2.9 KiB
2.9 KiB
Constitución — OnEverControl
Principios innegociables del proyecto. Toda spec, plan y tarea debe cumplirlos sin excepción.
- Modo Cliente Reducido: OnEverControl es exclusivamente un cliente web para Login y Puesto de Control en la LAN de OnEverAccess. Prohibido duplicar módulos maestros o administrativos de OnEverAccess.
- La Spec manda (SDD): Nada se implementa si no está en la spec activa (
specs/NNN-*/). Si falta una decisión o surge ambigüedad, se detiene la ejecución y se consulta al usuario. - Desacople de Hardware y Lectura por Cámara: El navegador jamás interactúa directamente con puertos COM o buses RS-485; toda orden a barreras o molinetes se encola en
pdtmdl. La lectura de documentos (DNI PDF417/QR) se realiza exclusivamente mediante la cámara integrada de la tablet, prescindiendo por completo de escáneres por puerto COM y emulación de teclado. - Diseño Touch-First para Tablets: La interfaz debe ser 100% operable en tablets (Android, iPad, Windows Surface). Touch targets mínimos de 48x48px, layout
100dvhresistente a teclado virtual y atajos de teclado físicos como alternativa. - La Tablet es una Workstation: Toda tablet se identifica ante SQL Server con un
workstation_nameregistrado y hereda los mismos permisos y carriles que una PC Windows en OnEverAccess. - Tests como Puerta de Calidad: En cada tarea de backend o lógica, los tests se escriben primero (en rojo) antes de implementar el código. Prohibido dar por terminada una tarea con tests fallando.
- Transaccionalidad en videoman: Las operaciones de acceso en SQL Server son atómicas (
tck,tckper,tckprx,mvthist,pdtmdl). Si falla una parte, se realiza rollback completo. - Idioma y Nomenclatura: Código y APIs en inglés con nombres semánticos; interfaz de usuario, mensajes de garita y documentación técnica en español.
- Portabilidad Multiplataforma (Windows 10/11, LXC, Docker): OnEverControl debe ejecutarse sin modificaciones de código tanto en bare-metal Windows 10/11 (servicio del sistema), como en contenedores ligeros LXC (Proxmox/Debian/Alpine con systemd) y entornos Docker / Docker Compose. Se prohíbe el uso de rutas hardcodeadas con contrabarras (usar siempre
pathlib.Path), llamadas exclusivas a APIs de Win32 en el backend, o dependencias directas de hardware que impidan el despliegue en entornos Linux sin privilegios. - Versionado Semántico y Repositorio Oficial Gitea: Todo cambio significativo o cierre de fase requiere actualizar explícitamente la versión del backend (
backend/app/__version__.py) y del frontend (frontend/package.json), asentando el detalle enCHANGELOG.mdantes de ser integrado y subido al repositorio oficial de Gitea (https://gitea.oemspot.com.ar/carlostellocba/OnEverControl). Queda prohibido realizar commits/pushes sin versionado explícito ni validación de pruebas.