Strategia branch
Scopo
Definire il flusso Git stile Odoo.sh e le protezioni CI/deploy per Ez FactoryOS.
Prerequisiti
- Accesso al repo
EzBit-Gh/Ez_FactoryOS_Frappe. - Secrets GitHub Environments configurati (vedi secrets).
Pipeline
mermaid
flowchart LR
feature["feature/*"] --> dev
dev -->|"PR + CI"| staging
staging -->|"PR + CI + review"| main
dev -.->|"VIETATO"| main| Branch | Scopo | Deploy |
|---|---|---|
dev | Sviluppo quotidiano | Locale (make up) + webhook Coolify opzionale |
staging | Validazione cliente | Coolify staging, immagine :staging / sha-* |
main | Produzione | Coolify production: promozione digest da staging, no rebuild |
Protezioni
main
- Push diretto bloccato; PR solo da
staging(block-dev-to-main.yml). - CI: lint, test Frappe, security, compose-validate, verify source=staging.
- GitHub Environment
productioncon approval. - Minimo 1 review.
staging
- PR da
devofeature/*. - Backup pre-deploy obbligatorio (
BACKUP_WEBHOOK_STAGING). - Post-deploy: migrate (configurator), health, staging-safety (manuale/istruzioni CI).
dev
- Push maintainer; CI su push; build immagine GHCR
:dev.
Checklist PR dev → staging
- [ ] Descrizione tecnica + impatto migrazioni
- [ ]
make test/make migratelocali OK - [ ] Nessun secret nel diff
- [ ] DocType JSON validi
- [ ] Docs aggiornate se cambia comportamento utente/ops
Checklist PR staging → main
- [ ] Tutti i check CI verdi
- [ ] Almeno 1 review
- [ ] Health staging OK (
/api/method/ping) - [ ] Digest immagine staging noto
- [ ] Backup staging verificato
Deploy e promozione
Runtime server: Coolify (secret ancora prefissati DOKPLOY_* per legacy).
Dettaglio: ADR-0004, Dokploy/Coolify setup, GitHub Actions.
Production: stesso artifact validato in staging (manifest OCI :staging → :main).
Verifica
bash
gh pr checks # su PR aperta
curl -fsS https://staging-factoryos.ezbit.it/api/method/pingRollback
Vedi infrastructure/rollback.
