Files
OnEverControl/MEMORY.md
T

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