docs: establish architecture records

2026-08-12 23:04:25 +03:00
parent 34577dc795
commit 2a09ef74bb
12 changed files with 140 additions and 0 deletions
@@ -0,0 +1,15 @@
+# 005. Устойчивость к ограничениям T-Bank upstream
+
+**Status:** Accepted, baseline decision
+
+## Context
+
+Внешний API имеет ограничения и временные ошибки; параллельные запросы пользователей не должны их обходить.
+
+## Decision
+
+Backend применяет глобальный конфигурируемый лимитер в 5 запросов в секунду к T-Bank, ограниченные временные повторы и повторы для `429`. In-memory TTL-кэш хранит данные 30 секунд, а инструменты не менее одного дня.
+
+## Consequences
+
+Лимит действует на экземпляр backend и кэш не переживает перезапуск. Распределённые лимиты, кэш и точные параметры retry будут рассмотрены при появлении нескольких экземпляров или подтвержденных требований upstream.