Files
OnEverControl/CHANGELOG.md
T

49 lines
4.7 KiB
Markdown

# 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](file:///c:/Workspace/OemspotPySYS/OnEverControl/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](file:///c:/Workspace/OemspotPySYS/OnEverControl/docs/constitution.md).
- **Arnés de Agentes de IA:** Reglas operativas, convenciones y trampas de dominio en [AGENTS.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/AGENTS.md) y memoria de contexto en [MEMORY.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/MEMORY.md).
- **Skill SDD:** Habilidad reutilizable de desarrollo guiado por especificaciones en [.agents/skills/sdd/SKILL.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/.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](file:///c:/Workspace/OemspotPySYS/OnEverControl/README.md) y [ROADMAP.md](file:///c:/Workspace/OemspotPySYS/OnEverControl/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`](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.