4.7 KiB
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 /healthy metadataGET /(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
pytestyhttpx(backend/tests/test_health.py).
- Configuración tipada con Pydantic Settings (
- 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
100dvhadaptado 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).
- Proyecto inicializado con versión
- Despliegue Multiplataforma:
- Plantilla de variables de entorno
.env.example. - Configuración de orquestación
docker-compose.ymly 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).
- Plantilla de variables de entorno
[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
pdtmdlde SQL Servervideoman, 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.