feat(api): migracion completa de Flask API a FastAPI ASGI con arquitectura en 4 capas v3.6.0
This commit is contained in:
@@ -0,0 +1,84 @@
|
||||
# Tareas de Implementación 003 — Migración de Flask API a FastAPI
|
||||
|
||||
Basado en: `specs/003-migracion-fastapi/spec.md` y `specs/003-migracion-fastapi/plan.md`.
|
||||
|
||||
---
|
||||
|
||||
## Tareas Preparatorias: Dependencias y Núcleo Base
|
||||
|
||||
### [x] Tarea 1: Adición de dependencias e infraestructura base
|
||||
- **Descripción**: Actualizar `requirements.txt` con `fastapi>=0.115.0`, `uvicorn[standard]>=0.30.0`, `httpx>=0.27.0` y `a2wsgi>=1.10.0`. Instalar dependencias en el entorno virtual `backend/venv`.
|
||||
- **Archivos**: `backend/requirements.txt`
|
||||
- **Hecho cuando**: Las dependencias se instalen limpiamente con `pip install -r requirements.txt` sin conflictos y puedan importarse `fastapi` y `uvicorn`.
|
||||
|
||||
### [x] Tarea 2: Capa de persistencia y dependencias de sesión (`database.py`)
|
||||
- **Descripción**: Implementar `backend/database.py` (o `storage.py`) para encapsular el `engine` de SQLAlchemy y la función generadora `get_db()`, permitiendo reutilizar los modelos existentes de `backend/app/models/` de forma independiente de `Flask-SQLAlchemy`.
|
||||
- **Archivos**: `backend/database.py`, `backend/app/models/__init__.py`
|
||||
- **Hecho cuando**: Un script de prueba pueda instanciar una sesión con `next(get_db())`, consultar la tabla `users` o `classrooms` y cerrarse sin fugas de conexiones.
|
||||
|
||||
### [x] Tarea 3: Dependencias de Seguridad y Autenticación JWT (`dependencies.py`)
|
||||
- **Descripción**: Implementar `get_current_user` y `require_roles(...)` en `backend/dependencies.py` para extraer y validar el JWT desde cookies (`access_token`) y cabeceras `Authorization: Bearer <token>`.
|
||||
- **Archivos**: `backend/dependencies.py`, `backend/security/`
|
||||
- **Hecho cuando**: Se verifiquen llamadas con y sin token, validando rechazo con HTTP 401 y validación de roles con HTTP 403.
|
||||
|
||||
### [x] Tarea 4: Bootstrap de la aplicación FastAPI (`main.py` y `asgi.py`)
|
||||
- **Descripción**: Crear `backend/main.py` instanciando `FastAPI`, configurando `CORSMiddleware`, manejador global de excepciones, prefijo `/api/v1` y documentación interactiva en `/docs`.
|
||||
- **Archivos**: `backend/main.py`, `backend/asgi.py`
|
||||
- **Hecho cuando**: El comando `uvicorn main:app --port 5000` levante el servidor y responda HTTP 200 en `GET /docs` y `GET /api/v1/version`.
|
||||
|
||||
---
|
||||
|
||||
## Tareas de Migración de Routers y Schemas (Capa 2 y Capa 3)
|
||||
|
||||
### [x] Tarea 5: Módulo de Autenticación (`routers/auth.py` y `schemas/auth.py`)
|
||||
- **Descripción**: Migrar los endpoints de `/api/v1/auth/` (login, logout, me, impersonate, google, moodle) a FastAPI, asegurando que las cookies `access_token` se seteen idénticamente.
|
||||
- **Archivos**: `backend/routers/auth.py`, `backend/schemas/auth.py`
|
||||
- **Hecho cuando**: El login local y el endpoint `/api/v1/auth/me` devuelvan el objeto de usuario y la cookie `HttpOnly` esperada por el BFF.
|
||||
|
||||
### [x] Tarea 6: Módulo de Aulas y Edificios (`routers/classrooms.py` y `schemas/classrooms.py`)
|
||||
- **Descripción**: Migrar endpoints de sedes, edificios, pisos y aulas físicas/virtuales (`/api/v1/classrooms/`).
|
||||
- **Archivos**: `backend/routers/classrooms.py`, `backend/schemas/classrooms.py`
|
||||
- **Hecho cuando**: `GET /api/v1/classrooms` y `GET /api/v1/classrooms/buildings` respondan con los filtros y estructuras esperadas.
|
||||
|
||||
### [x] Tarea 7: Módulo de Reservas y Matriz de Conflictos (`routers/reservations.py` y `schemas/reservations.py`)
|
||||
- **Descripción**: Migrar la creación, modificación, cancelación y consulta de reservas (`/api/v1/reservations`), integrando el validador de conflictos físicos, aforo, docentes y alumnos con respuestas HTTP 409 descriptivas.
|
||||
- **Archivos**: `backend/routers/reservations.py`, `backend/schemas/reservations.py`
|
||||
- **Hecho cuando**: Se ejecuten pruebas de colisión y el endpoint rechace reservas superpuestas con HTTP 409 y acepte reservas válidas con HTTP 201.
|
||||
|
||||
### [x] Tarea 8: Módulo de Dashboard y Cartelera (`routers/dashboard.py` y `schemas/dashboard.py`)
|
||||
- **Descripción**: Migrar los endpoints de métricas de ocupación (`/api/v1/dashboard/stats`), clases de hoy y semana (`/api/v1/dashboard/today-schedule`), aulas libres y sincronización de Google Sheets (`/api/v1/dashboard/sync-sheets`).
|
||||
- **Archivos**: `backend/routers/dashboard.py`, `backend/schemas/dashboard.py`
|
||||
- **Hecho cuando**: El Dashboard de Bedelía consuma las estadísticas por día, mañana, semana y mes sin errores.
|
||||
|
||||
### [x] Tarea 9: Módulo Administrativo y Auditoría (`routers/admin.py` y `schemas/admin.py`)
|
||||
- **Descripción**: Migrar los ABMs de ciclos lectivos, carreras, asignaturas, comisiones, docentes, alumnos y el endpoint de auditoría (`/api/v1/admin/audit-logs`).
|
||||
- **Archivos**: `backend/routers/admin.py`, `backend/schemas/admin.py`
|
||||
- **Hecho cuando**: La grilla de auditoría y los listados administrativos respondan con paginación y filtros correctos.
|
||||
|
||||
### [x] Tarea 10: Módulo de Optimizador Heurístico IA (`routers/optimizer.py`)
|
||||
- **Descripción**: Migrar `/api/v1/optimizer` y endpoints de `/api/genetic` a FastAPI `APIRouter`.
|
||||
- **Archivos**: `backend/routers/optimizer.py`
|
||||
- **Hecho cuando**: Las consultas de comisiones para optimización y cálculo de algoritmos genéticos respondan con normalidad.
|
||||
|
||||
---
|
||||
|
||||
## Tareas de Pruebas, Verificación y Despliegue (Principios 9 y 10)
|
||||
|
||||
### [x] Tarea 11: Adaptación de la Suite de Pruebas (`tests/`)
|
||||
- **Descripción**: Adaptar el fixture principal de testing para utilizar `TestClient` de FastAPI / `httpx` y ejecutar la suite completa de 57 pruebas.
|
||||
- **Archivos**: `backend/tests/test_fastapi_endpoints.py`, `backend/tests/*`
|
||||
- **Hecho cuando**: El comando `pytest tests -v` pase con 100% de éxito (57/57 tests en verde).
|
||||
|
||||
### [x] Tarea 12: Tolerancia Cero a Errores y Diagnóstico Estático
|
||||
- **Descripción**: Revisar analizador estático y linter para garantizar cero errores (`@[current_problems]`).
|
||||
- **Archivos**: Código fuente en `backend/`
|
||||
- **Hecho cuando**: La lista de problemas en la terminal/IDE esté completamente limpia (0 errores).
|
||||
|
||||
### [x] Tarea 13: Bump Semántico, Git Push y Despliegue en Servidor LXC Producción
|
||||
- **Descripción**:
|
||||
1. Incrementar versión a `v3.6.0` en `package.json`, `app.js`, `main.py`, `__init__.py`, `CHANGELOG.md` y `MEMORY.md`.
|
||||
2. Ajustar el servicio systemd en `10.0.0.217` para ejecutar con `uvicorn`.
|
||||
3. Ejecutar `git add .`, commit y `git push origin dev`.
|
||||
4. Desplegar en producción (`10.0.0.217`) y verificar HTTP 200 en `/version`, Swagger UI `/docs` y el Frontend institucional `https://eduspace.oemspot.com.ar`.
|
||||
- **Archivos**: `package.json`, `frontend/src/app.js`, `backend/main.py`, `CHANGELOG.md`, `MEMORY.md`
|
||||
- **Hecho cuando**: El entorno de producción corra FastAPI y el frontend responda correctamente con HTTP 200.
|
||||
Reference in New Issue
Block a user