Red local (LAN)

TuBiznext Offline puede funcionar de tres maneras distintas. Tú eliges cuál usar desde Configuración → Red.

Modo	Cuándo usarlo
Standalone	Una sola computadora. Sin red. Es el modo por defecto al instalar.
Servidor	Esta computadora comparte su base de datos con otras en la misma red.
Cliente	Esta computadora se conecta al servidor de otra computadora en la red.

Indicador de modo en la barra superior

El icono en la esquina superior derecha de la pantalla refleja en tiempo real el modo actual:

Icono	Significado
🖴 Gris (HardDrive)	Modo independiente — esta terminal opera localmente sin servidor central.
📡 Color primario (Server)	Servidor LAN — esta terminal es el servidor central. Otros clientes se conectan acá.
📶 Verde (Wifi)	Cliente LAN conectado — conexión activa al servidor.
📶 Amarillo pulsante	Conectando o reconectando.
📵 Rojo (WifiOff)	Sin conexión al servidor.

Al hacer clic en el icono se abre un panel con detalles técnicos:

Servidor: IP:puerto al que se conecta (o que sirve).
Latencia: con calificación (excelente / buena / regular / lenta).
Descubrimiento: el método usado para encontrar al servidor (IP guardada, mDNS, Broadcast UDP, Escaneo de subred).
Último chequeo: hace cuánto el servidor respondió por última vez.
Clientes conectados (modo servidor): lista con nombre y rol de cada terminal activa.
Servidores rechazados (si hay): alerta de seguridad si se detectaron impostores en la red.

Requisitos

Antes de configurar el modo LAN verifica lo siguiente:

Todas las computadoras están conectadas al mismo router o switch (misma red local).
Si usas WiFi, todas están en la misma red WiFi (mismo SSID).
El router no tiene activado el aislamiento de clientes (Client Isolation o AP Isolation). Esta opción, si está activa, impide que los dispositivos WiFi se vean entre sí.
El Firewall de Windows no bloquea los puertos de comunicación de TuBiznext en la computadora servidor.

Configurar la computadora servidor

En la computadora que actuará como servidor, abre TuBiznext y ve a Configuración → Red.
Haz clic en la card Servidor.
Haz clic en el botón verde Iniciar servidor. El sistema detecta la IP local, resuelve un puerto libre y arranca.
Verás la dirección que deben usar las terminales para conectarse y el código de pareo del servidor.
Si tienes varias interfaces de red (WiFi + cable), usa el desplegable para elegir cuál usar.

Si el puerto preferido está ocupado

Si el puerto guardado (típicamente 7878) ya está siendo usado por otro programa, TuBiznext prueba automáticamente los siguientes 5 puertos consecutivos (7879, 7880, …, 7883). Si encuentra uno libre lo usa y muestra un aviso:

Puerto cambiado: 7878 estaba ocupado — se usó 7879.

El puerto efectivo se persiste automáticamente, así que la próxima vez se intentará primero ese.

Timeout de inicio configurable

En Configuración → Red → Modo servidor → Avanzado hay un slider para ajustar cuánto espera el sistema a que el servidor levante (entre 5 y 60 segundos, default 14s).

Subilo si tu computadora es lenta (HDD viejo, poca RAM).
Bajalo si tu PC es rápida (SSD moderno) y querés ver fallos más rápido.

Conectar una terminal cliente

En cada computadora adicional que usarás como terminal:

Instala TuBiznext normalmente (el mismo instalador).
Abre la aplicación y ve a Configuración → Red.
Haz clic en la card Cliente.
El sistema busca automáticamente el servidor en la red. Si lo encuentra, aparece en la lista “Servidores en la red” — haz clic en él para conectarte.
Si no lo encuentra automáticamente, usa la sección “Ingresar IP manualmente” (más abajo en la misma pantalla), escribe la IP del servidor y haz clic en Probar conexión.
Guarda el modo cliente y vuelve al login.
Inicia sesión con tus credenciales normales. Si es la primera vez que esa terminal usa el servidor, TuBiznext hace el pareo automáticamente después de validar el servidor y el usuario.

Emparejar con código o QR (lo más simple)

Cuando el descubrimiento automático no encuentra el servidor (redes especiales, subredes distintas, o simplemente para ir al grano), podés conectar la terminal con un código de conexión — sin adivinar la IP.

En la PC servidor: en Configuración → Red, con el servidor iniciado, la tarjeta “Los clientes se conectan a” muestra:

