Backup & Restore¶

Un salvataggio regolare dei dati è importante. DiKAS offre sia il backup manuale sia quello automatico.

Creare un backup¶

Tramite l'interfaccia¶

Admin → Impostazioni → Sistema → Backup

Cliccare su „Crea backup"
DiKAS crea un file ZIP con:
*.jsonl.br — Tutti i documenti (compressi con Brotli)
attachments/ — Immagini e file allegati
Scaricare il file ZIP e conservarlo in modo sicuro

Tramite l'API¶

POST /api/v1/backup/create
Authorization: Bearer eyJ...

Cosa viene salvato?¶

Dati	Inclusi?
Articoli e gruppi	Sì
Clienti e credito	Sì
Personale	Sì
Tavoli e prenotazioni	Sì
Scontrini e chiusure giornaliere	Sì
Spese con giustificativi	Sì
Impostazioni	Sì
Buoni	Sì
Fatture e solleciti	Sì
Ordini di officina	Sì
Dati Disco	Sì
Immagini degli articoli	Sì
Documenti dei clienti	Sì

Restore (ripristino)¶

Ripristino completo¶

Admin → Impostazioni → Sistema → Ripristina

Caricare il file ZIP (max. 500 MB)
Cliccare su „Ripristina tutto"
La barra di avanzamento mostra il progresso
Al termine: accedere nuovamente

Attenzione: Un ripristino completo sovrascrive tutti i dati attuali!

Ripristino selettivo¶

È possibile selezionare quali dati ripristinare:

Categoria	Contenuti	Quando è utile?
Articoli	Articoli, gruppi, modelli di opzioni	Ripristinare il menu
Clienti	Clienti, transazioni	Ripristinare i dati dei clienti
Personale	Dipendenti, rilevazione presenze	Anagrafica del personale
Tavoli	Tavoli, gruppi, prenotazioni	Pianta tavoli
Impostazioni	Configurazione, stampanti, modelli	Dopo una reinstallazione
Dati di fatturato	Scontrini, spese, chiusure giornaliere	Dati storici
Disco	Ospiti, gruppi d'ingresso	Modulo Disco
Officina	Ordini	Modulo Officina

Suggerimento: Utilizzare il ripristino selettivo per ripristinare, ad esempio, solo il menu da un backup senza perdere gli attuali dati di cassa.

Svolgimento del ripristino¶

Upload → Entpacken → Kategorie-Filter → Dokumente einfügen → Anhänge wiederherstellen
                                           ↓
                                    Fortschritt via SignalR
                                    (Echtzeit-Balken im Browser)

Backup automatico (consigliato)¶

Per i sistemi in produzione consigliamo un backup automatico:

Tramite cron job (Linux)¶

# Tägliches Backup um 4:00 Uhr
0 4 * * * curl -s -X POST http://localhost:5015/api/v1/backup/create \
  -H "Authorization: Bearer $TOKEN" \
  -o /backup/dikas_$(date +\%Y\%m\%d).zip

Salvare il volume Docker¶

# CouchDB-Daten sichern
docker run --rm -v couchdb-data:/data -v /backup:/backup \
  alpine tar czf /backup/couchdb_$(date +%Y%m%d).tar.gz /data

Migrazione del database¶

Da CouchDB a SQLite/SQL Server¶

Se si desidera cambiare il database:

POST /api/v1/couch-to-sql/migrate
Content-Type: application/json

{
  "couchDbUrl": "http://localhost:5984",
  "couchDbUser": "admin",
  "couchDbPassword": "password"
}

Tutti i dati vengono trasferiti da CouchDB al database SQL. Gli allegati vengono copiati nel file system.

Passo successivo¶

→ TSE & Agenzia delle Entrate — Conformità KassenSichV