Skip to main content

Documentation Index

Fetch the complete documentation index at: https://woku.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

El constructor de reportes permite armar un reporte sin código: se elige una fuente de datos, se agregan dimensiones (cómo agrupar) y métricas (qué medir), y el servidor traduce todo a una consulta de agregación de MongoDB.

​
Fuentes de datos

  • Respuestas de formularios (form-responses).
  • NPS (nps).
  • Envíos de formularios (form-submissions).
  • Planes de acción (action-plans).

​
Dimensiones

Una dimensión es un campo por el que agrupar. Para campos de fecha se puede elegir una granularidad: día, semana o mes. Por ejemplo, createdAt agrupado por semana.

​
Métricas

Una métrica es un valor agregado. Las agregaciones disponibles son:
  • count: cantidad de documentos.
  • sum, avg, min, max: sobre un campo numérico (por ejemplo, avg de score).

​
Visualización

El reporte se puede mostrar como tabla, barra, línea, torta, mapa de calor o tarjeta de indicador. En V1 la vista previa se renderiza como tabla; las visualizaciones gráficas por tipo están planificadas como mejora posterior.

​
Vista previa y guardado

  1. Define nombre, fuente, dimensiones y métricas.
  2. Guarda la definición.
  3. Pulsa Ejecutar para ver el resultado en una tabla.
  4. Exporta a CSV, Excel o PDF, o agéndalo.

​
Cómo se construye la consulta

El servidor genera el pipeline en este orden:
  1. $match con el companyId (garantía multi-tenant) y los filtros.
  2. $group por las dimensiones (con $dateTrunc cuando hay granularidad) calculando las métricas.
  3. $project para aplanar el resultado.
  4. $sort por la primera dimensión.