Modo Offline y Sincronizacion

1. Como funciona el modo offline de Clink

Clink esta preparado para que tu restaurante no se detenga si se cae el internet. No tienes que activar nada ni presionar ningun boton: el sistema detecta automaticamente cuando pierde la conexion y cambia a modo local en silencio.

Mientras estas sin internet, todos los datos de ventas, pedidos y movimientos de caja se guardan localmente en el navegador usando IndexedDB, un almacenamiento seguro integrado en el sistema. Cuando vuelve la conexion, todo se sube automaticamente al servidor sin que tengas que hacer nada.

2. Que funciona sin internet

La gran mayoria de las funciones que necesitas para operar en el dia a dia funcionan perfectamente sin internet. Aqui esta la lista completa:

• Ventas y pedidos en el POS — puedes crear, modificar y completar ventas con total normalidad.
• Cobros en efectivo — registra pagos en efectivo sin ningun problema.
• Pagos con tarjeta (registro) — el pago se registra en Clink aunque el datafono procese por su propia red.
• Apertura y cierre de caja — abre turno, cierra turno y haz movimientos de caja (entradas y salidas de efectivo).
• Gestion de pedidos — crea pedidos nuevos, modifica pedidos abiertos, marca pedidos como completados.
• Actualizacion de inventario — las cantidades se calculan localmente y se sincronizan despues.
• Pantalla de cocina (via LAN) — si tus terminales estan en la misma red local, la cocina sigue recibiendo pedidos.
• Consulta de productos y precios — todo el catalogo esta cacheado localmente.

3. Que necesita internet

Algunas funciones dependen de servicios externos y no pueden operar completamente sin internet. Aqui esta la lista para que lo tengas claro:

• Consultas al Supervisor IA — la inteligencia artificial necesita conexion al servidor para responder.
• Notificaciones por WhatsApp — se guardan en cola y se envian automaticamente cuando vuelve el internet.
• Validacion de facturas DIAN — la DIAN requiere internet; mientras tanto, Clink entra en modo contingencia (ver seccion 9).
• Reportes entre sucursales — la consolidacion de datos de varias sedes necesita conexion.
• Integraciones con delivery — Rappi, iFood y otras plataformas requieren conexion en tiempo real.
• Actualizaciones del sistema — nuevas versiones se descargan solo con internet.

4. El banner de "Sin conexion"

Cuando Clink detecta que se perdio el internet, aparece un banner naranja en la parte superior de la pantalla. Este banner se llama internamente POSOfflineBanner y su funcion es mantenerte informado.

Que significa el banner

• Clink detecto la caida de internet y ya esta operando en modo local.
• Todas tus ventas y movimientos se estan guardando de forma segura en el equipo.
• Cuando el internet regrese, el banner desaparece automaticamente y la sincronizacion comienza.

Que debes hacer cuando lo ves

1. Nada especial. Sigue atendiendo a tus clientes como siempre.
2. Verifica si puedes resolver el problema de internet (reiniciar router, revisar cables).
3. Si tienes multiples terminales, asegurate de que esten en la misma red local (ver seccion 6).

5. Como se sincronizan los datos al reconectar

Cuando el internet regresa, Clink inicia un proceso de sincronizacion en segundo plano. Tu no ves interrupciones — el sistema sigue funcionando mientras sube los datos pendientes al servidor.

El proceso paso a paso

1. Deteccion de conexion. Clink verifica que el internet esta de vuelta con una prueba de conectividad.
2. Inventario de datos pendientes. Revisa todo lo que se registro en IndexedDB mientras estabas offline.
3. Subida ordenada. Los datos se envian al servidor en el orden en que se crearon, para mantener la coherencia.
4. Verificacion de conflictos. El sistema CrossDbReconciler compara los datos locales con lo que hay en el servidor.
5. Resolucion automatica. Si no hay conflictos, los datos se fusionan y el proceso termina.
6. Limpieza local. Los datos ya sincronizados se eliminan del almacenamiento local para liberar espacio.

6. Configurar sincronizacion por red local (LAN)

Si tienes varias terminales (cajas, cocina, bar), puedes configurar una sincronizacion por red local. Esto permite que los equipos se comuniquen entre si usando tu red WiFi o cable de red, sin necesidad de internet.

Para que sirve

Imagina que tienes dos cajas y la cocina. Si se va el internet pero todos estan conectados al mismo router, la sincronizacion LAN permite que:

• La cocina siga recibiendo pedidos de ambas cajas.
• Las dos cajas vean el mismo estado de los pedidos.
• Los datos se mantengan sincronizados entre terminales sin internet.

Como configurarlo

1. Abre el menu lateral y ve a Administracion.
2. Haz clic en Sincronizacion Local.
   /dashboard/configuracion/lan-sync
