spec: define versioned deployment bundle

2026-09-20 18:49:25 +03:00
parent e7a3c30b5d
commit 7f40372c3f
5 changed files with 458 additions and 0 deletions
@@ -0,0 +1,40 @@
+## Why
+
+После выпуска компонентов оператор вручную выбирает совместимые версии
+и повторяет порядок обновления. Нужен один выбранный релиз всей установки
+и одна команда, сохраняющая данные и настройки существующего сервера.
+
+## What Changes
+
+- Версионируемый комплект закрепляет проверенную пару версий интерфейса и API.
+- Оператор явно выбирает релиз; публикация компонента не обновляет сервер.
+- Обновление выполняется одной командой с предварительными проверками,
+  сохранением данных и диагностируемым результатом.
+- Обновление только интерфейса не прерывает работу API и не затрагивает базу.
+- Перед обновлением API создаётся согласованная резервная копия. Неудачное
+  обновление не запускает автоматическое восстановление или откат.
+- Инструкция охватывает подготовку сервера, первую установку, подключение
+  существующей установки, выпуск комплекта, обновление и ручное восстановление.
+
+Non-goals: настройка серверной инфраструктуры командой развёртывания,
+автоматическое обновление по выходу компонента, непрерывная доступность,
+несколько экземпляров API, автоматическая очистка копий и внешнее backup-хранилище.
+
+## Capabilities
+
+### New Capabilities
+
+- `specs/deployment-bundle/spec.md`: выбор полного релиза, безопасная автоматизация
+  обновления и сохранение существующей установки.
+
+### Modified Capabilities
+
+Нет. Новый контракт дополняет контейнерную поставку; существующий active change
+`containerized-application-delivery` и его capability `application-delivery`
+не изменяются и не архивируются в рамках этой работы.
+
+## Impact
+
+Основной пользователь — оператор одной установки WealthLedger. Изменяются
+комплект развёртывания, эксплуатационная документация и требования к обновлению.
+Прикладные функции интерфейса и API остаются прежними.