4.0 KiB
4.0 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 hoja de ruta. - Arnés de IA y SDD configurado: Creados
AGENTS.md,docs/constitution.mdy estructura de especificaciones. - Pendiente: Aprobación de la primera spec (
specs/001-login-workstation/) para dar inicio a la Fase 1.
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 Servervideoman. 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
videomande 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_nameregistrado 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 enpdtmdlpara que el servicioOnEverWPCexistente los despache físicamente a las placas ST1660. - Diseño Touch-First para Tablets: Controles mínimos de 48px, layout
100dvhpara 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 enbackend/yfrontend/, registrar enCHANGELOG.mdy 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;
pdtmdles 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
- Validar y aprobar la especificación
specs/001-login-workstation/spec.md. - Fase 1: Scaffolding inicial del backend FastAPI y frontend Node.js / Vite.