# 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`:** ```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):** ```powershell cd frontend npm install npm run build ``` 3. **Ejecutar como Servicio de Windows (Permanente y Autoiniciable):** Ejecute como Administrador: ```cmd 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:** ```cmd 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: ```bash 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: ```bash 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://: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://: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.