feat(migration): v3.8.0 - erradicacion total de flask, persistencia nativa sqlalchemy 2.0 y compatibilidad pura fastapi
This commit is contained in:
@@ -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`.
|
||||
Reference in New Issue
Block a user