Un código QR (desplegable “Conectar con QR / código”).
El código de texto copiable, con el formato biznext://IP:puerto.

En la terminal cliente o la APK: en el aviso Sin conexión al servidor:

Escaneá el QR con el botón Escanear QR (aparece solo en dispositivos con cámara, típicamente la APK). Apuntá la cámara al QR de la PC servidor y la conexión se completa sola.
O pegá el código de texto en el campo de dirección: la app separa sola la IP y el puerto. Después tocá Guardar.

Cómo funciona el descubrimiento automático

Cuando eliges el modo Cliente, el sistema busca el servidor en la red de forma automática y por etapas. Primero prueba las direcciones conocidas; después usa UDP y mDNS; solo si lo anterior falla escanea la subred. Así evita saturar routers modestos con cientos de conexiones innecesarias.

Método	Cuándo se usa
IP guardada	Pruebas rápidas a la última IP conocida.
mDNS (Bonjour)	Estándar de descubrimiento de servicios local.
Broadcast UDP	El cliente “grita” en la red y el servidor responde.
Escucha UDP	El cliente escucha los pulsos periódicos del servidor.
Escaneo de subred	Último recurso: prueba todas las IPs de la red local.

Si el servidor está en la misma red y el firewall lo permite, el sistema lo encuentra sin que tengas que escribir ninguna IP. Si no, podés conectarte manualmente con la IP del servidor.

Cuando la búsqueda termina sin resultados, Configuración → Red muestra un bloque de Diagnóstico de red con la causa más reciente y verificaciones concretas: misma WiFi, aislamiento de clientes del router, firewall y puertos 7878–7883/7879.

El panel del icono de modo te muestra cuál método funcionó — útil cuando algo no anda y querés saber por qué.

Fijar la IP del servidor (para que no cambie)

Si la IP del servidor cambia cada vez que reinicias (IP dinámica del router), conviene fijarla para que los clientes nunca la pierdan. Tenés tres opciones, de más simple a más manual:

Botón “Fijar esta IP (1 clic)” — en Configuración → Red → Modo servidor, desplegá “Evitá que los clientes pierdan el servidor” y tocá Fijar esta IP. TuBiznext pina la configuración actual (misma IP, máscara, gateway y DNS que ya funcionan) como estática. Windows pide permiso de administrador. Si algo sale mal, el botón Volver a IP automática lo revierte al instante.
Reserva en el router (DHCP) — entrá a la config del router y reservá esta IP para la PC servidor por su dirección MAC. No toca Windows.
Cable de red — conectar el servidor por cable suele darle una IP más estable que WiFi.

Cliente y servidor en redes distintas

Si el cliente se conecta exitosamente pero las dos máquinas están en subredes diferentes (por ejemplo una en WiFi guest y otra en la corporativa, o el cliente está en VPN), el sistema lo detecta y lo registra como advertencia en el Diagnóstico de red.

Mensaje típico:

Cliente y servidor en redes distintas: 192.168.1.0/24 vs 10.0.0.0/24

Esto explica por qué el descubrimiento automático puede fallar — los broadcasts UDP no cruzan subredes. Si funciona pasando la IP manual, ignorá la advertencia; si no, conectá ambas máquinas a la misma red.

Servidor pareado (protección contra suplantación)

Cuando un cliente inicia sesión exitosamente contra un servidor por primera vez, queda pareado con ese servidor. A partir de ese momento, la terminal verifica en cada conexión que sigue hablando con el mismo equipo. Esta verificación es automática. Para qu� sirve: si alguien en la red local pusiera otro equipo intentando hacerse pasar por tu servidor, las terminales lo detectan. Si eleg�s ese servidor e inici�s sesi�n con credenciales v�lidas, TuBiznext cambia el pareo autom�ticamente. Para qué sirve: si alguien en la red local pusiera otro equipo intentando hacerse pasar por tu servidor, las terminales pareadas lo detectarían y mostrarían un aviso. Tus credenciales y datos no se enviarían al equipo intruso.

Avisos que podés ver

Aviso	Qué significa
Badge rojo con `!` sobre el icono de modo	Se detectó al menos un servidor LAN que no coincide con tu pairing. Clic para ver detalles.
Banner amarillo “Se detect� un servidor distinto al pareado”	Apareci� un servidor con identidad distinta a la guardada. Si es tu nuevo servidor, selecci�nalo e inicia sesi�n; el pareo se actualiza solo.
Banner rojo “Servidor con firma inválida detectado y descartado”	Se detectó un equipo intentando imitar al servidor. La terminal lo rechazó automáticamente. Avisá al administrador.

