feat: alcance temporal configurable en importador y fix multi-carrera en ORM (v3.8.3)

This commit is contained in:
2026-10-19 17:27:36 -03:00
parent 4dd3e30698
commit c14ab0d49f
17 changed files with 682 additions and 39 deletions
+10 -16
View File
@@ -9,22 +9,16 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Erradicación Total de Flask y Persistencia Nativa FastAPI / SQLAlchemy 2.0 — v3.8.2 (Spec 004)**:
- **Erradicación Absoluta de Flask**:
- Eliminados de raíz los directorios residuales `backend/app/routes/` y `backend/app/forms/`.
- Eliminadas dependencias obsoletas en `requirements.txt` y `setup.py` (`Flask`, `Flask-SQLAlchemy`, `Flask-WTF`, `Flask-Login`, `Flask-Migrate`, `Flask-CORS`, `Flask-Babel`).
- Poda de wrappers `with flask_app.app_context():` y reemplazo por sesión nativa de SQLAlchemy 2.0.
- **Capa de Persistencia y Compatibilidad Nativa**:
- `backend/database.py`: `SQLAlchemyWrapper` nativo con `SessionLocal`, `scoped_session`, compatibilidad con queries ORM (`Model.query.get(...)`), inyección de metadata en `db.Table` y auto-registro en `db.create_all()`.
- `backend/app/__init__.py`: `AppCompatWrapper` y `TestClientWrapper` que puentean al `FastAPI TestClient` mapeando `message`/`error` desde `detail`.
- `backend/app/services/dashboard_service.py`: Servicio desacoplado para analíticas y Google Sheets sin referencias a Flask; resueltos tipos en `setdefault`.
- **Inicialización Limpia y Cuentas de Test**:
- `backend/init_db.py` depurado para registrar únicamente roles, permisos y las cuentas institucionales de test (`admin@edu-space.com`, `bedelia@edu-space.com`, `docente@edu-space.com`, `alumno@edu-space.com`), dejando las tablas académicas limpias sin materias ficticias.
- **Resolución Rigurosa de Tipado y Cero Diagnósticos (Principio 10)**:
- Pyright configurado con `0 errors, 0 warnings, 0 informations` en todo el proyecto.
- Limpieza de métodos auxiliares en `backend/app/models/setting.py`, tipado en `backend/init_db.py`, servicios y routers.
- **Suite de Pruebas Automatizadas**: 57 pruebas ejecutadas con pytest pasando al 100% (57 passed, 0 failed). Cero errores en código (`@[current_problems]`).
- **Versión Consolidada**: `v3.8.2`.
- **Sprint Activo: Alcance Temporal en Importador y Fix Multi-Carrera — v3.8.3 (Spec 005)**:
- **Selector de Alcance Temporal en Bedelía (`/admin/import`)**:
- *Por Semanas*: Configuración de semanas a generar (1..30, defecto 16) con accesos rápidos (1, 4, 8, 16 sem).
- *Rango de Fechas*: Selección cerrada `[date_from, date_to]` generando reservas para cada día lectivo dentro del intervalo.
- *Fecha Puntual Única*: Switch e input para generar exactamente 1 reserva por fila en la fecha puntual deseada.
- *Validaciones Semánticas*: Alerta en frontend y respuesta `400 Bad Request` en backend si `date_from > date_to`.
- **Resolución de Error Multi-Carrera (`_sa_instance_state`)**:
- En `Subject` y `Career`, anotado explícitamente `List['Career']` y `List['Subject']` con `uselist=True`, solventando la incompatibilidad de SQLAlchemy 2.0 que interpretaba la relación como escalar y fallaba con `'list' object has no attribute '_sa_instance_state'` al importar filas complejas como `ASIG00125`.
- **Suite de Pruebas Automatizadas**: 61 pruebas ejecutadas con pytest pasando al 100% (61 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`.
- **Versión Consolidada**: `v3.8.3`.
## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.