Files
OnEverControl/MEMORY.md
T

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

  • 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).

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.

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