12 — Analytics y métricas — RELE

1. Norte del producto

Tipo	Métrica	Definición
North Star	Lecturas REVIEWED por mes	Revisiones cerradas con valor de asesoría
Guardrail	% FLAGGED / total	Calidad o anomalía de datos / tarifa
Guardrail	Tasa error API create/list	Confiabilidad

Instrumentación real (Segment, PostHog, etc.) no está cableada en v1. Este doc define el modelo de medición.

2. Árbol de métricas

North Star: REVIEWED / mes
├── Activación residente: 1ª lectura SUBMITTED
├── Activación asesor: 1er PATCH status
├── Engagement: lecturas / residente / mes
├── Ops: mediana tiempo SUBMITTED → REVIEWED|FLAGGED
└── Calidad: kWh reportados vs outliers (futuro)

3. Eventos propuestos

Evento	Props	Cuándo
`home_viewed`	—	load `/`
`login_submitted`	role_hint?	submit form
`login_succeeded`	role	200 login
`login_failed`	reason	401
`readings_list_viewed`	role, total	load lista
`reading_created`	period, kwh, code	POST OK
`reading_detail_viewed`	id, status, role	GET detalle
`reading_status_patched`	id, from, to	PATCH OK
`empty_state_viewed`	role	empty
`error_state_viewed`	surface	error red
`logout`	role	click salir

4. Funnels

Funnel residente

home_viewed
login_succeeded (RESIDENT)
reading_created
(async) reading_status_patched → REVIEWED

Funnel asesor

login_succeeded (ADVISOR)
readings_list_viewed
reading_detail_viewed
reading_status_patched

5. KPIs operativos (panel futuro)

KPI	Cálculo	Fuente
Abiertas	SUBMITTED + FLAGGED	stats.summary.open
kWh mes	sum kwh period actual	aggregate
SLA revisión	p50 hours SUBMITTED→close	timestamps
Nota coverage	% con advisorNote no vacía	DB

6. Analytics de producto vs privacidad

Regla	Detalle
No enviar password	Nunca
Minimizar PII en eventos	Preferir user_id hash / role
CUPS	No en analytics v1
IP	Según política host

7. Implementación sugerida L2+

Capa	Opción
Product analytics	PostHog self-host o cloud EU
Errores	Sentry
Uptime API	Better Stack / Checkly
SQL métricas	Neon + vista `readings_by_status`

8. Dashboards (wire conceptual)

Vista	Widgets
Founder	North Star, activaciones, error rate
Ops asesor	Abiertas, p50 revisión, FLAGGED rate
Calidad	Distribución kWh, outliers

9. Experimentos (hipótesis)

Exp	Hipótesis	Métrica
E1	Prefill periodo mes actual ↑ create completion	`reading_created` / form start
E2	Badge FLAGGED en coral ↑ tiempo a patch	time-to-patch
E3	Nota obligatoria en FLAGGED ↑ calidad feedback	% note non-empty

Todas las filas son [HIPÓTESIS] hasta A/B real.

10. Qué medir en smoke diario (manual)

Check	Señal
Seed carga 5 lecturas	lista length
Stats open > 0	strip ABIERTAS
Create +1 total	POST
Patch REVIEWED	badge update

11. Criterio de aceptación analytics v1

Modelo North Star documentado.
Eventos nombrados (aunque no instrumentados).
Funnels de ambos roles definidos.
Sin stats de mercado inventadas presentadas como reales.