docs/development/frontend-workflow.md

Frontend Workflow

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

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.

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

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.