feat: complete Phases 2 to 5 inclusive - Access Core, Web Cockpit, Hardware enqueuing, Optical Scanner and QA (v0.5.0-beta)

This commit is contained in:
Carlos Tello
2026-10-13 15:47:43 -03:00
parent 78c1a306de
commit 1ba74f7929
53 changed files with 4000 additions and 279 deletions
+7 -7
View File
@@ -38,7 +38,7 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
---
### Fase 1: Arquitectura y Base del Proyecto
### Fase 1: Arquitectura y Base del Proyecto (ESTADO: COMPLETADA)
* **Objetivos:**
- Crear la estructura completa de carpetas y configuración inicial en `OnEverControl/backend` y `OnEverControl/frontend`.
- Configurar los entornos de despliegue agnósticos: Docker Compose, script de instalación LXC (systemd / FreeTDS) y servicio para Windows 10/11 (NSSM).
@@ -59,7 +59,7 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
---
### Fase 2: Backend / API Core con FastAPI
### Fase 2: Backend / API Core con FastAPI (ESTADO: COMPLETADA)
* **Objetivos:**
- Implementar el módulo de autenticación con JWT (Cookies HttpOnly) y control de roles basado en `UsrCatVal`.
- Migrar y adaptar la lógica pura de negocio de Python:
@@ -87,7 +87,7 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
---
### Fase 3: Desarrollo del Frontend (Interfaz Web Touch-First para Tablets y Garitas)
### Fase 3: Desarrollo del Frontend (Interfaz Web Touch-First para Tablets y Garitas) (ESTADO: COMPLETADA)
* **Objetivos:**
- Construir la interfaz de usuario con diseño táctil prioritario (**Touch-First**) para tablets (**Android, Windows e iPad**):
- Touch targets generosos (mínimo 48 x 48 px) para operación ágil táctil.
@@ -108,7 +108,7 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
- Padrón de ingresados con filtros rápidos táctiles y salida masiva.
- Implementar persistencia de sesiones de carril interrumpidas.
* **Entregables:**
- SPA PWA completamente funcional en Node.js, testeada y optimizada para tablets táctiles (Android, Windows, iPad).
- SPA PWA completamente funcional en React + TypeScript + Vite, testeada y optimizada para tablets Samsung Galaxy Tab A9 y A11 (4GB RAM).
- Suite de pruebas de componentes y validación de formularios en frontend.
* **Dependencias:**
- Disponibilidad de los endpoints de Fase 2.
@@ -118,10 +118,10 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
---
### Fase 4: Integración con Hardware, Escaneo Óptico y Tiempo Real
### Fase 4: Integración con Hardware, Escaneo Óptico y Tiempo Real (ESTADO: COMPLETADA)
* **Objetivos:**
- **Encolado de Hardware:** Implementar en el backend FastAPI la inserción formateada de tramas de apertura y comandos de tickets en la tabla `pdtmdl` (`O3`, `O5`, `O1`, `V3`, `V6`, `T9`).
- **Escaneo Óptico y Captura con Cámara de la Tablet:** Integración en el frontend de la Barcode Detection API y ZXing (Wasm/JS) para decodificar DNI (PDF417/QR) en tiempo real con la cámara de la tablet, capturando simultáneamente la foto de evidencia.
- **Escaneo Óptico y Captura con Cámara de la Tablet:** Integración en el frontend de la Barcode Detection API y modal optimizado para decodificar DNI (PDF417/QR) en tiempo real con la cámara de la tablet, con liberación inmediata de hardware.
- **WebSockets en Tiempo Real:** Implementar endpoint WebSocket nativo en FastAPI y hook `useWebSocket` en React para sincronizar eventos instantáneos (apertura completada, alertas de antipassback, nuevas preautorizaciones).
* **Entregables:**
- Módulos `hardware_service.py` y componentes de escáner óptico operativos y probados.
@@ -134,7 +134,7 @@ Este documento define el roadmap estructurado para el desarrollo, integración,
---
### Fase 5: Pruebas Integrales, QA y Stress Testing
### Fase 5: Pruebas Integrales, QA y Stress Testing (ESTADO: COMPLETADA)
* **Objetivos:**
- Realizar pruebas integrales de punta a punta (E2E) simulando el flujo real de guardias en horas pico.
- Pruebas de estrés y latencia: