Dashboard configurable (Dashboard Manager)

¿Para qué sirve?

El Dashboard es tuyo: cada usuario arma el suyo. Presiona Agregar widget arriba a la derecha y elige entre widgets sugeridos (ya configurados para los plugins que tienes activos) o tipos en blanco para armar el tuyo.

¿Cuándo lo necesitas?

• Quieres una pantalla de inicio útil, no un placeholder.
• Necesitas que los directivos vean números clave sin abrir cada módulo.
• Diferentes roles necesitan ver diferentes cosas al entrar.

Cómo activarlo

1. Registra dashboard-manager.
2. La entrada Dashboard en el menú ya existe (es la home del CMS); ahora se vuelve editable.

Tipos de widget

Tipo	Para qué sirve	Ejemplo
Métrica	Un número grande: contar o sumar una columna	"Ventas del período": suma de total_pedido
KPI + Tendencia	El número de este período comparado con el anterior	"Pedidos últimos 30 días" con +100%
Torta / Dona	Reparto por categoría	"Pedidos por estado"
Barras	Comparar categorías o meses	"Visitas por estado"
Progreso a meta	Avance contra un objetivo	"Meta de ventas del mes": 64% de $80.000
Registros recientes	Mini tabla con los últimos registros	Últimos pedidos
Estado del sistema	PHP, MySQL, espacio en disco	Para el responsable técnico
Accesos rápidos	Links personalizables	Enlaces frecuentes
Actividad reciente	Últimas acciones del log de auditoría	Quién hizo qué
HTML libre	Bloque HTML custom (solo superadmin)	Anuncios, banners

Widgets sugeridos

En la parte superior del selector aparecen widgets ya configurados para los plugins que tienes activos, a un clic. Ejemplos según lo que tengas activo:

• Con CRM Manager: "Total de contactos", "Contactos nuevos", "Fuentes configuradas".
• Con Inventory Manager: "Alertas de stock bajo", "Movimientos de stock".
• Con HR Manager: "Colaboradores activos", "Solicitudes hábiles pendientes", "Liquidaciones emitidas", "Marcaciones de asistencia por día", "Ausencias por tipo".
• Con Task Boards: "Tableros de trabajo", "Tareas en tableros".
• Con Mantención (CMMS): "Órdenes de trabajo abiertas", "Órdenes por estado", "Órdenes por tipo", "Órdenes emitidas (30 días)", "Órdenes por día", "Solicitudes sin atender", "Solicitudes por estado", "Equipos fuera de servicio", "Equipos críticos", "Equipos por estado", "Repuestos en bodega".
• Con Restaurante: nueve widgets que miran las dos cosas de un servicio — lo que está pasando ahora ("Cuentas abiertas", "Pedidos por aceptar", "Reservas por confirmar", "Platos agotados") y lo que ya pasó ("Ticket promedio", "Cuentas cerradas por día", "Cómo pagan", "Pedidos por estado", "Comandas por estación").
• Con la suite de condominios: veintiún widgets repartidos en cinco módulos — Comunidades ("Unidades del padrón", "Personas registradas", "Acceso al portal", "Vehículos registrados", "Mascotas registradas"), Tesorería ("Deuda vigente", "Pagos (30 días)", "Convenios vigentes", "Multas por estado", "Certificados por tipo"), Gastos Comunes ("Egresos registrados", "Cargos emitidos (30 días)", "Órdenes de compra por estado"), Conserjería ("Visitas dentro", "Encomiendas en espera", "Visitas recibidas (30 días)"), Reservas ("Reservas por aprobar", "Reservas por estado", "Espacios habilitados") y Asambleas ("Consultas abiertas", "Asambleas por estado").

Si desactivas un plugin, sus widgets desaparecen automáticamente del catálogo.

Cada widget responde al permiso de SU sección

Un widget es una superficie de lectura como cualquier otra: muestra lo que su dueño podría ver abriendo la sección. En un módulo repartido en varias secciones —Restaurante tiene siete— eso se decide por dato y no por módulo: quien tenga concedida Comandas y nada más ve "Comandas por estación", pero no el "Ticket promedio", que vive en Reportes.

El tablero de una comunidad, de un clic

Con la suite instalada, «Poner los widgets sugeridos» arma la pantalla de inicio completa: los números que exigen acción arriba, las tendencias al medio y los repartos por estado abajo. Si el tope de widgets no alcanza para todos, se ponen los que caben y el aviso dice cuántos quedaron fuera; el tope se cambia en max_widgets de la configuración del plugin.

Un dashboard de Mantención en cinco minutos

Con los sugeridos de Mantención armas la pantalla de inicio sin configurar nada: los cuatro números que exigen acción arriba (órdenes abiertas, solicitudes sin atender, equipos detenidos, equipos críticos), la tendencia al medio (órdenes emitidas y órdenes por día) y los repartos abajo (por estado, por tipo). Conviene poner en la misma fila widgets de altura parecida: una tarjeta de un solo número al lado de un gráfico se estira para igualarlo y queda medio vacía.