Cambiar de servidor intencionalmente

Si cambiaste el equipo servidor por motivos leg�timos (reinstalaci�n, equipo nuevo, etc.), el flujo normal es elegir el nuevo servidor e iniciar sesi�n. No hace falta pelear con c�digos ni pasos extra:

En la terminal cliente, ve a Configuración → Red.
Bajá a la sección Servidor pareado.
Si el nuevo servidor aparece como detectado, selecci�nalo.
Guarda el modo cliente si cambiaste la IP o el puerto.
En el pr�ximo inicio de sesi�n, la terminal se va a parear autom�ticamente con el servidor seleccionado.

Bloqueo por intentos fallidos

Para proteger las cuentas, el sistema bloquea automáticamente los intentos repetidos de login con contraseña incorrecta:

5 intentos fallidos → bloqueo de 30 minutos
El bloqueo aplica tanto a la dirección IP que intenta como al nombre de usuario afectado
Después de 30 minutos el contador se resetea automáticamente

Si te bloqueás por error (te equivocaste de contraseña varias veces): esperá 30 minutos y volvé a intentar. Si es urgente, el administrador puede reiniciar el servidor para limpiar los contadores.

Panel de administración del servidor

Cuando estás en modo Servidor, Acerca de → Servidor LAN muestra el panel de administración en tiempo real. Configuración → Red queda para elegir el modo, puerto, interfaz, firewall y opciones de arranque.

En la parte superior del panel verás un indicador de estado del servidor:

Estado	Significado
🟢 Saludable (≤5s)	El servidor está respondiendo normal. Corazón verde con pulso.
🟡 Lento (5–15s)	El servidor tarda en responder. Posible carga alta o red lenta.
🔴 Sin respuesta (>15s)	El servidor no responde. Posible crash o problema grave.

Botón Probar ahora para forzar un chequeo manual sin esperar el polling automático.

Información disponible

Sección	Qué muestra
Estado general	Uptime, puerto, tamaño de la base de datos, versión.
Clientes conectados	Lista de terminales activas con usuario y rol. Puedes expulsar una terminal con el botón ✕ o todas a la vez.
Actividad reciente	Últimas 50 operaciones: quién hizo qué y cuándo.
Log del proceso	Las últimas 80 líneas del archivo `server.log` con coloreado por severidad (errores en rojo, warnings en amarillo). Útil para diagnosticar problemas. Botón Refrescar para releer.
Estadísticas del día	Operaciones totales, errores, latencia promedio, conexiones.

Los botones Reiniciar servidor y Detener servidor están en la parte inferior del panel.

Modo mantenimiento

Cuando necesitás hacer cambios en el servidor (instalar actualizaciones, hacer un backup pesado, reiniciar) pero no querés cortar a los vendedores que están en medio de una venta:

Ve a Acerca de → Servidor LAN y encuentra la sección Modo mantenimiento.
Clic en Activar.

Mientras el modo está activo:

✅ Los vendedores ya conectados siguen operando normalmente (queries, ventas, SSE en tiempo real).
❌ Los nuevos logins de vendedores son rechazados con 503 Service Unavailable.
✅ Los administradores siguen pudiendo loguearse para gestionar el server.

Esto te permite:

Activar mantenimiento.
Esperar a que los vendedores actuales terminen sus ventas.
Hacer el cambio que necesites (reiniciar, backup, etc.) sin interrumpir a nadie.
Desactivar mantenimiento cuando termines.

Diagnóstico de red

Al final de la sección Configuración → Red hay un panel desplegable “Diagnóstico de red” con un historial cronológico de los últimos 50 eventos de red:

Cambios de modo (standalone ↔ server ↔ client)
Conexiones y desconexiones del cliente
Métodos de discovery usados
Cambios de IP del servidor detectados
Servidores rechazados por pairing inválido
Problemas de subnet
Errores de DB

Cada evento tiene:

Icono y color según severidad (verde = OK, amarillo = warning, rojo = error).
Timestamp (hora exacta y “hace cuánto”).
Mensaje descriptivo.

Botones del panel:

Exportar JSON — descarga toda la timeline para enviar a soporte.
Vaciar — limpia el historial (no afecta nada más).

Auto-restart cuando hay problemas

El sistema se recupera solo de problemas comunes sin que tengas que intervenir:

