Cache e gestione dati¶
Stridevox mantiene in cache i dati Garmin localmente per un accesso rapido. Questa pagina spiega come funziona la cache e come gestire i dati.
Come funziona la cache¶
Quando sincronizzi con Garmin, Stridevox scarica i dati fitness e li salva nel database locale. Questo significa:
- accesso veloce
- consultazione anche se Garmin è lento
- meno chiamate API verso Garmin
Impostazioni cache¶
Configura quanti dati tenere in Impostazioni > Garmin Connect.
Limite attività¶
- Default: 100 attività
- Massimo: 10.000
- controlla quante attività tenere in locale
Intervallo giorni¶
- Default: 30 giorni
- Massimo: 365 giorni
- controlla quanti giorni di riepiloghi giornalieri e sonno conservare
Operazioni di sincronizzazione¶
Sincronizzazione incrementale¶
Sincronizza dati (Veloce) recupera solo i dati nuovi:
- nuove attività
- riepiloghi giornalieri recenti
- dati sonno mancanti
Refresh completo¶
Refresh completo svuota la cache e riscarica tutto:
- elimina tutti i dati in cache
- riscarica attività fino al limite configurato
- riscarica riepiloghi e sonno per l'intervallo impostato
Svuota cache¶
Elimina tutte le attività, i dati sonno e i riepiloghi giornalieri senza riscaricarli.
Job in background¶
Per sincronizzazioni grandi puoi usare:
- Accoda refresh completo
- Accoda incrementale
Monitorare i job¶
| Stato | Significato |
|---|---|
| In attesa | Il job è in coda |
| In esecuzione | Il job sta sincronizzando |
| Completato | Il job è terminato con successo |
| Fallito | Il job ha generato un errore |
Azioni sui job¶
- Aggiorna — aggiorna la lista
- Annulla — interrompe un job
- Riprova — rilancia un job fallito
Stato della cache¶
La sezione Gestione dati mostra:
- numero di attività in cache
- numero di record sonno
- numero di riepiloghi giornalieri
- ultimo timestamp di sync
Buone pratiche¶
Strategia consigliata
- Setup iniziale: imposta il limite attività e usa Accoda refresh completo
- Aggiornamenti regolari: usa Sincronizza dati (Veloce) dopo i workout
- Troubleshooting: se i dati sembrano errati, usa Refresh completo
Limiti Garmin
Garmin applica rate limit. Se li raggiungi, aspetta 2–3 minuti prima di riprovare.