📊 Dashboard

¿Qué es el Dashboard?

El Dashboard es tu centro de control principal en CloudSuite Pro. Es la primera pantalla que ves al iniciar sesión y te muestra un resumen ejecutivo completo de tu negocio en tiempo real.

Piensa en el Dashboard como el tablero de instrumentos de un avión: te muestra todas las métricas importantes de un vistazo para tomar decisiones rápidas e informadas.

¿Para qué sirve?

El Dashboard te permite:

• 📈 Ver ventas en tiempo real: Total vendido, número de transacciones, ticket promedio
• 📦 Monitorear inventario: Valor del stock, productos con stock bajo
• 💰 Controlar caja: Sesiones abiertas, dinero recaudado, diferencias
• 👥 Conocer tus clientes: Top clientes que más compran
• 📄 Vigilar NCF: Secuencias por vencer, cumplimiento fiscal
• ⏰ Alertas de lotes: Productos próximos a vencer
• 📊 Tendencias: Gráficos de ventas, métodos de pago, uso de NCF

Características Principales

1. 📊 Visualización Personalizada por Permisos

El Dashboard es inteligente: solo muestra información de módulos a los que tienes acceso.

Ejemplo:

• Si tienes permiso de Facturas → Verás estadísticas de ventas
• Si tienes permiso de Inventario → Verás stock y lotes por vencer
• Si tienes permiso de Caja → Verás sesiones de caja activas
• Si tienes permiso de NCF → Verás alertas de secuencias

Personalización Automática

No necesitas configurar nada. El sistema detecta automáticamente tus permisos y ajusta el Dashboard.

2. 🔄 Actualización en Tiempo Real

• Actualización automática al cambiar de sucursal
• Botón "Actualizar" para refrescar datos manualmente
• Carga datos de los últimos 30 días por defecto

3. 🏢 Filtro por Sucursal

Si tienes múltiples sucursales, el Dashboard muestra datos de la sucursal activa seleccionada en el menú superior.

Cambiar sucursal:

1. Click en selector de sucursal (parte superior)
2. Selecciona la sucursal deseada
3. Dashboard se actualiza automáticamente

Secciones del Dashboard

📈 KPIs Principales (Indicadores Clave)

Cuatro tarjetas en la parte superior:

KPI	¿Qué muestra?	Ejemplo
💰 Ventas Totales	Total vendido en el período	RD$ 125,450.00
🛒 Transacciones	Número de facturas emitidas	87 facturas
🧾 Ticket Promedio	Venta promedio por factura	RD$ 1,442.00
📈 Crecimiento	% de aumento vs. período anterior	+12.5%

Colores:

• 🟢 Verde con flecha ⬆: Crecimiento positivo
• 🔴 Rojo con flecha ⬇: Decrecimiento
• ⚪ Gris: Sin cambio

📊 Gráficos de Ventas

Tendencia de Ventas (30 días)

• Gráfico de línea mostrando ventas diarias
• Eje horizontal: Fechas
• Eje vertical: Monto en RD$
• Útil para identificar días de mayor venta

Métodos de Pago

• Gráfico circular (pie chart)
• Muestra distribución de ventas por método:
  • 💵 Efectivo
  • 💳 Tarjeta
  • 🏦 Transferencia
  • ✅ Fiado (Crédito)

📦 Sección de Inventario

Tarjetas de Resumen

Métrica	Descripción
Valor Total	Valor total del inventario disponible
Productos con Stock Bajo	Cantidad de productos bajo mínimo
Total Productos	Cantidad de SKUs en inventario

Listado de Stock Bajo

Tabla mostrando productos críticos:

• Código del producto
• Nombre
• Almacén
• Cantidad actual
• Mínimo requerido
• Déficit (cuánto falta)

Acción: Click en producto → Va a página de inventario

Widget de Lotes por Vencer

Lista de lotes con fechas de vencimiento próximas (próximos 30 días):

• Producto
• Número de lote
• Fecha de vencimiento
• Días restantes
• Estado (Crítico si faltan menos de 7 días)

Colores:

• 🔴 Rojo: Menos de 7 días
• 🟡 Amarillo: Entre 7 y 15 días
• 🟢 Verde: Entre 15 y 30 días

💰 Sesiones de Caja

Widget mostrando:

Estadísticas Generales:

• Sesiones abiertas actualmente
• Total recaudado (todas las sesiones)
• Diferencias detectadas (faltantes/sobrantes)

Listado de Sesiones Recientes:

• Número de sesión
• Usuario responsable
• Total efectivo / tarjeta / transferencia
• Diferencias
• Estado (Abierta/Cerrada)

Acción: Click en sesión → Va a detalle de sesión de caja

👥 Top Clientes

Widget mostrando los 5 clientes que más han comprado:

• Nombre del cliente
• Total de compras en el período
• Número de facturas

Útil para identificar clientes VIP y planificar estrategias de fidelización.

📄 Cumplimiento Fiscal (NCF)

Uso de NCF por Mes (Últimos 6 meses)

Gráfico de barras mostrando:

• Mes
• B01 (Crédito Fiscal)
• B02 (Consumidor Final)
• B04 (Notas de Crédito)
• B13 (Gastos Menores)

Widget de Cumplimiento NCF

Tarjetas mostrando:

• Secuencias activas: Cuántas secuencias tienes habilitadas
• Por vencer: Secuencias que vencen en menos de 30 días
• Críticas: Secuencias con menos de 100 números disponibles
• NCF usados: Total de comprobantes emitidos

Alertas de NCF

Si tienes alertas activadas en preferencias de usuario, verás:

