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
+9
View File
@@ -11,6 +11,15 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.4] - 2026-10-21
### Fixed
- **Resolución Rigurosa de Tipado Estático y Cero Diagnósticos LSP (Principio 10)**:
- `backend/app/models/career.py`: Retirada anotación escalar restrictiva en `subjects` y securizado el conteo en `to_dict()` con verificación `isinstance(subs, (list, set, tuple))` satisfaciendo el protocolo `Sized`.
- `backend/app/models/subject.py`: Removidas anotaciones de lista en relaciones `commissions` y `careers`, permitiendo a SQLAlchemy 2.0 y Pyright inferir descriptores `InstrumentedAttribute` con métodos nativos (`.any()`).
- `backend/routers/academic.py`: Resueltos los accesos a `Subject.careers.any(...)` en filtros de asignaturas y comisiones.
- `backend/app/services/sheets_importer.py`: Corregidas las normalizaciones de `manual_dt`, `date_from_dt`, `date_to_dt` y `row_specific_date` evaluando `isinstance(d, datetime)` previo a `isinstance(d, date)` para eliminar incompatibilidad de comparación entre `date` y `datetime`.
- Verificados Pyright con `0 errors, 0 warnings, 0 informations` y 62 tests automatizados pasando al 100%.
## [3.8.3] - 2026-10-19
### Added
- **Alcance Temporal Flexible en Importador de Bedelía (`/admin/import`) (Spec 005)**:
+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.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session
from config.config import Config
__version__ = "3.8.3"
__version__ = "3.8.4"
class DummyContext:
def __enter__(self):
+3 -2
View File
@@ -16,18 +16,19 @@ class Career(db.Model):
created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc).replace(tzinfo=None))
# Relationships
subjects: List['Subject'] = db.relationship('Subject', backref='career_obj', lazy=True)
subjects = db.relationship('Subject', backref='career_obj', lazy=True)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self):
subs = getattr(self, 'subjects', None)
return {
'id': self.id,
'name': self.name,
'code': self.code,
'description': self.description,
'subjects_count': len(self.subjects) if self.subjects else 0,
'subjects_count': len(subs) if isinstance(subs, (list, set, tuple)) else 0,
'created_at': self.created_at.isoformat() if self.created_at else None
}
+2 -2
View File
@@ -32,8 +32,8 @@ class Subject(db.Model):
updated_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc).replace(tzinfo=None), onupdate=lambda: datetime.now(timezone.utc).replace(tzinfo=None))
# Relationships
commissions: List['Commission'] = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan')
careers: List['Career'] = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True))
commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan')
careers = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True))
def __init__(self, **kwargs):
super().__init__(**kwargs)
+20 -12
View File
@@ -557,32 +557,38 @@ class GoogleSheetsImporter:
dias_esp = ['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado', 'Domingo']
# Normalizar fecha manual si fue provista
manual_dt = None
manual_dt: Optional[date] = None
if manual_date:
try:
if isinstance(manual_date, (datetime, date)):
manual_dt = manual_date if isinstance(manual_date, date) else manual_date.date()
if isinstance(manual_date, datetime):
manual_dt = manual_date.date()
elif isinstance(manual_date, date):
manual_dt = manual_date
elif isinstance(manual_date, str) and manual_date.strip():
manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date()
except Exception:
pass
# Normalizar rango de fechas (date_from y date_to)
date_from_dt = None
date_from_dt: Optional[date] = None
if date_from:
try:
if isinstance(date_from, (datetime, date)):
date_from_dt = date_from if isinstance(date_from, date) else date_from.date()
if isinstance(date_from, datetime):
date_from_dt = date_from.date()
elif isinstance(date_from, date):
date_from_dt = date_from
elif isinstance(date_from, str) and date_from.strip():
date_from_dt = datetime.strptime(date_from.strip(), '%Y-%m-%d').date()
except Exception:
pass
date_to_dt = None
date_to_dt: Optional[date] = None
if date_to:
try:
if isinstance(date_to, (datetime, date)):
date_to_dt = date_to if isinstance(date_to, date) else date_to.date()
if isinstance(date_to, datetime):
date_to_dt = date_to.date()
elif isinstance(date_to, date):
date_to_dt = date_to
elif isinstance(date_to, str) and date_to.strip():
date_to_dt = datetime.strptime(date_to.strip(), '%Y-%m-%d').date()
except Exception:
@@ -929,12 +935,14 @@ class GoogleSheetsImporter:
# Determinar fechas a generar: específica de la fila (datepicker), puntual o 16 semanas
dates_to_generate = []
row_specific_date = None
row_specific_date: Optional[date] = None
raw_row_date = rec.get('date') or rec.get('inferred_date')
if raw_row_date:
try:
if isinstance(raw_row_date, (datetime, date)):
row_specific_date = raw_row_date if isinstance(raw_row_date, date) else raw_row_date.date()
if isinstance(raw_row_date, datetime):
row_specific_date = raw_row_date.date()
elif isinstance(raw_row_date, date):
row_specific_date = raw_row_date
elif isinstance(raw_row_date, str) and raw_row_date.strip():
row_specific_date = datetime.strptime(raw_row_date.strip(), '%Y-%m-%d').date()
except Exception:
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.8.3",
version="3.8.4",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.3",
"version": "3.8.4",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
const APP_VERSION = '3.8.3';
const FRONTEND_VERSION = '3.8.3';
const BACKEND_VERSION = '3.8.3';
const APP_VERSION = '3.8.4';
const FRONTEND_VERSION = '3.8.4';
const BACKEND_VERSION = '3.8.4';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);