Files
OnEverControl/docs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md

4.9 KiB

GUÍA TÉCNICA: DESPLIEGUE PILOTO Y CONVIVENCIA HÍBRIDA (Fase 6)

OnEverControl — Servidor de Puesto de Control Web

Esta guía detalla los pasos de instalación, configuración de red y puesta en marcha del entorno piloto de OnEverControl para operar de forma simultánea e híbrida con el sistema de escritorio existente de OnEverAccess.


1. Principio de Convivencia Híbrida

OnEverControl fue diseñado bajo una arquitectura desacoplada no disruptiva:

  • Base de Datos Compartida: Ambas interfaces (Web y Escritorio) leen y escriben en las mismas tablas transaccionales de SQL Server (videoman: tck, tckper, tckprx, tckhst, mvthist).
  • Hardware Desacoplado: El cliente web no toma puertos COM ni compite por recursos físicos. Toda apertura se encola en la tabla pdtmdl, la cual es leída y despachada por el servicio local OnEverWPC hacia las placas ST1660 en menos de 50 ms.
  • Transición Transparente: Un ingreso registrado desde una tablet en la garita puede ser cerrado desde una PC con el software de escritorio, y viceversa, sin inconsistencias ni bloqueos.

2. Opciones de Despliegue del Servidor Web

El servidor puede instalarse en el mismo equipo donde corre OnEverAccess o en un nodo auxiliar de la red LAN:

Opción A: Windows 10/11 Bare-Metal (Modo Nativo o Servicio NSSM)

  1. Configurar el archivo .env:
    DB_SERVER=localhost\SQLEXPRESS
    DB_NAME=videoman
    DB_USER=sa
    DB_PASSWORD=SuPassword
    SERVER_PORT=8000
    
  2. Construir el Frontend (si hubo cambios de código):
    cd frontend
    npm install
    npm run build
    
  3. Ejecutar como Servicio de Windows (Permanente y Autoiniciable): Ejecute como Administrador:
    scripts\windows\install_service.bat
    
    El servicio iniciará automáticamente con el sistema operativo y reiniciará ante cualquier fallo.
  4. Ejecución Directa de Diagnóstico:
    scripts\windows\start_native.bat
    

Opción B: Contenedor LXC en Proxmox VE / Debian (Recomendado para servidores)

El contenedor LXC ofrece un consumo ultra-reducido (< 80 MB de RAM y < 1% CPU):

  1. Cree un contenedor LXC Debian 12 en Proxmox con 1 vCPU, 512 MB de RAM y 4 GB de disco.
  2. Copie la carpeta OnEverControl/ al contenedor.
  3. Ejecute el script automatizado de aprovisionamiento:
    chmod +x scripts/lxc/setup_lxc.sh
    sudo ./scripts/lxc/setup_lxc.sh
    
  4. El script configurará las dependencias de FreeTDS, creará el entorno virtual Python y registrará el servicio systemd onevercontrol.service con reinicio automático.

Opción C: Docker Compose con Nginx Reverse Proxy

  1. Verifique que Docker y Docker Compose estén instalados en el host.
  2. Levante el stack productivo:
    docker compose up -d
    
  3. El frontend y los WebSockets quedarán disponibles en el puerto estándar 80.

3. Configuración de la Tablet en Garita (Samsung Galaxy Tab)

  1. Conexión de Red: Conecte la tablet a la red Wi-Fi de garitas (debe tener visibilidad TCP hacia la IP del servidor en el puerto 8000 u 80).
  2. IP Fija / DHCP Reserva: Se recomienda asignar reserva DHCP a la tablet y registrar su nombre en la tabla wks de la base de datos (por ejemplo: TAB_GARITA_1).
  3. Instalación como PWA Standalone (Kiosco):
    • Abra Chrome o Samsung Internet y navegue a http://<IP_SERVIDOR>:8000/.
    • Toque los 3 puntos del menú y elija "Agregar a pantalla de inicio" (o "Instalar aplicación").
    • La aplicación quedará instalada como una app nativa, con ícono de garita, pantalla completa y soporte de orientación táctil.

4. Checklist de Verificación Pre-Vuelo (Testing Piloto)

Antes de entregar la tablet al guardia de seguridad en el puesto:

Ítem Prueba Criterio de Éxito
1. Conectividad Navegar a http://<IP>:8000/health Retorna {"status": "ok", "version": "0.6.0-beta"}
2. Login Iniciar sesión con usuario guardia Ingreso exitoso y emisión de cookie HttpOnly
3. WebSockets Observar indicador en cabecera Badge verde ● Online activo
4. Hardware Toque en "⚡ Abrir Barrera Entrada" Barrera física levanta y latencia < 100 ms
5. Escaneo DNI Escanear DNI con la cámara de la tablet Datos de documento, apellido y nombre completados
6. Híbrido Ingresar un auto desde la web y cerrar desde la PC El auto desaparece del listado en ambos sistemas

5. Plan de Contingencia Durante el Piloto

Si por cualquier motivo la tablet sufriera descarga de batería o pérdida de enlace Wi-Fi durante el turno:

  • El guardia puede sentarse en la PC habitual y abrir el sistema de escritorio existente (pct_view.py).
  • No se pierde ninguna información: todos los vehículos ingresados durante el turno continuarán visibles en el sistema de escritorio para darles salida con normalidad.