12 — Analytics y métricas — VOLTA
1. Objetivo
Definir el modelo de medición del producto.
En v1 L1 la instrumentación puede ser mínima o nula en código; las métricas guían producto y roadmap.
No se reportan dashboards con números inventados como si fueran producción.
2. North Star
| Métrica | Definición | Por qué |
|---|
| Plazas confirmadas / semana | Count ClassRequest con status CONFIRMED creadas o confirmadas en la ventana | Mide cierre real del job del club |
3. Árbol de métricas
| Nivel | Métrica | Definición |
|---|
| Input | Visitas home | Page view / |
| Activación visitante | Solicitudes enviadas | POST /api/requests 2xx |
| Calidad captura | % forms con phone | phone non-null / total |
| Ops | Tiempo NEW → CONTACTED | Mediana hours |
| Ops | Tiempo NEW → CONFIRMED | Mediana hours |
| Ops | % open (NEW+CONTACTED) | open / total |
| Salud | Error rate API | 5xx / total |
| Coach | Logins / día | POST login 200 |
4. Eventos propuestos (schema)
| Evento | Props | Trigger |
|---|
home_viewed | — | Enter / |
join_started | — | Enter /apuntarme |
join_submitted | classType | Submit form |
join_succeeded | code, classType | 201 |
join_failed | reason | 4xx/5xx/network |
success_viewed | code | /ok |
coach_login_succeeded | — | 200 login |
coach_login_failed | — | 401 |
inbox_viewed | total, open | load inbox |
request_opened | id, status | detail |
status_changed | id, from, to | PATCH 200 |
5. Funnels
Funnel visitante
home_viewed → join_started → join_submitted → join_succeeded → (offline) contact → CONFIRMED
| Paso | Fricción esperada [HIPÓTESIS] |
|---|
| Home → Join | CTA claro reduce drop |
| Join → Success | Validación y red |
| Success → CONFIRMED | Ops del coach (fuera de web) |
Funnel coach
login → inbox_viewed → request_opened → status_changed(CONTACTED|CONFIRMED)
6. Segmentos
| Segmento | Cómo |
|---|
| Por ClassType | prop en eventos create/status |
| Por status | byStatus snapshot |
| Mobile vs desktop | UA / viewport (futuro) |
7. Implementación v1 vs futura
| Pieza | v1 L1 | Futuro |
|---|
| Logs API Nest | Opcional console | Structured logs |
| Product analytics | No obligatorio | Plausible / PostHog |
| Stats in-app | GET summary | + series temporales |
| A/B CTA copy | No | L2 |
8. KPIs de éxito del case (demo)
| KPI demo | Criterio |
|---|
| Seed visible | ≥5 requests en inbox tras seed |
| Create E2E | 1 request nueva aparece en list |
| Status E2E | PATCH refleja badge |
| Auth | Sin token no hay list |
9. Ética de medición
- No trackear notas libres con PII hacia terceros sin base legal.
- No inventar “conversión 37%” en el portfolio.
- Separar métrica modelo vs dato medido.
