docs/development/frontend-workflow.md

Frontend Workflow

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

npm ci
npm run verify

verify проверяет OpenAPI drift, TypeScript, Biome, unit tests и coverage, Knip, FSD dependency rules и production build. Он работает без backend.

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.