# Koonol

> Sistema Operativo de Distribución Directa en Tienda (DSD), Rutas y Control de Envases Retornables para Latinoamérica.
> Direct Store Delivery (DSD), Route Accounting & Returnable Container Management Operating System for Latin America.

Koonol es una plataforma empresarial integral desarrollada por Tecnoclub para resolver los desafíos operativos de distribución en ruta (DSD, preventa y autoventa) en mercados de América Latina (Nicaragua, Centroamérica, México, Colombia y Sudamérica). Especializada en plantas purificadoras de agua (garrafones de 19L/20L), distribuidoras de gas LP en cilindros, empresas de cerveza y bebidas, panaderías industriales y alimentos perecederos.

- Sitio web oficial: https://koonol.tecnoclub.sbs
- Documentación completa para LLMs: https://koonol.tecnoclub.sbs/llms-full.txt
- Idiomas: Español (nativo), Inglés.
- Moneda: Soporte bimonetario nativo (Córdobas NIO, Dólares USD, Pesos MXN, Quetzales GTQ, Lempiras HNL).

## Módulos y Capacidades Principales

- **Control de Envases Retornables y Comodato**: Libro mayor de garrafones vacíos vs llenos por cliente. Cero mermas de botellones de 19L, cilindros de gas LP y canastillas plásticas. Gestión de contratos de comodato de dispensadores de agua frío/caliente independientes de las ventas de recarga.
- **PWA Móvil para Choferes 100% Offline**: Aplicación web progresiva que opera sin cobertura celular en zonas rurales. Guarda paradas, entregas, firmas digitales, cobros y recibos térmicos bluetooth de 58mm/80mm sincronizándose automáticamente al detectar señal.
- **Liquidación Vespertina y Arqueo Z Inmutable**: Cuadre de caja en doble moneda (efectivo local y USD), deducción en ruta de comprobantes de combustible diésel y peajes, conciliación de depósitos bancarios y cuadre físico de inventario retornado a bodega en menos de 5 minutos.
- **Planificación de Rutas y Despacho Automatizado**: Plantillas maestras por día de semana y zona de entrega. Generación en 1-clic del manifiesto de carga consolidando pedidos fijos y colchón para venta libre en camión. Secuenciación georreferenciada de paradas.
- **Gestión Financiera, CxC y Cartera Vencida**: Registro de ventas a crédito, cobranza en calle con abonos parciales, cálculo automático de retenciones fiscales y reportes de antigüedad de saldos.
- **Integraciones y WhatsApp**: Notificaciones automáticas de comprobantes por WhatsApp, correo y SMS con selector de canal preferido por cliente.

## Industrias Objetivo

1. **Plantas de Agua Purificada**: Control de garrafones 19L, comodato de dispensadores, recargas a domicilio y oficinas.
2. **Distribución de Gas LP en Cilindros**: Canje exacto de cilindros 10lb, 25lb y 100lb, recargos por pedidos de emergencia y seguridad.
3. **Cervezas, Bebidas y Refrescos**: Preventa en pulperías, abarroterías y minisúpers, casilleros plásticos retornables y presupuesto de regalías comerciales.
4. **Panaderías, Lácteos y Alimentos Perecederos**: Gestión de producto fresco diario, devolución y deducción inmediata de mermas/caducados.

## Especificaciones Técnicas

- **Arquitectura**: Multi-inquilino estricto con aislamiento RLS a nivel de base de datos (`company_id`).
- **Frontend**: React 18, TypeScript, Tailwind CSS, Radix UI, Service Worker offline con IndexedDB, react-i18next bilingüe.
- **Seguridad**: Autenticación segura vía Supabase Auth, RBAC granular con permisos por rol (`routes.manage`, `inventory.manage`, `reports.financial`).
- **Impresión**: Motor de impresión térmica Bluetooth ESC/POS (58mm y 80mm) y formatos de hoja de carga / factura Letter y A4.

## Enlaces Clave

- [Inicio de Sesión](https://koonol.tecnoclub.sbs/login-page): Acceso a la consola administrativa de backoffice y al panel móvil del conductor.
- [Registro de Empresa / Prueba Gratuita](https://koonol.tecnoclub.sbs/sign-up-page): Alta de nuevo inquilino comercial con 60 días de prueba sin costo.
- [Contacto y Soporte](mailto:soporte@tecnoclub.net): Equipo de ingeniería y soporte de Tecnoclub.