Files
OnEverControl/docs/constitution.md
T

2.9 KiB

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.