FAQ e risoluzione dei problemi¶

Domande comuni e soluzioni per Stridevox.

Generale¶

A quali dati accede Stridevox dal mio account Garmin?

Stridevox legge le tue attività (corsa, bici, nuoto, ecc.), i dati del sonno (fasi, durata) e i riepiloghi giornalieri (passi, calorie, Body Battery, stress). Non accede a informazioni personali come nome, indirizzo o dati di pagamento.

I miei dati vengono inviati a terzi?

I tuoi dati fitness vengono inviati al provider IA che hai configurato (xAI, OpenAI, Anthropic, Google o Azure) come parte delle conversazioni chat. Non vengono condivisi con altri. Le tue credenziali Garmin e le chiavi API IA sono cifrate e memorizzate localmente sul tuo server.

Posso usare Stridevox senza un account Garmin?

Stridevox è progettato attorno all'integrazione con Garmin Connect. Senza un account Garmin, Dashboard, Attività, Grafici e Record personali non avranno dati. La Chat funzionerebbe, ma senza contesto fitness da analizzare.

Quali lingue supporta Stridevox?

L'interfaccia è disponibile in inglese, francese, spagnolo, italiano e tedesco. La chat IA può rispondere in qualsiasi lingua supportata dal tuo provider IA: basta impostare la lingua della chat o fare la domanda nella lingua preferita.

Problemi di connessione¶

Non riesco a collegarmi a Garmin: cosa devo fare?

Controlla le credenziali — Assicurati che l'email corrisponda al tuo account Garmin Connect
Codice MFA scaduto — I codici MFA Garmin scadono in circa 60 secondi. Clicca di nuovo su Connetti per richiederne uno nuovo
Rate limiting Garmin — Se hai fatto troppi tentativi, aspetta 2-3 minuti
Guasto Garmin — Controlla connect.garmin.com per verificare se Garmin è offline

I miei dati non compaiono dopo la sincronizzazione

Controlla lo stato della cache nelle Impostazioni per verificare che i dati siano stati davvero sincronizzati
Assicurati che il limite attività sia abbastanza alto da includere le attività attese
Prova un refresh completo per ricostruire la cache da zero
Controlla i job in background per eventuali sincronizzazioni fallite

La sincronizzazione è molto lenta

Le sincronizzazioni iniziali molto grandi (centinaia di attività) possono richiedere diversi minuti. Usa Accoda refresh completo per eseguirla in background e continuare a usare l'app. L'indicatore di avanzamento mostra a che punto è arrivata.

Chat IA¶

L'IA non conosce il mio allenamento recente

L'IA usa dati in cache. Se hai appena terminato un allenamento:

Aspetta che venga sincronizzato con Garmin Connect (controlla l'app Garmin)
Clicca Sincronizza dati (Veloce) nelle Impostazioni
Torna alla Chat e fai di nuovo la domanda

L'IA fornisce informazioni sbagliate sui miei dati

Assicurati che i dati siano sincronizzati e aggiornati
Prova ad avviare una nuova sessione chat (le sessioni molto lunghe accumulano contesto e possono confondere l'IA)
Prova un modello o provider IA diverso per confrontare il risultato
Verifica se il problema riguarda un allenamento specifico (potrebbe avere dati Garmin incompleti)

Posso cambiare provider IA a metà conversazione?

Sì. Cambiare provider nelle Impostazioni ha effetto immediato sui nuovi messaggi. La cronologia chat esistente viene conservata.

Come posso ridurre i costi dell'API IA?

Avvia nuove sessioni per argomenti non correlati (meno contesto = meno token)
Usa modelli più veloci/economici per domande semplici
Tieni i modelli avanzati per analisi approfondite

Attività¶

Perché alcune attività non hanno una mappa?

Le mappe richiedono dati GPS. Le attività indoor (tapis roulant, ciclismo indoor) e alcune attività create manualmente non hanno tracce GPS, quindi nessuna mappa viene mostrata.

Come funziona il confronto tra attività?

Seleziona da 2 a 5 attività usando la modalità Confronta, poi clicca Confronta ora. La tabella mostra le metriche chiave affiancate, con i valori migliori evidenziati.

Posso condividere un'attività con qualcuno che non usa Stridevox?

Sì. I link di condivisione delle attività sono pagine pubbliche consultabili da chiunque in un browser senza account. Puoi opzionalmente aggiungere password e data di scadenza.

Record personali¶

Perché i miei record personali non si vedono?

I record vengono calcolati dalle attività in cache. Assicurati di aver sincronizzato i dati
Clicca Ricalcola nella pagina Record personali per forzare l'aggiornamento
Solo alcuni tipi di attività valgono per i record (corsa, ciclismo, ecc.)

Un record sembra sbagliato: come lo correggo?

Clicca Ricalcola per ricostruire i record dai dati attuali in cache. Se i dati Garmin sottostanti sono errati, anche il record lo rifletterà.

Sicurezza¶

Ho perso l'app di autenticazione: come entro?

Usa uno dei tuoi codici di backup (se li hai salvati durante la configurazione del 2FA)
Se non hai codici di backup, chiedi a un amministratore di reimpostare l'MFA dal pannello admin
Dopo il reset MFA, potrai accedere con la sola password e, se vuoi, riattivare il 2FA

Ho dimenticato la password

Se hai impostato un indirizzo email: clicca Password dimenticata nella schermata di login e controlla la posta per il link di reset
Se non hai impostato un'email: chiedi a un amministratore di reimpostare la password dal pannello admin

Più persone possono usare Stridevox?

Sì. Il primo utente è l'amministratore e può creare altri account dal pannello admin. Ogni utente collega il proprio account Garmin e ha cronologia chat, impostazioni e dati separati.

Tecnico¶

Quale database usa Stridevox?

Stridevox supporta sia SQLite (predefinito, nessuna configurazione richiesta) sia PostgreSQL (per setup di produzione o multi-worker). SQLite è consigliato per installazioni singolo utente o piccoli team.

Posso eseguire Stridevox su un Raspberry Pi?

Stridevox è sufficientemente leggero per girare su Raspberry Pi 4 o successivi. Usa SQLite per il database e un modello IA più leggero per prestazioni migliori.

Come aggiorno Stridevox?

Scarica il codice più recente e riavvia:

cd stridevox
git pull origin master
cd backend
pip install -r requirements.txt
sudo systemctl restart stridevox

Per il frontend, copia i file aggiornati nella document root del tuo server web.

Dove vengono salvati i backup?

I backup sono archiviati nella directory backups/ dentro la cartella backend. Puoi anche scaricarli dalle Impostazioni per conservarli offline.