Preguntas frecuentes y solución de problemas¶

Preguntas comunes y soluciones para Stridevox.

General¶

¿A qué datos accede Stridevox de mi cuenta Garmin?

Stridevox lee tus actividades (carreras, salidas en bici, natación, etc.), datos de sueño (fases, duración) y resúmenes diarios (pasos, calorías, Body Battery, estrés). No accede a información personal como tu nombre, dirección o datos de pago.

¿Se envían mis datos a terceros?

Tus datos de fitness se envían al proveedor de IA que hayas configurado (xAI, OpenAI, Anthropic, Google o Azure) como parte de las conversaciones del chat. No se comparten con nadie más. Tus credenciales de Garmin y claves API de IA se cifran y almacenan localmente en tu servidor.

¿Puedo usar Stridevox sin una cuenta Garmin?

Stridevox está diseñado en torno a la integración con Garmin Connect. Sin una cuenta Garmin, el Panel de control, las Actividades, los Gráficos y los Récords personales no tendrán datos. La función de Chat funcionaría, pero no tendría contexto de fitness para analizar.

¿Qué idiomas soporta Stridevox?

La interfaz está disponible en inglés, francés y español. El chat con IA puede responder en cualquier idioma soportado por tu proveedor de IA; simplemente configura el idioma del chat o pregunta en tu idioma preferido.

Problemas de conexión¶

No puedo conectarme a Garmin — ¿qué debo hacer?

Verifica tus credenciales — Asegúrate de que el correo electrónico coincida con tu cuenta de Garmin Connect
El código MFA expiró — Los códigos MFA de Garmin expiran en ~60 segundos. Haz clic en Conectar de nuevo para obtener un nuevo código
Límite de tasa de Garmin — Si has hecho demasiados intentos, espera 2–3 minutos
Interrupción de Garmin — Consulta connect.garmin.com para ver si Garmin está fuera de servicio

Mis datos no aparecen después de la sincronización

Comprueba el estado de la caché en Configuración para verificar que los datos se sincronizaron realmente
Asegúrate de que el límite de actividades sea lo suficientemente alto para incluir las actividades que esperas
Prueba una actualización completa para reconstruir la caché desde cero
Revisa los trabajos en segundo plano para buscar trabajos de sincronización fallidos

La sincronización tarda mucho

Las sincronizaciones iniciales grandes (cientos de actividades) pueden tardar varios minutos. Usa Encolar actualización completa para ejecutarla como un trabajo en segundo plano y poder seguir usando la aplicación. El indicador de progreso muestra cuánto ha avanzado.

Chat con IA¶

La IA no sabe sobre mi entrenamiento reciente

La IA usa datos en caché. Si acabas de terminar un entrenamiento:

Espera a que se sincronice con Garmin Connect (comprueba la app de Garmin)
Haz clic en Sincronizar datos (Rápido) en Configuración
Vuelve al Chat y pregunta de nuevo

La IA da información incorrecta sobre mis datos

Asegúrate de que tus datos estén sincronizados y actualizados
Prueba a iniciar una nueva sesión de chat (las sesiones largas acumulan contexto que puede confundir a la IA)
Prueba con un modelo o proveedor de IA diferente para comparar
Comprueba si el problema es específico de un entrenamiento (puede tener datos incompletos de Garmin)

¿Puedo cambiar el proveedor de IA a mitad de conversación?

Sí. Cambiar el proveedor en Configuración surte efecto inmediato para los nuevos mensajes. Tu historial de chat existente se conserva.

¿Cómo puedo reducir los costes de la API de IA?

Inicia nuevas sesiones de chat para temas no relacionados (menos contexto = menos tokens)
Usa modelos más rápidos/económicos (p. ej., Gemini Flash, GPT-3.5) para preguntas simples
Reserva los modelos detallados para análisis en profundidad

Actividades¶

¿Por qué algunas actividades no tienen mapa?

Los mapas requieren datos GPS. Las actividades de interior (carreras en cinta, ciclismo indoor) y algunas actividades creadas manualmente no tienen trazas GPS, por lo que no se muestra ningún mapa.

¿Cómo funciona la comparación de actividades?

Selecciona de 2 a 5 actividades usando el modo Comparar, luego haz clic en Comparar ahora. La tabla de comparación muestra las métricas clave lado a lado con los mejores valores resaltados. Los mejores resultados están codificados por colores para una fácil identificación.

¿Puedo compartir una actividad con alguien que no usa Stridevox?

¡Sí! Los enlaces de actividades compartidas son páginas públicas que cualquier persona puede ver en un navegador sin una cuenta. Opcionalmente puedes añadir una contraseña y una fecha de expiración.

Récords personales¶

¿Por qué no se muestran mis récords personales?

Los récords se calculan a partir de tus actividades en caché. Asegúrate de que has sincronizado tus datos
Haz clic en Recalcular en la página de Récords personales para forzar una actualización
Solo ciertos tipos de actividades califican para récords (carrera, ciclismo, etc.)

Un récord parece incorrecto — ¿cómo lo corrijo?

Haz clic en Recalcular para reconstruir los récords a partir de tus datos actuales en caché. Si los datos subyacentes de Garmin son incorrectos, el récord lo reflejará.

Seguridad¶

He perdido mi app de autenticación — ¿cómo inicio sesión?

Usa uno de tus códigos de respaldo (si los guardaste durante la configuración de 2FA)
Si no tienes códigos de respaldo, pide a un administrador que restablezca tu MFA desde el Panel de administración
Después del restablecimiento de MFA, puedes iniciar sesión solo con tu contraseña y opcionalmente volver a activar la 2FA

He olvidado mi contraseña

Si tienes un correo electrónico configurado: Haz clic en ¿Olvidaste tu contraseña? en la pantalla de inicio de sesión y revisa tu correo para obtener un enlace de restablecimiento
Si no tienes un correo electrónico configurado: Pide a un administrador que restablezca tu contraseña desde el Panel de administración

¿Pueden varias personas usar Stridevox?

¡Sí! El primer usuario es el administrador y puede crear cuentas adicionales desde el Panel de administración. Cada usuario conecta su propia cuenta Garmin y tiene su propio historial de chat, configuración y datos.

Técnico¶

¿Qué base de datos usa Stridevox?

Stridevox soporta tanto SQLite (por defecto, sin configuración necesaria) como PostgreSQL (para entornos de producción/multi-worker). SQLite se recomienda para despliegues de un solo usuario o equipos pequeños.

¿Puedo ejecutar Stridevox en una Raspberry Pi?

Stridevox es lo suficientemente ligero para ejecutarse en una Raspberry Pi 4 o posterior. Usa SQLite para la base de datos y un modelo de IA más ligero para el mejor rendimiento.

¿Cómo actualizo Stridevox?

Descarga el código más reciente y reinicia:

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

Para el frontend, copia los archivos actualizados a la raíz de documentos de tu servidor web.

¿Dónde se almacenan mis copias de seguridad?

Las copias de seguridad se almacenan en el directorio backups/ dentro de la carpeta del backend. También puedes descargarlas desde Configuración para almacenamiento offline.