# 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: ```python 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: ```python 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`.