docs(ai): route frontend conventions by task

This commit is contained in:
2026-09-09 16:22:47 +03:00
parent 26f229ba3e
commit bcc034f198
14 changed files with 333 additions and 210 deletions
+13 -8
View File
@@ -10,6 +10,7 @@ backend; прямые вызовы T-Bank из frontend не допускают
```bash
cp .env.example .env
nvm use --silent
npm ci
npm run dev
```
@@ -25,23 +26,27 @@ npm run verify
Команда проверяет, что generated OpenAPI types соответствуют committed snapshot,
затем запускает strict TypeScript, Biome, один coverage-backed запуск Vitest,
Knip, dependency rules и production build. Если backend-контракт изменился,
Knip, dependency rules приложения и stories, сборки приложения и Storybook.
Если backend-контракт изменился,
обновите `src/shared/api/spec/openapi.json` копированием backend OpenAPI
document и затем выполните `npm run openapi:generate`.
## Документация
- [Структура и FSD](docs/STRUCTURE.md)
- [API layer и OpenAPI](docs/API-LAYER.md)
- [UI-паттерны](docs/UI-PATTERN.md)
- [Conventions](docs/CONVENTIONS.md) и [тестирование](docs/TESTING.md)
- [Router conventions](.ai/CONVENTIONS.md) и [источники](.ai/SOURCES.md)
- [Выбор owner/FSD](.ai/conventions/frontend-architecture.md)
- [UI, state, формы и компоненты](.ai/conventions/frontend-ui.md)
- [Data/API/cache](.ai/conventions/frontend-data.md)
- [Testing](.ai/conventions/frontend-testing.md)
- [Поставленный UI-каталог Storybook](../docs/development/ui-catalog.md)
- [Обзор поставленной системы](../docs/architecture/system-overview.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)
- [Frontend workflow](../docs/development/frontend-workflow.md)
- [Remediation registry](../docs/development/audit-remediation.md)
Runtime OpenAPI backend сверяется с frontend snapshot отдельной read-only
backend командой `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 нет.