From c3810a6525326c7274682939ad71c32b2eea55b9 Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Tue, 13 Oct 2026 16:00:55 -0300 Subject: [PATCH] docs: sync MEMORY.md and ROADMAP.md with completed Phases 0 to 6 and status tracker --- MEMORY.md | 40 ++++++++++++++++++++-------------------- ROADMAP.md | 24 +++++++++++++++++++----- 2 files changed, 39 insertions(+), 25 deletions(-) diff --git a/MEMORY.md b/MEMORY.md index d01c4fb..0e80fb2 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -3,26 +3,26 @@ Memoria del proyecto entre sesiones. Máximo ~50 líneas: resume o elimina lo que ya no aporte. ## Estado actual -- **Fase 0 (Completada):** Análisis técnico exhaustivo del puesto de control actual (`OemspotPySYS`), definición de arquitectura, tecnologías y roadmap. -- **Fase 1 (Completada - v0.1.0-alpha):** Base del proyecto, backend FastAPI con `/health` (tests en verde), frontend React + TypeScript + Vite con layout `100dvh` compilado limpiamente (< 50KB gzip), configuración multiplataforma (Windows 10/11, LXC y Docker) y script de diagnóstico SQL Server. -- **Pendiente:** Implementar la primera especificación funcional (`specs/001-login-workstation/`) correspondiente a la Fase 2 (Backend Core y Login). +- **Versión Activa:** `v0.6.0-beta` (Sincronizada en backend y frontend). +- **Fases Completadas (0 a 6):** + - **Fase 0 & 1:** Arquitectura, arnés de IA, Docker, LXC, Windows NSSM, FastAPI `/health` y Vite SPA. + - **Fase 2:** Backend core, contraseñas legacy VB6, JWT HttpOnly, `TicketID` canónico, antipassback y repositorios atómicos SQL Server (`tck`, `tckprx`, `tckper`, `tckhst`, `mvthist`). + - **Fase 3:** Frontend SPA React + TS + Vite Touch-First para Samsung Galaxy Tab A9/A11 (4GB RAM) con layout `100dvh` de 2 columnas, autocompletado de lotes y steppers de ocupantes. + - **Fase 4:** Encolado industrial en `pdtmdl` (tramas ST1660 con checksum VB6), escaneo de DNI con cámara integrada de la tablet (`BarcodeDetector`) y WebSockets en tiempo real. + - **Fase 5:** QA integral con 28 pruebas pytest aprobadas, latencia de encolado de hardware ~72 ms y bundle de producción < 55 KB gzip. + - **Fase 6:** Convivencia híbrida Desktop-Web validada bidireccionalmente (`test_hybrid_coexistence.py`), modo Kiosco PWA (`manifest.json`), montaje estático unificado en FastAPI y manuales operativos (`docs/MANUAL_OPERADOR_GARITA.md` y `docs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md`). +- **Próximo Paso:** Fase 7 (Puesta en Producción y Migración Total de Garitas). -## Decisiones (y por qué) -- **Backend en FastAPI + Pydantic v2 & Frontend en React + TypeScript + Vite:** FastAPI reutiliza los módulos probados de Python (`parser_dni`, pymssql) y gestiona la persistencia con SQL Server `videoman`. React con TypeScript y Vite produce una SPA estática ultraliviana con huella mínima en memoria RAM (~30-50 MB en navegador), fundamental para operar de forma fluida y sin lag en tablets **Samsung Galaxy Tab A9 y A11 de 4GB de RAM**. -- **Modo Cliente Reducido en LAN:** Se migra exclusivamente el Login y el Puesto de Control operativo (ingreso, salida, acompañantes, barreras, antipassback) conectándose a la base de datos `videoman` de OnEverAccess en la red local. Cero duplicación de módulos administrativos centrales. -- **Tablets como Workstations:** Cada tablet (Android, iPad, Windows) se identifica con un `workstation_name` registrado en SQL Server, heredando exactamente los mismos permisos y carriles asignados que una PC Windows. -- **Lectura de Documento con la Cámara de la Tablet:** Se reemplazan completamente los escáneres físicos externos (puerto COM o emulación de teclado). La tablet utiliza su cámara integrada (trasera/frontal) con Barcode Detection API / ZXing para leer instantáneamente el DNI argentino (PDF417 y QR), capturando al mismo tiempo la foto de evidencia visual. Elimina periféricos, cables y otorga 100% de movilidad al guardia en el carril. -- **Desacople de Hardware vía `pdtmdl`:** El navegador nunca intenta abrir puertos COM o RS-485. Encola comandos en `pdtmdl` para que el servicio `OnEverWPC` existente los despache físicamente a las placas ST1660. -- **Diseño Touch-First para Tablets:** Controles mínimos de 48px, layout `100dvh` para prevenir oclusión por teclado virtual y soporte PWA a pantalla completa. -- **Sin Streaming de Cámaras Hikvision por ISAPI:** Se descarta por completo el streaming de cámaras fijas hacia las tablets. Esto elimina la saturación de red Wi-Fi, evita el recalentamiento y preserva la batería de los dispositivos de garita. -- **Portabilidad Servidor Multiplataforma (Windows 10/11, LXC, Docker):** Al estar desacoplado del hardware COM/RS-485 mediante la tabla `pdtmdl`, OnEverControl es agnóstico del SO de host. Puede ejecutarse bare-metal en Windows 10/11 (como servicio), en contenedores LXC (Proxmox/Debian con systemd y FreeTDS nativo) o empaquetado en Docker / Docker Compose sin necesidad de passthrough de dispositivos ni privilegios especiales. -- **Repositorio Oficial Gitea y Versionado:** Repositorio central en `https://gitea.oemspot.com.ar/carlostellocba/OnEverControl`. Obligatorio incrementar y sincronizar versiones en `backend/` y `frontend/`, registrar en `CHANGELOG.md` y pasar suite de pruebas antes de cada push a Gitea. +## Decisiones Clave (y por qué) +- **Desacople vía `pdtmdl`:** Cero puertos COM o drivers seriales en el cliente web; `OnEverWPC` despacha las órdenes de apertura. +- **La Tablet como Workstation:** Cada tablet se registra en `wks` de SQL Server y hereda carriles y módulos idénticamente a una PC. +- **Cámara Tablet en reemplazo de Lectores Físicos:** Se utiliza la cámara integrada con liberación inmediata de hardware (`MediaStreamTrack.stop()`), evitando periféricos y fugas de memoria en tablets de 4GB. +- **Sin Streaming Hikvision por ISAPI:** Excluido para no agotar la batería ni saturar la red Wi-Fi en garitas. +- **Convivencia Híbrida 100% Compatible:** La base de datos es compartida; ingresos web pueden cerrarse desde la app desktop y viceversa sin colisiones. +- **Repositorio Oficial Gitea y Versionado:** `https://gitea.oemspot.com.ar/carlostellocba/OnEverControl`. Obligatorio incrementar versiones en backend/frontend, documentar en `CHANGELOG.md` y pasar pruebas antes de cada push. ## Aprendizajes y errores a evitar -- **No trasladar lógica serial al navegador:** En tablets y navegadores estándar, el acceso serial directo es restrictivo o inexistente; `pdtmdl` es la vía robusta y desacoplada. -- **Evitar streaming de video continuo en tablets:** El video agota aceleradamente la batería y satura la Wi-Fi de garita; mantener la tablet enfocada en la operativa de paso y fotos de evidencia. -- **Evitar re-renders en inputs táctiles:** En tablets, los re-renders pesados provocan pérdida de foco en el teclado en pantalla. Usar estado reactivo localizado. - -## Próximos pasos -- [ ] Fase 2: Implementación de `specs/001-login-workstation/` (Autenticación JWT, verificación de contraseña y asignación de Workstation/carriles en SQL Server). - +- **Tabla `Per` en SQL Server:** Exige columnas obligatorias `CREATEdByID` (2) y `LastUpdateDateByID` (2). +- **Tabla `lot`:** El nombre del lote está en la columna `Lote`, no `Nombre`. +- **Tabla `PerDocCatVal`:** Requiere `DocumentoID` (100000), `CategoriaID` (11) y `ValorID` (1). +- **Cámara en tablets de 4GB RAM:** Detener siempre todas las pistas de audio/video (`track.stop()`) al cerrar el modal para no saturar memoria. diff --git a/ROADMAP.md b/ROADMAP.md index e0e74ad..0f0c727 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -5,17 +5,31 @@ Este documento define el roadmap estructurado para el desarrollo, integración, --- -### Resumen Visual de Fases +### Resumen Visual de Fases y Estado ```text -[Fase 0: Análisis & Diseño] ➔ [Fase 1: Arquitectura & Setup Base] ➔ [Fase 2: Backend Core & APIs] - │ -[Fase 5: Pruebas & QA]  [Fase 4: Integración Hardware/Cámaras]  [Fase 3: Frontend Web SPA] +[Fase 0: ✔ COMPLETADA] ➔ [Fase 1: ✔ COMPLETADA] ➔ [Fase 2: ✔ COMPLETADA] + │ +[Fase 5: ✔ COMPLETADA]  [Fase 4: ✔ COMPLETADA]  [Fase 3: ✔ COMPLETADA] │ ▼ -[Fase 6: Piloto & Migración] ➔ [Fase 7: Puesta en Producción] ➔ [Fase 8: Mejoras Posteriores] +[Fase 6: ✔ COMPLETADA] ➔ [Fase 7: ⏳ PENDIENTE] ➔ [Fase 8: ⏳ PENDIENTE] ``` +### Tabla de Progreso de Fases + +| Fase | Título / Alcance | Estado | Versión | Hitos Clave | +| :--- | :--- | :---: | :---: | :--- | +| **Fase 0** | Análisis, Diseño y Arquitectura | **COMPLETADA** | - | Informe maestro, constitución, arnés de IA, especificaciones SDD. | +| **Fase 1** | Arquitectura y Setup Base | **COMPLETADA** | `v0.1.0-alpha` | Backend FastAPI (`/health`), React Vite SPA, Docker, LXC, Windows NSSM. | +| **Fase 2** | Backend Core y Control de Accesos | **COMPLETADA** | `v0.5.0-beta` | JWT, passwords legacy VB6, DNI parser multiformato, antipassback, `TicketID`. | +| **Fase 3** | Frontend Web Cockpit Touch-First | **COMPLETADA** | `v0.5.0-beta` | SPA React TS para tablets Galaxy Tab A9/A11 (4GB RAM), autocompletado lotes. | +| **Fase 4** | Hardware, Escaneo Óptico y WebSockets | **COMPLETADA** | `v0.5.0-beta` | Encolado en `pdtmdl`, cámara tablet (`BarcodeDetector`), WebSockets live. | +| **Fase 5** | Pruebas Integrales, QA y Stress Testing | **COMPLETADA** | `v0.5.0-beta` | 28 tests pytest aprobados, latencia hardware 72ms, build Vite < 55KB gzip. | +| **Fase 6** | Despliegue Piloto y Convivencia Híbrida | **COMPLETADA** | `v0.6.0-beta` | Compatibilidad Desktop/Web validada, PWA Kiosco, manuales garita y piloto. | +| **Fase 7** | Puesta en Producción y Migración Total | **PENDIENTE** | `v1.0.0` | Habilitación en todas las garitas, retiro gradual de desktop, monitoreo. | +| **Fase 8** | Mejoras Posteriores y Analítica | **PENDIENTE** | `v1.1.0+` | Reconocimiento LPR embebido, analítica de flujo en carriles. | + --- ## Detalle de Fases de Ejecución