first commit

docs/KPIS.md

@@ -0,0 +1,17 @@
+# KPIs y métricas
+
+## KPIs iniciales
+- **Tiempo medio de detección**: minutos desde la publicación hasta la ingesta.
+- **Cobertura del catálogo**: % de datasets detectados vs. catálogo total.
+- **Tasa de alertas útiles**: % de alertas calificadas como relevantes en pilotos.
+- **Conversión piloto → cliente**: ratio de pilotos que pagan al mes 2.
+
+## Métricas operativas (hoy)
+- `ingest_runs`: duración, errores, datasets nuevos/actualizados.
+- `alert_runs`: perfiles procesados, alertas enviadas/fallidas.
+- `/admin/monitor/status`: conteos globales.
+
+## Recolección recomendada
+- Log de timestamps de ingesta por dataset (para medir detección).
+- Feedback por alerta (útil/no útil) en UI de piloto.
+