docs: refresh project onboarding entrypoints

This commit is contained in:
2026-08-24 10:29:00 +03:00
parent b623805cbe
commit 88c0cd3281
8 changed files with 260 additions and 7 deletions
+5 -1
View File
@@ -1,7 +1,11 @@
# Development
# Разработка
Здесь размещаются устойчивые правила разработки, локальной проверки и поставки. Требования и планы изменений остаются в `../specs/openspec`.
- [Frontend workflow](frontend-workflow.md) — Node 22, локальный запуск и
frontend verification.
- [Backend workflow](backend-workflow.md) — bootstrap backend, локальные
non-mutating gates и границы e2e.
- [Audit remediation registry](audit-remediation.md) — текущий статус findings, следующий OpenSpec change и evidence завершённых улучшений.
- [OpenSpec authority и lifecycle](openspec-authority-and-lifecycle.md) — единственный SDD store, границы постоянной документации и условия archive.
- [Проверка runtime OpenAPI](runtime-openapi-verification.md) — отдельный read-only contract gate и его границы.
+35
View File
@@ -0,0 +1,35 @@
# Рабочий процесс backend
## Предварительные условия
Backend требует Node 22. Создайте `backend/.env` на основе
`backend/.env.example` и замените placeholder-значения `JWT_SECRET` и
`TOKEN_ENCRYPTION_KEY`; token T-Bank в этот файл не записывается.
```bash
cd backend
cp .env.example .env
npm ci
```
## Локальная проверка
Следующие команды не изменяют versioned-файлы:
```bash
npm run lint
npm run typecheck:app
npm run typecheck:test
npm test -- --runInBand
```
`npm run lint:fix` — явная записывающая команда. Runtime OpenAPI сверяется с
frontend snapshot из workspace:
```bash
bash specs/scripts/verify-runtime-openapi.sh
```
`npm run test:e2e` временно не является passing gate: Prisma schema engine
останавливает migration до Jest. Точная диагностика и trigger пересмотра
зафиксированы в [audit remediation registry](audit-remediation.md).