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
+30
View File
@@ -2,6 +2,36 @@
Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.
## [v0.5.0-beta] - 2026-10-13 (Fases 2 a 5: Core de Accesos, Cockpit Táctil Web, Hardware, Escaneo Óptico y QA)
### Agregado
- **Fase 2: Backend Core y Control de Accesos:**
- Repositorio y Servicio de Accesos transaccional atómico (`tck`, `tckprx`, `tckper`, `tckhst`, `mvthist`).
- Generador matemático de `TicketID` canónico compatible con OnEverAccess.
- Validación de antipassback para impedir ingresos duplicados activos en el predio.
- Soporte de compatibilidad legacy VB6 para contraseñas de operadores (`usr`, `usrlogin`).
- Emisión de cookies HttpOnly con JWT para autenticación segura en red local.
- Parser de DNI argentino multiformato (2009, 2012, 2026 y App Mi Argentina).
- Endpoints REST `/api/v1/access/entry`, `/api/v1/access/exit`, `/api/v1/access/tickets/active`, `/api/v1/access/people/search`, `/api/v1/access/lots/search` y `/api/v1/access/parse-dni`.
- **Fase 3: Desarrollo del Frontend Web (Cockpit Garita):**
- Aplicación SPA Touch-First (React + TypeScript + Vite) con tiempo de carga inferior a 100ms y consumo de RAM < 35MB en tablets Samsung Galaxy Tab A9 y A11 (4GB RAM).
- `AuthContext` con soporte de persistencia de sesión y resolución de estación (`CFT-DESK`).
- Vista `LoginView` con selector táctil de workstation y retroalimentación de errores.
- Vista de garita `ControlPostView` con layout de doble columna (Ingreso Rápido a la izquierda, Predio y Egresos a la derecha).
- Búsqueda predictiva con autocompletado en tiempo real para Lotes y Destinos.
- Steppers táctiles de 48px para control de ocupantes y menores sin teclado virtual.
- **Fase 4: Hardware y Escaneo Óptico en Tiempo Real:**
- Servicio de hardware `HardwareService` con generación de tramas ST1660 (`STX + Addr + Payload + CS + EOF`) y encolado en tabla `pdtmdl` para despacho por `OnEverWPC`.
- Componente modal `CameraScannerModal` con `BarcodeDetector` nativo (PDF417, QR) y fallback manual, con liberación inmediata de hardware (`MediaStreamTrack.stop()`) para evitar fugas de memoria en tablet.
- Servidor y cliente WebSocket en `/ws/station/{station_name}` con reconexión automática y heartbeat ping/pong para eventos en tiempo real (`ticket_created`, `ticket_closed`, `barrier_opened`).
- Acciones de apertura manual de emergencia para módulos de carril con auditoría registrada.
- **Fase 5: Pruebas Integrales, QA y Stress Testing:**
- Suite integral con 26 pruebas automáticas de pytest aprobadas (100% éxito).
- Pruebas de estrés y latencia (`tests/test_stress_performance.py`) que demuestran latencia de encolado de hardware de ~72ms (ampliamente inferior a la meta de 100ms).
- Validación de concurrencia sobre pool de conexiones SQL Server.
- Build estático de producción Vite validado (< 55 KB gzip total).
- Actualización sincronizada de versión `0.5.0-beta` en backend y frontend para subida al repositorio Gitea.
## [v0.1.0-alpha] - 2026-10-13 (Fase 1: Arquitectura y Base del Proyecto)
### Agregado