docs: refine backend conventions and routing

2026-09-15 05:42:16 +03:00
parent 660b250ecd
commit 9810d47e42
12 changed files with 201 additions and 131 deletions
@@ -2,7 +2,8 @@

 ## Выбор boundary

-T-Bank gRPC принадлежит TbankClient; MOEX metadata — MoexClient. Сервисы use case
+T-Bank gRPC принадлежит TbankClient; MOEX metadata — MoexClient; NCR ratings —
+NcrRatingsClient. Сервисы use case
 используют объявленные клиентом records; SDK clients, metadata и transport errors
 остаются внутри integration. Frontend не вызывает
 T-Bank и не получает credentials/proto client. Reference source —
@@ -40,6 +41,10 @@ Existing client уже владеет bounded FIFO queue, rate limit, deadline
 CA mechanism. Точные параметры и ограничения принадлежат
 [connection configuration](../../../docs/integrations/tbank.md#конфигурация-и-ограничения).

+Эта queue/retry policy относится к T-Bank. MOEX/NCR HTTP clients используют
+собственный bounded timeout и безопасный unavailable outcome; не приписывай им
+gRPC retry policy. При изменении upstream сначала прочитай конкретный client.
+
 При query/cache change установи key, user/account/generation ownership,
 freshness и поведение late response. Старый результат не может обслужить новую
 connection generation. Client Cached Snapshot frontend отличается от backend