Cluster LAN multi-caja

Esta guía es para Premium. Multi-caja LAN está incluida en el plan Premium.

OnlyPos soporta hasta 5 cajas en la misma LAN, sin servidor central. Las cajas se hablan entre sí de forma segura usando firma criptográfica en cada evento — ninguna otra PC en la red puede inyectar ventas falsas. Si una caja se cae, las demás siguen vendiendo.

Primer nodo

1. En el primer PC, durante el wizard de onboarding selecciona "Este es el primer PC".
2. La app genera las credenciales internas del cluster automáticamente.
3. Te muestra un código de 8 dígitos + QR de pareo.
4. Anota el código (o sácale foto al QR).

Nodos siguientes

En cada PC adicional:

1. Instala OnlyPos y arranca.
2. En el wizard selecciona "Ya tengo OnlyPos en otro PC".
3. La app intenta descubrir el primer nodo automáticamente:
   • Primero por mDNS (default).
   • Si no encuentra en 5 segundos, escaneo activo de la subred.
   • Como fallback siempre disponible: "Ingresar IP manualmente".
4. Una vez detectado, ingresa el código de 8 dígitos.
5. La app hace handshake firmado y queda pareada.

Modo de topología

Durante el onboarding del primer nodo, eliges el modo:

• auto (default) — recomendado para almacén típico. Cualquier nodo puede ser líder. Failover automático en ~3-4 segundos.
• central — si tienes un PC dedicado de back-office. Ese PC queda fijo como líder con prioridad alta.
• hybrid — central preferido pero con failover si cae.

El modo se cambia después desde Admin → Cluster.

Roles por nodo

Cada nodo puede tener uno o más roles:

• order — toma pedidos. Útil en mostradores de almacén.
• cashier — cobra. La caja principal.
• kitchen — vista de cocina (solo en templates Despacho y Mesa).

Los roles se asignan desde Admin → Cluster → Estaciones y se pueden cambiar.

Si cae un nodo

Si tienes modo auto o hybrid, otro nodo asume como líder en ~3-4 segundos. Las demás cajas siguen vendiendo sin notar nada.

Si tienes modo central y cae el central, pierdes escritura del cluster hasta que el central vuelva. Los demás nodos te avisan con un banner. Para evitar esto, cambia a hybrid.

Firewall corporativo

Si la PC está en una red corporativa con firewall estricto o WiFi con client isolation, mDNS puede estar bloqueado. En ese caso usa la opción "Ingresar IP manualmente" durante el pareo.

La regla de firewall que OnlyPos crea solo abre el puerto necesario para el cluster local — no abre nada al internet.

Revocar un nodo

Si pierdes un PC pareado o quieres sacarlo del cluster:

Admin → Cluster → Nodos → Revocar.

La revocación elimina la clave pública del nodo del cluster. Ese PC ya no puede sincronizar eventos. Sus datos locales quedan intactos (no se borran remotamente — eso requiere acceso físico a la PC).