Files
backend/.ai/CONVENTIONS.md
T

2.2 KiB
Raw Blame History

Backend router

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

Решение / сигнал Читать
Новый module/provider/service; бизнес-логика; перенос responsibility Architecture
Controller, DTO, route/status, validation/exception, публичная HTTP-семантика HTTP API
Prisma/schema/query/persistence, transaction, migration, atomic write Data
Тесты или behavior с testing risk Testing
JWT, cookie, login/refresh/logout, guard/access, token encryption, sensitive logs Security
T-Bank/gRPC/proto, upstream retry/rate limit/cache, MoexClient 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 файлы.