docs: document runtime OpenAPI verification

2026-08-23 21:22:57 +03:00
parent d870d535d7
commit 7a3048c347
1 changed files with 3 additions and 0 deletions
@@ -13,6 +13,9 @@ npm run verify

 Node 22 обязателен (`.nvmrc`). `npm run openapi:sync` - единственная команда, обращающаяся к `${VITE_API_BASE_URL:-http://localhost:3000}/api/docs-json`; она атомарно обновляет snapshot и generated types. `openapi:generate` и `openapi:check` работают только с committed snapshot.

+Для read-only сверки backend runtime OpenAPI с committed snapshot под Node 22
+запускать из workspace `bash specs/scripts/verify-runtime-openapi.sh`.
+
 ## Документация для агента

 - Перед изменением API или transport types прочитать [`docs/API-LAYER.md`](docs/API-LAYER.md).