docs: add community release checklist

2026-05-03 19:45:13 +00:00
parent 101229d3f4
commit 17d9c42521
6 changed files with 129 additions and 1 deletions
@@ -0,0 +1,111 @@
+# Community release checklist
+
+## 1. Назначение документа
+
+Этот документ фиксирует канонический release path только для открытой редакции `Community`.
+
+Он нужен, чтобы:
+
+- не смешивать Community delivery с будущей коммерческой поставкой;
+- дать reproducible checklist для public release;
+- зафиксировать, какие артефакты считаются source of truth именно для открытой редакции.
+
+## 2. Source of truth для Community release
+
+Для открытой редакции каноническими считаются:
+
+- `deploy/community/docker-compose.yml`
+- `deploy/community/.env.example`
+- `.github/workflows/ci.yml`
+- `.github/workflows/deploy.yml`
+- `docs/deployment.md`
+- `docs/deploy-and-staging-smoke.md`
+- `docs/authenticated-staging-pass.md`
+
+Root-файлы:
+
+- `docker-compose.yml`
+- `.env.example`
+
+считаются только convenience-слоем для локальной разработки и не должны использоваться как
+основа будущей коммерческой упаковки.
+
+## 3. Что обязательно входит в Community release
+
+Community release должен поставлять:
+
+- `ui`
+- `admin-api`
+- `mcp-server`
+- `postgres` как runtime dependency в compose-манифесте
+- healthchecks
+- базовый self-hosted deployment path
+- capability-gated UI, который не притворяется коммерческой редакцией
+
+## 4. Чего не должно быть в Community release
+
+В Community release нельзя включать:
+
+- private container images;
+- private `Helm` charts;
+- hosted control-plane services;
+- enterprise-only auth/governance services;
+- private token issuer implementations;
+- manifests, которые пытаются быть общими одновременно для Community и коммерческой поставки.
+
+## 5. Community release workflow
+
+Перед выпуском нужно проверить:
+
+1. `CI` зеленый.
+2. Community deployment manifest валиден:
+   - `docker compose -f deploy/community/docker-compose.yml --env-file deploy/community/.env.example config -q`
+3. Docker image build проходит для:
+   - `admin-api`
+   - `mcp-server`
+   - `ui`
+4. Deploy workflow использует именно `deploy/community/docker-compose.yml`.
+5. Post-deploy smoke выполнен по:
+   - `docs/deploy-and-staging-smoke.md`
+   - `docs/authenticated-staging-pass.md`
+
+## 6. Правило для будущих коммерческих редакций
+
+`Enterprise` и `Cloud` не должны проектироваться как:
+
+- другой `.env` поверх `deploy/community/docker-compose.yml`;
+- скрытые feature flags внутри Community release path;
+- дополнительные сервисы, “подмешанные” в те же public manifests без отдельной delivery границы.
+
+Они должны иметь:
+
+- отдельные private repositories;
+- отдельные manifests;
+- отдельные release pipelines;
+- отдельные operator docs.
+
+До создания:
+
+- `crank-enterprise`
+- `crank-cloud`
+
+нельзя считать physical packaging split завершенным.
+
+## 7. Минимальный operator checklist
+
+Перед публикацией Community release нужно подтвердить:
+
+- capability matrix совпадает с `docs/product-editions.md`;
+- UI не показывает рабочими premium-only сценарии;
+- `admin-api` и `mcp-server` enforce capability limits на сервере;
+- public deployment path воспроизводим на чистом хосте;
+- staging smoke записан в regression notes.
+
+## 8. Связанные документы
+
+- `docs/product-editions.md`
+- `docs/commercial-boundaries.md`
+- `docs/deployment.md`
+- `docs/deploy-and-staging-smoke.md`
+- `docs/authenticated-staging-pass.md`
+- `docs/implementation-plan.md`