# 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.