docs: refresh project onboarding entrypoints
This commit is contained in:
@@ -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 и его границы.
|
||||
|
||||
@@ -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).
|
||||
Reference in New Issue
Block a user