3. Elige el equipo servidor. Es el equipo principal que coordinara la sincronizacion (normalmente la caja principal).
4. Anota la IP y puerto que aparecen en pantalla (ejemplo: 192.168.1.100:3000).
5. En cada terminal adicional, ve a la misma seccion y selecciona "Conectar como seguidor".
6. Ingresa la IP y puerto del servidor que anotaste en el paso 4.
7. Haz clic en Conectar y espera la confirmacion de conexion exitosa.

Configuracion de red offline adicional

Tambien puedes ajustar opciones avanzadas de red local desde:

1. Ve a Administracion → Red Local.
   /dashboard/configuracion/red-offline
2. Aqui puedes ver el estado de cada terminal conectada a la red.
3. Configura prioridades de sincronizacion si alguna terminal es mas critica.

7. Multiples terminales sin internet

Cuando tienes varias cajas o terminales y se cae el internet, cada una sigue operando de forma independiente. Cada terminal guarda sus datos localmente y los sincroniza cuando vuelve la conexion.

Escenario tipico

Tu restaurante tiene Caja 1 (barra), Caja 2 (salon) y Pantalla Cocina. Se va el internet a las 12:30 pm y regresa a las 2:00 pm.

Con red LAN configurada

Si configuraste la sincronizacion LAN (seccion 6), las terminales se comunican entre si incluso sin internet. La cocina recibe pedidos, las cajas ven estados actualizados y la experiencia es casi identica a cuando hay internet.

Sin red LAN

Sin LAN, cada terminal funciona de forma aislada. La cocina no recibe pedidos automaticamente (tendrias que llevarlos manualmente), pero las ventas se guardan perfectamente y se sincronizan despues.

8. Resolucion de conflictos entre cajas

Cuando dos o mas terminales operan offline al mismo tiempo, puede pasar que ambas modifiquen datos que se superponen. Por ejemplo, ambas cajas descuentan inventario del mismo producto. Para esto existe el CrossDbReconciler.

Como funciona la reconciliacion

1. Al reconectar, cada terminal envia sus datos pendientes al servidor.
2. El servidor detecta si hay registros que se solapan (mismo producto, mismo periodo).
3. Para ventas, no hay conflicto: cada venta es unica, asi que simplemente se suman todas.
4. Para inventario, el sistema recalcula el stock sumando todos los movimientos de todas las terminales.
5. Si hay una discrepancia que no puede resolverse automaticamente, el sistema te notifica para que revises.

Ejemplo practico

El inventario dice que hay 20 hamburguesas. Caja 1 vende 8 offline y Caja 2 vende 6 offline. Al reconectar:

El sistema sabe que 20 - 8 - 6 = 6, y actualiza el stock correctamente. No importa cual terminal se sincronice primero.

9. Modo contingencia de facturacion DIAN

La DIAN (Direccion de Impuestos y Aduanas Nacionales) requiere que cada factura electronica sea validada en linea. Cuando no hay internet, Clink activa el modo contingencia para que puedas seguir facturando legalmente.

Que pasa cuando se va el internet

1. Clink detecta que no puede comunicarse con la DIAN.
2. Automaticamente cambia a modo contingencia.
3. Las facturas se generan con un consecutivo de contingencia especial.
4. Cada factura se guarda localmente con toda la informacion fiscal requerida.
5. El cliente recibe su factura normalmente (impresa o digital).

Cuando regresa el internet

1. Clink envia automaticamente todas las facturas pendientes a la DIAN para validacion.
2. La DIAN asigna los CUFE (Codigo Unico de Factura Electronica) correspondientes.
3. Las facturas se actualizan con el numero de validacion oficial.
4. El proceso queda registrado en el log de facturacion.

10. Consejos para operar sin internet de forma confiable

Aunque Clink maneja el modo offline automaticamente, hay cosas que puedes hacer para que la experiencia sea aun mejor:

Antes de que pase

1. Configura la red LAN (seccion 6). Es tu mejor aliado para operar sin internet con multiples terminales.
2. Asegurate de que el POS este abierto antes de que se caiga el internet. Si el navegador no esta cargado, no podra entrar en modo offline.
3. Ten un respaldo de internet. Un celular con datos moviles compartidos (hotspot) puede salvar el dia para funciones que requieren internet.
4. No borres la cache del navegador. Los datos offline se guardan ahi. Si limpias la cache, pierdes los datos pendientes.

Mientras estas offline

1. No cierres las pestanas del POS. Mantener Clink abierto asegura que todo se guarde correctamente.
2. No apagues los equipos. Si apagas una terminal, los datos offline se mantienen, pero la terminal deja de operar.
3. Usa efectivo como metodo principal de pago si no estas seguro de que el datafono tenga su propia conexion.
4. Lleva un conteo manual de respaldo si el corte se extiende por varias horas, solo como precaucion.

Cuando regresa el internet

1. Espera 2-5 minutos antes de cerrar cualquier terminal. Dale tiempo al sistema para sincronizar.
2. Revisa el registro de sincronizacion en Administracion para confirmar que todo subio correctamente.
3. Verifica el inventario si estuviste mucho tiempo offline con varias cajas operando.