Modalità offline

Scripvio è pensato offline-first: la maggior parte del tuo lavoro personale (note, diario, monitoraggio) può continuare senza rete. I dati vengono prima salvati sul dispositivo, poi sincronizzati con il tuo account quando Internet torna.

Questa guida spiega cosa funziona offline, cosa richiede una connessione e come leggere i banner dell’app.

→ Sincronizzazione · FAQ offline

Principio offline-first

flowchart LR
  U[Tu] --> L[Archivio locale SQLite]
  L --> Q[Coda]
  Q -->|Rete OK| S[Server Scripvio]
  S --> L

Fase	Dove
Inserimento	Immediato sul telefono
Coda	Creazioni, modifiche, eliminazioni in attesa
Invio	Automatico al ritorno della rete

In genere non devi premere un pulsante « Sincronizza »: l’app tenta l’invio appena la connessione torna.

Un banner compatto può apparire in alto su più schermate (soprattutto Crea, Biblioteca, editor note/diario) quando la rete o la sync lo richiede.

Messaggio (etichetta app)	Significato	Colore / icona
Sincronizzazione con il server…	Invio in corso	Primario, icona sync
Nessuna connessione. Le tue modifiche sono salvate su questo dispositivo…	Offline — lavoro locale OK	Allerta, nuvola barrata
Alcune modifiche sono in attesa di sincronizzazione con il server.	Online ma coda non vuota	Secondario
Sincronizzazione non riuscita. Le tue modifiche restano su questo dispositivo…	Ultimo invio fallito — nuovo tentativo automatico	Errore

Priorità di visualizzazione: sync in corso → offline → errore → in attesa.

→ Sincronizzazione

Cosa puoi fare offline

Note (bozze)

Azione	Offline
Creare una nota	✅ (identificatore temporaneo `local_…`)
Modificare titolo, sezioni, contenuto	✅ (autosalvataggio locale)
Aggiungere / riordinare sezioni	✅ (`local_section_…` se necessario)
Riferimenti biblici strutturati	⚠️ Limitato — metadati Bibbia richiesti online
Passaggio in testo libero nella nota	✅
Pubblica	⏳ Pubblicazione in coda (offline). — applicata alla sync
Esporta PDF	❌ Connessione + nota non `local_` — vedi sotto

Note di culto o di studio — offline e sincronizzate. (hub Crea)

→ Note — bozze e pubblicazione

Diario (bozze)

Azione	Offline
Creare / modificare una voce	✅
Umore, etichette, testo	✅
Pubblica	⏳ Pubblicazione in coda (offline).
Riferimenti biblici strutturati	⚠️ I riferimenti biblici saranno disponibili dopo la sincronizzazione di questa voce con il tuo account.
Collegare attività Monitoraggio	❌ Il collegamento richiede una connessione internet.

→ Diario — bozze e pubblicazione

Biblioteca (pubblicato)

Azione	Offline
Leggere note / diario già sincronizzati	✅ (cache locale)
Vedere elenco, ricerca, preferiti	✅ su dati in cache
Nuovo contenuto da un altro dispositivo	❌ fino a sync + aggiornamento
Nuova versione… / modifica pubblicata	Dipende dalla cache — pubblicazione spesso in coda

Offline — i totali riguardano solo le note disponibili su questo dispositivo. (contatori elenco Crea)

→ Biblioteca

Monitoraggio

Azione	Offline
Aggiungere lettura / preghiera / meditazione	✅ (voci locali in attesa)
Dashboard	Parziale — calendario: La vista mensile può essere parziale offline…
Collegare al diario	❌ dopo la creazione — messaggio offline possibile

→ Monitoraggio

Home

Elemento	Offline
Ripresa bozze locali	✅
Statistiche note	Offline — nessuna statistica locale possibile
Indizio dashboard	Alcuni dati richiedono una connessione (ricerca, diario aggiornato).

Connessione richiesta (o fortemente consigliata)

Esigenza	Perché
Prima connessione / creazione account	Autenticazione server
Ricerca biblica (nuova ricerca)	API Bibbia — Sei offline — la nuova ricerca biblica non è disponibile…
Lettura passaggio Bibbia (foglio)	Connessione richiesta per visualizzare questo passaggio.
Export PDF nota	È necessaria una connessione di rete per esportare il PDF. + nota non `local_`
Profilo (nome, foto, lingua account)	Offline — le modifiche al profilo sono disabilitate
Notifiche account (interruttori)	Spesso disattivati offline
Aggiungere versetto da Ricerca a nota/diario	API
Eliminazione account	Disattivata offline

Ricerca: cache locale

Offline, puoi ancora aprire l’ultima ricerca salvata sul dispositivo: Visualizzazione dell’ultima ricerca salvata su questo dispositivo.

→ Ricerca biblica

Export PDF e sync

Se alcune modifiche non sono ancora inviate:

Sincronizza prima dell’esportazione — Alcune modifiche non sono ancora sincronizzate. Sincronizzare ora per includere l’ultima versione nel PDF?

Pulsante	Effetto
Sincronizza ora	Avvia la coda poi export
Annulla	Abbandona l’export

Salva o sincronizza la nota prima di esportare. se la nota è ancora local_….

Identificatori temporanei (`local_…`)

Finché una creazione non è confermata dal server, Scripvio usa id locali:

Prefisso	Esempio d’uso
`local_…`	Nota creata offline
`local_section_…`	Sezione nuova
`local_verse_…`	Riferimento biblico in attesa

Dopo sync riuscita, l’app sostituisce con l’id server — continui a lavorare senza cambiare schermata.

Disconnessione offline

Se esci senza rete, Scripvio avvisa che i dati locali (incluse note non sincronizzate) possono essere eliminati dal dispositivo.

→ Profilo — disconnessione

Buone pratiche

Consiglio	Motivo
Attendere la fine del banner Sincronizzazione… prima di un PDF importante	PDF = versione server
Evitare due dispositivi in parallelo offline sulla stessa nota	L’ultimo invio può prevalere
Tenere l’app aperta qualche secondo dopo il Wi‑Fi	Lascia svuotare la coda
Verificare il banner prima di un culto senza rete	Sapere se parti al 100 % locale

Errori frequenti

Sintomo	Spiegazione	Azione
Biblioteca « bloccata »	Cache locale	Riconnetti, aggiorna (pull)
Nota pubblicata assente online	Pubblicazione ancora in coda	Attendi sync
Riferimento Bibbia disattivato	Nessun metadato offline	Torna online o testo libero
Banner errore persistente	API o rete instabile	Riprova più tardi; contenuto resta locale
PDF rifiutato	`local_` o nessuna rete	Sync poi riesporta

Domande frequenti

Posso usare Scripvio in aereo senza prepararmi?
Sì per creare e modificare; la Biblioteca mostrerà solo ciò che era già sul dispositivo.

L’offline è illimitato nel tempo?
I dati restano sul dispositivo fino a sync o disconnessione (che può cancellare il locale).

Scripvio funziona senza account offline?
No — devi esserti connesso almeno una volta per avere sessione + cache.

Guide correlate

Argomento	Link
Sync dettagliata	Sincronizzazione
FAQ	Offline e sync
Note	Note — presentazione
Supporto	Contattaci