🔴 Secuencias Críticas:

• Secuencia con menos de 100 números disponibles
• Requiere acción inmediata

🟡 Secuencias por Vencer:

• Secuencias que vencen en menos de 30 días
• Planifica renovación con DGII

Acción: Click en alerta → Va a configuración de NCF

Permisos Necesarios

El Dashboard requiere permiso básico:

• DASHBOARD.VIEW: Ver el dashboard

Permisos adicionales (controlan qué secciones se muestran):

• INVOICE.VIEW: Ver estadísticas de ventas
• INVENTORY.VIEW: Ver datos de inventario y lotes
• CUSTOMERS.VIEW: Ver top clientes
• CASH_SESSIONS.VIEW: Ver sesiones de caja
• NCF.VIEW: Ver alertas y cumplimiento fiscal

Permisos Automáticos

No necesitas activar permisos especiales para el Dashboard. El sistema detecta tus permisos de otros módulos y ajusta la visualización.

Botón de Actualizar

En la esquina superior derecha del Dashboard:

Botón "🔄 Actualizar":

• Click para refrescar todos los datos
• Útil si quieres ver cambios recientes
• Mientras actualiza, muestra animación de carga

Casos de Uso

Caso 1: Gerente revisando el día

Situación: Son las 5:00 PM y el gerente quiere ver cómo va el día.

Dashboard muestra:

• ✅ Ventas del día: RD$ 45,780.00 (32 facturas)
• ✅ Ticket promedio: RD$ 1,430.00
• ✅ Crecimiento: +8% vs. ayer
• ✅ 3 sesiones de caja abiertas
• ✅ Total recaudado: RD$ 45,780.00
• ✅ Sin diferencias detectadas

Decisión: Día productivo, sin problemas de caja.

Caso 2: Supervisor de inventario en la mañana

Situación: Lunes 8:00 AM, revisar inventario antes de abrir.

Dashboard muestra:

• ⚠️ 12 productos con stock bajo
• 🔴 5 lotes vencen en menos de 7 días
• ✅ Valor de inventario: RD$ 2,450,890.00

Acción:

1. Click en "12 productos con stock bajo"
2. Crea órdenes de compra para reabastecer
3. Click en lotes por vencer
4. Planifica promoción para vender rápido

Caso 3: Contador revisando cumplimiento fiscal

Situación: Fin de mes, verificar NCF antes de reportes DGII.

Dashboard muestra:

• 🔴 Secuencia B02 tiene 85 números disponibles (crítico)
• 🟡 Secuencia B01 vence el 15 del mes próximo
• ✅ B13 y B04 sin problemas

Acción:

1. Click en alerta B02 crítica
2. Va a configuración de NCF
3. Solicita nueva secuencia a DGII con urgencia
4. Click en B01 por vencer
5. Planifica renovación la próxima semana

Caso 4: Vendedor por comisión

Situación: Vendedor revisa su desempeño.

Dashboard muestra:

• ✅ Top clientes que compraron
• ✅ Métodos de pago más usados
• ✅ Tendencia de ventas de la semana

Acción: Identifica cliente VIP para ofrecerle promoción especial.

Navegación desde el Dashboard

Todos los widgets tienen enlaces directos:

Elemento	Acción al hacer click
Producto con stock bajo	→ Página de inventario del producto
Lote por vencer	→ Página de lotes
Sesión de caja	→ Detalle de sesión
Top cliente	→ Perfil del cliente
Alerta de NCF	→ Configuración de secuencias NCF

Consejos y Mejores Prácticas

Revisión Diaria

Revisa el Dashboard al inicio y fin del día para estar al tanto del estado del negocio.

Activa Alertas de NCF

En Preferencias de Usuario, activa "Alertas de vencimiento de NCF" para ver avisos en el Dashboard.

Cambio de Sucursal

Si gestionas múltiples sucursales, cambia entre ellas para comparar desempeño.

Stock Bajo

Si ves productos con stock bajo, actúa rápido creando órdenes de compra antes de quedarte sin inventario.

Lotes por Vencer

Planifica promociones para productos próximos a vencer. Evita pérdidas.

Preguntas Frecuentes

P: ¿Por qué no veo algunas secciones del Dashboard?
R: Solo se muestran secciones de módulos a los que tienes permiso de acceso. Contacta a tu administrador si necesitas más permisos.

P: ¿El Dashboard se actualiza automáticamente?
R: Se actualiza al cambiar de sucursal. Para actualizar manualmente, usa el botón "Actualizar".

P: ¿Qué período de tiempo muestra el Dashboard?
R: Por defecto, muestra datos de los últimos 30 días.

P: ¿Puedo personalizar qué se muestra en el Dashboard?
R: No directamente. El Dashboard se personaliza automáticamente según tus permisos.

P: ¿Por qué no veo alertas de NCF?
R: Verifica en Configuración → Preferencias de Usuario que las alertas de NCF estén activadas.

P: ¿Las estadísticas incluyen todas las sucursales?
R: No. Solo incluyen la sucursal actualmente seleccionada. Para ver todas, ve a módulo de Reportes.

P: ¿Qué significa "Crecimiento +12.5%"?
R: Es el porcentaje de aumento de ventas comparando el período actual con el período anterior (misma duración).

P: ¿Puedo exportar datos del Dashboard?
R: No directamente. Para exportar reportes detallados, ve al módulo de Reportes.

Próximos Pasos

• Reportes - Análisis detallados y exportación
• Inventario - Gestionar productos con stock bajo
• Sesiones de Caja - Controlar efectivo y transacciones
• NCF - Configurar secuencias fiscales