Files
docs/AI_INDEX.md
T

4.8 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
Общий портфель и разделы по всем счетам All accounts
Страница акции, поиск, график и история одной бумаги Stock detail
Страница облигации, поиск, купоны и переходы из портфеля Bond detail
Источники кредитных рейтингов облигаций Исследование источников
Позиции/суммы портфеля, 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.