Files
admin-edu-space/specs/004-depuracion-flask-total/plan.md
T

3.5 KiB

Plan Técnico: 004-depuracion-flask-total - Erradicación Total de Flask y Migración a SQLAlchemy 2.0 Nativo

1. Arquitectura de la Solución

1.1. Capa de Persistencia Nativa (backend/database.py y backend/app/__init__.py)

Actualmente, los modelos (Building, Classroom, User, etc.) importan db desde app (from app import db), y dependen de propiedades como db.Model, db.Column, db.relationship y db.session. Para desacoplarlo de Flask sin tener que reescribir manualmente cada modelo:

  • Diseñamos una clase/adaptador SQLAlchemyWrapper en backend/database.py (o en backend/app/db.py reexportado en app/__init__.py) construido 100% sobre SQLAlchemy 2.0 estándar:
    • engine = create_engine(DATABASE_URL, pool_pre_ping=True, ...)
    • SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
    • session = scoped_session(SessionLocal)
    • Model = declarative_base()
    • Reexporta directamente tipos de SQLAlchemy: Column = sa.Column, Integer = sa.Integer, String = sa.String, relationship = orm.relationship, etc.
    • Métodos create_all() y drop_all() ejecutados directamente contra engine.
  • En backend/database.py, la dependencia FastAPI get_db() yieldará la sesión nativa:
    def get_db():
        db_session = SessionLocal()
        try:
            yield db_session
        finally:
            db_session.close()
    
  • Ya no existirá get_flask_app() ni necesidad de flask_app.app_context().

1.2. Limpieza de Routers (backend/routers/*.py)

  • Remover:
    from database import get_flask_app
    flask_app = get_flask_app()
    
  • Remover envoltorios with flask_app.app_context():.
  • Las consultas accederán directamente a db.session (que es el scoped_session nativo de SQLAlchemy) o a la dependencia inyectada db: Session = Depends(get_db).

1.3. Poda de Archivos y Directorios Legados

  • Eliminar recursivamente:
    • backend/app/routes/ (antiguo monolito Jinja2 y APIs de Flask).
    • backend/app/forms/ (formularios WTForms).
  • Modificar:
    • install.sh: eliminar flask de la verificación de dependencias.
    • backend/requirements.txt: remover Flask, Flask-SQLAlchemy, Flask-Login, Flask-WTF, Flask-Migrate, Flask-CORS, Flask-Babel.
    • backend/setup.py: remover las mismas dependencias de install_requires.
    • backend/app/__init__.py: eliminar imports de Flask, request, session, Babel, Migrate, CORS y el registro de blueprints de Flask.

1.4. Actualización del Arnés de Tests (backend/tests/conftest.py)

  • Modificar conftest.py para inicializar SQLAlchemy en memoria (sqlite:///:memory:) sin depender de create_app() de Flask.
  • Los tests que hacían peticiones HTTP utilizarán fastapi.testclient.TestClient apuntando a backend.main:app.

2. Fases de Ejecución

  1. Fase 1: Motor SQLAlchemy 2.0 Desacoplado: Implementar la capa nativa de base de datos en backend/database.py y actualizar backend/app/__init__.py.
  2. Fase 2: Retiro de app_context() en Routers y Servicios: Eliminar get_flask_app() y with flask_app.app_context(): de los routers de FastAPI.
  3. Fase 3: Eliminación de Código Muerto y Dependencias: Borrar carpetas app/routes/ y app/forms/. Actualizar requirements.txt, setup.py e install.sh.
  4. Fase 4: Adaptación de Tests y Verificación: Actualizar conftest.py y correr la suite completa de 57 tests.
  5. Fase 5: Despliegue y Validación en Producción: Bump de versión, commit, git push a dev y despliegue a LXC 10.0.0.217.