Benvenuto in Obelica

Obelica e' il droplet DigitalOcean che sta diventando il centro operativo self-hosted di Obelica.

Questa documentazione descrive lo stato reale del server, le regole operative, le decisioni architetturali e il percorso per arrivare a una produzione sicura, mantenibile e affidabile.

Ultimo inventario: 2026-06-22.

Fonte di verita'

Questo repository, bona/obelica-docs, e' la fonte di verita' tecnica per Obelica VPS.

La vecchia cartella host-side /opt/obelica/docs e il framework locale sul Mac non devono contenere documentazione tecnica duplicata. Devono rimandare a questo Fumadocs.

Argomenti principali

• Stato attuale
• Inventario tecnico
• Architettura
• Sicurezza
• Servizi
• App candidate staging
• Database
• Repository
• Backup e restore
• Backup con obelica-backup
• Operazioni e runbook
• Uso disco
• Cron job
• Migrazioni app
• Roadmap produzione

Regole di documentazione

• Non salvare password, token, chiavi private, cookie o API key in questa docs.
• I file sotto /opt/obelica/secrets sono documentati solo per path e nomi variabili.
• Ogni cambio infrastrutturale deve aggiornare la pagina del servizio, il runbook operativo e, se rilevante, audit o decision log.
• Le app si documentano nel dettaglio solo quando diventano oggetto di lavoro reale.
• Per la governance della documentazione, vedi Documentazione operativa.