Files
OnEverControl/CHANGELOG.md
T

7.5 KiB

Changelog — OnEverControl

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

  • 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.