Skip to content

ADR-0006: Pannello control.factoryos.ezbit.it come microservizio separato ​

Status ​

Accepted (2026-09)

Context ​

Serve un cruscotto stile odoo.sh + Railway per gestire i tre ambienti Ez FactoryOS (dev, staging, main) da control.factoryos.ezbit.it: stato container/servizi, backup/restore con storico, promozione dev → staging → main con un click, rebuild staging da dev o main. La CI/CD esistente (GitHub Actions + Coolify webhook + immagini GHCR) deve restare invariata. Su Coolify esistono ez-factoryos-staging e ez-factoryos-production, manca il servizio development.

Decision ​

  • Microservizio Docker separato (FastAPI + pagina statica minimale), deployato su Coolify come compose custom nel progetto Ez FactoryOS, dominio control.factoryos.ezbit.it via proxy Traefik Coolify.
  • Il pannello non esegue deploy di codice direttamente: la promozione crea e mergia PR GitHub (dev → staging, staging → main); il deploy resta ai workflow esistenti. Vietato dev → main diretto, come block-dev-to-main.yml.
  • Stato servizi via Coolify API v1; operazioni bench (backup, restore, migrate) via SSH con chiave dedicata (docker exec sui container backend-<uuid> / db-<uuid>).
  • Backup su disco VPS in /data/factoryos-backups/{dev,staging,main}/ ( volumi Coolify), manifest.json + storico SQLite, retention 7 giornalieri
    • 4 settimanali, job giornaliero ore 03:30.
  • Rebuild staging = codice + dati: redeploy CUSTOM_TAG sorgente via Coolify API, restore ultimo backup sorgente, migrate, anonymize + staging-safety.
  • Auth: HTTP Basic + header X-Control-Token per azioni mutative, audit log append-only. Nessun endpoint guest.
  • Ambiente dev su Coolify: nuovo servizio ez-factoryos-development da coolify.development.yml (generato con uuid placeholder fino a creazione servizio), env da .env.development.server.example.

Consequences ​

  • Nessuna modifica ai workflow deploy esistenti, solo lettura stato via GitHub API.
  • Nuova superficie operativa: token Coolify, token GitHub, chiave SSH dedicata come secret Coolify (mai in repo).
  • Restore main da dev vietato senza flag esplicito + doppia conferma.
  • Codice pannello: deploy/control/.
  • Metriche host (disco/RAM via SSH) in dashboard; alert webhook opzionale CONTROL_ALERT_WEBHOOK_URL su transizione a red.
  • Verify backup settimanale/API verso staging; CloudBeaver su https://db.factoryos.ezbit.it collegato da Portali/Accessi.

References ​

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