backend/AGENTS.md

Backend router

Репозиторий самостоятельный: обязательные инструкции и проверки используют только его файлы и предоставленные публичные контракты. Перед работой прочитай порядок работы, затем объединяй triggers задачи и путей; читай активированные темы до решения.

Решение / сигнал	Читать
Устройство/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
Helper/dependency/новый pattern, refactor/scope	Change scope, для пакета — Dependencies
Выбор gate, tooling, завершение	Проверки

Новый endpoint обычно требует HTTP API + Testing; Data/Security добавляются по persistence/access trigger. Auth refresh активирует Security + Data + Testing. Перед завершением повтори routing по новым и изменённым файлам. Для Git/release прочитай Git и релизы.

Источники

Вопрос	Локальный источник
HTTP errors/DTO/wire shape	HTTP API, генерация npm run openapi:generate, configured HTTP tests
Auth/session, account access, secrets	Security и auth/access tests
Prisma/data ownership	Data, Prisma schema/migrations
T-Bank/cache/logging	Integrations, Observability
Money и финансовые расчёты	Data, domain source и tests владельца
Поведение области	Module source и tests; неясное ожидание уточни до изменения
Versions/scripts/check scope	Manifest/lockfile, ESLint/TypeScript/Jest/Prisma configs