docs: refresh project onboarding entrypoints

This commit is contained in:
2026-08-24 10:29:00 +03:00
parent b623805cbe
commit 88c0cd3281
8 changed files with 260 additions and 7 deletions
+9 -3
View File
@@ -24,7 +24,7 @@ sequenceDiagram
`INVALID_TBANK_TOKEN` означает, что T-Bank отклонил аутентификацию или права доступа. `TBANK_UNAVAILABLE` означает временную ошибку, превышение лимита, ожидание в очереди или другую ошибку внешнего сервиса.
## Configuration and limits
## Конфигурация и ограничения
- `TOKEN_ENCRYPTION_KEY` - закодированный в base64 32-байтный ключ AES-256-GCM; обязателен при запуске.
- `TBANK_GRPC_ENDPOINT` по умолчанию имеет значение `invest-public-api.tbank.ru:443`.
@@ -35,6 +35,12 @@ FIFO-ограничитель на экземпляр запускает не б
Портфель с большим числом ранее не кэшированных инструментов создаёт отдельные metadata lookup. Если в такой ситуации очередь переполняется и позиции получают FIGI вместо names, увеличьте `TBANK_RATE_LIMIT_PER_SECOND` в соответствии с разрешённой upstream-квотой; для локального портфеля из множества позиций использовалось значение `50`.
## MVP limits
## Ограничения
Реализована только проверка токена. Счета, портфели, кэш метаданных инструментов, ротация ключа, распределенное ограничение запросов и сериализация параллельного обновления подключения отложены. Вендорные protobuf-контракты взяты из `references/moex-vibe`; при необходимости обновляйте их вручную по официальной документации T-Bank Invest API.
Подключение используется поставленными сценариями Brokerage Accounts,
Portfolio, Account Ledger и Future Cash Events; frontend не обращается к
T-Bank напрямую. Token encryption key не ротируется, rate limit остаётся
per-instance, а обновление connection не сериализуется между распределёнными
экземплярами backend. Вендорные protobuf-контракты взяты из
`references/moex-vibe`; при необходимости обновляйте их вручную по официальной
документации T-Bank Invest API.