backend/AGENTS.md

Backend router

Общие инструкции — workspace AGENTS. Объединяй triggers задачи, путей и обнаруженных boundaries; читай только нужные темы до решения. Системные факты/spec/ADR выбирай в разделе Источники по вопросу.

Решение / сигнал	Читать
Устройство/data flow, module/layer/public API/DI/suffix, owner	Architecture
TS vocabulary, domain literals, magic values	Types/values
Controller/DTO/validation, route/status/response, OpenAPI	HTTP API
Application/domain/HTTP error, exception, code	Errors
Repository/Prisma/query, transaction, migration, atomic write	Data
Tests или behavior с regression risk	Testing
JWT/cookie/session/guard/access, encryption, secrets	Security
External client/gateway/SDK/proto, retry/rate limit/cache	Integrations
Logging/context/levels, sensitive logs	Observability; sensitive data также Security
Изменение публичного wire contract / Swagger metadata	HTTP API + HTTP contract source
Helper/dependency/новый pattern, refactor/scope	Code health, для пакета — Dependencies
Выбор gate, tooling, завершение	Guardrails

Новый endpoint обычно требует HTTP API + Testing; Data/Security добавляются по persistence/access trigger. Auth refresh активирует Security + Data + Testing. Повтори routing по итоговому diff, включая новые файлы. Migration backlog читается только при соответствующем finding через plan.

Источники

Открывай только источник по возникшему вопросу. Code показывает реализацию, docs — текущую систему, ADR — rationale, specs — requirements. Старый пример не отменяет контракт; conflicting security/data facts выясняй до решения.

Вопрос	Источник
HTTP errors/DTO/wire shape	HTTP API; editable OpenAPI генерирует Nest
Auth/session, account access, secrets	Authentication, T-Bank
Prisma/data ownership, хранение и доступ	Containers
T-Bank/cache/logging	T-Bank, Freshness, Observability
Money, account/position/income/cache meanings	Глоссарий
Поведение области / требования	Области docs, Specs index
Versions/scripts/check scope	Manifest/lockfile, ESLint/TypeScript/Jest/Prisma configs