docs/development/backend-workflow.md

Рабочий процесс backend

Предварительные условия

Backend требует Node 22. Создайте backend/.env на основе backend/.env.example и замените placeholder-значения JWT_SECRET и TOKEN_ENCRYPTION_KEY; token T-Bank в этот файл не записывается.

cd backend
cp .env.example .env
npm ci

Локальная проверка

Canonical gate не изменяет versioned-файлы:

npm run verify

Он проверяет Node 22 до application stages и последовательно запускает hygiene, lint, application/test TypeScript, Jest и build. npm run lint:fix — явная записывающая команда, а npm run test:cov — отдельная диагностика без общего числового threshold. Runtime OpenAPI сверяется с frontend snapshot из workspace:

bash specs/scripts/verify-runtime-openapi.sh

npm run test:e2e временно не является passing gate: Prisma schema engine останавливает migration до Jest. Точная диагностика и trigger пересмотра зафиксированы в audit remediation registry.