Modelo y significado
Cubes y vistas semánticas
Un cube es la entidad técnica: apunta a una tabla (o a una consulta SQL), declara sus joins, y define measures y dimensions. Es donde se responde de dónde sale el dato.
Un vista semántica es la capa curada —una view de Cube—: una selección de measures y dimensions de uno o varios cubes, con nombres de negocio. Es lo que consultan las personas y la IA, y por lo que se navega en la aplicación.
La separación importa: un cube puede tener treinta columnas técnicas y un vista semántica exponer las seis que alguien va a preguntar.
Las dos mitades
Cada elemento y cada métrica tienen dos definiciones, y cada una tiene su propio visto bueno.
La técnica — el SQL, los joins, el tipo de agregación. La edita quien conoce los datos (perfil Modelador), y se edita como lo que es: el fichero YAML. Una pantalla que solo entendiera los campos que qontexta conoce sería un editor peor que el propio repositorio, así que aquí se edita el fichero, con la garantía de que tiene que seguir siendo un modelo Cube válido.
La de negocio — qué mide, qué deja fuera, en qué unidad, cómo se lee, cómo lo llama la gente y qué preguntas responde. La edita quien responde del número (perfil Dueño de negocio), en un formulario, sin ver SQL.
Una métrica está lista cuando las dos mitades están validadas. Hasta entonces se puede consultar, pero la aplicación —y el agente— dicen que su significado no está firmado.
Qué escribir en la mitad de negocio
Los campos no son burocracia: son lo que un agente lee antes de elegir una métrica.
| Campo | Para qué sirve |
|---|---|
| Título | Cómo se llama esto para el negocio. |
| Descripción | Qué es, en una o dos frases. Di también qué deja fuera. |
| Dueño | El equipo que responde de este número si alguien lo cuestiona. |
| Unidad | €, %, pedidos… en qué se cuenta. |
| Cómo se lee | Matices, salvedades, con qué no hay que confundirlo. |
| Sinónimos | Cómo llama el negocio a esto mismo. Ayuda a la IA a encontrarlo. |
| Preguntas que responde | Las preguntas reales que hace la gente. Las lee la IA. |
Validar
Validar la mitad de negocio requiere título, descripción y dueño. La aprobación se
escribe en el propio fichero (meta.qontexta), así que viaja con la definición y
se revisa en la pull request como cualquier otro cambio.
Editar una definición ya validada la devuelve a pendiente: si cambia el significado, alguien tiene que volver a decir que es correcto.
Quién puede qué
| Perfil | Puede |
|---|---|
| Modelador | Editar la definición técnica, usar el asistente, crear entornos y promocionar. |
| Dueño de negocio | Editar y validar el significado. No toca SQL. |
| Administrador | Todo, más la configuración de la cuenta. |
| Visor | Consultar el modelo publicado. |