32 lines
2.5 KiB
Markdown
32 lines
2.5 KiB
Markdown
# Backend
|
||
|
||
## Назначение
|
||
|
||
NestJS API WealthLedger. Все функциональные изменения планируются в `../specs/openspec` до реализации.
|
||
|
||
## Проверка
|
||
|
||
```bash
|
||
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/system-overview.md) и [`../docs/architecture/domain-glossary.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`](../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 исключением.
|