2.4 KiB
WealthLedger backend
NestJS API WealthLedger. Backend владеет auth, SQLite-данными и server-side интеграцией T-Bank; frontend не обращается к T-Bank напрямую.
Быстрый старт
Требуется Node 22 (.nvmrc). Создайте .env из примера, замените placeholder
секреты и установите зависимости строго из lockfile:
cp .env.example .env
npm ci
npm run start:dev
JWT_SECRET должен быть секретом не короче 32 символов, а
TOKEN_ENCRYPTION_KEY — base64-кодированным 32-байтным ключом. Не добавляйте
T-Bank token в .env: он вводится пользователем и хранится в зашифрованном
виде.
Проверка
Единый completion gate не изменяет versioned-файлы:
npm run verify
Он сначала отклоняет runtime вне Node 22, затем запускает hygiene, lint,
application/test typechecks, Jest и build. npm run lint:fix — отдельная
записывающая команда, npm run test:cov — диагностика без общего числового
threshold. npm run test:e2e пока не является passing gate: Prisma schema
engine останавливает migration до запуска Jest. Точный статус и trigger
пересмотра находятся в remediation registry.
Документация
- Backend workflow
- Engineering governance и risk-based testing
- OpenSpec authority и lifecycle
- API contract и runtime OpenAPI
- Обзор поставленной системы
- Архитектурные решения
- Remediation registry
Из workspace runtime OpenAPI можно read-only сверить с frontend snapshot:
bash specs/scripts/verify-runtime-openapi.sh
Полный multi-repository change проверяется из workspace через
bash specs/scripts/verify-workspace-change.sh <change>.