Los gráficos muestran palabras, no claves

Los widgets de torta y barras agrupan por una columna, y esa columna guarda claves internas (en_ejecucion, fuera_servicio). Los widgets sugeridos traen la traducción incluida, así que la leyenda dice "En ejecución" y "Fuera de servicio". Si armas un gráfico agrupado a mano sobre una columna de estado, verás la clave tal cual — es la señal de que conviene partir del sugerido.

Un tablero por comunidad

Si administras varios condominios, cada widget de la suite muestra sólo la comunidad en la que estás trabajando. Cambias de comunidad en el selector y el mismo tablero se vuelve a leer con los datos de la otra: no hay que armar un tablero por edificio.

Es la misma regla que el resto de la suite. Un número que sume dos comunidades no responde ninguna pregunta —¿de quién es esa deuda?— y pondría los datos de un cliente en la pantalla de otro.

Si no hay comunidad elegida, el widget no muestra un número

Dice «Elige una comunidad para ver este dato». Le pasa a quien administra varias y todavía no entró a ninguna. Los widgets que no son de la suite —usuarios, actividad, tus propias tablas— siguen funcionando igual.

Cumplimiento no tiene widgets sugeridos

Sus obligaciones se guardan por alcance (un edificio, una torre, el condominio entero) y no por comunidad, así que el filtro de arriba no las alcanza. Un widget sobre esa tabla contaría las obligaciones de todos los condominios juntos, y por eso no se ofrece.

Configuración de un widget

1. Elige el tipo (o un sugerido, que ya viene relleno).
2. Elige de dónde salen los datos y la columna a contar, sumar o agrupar.
3. Ponle un título en palabras de tu negocio, y elige color y ancho.
4. Guarda. Con Editar puedes arrastrar los widgets para reordenarlos.

El desplegable habla en tu idioma, no en el de la base de datos

Los datos aparecen agrupados por módulo y con el nombre de lo que guardan:

Propiedades
    Clientes
    Contratos
    Propiedades
    Visitas a terreno
Firma Electrónica
    Documentos para firmar
    Firmantes

Y sólo salen los de los módulos que tienes encendidos. Si no usas Restaurante, sus datos no aparecen; si lo enciendes mañana, aparecen solos.

Nunca se ofrecen las tablas del sistema —usuarios, páginas, configuración— ni las de licencias: un indicador no se construye sobre ellas.

Las tablas que creas tú ya vienen con nombre

Si armaste una sección con Agregar Sección → Tabla, el panel te preguntó cómo se llama la sección y cómo se llama cada campo. Eso es lo que se muestra aquí — aparecen agrupadas bajo Tus tablas, con el nombre que les pusiste.

No hay nada que configurar: la respuesta se dio al crearla, que es el momento en que alguien sabe de verdad para qué es cada campo.

Las columnas también

En vez de published_inspo o sale_amount_prppr, el desplegable dice Publicado y Valor venta.

Y cuando el widget pide una columna de fecha, sólo se ofrecen las que efectivamente guardan fechas. Antes se podía elegir un enlace o un número como fecha, y el widget nacía roto sin decir por qué. Si la tabla no guarda ninguna fecha, el selector lo dice en vez de quedarse vacío.

¿Quién ve cada widget?

Cada widget tiene una visibilidad:

• Personal: solo lo ve quien lo creó. Es el valor por defecto.
• Por rol: lo ven todos los usuarios que tengan ese rol.
• Todos los usuarios: aparece en el dashboard de cualquiera que entre al panel.

Dashboards distintos por persona

Cada usuario ve y edita su propio dashboard. La cajera puede tener ventas del día y el jefe de bodega los insumos bajo mínimo, sin estorbarse — y encima de eso, los widgets que la empresa haya publicado para todos.

Quién puede publicar para otros

Son dos permisos distintos, y se dan en Roles y Permisos:

Para…	El rol necesita…
Armar sus propios widgets	Crear en Dashboard
Reordenar y editar su tablero	Editar en Dashboard
Publicar para todos o por rol	Las cuatro casillas de Dashboard

La idea es que armar tu tablero sea cosa tuya, y que poner algo en la pantalla de los demás pida control completo de la sección. Si un rol no puede publicar, el selector de visibilidad ni siquiera aparece y sus widgets quedan personales.

Un widget no muestra datos que la persona no podría ver

Cada widget lee de una tabla, y esa tabla pertenece a una sección del panel. El widget respeta el permiso de esa sección: si alguien no tiene acceso a Ventas, un widget sobre ventas le aparece vacío, aunque se lo hayan publicado para todos.

Suena obvio, pero antes no era así: el tablero era una puerta lateral para ver datos de secciones que no se tenían asignadas. Si un widget compartido se te ve en blanco, no está roto — te falta el permiso de la sección de donde saca los datos.

