From 5d5497a4e4fc52cd03326080ba082c6dec369ce5 Mon Sep 17 00:00:00 2001
From: Sergey Krylov <ksv741@mail.ru>
Date: Fri, 14 Aug 2026 09:43:24 +0300
Subject: [PATCH] refactor: refactor foundation

---
 development/frontend-workflow.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 development/frontend-workflow.md

diff --git a/development/frontend-workflow.md b/development/frontend-workflow.md
new file mode 100644
index 0000000..84f25d2
--- /dev/null
+++ b/development/frontend-workflow.md
@@ -0,0 +1,18 @@
+# Frontend Workflow
+
+Frontend требует Node 22. В `frontend/` чистая установка и полный локальный quality gate выполняются так:
+
+```bash
+npm ci
+npm run verify
+```
+
+`verify` проверяет OpenAPI drift, TypeScript, Biome, unit tests и coverage, Knip, FSD dependency rules и production build. Он работает без backend.
+
+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.