Files
docs/AI_INDEX.md
T

6.4 KiB

Project knowledge index

Карта проектных знаний по вопросам читателя. Все необходимые объяснения находятся внутри документации. Для первого знакомства откройте главную страницу, для конкретного сценария — карту возможностей.

HTTP API

Вопрос Документ
Как API проверяет запрос, подтверждает доступ и сообщает об ошибках? HTTP semantics
Как сохраняется согласованность публичного контракта frontend и backend? Contract workflow
Почему backend является источником OpenAPI? ADR 002

Security

Вопрос Документ
Как работают вход, восстановление сессии, cookie и logout? Authentication
Что происходит при конкурентном refresh или повторном предъявлении заменённого token? ADR 009, термины
Как защищён T-Bank token и что меняется при замене подключения? Connection, ADR 004

Data

Локальная база хранит пользователей, сессии и зашифрованные подключения. Брокерские счета и финансовые снимки не сохраняются как долговременная история. Принадлежность данных и границы хранения описаны в обзоре системы. Причина выбора локальной базы — ADR 001. Точность и валюты — Money. Сохранение данных при обновлении — локальное окружение.

Integrations

T-Bank, TLS, повторные попытки и лимиты — ограничения подключения и server-side boundary. MOEX/НКР и происхождение показателей — облигации и внешние системы. Смена подключения и финансовый кэш — connection cache. Логирование выполняется на инфраструктурной границе backend: события связываются с HTTP-запросом, а секреты и полные запросы не попадают в журнал. Принятые ограничения описаны в ADR 008.

Domain

Определения и различия понятий — в глоссарии: Money, Portfolio Position, Client Cached Snapshot, Ledger, Realized Income. Связи понятий и подсистем — system overview.

Features

Предмет вопроса Текущее поведение
Счета и сводки Brokerage accounts
Общий портфель и разделы по всем счетам All accounts
Поиск, график и история акции Stock detail
Поиск, купоны и показатели облигации Bond detail
Покрытие источников кредитных рейтингов Исследование источников
Позиции, суммы портфеля и свежесть данных Portfolio
Операции, фильтры и пагинация Account ledger
Будущие выплаты Upcoming events
Реализованные доходы и периоды Income analytics
Восстановление после ошибок интерфейса Frontend resilience

UI

Визуальные роли и общие состояния — дизайн-система. Примеры экранов и ограничения их проверки — UI-каталог. Обновление данных при возвращении в окно — ADR 007.

Engineering

Принципы изменения и проверки системы — engineering governance. Ведение знаний и разрешение расхождений — документация. Локальное окружение и диагностика — local workspace. Служебные материалы сопровождения и исторические результаты отделены от описания системы в разделе разработки.