backend/AGENTS.md

Backend

NestJS API; общие правила работы — в root AGENTS.md. До backend-решения прочитай router и sources, затем только применимые документы/разделы.

Проверка

Перед 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 сохраняют направление контракта и проходят contract check. Общий e2e запускается на отдельных временных DB; применимость и маршрут проверки описаны в backend testing. Generated Prisma client не редактируется вручную. Credentials, авторизация доступа к счетам и внешние интеграции остаются server-side.

ESLint/TypeScript не доказывают правильность domain boundaries, security или денежных вычислений: для них нужны semantic review и risk-based tests.

Ветки и релизы

Работа — в отдельной ветке от develop, затем PR в develop; в main напрямую не пушить. Release/hotfix и синхронизация веток — по root README. Commits и заголовки PR — Conventional Commits; для спецификаций допустим spec:. Перед подготовкой релиза прочитай root README; версии вручную не повышать.