# Frontend Workflow

Frontend требует Node 22. В `frontend/` чистая установка и полный локальный quality gate выполняются так:

```bash
npm ci
npm run verify
```

`verify` проверяет TypeScript, Biome, один coverage-backed запуск Vitest, Knip,
FSD dependency rules и production build. Он работает без backend. Coverage
остаётся anti-regression constraint; правила выбора тестов зафиксированы в
[engineering governance](engineering-governance.md).

Backend остаётся источником OpenAPI. После изменения опубликованного
backend-контракта разработчик обновляет в `frontend/` committed snapshot
`src/shared/api/spec/openapi.json` копированием backend OpenAPI document, затем
запускает:

```bash
npm run openapi:generate
```

Команда использует только committed snapshot и регенерирует
`src/shared/api/generated/schema.d.ts` offline. Проверку соответствия backend
runtime contract и frontend snapshot выполняют отдельной backend-командой
`npm run test:openapi-contract`.