84 lines
6.4 KiB
Markdown
84 lines
6.4 KiB
Markdown
# Project knowledge index
|
|
|
|
Карта проектных знаний по вопросам читателя. Все необходимые объяснения
|
|
находятся внутри документации. Для первого знакомства откройте
|
|
[главную страницу](README.md), для конкретного сценария —
|
|
[карту возможностей](features/README.md).
|
|
|
|
## HTTP API
|
|
|
|
| Вопрос | Документ |
|
|
| --- | --- |
|
|
| Как API проверяет запрос, подтверждает доступ и сообщает об ошибках? | [HTTP semantics](architecture/http-api.md) |
|
|
| Как сохраняется согласованность публичного контракта frontend и backend? | [Contract workflow](development/runtime-openapi-verification.md) |
|
|
| Почему backend является источником OpenAPI? | [ADR 002](adr/002-nest-generated-openapi-contract.md) |
|
|
|
|
## Security
|
|
|
|
| Вопрос | Документ |
|
|
| --- | --- |
|
|
| Как работают вход, восстановление сессии, cookie и logout? | [Authentication](features/authentication.md) |
|
|
| Что происходит при конкурентном refresh или повторном предъявлении заменённого token? | [ADR 009](adr/009-concurrent-refresh-rotation-policy.md), [термины](architecture/domain-glossary.md#concurrent-refresh-attempt) |
|
|
| Как защищён T-Bank token и что меняется при замене подключения? | [Connection](features/tbank-connection.md), [ADR 004](adr/004-encrypted-per-user-tbank-token.md) |
|
|
|
|
## Data
|
|
|
|
Локальная база хранит пользователей, сессии и зашифрованные подключения.
|
|
Брокерские счета и финансовые снимки не сохраняются как долговременная история.
|
|
Принадлежность данных и границы хранения описаны в
|
|
[обзоре системы](architecture/system-overview.md#хранимые-данные).
|
|
Причина выбора локальной базы — [ADR 001](adr/001-prisma-sqlite-local-mvp.md).
|
|
Точность и валюты — [Money](architecture/domain-glossary.md#money).
|
|
Сохранение данных при обновлении — [локальное окружение](development/local-workspace.md#подготовка-backend).
|
|
|
|
## Integrations
|
|
|
|
T-Bank, TLS, повторные попытки и лимиты —
|
|
[ограничения подключения](features/tbank-connection.md#конфигурация-и-ограничения)
|
|
и [server-side boundary](adr/003-tbank-server-side-grpc-boundary.md).
|
|
MOEX/НКР и происхождение показателей — [облигации](features/bond-detail.md#содержание)
|
|
и [внешние системы](architecture/system-overview.md#контекст-системы).
|
|
Смена подключения и финансовый кэш — [connection cache](features/tbank-connection.md#граница-финансового-кэша).
|
|
Логирование выполняется на инфраструктурной границе backend: события связываются
|
|
с HTTP-запросом, а секреты и полные запросы не попадают в журнал.
|
|
Принятые ограничения описаны в [ADR 008](adr/008-pino-backend-logging.md).
|
|
|
|
## Domain
|
|
|
|
Определения и различия понятий — в [глоссарии](architecture/domain-glossary.md):
|
|
[Money](architecture/domain-glossary.md#money),
|
|
[Portfolio Position](architecture/domain-glossary.md#portfolio-position),
|
|
[Client Cached Snapshot](architecture/domain-glossary.md#client-cached-snapshot),
|
|
[Ledger](architecture/domain-glossary.md#account-ledger),
|
|
[Realized Income](architecture/domain-glossary.md#realized-income-analytics).
|
|
Связи понятий и подсистем — [system overview](architecture/system-overview.md#предметная-модель).
|
|
|
|
## Features
|
|
|
|
| Предмет вопроса | Текущее поведение |
|
|
| --- | --- |
|
|
| Счета и сводки | [Brokerage accounts](features/brokerage-accounts.md) |
|
|
| Общий портфель и разделы по всем счетам | [All accounts](features/all-accounts.md) |
|
|
| Поиск, график и история акции | [Stock detail](features/stock-detail.md) |
|
|
| Поиск, купоны и показатели облигации | [Bond detail](features/bond-detail.md) |
|
|
| Покрытие источников кредитных рейтингов | [Исследование источников](research/bond-credit-ratings.md) |
|
|
| Позиции, суммы портфеля и свежесть данных | [Portfolio](features/portfolio-view.md) |
|
|
| Операции, фильтры и пагинация | [Account ledger](features/brokerage-account-ledger.md) |
|
|
| Будущие выплаты | [Upcoming events](features/brokerage-account-upcoming-events.md) |
|
|
| Реализованные доходы и периоды | [Income analytics](features/brokerage-account-income-analytics.md) |
|
|
| Восстановление после ошибок интерфейса | [Frontend resilience](features/frontend-ui-resilience.md) |
|
|
|
|
## UI
|
|
|
|
Визуальные роли и общие состояния — [дизайн-система](development/design-system.md).
|
|
Примеры экранов и ограничения их проверки — [UI-каталог](development/ui-catalog.md).
|
|
Обновление данных при возвращении в окно — [ADR 007](adr/007-react-query-fetch-policy.md).
|
|
|
|
## Engineering
|
|
|
|
Принципы изменения и проверки системы — [engineering governance](development/engineering-governance.md).
|
|
Ведение знаний и разрешение расхождений — [документация](development/documentation.md).
|
|
Локальное окружение и диагностика — [local workspace](development/local-workspace.md).
|
|
Служебные материалы сопровождения и исторические результаты отделены от
|
|
описания системы в [разделе разработки](development/README.md).
|