Problema	Reacción automática
Microcorte de red (parpadeo de WiFi, congestión de 1–2s)	La terminal muestra un aviso sutil “Reconectando…” arriba y sigue usable — reintenta la misma IP en ráfaga corta. Solo si el corte persiste aparece el aviso a pantalla completa. Un parpadeo ya no interrumpe la venta.
El proceso del servidor crashea	Watchdog lo reinicia hasta 3 veces (delays de 2s, 5s, 10s). Toast informativo en cada intento.
Cliente pierde conexión más tiempo	Rediscovery escalonado: primero vías rápidas (IP guardada, UDP, mDNS); solo si persiste, escaneo de subred. Reintenta con backoff hasta 15s, para siempre.
IP del servidor cambia (DHCP)	El servidor vuelve a anunciarse rápido (cada 0,5s por 30s) y el cliente detecta y guarda la nueva IP en segundos. Evento en la timeline.
La PC servidor se iba a dormir	Mientras sirve, TuBiznext impide que la PC entre en reposo (la pantalla igual se apaga). Así no se corta a las terminales de noche o en inactividad.
Pérdida total de red en el servidor	Cuando vuelve la red, retoma el broadcast rápido para que los clientes lo reencuentren enseguida.
Server compartido de otra forma	Funciona en cualquier topología con camino de red: WiFi normal, la PC servidor como zona WiFi, o cable directo entre dos PCs sin router.
Puerto preferido ocupado	Prueba 5 puertos consecutivos siguientes antes de fallar.

Diagnóstico automático de la causa

Cuando una terminal no encuentra el servidor, el aviso Sin conexión al servidor no solo dice “no hay conexión”: intenta identificar la causa más probable y darte los pasos concretos. Los casos típicos:

Causa detectada	Qué te dice / qué hacer
El servidor cambió de IP	Precarga la IP nueva; tocás Guardar y listo.
Aislamiento de clientes del router	El servidor no responde por ningún canal: desactivá “AP/Client Isolation” en el router, usá cable, o creá una zona WiFi.
Redes distintas / subred	Estás en otra red que el servidor (WiFi invitados, VPN): conectate a la misma.
Sin red / servidor apagado	Revisá que el servidor esté encendido con TuBiznext abierto y el firewall de Windows.

Qué pasa cuando el servidor se apaga

Si el servidor se apaga mientras hay terminales conectadas:

Las terminales detectan la pérdida de conexión y muestran un aviso de reconexión.
No pueden registrar ventas ni consultar datos hasta que el servidor vuelva.
Cuando el servidor se reactiva, las terminales reconectan automáticamente en pocos segundos. No necesitas hacer nada en las terminales.

Aviso de cierre (graceful shutdown)

Cuando un admin detiene el servidor desde el panel (no por un crash), los clientes reciben un toast rojo durante 8 segundos:

El servidor se va a cerrar — En unos segundos quedará offline. Guardá tu trabajo y esperá la reconexión.

Tienen 3 segundos para guardar antes del shutdown real. No es mucho, pero alcanza para terminar una operación en curso.

Si el Firewall de Windows bloquea la conexión

El instalador de TuBiznext crea automáticamente las reglas de firewall necesarias. Si fueron eliminadas:

Abre Panel de control → Firewall de Windows Defender → Configuración avanzada.
Haz clic en Reglas de entrada → Nueva regla.
Elige Puerto, define el rango de puertos que usa TuBiznext (consúltalo en Configuración → Red en la pantalla del servidor).
Selecciona Permitir la conexión y aplica para todos los perfiles.

Si no estás seguro de cómo hacerlo, contacta a Soporte para que tu distribuidor lo configure.

Protección contra ventas duplicadas

Cuando dos vendedores en la misma ubicación intentan vender el último (o uno de los últimos) productos del stock al mismo tiempo, el sistema garantiza que solo una venta se complete con stock real:

El primer vendedor descuenta el stock normalmente.
El segundo vendedor recibe un mensaje claro:

Otro vendedor acaba de descontar stock de “[producto]”. Refrescá el carrito y volvé a intentarlo.
Su venta NO se registra hasta que refresque el carrito con el stock actualizado.

Esto se controla a nivel de base de datos con un trigger atómico — es imposible que dos ventas concurrentes generen stock fantasma negativo.

Preguntas frecuentes sobre LAN

¿Cuántas terminales puedo conectar? No hay un límite configurado en el software. El rendimiento práctico depende del hardware del servidor. Para negocios con 2 a 5 terminales funciona sin problemas.

