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.itvia 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. Vietatodev → maindiretto, comeblock-dev-to-main.yml. - Stato servizi via Coolify API v1; operazioni bench (
backup,restore,migrate) via SSH con chiave dedicata (docker execsui containerbackend-<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_TAGsorgente via Coolify API, restore ultimo backup sorgente, migrate, anonymize + staging-safety. - Auth: HTTP Basic + header
X-Control-Tokenper azioni mutative, audit log append-only. Nessun endpoint guest. - Ambiente dev su Coolify: nuovo servizio
ez-factoryos-developmentdacoolify.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_URLsu transizione a red. - Verify backup settimanale/API verso staging; CloudBeaver su
https://db.factoryos.ezbit.itcollegato da Portali/Accessi.
