# Frontend Workflow

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

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

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

Backend остаётся источником OpenAPI. После изменения опубликованного backend-контракта разработчик запускает в `frontend/`:

```bash
npm run openapi:sync
```

Команда использует `${VITE_API_BASE_URL:-http://localhost:3000}/api/docs-json`, генерирует types во временной директории и заменяет committed snapshot и generated artifact только после успешной генерации. Обычные `openapi:generate` и `openapi:check` используют committed snapshot offline.