ksv741
9810d47e42
Backend security / security (push) Successful in 8s
Backend verify / verify (push) Successful in 2m12s
Conventional commits / commits (pull_request) Successful in 25s
Backend security / security (pull_request) Successful in 7s
Backend verify / verify (pull_request) Successful in 2m3s
28 lines
2.5 KiB
Markdown
28 lines
2.5 KiB
Markdown
# Backend router
|
||
|
||
Общие инструкции — [workspace AGENTS](../AGENTS.md). Объединяй triggers задачи,
|
||
путей и обнаруженных boundaries; читай только нужные темы до решения.
|
||
[Sources](.ai/SOURCES.md) выбирает факты/spec/ADR по возникшему вопросу.
|
||
|
||
| Решение / сигнал | Читать |
|
||
| --- | --- |
|
||
| Первое знакомство, data flow, общая архитектура | [Mental model](.ai/architecture.md) |
|
||
| Module/layer/public API/DI/suffix, owner, перенос responsibility | [Modules/application](.ai/conventions/backend-architecture.md) |
|
||
| TS vocabulary, domain literals, magic values | [Types/values](.ai/conventions/backend-architecture.md#domain-literals-and-magic-values) |
|
||
| Controller/DTO/validation, route/status/response, OpenAPI | [HTTP API](.ai/conventions/backend-http-api.md) |
|
||
| Application/domain/HTTP error, exception, code | [Errors](.ai/conventions/backend-error-handling.md) |
|
||
| Repository/Prisma/query, transaction, migration, atomic write | [Data](.ai/conventions/backend-data.md) |
|
||
| Tests или behavior с regression risk | [Testing](.ai/conventions/backend-testing.md) |
|
||
| JWT/cookie/session/guard/access, encryption, secrets | [Security](.ai/conventions/security-auth.md) |
|
||
| External client/gateway/SDK/proto, retry/rate limit/cache | [Integrations](.ai/conventions/backend-integrations.md) |
|
||
| Logging/context/levels, sensitive logs | [Observability](.ai/conventions/backend-observability.md); sensitive data также Security |
|
||
| Изменение публичного wire contract / Swagger metadata | HTTP API + [HTTP contract source](../docs/architecture/http-api.md#источник-контракта) |
|
||
| Helper/dependency/новый pattern, refactor/scope | [Code health](../.ai/conventions/code-health.md), для пакета — [Dependencies](../.ai/conventions/dependencies.md) |
|
||
| Выбор gate, tooling, завершение | [Guardrails](../.ai/conventions/guardrails.md) |
|
||
|
||
Новый endpoint обычно требует HTTP API + Testing; Data/Security добавляются
|
||
по persistence/access trigger. Auth refresh активирует Security + Data + Testing.
|
||
Повтори routing по итоговому diff, включая новые файлы. Migration backlog
|
||
читается только при соответствующем finding через
|
||
[plan](../.ai/migrations/conventions-v1/plan.md).
|