chore: make OpenAPI export atomic and add read-only check (WealthLedger/backend#3)

2026-10-15 10:47:31 +03:00
parent 96d4de4195
commit 04abdc39ee
3 changed files with 45 additions and 11 deletions
@@ -218,7 +218,10 @@ nvm use --silent
 npm run openapi:generate
 ```

-Команда собирает backend и записывает `openapi.json` в корень репозитория.
+Команда собирает backend и записывает `openapi.json` в корень репозитория
+атомарно: через временный файл и rename, без частичной записи при сбое.
+`npm run openapi:check` только сравнивает runtime schema с файлом и завершается
+с ошибкой при расхождении, не перезаписывая его.
 Сервер и HTTP-порт не запускаются; Nest preview читает metadata без создания
 провайдеров и подключения к БД/T-Bank. Настроенный `.env` и реальные секреты
 не нужны. `openapi.json` исключён из Git и каждый раз создаётся из DTO/Swagger