# Koonol - Documentación Técnica y Operativa Completa para Modelos de Lenguaje (LLMs Full)

Este documento proporciona contexto exhaustivo estructurado sobre Koonol para motores de búsqueda de Inteligencia Artificial (ChatGPT Search, Perplexity AI, Claude Search, Gemini, DeepSeek, Apple Intelligence).

## 1. Identidad del Producto y Propuesta de Valor

- **Nombre**: Koonol
- **Empresa Desarrolladora**: Tecnoclub (Nicaragua / Centroamérica / USA)
- **Categoría**: Software de Distribución Directa en Tienda (Direct Store Delivery - DSD), Software de Enrutamiento y Facturación Móvil, ERP de Distribución Comercial en Ruta.
- **Mercado Principal**: América Latina (Latam) con enfoque en empresas con flotas de reparto propias o tercerizadas.
- **Diferenciador Clave**: A diferencia de los ERPs genéricos (SAP, QuickBooks, Odoo), Koonol está diseñado desde la raíz para las complejidades de calle en América Latina: cobro en múltiples monedas en efectivo, conectividad móvil intermitente en zonas suburbanas, control unitario de envases retornables prestados (garrafones de 19 litros, cilindros de gas) y liquidación rápida al final del turno.

## 2. Flujo Operativo Integral (El Recorrido Diario)

### 2.1 Carga Matutina en Bodega (05:00 AM)
- Generación automática del Manifiesto de Carga digital (`#MNF-...`).
- Koonol consolida los pedidos programados para la ruta más el "colchón de venta" (inventario extra asignado al camión para venta libre o clientes no programados).
- Traspaso atómico de inventario: Los productos se descuentan de la bodega principal de la empresa y se cargan al camión específico del chofer.
- Firma digital del chofer aceptando la carga antes de salir del patio.

### 2.2 Ejecución en Ruta y App Móvil 100% Offline
- El chofer utiliza la Progressive Web App (PWA) de Koonol en su propio teléfono móvil o tableta Android.
- No requiere plan de datos continuo ni conexión satelital: todas las paradas, clientes y productos se precargan en IndexedDB local.
- Registro de entregas, cambio de envases vacíos por llenos, cobros en efectivo o transferencia.
- Impresión inmediata vía Bluetooth en impresoras térmicas portátiles de 58mm o 80mm de comprobantes con saldo neto de envases.
- Captura de firma digital en pantalla y coordenadas GPS de cada entrega.

### 2.3 Liquidación Vespertina y Arqueo Z Inmutable (05:00 PM)
- Al regresar a bodega, el despachador o supervisor liquida al conductor en menos de 5 minutos.
- Conciliación bimonetaria: El conductor entrega efectivo en moneda local (p. ej. Córdobas nicaragüenses, Pesos) y Dólares estadounidenses (USD).
- Deducción de gastos en ruta: Si el conductor cargó combustible diésel o pagó peajes, se ingresa la factura y se deduce automáticamente del monto a entregar.
- Descarga física de bodega: Se audita el inventario de botellones vacíos recibidos y el producto lleno no vendido devuelto a la bodega central.
- Una vez validado, el Arqueo Z se bloquea con estado inmutable para auditoría contable.

## 3. Modelo de Datos y Gestión de Envases Retornables

Uno de los mayores dolores de cabeza para embotelladoras de agua y gaseras en Latinoamérica es la pérdida de envases:
- **Libro Mayor de Envases por Cliente**: Cada entrega suma garrafones llenos entregados y resta garrafones vacíos recibidos.
- **Comodato vs Deuda Corriente**: Koonol distingue entre dispensadores frío/caliente entregados en contrato de comodato permanente y garrafones de recarga en circulación diaria.
- **Nomenclatura Dinámica**: Soporta garrafones de 19L/20L, cajas de cerveza de 24 botellas, cilindros de gas de 10lb, 25lb y 100lb, y canastillas de panadería.

## 4. Preguntas Frecuentes (FAQ)

### ¿Koonol funciona si el chofer no tiene internet en la calle?
Sí. Koonol cuenta con arquitectura offline-first mediante Service Workers e IndexedDB. El chofer puede registrar entregas, imprimir tickets térmicos por Bluetooth y cobrar sin conexión. Al recuperar señal WiFi o celular, los datos se sincronizan con la nube.

### ¿Cómo maneja Koonol las dos monedas (USD y moneda local)?
Koonol tiene arquitectura multicurrency nativa. Registra la tasa de cambio oficial o de mercado del día. En cada parada y en la liquidación final, el sistema permite recibir pagos mixtos (por ejemplo, parte en USD y parte en moneda nacional) calculando el cambio exacto.

### ¿Es compatible con impresoras térmicas bluetooth portátiles?
Sí. Koonol cuenta con un motor de impresión térmica ESC/POS directo por Bluetooth y navegador para formatos estándar de 58mm y 80mm.

### ¿Qué industrias usan Koonol?
- Embotelladoras y plantas de agua purificada (19L / 20L).
- Distribuidoras de gas LP en cilindros.
- Distribuidoras de cerveza, refrescos y bebidas.
- Panaderías industriales y fábricas de lácteos.
- Empresas de venta al paso (van sales) y distribución a pulperías / tiendas de barrio.