backend/AGENTS.md

Backend

Назначение

NestJS API WealthLedger. Все функциональные изменения планируются в ../specs/openspec до реализации.

Проверка

npm ci
npm run lint
npm run typecheck:app
npm run typecheck:test

Node 22 обязателен. npm run lint и npm run lint:check не изменяют versioned-файлы; npm run lint:fix — явная записывающая команда. Текущий npm run test:e2e временно не является надёжным gate: WL-P2-05 отложен из-за Prisma schema-engine failure; статус и trigger пересмотра указаны в ../docs/development/audit-remediation.md. Для read-only сверки runtime OpenAPI с frontend snapshot под Node 22 запускать из workspace bash specs/scripts/verify-runtime-openapi.sh.

Границы

• Перед изменением поставленного поведения или доменных терминов прочитать ../docs/architecture/system-overview.md и ../docs/architecture/domain-glossary.md.
• Публичный HTTP API версионируется как /api/v1; OpenAPI из backend - источник контракта для frontend.
• Backend отвечает за доменную логику, данные, конфигурацию и внешние интеграции. Frontend не вызывает T-Bank напрямую; будущая интеграция остается за backend boundary.
• Не размещать frontend-код, сгенерированный клиент или постоянную документацию в этом репозитории.
• Для задачи по Audit ID, продолжения remediation или выбора следующего улучшения сначала прочитать ../docs/development/audit-remediation.md; единственный canonical OpenSpec store — wealth-ledger-specs в ../specs/openspec, а OpenSpec commands, читающие или изменяющие change, выполнять с --store wealth-ledger-specs.
• Не создавать и не коммитить framework-specific planning/spec/task/design artifacts: versioned SDD-артефакты хранятся только в ../specs/openspec; ../references/** остаётся read-only исключением.