3.2 KiB
3.2 KiB
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
/healthy Vite SPA. - Fase 2: Backend core, contraseñas legacy VB6, JWT HttpOnly,
TicketIDcanó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
100dvhde 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.mdydocs/GUIA_DESPLIEGUE_PILOTO_HIBRIDO.md).
- Fase 0 & 1: Arquitectura, arnés de IA, Docker, LXC, Windows NSSM, FastAPI
- 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;OnEverWPCdespacha las órdenes de apertura. - La Tablet como Workstation: Cada tablet se registra en
wksde 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 enCHANGELOG.mdy 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 dewksmdl+mdl. Cero mocks en login o cockpit. - Historial vs Activos:
tckcontiene solo ocupantes activos dentro del predio. Para auditoría y visualización de pasadas se consultamvthist(/api/v1/access/movements/recent). - Tabla
Peren SQL Server: Exige columnas obligatoriasCREATEdByID(2) yLastUpdateDateByID(2). - Tabla
lot: El nombre del lote está en la columnaLote, noNombre. - Tabla
PerDocCatVal: RequiereDocumentoID(100000),CategoriaID(11) yValorID(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.