3.5 KiB
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
SQLAlchemyWrapperenbackend/database.py(o enbackend/app/db.pyreexportado enapp/__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()ydrop_all()ejecutados directamente contraengine.
- En
backend/database.py, la dependencia FastAPIget_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 deflask_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 elscoped_sessionnativo de SQLAlchemy) o a la dependencia inyectadadb: 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: eliminarflaskde la verificación de dependencias.backend/requirements.txt: removerFlask,Flask-SQLAlchemy,Flask-Login,Flask-WTF,Flask-Migrate,Flask-CORS,Flask-Babel.backend/setup.py: remover las mismas dependencias deinstall_requires.backend/app/__init__.py: eliminar imports de Flask,request,session,Babel,Migrate,CORSy el registro de blueprints de Flask.
1.4. Actualización del Arnés de Tests (backend/tests/conftest.py)
- Modificar
conftest.pypara inicializar SQLAlchemy en memoria (sqlite:///:memory:) sin depender decreate_app()de Flask. - Los tests que hacían peticiones HTTP utilizarán
fastapi.testclient.TestClientapuntando abackend.main:app.
2. Fases de Ejecución
- Fase 1: Motor SQLAlchemy 2.0 Desacoplado:
Implementar la capa nativa de base de datos en
backend/database.pyy actualizarbackend/app/__init__.py. - Fase 2: Retiro de
app_context()en Routers y Servicios: Eliminarget_flask_app()ywith flask_app.app_context():de los routers de FastAPI. - Fase 3: Eliminación de Código Muerto y Dependencias:
Borrar carpetas
app/routes/yapp/forms/. Actualizarrequirements.txt,setup.pyeinstall.sh. - Fase 4: Adaptación de Tests y Verificación:
Actualizar
conftest.pyy correr la suite completa de 57 tests. - Fase 5: Despliegue y Validación en Producción:
Bump de versión, commit, git push a
devy despliegue a LXC10.0.0.217.