Files
OnEverControl/CHANGELOG.md
T

18 KiB

Changelog — OnEverControl

Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.

[v0.7.0-beta] - 2026-10-29 (Paridad Funcional Total con OnEverAccess Desktop v1.2.4)

Bloque 1: Normalización de DNI Antiguo, Redirección Bidireccional y Sesiones

  • Normalización de DNI Antiguo con Prefijos 'F' y 'M':
    • Implementación de limpiar_numero_documento en dni_parser_service.py con regex para formatos históricos (Libreta Cívica, Libreta de Enrolamiento y Formato 2009).
    • Deducción automática de género ('F'/'M') y saneamiento del número antes de consultas y altas en PerDocCatVal.
    • Integración en escáner de cámara, parseo de PDF417/QR y entrada manual de Nro Doc.
  • Redirección Bidireccional de Carril (Entrada ↔ Salida):
    • Detección en Entrada ante Antipassback (persona con ticket activo en predio), mostrando banner de advertencia, selector reactivo de carriles de egreso y botón de salto inmediato preservando datos.
    • Detección en Salida ante "Persona no registrada en predio", ofreciendo salto inmediato a carriles de ingreso.
  • Historial de Escaneos (DNI) con Carga Rápida:
    • Groupbox reactivo en columna de acciones sincronizado en tiempo real con hasta 30 escaneos recientes.
    • Carga inmediata de datos al formulario con doble clic o botón de selección táctil.
    • Botón de limpieza de historial.
  • Persistencia y Reanudación de Sesión Interrumpida por Carril:
    • Gestor de sesión en localStorage por módulo (CarrilProcessSessionManager).
    • Al cambiar de carril con carga incompleta, se preserva el estado y se presenta un banner con cantidad de integrantes y botones para "Continuar Ingreso ➡️" o "Descartar ✕".

Bloque 2: Modales Operativos y Consultas Avanzadas

  • Visitas Preautorizadas (pre):
    • Modal reactivo PreauthorizedModal.tsx con filtros por visitante, lote o entidad y selector "Vigentes Hoy" / "Todas las Fechas".
    • Precarga directa de visitante y lote al carril de entrada.
    • Consumo atómico de la preautorización al generar el ticket de ingreso o mediante endpoint POST /api/v1/access/preauthorizations/{id}/consume.
  • Búsqueda Avanzada de Personas (DialogoBuscarPersona):
    • Modal PersonSearchModal.tsx con búsqueda multi-palabra sobre Apellido, Nombre, Documento, Nro de Socio y Lote.
    • Indicadores visuales de estado y alertas de Lista Negra (⛔ LISTA NEGRA).
  • Búsqueda Predictiva de Vehículos por Patente (DialogoBuscarPatente):
    • Modal VehicleSearchModal.tsx con soporte dual:
      • Modo Entrada: padrón de vehículos con marcas, modelos, titulares y vigencia de seguros automotores.
      • Modo Salida: vehículos con tickets activos dentro del predio con conductor, DNI, lote e ingreso.
  • Ficha Técnica Completa de Persona (DialogoFichaPersona):
    • Modal PersonProfileModal.tsx accesible mediante botón VER FICHA.
    • Muestra perfil completo: identificación, vínculo, patentes asociadas, coberturas de seguro automotor, ART, licencia de conductor y observaciones registradas.

Bloque 3: Salida Masiva, Control de Hardware y Pólizas

  • Salida Masiva Transaccional (DlgSalidaMasiva):
    • Modal MassExitModal.tsx con estadísticas en tiempo real de ocupación del predio.
    • Filtro multi-criterio, selección individual, "Seleccionar Todos" y "Deseleccionar".
    • Motivos operativos ("Toque de queda", "Evacuación", "Fin de evento", etc.) y observaciones para auditoría.
    • Transacción atómica en SQL Server: registro maestro en salida_masiva, desglose en salida_masiva_detalle, migración a tckhst, snapshots en mvthist y traza en auditoria_cambios.
  • Comando de Cierre Forzado de Hardware (C0..C6):
    • Endpoint POST /api/v1/hardware/modules/{id}/close en backend.
    • Implementación en HardwareService.encolar_cierre con mapeo de tramas industriales según firmware (ST1660 PASS vs PARK) y tipo de acceso.
    • Botón táctil 🛑 Forzar Cierre en el cockpit de garita junto a ⚡ Pulso Apertura.

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:
  • 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.
  • 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.
  • Arnés de Agentes de IA: Reglas operativas, convenciones y trampas de dominio en AGENTS.md y memoria de contexto en MEMORY.md.
  • Skill SDD: Habilidad reutilizable de desarrollo guiado por especificaciones en .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 y 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. Requisito formal de incrementar y sincronizar versiones de backend y frontend con registro en este changelog antes de cada push.