analytics catalog

apps/mobile_app/docs/analytics-catalog.md

@@ -0,0 +1,351 @@
+# Catálogo de Eventos — SaveFamily
+
+> Documento para el equipo de Marketing. Lista todos los eventos que la app registra y describe el momento exacto en que se dispara cada uno.
+
+---
+
+## Índice
+
+1. [Pantallas de la app](#pantallas-de-la-app)
+2. [Autenticación](#autenticación)
+3. [Cuenta](#cuenta)
+4. [Alta de dispositivo (reloj/wearable del niño)](#alta-de-dispositivo)
+5. [Funciones del dispositivo](#funciones-del-dispositivo)
+6. [Contactos del dispositivo](#contactos-del-dispositivo)
+7. [Ajustes del dispositivo](#ajustes-del-dispositivo)
+8. [Soporte](#soporte)
+9. [Onboarding](#onboarding)
+10. [Panel principal (home)](#panel-principal)
+11. [Ubicación y mapa](#ubicación-y-mapa)
+
+---
+
+## Pantallas de la app
+
+Cada vez que el usuario navega a una pantalla, queda registrada
+automáticamente. También se registran los cambios entre pestañas del menú
+inferior.
+
+Pantallas registradas:
+
+- Pantalla de carga inicial
+- Onboarding / intro
+- Login
+- Alta de cuenta (signup)
+- Recuperación de contraseña
+- Wizard de alta de reloj/dispositivo
+- Inicio de vinculación de teléfono
+- Verificación del código de vinculación
+- Dashboard principal (home)
+- Soporte / atención al cliente
+- Menú de cuenta
+- Editar datos personales
+- Cambiar contraseña
+- Dispositivos vinculados a la cuenta
+- Sub-usuarios de la app
+- Eliminación de cuenta
+- Menú de gestión del dispositivo
+- Actividades programadas
+- Contactos
+- Editar contacto
+- Salud (ritmo cardíaco, oxígeno en sangre)
+- Conexión remota (cámara y llamada)
+- Localizar dispositivo
+- Recompensas
+- Medidor de actividad / pasos
+- Uso de aplicaciones
+- Control de volumen
+- Historial de llamadas
+- Imagen de fondo del dispositivo
+- Mapa de ubicación
+- Chat
+- Menú de ajustes
+- Alarmas
+- Gestión remota
+- Contactos SOS
+- Sonido del dispositivo
+- Sincronización del reloj
+- Gestión de apps instaladas
+- Batería / modo nocturno
+- Bloqueo de teléfono (whitelist)
+- Desactivar funciones (teclado, GPS)
+- Idioma del dispositivo
+- Notificaciones del dispositivo
+- Encendido/apagado remoto
+- Alertas
+- Zona horaria
+- Configuración WiFi
+
+---
+
+## Autenticación
+
+### Login
+
+- **legacy_auth_login_attempt** — El usuario pulsa "Iniciar sesión" después de completar el formulario.
+- **legacy_auth_login_success** — Email y contraseña aceptados (todavía falta el segundo factor).
+- **legacy_auth_login_failure** — El intento de login fue rechazado.
+
+### Doble factor (2FA)
+
+- **legacy_auth_2fa_requested** — Se le envió el código de verificación al usuario.
+- **legacy_auth_2fa_verified** — El código fue aceptado y la sesión está activa (login completado).
+- **legacy_auth_2fa_failure** — El código fue rechazado (incorrecto o expirado).
+- **legacy_auth_2fa_resend** — El usuario pidió que le reenvíen el código.
+
+### Alta de cuenta (signup)
+
+El alta es un wizard de 3 pasos.
+
+- **legacy_auth_signup_started** — El usuario envió el formulario final del alta.
+- **legacy_auth_signup_completed** — La cuenta se creó exitosamente.
+- **legacy_auth_signup_failed** — El alta falló.
+- **legacy_auth_signup_step_completed** — El usuario completó un paso del wizard y avanzó al siguiente.
+- **legacy_auth_signup_step_back** — El usuario volvió al paso anterior dentro del wizard.
+- **legacy_auth_signup_step_validation_failed** — El usuario intentó avanzar pero el formulario tenía errores.
+
+### Recuperación de contraseña
+
+- **legacy_auth_password_reset_requested** — El usuario inició el flujo de "olvidé mi contraseña".
+- **legacy_auth_password_reset_email_sent** — Se envió el email con el enlace de recuperación.
+- **legacy_auth_password_reset_completed** — El usuario guardó exitosamente su nueva contraseña.
+- **legacy_auth_password_reset_failed** — El intento de guardar la nueva contraseña falló.
+
+### Vinculación de teléfono
+
+- **legacy_auth_link_phone_code_requested** — El usuario envió su número y pidió el código.
+- **legacy_auth_link_phone_code_request_failed** — Falló el envío del código.
+- **legacy_auth_link_phone_code_verified** — El código fue verificado, número vinculado.
+- **legacy_auth_link_phone_code_verification_failed** — El código no fue aceptado.
+
+### Cierre de sesión
+
+- **legacy_auth_logout** — El usuario cerró sesión.
+
+---
+
+## Cuenta
+
+- **legacy_account_personal_data_edited** — El usuario guardó cambios en sus datos personales (nombre, apellido, teléfono).
+- **legacy_account_password_changed** — El usuario cambió su contraseña exitosamente.
+- **legacy_account_password_change_failed** — El cambio de contraseña falló.
+- **legacy_account_linked_device_unlinked** — El usuario quitó un dispositivo vinculado de su cuenta.
+- **legacy_account_linked_device_renamed** — El usuario renombró un dispositivo vinculado.
+- **legacy_account_app_user_delete_triggered** — El usuario tocó "eliminar" en la pantalla de sub-usuarios.
+- **legacy_account_deletion_initiated** — El usuario entró al flujo de "eliminar cuenta". Señal temprana de churn.
+- **legacy_account_deletion_confirmed** — El usuario confirmó la eliminación.
+- **legacy_account_deletion_completed** — La cuenta se eliminó.
+- **legacy_account_deletion_cancelled** — El usuario canceló antes de confirmar la eliminación.
+
+---
+
+## Alta de dispositivo
+
+Vincular el reloj/dispositivo del niño a la cuenta del adulto.
+
+### Wizard de alta
+
+- **legacy_device_setup_started** — El usuario entró al wizard de alta de dispositivo.
+- **legacy_device_setup_step_completed** — El usuario completó un paso del wizard. Se registra cuánto tiempo tardó en ese paso.
+- **legacy_device_setup_completed** — El dispositivo quedó vinculado. Se registra género y edad del niño y la relación con el adulto.
+- **legacy_device_setup_failed** — Falló el alta del dispositivo.
+- **legacy_device_setup_cancelled** — El usuario abandonó el wizard.
+
+### Cómo se introdujo el código del reloj
+
+- **legacy_device_setup_qr_scanned** — El usuario escaneó el código QR del reloj.
+- **legacy_device_setup_manual_code_entered** — El usuario tipeó el código manualmente.
+
+### Familias con varios hijos
+
+- **legacy_device_setup_reset_for_new_kid** — Después de terminar un alta, el usuario eligió "agregar otro hijo".
+
+---
+
+## Funciones del dispositivo
+
+### Localizar dispositivo
+
+- **legacy_device_locate_requested** — El usuario pulsó el botón de localizar.
+- **legacy_device_locate_success** — La orden de localizar se envió al dispositivo.
+- **legacy_device_locate_failure** — La orden de localizar falló.
+
+### Conexión remota (cámara y llamada)
+
+- **legacy_device_remote_connection_started** — El usuario abrió la pantalla de conexión remota.
+- **legacy_device_remote_connection_photo_taken** — El usuario pidió una foto desde la cámara remota.
+- **legacy_device_remote_connection_call_initiated** — El usuario inició una llamada con el dispositivo.
+- **legacy_device_remote_connection_picture_viewed** — El usuario navegó entre las fotos tomadas remotamente.
+
+### Volumen del dispositivo
+
+- **legacy_device_volume_control_changed** — El usuario guardó un cambio de volumen. Se dispara una vez por cada tipo modificado (multimedia, tono de llamada, alarma).
+
+### Imagen de fondo del reloj
+
+- **legacy_device_background_image_changed** — El usuario eligió una imagen existente como fondo.
+- **legacy_device_background_image_uploaded** — El usuario subió una foto personal como fondo.
+
+### Actividades programadas (rutinas en el dispositivo)
+
+- **legacy_device_scheduled_activity_added** — El usuario creó una nueva actividad programada. Se registra el día de la semana y el horario.
+- **legacy_device_scheduled_activity_updated** — El usuario editó una actividad programada.
+- **legacy_device_scheduled_activity_removed** — El usuario eliminó una actividad programada.
+
+### Recompensas
+
+- **legacy_device_rewards_granted** — El usuario otorgó minutos de recompensa al dispositivo. Se registra la cantidad de minutos.
+
+### Podómetro / pasos
+
+- **legacy_device_activity_pedometer_toggled** — El usuario activó o desactivó el contador de pasos.
+- **legacy_device_activity_meter_time_range_changed** — El usuario cambió el rango de fechas en la pantalla de pasos (hoy, 7 días, 30 días, personalizado).
+
+### Salud (ritmo cardíaco / oxígeno en sangre)
+
+- **legacy_device_health_heart_rate_frequency_changed** — El usuario cambió la frecuencia con la que se mide el ritmo cardíaco.
+- **legacy_device_health_measurement_started** — El usuario inició una medición manual.
+- **legacy_device_health_time_range_changed** — El usuario cambió el rango de fechas en la pantalla de salud.
+
+### Uso de aplicaciones del dispositivo
+
+- **legacy_device_apps_use_time_range_changed** — El usuario cambió el rango de fechas en la pantalla de uso de apps. Se registra el tiempo total acumulado y la app más usada del período.
+
+### Historial de llamadas
+
+- **legacy_device_call_history_filter_changed** — El usuario filtró el historial (todas, entrantes, salientes, perdidas). Filtrar perdidas suele ser señal de preocupación del adulto.
+
+---
+
+## Contactos del dispositivo
+
+Contactos permitidos para llamar al/desde el dispositivo del niño.
+
+- **legacy_contacts_added** — El usuario agregó un contacto. Se registra cuántos contactos tiene en total.
+- **legacy_contacts_edited** — El usuario editó un contacto existente.
+- **legacy_contacts_deleted** — El usuario eliminó un contacto. Se registra el total restante.
+
+---
+
+## Ajustes del dispositivo
+
+### Alarmas
+
+- **legacy_settings_alarm_added** — El usuario creó una alarma. Se registra la hora.
+- **legacy_settings_alarm_updated** — El usuario editó una alarma.
+- **legacy_settings_alarm_removed** — El usuario eliminó una alarma.
+
+### Contactos SOS
+
+- **legacy_settings_sos_contact_added** — El usuario agregó un contacto SOS.
+- **legacy_settings_sos_contact_removed** — El usuario eliminó un contacto SOS.
+
+### Whitelist de llamadas (bloqueo de teléfono)
+
+- **legacy_settings_block_phone_contact_added** — El usuario agregó un contacto a la lista de llamadas permitidas.
+- **legacy_settings_block_phone_contact_removed** — El usuario quitó un contacto de la lista de llamadas permitidas.
+
+### Control parental (funciones desactivadas)
+
+- **legacy_settings_disable_functions_changed** — El usuario guardó cambios en la pantalla de funciones desactivadas.
+- **legacy_settings_disable_functions_keyboard_toggled** — El usuario activó o desactivó el teclado.
+- **legacy_settings_disable_functions_gps_toggled** — El usuario activó o desactivó el GPS.
+
+### Otros ajustes
+
+- **legacy_settings_language_changed** — El usuario cambió el idioma del dispositivo.
+- **legacy_settings_alerts_configured** — El usuario guardó cambios en las alertas. Se registra cuántas alertas activas tiene y cuáles están encendidas.
+- **legacy_settings_timezone_changed** — El usuario cambió la zona horaria.
+- **legacy_settings_wifi_added** — El usuario agregó una red WiFi permitida.
+- **legacy_settings_wifi_removed** — El usuario eliminó una red WiFi permitida.
+- **legacy_settings_sound_changed** — El usuario cambió el modo de sonido del dispositivo (normal / silencio / vibración).
+- **legacy_settings_sync_clock_triggered** — El usuario disparó una sincronización manual del reloj.
+- **legacy_settings_battery_night_mode_toggled** — El usuario activó o desactivó el modo nocturno (ahorro de batería).
+
+### Gestión remota del dispositivo
+
+- **legacy_settings_remote_management_shutdown** — El usuario apagó el dispositivo a distancia.
+- **legacy_settings_remote_management_restart** — El usuario reinició el dispositivo a distancia.
+- **legacy_settings_remote_management_factory_reset** — El usuario restauró el dispositivo a fábrica. Suele preceder al desvinculado y al churn.
+
+---
+
+## Soporte
+
+- **legacy_support_contact_initiated** — El usuario tocó el botón para contactar a soporte. Se registra el canal (email) y el país seleccionado en el formulario.
+
+---
+
+## Onboarding
+
+- **legacy_onboarding_step_changed** — El usuario pasó a un nuevo slide del intro inicial.
+
+---
+
+## Panel principal
+
+- **legacy_control_panel_device_selected** — El usuario cambió el dispositivo activo (útil cuando hay varios hijos). Se registra cuántos dispositivos tiene vinculados.
+- **legacy_control_panel_positions_refreshed** — El usuario refrescó manualmente el dashboard (pull-to-refresh o botón de actualizar).
+
+---
+
+## Ubicación y mapa
+
+### Zonas seguras (geofences)
+
+- **legacy_location_geofence_created** — Se creó una nueva zona segura.
+- **legacy_location_geofence_updated** — Se editó una zona segura existente.
+- **legacy_location_geofence_deleted** — Se eliminó una zona segura.
+
+### Lugares frecuentes
+
+- **legacy_location_frequent_place_created** — Se creó un nuevo lugar frecuente.
+- **legacy_location_frequent_place_updated** — Se editó un lugar frecuente existente.
+- **legacy_location_frequent_place_deleted** — Se eliminó un lugar frecuente.
+
+### Funnel de creación de lugares (zonas y frecuentes)
+
+- **legacy_location_place_creation_started** — El usuario tocó "agregar zona" o "agregar lugar frecuente".
+- **legacy_location_point_confirmed** — El usuario fijó el centro del lugar tocando el mapa.
+- **legacy_location_radius_confirmed** — El usuario confirmó el radio de la zona segura. Se registra el tamaño del radio.
+- **legacy_location_place_creation_cancelled** — El usuario abandonó el flujo de creación o edición. Se registra en qué paso lo dejó.
+
+### Exploración y edición
+
+- **legacy_location_geofence_selected** — El usuario tocó una zona segura del mapa para verla.
+- **legacy_location_geofence_dismissed** — El usuario cerró el detalle de la zona sin hacer cambios.
+- **legacy_location_geofence_edit_started** — El usuario tocó "editar" en una zona seleccionada.
+- **legacy_location_frequent_place_selected** — El usuario tocó un lugar frecuente para verlo.
+- **legacy_location_frequent_place_dismissed** — El usuario cerró el detalle del lugar frecuente.
+- **legacy_location_history_position_selected** — El usuario tocó un punto del historial de ubicaciones en el mapa.
+- **legacy_location_history_position_dismissed** — El usuario cerró el detalle del punto del historial.
+
+### Historial de ubicaciones
+
+- **legacy_location_history_loaded** — El usuario cargó el historial de ubicaciones para un rango de fechas.
+- **legacy_location_history_cleared** — El usuario limpió el trayecto del mapa.
+
+### Frecuencia de ubicación
+
+- **legacy_location_frequency_updated** — El usuario cambió cada cuánto el dispositivo manda su posición.
+
+### Capas del mapa
+
+- **legacy_location_map_geofences_toggled** — El usuario mostró u ocultó las zonas seguras en el mapa.
+- **legacy_location_map_frequent_places_toggled** — El usuario mostró u ocultó los lugares frecuentes en el mapa.
+- **legacy_location_map_route_trail_toggled** — El usuario mostró u ocultó la línea del trayecto histórico.
+
+### Modo "seguir en vivo"
+
+- **legacy_location_following_toggled** — El usuario activó o desactivó el modo "seguir dispositivo" (el mapa se re-centra automáticamente sobre el niño).
+
+### Acciones del mapa
+
+- **legacy_location_map_actions_expanded** — El usuario abrió o cerró el menú de acciones del mapa.
+- **legacy_location_map_zoomed** — El usuario hizo zoom y se quedó en ese nivel.
+- **legacy_location_map_style_changed** — El usuario eligió otro estilo de mapa (estándar, claro, oscuro, satélite, etc.).
+- **legacy_location_map_center_tapped** — El usuario tocó "centrar en el dispositivo" para volver el mapa sobre el niño.
+- **legacy_location_map_refresh_tapped** — El usuario tocó refrescar dentro del mapa para pedir la posición más reciente.
+- **legacy_location_shared** — El usuario compartió la ubicación del niño hacia otra app (familia, pareja, abuelos). Acción viral del producto.
+- **legacy_location_list_sheet_opened** — El usuario abrió la lista con todas sus zonas, lugares frecuentes e historial.
+- **legacy_location_history_type_filter_changed** — El usuario filtró el historial por tipo de posición (GPS, WiFi, SOS). Filtrar SOS suele indicar que está investigando un evento crítico.