4.9 KiB
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 localOnEverWPChacia 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)
- Configurar el archivo
.env:DB_SERVER=localhost\SQLEXPRESS DB_NAME=videoman DB_USER=sa DB_PASSWORD=SuPassword SERVER_PORT=8000 - Construir el Frontend (si hubo cambios de código):
cd frontend npm install npm run build - Ejecutar como Servicio de Windows (Permanente y Autoiniciable):
Ejecute como Administrador:
El servicio iniciará automáticamente con el sistema operativo y reiniciará ante cualquier fallo.
scripts\windows\install_service.bat - 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):
- Cree un contenedor LXC Debian 12 en Proxmox con 1 vCPU, 512 MB de RAM y 4 GB de disco.
- Copie la carpeta
OnEverControl/al contenedor. - Ejecute el script automatizado de aprovisionamiento:
chmod +x scripts/lxc/setup_lxc.sh sudo ./scripts/lxc/setup_lxc.sh - El script configurará las dependencias de FreeTDS, creará el entorno virtual Python y registrará el servicio
systemdonevercontrol.servicecon reinicio automático.
Opción C: Docker Compose con Nginx Reverse Proxy
- Verifique que Docker y Docker Compose estén instalados en el host.
- Levante el stack productivo:
docker compose up -d - 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)
- 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).
- IP Fija / DHCP Reserva: Se recomienda asignar reserva DHCP a la tablet y registrar su nombre en la tabla
wksde la base de datos (por ejemplo:TAB_GARITA_1). - 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.
- Abra Chrome o Samsung Internet y navegue a
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.