Skip to content

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
BranchScopoDeploy
devSviluppo quotidianoLocale (make up) + webhook Coolify opzionale
stagingValidazione clienteCoolify staging, immagine :staging / sha-*
mainProduzioneCoolify 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 production con approval.
  • Minimo 1 review.

staging ​

  • PR da dev o feature/*.
  • 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 migrate locali 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/ping

Rollback ​

Vedi infrastructure/rollback.

Ez FactoryOS — MES per Ortobellina / OP Raggio di Sole · App Frappe v16 ez_factoryos