🥛 1. Introducción y Offline-First
El POS de kerospizzasupply.com es una aplicación web progresiva de vanguardia, diseñada específicamente para el acopio de leche y la venta de quesos en rutas de campo. Su principal virtud reside en su arquitectura Offline-First (diseño preparado para la desconexión).
Cuando los conductores y recolectores viajan por áreas rurales donde no existe señal telefónica, el sistema almacena de forma íntegra los vales de acopio, las coordenadas de GPS y las facturas en el almacenamiento local del teléfono. En el momento que se recupera señal de red, el sistema sincroniza todo automáticamente en segundo plano.
📲 2. Instalación del Sistema (PWA)
Para obtener un rendimiento óptimo en dispositivos móviles y de escritorio, se recomienda instalar la aplicación como una App nativa (PWA). Esto crea un icono directo en el escritorio o en la pantalla de inicio del teléfono y optimiza la memoria disponible.
Instalación en Android (Google Chrome):
Entre a kerospizzasupply.com/facturacion. Si accede desde una computadora o si la app aún no está instalada en su móvil, se activará el panel de descarga en Configuración.
Figura 1: Botón para descargar e instalar la app en versión escritorio.
En el móvil, si la app ya fue previamente agregada o si ya está lista en el dispositivo, el botón verde se ocultará automáticamente para dar paso al check verde de confirmación.
Figura 2: Confirmación de aplicación instalada o lista para uso en dispositivo móvil.
Nota: Si no le aparece el botón verde y desea reinstalar, pulse el menú de tres puntos (⋮) en la esquina superior derecha de Google Chrome en su teléfono y elija la opción "Instalar aplicación" o "Agregar a la pantalla principal".
👥 3. Control de Accesos y Roles de Usuario
El POS bloquea las funciones según la responsabilidad del operario que inicia sesión:
| Rol | Para quién es | Secciones habilitadas |
|---|---|---|
| FACTURADOR | Choferes / Recolectores | Acopio diario, Ventas de ruta, Planilla local del camión, GPS tracker. |
| CONTADOR | Administración / Contabilidad | Liquidaciones de productores, Nómina del personal, Gastos de camiones, Catálogos. |
| ADMIN | Encargado General | Control total operativo, reportes consolidados y estadísticas. |
| SUPER_ADMIN | Dueño / Soporte Técnico | Acceso irrestricto, configuración de licencias y gestión del personal. |
🚚 4. Módulo de Campo (Conductores - Rol: FACTURADOR)
Acopio de Leche
Permite capturar la leche recolectada del día. El chofer elige la **Ruta** y al **Productor** asignado a ella. Al ingresar la cantidad, puede cambiar entre Litros y Galones. Al hacer clic en Guardar Recibo, la transacción se almacena en el teléfono.
Ventas en Ruta
Permite vender los productos del camión (queso mozzarella, quesillo, queso chontaleño, etc.). La cantidad de queso se digita en libras y el sistema calcula la conversión en Kilogramos para control de stock. Se puede definir si el cobro es al contado o a crédito.
Impresión de Tickets por Bluetooth
💡 ¿Cómo conectar la Impresora en Ruta?
Vaya a Configuración, encienda su mini impresora bluetooth portátil y presione Conectar Impresora en la app. Al guardar el recibo, este se imprimirá automáticamente. Si no hay impresora, la app le permite enviar un comprobante estructurado por WhatsApp.
📊 5. Módulos Administrativos (Oficina y Contabilidad)
Liquidación de Productores
Calcula los pagos semanales de leche. El sistema carga los vales recogidos por el camión, deduce los préstamos o insumos entregados previamente al productor, y calcula el saldo neto final a cancelar en efectivo o cheque.
Gastos del Vehículo
Permite registrar los gastos de ruta como combustible, viáticos del chofer o repuestos mecánicos, adjuntando fotografías de comprobantes o facturas físicas a través de la cámara del celular.
Back-Office e Inventarios
Genera gráficos en tiempo real sobre ganancias netas, balances de inventarios activos en la planta y rendimientos totales de producción.
🔐 6. Administración de Usuarios y Licencias
El Super Administrador da de alta a todo el personal. Desde la sección de Administración de Usuarios en configuración, se registran los nuevos conductores y se les asigna su contraseña correspondiente.
Adicionalmente, el panel incluye la sección de Control de Licencia, donde se puede visualizar el estado de activación del dominio y agregar códigos prepago para extender la validez del software.
⚙️ 7. Mecánica Técnica Offline
Para que no haya pérdida de información, el sistema utiliza un bucle de red automático. Si el chofer realiza transacciones sin internet, estas quedan registradas con la propiedad synced: 0.
Cada 30 segundos, el software verifica si hay conexión disponible a internet. Al restablecerse la red, recopila de forma masiva los datos con synced: 0, los envía al backend y los actualiza como sincronizados en el panel principal.
🔧 8. Resolución de Problemas Frecuentes
Problema: El cartel "Error al cargar historial: Inicie sesión para acceder al sistema"
Causa: La sesión de usuario en el servidor expiró después de pasar más de 24 minutos inactivo con la pestaña abierta en el teléfono.
Figura 3: Alerta clásica de sesión expirada al intentar consultar datos online sin credenciales activas.
Solución: El interceptor inteligente de la app ahora detectará este error y abrirá automáticamente la ventana de login en la pantalla de su teléfono. Solo ingrese su clave de nuevo para reactivar su sesión y reintentar.
⚠️ Importante: ¿Cómo actualizar la App para ver cambios nuevos?
Si modificas el código de la aplicación, el celular mantendrá la versión vieja. Para forzar la actualización: desliza y cierra la app móvil por completo, ábrela de nuevo y, si es necesario, toca el icono de candado en la barra superior de Chrome y pulsa en "Borrar datos y restablecer".