docs: explain server-side portfolio metadata recovery

2026-09-12 15:38:19 +03:00
parent f20c3f47bc
commit 05bfe8df1c
3 changed files with 55 additions and 10 deletions
@@ -127,10 +127,17 @@ Backend хранит token в шифротексте AES-256-GCM с новым n

 Параметры окружения определяет backend
 [validateEnv](../../backend/src/config/env.validation.ts) (workspace-ссылка).
-Общий FIFO-лимитер ограничивает поток RPC и отклоняет новый вызов при 50
+Общий FIFO-лимитер ограничивает поток RPC и не допускает более 50
 ожидающих. Для `UNAVAILABLE`, `DEADLINE_EXCEEDED` и `RESOURCE_EXHAUSTED`
-предусмотрен один повтор через секунду. Deadline каждой попытки — 15 секунд,
+обычный RPC допускает один повтор через секунду. Deadline каждой попытки — 15 секунд,
 а ожидание места в лимитере не является временем этой сетевой попытки.
+Для поиска метаданных `GetInstrumentBy` разрешены две повторные попытки
+с паузами 2 и 4 секунды после неудачных попыток. Они применяются к тем же
+временным кодам и к переполнению локальной очереди; перед каждой попыткой
+проверяется её вместимость. Постоянные ошибки и отказ авторизации
+не повторяются. Подтверждённый `NOT_FOUND` при поиске метаданных означает
+отсутствие инструмента, а не временный сбой. Остальные RPC при полной
+очереди завершаются сразу.
 Параметры попыток принадлежат
 [T-Bank client](../../backend/src/tbank/tbank.client.ts) (workspace-ссылка);
 решение об ограниченных повторах — [ADR 005](../adr/005-tbank-upstream-resilience.md).