12 KiB
12 KiB
Changelog — OnEverControl
Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.
[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/workstationspara poblar el dropdown de estaciones directamente desde la tablawksde SQL Server (CFT-DESK,REGATAS-R).
- Eliminación de todas las opciones mock en
- Configuración de Módulos de Entrada y Salida (
wksmdl+mdl):- Implementación de
/api/v1/control-posts/{workstation_name}/configy/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.
- Implementación de
- Pestaña de Historial de Movimientos Reales (
mvthist):- Nuevo endpoint
/api/v1/access/movements/recentpara consultar las últimas transacciones registradas en SQL Server. - Implementación en
ControlPostView.tsxde selector de pestañas entre "🟢 En Predio (Activos)" y "📜 Historial Movimientos BD".
- Nuevo endpoint
- Adopción Total del Sistema de Diseño Oficial (
styles/design_system.py):- Implementación en
tokens.cssybase.cssde 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
10pxen tarjetas, entradas, botones y selectores. - Soporte de temas Claro/Oscuro dinámicos mediante hook
useThemey conmutador táctil☀️ / 🌙. - Tipografía profesional
'Segoe UI', 'Roboto', sans-serifcon estilos de títulos, scrollbars modernas y badges de estado.
- Implementación en
- Acceso Robusto y Universal a Cámaras en Android y Windows:
- Integración de biblioteca industrial
@zxing/librarypara 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 rechazanfacingMode: environment. - Despliegue dual de backend en HTTP (
:8000) y HTTPS con certificado SSL (:8443) para habilitar Secure Context en tablets.
- Integración de biblioteca industrial
[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 puerto8000si Nginx no está presente, permitiendo el despliegue inmediato en Windows 10/11 y contenedores LXC con un único proceso ejecutable.
- Configuración automática para servir la aplicación SPA compilada (
- Configuración de PWA y Modo Kiosco para Tablets:
- Archivo
manifest.jsony 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.
- Archivo
- 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,tckperymvthist, permitiendo su cierre normal desde la aplicación de escritorio sin corrupción de datos.
- Escenario 1 (Desktop -> Web): Verificación de que ingresos generados por el cliente legado de escritorio (
- Documentación Operativa y Guías de Piloto:
- Manual de operador ilustrado para garitas y tablets en
docs/MANUAL_OPERADOR_GARITA.md. - Guía técnica de instalación del piloto para administradores en
docs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md(Windows NSSM, LXC Proxmox y Docker Compose).
- Manual de operador ilustrado para garitas y tablets en
- Actualización de Versiones Sincronizadas:
- Incremento formal a
v0.6.0-betaenbackend/app/__version__.pyyfrontend/package.jsonpara publicación en Gitea.
- Incremento formal a
[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
TicketIDcanó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/searchy/api/v1/access/parse-dni.
- Repositorio y Servicio de Accesos transaccional atómico (
- 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).
AuthContextcon soporte de persistencia de sesión y resolución de estación (CFT-DESK).- Vista
LoginViewcon selector táctil de workstation y retroalimentación de errores. - Vista de garita
ControlPostViewcon 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
HardwareServicecon generación de tramas ST1660 (STX + Addr + Payload + CS + EOF) y encolado en tablapdtmdlpara despacho porOnEverWPC. - Componente modal
CameraScannerModalconBarcodeDetectornativo (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.
- Servicio de hardware
- 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-betaen 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 /healthy metadataGET /(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
pytestyhttpx(backend/tests/test_health.py).
- Configuración tipada con Pydantic Settings (
- 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
100dvhadaptado 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).
- Proyecto inicializado con versión
- Despliegue Multiplataforma:
- Plantilla de variables de entorno
.env.example. - Configuración de orquestación
docker-compose.ymly 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).
- Plantilla de variables de entorno
[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
pdtmdlde SQL Servervideoman, 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.