4.3 KiB
Project knowledge index
Открывай раздел по конкретному вопросу, затем только нужный source. Это карта фактов, не обязательное чтение всего docs. Текущий wire contract генерируется backend; устаревший ADR/пример кода не переопределяет его.
HTTP API
| Trigger | Source |
|---|---|
| Endpoint, DTO, validation, status, exception/error shape | HTTP semantics |
| Изменение публичного wire contract, snapshot/generated types | Contract workflow |
| Почему Nest — источник OpenAPI | ADR 002 |
Security
| Trigger | Source |
|---|---|
| Login/session/logout, cookie/access storage | Authentication |
| Concurrent/superseded refresh | ADR 009, термины |
| T-Bank token encryption, connection generation/cache | Connection, ADR 004 |
Data
Persistence source — Prisma schema, migrations. ADR 001 описывает исторический выбор SQLite, не текущий список таблиц. Transaction/ownership/migration decisions — backend data guide.
Integrations
T-Bank/proto/TLS/retry/limits — connection configuration и server-side boundary. Cache generation — connection cache. Logging — ADR 008 и реальный logger boundary.
Domain
Начинай с точного термина в глоссарии: Money, Portfolio Position, Client Cached Snapshot, Ledger, Realized Income. Cross-area topology — system overview.
Features
| Предмет задачи | Current behavior |
|---|---|
| Счета и их сводки | Brokerage accounts |
| Позиции/суммы портфеля, backend cache | Portfolio |
| Операции/фильтры/cursor | Account ledger |
| Будущие выплаты | Upcoming events |
| Реализованные доходы/периоды | Income analytics |
| UI recovery/error boundaries | Frontend resilience |
Behavioral requirements при необходимости — через specs index. Это не запускает SDD lifecycle.
UI
Theme/tokens/reuse — design system. Существующие components/stories и ограничения — UI catalog. Query freshness/focus policy — ADR 007.
Engineering
Scope/abstraction/dependency/testing — общие правила. Routing/recovery — context discipline. Commands — frontend / backend. Известный Audit ID — найденная запись registry; читай её evidence только для этого вопроса. Historical audits не являются live rules.