feat(migration): v3.8.0 - erradicacion total de flask, persistencia nativa sqlalchemy 2.0 y compatibilidad pura fastapi

This commit is contained in:
2026-10-19 15:49:50 -03:00
parent ae071d7f72
commit 5ed62d5d30
56 changed files with 3706 additions and 12756 deletions
+61
View File
@@ -0,0 +1,61 @@
# 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`.