01Idea general
El sistema reemplaza la hoja de Excel de inventario. Cada día se mide el nivel de los tanques —una o varias veces— y el sistema calcula cuánto se consumió, detecta faltantes y arma los reportes.
La diferencia clave con una hoja de cálculo: el consumo no se escribe, se deduce de cuánto bajó el tanque. Nadie digita las ventas.
02El modelo de consumo
El consumo de un día se deduce de la caída del nivel entre el cierre de un día y el del siguiente, sumando lo que se cargó (una descarga sube el nivel y "esconde" el consumo real):
Consumo del día = Nivel(cierre de ayer) − Nivel(cierre de hoy) + cargas del día- Sin carga: el consumo es simplemente cuánto bajó el tanque.
- Con carga: se suma lo descargado.
- Se calcula por tanque y se suma por producto (Corriente 1 + Corriente 2).
03Operador
Islero o encargado del turno. Su trabajo es medir.
Entrar con PIN rápido
El operador no teclea correo ni contraseña: escoge su estación (se recuerda en el dispositivo), toca su nombre y escribe un PIN de 4 dígitos.
- El administrador le fija o reinicia el PIN desde Configuración → Usuarios.
- Supervisor y administrador siguen entrando con correo y contraseña (enlace "Soy supervisor/administrador").
Medición pestaña 1
Todos los tanques en una lista — cada uno con su color para no equivocarse — y el campo de nivel en la misma fila.
- Decimales con coma (p. ej. 150,75) y galones en vivo mientras se escribe, con la tabla de aforo.
- Al confirmar (✓) la lectura se guarda sola y la fila se bloquea con sus galones y hora; el botón Editar permite corregirla.
- Con varias mediciones al día muestra el progreso (1/3 hoy) y "Medir de nuevo" hasta completarlas; con horarios, "Última 09:43 pm → Próxima: 11:59 pm".
- Sin internet: se mide igual; la lectura queda en cola y se envía sola al volver la señal.
Descargue pestaña 2
Cuando llega un carrotanque, lo registra el operador. Un carro = un solo registro.
- Se pone la placa y, por cada tanque que llenó el carro, el nivel antes y después (cm) y los galones de cada bodega (puede haber varias al mismo tanque).
- El sistema muestra en vivo cuánto llegó de verdad y lo compara con lo declarado: cuadró / faltan ~N gal / llegó de más.
- Si el mismo carro descarga dos veces en un tanque, medir el nivel antes/después de cada descargue por separado.
El operador no ve el panel de supervisión ni la configuración. Su Cumplimiento muestra los días medidos y la racha sin medir.
04Supervisor
Jefe de estación. Además de medir, opera el panel.
Panel de control
- Dashboard: alertas abiertas, ventas/entradas del día, y dos gráficas: existencia física por día (últimos ~14 días) y ocupación de tanques por producto. Cada producto muestra existencia, ocupación y autonomía (días hasta agotarse).
- Cierre del día: congela el día por producto. Un día cerrado es inmutable; se puede ajustar contra físico (una vez al mes) o reabrir (solo admin).
Historiales
- Mediciones: cada lectura — nivel, galones, quién y cuándo — filtrable por rango y tanque, descargable en Excel. Con varias lecturas el mismo día, la última es la que cuenta (marcada "vigente").
- Descargues: cada carrotanque — placa, quién lo registró, y por tanque las bodegas, lo declarado, lo que subió y el faltante.
Venta diaria supervisor/admin
- La estación factura en su POS (Dominus); aquí se sube el total del día por producto para alimentar diferencias y consumo.
- Es de solo-agregado: una vez registrada la venta de un producto en un día, no se edita (para corregir, un ajuste de cierre).
Reportes Excel · PDF
- Inventario (R1): el control diario tipo Excel, con una columna Consumo der. deducido de las mediciones.
- Descarga en Excel: por producto, o "todos" (un libro con una hoja de Resumen + una hoja por producto, como la hoja manual pero en pestañas). Galones con 2 decimales.
- Consumo: consumo derivado por producto y día, con perfil por franja horaria.
- Ajustes, Logística, Movimientos: auditoría de ajustes, vehículos y trazabilidad documental.
Conciliación
- El registro del descargue lo hace el operador en su pantalla (con nivel antes/después → alerta de descarga corta automática).
- Conciliación: cruzar las facturas (que llegan días o semanas después) con los descargues físicos, con propuestas automáticas.
Navegación · menú "Más"
- La barra inferior tiene lo del día a día; el botón Más (⋯) abre un panel con el resto: reportes, recepciones, conciliación, cierre del día, configuración y este manual. Solo lo ven supervisor y administrador.
- Buscar en las listas: los selectores con muchas opciones (proveedor, producto, tanque, carrotanque) permiten escribir para filtrar en vez de desplazar una lista larga.
05Administrador
Dueño o gerente. Todo lo del supervisor, más la configuración.
Configuración lista de secciones
- Tanques: crear, editar (capacidad, altura, mediciones/día y color para identificarlo al medir), desactivar; configurar horarios y gestionar el aforo.
- Aforo por tanque: cargar el certificado en PDF, o escribir la tabla a mano (una línea por punto:
cm galones). Cada tanque se puede recalibrar: la tabla anterior se archiva y queda la nueva vigente. - Inventario inicial: para arrancar sin cargar el histórico — se mide cada tanque con la varilla y ese volumen queda como inventario inicial (una sola vez por producto; no cuenta como compra).
- Usuarios: crear, editar rol, activar/desactivar y fijar/reiniciar el PIN de 4 dígitos de los operadores. Nadie puede desactivarse a sí mismo.
- Productos, proveedores y umbrales de alerta (diferencia diaria en galones y desvío mensual en %).
- Notificaciones: vincular Telegram — alertas críticas al instante y resumen diario a las 10 p.m.
- Passkeys: registrar la huella / Face ID / llave del dispositivo para entrar sin contraseña ("Entrar con passkey" en el login). Para supervisores y administradores; una por equipo.
- Sedes y Plan: las estaciones de la organización y el uso de la suscripción contra sus límites.
- Zona de peligro: reiniciar los datos de la estación para arrancar de cero (borra la historia; conserva la configuración). Exige el nombre exacto y la contraseña del administrador; no se puede deshacer.
06Tabla de permisos
| Rol | Para quién | Qué puede hacer |
|---|---|---|
| Operador | Islero / turno | Medir tanques, registrar descargues, ver su cumplimiento. |
| Supervisor | Jefe de estación | + panel, reportes, recepciones, conciliación, cierre del día. |
| Administrador | Dueño / gerente | + configuración: sedes, tanques, aforo, proveedores, usuarios, productos, umbrales, plan. |
| Consulta | Auditor / contador | Solo lectura de reportes. |
| Soporte | Proveedor del software | Gestión de la plataforma (multi-organización). |
Un usuario desactivado no puede iniciar sesión. La sesión se renueva sola; para cerrarla, el botón Salir abajo.
07Alertas
El sistema levanta alertas al cerrar el día. Las abiertas aparecen en el dashboard.
| Alerta | Qué significa |
|---|---|
| Consumo negativo | El tanque subió sin carga registrada → descargue no registrado o lectura mala. |
| Descarga corta | Se declararon más galones de los que subió el tanque (requiere nivel antes/después). |
| Diferencia diaria / mensual | La diferencia teórico vs físico salió de banda (cuando hay ventas digitadas). |
| Autonomía baja | Quedan pocos días de combustible antes de agotarse. |
| Nivel mínimo / Sobre capacidad | El tanque está bajo el mínimo o sobre su capacidad. |
| Inventario negativo | El saldo teórico dio negativo → error de captura. |
08La medición (clave del modelo)
- Estación 24 horas: el cierre se mide entre 11 p.m. y 1 a.m. La app lo maneja sola: una medición de la madrugada (antes de las 5 a.m.) cuenta como cierre del día que terminó, igual que en la hoja de siempre.
- Medir varias veces al día (medianoche, 8 a.m., 2 p.m.) no cambia el total del día, pero da el perfil por franja y detecta anomalías antes.
- Medir antes y después de cada descargue permite validar la carga (alerta de descarga corta).
merma = consumo medido − ventas facturadas): evaporación, calibración o robo.09Preguntas frecuentes
¿Por qué "10 de 11 días" si se mide todos los días?
El mes en curso incluye hoy. Si hoy aún no se ha medido, cuenta como pendiente. Al tomar la medición de hoy pasa a 11/11.
¿Por qué la "Diferencia" da cero o se ve rara?
Porque el consumo se deduce de la física: el teórico y el físico coinciden por construcción, hasta que exista una fuente de ventas independiente (fase 2, con surtidor o facturación).
La factura del combustible llega meses después. ¿Es un problema?
No. La recepción física entra al inventario el día del descargue; la factura se concilia aparte cuando llega. Van desacopladas a propósito.
¿Qué pasa si no hay internet en la isla?
El operador mide igual. La lectura se guarda en el dispositivo y se sincroniza sola cuando vuelve la conexión.