Files
OnEverControl/MEMORY.md
T

31 lines
3.2 KiB
Markdown

# MEMORY.md — OnEverControl
Memoria del proyecto entre sesiones. Máximo ~50 líneas: resume o elimina lo que ya no aporte.
## Estado actual
- **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 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
- **Workstations y Módulos Dinámicos:** Las workstations se consultan directamente de la tabla `wks` (`/api/v1/control-posts/workstations`) y sus módulos de `wksmdl` + `mdl`. Cero mocks en login o cockpit.
- **Historial vs Activos:** `tck` contiene solo ocupantes activos dentro del predio. Para auditoría y visualización de pasadas se consulta `mvthist` (`/api/v1/access/movements/recent`).
- **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.