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. - **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. - **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 ## [3.8.3] - 2026-10-19
### Added ### Added
- **Alcance Temporal Flexible en Importador de Bedelía (`/admin/import`) (Spec 005)**: - **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. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - 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. - 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)**: - **Sprint Activo: Cero Diagnósticos LSP y Tipado Estático — v3.8.4**:
- **Selector de Alcance Temporal en Bedelía (`/admin/import`)**: - **Resolución Rigurosa de Tipado en Modelos y Routers**:
- *Por Semanas*: Configuración de semanas a generar (1..30, defecto 16) con accesos rápidos (1, 4, 8, 16 sem). - `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`.
- *Rango de Fechas*: Selección cerrada `[date_from, date_to]` generando reservas para cada día lectivo dentro del intervalo. - `Career.to_dict()`: Conteo protegido con `isinstance(subs, (list, set, tuple))` satisfaciendo el protocolo `Sized`.
- *Fecha Puntual Única*: Switch e input para generar exactamente 1 reserva por fila en la fecha puntual deseada. - `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.
- *Validaciones Semánticas*: Alerta en frontend y respuesta `400 Bad Request` en backend si `date_from > date_to`. - **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`.
- **Resolución de Error Multi-Carrera (`_sa_instance_state`)**: - **Versión Consolidada**: `v3.8.4`.
- 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é) ## 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. - **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 database import db, get_db, engine, SessionLocal, session
from config.config import Config from config.config import Config
__version__ = "3.8.3" __version__ = "3.8.4"
class DummyContext: class DummyContext:
def __enter__(self): 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)) created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc).replace(tzinfo=None))
# Relationships # 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): def __init__(self, **kwargs):
super().__init__(**kwargs) super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
subs = getattr(self, 'subjects', None)
return { return {
'id': self.id, 'id': self.id,
'name': self.name, 'name': self.name,
'code': self.code, 'code': self.code,
'description': self.description, '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 '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)) 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 # Relationships
commissions: List['Commission'] = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan') commissions = 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)) careers = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True))
def __init__(self, **kwargs): def __init__(self, **kwargs):
super().__init__(**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'] dias_esp = ['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado', 'Domingo']
# Normalizar fecha manual si fue provista # Normalizar fecha manual si fue provista
manual_dt = None manual_dt: Optional[date] = None
if manual_date: if manual_date:
try: try:
if isinstance(manual_date, (datetime, date)): if isinstance(manual_date, datetime):
manual_dt = manual_date if isinstance(manual_date, date) else manual_date.date() manual_dt = manual_date.date()
elif isinstance(manual_date, date):
manual_dt = manual_date
elif isinstance(manual_date, str) and manual_date.strip(): elif isinstance(manual_date, str) and manual_date.strip():
manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date() manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date()
except Exception: except Exception:
pass pass
# Normalizar rango de fechas (date_from y date_to) # Normalizar rango de fechas (date_from y date_to)
date_from_dt = None date_from_dt: Optional[date] = None
if date_from: if date_from:
try: try:
if isinstance(date_from, (datetime, date)): if isinstance(date_from, datetime):
date_from_dt = date_from if isinstance(date_from, date) else date_from.date() 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(): elif isinstance(date_from, str) and date_from.strip():
date_from_dt = datetime.strptime(date_from.strip(), '%Y-%m-%d').date() date_from_dt = datetime.strptime(date_from.strip(), '%Y-%m-%d').date()
except Exception: except Exception:
pass pass
date_to_dt = None date_to_dt: Optional[date] = None
if date_to: if date_to:
try: try:
if isinstance(date_to, (datetime, date)): if isinstance(date_to, datetime):
date_to_dt = date_to if isinstance(date_to, date) else date_to.date() 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(): elif isinstance(date_to, str) and date_to.strip():
date_to_dt = datetime.strptime(date_to.strip(), '%Y-%m-%d').date() date_to_dt = datetime.strptime(date_to.strip(), '%Y-%m-%d').date()
except Exception: except Exception:
@@ -929,12 +935,14 @@ class GoogleSheetsImporter:
# Determinar fechas a generar: específica de la fila (datepicker), puntual o 16 semanas # Determinar fechas a generar: específica de la fila (datepicker), puntual o 16 semanas
dates_to_generate = [] dates_to_generate = []
row_specific_date = None row_specific_date: Optional[date] = None
raw_row_date = rec.get('date') or rec.get('inferred_date') raw_row_date = rec.get('date') or rec.get('inferred_date')
if raw_row_date: if raw_row_date:
try: try:
if isinstance(raw_row_date, (datetime, date)): if isinstance(raw_row_date, datetime):
row_specific_date = raw_row_date if isinstance(raw_row_date, date) else raw_row_date.date() 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(): elif isinstance(raw_row_date, str) and raw_row_date.strip():
row_specific_date = datetime.strptime(raw_row_date.strip(), '%Y-%m-%d').date() row_specific_date = datetime.strptime(raw_row_date.strip(), '%Y-%m-%d').date()
except Exception: except Exception:
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="3.8.3", version="3.8.4",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.8.3", "version": "3.8.4",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+3 -3
View File
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.8.3'; const APP_VERSION = '3.8.4';
const FRONTEND_VERSION = '3.8.3'; const FRONTEND_VERSION = '3.8.4';
const BACKEND_VERSION = '3.8.3'; const BACKEND_VERSION = '3.8.4';
env.addGlobal('app_version', APP_VERSION); env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);