Dashboard — Panorama general
El Dashboard es la pantalla principal al entrar a Heskala. Agrupa en un solo lugar las métricas más importantes de tu negocio: cotizaciones, ventas, facturas, inventario, clientes y el pulso del agente de IA.
Esta guía explica cómo está armado. Para editarlo —agregar, mover, quitar o configurar widgets— mirá Personalizar el dashboard.
Qué vas a ver
Sección titulada «Qué vas a ver»El dashboard es una grilla de widgets. Cada widget es un bloque que muestra una métrica puntual: un número grande, un gráfico de barras, una lista de los últimos registros, una tendencia mensual, etc.
Por defecto, el dashboard de Heskala arranca con un set razonable de widgets. A partir de ahí, cada usuario puede personalizarlo a su gusto sin afectar al de otros usuarios.
Conceptos clave
Sección titulada «Conceptos clave»| Concepto | Qué es |
|---|---|
| Widget | Un bloque individual de la grilla (un stat, un gráfico, una lista). |
| Tipo de widget | Cómo se ve: stat_card, bar_chart, line_chart, pie_chart, area_chart, recent_list, ai_pulse. |
| Fuente de datos | De dónde sale la información: cotizaciones, clientes, productos, ventas, facturas, inventario, órdenes de trabajo, AI. |
| Métrica | Qué se mide dentro de esa fuente: total, pendientes, por estado, tendencia, etc. |
| Tamaño | Cuántas columnas ocupa el widget: sm (1), md (2), lg (3), xl (4). |
| Rango de tiempo | El período que cubre: hoy, esta semana, este mes, últimos 7/30/90/180 días, todo el tiempo. |
Tipos de widget
Sección titulada «Tipos de widget»| Tipo | Para qué sirve |
|---|---|
stat_card | Un número destacado (total, pendientes, monto). |
bar_chart | Comparar una métrica entre categorías (por estado, por tipo). |
line_chart | Evolución a lo largo del tiempo (tendencia mensual). |
area_chart | Igual que line_chart pero con área rellenada. |
pie_chart | Distribución porcentual (activos vs. inactivos, por tipo). |
recent_list | Lista de los últimos registros (recientes). |
ai_pulse | Resumen del estado del agente de IA (alertas, insights). |
Fuentes de datos disponibles
Sección titulada «Fuentes de datos disponibles»El dashboard puede leer de estas áreas de tu empresa:
- Cotizaciones (total, pendientes, conversión, valor total, tendencia, recientes).
- Clientes (total, activos vs. inactivos, por tipo).
- Productos / servicios (total, activos vs. inactivos, por tipo, recientes).
- Ventas (total, por estado, monto total, tendencia, recientes).
- Facturas (total, pendientes, por estado, monto, resumen de impuestos, tendencia, recientes).
- Órdenes de trabajo (total, en progreso, programadas, por estado, por prioridad, costo total, tendencia, recientes).
- Inventario (productos con stock, unidades disponibles, stock bajo, sin stock, vencidos, dañados, distribución de alertas, tendencia de movimientos, movimientos recientes).
- AI (pulso del negocio).
Cada widget se arma eligiendo una fuente + una métrica. El WidgetPicker
solo te muestra las combinaciones válidas.
Rango de tiempo
Sección titulada «Rango de tiempo»La mayoría de widgets aceptan un rango de tiempo que filtra los datos. Los rangos disponibles son:
| Rango | Qué cubre |
|---|---|
| Hoy | El día en curso. |
| Esta semana | Desde el lunes hasta hoy. |
| Este mes | Desde el 1 del mes hasta hoy. |
| Últimos 7 días | Hoy y los 6 días anteriores. |
| Últimos 30 días | Hoy y los 29 días anteriores. |
| Últimos 3 meses | Hoy y los 89 días anteriores. |
| Últimos 6 meses | Hoy y los 179 días anteriores. |
| Todo el tiempo | Sin filtro de fecha (lo acumulado). |
Permisos y visibilidad por rol
Sección titulada «Permisos y visibilidad por rol»Algunos widgets están restringidos por rol. El dashboard filtra los widgets según lo que tu usuario puede ver y deja solo los que aplican:
| Nivel de acceso | Quién lo ve |
|---|---|
standard (default) | Cualquier usuario con permiso de lectura en el módulo. |
elevated | Admins de empresa, super admins o usuarios con permiso de crear/editar en el módulo. |
admin_only | Solo admins de empresa y super admins. |
Por ejemplo, métricas como monto total, resumen de impuestos o
tendencia mensual de facturas suelen ser admin_only. Si no las ves en
el WidgetPicker, es porque tu rol no tiene acceso.
Los módulos de Invoices, Ventas y Stock tienen acceso
elevated por defecto, así que sus widgets sólo aparecen para usuarios con
permisos de edición.
El botón flotante de DevTools
Sección titulada «El botón flotante de DevTools»Hay un botón flotante de DevTools que sirve para diagnosticar el dashboard: muestra qué datos fuente están disponibles para tu rol, qué permisos tenés en cada módulo y simula una nueva versión de la app. Útil solo para desarrollo y super admins.
Siguiente paso
Sección titulada «Siguiente paso»Para mover, agregar, quitar o cambiar widgets, andá a Personalizar el dashboard.