6.5 KiB
6.5 KiB
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.txtconfastapi>=0.115.0,uvicorn[standard]>=0.30.0,httpx>=0.27.0ya2wsgi>=1.10.0. Instalar dependencias en el entorno virtualbackend/venv. - Archivos:
backend/requirements.txt - Hecho cuando: Las dependencias se instalen limpiamente con
pip install -r requirements.txtsin conflictos y puedan importarsefastapiyuvicorn.
[x] Tarea 2: Capa de persistencia y dependencias de sesión (database.py)
- Descripción: Implementar
backend/database.py(ostorage.py) para encapsular elenginede SQLAlchemy y la función generadoraget_db(), permitiendo reutilizar los modelos existentes debackend/app/models/de forma independiente deFlask-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 tablausersoclassroomsy cerrarse sin fugas de conexiones.
[x] Tarea 3: Dependencias de Seguridad y Autenticación JWT (dependencies.py)
- Descripción: Implementar
get_current_useryrequire_roles(...)enbackend/dependencies.pypara extraer y validar el JWT desde cookies (access_token) y cabecerasAuthorization: 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.pyinstanciandoFastAPI, configurandoCORSMiddleware, manejador global de excepciones, prefijo/api/v1y documentación interactiva en/docs. - Archivos:
backend/main.py,backend/asgi.py - Hecho cuando: El comando
uvicorn main:app --port 5000levante el servidor y responda HTTP 200 enGET /docsyGET /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 cookiesaccess_tokense seteen idénticamente. - Archivos:
backend/routers/auth.py,backend/schemas/auth.py - Hecho cuando: El login local y el endpoint
/api/v1/auth/medevuelvan el objeto de usuario y la cookieHttpOnlyesperada 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/classroomsyGET /api/v1/classrooms/buildingsrespondan 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/optimizery endpoints de/api/genetica FastAPIAPIRouter. - 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
TestClientde FastAPI /httpxy ejecutar la suite completa de 57 pruebas. - Archivos:
backend/tests/test_fastapi_endpoints.py,backend/tests/* - Hecho cuando: El comando
pytest tests -vpase 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:
- Incrementar versión a
v3.6.0enpackage.json,app.js,main.py,__init__.py,CHANGELOG.mdyMEMORY.md. - Ajustar el servicio systemd en
10.0.0.217para ejecutar conuvicorn. - Ejecutar
git add ., commit ygit push origin dev. - Desplegar en producción (
10.0.0.217) y verificar HTTP 200 en/version, Swagger UI/docsy el Frontend institucionalhttps://eduspace.oemspot.com.ar.
- Incrementar versión a
- 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.