Files
OnEverControl/docs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md
T

106 lines
4.9 KiB
Markdown

# 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://<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.