backend/.ai/CONVENTIONS.md

Backend router

Объединяй triggers из смысла задачи, путей и обнаруженных boundaries. Читай выбранные guides до решения; якорь допускает чтение только нужного раздела. Просто backend-файл не требует всех conventions.

Решение / сигнал	Читать
Новый файл/suffix/layer; поиск feature owner; progressive structure; перенос responsibility	Architecture
Controller, DTO, route/status, validation/exception, публичная HTTP-семантика	HTTP API
Repository/data access; Prisma/schema/query, transaction, migration, atomic write	Data
Тесты или behavior с testing risk	Testing
JWT, cookie, login/refresh/logout, guard/access, token encryption, sensitive logs	Security
External client/integration boundary; T-Bank/gRPC/proto, retry/rate limit/cache	Integrations
Logging/request context без изменения secrets/auth	Logging
Новый abstraction/dependency, refactor, неясный scope	Общий выбор реализации
Изменение request/response/route/status/error shape или Swagger metadata	HTTP API + общий contract workflow

Новый endpoint обычно требует HTTP API + Testing; Architecture/Data/Security добавляются по новым ответственности, persistence или access rules. Изменение одного Prisma query без HTTP/auth границы не требует HTTP API/Security. Auth refresh активирует Security + Data + Testing; HTTP API добавляется, если меняется controller/HTTP contract. Exact docs/spec sources выбирай через SOURCES. Повтори routing при расширении diff, включая новые и unstaged файлы.