Files

15 lines
2.9 KiB
Markdown

# Constitución — OnEverControl
Principios innegociables del proyecto. Toda spec, plan y tarea debe cumplirlos sin excepción.
1. **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.
2. **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.
3. **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.
4. **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 `100dvh` resistente a teclado virtual y atajos de teclado físicos como alternativa.
5. **La Tablet es una Workstation**: Toda tablet se identifica ante SQL Server con un `workstation_name` registrado y hereda los mismos permisos y carriles que una PC Windows en OnEverAccess.
6. **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.
7. **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.
8. **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.
9. **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.
10. **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 en `CHANGELOG.md` antes 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.