Appliance Local Flexor Gas

Características Principales del Appliance:

• Autonomía Local Offline: El Appliance almacena hasta 90 días de transacciones de despacho, lecturas volumétricas por segundo y aperturas de turno en su base de datos local SQLite cifrada con AES-256.
• Doble Puerto de Simulación / Hardware: Permite operar en modo simulación de laboratorio con generadores de tráfico realistas o conmutar al convertidor de puertos Moxa NPort conectado al hardware real sin recompilar el código.
• Certificación Criptográfica: Cada evento de despacho, corte de turno y recepción de combustible genera un hash SHA-256 inmutable con sello digital fiscal.

Comandos de Comunicación Veeder-Root Soportados:

3.1. Dashboard Unificado de Inicio (Visión Ejecutiva Integral)

A diferencia de la vista detallada de telemetría de tanques, el módulo de Inicio ofrece un tablero ejecutivo consolidado que unifica en una sola pantalla de alta visibilidad:

• Métricas Clave del Turno (KPIs): Volumen total acumulado despachado, inventario total disponible en planta, bombas en operación activa y estado de la sincronización hacia la nube.
• Inventario Sintético de Tanques: Barras de progreso con porcentajes de llenado, volumen neto actual, capacidad total y presencia de agua en fondo para cada combustible (Magna, Premium, Diésel).
• Forecourt Compacto en Vivo: Visualización simultánea del estado en tiempo real de todas las bombas de despacho de la estación sin requerir desplazamiento de pantalla (scroll).
• Últimas Transacciones Despachadas: Bitácora de tickets recientes con folio, bomba, combustible, litros, precio unitario e importe total.

3.2. Forecourt Compacto y Modo Monitoreo Pasivo vs Modo Simulación

Para estaciones con múltiples islas y alta afluencia vehicular, la vista de dispensarios cuenta con un diseño optimizado y una imagen de patio que brinda contexto visual inmediato:

Vista representativa del patio de despacho y distribución de islas

Diagrama de Estados de Bomba (Dispensario):

Procedimiento Estándar de Descarga (Paso a Paso):

1. Verificación Documental: El operador ingresa el folio de remisión, placas de pipa, transportista y volumen a 20°C marcado en la factura de Pemex.
2. Toma de Lectura Inicial (Sonda ATG): El Appliance consulta la sonda del tanque de destino y congela el volumen inicial y altura de agua en fondo (debe ser 0 mm).
3. Interconexión y Descarga: Se conecta la manguera de descarga con línea a tierra. La telemetría detecta el incremento paulatino de producto.
4. Periodo de Reposo (15 minutos): Se espera a la disipación de burbujas de aire y estabilización térmica.
5. Toma de Lectura Final & Conciliación: El sistema calcula:
   Merma (L) = Volumen Neto Recibido ATG - Volumen Facturado Remisión (a 20°C)
   Tolerancia Máxima SAT / CRE: ±0.50%
6. Firma Digital: Se genera el certificado digital de descarga con hash SHA-256 y sello fiscal para auditoría.

Sellado Fiscal SAT Anexo 30:

Al ejecutarse el corte, el sistema emite un ticket impreso con el desglose de ventas por manguera, forma de pago (efectivo, tarjetas, vales) y el balance volumétrico. Este registro queda sellado y se transmite automáticamente a la nube para formar parte del reporte de controles volumétricos diario.

¿Por qué SQLite en el Appliance Local en lugar de un motor pesado (PostgreSQL / MySQL)?

• Zero-Dependency & Zero-Maintenance: SQLite no es un servicio de servidor en ejecución, sino una biblioteca C/C++ embebida directamente dentro del proceso del Appliance. No consume 1-2 GB de memoria RAM en segundo plano, no abre puertos adicionales ni requiere un Administrador de Base de Datos (DBA) en la gasolinera.
• Resiliencia Total a Apagones (Modo WAL - Write-Ahead Logging): Las estaciones sufren micro-cortes y apagones frecuentes. En motores cliente-servidor convencionales, un apagón repentino durante una escritura a disco suele corromper los índices y bloquear el arranque del servicio. SQLite en modo WAL escribe en un archivo de bitácora secuencial (appliance.db-wal) con operaciones atómicas ACID. Si la energía se corta a mitad de un despacho, el archivo se repara automáticamente al reiniciar en milisegundos sin pérdida ni corrupción de datos.
• Portabilidad Absoluta (Single File): Toda la base de datos local reside en un único archivo ~/.flexorgas/appliance/appliance.db, facilitando respaldos automáticos instantáneos antes de mantenimientos de hardware.
• Buffer Offline de 90 Días: El Appliance puede operar de forma continua sin conexión a Internet durante meses, acumulando cada litro despachado, variación de sonda y corte de turno.

Patrón Outbox y Sincronización Asíncrona hacia Azure PostgreSQL:

En la nube (Flexor Gas Cloud), los datos consolidados se almacenan en Azure Database for PostgreSQL Flexible Server por su soporte multi-tenant y manejo nativo de documentos JSONB (necesarios para los sellos del SAT Anexo 30). La sincronización entre el SQLite de la estación y el PostgreSQL de la nube opera bajo el Outbox Pattern:

Un servicio en segundo plano (CloudSyncWorker) lee lotes de eventos pendientes y los transmite vía HTTP POST seguro (mTLS 1.3 con firma HMAC-SHA256) a la nube. Al recibir confirmación (Ack HTTP 200), marca los registros locales como SYNCED, garantizando entrega garantizada (At-Least-Once Delivery) e idempotencia por hash criptográfico.

Matriz de Permisos y Roles en el Appliance Local:

8.2. Ergonomía de Interfaz y Directrices de UX

• Cierre de Modales por Clic Externo (Backdrop): Cualquier ventana modal (usuarios, corte de turno, recepciones o precios) se cierra inmediatamente al hacer clic en el fondo oscurecido exterior sin necesidad de buscar el botón de cruz.
• Tooltips Informativos sin Alteración de Cursor: Las descripciones de ayuda aparecen suavemente tras posar el cursor durante 3 segundos sobre el elemento, manteniendo el cursor estándar del puntero (sin cambiar a signo de interrogación) y desvaneciéndose de forma instantánea al retirar el ratón.
• Identificador de Estación Única: La barra superior presenta un distintivo con el nombre comercial, municipio y número de permiso CRE configurado en el sistema local, eliminando controles desplegables que pudieran sugerir cambio a estaciones remotas.

Comando de Instalación en Linux / macOS:

Comando de Instalación en Windows (PowerShell Administrador):

Verificación de Servicio Activo: