Files
OnEverControl/CHANGELOG.md
T

4.7 KiB

Changelog — OnEverControl

Todas las modificaciones, adiciones y decisiones de arquitectura notables de este proyecto serán documentadas en este archivo.

[v0.1.0-alpha] - 2026-10-13 (Fase 1: Arquitectura y Base del Proyecto)

Agregado

  • Backend FastAPI:
    • Configuración tipada con Pydantic Settings (backend/app/core/config.py).
    • Definición de versión 0.1.0-alpha (backend/app/__version__.py).
    • Endpoint de verificación de salud GET /health y metadata GET / (backend/app/main.py).
    • Middlewares de CORS y compresión GZip para red local y tablets.
    • Router base versionado v1 (backend/app/api/v1/router.py).
    • Pruebas unitarias automatizadas con pytest y httpx (backend/tests/test_health.py).
  • Frontend React + TypeScript + Vite:
    • Proyecto inicializado con versión 0.1.0-alpha (frontend/package.json).
    • Sistema de diseño con OnEver Design Tokens (frontend/src/styles/tokens.css).
    • Layout Touch-First 100dvh adaptado a Samsung Galaxy Tab A9/A11 de 4GB RAM (frontend/src/styles/base.css).
    • Componente shell principal con verificación en tiempo real de salud de API y modo kiosco (frontend/src/App.tsx).
    • Build estático ultraoptimizado con Vite (< 50 KB gzip).
  • Despliegue Multiplataforma:
    • Plantilla de variables de entorno .env.example.
    • Configuración de orquestación docker-compose.yml y Nginx proxy.
    • Dockerfile para Backend FastAPI.
    • Script de instalación de servicio Windows NSSM (scripts/windows/install_service.bat) y modo nativo (scripts/windows/start_native.bat).
    • Script de aprovisionamiento LXC para Proxmox/Debian (scripts/lxc/setup_lxc.sh) y unit file systemd (scripts/lxc/onevercontrol.service).
    • Script agnóstico de diagnóstico y test de conectividad SQL Server (scripts/test_sql_connection.py).

[Fase 0: Análisis y Arquitectura] - 2026-10-13

Agregado

  • Informe Técnico Maestro: Análisis exhaustivo del sistema de puesto de control actual (OemspotPySYS), arquitectura desacoplada, modelo transaccional y propuesta de cliente web en INFORME_TECNICO_PUESTO_DE_CONTROL_WEB.md.
  • Constitución del Proyecto: 9 principios innegociables (Thin Client, SDD, Hardware vía pdtmdl, Touch-First, Tablet como Workstation, TDD, Atomicidad SQL Server, Convenciones de Idioma, Portabilidad Multiplataforma Windows/LXC/Docker) en docs/constitution.md.
  • Arnés de Agentes de IA: Reglas operativas, convenciones y trampas de dominio en AGENTS.md y memoria de contexto en MEMORY.md.
  • Skill SDD: Habilidad reutilizable de desarrollo guiado por especificaciones en .agents/skills/sdd/SKILL.md.
  • Especificaciones EARS Iniciales:
    • specs/001-login-workstation/: Autenticación de operadores y resolución de estación de trabajo / carril.
    • specs/002-access-control-camera-scanner/: Escaneo óptico de DNI argentino (PDF417 y QR) mediante la cámara de la tablet.
  • Documentación y Hoja de Ruta: README.md y ROADMAP.md con fases 0 a 8.

Definiciones de Arquitectura

  • Backend: FastAPI (Python 3.11+) + Pydantic v2.
  • Frontend: React + TypeScript + Vite (SPA estática optimizada para tablets Samsung Galaxy Tab A9 y A11 de 4 GB RAM).
  • Soporte de Servidor Multiplataforma: Capacidad de ejecución agnóstica en Windows 10/11 (bare-metal / servicio NSSM), contenedores LXC (Proxmox VE / Debian con systemd y FreeTDS, < 80 MB RAM overhead) y Docker / Docker Compose.
  • Desacople de Hardware: Toda orden física hacia barreras y molinetes ST1660 se encola en la tabla pdtmdl de SQL Server videoman, sin requerir puertos COM ni drivers Win32 en el servidor web.
  • Escaneo Óptico y Cámara: Reemplazo total de escáneres físicos COM o emulación de teclado por la cámara integrada de la tablet (Barcode Detection API / ZXing).
  • Sin Streaming Hikvision ISAPI: Exclusión de transmisión de video continuo en cliente web para proteger batería y ancho de banda en garitas.
  • Repositorio Oficial Gitea & Versionado: Repositorio oficial en https://gitea.oemspot.com.ar/carlostellocba/OnEverControl. Requisito formal de incrementar y sincronizar versiones de backend y frontend con registro en este changelog antes de cada push.