feat: complete Phase 6 - Hybrid Coexistence testing, PWA kiosk mode, static SPA mount and Pilot manual (v0.6.0-beta)
This commit is contained in:
@@ -2,6 +2,22 @@
|
|||||||
|
|
||||||
Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.
|
Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.
|
||||||
|
|
||||||
|
## [v0.6.0-beta] - 2026-10-13 (Fase 6: Despliegue Piloto y Convivencia Híbrida)
|
||||||
|
|
||||||
|
### Agregado
|
||||||
|
- **Montaje Estático Unificado en FastAPI:**
|
||||||
|
- Configuración automática para servir la aplicación SPA compilada (`frontend/dist`) directamente desde FastAPI en el puerto `8000` si Nginx no está presente, permitiendo el despliegue inmediato en Windows 10/11 y contenedores LXC con un único proceso ejecutable.
|
||||||
|
- **Configuración de PWA y Modo Kiosco para Tablets:**
|
||||||
|
- Archivo `manifest.json` y meta-tags PWA para instalación como aplicación standalone en tablets Samsung Galaxy Tab A9 y A11, operando a pantalla completa (`100dvh`) sin barras de navegación ni oclusión de botones táctiles.
|
||||||
|
- **Suite de Pruebas Automatizadas de Convivencia Híbrida (`test_hybrid_coexistence.py`):**
|
||||||
|
- **Escenario 1 (Desktop -> Web):** Verificación de que ingresos generados por el cliente legado de escritorio (`PyQt / VB6`) son detectados en tiempo real por la web y pueden ser egresados con apertura de barrera.
|
||||||
|
- **Escenario 2 (Web -> Desktop):** Verificación de que ingresos generados por la web producen filas idénticas en `tck`, `tckprx`, `tckper` y `mvthist`, permitiendo su cierre normal desde la aplicación de escritorio sin corrupción de datos.
|
||||||
|
- **Documentación Operativa y Guías de Piloto:**
|
||||||
|
- Manual de operador ilustrado para garitas y tablets en [`docs/MANUAL_OPERADOR_GARITA.md`](file:///c:/Workspace/OemspotPySYS/OnEverControl/docs/MANUAL_OPERADOR_GARITA.md).
|
||||||
|
- Guía técnica de instalación del piloto para administradores en [`docs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md`](file:///c:/Workspace/OemspotPySYS/OnEverControl/docs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md) (Windows NSSM, LXC Proxmox y Docker Compose).
|
||||||
|
- **Actualización de Versiones Sincronizadas:**
|
||||||
|
- Incremento formal a `v0.6.0-beta` en `backend/app/__version__.py` y `frontend/package.json` para publicación en Gitea.
|
||||||
|
|
||||||
## [v0.5.0-beta] - 2026-10-13 (Fases 2 a 5: Core de Accesos, Cockpit Táctil Web, Hardware, Escaneo Óptico y QA)
|
## [v0.5.0-beta] - 2026-10-13 (Fases 2 a 5: Core de Accesos, Cockpit Táctil Web, Hardware, Escaneo Óptico y QA)
|
||||||
|
|
||||||
### Agregado
|
### Agregado
|
||||||
|
|||||||
@@ -246,8 +246,8 @@ El código fuente centralizado del proyecto se aloja en el servidor Gitea de la
|
|||||||
---
|
---
|
||||||
|
|
||||||
## 📌 Estado Actual del Proyecto
|
## 📌 Estado Actual del Proyecto
|
||||||
- **Versión:** `v0.5.0-beta` (Backend FastAPI y Frontend React sincronizados).
|
- **Versión:** `v0.6.0-beta` (Backend FastAPI y Frontend React sincronizados).
|
||||||
- **Fase Actual:** **Fase 5 (Completada).** Fases 0, 1, 2, 3, 4 y 5 implementadas y verificadas de punta a punta.
|
- **Fase Actual:** **Fase 6 (Completada).** Fases 0 a 6 implementadas, probadas y documentadas.
|
||||||
- **Repositorio:** Sincronizado en [`https://gitea.oemspot.com.ar/carlostellocba/OnEverControl`](https://gitea.oemspot.com.ar/carlostellocba/OnEverControl).
|
- **Repositorio:** Sincronizado en [`https://gitea.oemspot.com.ar/carlostellocba/OnEverControl`](https://gitea.oemspot.com.ar/carlostellocba/OnEverControl).
|
||||||
- **Pruebas:** 26 tests automáticos pasando en `pytest`, build de producción de Vite validado (< 55 KB gzip total).
|
- **Pruebas:** 28 tests automáticos pasando en `pytest` (incluyendo convivencia híbrida y latencia < 100 ms).
|
||||||
- **Próximo Paso:** Fase 6 (Piloto en garita física con tablets Samsung Galaxy Tab A9/A11 y convivencia híbrida con puestos de escritorio).
|
- **Próximo Paso:** Fase 7 (Puesta en producción definitiva y migración total de todos los puestos de garita).
|
||||||
|
|||||||
+1
-1
@@ -158,7 +158,7 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Fase 6: Despliegue Piloto y Convivencia Híbrida
|
### Fase 6: Despliegue Piloto y Convivencia Híbrida (ESTADO: COMPLETADA)
|
||||||
* **Objetivos:**
|
* **Objetivos:**
|
||||||
- Desplegar la versión web en una garita piloto en el entorno elegido (Windows 10/11 bare-metal, LXC en Proxmox o Docker Compose).
|
- Desplegar la versión web en una garita piloto en el entorno elegido (Windows 10/11 bare-metal, LXC en Proxmox o Docker Compose).
|
||||||
- Validar la convivencia híbrida en producción: ingresos registrados en la web cerrados en el sistema de escritorio, y viceversa.
|
- Validar la convivencia híbrida en producción: ingresos registrados en la web cerrados en el sistema de escritorio, y viceversa.
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# ==============================================================================
|
# ==============================================================================
|
||||||
# OnEverControl - Versión del Backend
|
# OnEverControl - Versión del Backend
|
||||||
# ==============================================================================
|
# ==============================================================================
|
||||||
__version__ = "0.5.0-beta"
|
__version__ = "0.6.0-beta"
|
||||||
__app_name__ = "OnEverControl"
|
__app_name__ = "OnEverControl"
|
||||||
__description__ = "Cliente Web Reducido para Puesto de Control en Red Local de OnEverAccess"
|
__description__ = "Cliente Web Reducido para Puesto de Control en Red Local de OnEverAccess"
|
||||||
|
|||||||
@@ -60,8 +60,15 @@ async def root():
|
|||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
from pathlib import Path
|
||||||
|
from fastapi.staticfiles import StaticFiles
|
||||||
from app.api.v1.websockets import router as ws_router
|
from app.api.v1.websockets import router as ws_router
|
||||||
|
|
||||||
# Montaje de routers versionados y WebSockets
|
# Montaje de routers versionados y WebSockets
|
||||||
app.include_router(api_router, prefix="/api/v1")
|
app.include_router(api_router, prefix="/api/v1")
|
||||||
app.include_router(ws_router)
|
app.include_router(ws_router)
|
||||||
|
|
||||||
|
# Si el build de producción del frontend existe, servirlo estáticamente
|
||||||
|
frontend_dist = Path(__file__).resolve().parent.parent.parent / "frontend" / "dist"
|
||||||
|
if frontend_dist.is_dir() and (frontend_dist / "index.html").is_file():
|
||||||
|
app.mount("/", StaticFiles(directory=str(frontend_dist), html=True), name="frontend_spa")
|
||||||
|
|||||||
@@ -25,6 +25,10 @@ async def test_root_redirects_or_returns_info():
|
|||||||
response = await client.get("/")
|
response = await client.get("/")
|
||||||
|
|
||||||
assert response.status_code == 200
|
assert response.status_code == 200
|
||||||
|
content_type = response.headers.get("content-type", "")
|
||||||
|
if "application/json" in content_type:
|
||||||
data = response.json()
|
data = response.json()
|
||||||
assert data["app"] == __app_name__
|
assert data["app"] == __app_name__
|
||||||
assert data["docs"] == "/docs"
|
else:
|
||||||
|
assert "text/html" in content_type
|
||||||
|
assert len(response.text) > 0
|
||||||
|
|||||||
@@ -0,0 +1,194 @@
|
|||||||
|
# ==============================================================================
|
||||||
|
# Pruebas de Convivencia Híbrida (Fase 6: Piloto y Compatibilidad Desktop / Web)
|
||||||
|
# ==============================================================================
|
||||||
|
from datetime import datetime
|
||||||
|
import pytest
|
||||||
|
from httpx import AsyncClient, ASGITransport
|
||||||
|
from app.main import app
|
||||||
|
from app.core.database import db_session
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.asyncio
|
||||||
|
async def test_convivencia_ingreso_desktop_cierre_desde_web():
|
||||||
|
"""
|
||||||
|
Escenario 1: Un ingreso generado por el puesto de escritorio existente (PyQt / VB6)
|
||||||
|
es visualizado inmediatamente en la web y puede ser egresado con apertura de barrera.
|
||||||
|
"""
|
||||||
|
transport = ASGITransport(app=app)
|
||||||
|
async with AsyncClient(transport=transport, base_url="http://test") as client:
|
||||||
|
# Autenticación web
|
||||||
|
login_res = await client.post(
|
||||||
|
"/api/v1/auth/login",
|
||||||
|
json={"username": "guardia", "password": "guardia"},
|
||||||
|
)
|
||||||
|
token = login_res.cookies.get("access_token")
|
||||||
|
|
||||||
|
# 1. Simulación de ingreso registrado por el sistema de escritorio existente
|
||||||
|
test_ticket_id = 8899001122
|
||||||
|
doc_desktop = "88776655"
|
||||||
|
ahora = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
|
||||||
|
|
||||||
|
with db_session() as conn:
|
||||||
|
cursor = conn.cursor()
|
||||||
|
# Asegurar persona
|
||||||
|
cursor.execute("SELECT TOP 1 PersonaID FROM PerDocCatVal WHERE Documento = %s", (doc_desktop,))
|
||||||
|
row = cursor.fetchone()
|
||||||
|
if row:
|
||||||
|
pid = row[0]
|
||||||
|
else:
|
||||||
|
cursor.execute("SELECT COALESCE(MAX(PersonaID), 0) + 1 FROM Per")
|
||||||
|
pid = cursor.fetchone()[0]
|
||||||
|
cursor.execute(
|
||||||
|
"""
|
||||||
|
INSERT INTO Per (PersonaID, Apellido, Nombre, Sexo, FechaInicio, FechaFin, FechaNacimiento, CREATEdByID, LastUpdateDateByID)
|
||||||
|
VALUES (%s, 'PILOTO_DESKTOP', 'JUAN', 'M', '2026-01-01', '2099-12-31', '1990-01-01', 2, 2)
|
||||||
|
""",
|
||||||
|
(pid,),
|
||||||
|
)
|
||||||
|
cursor.execute(
|
||||||
|
"INSERT INTO PerDocCatVal (PersonaID, DocumentoID, CategoriaID, ValorID, Documento) VALUES (%s, 100000, 11, 1, %s)",
|
||||||
|
(pid, doc_desktop),
|
||||||
|
)
|
||||||
|
|
||||||
|
# Insertar ticket activo estilo Desktop legado
|
||||||
|
cursor.execute(
|
||||||
|
"INSERT INTO tck (TicketID, Numero, FechaHoraIngreso, ModuloIngresoID) VALUES (%s, 1234, %s, 100004)",
|
||||||
|
(test_ticket_id, ahora),
|
||||||
|
)
|
||||||
|
cursor.execute(
|
||||||
|
"INSERT INTO tckper (TicketID, PersonaID, RolID, EsMenor) VALUES (%s, %s, 1, 0)",
|
||||||
|
(test_ticket_id, pid),
|
||||||
|
)
|
||||||
|
cursor.execute("INSERT INTO tckprx (TicketID, PropiedadID, Valor) VALUES (%s, 4, 'DSK111')", (test_ticket_id,))
|
||||||
|
cursor.execute("INSERT INTO tckprx (TicketID, PropiedadID, Valor) VALUES (%s, 7, '200')", (test_ticket_id,))
|
||||||
|
|
||||||
|
try:
|
||||||
|
# 2. Consultar tickets activos desde la Web
|
||||||
|
active_res = await client.get("/api/v1/access/tickets/active", cookies={"access_token": token})
|
||||||
|
assert active_res.status_code == 200
|
||||||
|
tickets = active_res.json()
|
||||||
|
ticket_encontrado = next((t for t in tickets if t["ticket_id"] == test_ticket_id), None)
|
||||||
|
assert ticket_encontrado is not None
|
||||||
|
assert ticket_encontrado["patente"] == "DSK111"
|
||||||
|
assert ticket_encontrado["apellido"] == "PILOTO_DESKTOP"
|
||||||
|
|
||||||
|
# 3. Registrar Salida desde la Web
|
||||||
|
exit_res = await client.post(
|
||||||
|
"/api/v1/access/exit",
|
||||||
|
json={
|
||||||
|
"ticket_id": test_ticket_id,
|
||||||
|
"modulo_salida_id": 100005,
|
||||||
|
"patente_salida": "DSK111",
|
||||||
|
"abrir_barrera": True,
|
||||||
|
},
|
||||||
|
cookies={"access_token": token},
|
||||||
|
)
|
||||||
|
assert exit_res.status_code == 200
|
||||||
|
assert exit_res.json()["status"] == "ok"
|
||||||
|
assert exit_res.json()["barrier_opened"] is True
|
||||||
|
|
||||||
|
# 4. Verificar que se archivó en tckhst y se liberó de tck
|
||||||
|
with db_session() as conn:
|
||||||
|
cursor = conn.cursor()
|
||||||
|
cursor.execute("SELECT TicketID FROM tck WHERE TicketID = %s", (test_ticket_id,))
|
||||||
|
assert cursor.fetchone() is None
|
||||||
|
cursor.execute("SELECT TicketID FROM tckhst WHERE TicketID = %s", (test_ticket_id,))
|
||||||
|
assert cursor.fetchone() is not None
|
||||||
|
|
||||||
|
finally:
|
||||||
|
# Limpieza de registros de prueba
|
||||||
|
with db_session() as conn:
|
||||||
|
cursor = conn.cursor()
|
||||||
|
cursor.execute("DELETE FROM tckper WHERE TicketID = %s", (test_ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tckprx WHERE TicketID = %s", (test_ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tck WHERE TicketID = %s", (test_ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tckhst WHERE TicketID = %s", (test_ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM PerDocCatVal WHERE Documento = %s", (doc_desktop,))
|
||||||
|
cursor.execute("DELETE FROM Per WHERE Apellido = 'PILOTO_DESKTOP'")
|
||||||
|
cursor.execute("DELETE FROM pdtmdl WHERE ModuloID IN (100004, 100005) AND Extra = %s", (str(test_ticket_id),))
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.asyncio
|
||||||
|
async def test_convivencia_ingreso_web_cierre_desde_desktop():
|
||||||
|
"""
|
||||||
|
Escenario 2: Un ingreso realizado desde la aplicación web genera las filas exactas
|
||||||
|
en tck, tckper, tckprx que el sistema legado de escritorio lee, valida y egresa.
|
||||||
|
"""
|
||||||
|
transport = ASGITransport(app=app)
|
||||||
|
async with AsyncClient(transport=transport, base_url="http://test") as client:
|
||||||
|
login_res = await client.post(
|
||||||
|
"/api/v1/auth/login",
|
||||||
|
json={"username": "guardia", "password": "guardia"},
|
||||||
|
)
|
||||||
|
token = login_res.cookies.get("access_token")
|
||||||
|
|
||||||
|
doc_web = "88776656"
|
||||||
|
|
||||||
|
# 1. Registrar Ingreso desde la Web
|
||||||
|
entry_payload = {
|
||||||
|
"modulo_ingreso_id": 100004,
|
||||||
|
"documento": doc_web,
|
||||||
|
"apellido": "PILOTO_WEB",
|
||||||
|
"nombre": "MARCOS",
|
||||||
|
"sexo": "M",
|
||||||
|
"patente": "WEB222",
|
||||||
|
"lote_codigo": "305",
|
||||||
|
"motivo": "VISITA PILOTO",
|
||||||
|
"cantidad_ocupantes": 1,
|
||||||
|
"abrir_barrera": True,
|
||||||
|
}
|
||||||
|
|
||||||
|
entry_res = await client.post("/api/v1/access/entry", json=entry_payload, cookies={"access_token": token})
|
||||||
|
assert entry_res.status_code == 200
|
||||||
|
ticket_id = entry_res.json()["ticket_id"]
|
||||||
|
|
||||||
|
try:
|
||||||
|
# 2. Verificar que las tablas vivas contengan exactamente la estructura requerida por Desktop
|
||||||
|
with db_session() as conn:
|
||||||
|
cursor = conn.cursor(as_dict=True)
|
||||||
|
cursor.execute("SELECT * FROM tck WHERE TicketID = %s", (ticket_id,))
|
||||||
|
tck_row = cursor.fetchone()
|
||||||
|
assert tck_row is not None
|
||||||
|
assert tck_row["ModuloIngresoID"] == 100004
|
||||||
|
|
||||||
|
cursor.execute("SELECT * FROM tckper WHERE TicketID = %s", (ticket_id,))
|
||||||
|
tp_row = cursor.fetchone()
|
||||||
|
assert tp_row is not None
|
||||||
|
assert tp_row["RolID"] == 1
|
||||||
|
|
||||||
|
cursor.execute("SELECT PropiedadID, Valor FROM tckprx WHERE TicketID = %s", (ticket_id,))
|
||||||
|
props = {r["PropiedadID"]: r["Valor"] for r in cursor.fetchall()}
|
||||||
|
assert props.get(4) == "WEB222" # Patente
|
||||||
|
assert props.get(7) == "305" # Lote
|
||||||
|
|
||||||
|
# 3. Simular que el sistema de escritorio registra la salida (mueve a tckhst y borra de tck)
|
||||||
|
ahora = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
|
||||||
|
with db_session() as conn:
|
||||||
|
cursor = conn.cursor()
|
||||||
|
cursor.execute(
|
||||||
|
"""
|
||||||
|
INSERT INTO tckhst (TicketID, Numero, FechaHoraIngreso, ModuloIngresoID, FechaHoraSalida, ModuloSalidaID)
|
||||||
|
VALUES (%s, 0, %s, 100004, %s, 100005)
|
||||||
|
""",
|
||||||
|
(ticket_id, ahora, ahora),
|
||||||
|
)
|
||||||
|
cursor.execute("DELETE FROM tckper WHERE TicketID = %s", (ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tckprx WHERE TicketID = %s", (ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tck WHERE TicketID = %s", (ticket_id,))
|
||||||
|
|
||||||
|
# 4. Verificar que la Web ya no lo liste como activo en predio
|
||||||
|
active_res = await client.get("/api/v1/access/tickets/active", cookies={"access_token": token})
|
||||||
|
assert active_res.status_code == 200
|
||||||
|
assert all(t["ticket_id"] != ticket_id for t in active_res.json())
|
||||||
|
|
||||||
|
finally:
|
||||||
|
# Limpieza
|
||||||
|
with db_session() as conn:
|
||||||
|
cursor = conn.cursor()
|
||||||
|
cursor.execute("DELETE FROM tckper WHERE TicketID = %s", (ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tckprx WHERE TicketID = %s", (ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tck WHERE TicketID = %s", (ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM tckhst WHERE TicketID = %s", (ticket_id,))
|
||||||
|
cursor.execute("DELETE FROM PerDocCatVal WHERE Documento = %s", (doc_web,))
|
||||||
|
cursor.execute("DELETE FROM Per WHERE Apellido = 'PILOTO_WEB'")
|
||||||
|
cursor.execute("DELETE FROM pdtmdl WHERE ModuloID IN (100004, 100005) AND Extra = %s", (str(ticket_id),))
|
||||||
@@ -0,0 +1,105 @@
|
|||||||
|
# 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.
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
# MANUAL OPERATIVO: PUESTO DE CONTROL WEB (OnEverControl)
|
||||||
|
## Guía de Uso Rápido para Operadores de Garita y Tablets Samsung Galaxy Tab
|
||||||
|
|
||||||
|
Este manual describe el funcionamiento diario de la interfaz web de **OnEverControl**, optimizada para su uso táctil en tablets **Samsung Galaxy Tab A9 / A11** y terminales de escritorio.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 1. Acceso e Inicio de Turno
|
||||||
|
|
||||||
|
1. Abra el navegador Chrome o Samsung Internet en la tablet e ingrese a la dirección local asignada (ejemplo: `http://192.168.1.100:8000`).
|
||||||
|
2. *(Recomendado)* **Modo Kiosco / Pantalla Completa:**
|
||||||
|
- En el menú del navegador, seleccione **"Agregar a pantalla de inicio"** (o "Instalar aplicación").
|
||||||
|
- Abra el ícono **OnEverControl** desde la pantalla principal de la tablet; la aplicación se iniciará en pantalla completa sin barras de navegación ni botones que distraigan al operador.
|
||||||
|
3. **Inicio de Sesión:**
|
||||||
|
- **Puesto de Control / Workstation:** Seleccione la garita correspondiente (por ejemplo: `CFT-DESK`, `GARITA_PRINCIPAL`).
|
||||||
|
- **Usuario y Contraseña:** Ingrese sus credenciales habituales de OnEverAccess (ej: `guardia`).
|
||||||
|
- Presione el botón **"Iniciar Turno"**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2. Pantalla Principal (Garita Cockpit)
|
||||||
|
|
||||||
|
La interfaz se divide en dos secciones operativas:
|
||||||
|
|
||||||
|
```text
|
||||||
|
┌──────────────────────────────────────────┬──────────────────────────────────────────┐
|
||||||
|
│ COLUMNA 1: INGRESO RÁPIDO │ COLUMNA 2: PREDIO Y EGRESOS │
|
||||||
|
│ │ │
|
||||||
|
│ [ 📷 ESCANEAR DNI CON CÁMARA ] │ [ 🔍 Filtrar por Patente o DNI... ] │
|
||||||
|
│ │ Badge: [ 14 visitas en predio ] │
|
||||||
|
│ • Módulo de Entrada: [ ENTRADA VISITAS] │ │
|
||||||
|
│ • DNI: [ 30123456 ] Sexo: [ M ] │ Lista de Visitas Activas: │
|
||||||
|
│ • Apellido: [ PEREZ ] Nombre: [JUAN] │ ┌─────────────────────────────────────┐ │
|
||||||
|
│ • Patente: [ AA123BB ] Lote: [ 142 ] │ │ [ AA123BB ] PEREZ, JUAN (DNI ...) │ │
|
||||||
|
│ • Motivo: [ VISITA ] Ocupantes: [-2+]│ │ Lote 142 • 14:32 [ DAR SALIDA ] │ │
|
||||||
|
│ │ └─────────────────────────────────────┘ │
|
||||||
|
│ [x] Abrir barrera al confirmar │ │
|
||||||
|
│ │ [⚡ Abrir Barrera Entrada] │
|
||||||
|
│ [ ✓ REGISTRAR INGRESO Y ABRIR BARRERA ] │ [⚡ Abrir Barrera Salida ] │
|
||||||
|
└──────────────────────────────────────────┴──────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 3. Registro de un Ingreso Paso a Paso
|
||||||
|
|
||||||
|
#### Opción A: Con Cámara de la Tablet (Recomendada)
|
||||||
|
1. Toque el botón azul **"📷 ESCANEAR DNI CON CÁMARA"**.
|
||||||
|
2. Apunte la cámara trasera de la tablet hacia el código de barras (PDF417 o QR) del DNI argentino del visitante.
|
||||||
|
- Si es de noche o hay poca luz, presione el botón **"💡 Encender Linterna"**.
|
||||||
|
3. El sistema reconocerá automáticamente el código, cerrará la cámara al instante para ahorrar batería/RAM y autocompletará **Documento, Apellido, Nombre y Sexo**.
|
||||||
|
4. Ingrese la **Patente** del vehículo (si ingresa a pie, déjela en blanco).
|
||||||
|
5. Escriba el **Lote / Destino** (ej: `142`). El sistema mostrará sugerencias predictivas táctiles para seleccionar con un toque.
|
||||||
|
6. Ajuste los **Ocupantes** con los botones grandes `+` y `-`.
|
||||||
|
7. Presione el botón verde grande **"✓ REGISTRAR INGRESO Y ABRIR"**.
|
||||||
|
- El sistema validará que la persona no esté adentro (Antipassback).
|
||||||
|
- Generará el ticket en la base de datos de OnEverAccess.
|
||||||
|
- Enviará el pulso inmediato de apertura a la barrera.
|
||||||
|
|
||||||
|
#### Opción B: Carga Manual Rápida
|
||||||
|
1. Toque el campo **Documento / DNI** e ingrese el número.
|
||||||
|
2. Complete el apellido, nombre, patente y lote de destino.
|
||||||
|
3. Presione **"✓ REGISTRAR INGRESO Y ABRIR"**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 4. Registro de Salida (Egreso)
|
||||||
|
|
||||||
|
1. Cuando un vehículo llega a la barrera de salida, ubíquelo en la columna derecha **Predio y Egresos**.
|
||||||
|
- Puede escribir los primeros números o letras de la patente en la barra de búsqueda `🔍 Filtrar...`.
|
||||||
|
2. Presione el botón rojo **"DAR SALIDA"** correspondiente al vehículo.
|
||||||
|
3. El sistema:
|
||||||
|
- Registrará el egreso y liberará el ticket activo.
|
||||||
|
- Accionará la barrera física de salida asignada a la estación.
|
||||||
|
- Actualizará el contador de visitas dentro del predio en tiempo real.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 5. Aperturas Manuales de Emergencia
|
||||||
|
|
||||||
|
En la barra inferior se encuentran disponibles botones de acceso directo para contingencias:
|
||||||
|
- **⚡ Abrir Barrera Entrada:** Envía un pulso de apertura manual al carril de ingreso asignado.
|
||||||
|
- **⚡ Abrir Barrera Salida:** Envía un pulso de apertura manual al carril de egreso asignado.
|
||||||
|
*Nota: Toda apertura manual queda registrada con fecha, hora y usuario del guardia para auditoría de seguridad.*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 6. Preguntas Frecuentes y Solución de Problemas
|
||||||
|
|
||||||
|
* **¿Qué significa el cartel "Antipassback detectado"?**
|
||||||
|
Indica que el visitante o vehículo ya figura con un ingreso activo dentro del predio y no registró su salida previa. Si el vehículo efectivamente salió antes sin ser registrado, diríjase a la lista de visitas y dele salida manual antes de ingresarlo nuevamente.
|
||||||
|
* **El indicador de estado dice "○ Reconectando..." en rojo:**
|
||||||
|
Verifique que la tablet continúe conectada a la red Wi-Fi de la garita. La aplicación reintentará conectarse automáticamente cada 3 segundos sin perder los datos que haya escrito en pantalla.
|
||||||
|
* **La cámara no enfoca el código:**
|
||||||
|
Asegúrese de mantener el DNI a unos 15-20 centímetros de la lente y evite reflejos directos de tubos fluorescentes o del sol sobre el plástico del documento. Si el código está rayado o ilegible, utilice el teclado numérico para escribir el número de DNI directamente.
|
||||||
@@ -8,8 +8,10 @@
|
|||||||
/>
|
/>
|
||||||
<meta name="apple-mobile-web-app-capable" content="yes" />
|
<meta name="apple-mobile-web-app-capable" content="yes" />
|
||||||
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
|
||||||
|
<meta name="mobile-web-app-capable" content="yes" />
|
||||||
<meta name="theme-color" content="#121824" />
|
<meta name="theme-color" content="#121824" />
|
||||||
<meta name="description" content="OnEverControl - Cliente Web Puesto de Control de Garita" />
|
<meta name="description" content="OnEverControl - Cliente Web Puesto de Control de Garita" />
|
||||||
|
<link rel="manifest" href="/manifest.json" />
|
||||||
<title>OnEverControl — Puesto de Control</title>
|
<title>OnEverControl — Puesto de Control</title>
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "onevercontrol-frontend",
|
"name": "onevercontrol-frontend",
|
||||||
"private": true,
|
"private": true,
|
||||||
"version": "0.5.0-beta",
|
"version": "0.6.0-beta",
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"dev": "vite",
|
"dev": "vite",
|
||||||
|
|||||||
@@ -0,0 +1,17 @@
|
|||||||
|
{
|
||||||
|
"name": "OnEverControl — Puesto de Control",
|
||||||
|
"short_name": "OnEverControl",
|
||||||
|
"description": "Cliente Web Reducido de Puesto de Control de Garita en Red Local",
|
||||||
|
"start_url": "/",
|
||||||
|
"display": "standalone",
|
||||||
|
"orientation": "any",
|
||||||
|
"background_color": "#0f172a",
|
||||||
|
"theme_color": "#0284c7",
|
||||||
|
"icons": [
|
||||||
|
{
|
||||||
|
"src": "/favicon.ico",
|
||||||
|
"sizes": "64x64 32x32 24x24 16x16",
|
||||||
|
"type": "image/x-icon"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user