31 lines
2.1 KiB
Markdown
31 lines
2.1 KiB
Markdown
# Backend
|
|
|
|
NestJS API; общие правила работы — в root `AGENTS.md`.
|
|
До backend-решения прочитай [router](.ai/CONVENTIONS.md) и
|
|
[sources](.ai/SOURCES.md), затем только применимые документы/разделы.
|
|
|
|
## Проверка
|
|
|
|
Перед Node-командами: `nvm use --silent` по `.nvmrc`.
|
|
После lockfile install `npm ci` полный gate — `npm run verify`:
|
|
zero-warning ESLint, application/test TypeScript, Jest и build.
|
|
`lint:fix`/`format` пишут файлы и запускаются отдельно от доказательства проверки.
|
|
`test:cov` — диагностика без общего threshold; scripts принадлежат `package.json`.
|
|
|
|
HTTP contract changes сохраняют [направление контракта](../docs/architecture/http-api.md#источник-контракта)
|
|
и проходят contract check. Общий e2e запускается на отдельных временных DB;
|
|
применимость и маршрут проверки
|
|
описаны в [backend testing](.ai/conventions/backend-testing.md).
|
|
Generated Prisma client не редактируется вручную. Credentials, авторизация
|
|
доступа к счетам и внешние интеграции остаются server-side.
|
|
|
|
ESLint/TypeScript не доказывают правильность domain boundaries, security или
|
|
денежных вычислений: для них нужны semantic review и risk-based tests.
|
|
|
|
## Ветки и релизы
|
|
|
|
Работа — в отдельной ветке от `develop`, затем PR в `develop`; в `main` напрямую
|
|
не пушить. Release/hotfix и синхронизация веток — по [root README](../README.md#релизы-и-ветки).
|
|
Commits и заголовки PR — Conventional Commits; для спецификаций допустим `spec:`.
|
|
Перед подготовкой релиза прочитай root README; версии вручную не повышать.
|