crank/docs/community-release-checklist.md

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-манифесте
• optional valkey profile как рекомендованный, но не обязательный cache layer
• 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
   • docker compose -f deploy/community/docker-compose.yml --env-file deploy/community/.env.example --profile cache 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 границы.

Они должны иметь:

• отдельный public repository crank-community;
• отдельные private repositories;
• отдельные manifests;
• отдельные release pipelines;
• отдельные operator docs.

До создания:

• crank-community
• 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 воспроизводим на чистом хосте;
• базовый запуск и запуск с profile cache оба валидны;
• staging smoke записан в regression notes.

8. Связанные документы

• docs/product-editions.md
• docs/commercial-boundaries.md
• docs/repository-split-map.md
• docs/deployment.md
• docs/deploy-and-staging-smoke.md
• docs/authenticated-staging-pass.md
• docs/implementation-plan.md