Update frontend verification docs

2026-08-26 23:38:59 +03:00
parent 4af0a9c055
commit 8eac3b0ffa
2 changed files with 18 additions and 12 deletions
@@ -7,15 +7,21 @@ npm ci
 npm run verify
 ```

-`verify` проверяет OpenAPI drift, TypeScript, Biome, один coverage-backed запуск Vitest,
-Knip, FSD dependency rules, production build и bundle budget. Он работает без
-backend. Coverage остаётся anti-regression constraint; правила выбора тестов
-зафиксированы в [engineering governance](engineering-governance.md).
+`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/`:
+Backend остаётся источником OpenAPI. После изменения опубликованного
+backend-контракта разработчик обновляет в `frontend/` committed snapshot
+`src/shared/api/spec/openapi.json` копированием backend OpenAPI document, затем
+запускает:

 ```bash
-npm run openapi:sync
+npm run openapi:generate
 ```

-Команда использует `${VITE_API_BASE_URL:-http://localhost:3000}/api/docs-json`, генерирует types во временной директории и заменяет committed snapshot и generated artifact только после успешной генерации. Обычные `openapi:generate` и `openapi:check` используют committed snapshot offline.
+Команда использует только committed snapshot и регенерирует
+`src/shared/api/generated/schema.d.ts` offline. Проверку соответствия backend
+runtime contract и frontend snapshot выполняют отдельной backend-командой
+`npm run test:openapi-contract`.