Saltar a contenido

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-frontend no 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.