Un widget ya publicado lo puede corregir o retirar cualquiera que pueda publicar, no solo quien lo creó: así un tablero de la empresa no queda secuestrado por una sola cuenta. Los personales, en cambio, son intocables para el resto.

Publicar un tablero completo

Normalmente uno arma el dashboard y después decide quién debería verlo. Para eso está el botón Compartir, arriba a la derecha:

1. Pulsa Compartir.
2. Elige Solo yo, Todos los usuarios o uno de tus roles.
3. Aplica: el cambio afecta a todos los widgets que creaste tú, de una vez.

Lo que hayan publicado otras personas no se toca.

Los widgets existentes no se comparten solos

Un dashboard armado antes de decidir esto queda personal, que es el valor por defecto. Si lo creaste con el superadministrador y nadie más lo ve, no está fallando: falta pulsar Compartir → Todos los usuarios.

Llevarte el tablero a otra instalación

Armar un tablero es trabajo: elegir cada widget, apuntarlo a la tabla correcta, ordenarlo. Si lo hiciste en tu equipo y el sistema de verdad vive en tu dominio, no hace falta repetirlo — el tablero se lleva en un archivo.

En el menú Tablero (arriba a la derecha):

1. Exportar tablero (.json) — descarga tu tablero completo en un archivo.
2. En la otra instalación, Importar tablero… y eliges ese archivo.

Antes de escribir nada, la pantalla te dice qué va a pasar: cuántos widgets llegan, cuántos no y por qué, y cuáles llegan cambiados. Recién ahí aparece el botón de importar.

Puedes elegir entre agregar (los widgets llegan al final de tu tablero, sin borrar nada) o reemplazar tu tablero (se retiran primero los widgets que creaste tú; lo que publicó otra persona no se toca).

Por qué a veces no llega todo

El archivo no lleva números internos, porque los de una instalación no significan nada en la otra. Entonces:

• Un widget sobre datos de un módulo que allá no está instalado no se importa. No serviría de nada: dibujaría un cuadro vacío para siempre.
• Un widget dirigido a un rol busca allá un rol con el mismo nombre. Si no existe, el widget llega igual pero sólo para ti, y la pantalla te lo dice.
• Si tu cuenta no puede publicar para otras personas, todo lo que venía compartido llega sólo para ti.
• El widget de HTML libre sólo llega si la cuenta que importa puede tener uno (superadmin).

Se llevan los datos del tablero, no los datos del negocio

El archivo describe qué muestra cada widget, no lo que muestra hoy. Al llegar, cada widget consulta la base de datos de esa instalación. Un contador de unidades que acá dice 116 allá dirá lo que allá haya.

Exportar a PDF

La opción Descargar PDF del mismo menú genera un PDF del dashboard tal como está, listo para enviar por correo o imprimir. Sale con el logo, el nombre y el color que tengas configurados en Apariencia, las métricas como tarjetas, los gráficos en su proporción real y el número de página en cada hoja.

Se genera en tu propio navegador, así que no viaja nada al servidor y funciona aunque la instalación no tenga internet.

Se conecta con

• Cualquier tabla del CMS: widgets tipo Métrica o Gráfico te dejan elegir cualquiera.
• Todos los plugins: sus datos alimentan los widgets sugeridos si están activos.
• Mantención (CMMS): once widgets sugeridos sobre órdenes, solicitudes, equipos y repuestos.

Preguntas frecuentes

¿Los widgets se actualizan en tiempo real? Se actualizan al cargar la página. Puedes configurar auto-refresh por widget.

¿Cuánto pesa un dashboard con muchos widgets? Cada widget consulta la base de datos al cargar. Con 20 widgets pesados puede tardar. Considera cache o precomputar en tablas resumen.

Cambié un widget sugerido y ahora quiero la versión corregida. ¿Se actualiza sola? No. Un sugerido es una plantilla: al ponerlo se copia su configuración al widget, y desde ahí el widget es tuyo. Si una actualización del sistema mejora un sugerido (por ejemplo, agrega la traducción de un estado nuevo), borra el widget y vuelve a ponerlo desde el selector.

¿Puedo agregar HTML libre? Sí, con el widget HTML — solo disponible para superadmin por seguridad.

Exporté mi tablero y allá llegaron menos widgets. ¿Se perdió algo? No: se descartó lo que allá no podía funcionar, y la pantalla de importación te dijo cuántos y por qué antes de escribir nada. Lo más común es que falte instalar el módulo del que salen esos datos; instálalo y vuelve a importar el mismo archivo.

¿El archivo del tablero lleva datos de mis clientes? No. Lleva la descripción de cada widget —qué tabla mira, cómo agrupa, de qué color es—, nunca las filas de esas tablas.

¿Qué sigue?

• Report Manager — reportes exportables complementarios.
• Personalización: logo, colores y tema — para que el dashboard combine con tu marca.