feat(api): migracion completa de Flask API a FastAPI ASGI con arquitectura en 4 capas v3.6.0

This commit is contained in:
2026-10-16 17:36:44 -03:00
parent 5057d648c9
commit 37c21e1cd8
28 changed files with 1956 additions and 309 deletions
+16
View File
@@ -11,6 +11,22 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.6.0] - 2026-10-16
### Added
- **Migración Integral del Backend Core a FastAPI (Principio 11)**:
- **Arquitectura en 4 Capas Desacoplada**: Implementados `backend/main.py` (FastAPI bootstrap), `backend/routers/` (APIRouters modulares), `backend/schemas/` (Pydantic v2 BaseModels con validación declarativa) y `backend/database.py` (persistencia relacional).
- **Routers FastAPI de Alto Rendimiento**:
- `routers/version.py`: Endpoint `/api/v1/version` identificando el motor FastAPI ASGI.
- `routers/auth.py`: Autenticación híbrida (Local con fallback admin, Google OAuth 2.0 institucional, Moodle delegado, cookies JWT `HttpOnly`, revocación y refresh silencioso).
- `routers/classrooms.py`: ABM de aulas físicas y virtuales con filtros granulares y auditoría.
- `routers/reservations.py`: Gestión integral de reservas con matriz de colisiones física, docente y aforo, y respuestas semánticas 409 Conflict.
- `routers/students.py`: Consulta de calificaciones individuales e hitos académicos.
- `routers/dashboard.py`: Métricas operativas en tiempo real (día, mañana, semana y mes) y sincronización con Google Sheets.
- `routers/optimizer.py` y `/api/genetic`: Trabajos de optimización áulica y sincronización Spring Boot.
- **Documentación Interactiva Automática**: Swagger UI expuesto nativamente en `/docs`, ReDoc en `/redoc` y OpenAPI v3 en `/openapi.json`.
- **Puente ASGI/WSGI de Cero Regresión**: Integración con `a2wsgi` para delegar sin interrupción cualquier módulo legado manteniendo compatibilidad total con Gunicorn, Uvicorn y systemd.
- **Suite de Pruebas**: Suite ampliada a 57 tests automatizados con 100% de éxito (`57 passed`).
## [3.5.7] - 2026-10-16
### Added
- **Principio 11 de la Constitución: Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**: