docs(ai): add scoped backend conventions

This commit is contained in:
2026-09-09 16:23:03 +03:00
parent 320e8a04b0
commit a83e26e5ef
10 changed files with 377 additions and 36 deletions
+12 -5
View File
@@ -10,6 +10,7 @@ NestJS API WealthLedger. Backend владеет auth, SQLite-данными и s
```bash
cp .env.example .env
nvm use --silent
npm ci
npm run start:dev
```
@@ -27,7 +28,7 @@ T-Bank token в `.env`: он вводится пользователем и хр
npm run verify
```
Он сначала отклоняет runtime вне Node 22, затем запускает hygiene, lint,
Он запускает zero-warning lint,
application/test typechecks, Jest и build. `npm run lint:fix` — отдельная
записывающая команда, `npm run test:cov` — диагностика без общего числового
threshold. `npm run test:e2e` пока не является passing gate: Prisma schema
@@ -36,19 +37,25 @@ engine останавливает migration до запуска Jest. Точны
## Документация
- [Router conventions](.ai/CONVENTIONS.md) и [источники](.ai/SOURCES.md)
- [Backend architecture](.ai/conventions/backend-architecture.md)
- [HTTP API](.ai/conventions/backend-http-api.md), [data](.ai/conventions/backend-data.md) и [testing](.ai/conventions/backend-testing.md)
- [Security/auth](.ai/conventions/security-auth.md) и [integrations](.ai/conventions/backend-integrations.md)
- [Backend workflow](../docs/development/backend-workflow.md)
- [Engineering governance и risk-based testing](../docs/development/engineering-governance.md)
- [OpenSpec authority и lifecycle](../docs/development/openspec-authority-and-lifecycle.md)
- [Карта проектных фактов](../docs/AI_INDEX.md)
- [API contract и runtime OpenAPI](../docs/development/runtime-openapi-verification.md)
- [Обзор поставленной системы](../docs/architecture/system-overview.md)
- [Архитектурные решения](../docs/adr/README.md)
- [Remediation registry](../docs/development/audit-remediation.md)
Из workspace runtime OpenAPI можно read-only сверить с frontend snapshot:
Из backend runtime OpenAPI можно read-only сверить с frontend snapshot:
```bash
npm run test:openapi-contract
```
Полный multi-repository change проверяется из workspace через
native OpenSpec validation and the canonical gates of each affected repository.
Разработка идёт напрямую по задаче пользователя. Каждый affected repo проходит
свой verify; при изменении wire contract дополнительно выполняется contract check.
Обязательного OpenSpec/SDD lifecycle нет.