3.8 KiB
3.8 KiB
Backend router
Репозиторий самостоятельный: обязательные инструкции и проверки используют
только его файлы и предоставленные публичные контракты. Перед работой прочитай
порядок работы, затем
объединяй triggers задачи и путей; читай активированные темы до решения.
До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение
допускается без Issue. Общий маршрут — Engineering Workflow
(main#28; после merge — актуальная версия develop).
| Решение / сигнал | Читать |
|---|---|
| Устройство/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 |