2.1 KiB
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; версии вручную не повышать.