Diseños UI: dashboards iniciales del CRM¶
Esta sección reúne los diseños de referencia de la interfaz del CRM en core-frontend. Los diseños muestran lo que se espera de la pantalla inicial de cada módulo: al entrar a un módulo, el usuario ve un dashboard con las métricas de ese módulo.
Estado: diseño de referencia (mockup). Los números son de ejemplo; montos y ciudades aparecen como marcadores (
[MONTO],[META],[Ciudad 1]).
Abrir los diseños (solo lectura)
El enlace abre un lienzo compartido en modo lectura con los dos dashboards uno al lado del otro y notas sobre el origen de cada métrica.
Dónde se muestra¶
Cada módulo se abre en /modulos/:moduloId, cuya página índice es ModuloInicioPage (src/modules/navegacion). Hoy muestra un mensaje genérico; el comportamiento esperado es reemplazarlo por el dashboard del módulo:
| Módulo | Pantalla inicial esperada |
|---|---|
clientes |
Dashboard de Clientes |
fuerza-ventas |
Dashboard de Fuerza de ventas |
| Otros módulos | Mensaje genérico actual, hasta tener su propio dashboard |
Cada dashboard vive dentro de su módulo (src/modules/<modulo>/), de modo que agregar uno nuevo no modifica los existentes.
Dashboard de Clientes¶
- Filtros: periodo, promotor, canal y exportación.
- Indicadores: clientes activos, nuevos del mes, prospectos abiertos, tasa de conversión y clientes sin promotor asignado.
- Altas por mes: columnas de los últimos 12 meses.
- Embudo de prospectos: cantidad por estado.
- Distribuciones: por canal, por clase de cliente y locales por ciudad.
- Cartera por promotor: tabla con clientes asignados.
| Origen de los datos | Métricas |
|---|---|
Disponible hoy en crm-svc-clientes (totales de los listados {items, total}) |
Clientes activos/inactivos, prospectos, cartera por promotor |
| Requiere backend | Altas por mes, distribución por canal/clase/ciudad, clientes sin promotor |
Propuesta: un endpoint de resumen GET /clientes/dashboard?desde&hasta que devuelva los agregados en una sola llamada.
Dashboard de Fuerza de ventas¶
- Filtros: mes, supervisor y promotor.
- Indicadores contra meta: ventas, visitas efectivas, cobertura de clientes, cobranza y pedidos confirmados; cada barra marca el ritmo esperado según el día del mes.
- Ventas acumuladas vs. meta: línea diaria con la línea de ritmo de referencia.
- Visitas de hoy: distribución por estado (finalizadas, en curso, pendientes, canceladas) y check-ins fuera de rango.
- Promotores vs. meta: tabla con estado En ritmo / Bajo ritmo.
- Requerimientos abiertos: por prioridad, con vencidos.
- Pedidos cancelados: por motivo.
| Origen de los datos | Métricas |
|---|---|
Disponible hoy en crm-svc-fuerza-ventas |
Promotores activos, por tipo y coordinadores |
| Requiere backend (contrato OpenAPI, sin implementar) | Pedidos, visitas, requerimientos, metas y avance contra meta |
El dashboard completo depende de implementar esos dominios y un endpoint de resumen por módulo.
Notas de implementación¶
core-frontendno tiene librería de gráficos; se sugiere MUI X Charts por integrarse con el tema MUI existente.- Los colores de estado (éxito, advertencia, error) se acompañan siempre de ícono y texto, no solo de color.