Plan de Pruebas — M3: Dashboard + Reportes
Fecha: 2026-07-27 Módulo: doc/plans/2026-07-25-plan-desarrollo-modulos.md (M3) Ambiente: Dev local (./start-dev.sh) — http://localhost:5173
Estado de los datos
Además del seed base, la base tiene ~124 transacciones (100 simuladas como si vinieran de Soterex, ACCEPTED) más lo que se fue pagando/cancelando durante el desarrollo. Si querés arrancar de cero:
bash
docker compose exec backend php artisan tinker --execute="App\Models\AuditLog::query()->delete(); App\Models\Transaction::query()->delete();"
docker compose exec backend php artisan db:seed --no-interactionUsuarios (mismos que M1/M2)
| Password | Dashboard / Reportes | |
|---|---|---|
admin@cislatam.test | Admin123! | Ve ambos — sin el KPI de comisión en el Dashboard |
supervisor@cislatam.test | Super123! | Ve ambos — con el KPI de comisión en el Dashboard |
backoffice@cislatam.test | Backoffice123! | No ve ninguno de los dos |
1. Acceso por rol
| # | Paso | Resultado esperado |
|---|---|---|
| 1.1 | Como Backoffice, mirar el sidebar | No aparecen ni "Dashboard" ni "Reportes" |
| 1.2 | Como Backoffice, entrar directo por URL a http://localhost:5173/ | Te rebota a Transacciones — no se llega ni escribiendo la URL |
| 1.3 | Como Backoffice, entrar directo a http://localhost:5173/reportes/situacion | Mismo rebote |
| 1.4 | Como Supervisor o Admin | Ambos ítems aparecen en el sidebar y se puede entrar sin problema |
2. Dashboard — KPIs
| # | Paso | Resultado esperado |
|---|---|---|
| 2.1 | Como cualquiera de los dos roles con acceso, entrar a Dashboard | Se ven 4 tarjetas: Transacciones pagadas (hoy), Transacciones pendientes (ACCEPTED), PDVs activos, Saldo de prefondeo |
| 2.2 | Como Supervisor | Aparece una 5ta tarjeta: "Comisión generada (hoy)" |
| 2.3 | Como Admin | Esa 5ta tarjeta no aparece — mismo país, mismo permiso de módulo que Supervisor, pero el rol no es el mismo |
| 2.4 | Como Supervisor (acotado a 2 PDVs: GT-CAP-001 y GT-QUE-002), mirar "PDVs activos" | Muestra 2, no el total del país |
| 2.5 | Como Admin (sin restricción de PDV), mirar "PDVs activos" | Muestra el total real de PDVs activos del país (4 en el seed) |
3. Reportes — Estado de Situación
Los pasos 3.2, 3.3 y 3.6 a 3.9 se corren como Admin (sin restricción de PDV). El Supervisor del seed está acotado a 2 PDVs, así que con él esas filas dan otro resultado a propósito: es el caso 3.10.
| # | Paso | Resultado esperado |
|---|---|---|
| 3.1 | Entrar a Reportes | Cae directo en la pestaña "Estado de Situación" |
| 3.2 | Mirar los totalizadores de arriba | Saldo actual, Saldo anterior (el saldo del país justo antes del "Desde"), Prefondeo cargado, Pagado (con su comisión debajo), Pendiente, Cancelado |
| 3.3 | Mirar la tabla de movimientos | Mezcla transacciones (ACCEPTED/PAID/CANCELLED) y asientos de prefondeo, ordenados por fecha con lo más nuevo arriba — la comisión se ve en cada fila de transacción (a diferencia del listado de Transacciones, donde está restringida) — y una última columna Balance final |
| 3.4 | Filtrar por fecha Desde/Hasta | La tabla y los totalizadores se recalculan para ese rango |
| 3.5 | Sin poner fecha | Trae los últimos 30 días por defecto (aviso al lado de los inputs) |
| 3.6 | Mirar el Balance final de dos filas seguidas | Un asiento suma su monto; un pago PAID resta monto + comisión; una ACCEPTED o CANCELLED repite el saldo de la fila de abajo y se ve atenuada. Si hay más de una página, la fila muestra el mismo saldo vea la página que vea |
| 3.7 | Ir a la última página | La última fila es Saldo anterior (con la fecha "Desde"): es lo más viejo, así que cierra la lista. Su valor es el de la tarjeta Saldo anterior |
| 3.8 | Elegir un PDV en el filtro | Desaparecen la columna Balance final y la fila Saldo anterior, y un aviso arriba de la tabla explica el motivo. La tarjeta Saldo anterior se mantiene. Volver a "Todos los PDVs" la trae de vuelta |
| 3.9 | Exportar a Excel y a PDF (sin PDV elegido) | Traen la columna Balance final con los mismos valores y orden que la pantalla, y la fila Saldo anterior al final. Con un PDV elegido, el export no trae ni la columna ni la fila |
| 3.10 | Como Supervisor (acotado a GT-CAP-001 y GT-QUE-002), entrar a Estado de Situación | Un aviso arriba de la tabla dice "Tu acceso está limitado a algunos PDVs"; no hay columna Balance final, ni fila Saldo anterior, ni tarjeta Saldo anterior (quedan Saldo actual, Prefondeo cargado, Pagado, Pendiente y Cancelado). Si además elige un PDV, el aviso pasa a ser el del filtro de PDV |
| 3.11 | Como Supervisor, exportar a Excel y a PDF | El export trae 5 columnas (Fecha, Movimiento, Detalle, Monto, Comisión): sin Balance final y sin la fila Saldo anterior |
4. Reportes — Volumen y Comparativas
| # | Paso | Resultado esperado |
|---|---|---|
| 4.1 | Click en la pestaña "Volumen y Comparativas" | La URL cambia a /reportes/volumen, el ítem "Reportes" del sidebar se mantiene resaltado |
| 4.2 | Mirar "Totalizadores por país" | Una fila por país con alcance (hoy solo Guatemala) + una fila "Total" al final |
| 4.3 | Mirar "Ranking de PDVs" | Incluye todos los PDVs activos del alcance, incluso los que no tuvieron ninguna transacción pagada en el rango (aparecen con 0) |
| 4.4 | Click en cualquier encabezado de columna del ranking (ej. "Monto") | Ordena por esa columna, con flechita indicando el sentido; un segundo click invierte el orden |
| 4.5 | Los totales de "Totalizadores por país" vs. los de "Estado de Situación" (mismo rango) | Deben coincidir — son la misma info vista de 2 formas distintas |
5. Qué NO es parte de este módulo (no reportar como bug)
- La exportación a Excel/PDF del Estado de Situación existe (ver 3.9); la de Volumen y Comparativas todavía no (funcional, pregunta #6 — pendiente, no bloqueante).
- Con un solo país cargado (Guatemala), la comparativa "país vs país" no se puede ver en acción todavía — hace falta el ABM de Países (M4) para dar de alta un segundo país.
- El filtro de país en "Volumen y Comparativas" no tiene efecto visible mientras haya un solo país en tu alcance (queda listo para cuando haya más de uno).
Cómo reportarme el feedback
Con el número de la tabla alcanza (ej. "2.3 el Admin igual ve la comisión").

