fix: resolver tipos estaticos en modelos, importador y academic router (v3.8.4)

This commit is contained in:
2026-10-21 10:07:25 -03:00
parent c14ab0d49f
commit 85fa1b389f
9 changed files with 47 additions and 32 deletions
+7 -10
View File
@@ -9,16 +9,13 @@ 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: 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`.
- **Sprint Activo: Cero Diagnósticos LSP y Tipado Estático — v3.8.4**:
- **Resolución Rigurosa de Tipado en Modelos y Routers**:
- `Career.subjects` y `Subject.commissions` / `Subject.careers`: Retiradas las anotaciones de lista en relaciones que desorientaban a SQLAlchemy y Pyright, permitiendo inferir descriptores `InstrumentedAttribute` con soporte completo de `.any()` en queries de `academic.py`.
- `Career.to_dict()`: Conteo protegido con `isinstance(subs, (list, set, tuple))` satisfaciendo el protocolo `Sized`.
- `sheets_importer.py`: Normalizaciones de `manual_dt`, `date_from_dt`, `date_to_dt` y `row_specific_date` evaluando `datetime` previo a `date` (`isinstance(d, datetime)` antes de `isinstance(d, date)`), erradicando advertencias de comparación cruzada.
- **Suite de Pruebas Automatizadas**: 62 pruebas ejecutadas con pytest pasando al 100% (62 passed, 0 failed). Cero errores en código (`@[current_problems]`). Pyright `0 errors, 0 warnings`.
- **Versión Consolidada**: `v3.8.4`.
## 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.