Files

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.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.