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í con eventos firmados Ed25519. Si una se cae, las demás siguen vendiendo.

Primer nodo

1. En el primer PC, durante el wizard de onboarding seleccioná "Este es el primer PC".
2. La app genera el cluster_secret (32 bytes random) y su par de claves Ed25519.
3. Te muestra un código de 8 dígitos + QR de pareo.
4. Anotá el código (o sacale foto al QR).

Nodos siguientes

En cada PC adicional:

1. Instalá OnlyPos y arrancá.
2. En el wizard seleccioná "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, ingresá 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, elegís 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 tenés 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 tenés modo auto o hybrid, otro nodo asume como líder en ~3-4 segundos. Las demás cajas siguen vendiendo sin notar nada.

Si tenés modo central y cae el central, perdés escritura del cluster hasta que el central vuelva. Los demás nodos te avisan con un banner. Para evitar esto, cambiá 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 usá 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 perdés un PC pareado o querés 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).