Files
OnEverControl/CHANGELOG.md
T

140 lines
14 KiB
Markdown

# Changelog — OnEverControl
Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.
## [v0.6.3-beta] - 2026-10-14 (Paridad de Validaciones de Puesto de Control, Pólizas de Seguro, ART y UX Tablet 9-11")
### Agregado y Corregido
- **Validaciones Estrictas de Formulario (Paridad 1:1 con `puestocontrol/pct_view.py:validar_formulario`):**
- **Documento Obligatorio:** Mínimo 4 caracteres alfanuméricos requeridos; rechazo con código 422 si está vacío o incompleto.
- **Nombre Obligatorio:** Campo requerido; rechazo con código 422 si falta el nombre del visitante o conductor.
- **Lote de Destino Obligatorio:** Campo obligatorio (`lote_id` o `lote_codigo`); validación de restricciones en tiempo real con Categoría 26 de `LotCatVal` (moroso / restringido / en obra). Modal interactivo de confirmación y anulación manual autorizada para operadores.
- **Selector Táctil de Modo Conductor vs Peatón:**
- Botonera segmentada de 48px de alto para tablets Samsung Galaxy Tab A9 / A11 (`🚗 Conductor` y `🚶 Peatón`).
- **Modo Conductor:** Patente obligatoria. Validación estricta de vigencia de póliza de Seguro Automotor (`ps_hasta`): bloqueo inmediato de acceso (403) si la cobertura está vencida, sin fecha o en 1900-01-01.
- **Modo Peatón:** Desactiva y omite la exigencia de vehículo/seguro automotor, preservando intactas las coberturas preexistentes en `perpolreg` y `Aut` sin sobrescribirlas.
- **Validación de Póliza ART / Accidentes Personales:**
- Para motivos de ingreso vinculados a trabajo (`TRABAJADOR`, `SERVICIO`, `PROVEEDOR`, `OBRA`), verificación y bloqueo (403) ante coberturas vencidas.
- **Carga Predictiva y Autocompletado Instantáneo:**
- Al escribir o escanear DNI: recuperación automática de titular, patentes registradas en `PerAut`, coberturas de seguro en `Aut`/`perpolreg`, ART, licencia y observaciones (`PerPrx`).
- Al tipear o seleccionar patente: consulta de póliza de seguro y titular en `Aut`, con botones de selección rápida táctil de patentes asociadas.
- **Diseño Táctil y Pólizas en Tablets de 9 a 11 Pulgadas (Samsung Tab A9 y A11):**
- Acordeón colapsable con badges de estado en tiempo real (Verde: Vigente, Rojo: Vencida, Naranja: Faltante).
- Botones táctiles de vencimiento rápido (+1 Mes, +6 Meses, +1 Año) para agilizar la carga en garita sin requerir teclado virtual.
- Targets táctiles $\ge 44-48\text{px}$ en todos los controles interactivos.
## [v0.6.1-beta] - 2026-10-13 (Carga Dinámica de Workstations y Movimientos Reales de SQL Server)
### Agregado y Corregido
- **Carga Dinámica de Estaciones de Trabajo (`wks`):**
- Eliminación de todas las opciones mock en `LoginView.tsx`.
- Integración del endpoint `/api/v1/control-posts/workstations` para poblar el dropdown de estaciones directamente desde la tabla `wks` de SQL Server (`CFT-DESK`, `REGATAS-R`).
- **Configuración de Módulos de Entrada y Salida (`wksmdl` + `mdl`):**
- Implementación de `/api/v1/control-posts/{workstation_name}/config` y `/api/v1/control-posts/workstation/{workstation_name}/config`.
- Detección precisa de sentido de carril (Entrada vs Salida) con base en nombres y flags en base de datos.
- **Pestaña de Historial de Movimientos Reales (`mvthist`):**
- Nuevo endpoint `/api/v1/access/movements/recent` para consultar las últimas transacciones registradas en SQL Server.
- Implementación en `ControlPostView.tsx` de selector de pestañas entre "🟢 En Predio (Activos)" y "📜 Historial Movimientos BD".
- **Adopción Total del Sistema de Diseño Oficial (`styles/design_system.py`):**
- Implementación en `tokens.css` y `base.css` de la paleta oficial OnEver: `--bg-main` (`#0F172A`), `--bg-sidebar` (`#020617`), `--input-bg` (`#1E293B`), `--blue-base` (`#2563EB`), `--blue-hover` (`#3B82F6`), `--success` (`#10B981`), `--danger` (`#EF4444`) y `--border` (`#374151`).
- Bordes redondeados estandarizados a `10px` en tarjetas, entradas, botones y selectores.
- Soporte de temas Claro/Oscuro dinámicos mediante hook `useTheme` y conmutador táctil `☀️ / 🌙`.
- Tipografía profesional `'Segoe UI', 'Roboto', sans-serif` con estilos de títulos, scrollbars modernas y badges de estado.
- **Acceso Robusto y Universal a Cámaras en Android y Windows:**
- Integración de biblioteca industrial `@zxing/library` para decodificación universal de códigos PDF417 de DNI tarjeta y QR digital en cualquier navegador.
- Fallback de captura fotográfica nativa (`capture="environment"`) que abre directamente la cámara de Samsung Galaxy / Windows sin requerir streaming continuo WebRTC ni HTTPS en red local.
- Fallback automático de restricciones de video (`{ video: true }`) para webcams de escritorio Windows que rechazan `facingMode: environment`.
- Despliegue dual de backend en HTTP (`:8000`) y HTTPS con certificado SSL (`:8443`) para habilitar Secure Context en tablets.
## [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)
### 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
- **Backend FastAPI:**
- Configuración tipada con Pydantic Settings (`backend/app/core/config.py`).
- Definición de versión `0.1.0-alpha` (`backend/app/__version__.py`).
- Endpoint de verificación de salud `GET /health` y metadata `GET /` (`backend/app/main.py`).
- Middlewares de CORS y compresión GZip para red local y tablets.
- Router base versionado v1 (`backend/app/api/v1/router.py`).
- Pruebas unitarias automatizadas con `pytest` y `httpx` (`backend/tests/test_health.py`).
- **Frontend React + TypeScript + Vite:**
- Proyecto inicializado con versión `0.1.0-alpha` (`frontend/package.json`).
- Sistema de diseño con OnEver Design Tokens (`frontend/src/styles/tokens.css`).
- Layout Touch-First `100dvh` adaptado a Samsung Galaxy Tab A9/A11 de 4GB RAM (`frontend/src/styles/base.css`).
- Componente shell principal con verificación en tiempo real de salud de API y modo kiosco (`frontend/src/App.tsx`).
- Build estático ultraoptimizado con Vite (< 50 KB gzip).
- **Despliegue Multiplataforma:**
- Plantilla de variables de entorno `.env.example`.
- Configuración de orquestación `docker-compose.yml` y Nginx proxy.
- Dockerfile para Backend FastAPI.
- Script de instalación de servicio Windows NSSM (`scripts/windows/install_service.bat`) y modo nativo (`scripts/windows/start_native.bat`).
- Script de aprovisionamiento LXC para Proxmox/Debian (`scripts/lxc/setup_lxc.sh`) y unit file systemd (`scripts/lxc/onevercontrol.service`).
- Script agnóstico de diagnóstico y test de conectividad SQL Server (`scripts/test_sql_connection.py`).
## [Fase 0: Análisis y Arquitectura] - 2026-10-13
### Agregado
- **Informe Técnico Maestro:** Análisis exhaustivo del sistema de puesto de control actual (`OemspotPySYS`), arquitectura desacoplada, modelo transaccional y propuesta de cliente web en [INFORME_TECNICO_PUESTO_DE_CONTROL_WEB.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/INFORME_TECNICO_PUESTO_DE_CONTROL_WEB.md).
- **Constitución del Proyecto:** 9 principios innegociables (Thin Client, SDD, Hardware vía `pdtmdl`, Touch-First, Tablet como Workstation, TDD, Atomicidad SQL Server, Convenciones de Idioma, Portabilidad Multiplataforma Windows/LXC/Docker) en [docs/constitution.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/docs/constitution.md).
- **Arnés de Agentes de IA:** Reglas operativas, convenciones y trampas de dominio en [AGENTS.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/AGENTS.md) y memoria de contexto en [MEMORY.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/MEMORY.md).
- **Skill SDD:** Habilidad reutilizable de desarrollo guiado por especificaciones en [.agents/skills/sdd/SKILL.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/.agents/skills/sdd/SKILL.md).
- **Especificaciones EARS Iniciales:**
- `specs/001-login-workstation/`: Autenticación de operadores y resolución de estación de trabajo / carril.
- `specs/002-access-control-camera-scanner/`: Escaneo óptico de DNI argentino (PDF417 y QR) mediante la cámara de la tablet.
- **Documentación y Hoja de Ruta:** [README.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/README.md) y [ROADMAP.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/ROADMAP.md) con fases 0 a 8.
### Definiciones de Arquitectura
- **Backend:** FastAPI (Python 3.11+) + Pydantic v2.
- **Frontend:** React + TypeScript + Vite (SPA estática optimizada para tablets Samsung Galaxy Tab A9 y A11 de 4 GB RAM).
- **Soporte de Servidor Multiplataforma:** Capacidad de ejecución agnóstica en **Windows 10/11** (bare-metal / servicio NSSM), contenedores **LXC** (Proxmox VE / Debian con systemd y FreeTDS, < 80 MB RAM overhead) y **Docker / Docker Compose**.
- **Desacople de Hardware:** Toda orden física hacia barreras y molinetes ST1660 se encola en la tabla `pdtmdl` de SQL Server `videoman`, sin requerir puertos COM ni drivers Win32 en el servidor web.
- **Escaneo Óptico y Cámara:** Reemplazo total de escáneres físicos COM o emulación de teclado por la cámara integrada de la tablet (Barcode Detection API / ZXing).
- **Sin Streaming Hikvision ISAPI:** Exclusión de transmisión de video continuo en cliente web para proteger batería y ancho de banda en garitas.
- **Repositorio Oficial Gitea & Versionado:** Repositorio oficial en [`https://gitea.oemspot.com.ar/carlostellocba/OnEverControl`](https://gitea.oemspot.com.ar/carlostellocba/OnEverControl). Requisito formal de incrementar y sincronizar versiones de backend y frontend con registro en este changelog antes de cada push.