Files
OnEverControl/MEMORY.md
T

29 lines
4.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
- **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).