¿Las terminales necesitan licencia propia? No para la APK ni para el modo cliente LAN simple. La licencia se valida en la computadora servidor, que es donde vive la base de datos principal. Las terminales cliente y la APK se conectan al servidor autorizado y no necesitan activar una licencia local propia.

Si instalás otra PC para trabajar como servidor independiente o modo standalone, esa PC sí necesita su propia licencia.

¿Puedo usar el servidor también como punto de venta? Sí. La computadora servidor puede hacer ventas al mismo tiempo que sirve a las demás terminales.

¿Qué pasa si dos vendedores venden el mismo producto al mismo tiempo? El sistema lo maneja automáticamente. Si dos terminales intentan operar sobre el mismo dato a la vez, una espera a que la otra termine. Y si el stock se agota durante esa espera, el segundo recibe un mensaje claro y NO se cobra una venta fantasma — ver “Protección contra ventas duplicadas” arriba.

¿Los reportes incluyen ventas de todas las terminales? Sí. Todas las ventas van a la misma base de datos del servidor. Los reportes del administrador siempre muestran datos consolidados de todas las terminales.

¿El servidor arranca solo al abrir TuBiznext? Sí, si ya configuraste el modo servidor antes. La primera vez que activás modo servidor tenés que clickear “Iniciar servidor” manualmente desde Settings. Las siguientes veces se inicia solo al abrir la app.

¿Puedo cambiar el puerto del servidor? Sí, desde Configuración → Red podés editar el puerto. Si el puerto preferido está ocupado, TuBiznext busca uno libre cercano automáticamente.

¿Qué hago si la PC servidor cambia de IP por DHCP? Los clientes la detectan en el siguiente discovery y se reconectan solos. Verás el cambio reflejado en el diagnóstico de red. Si querés evitar el corte breve, configurá IP fija en el servidor.

¿Cuánta latencia es normal en LAN?

<50 ms: excelente (cable o WiFi 5GHz cercano).
<150 ms: buena (WiFi normal).
<400 ms: regular (WiFi débil o red saturada).
>400 ms: lenta (revisar router/distancia).

Lo ves en el tooltip del icono de modo.

Conexion automatica para clientes y APK

TuBiznext intenta que el cliente no tenga que escribir IP manualmente:

En la PC servidor, ve a Configuracion -> Red, elige Servidor y haz clic en Iniciar servidor o Guardar. Si el servidor esta detenido, TuBiznext lo inicia automaticamente.
En la terminal cliente o en la APK, la busqueda LAN corre sola al abrir en modo cliente.
Si aparece el aviso Sin conexion al servidor, toca Buscar auto. La app vuelve a escanear la red, prueba los puertos habituales del servidor y guarda el resultado.
La IP manual queda como respaldo para soporte o redes especiales.

Diagnostico en la APK

Cuando la APK no logra conectarse, el aviso Sin conexion al servidor muestra un panel Diagnostico LAN. Ese panel funciona como una consola visible en el telefono.

Cada intento muestra:

Mensaje	Que significa
IP guardada	La APK probo la ultima IP conocida del servidor.
UDP query / UDP listen	La APK intento descubrir el servidor por broadcast del router.
mDNS	La APK busco el servicio local anunciado por la laptop servidor.
Scan	La APK escaneo la subred WiFi real y los puertos `7878-7883`.
Sin respuesta	La IP/puerto no respondio. Revisa firewall, puerto y que ambos equipos esten en la misma WiFi.

Si aparece Se detect� un servidor distinto al pareado, la terminal encontr� un servidor TuBiznext diferente al anterior. Si es tu servidor correcto, selecci�nalo e inicia sesi�n; la app actualizar� el pareo autom�ticamente.

Si la laptop servidor esta conectada por WiFi al router y el telefono no encuentra nada, revisa en el router que no este activado AP Isolation, Client Isolation o una red de invitados. Esas opciones impiden que el telefono vea la laptop aunque ambos tengan internet.

Reparar conexion desde Windows

En la PC servidor, Configuracion -> Red -> Servidor LAN incluye el boton Reparar conexion.

Usalo cuando un telefono o una terminal no encuentre el servidor automaticamente. TuBiznext hace estas acciones por vos:

Detiene cualquier servidor LAN anterior.
Repara las reglas del Firewall de Windows para los puertos del servidor.
Vuelve al puerto automatico principal 7878.
Detecta la interfaz WiFi/Ethernet activa.
Inicia el servidor otra vez y empieza a anunciarlo en la red.

¿Todavía no tienes TuBiznext? Pruébalo 30 días gratis.