Georadar no expone datos crudos a la hora de reportar: expone métricas. Cada pregunta que el dashboard, la API o un agente pueden contestar —¿cuánta visibilidad tiene Nike? ¿qué sentimiento se asocia a “cómodo”? ¿qué fuente se cita más?— se resuelve combinando dos capas de cómputo.

Esta sección es la referencia técnica del modelo de métricas. Si llegaste buscando cómo leer los números del dashboard, ve primero a Proceso · Leer los resultados.

Dos capas

1. Per-response (worker) — justo después de detectar entidades en una respuesta, se corren funciones puras en packages/analytics-db/src/metrics/calculators.ts que producen scores por entidad: visibility_score, sentiment_score, position_score, mention_score, competitive_score, business_impact_score. Esos valores se escriben precalculados en ClickHouse.

2. Agregada (ClickHouse) — el modelo semántico de packages/analytics-semantic-model declara un catálogo tipado de 37 medidas (share of voice, coverage rate, avg sentiment, etc.), y packages/analytics-query-recipes las materializa como SQL sobre las columnas precalculadas.

Qué vive aquí

• Catálogo — las 37 medidas una a una: fórmula, escala, grain, cómo leerla, trampas típicas.
• Computation (próximo) — el viaje end-to-end de una métrica, desde el response crudo hasta el número del dashboard, con Share of Voice como caso guía.
• Cómo leerlas (próximo) — lectura accionable para no-técnicos, con diferencias clave (SoV vs SBoV, visibility vs business impact, normalización de sentimiento).