Tipos de visualización

Define cómo se representan los datos que Nova prepara para cada widget y qué bloques de contenido no requieren datos.

Que se logra

• Resultado: el resultado de una consulta se presenta en el formato que mejor comunica una tendencia, comparación, distribución, detalle o explicación.
• Caso de uso: una empresa de formación usa una métrica para inscripciones, una serie para su evolución y una tabla para revisar los cursos involucrados.
• Se combina con: Widgets de visualización, Datos de widgets y Constructor de reportes con Nova.

Donde esta

• Ruta: /[orgId]/analytics/ai-reports
• Acceso en UI: AI Reports > widgets
• Componente(s): ReportVisualizationRenderer.tsx, ReportLayoutBlock.tsx

Como funciona

1. Pedir a Nova el tipo de resultado necesario desde Add.
2. Nova guarda el tipo y la configuración compatible con las claves de datos devueltas.
3. Consultar el resultado en el lienzo y pedir un ajuste a Nova si la representación no comunica bien la métrica.

Reglas y validaciones

• Tipos con datos: metric, line, area, bar, horizontal_bar, stacked_bar, stacked_area, combo, pie, donut, scatter, gauge y table.
• combo mezcla series de barras y líneas. gauge espera un valor entre 0 y 100.
• Los bloques heading, subheading, text, divider y spacer no ejecutan una consulta.
• Las cifras admiten formato numérico, moneda, porcentaje y compacto; las tablas pueden formatear cada columna.

Backend

• Servicios: report-widgets (find/create/patch), report-widget-data (create)
• Efectos: el renderizador elige las claves de eje, serie, etiqueta y valor guardadas para el tipo.

Relaciones

• Requiere: una configuración de widget compatible con la fuente de datos.
• Dispara / afecta: presentación de las filas obtenidas por el widget.

Notas

Si un widget no tiene fuente de datos, el renderizador usa datos de ejemplo salvo en los bloques de diseño.