76 lines
4.4 KiB
Markdown
76 lines
4.4 KiB
Markdown
# Project knowledge index
|
|
|
|
Открывай раздел по конкретному вопросу, затем только нужный source.
|
|
Это карта фактов, не обязательное чтение всего docs. Текущий wire contract
|
|
генерируется backend; устаревший ADR/пример кода не переопределяет его.
|
|
|
|
## HTTP API
|
|
|
|
| Trigger | Source |
|
|
| --- | --- |
|
|
| Endpoint, DTO, validation, status, exception/error shape | [HTTP semantics](architecture/http-api.md) |
|
|
| Изменение публичного wire contract, snapshot/generated types | [Contract workflow](development/runtime-openapi-verification.md) |
|
|
| Почему Nest — источник OpenAPI | [ADR 002](adr/002-nest-generated-openapi-contract.md) |
|
|
|
|
## Security
|
|
|
|
| Trigger | Source |
|
|
| --- | --- |
|
|
| Login/session/logout, cookie/access storage | [Authentication](features/authentication.md) |
|
|
| Concurrent/superseded refresh | [ADR 009](adr/009-concurrent-refresh-rotation-policy.md), [термины](architecture/domain-glossary.md#concurrent-refresh-attempt) |
|
|
| T-Bank token encryption, connection generation/cache | [Connection](features/tbank-connection.md), [ADR 004](adr/004-encrypted-per-user-tbank-token.md) |
|
|
|
|
## Data
|
|
|
|
Persistence source — [Prisma schema](../backend/prisma/schema.prisma),
|
|
[migrations](../backend/prisma/migrations/). [ADR 001](adr/001-prisma-sqlite-local-mvp.md)
|
|
описывает исторический выбор SQLite, не текущий список таблиц.
|
|
Transaction/ownership/migration decisions — [backend data guide](../backend/.ai/conventions/backend-data.md).
|
|
|
|
## Integrations
|
|
|
|
T-Bank/proto/TLS/retry/limits — [connection configuration](features/tbank-connection.md#конфигурация-и-ограничения)
|
|
и [server-side boundary](adr/003-tbank-server-side-grpc-boundary.md).
|
|
Cache generation — [connection cache](features/tbank-connection.md#граница-финансового-кэша).
|
|
Logging — [ADR 008](adr/008-pino-backend-logging.md) и
|
|
[реальный logger boundary](../backend/.ai/conventions/backend-architecture.md#logging).
|
|
|
|
## 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).
|
|
Cross-area topology — [system overview](architecture/system-overview.md).
|
|
|
|
## Features
|
|
|
|
| Предмет задачи | Current behavior |
|
|
| --- | --- |
|
|
| Счета и их сводки | [Brokerage accounts](features/brokerage-accounts.md) |
|
|
| Общий портфель и разделы по всем счетам | [All accounts](features/all-accounts.md) |
|
|
| Позиции/суммы портфеля, backend cache | [Portfolio](features/portfolio-view.md) |
|
|
| Операции/фильтры/cursor | [Account ledger](features/brokerage-account-ledger.md) |
|
|
| Будущие выплаты | [Upcoming events](features/brokerage-account-upcoming-events.md) |
|
|
| Реализованные доходы/периоды | [Income analytics](features/brokerage-account-income-analytics.md) |
|
|
| UI recovery/error boundaries | [Frontend resilience](features/frontend-ui-resilience.md) |
|
|
|
|
Behavioral requirements при необходимости — через [specs index](../specs/AI_INDEX.md).
|
|
Это не запускает SDD lifecycle.
|
|
|
|
## UI
|
|
|
|
Theme/tokens/reuse — [design system](development/design-system.md).
|
|
Существующие components/stories и ограничения — [UI catalog](development/ui-catalog.md).
|
|
Query freshness/focus policy — [ADR 007](adr/007-react-query-fetch-policy.md).
|
|
|
|
## Engineering
|
|
|
|
Scope/abstraction/dependency/testing — [общие правила](development/engineering-governance.md).
|
|
Routing/recovery — [context discipline](development/agent-token-efficiency.md).
|
|
Commands — [frontend](development/frontend-workflow.md) / [backend](development/backend-workflow.md).
|
|
Известный Audit ID — найденная запись [registry](development/audit-remediation.md);
|
|
читай её evidence только для этого вопроса. Historical audits не являются live rules.
|