Ventas por Hora
Ventas por Tipo de Producto
Premios por Hora
Distribucion por Loteria
Top 10 Terminales
Consolidado
Ventas vs Premios por Hora
Top 10 Bancas
Distribucion Ventas
Datos
Ventas por Producto
Ventas por Producto Top 10
Por Loteria
Premios vs Ventas
Detalle
Ventas por Hora
Ventas por Hora
Tickets por Hora
Detalle
Resultados Sorteos
Ventas vs Premios por Loteria
Devolucion %
Detalle
Resultados por Juegos
Ventas por Producto
Premios Pagados vs No Pagados
Detalle
Tickets
Por Estatus
Monto por Tipo
Top Bancas
Detalle
Resumen General
Ventas vs Premios vs Comision Top 15
Resultado por Banca
Detalle
Resumen LTK
Ventas por Grupo
Trad vs No Trad
Detalle
Recargas
Por Producto
Monto por Banca Top 10
Detalle
Rutas
Monto Asignado vs Procesado
Detalle
Tesoreria
Balance por Grupo
Detalle
Terminales
Por Estatus
Por Grupo
Detalle
Usuarios
Sesiones por Consorcio
Sesiones
Faltantes
Por Concepto
Monto por Ruta
Detalle
Sin Cuadrar
Por Consorcio
Distribucion Dias
Detalle
Compensacion
Por Entidad
Detalle
Movimientos Terminales
Egresos vs Ingresos por Tipo
Distribucion Egresos / Ingresos
Detalle
Movimientos Tesoreria
Monto por Concepto
Distribucion por Concepto
Detalle
Cantidad Tickets
Vendido vs Premiado por Grupo
Utilidad por Banca Top 10
Detalle
Ventas Limites por Dia
Venta vs Premios por Consorcio
Balance por Ruta Top 10
Detalle
Ventas Grupo Productos
Distribucion por Tipo
Ventas por Grupo Top 15
Detalle
Saldo Colector
Balance por Colector Top 15
Detalle
Rutas Efectividad
Estatus de Rutas
Recolectar vs Entregado por Grupo
Detalle
Activacion Terminal
Activaciones por Agencia
Detalle
Cierre Tesoreria
Resumen por Tesoreria
| Tesoreria | Nombre | Resultado Rutas | Total Egresos | Total a Depositar | Balance Dia | Tesorero | No. Cierre |
|---|
Solicitud Faltante
Faltante vs Depositado por Empleado
Detalle
SJ Entradas Diario
Debito vs Credito por Division
Top 15 Grupos por Debito
Distribucion por Sociedad
Detalle
Comparativo MT vs SJ
MT vs SJ por Concepto
MT Categorias (Ingreso vs Egreso)
SJ por Tipo de Asiento
SJ por Division
SJ por Sociedad
MT vs SJ Ingresos por Dia
Top 20 Grupos MT (Ingresos)
Top 20 Grupos SJ (Debito)
Comparativo por Concepto
| Concepto | MT Ingreso | MT Egreso | SJ Debito | SJ Credito | Diferencia |
|---|
Desglose Diario MT vs SJ
| Dia | MT Mov. | MT Ingreso | MT Egreso | MT Term. | SJ Asientos | SJ Debito | SJ Credito | SJ Grupos |
|---|
Grupos MT (Top 20)
| Grupo MT | Movimientos | Ingreso | Egreso |
|---|
Grupos SJ (Top 20)
| Grupo SJ | Asientos | Debito | Credito |
|---|
SJ Divisiones
| Division | Asientos | Debito | Credito | Grupos |
|---|
SJ Sociedades
| Sociedad | Asientos | Debito | Credito |
|---|
MT Tipos Detallados (Top 30)
| Tipo MT | Movimientos | Ingreso | Egreso |
|---|
SJ Tipos de Asiento Detallados
| Ref | Descripcion | Asientos | Debito | Credito |
|---|
TAP: MV-Tesoreria vs SJ
Resumen por Terminal
| Terminal | Centro Costo | MV Movs | MV Ingresos | MV Egresos | MV Neto | SJ Asientos | SJ Débito | SJ Crédito | SJ Neto | Diferencia | %Dif | Estado |
|---|
Cruce por Categoria (RubrosID)
Descuadres ordenados de mayor a menor| Categoria | Grupo | MV Ingresos | MV Egresos | MV Neto | SJ Debito | SJ Credito | SJ Neto | Diferencia |
|---|
MV-Tesoreria por Concepto
SJ por Cuenta
MV-Tesoreria: Agrupado por Concepto
| Concepto | Movimientos | Monto |
|---|
SJ: Agrupado por Cuenta + Descripcion
| Cuenta | Nombre Cuenta | Descripcion | Asientos | Debito | Credito |
|---|
MV-Tesoreria: Movimientos Individuales
| Fecha | Hora | Concepto | Clasificación | Monto | No.Mov |
|---|
SJ: Entradas Individuales
| Fecha | Cuenta | Nombre | Descripción | Débito | Crédito | Centro Costo |
|---|
Cruce Diario MV-Tesorería vs SJ
| Dia | MV Movs | MV Ingresos | MV Egresos | MV Neto | SJ Asientos | SJ Débito | SJ Crédito | SJ Neto | Diferencia |
|---|
Cuentas SJ vs LotoBet
Resumen por Cuenta
Click en una fila para ver el detalle por terminal
| Cuenta | Descripción | LotoBet | SJ | Diferencia | |
|---|---|---|---|---|---|
| TOTAL | — | — | — |
N Dias Sin Cuadrar
Agrupado por Días Sin Cuadrar
Click en una fila para ver el detalle de terminales| Días Sin Cuadrar | Cantidad Terminales | Monto Total |
|---|
📉 Zonas en Caída
Zonas
| Zona | Terms (caída/total) | Venta previa | Venta actual | Δ | Δ% | Estado |
|---|
Terminales con mayor caída
| Terminal | Zona | Agencia | Venta previa | Venta actual | Δ | Δ% |
|---|
Alerta Tesoreria
Excedido por Tesoreria
Estado General
Estado de Tesorerias
| Semaforo | Terminal | Grupo | Empresa | Dato del | Fondo Asignado | Saldo Inicial | Saldo Actual | Excedido | Monto a Reponer | Total Depositado | Cierre del día | Dif. Depósito |
|---|
Alertas Ventas x Tickets
Terminales con tickets < 25% de su promedio fijo (dia o dia anterior)Sugerencias
Buzon de Sugerencias
Importar Resumen Ventas - Loteka
Importar Resumen Ventas Loteka
Sube el archivo CSV (LTKResumenVentasV4Api) y selecciona la fecha del reporte.
Historial de Importaciones
Cargando...
Importar Resumen Ventas - Real
Importar Resumen Ventas Real
Sube el archivo CSV (LTKResumenVentasV4ApiREAL) y selecciona la fecha del reporte.
Historial de Importaciones
Cargando...
Comparativo Ventas vs Promedio
Resumen por Zona
Selecciona sistema y fecha, luego haz click en Consultar
Comparativo Dia/Mes/Ano
ⓘ Default = ayer. El dia de hoy esta en produccion y no tiene cierre, por eso por defecto se compara ayer vs antier (o ayer vs el periodo anterior segun la opcion).
Actual vs Anterior por Zona
Top 10 Mayor Crecimiento
Detalle por Zona
Historico de Ventas por Usuario
| Periodo | Tradicional | No Trad | Recargas | Raza | Total | |
|---|---|---|---|---|---|---|
| Busca una terminal o nombre para ver el historico de ventas | ||||||
Premios
Premios Tradicional por Rango
Premios No Tradicional por Rango
Tradicional — Por Rango
Tradicional — Premios por Producto
No Tradicional — Por Rango
No Tradicional — Premios por Producto
Manual Fuente de Datos
Documentación completa de dónde vienen los datos que se muestran en cada pestaña del sistema, cómo se calculan las fórmulas, y con qué frecuencia se refrescan.
1. Auto Reporte CEO
Fuente: resumen_ventas_ltk (automatico, cada hora) + promedio_ventas_por_producto
Frecuencia: Se actualiza cada hora. Dia cerrado usa consolidado, dia en curso usa ultimo snapshot horario.
| Metrica | Formula | Descripcion |
|---|---|---|
| Cant Terminal | COUNT terminales con venta o promedio > 0 | Total de terminales en la zona (excluye las que tienen todo en 0) |
| Ag. Cumplimiento | COUNT terminales donde venta_hoy >= promedio Y promedio > 0 | Cantidad de agencias que vendieron igual o mas que su promedio individual |
| % Agencias | Ag. Cumplimiento / Terminales con promedio * 100 | Porcentaje de agencias que cumplieron. Verde >= 50%, Rojo < 50% |
| % Cumpl. Zona | SUM(ventas zona) / SUM(promedios zona) * 100 | Rendimiento de la zona como un todo. Verde >= 100% (cumplio), Rojo < 100% |
Productos: Tradicional (venta_loteria vs prom_trad), No Tradicional (venta_lot vs prom_no_trad), Paquetico (venta_recarga_paquetico vs prom_paquetico), Raza (ventas_externa vs prom_raza), Total (venta_total vs prom_total)
Exclusiones: SH SALCEDO y TESORERIA CENTRAL no se incluyen en ningun calculo.
Terminales duplicadas (Raza): Algunas terminales tienen 2 filas. Se usa MAX(ventas_externa) y SUM(venta_total) por terminal para evitar duplicacion.
2. Auto Comparativo Ventas
Fuente: resumen_ventas_ltk + resumen_ventas_productos (Rapidita/Chance) + promedio_ventas_por_producto
Frecuencia: Automatico cada hora. Siempre Real.
| Columna | Venta del Dia | Promedio (meta) | % Variacion |
|---|---|---|---|
| Tradicional | venta_loteria | prom_trad | (venta - prom) / prom * 100 |
| No Tradicional | venta_lot | prom_no_trad | (venta - prom) / prom * 100 |
| Paquetico | venta_recarga_paquetico | prom_paquetico | (venta - prom) / prom * 100 |
| Raza | ventas_externa | prom_raza | (venta - prom) / prom * 100 |
| Rapidita | SUM(ventas) WHERE producto LIKE EXTRAORDINARIA de resumen_ventas_productos | prom_chance_express | (venta - prom) / prom * 100 |
| Chance Real | SUM(ventas) WHERE loteria1='CHANCE REAL' de resumen_ventas_productos | megachance | (venta - prom) / prom * 100 |
| Total | venta_total | prom_total | (venta - prom) / prom * 100 |
KPI Promedio x Terminal: SUM(todos los promedios) / total terminales
Arriba/Abajo Promedio: Cuenta terminales donde total_hoy > total_prom (arriba) o total_hoy < total_prom (abajo)
Flechas: Verde ▲ = positivo, Rojo ▼ = negativo, Gris ▶ = 0%
Join promedio: Se busca por terminal O terminal_ant (terminales migradas) sin filtrar por sistema.
3. Panel General
Fuente: resumen_ventas_ltk (consolidado o ultimo snapshot) + consolidado (premios/pagos)
Frecuencia: Automatico cada hora.
| KPI | Formula |
|---|---|
| Ventas Total | SUM(venta_total) agrupado por terminal de resumen_ventas_ltk |
| Ventas Trad | SUM(venta_loteria) de resumen_ventas_ltk |
| Ventas No Trad | SUM(venta_lot) de resumen_ventas_ltk |
| Premios Total | SUM(premios) + SUM(premios_lot) de resumen_ventas_ltk |
| Utilidad Neta | (Ventas Trad + Ventas Lot) - Premios Total |
| Utilidad Bruta | (Ventas Trad + Ventas Lot) - Pagos Trad - Pagos Lot |
| Recargas | SUM(venta_recarga) de resumen_ventas_ltk |
4. Super-Grupos (Zonas)
Las zonas originales se agrupan en super-grupos para simplificar el analisis:
SANTO DOMINGO ESTE: 01 STO DGO ESTE, ANEUDY
SANTO DOMINGO NORTE: 01 STO DGO NORTE, GARDY
SANTO DOMINGO OESTE: 01 STO DGO OESTE
VIRGILIO: 01 - VIRGILIO
BOCA CHICA: 01 BOCA CHICA
GRUPO WILLY: 01 GRUPO WILLY
NAGUA: 71 *
CONSUELO: 46 *
SAN PEDRO: 23 *
SANTIAGO: 31 *
HATO MAYOR: 27 *
HIGUEY: 28 *
SAN CRISTOBAL: 93 *
QUISQUEYA: 14 *
MONTE PLATA: 05 *
PUERTO PLATA: 37 *
SAN JUAN: 12 *
JOSE LUIS: 66 *
EL PUERTO: 24 (JIMMY)
EL MAYOR: 24- *
OCOA: 13, 32
COTUI: 49 *
AZUA: 10 *
LA VEGA: 47 *
BONAO: 48 *
MICHES: 29 *
TERRENAS: 34 *
SABANA DE LA MAR: 67 *
MAO: 33 *
EL SEIBO: 25 *
LA ROMANA: 26 *
GUERRA: 22 *
YAMASA: YAMASA
Excluidos: SH SALCEDO (55 SH/QPL), TESORERIA CENTRAL (55 Tesoreria)
5. Tablas de Base de Datos
| Tabla | Fuente | Uso |
|---|---|---|
resumen_ventas_ltk | Auto cada hora desde archivos CSV | Ventas por terminal (trad, no trad, paquetico, raza, total, balance) |
resumen_ventas_productos | Auto cada hora desde archivos CSV | Ventas por producto/loteria (Rapidita, Chance Real, etc.) |
promedio_ventas_por_producto | Tabla estatica de promedios historicos | Meta/base de comparacion por terminal. Join por terminal o terminal_ant |
data_completa_terminales | Tabla estatica | Grupo/zona de cada terminal |
consolidado | Auto cada hora | Premios, pagos, depositos (algunos campos en 0 para ciertos dias) |
vc_resumen_real/loteka | Importacion manual | Archivo LTKResumenVentasV4Api subido manualmente |
vc_ventas_producto_v2_real/ltk | Importacion manual | Ventas por producto V2 subido manualmente |
vc_tickets_rapidita | Importacion manual | Tickets Rapidita subido manualmente |
vc_tickets_chance_real | Importacion manual | Tickets Chance Real subido manualmente |
6. Reportes visibles en el dashboard (por sección)
Origen de datos, endpoints y frecuencia de refresco de cada pestaña del menú actual:
📊 Sección DASHBOARD
| Pestaña | Fuente de datos | Endpoint backend | Frecuencia |
|---|---|---|---|
| Auto Reporte CEO | resumen_ventas_ltk + consolidado + promedio_ventas_por_producto | /api/vc/auto-reporte-ceo/{sis} | Automático c/hora |
| Panel General | resumen_ventas_ltk (totales por terminal) + consolidado (premios/pagos por hora) | /api/consolidado/summary + /api/consolidado/bancas | Automático c/hora |
| Auto Comparativo Ventas | resumen_ventas_ltk + resumen_ventas_productos (Rapidita/Chance Real) + promedio_ventas_por_producto | /api/vc/auto-comparativo/{sis} | Automático c/hora |
| Zonas en Caída | resumen_ventas_ltk (compara promedio de N días previos vs día actual; umbral -10%/-15%/-20%/-25%) | /api/zonas-en-caida?dias=X&umbral=Y | Automático c/hora |
| Comparativo Dia/Mes/Año | historico_ventas_usuario + resumen_ventas_ltk (cruce histórico) | /api/comparativo-historico/zonas | Histórico (diario) |
| Historico Ventas | historico_ventas_usuario (~8M filas hasta mar-26 + ~24k diarias abril) | /api/historico/detalle, /search | Auto-generador diario + cargas manuales desde DW Colombo |
| Premios | consolidado (tradicional/no-trad) por rango de fechas | /api/premios/por-rango | Automático c/hora |
📒 Sección CONTABILIDAD
| Pestaña | Fuente de datos | Endpoint backend | Frecuencia |
|---|---|---|---|
| SJ Entradas Diario | sj_entradas_diario (sincronizado desde API SJ externa apisj.azurewebsites.net, ventana 7 días) | /api/sj/entradas-diario | Sync c/5 min (sj_sync.py) |
| Comparativo MT vs SJ | movimientos_tesoreria (lado Lotobet) vs sj_entradas_diario (lado contable) | /api/comparativo | Automático c/5 min |
| TAP MV-Tes vs SJ | movimientos_tesoreria (dedup por numero_movimiento) + sj_entradas_diario + mapping via sj_centros_costo + override mov_tesoreria_clasif_manual | /api/comparativo/tap | Automático c/5 min |
| TAP MV-Tes vs SJ NEW | Igual que TAP pero con reglas actualizadas para el formato ref nuevo del proveedor SJ (LOTOBET_VTA, LOTOBET_RE, MOVINV, etc., post-2026-03) | /api/comparativo/tap_new | Automático c/5 min |
🔔 Sección ALERTAS
| Pestaña | Fuente de datos | Endpoint backend | Frecuencia |
|---|---|---|---|
| Alerta Tesorería | control_tesoreria + tesoreria_montos_alexa + movimientos_tesoreria (cruce consumo vs umbral 70%) | /api/alerta-tesoreria/estado, /alertas, /movimientos | c/5 min (alerta_tesoreria.py) |
⚙️ Sección SISTEMA
| Pestaña | Fuente de datos | Endpoint backend | Frecuencia |
|---|---|---|---|
| Sugerencias | sugerencias (tabla interna; ingresos y estados via POST) | /api/sugerencias (GET/POST) | Manual |
| Manual Fuente de datos | Este documento. Estático en el HTML. | — | — |
Fuente principal validada: resumen_ventas_ltk (ventas x terminal). Todos los reportes de Dashboard parten de esta tabla + complementos.
Convenciones visuales: Verde = cumplió/positivo. Rojo = no cumplió/negativo. Púrpura ✏️ = clasificación manual aplicada por admin (TAP). Gris N/A = sin promedio de referencia (Gerencia debe asignar).
7. Flujo de datos: del origen al dashboard
Cómo llega la información al sistema antes de ser consultada desde los endpoints:
- CSVs de Lotobet (ventas/operación): llegan vía SFTP del proveedor a
/opt/lotobet/data/incoming/<Tabla>/. El daemoningest.pycorre c/5 min, detecta archivos nuevos, valida formato y haceCOPYa PostgreSQL. Archivos procesados se mueven aprocesados/. - Formato dual (
es_consolidado): cada tabla tiene snapshots por hora (es_consolidado=false, archivosYYYY-MM-DD_HH-MM.csv) + consolidado diario final (es_consolidado=true, archivoYYYY-MM-DD.csv). Los endpoints prefierentruecon fallback afalsepara el día en curso. - SJ (contabilidad externa): daemon
sj_sync.pyllama c/5 min al API RESTapisj.azurewebsites.net(endpointsEntradasDiario,MovInventario,CatalagoCta,ConsultaCentroCostos) con ventana deslizante de 7 días para capturar cargas retrasadas o editadas. Upsert ensj_entradas_diario,sj_mov_inventario,sj_catalogo_cuentas,sj_centros_costo. - Promedios y referencias históricas: tabla
promedio_ventas_por_producto(meta por terminal, join porterminaloterminal_ant);historico_ventas_usuariocargado desde CSV del DW Colombo + auto-generador diario (auto_generate_historico()) para los últimos 7 días. - Alertas automáticas por correo (Resend API):
alerta_archivos.py— diario 05:00 — valida que llegaron los CSVs de cierre.alerta_tesoreria.py— c/5 min — detecta tesorerías con consumo ≥70% del límite diario.alerta_sj.py— diario — detecta grupos contables SJ silenciosos >2 días.
- Clasificación manual admin: tabla
mov_tesoreria_clasif_manualpermite override pornumero_movimientosobre la clasificación automática del TAP. Se aplica en cruce por categoría + detalle individual.
Infraestructura: VPS + 3 contenedores Docker (lotobet-db con TimescaleDB pg16, lotobet-api FastAPI con supervisord, lotobet-nginx con TLS Let's Encrypt). DB con 29+ tablas, 75M+ filas, 7 hypertables.
8. Concepto técnico clave: es_consolidado
Las tablas ingestadas desde CSV tienen dos versiones del mismo día:
| Valor | Archivo origen | Frecuencia | Uso |
|---|---|---|---|
| es_consolidado = false | YYYY-MM-DD_HH-MM.csv | ~16 archivos/día (08-20h) | Vista "en vivo" del día en curso |
| es_consolidado = true | YYYY-MM-DD.csv | 1 archivo/día (cierre ~03:00) | Totales oficiales finales |
Regla en endpoints: preferir es_consolidado=true (totales oficiales). Si está vacío (día actual aún no cerrado), fallback al último snapshot es_consolidado=false.
⚠️ Importante: sumar ambos produce valores duplicados (~2x). Todos los endpoints del sistema filtran correctamente; NO consultar directamente la tabla sin filtrar.
Auto Reporte CEO
ⓘ Reporte de un solo día. Compara las ventas de un día contra el promedio histórico de cada terminal.
Tendencia de ventas — últimos días
Línea azul = ventas totales del día. Línea punteada naranja = meta diaria (suma de promedios). Zona verde por encima de meta, rosa por debajo.
Selecciona sistema y fecha, luego Consultar
Ventas por Sucursal y Categoría — Año / Mes / Zona
Cargando...
Dashboard Ejecutivo
Venta Tradicional
Venta No Tradicional
Venta Recarga
Venta Raza
Ventas Totales
eficienciatrd por Mes
eficiencianotrd por Mes
eficienciarec por Mes
efiraza por Mes
eficiencia por Mes
Auto Comparativo Ventas
ⓘ Reporte de un solo día. Compara cada terminal vs su promedio histórico de referencia.
Resumen por Zona (Auto)
Selecciona sistema y fecha, luego Consultar
Ventas 0
Alertas de terminales sin ventas (DW Colombo)Tendencia de alertas por día
Top zonas con alertas
Distribución por zona (top 8)
Heatmap día × hora del corte
Cargando...
Terminales recurrentes (más días distintos sin ventas)
Cargando...
Detalle de alertas
Cargando...
Comparativo Producto V2
Por Zona
Selecciona sistema y fecha, luego Consultar
Pivot por Zona / Terminal / Loteria
Consultar para cargar
Importar Archivos Extras
Tickets Rapidita
Tickets Chance Real
Resumen Ventas Real V2
Historial Rapidita
Cargando...
Historial Chance Real
Cargando...
Historial Resumen V2
Cargando...
Ventas por Producto V2 - LTK
Importar Ventas por Producto - Loteka
Sube el archivo CSV de Ventas por Producto (Entidad, Loteria, Producto, Tipo, Ventas, Premios, Pagos).
Historial de Importaciones
Cargando...
Ventas por Producto V2 - Real
Importar Ventas por Producto - Real
Sube el archivo CSV de Ventas por Producto (Entidad, Loteria, Producto, Tipo, Ventas, Premios, Pagos).
Historial de Importaciones
Cargando...
Reporte Gerencial CEO
Selecciona sistema y fecha, luego Consultar
Administración · Usuarios
Usuarios del sistema
| Usuario | Nombre | Roles | Activo | Último login | Acciones |
|---|
Administración · Roles y permisos
Marca las vistas que cada rol puede ver. El rol admin tiene acceso a todo y no se puede editar.