From 85fa1b389fe199c3c36c17575fc2ee78e24e6d0e Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Wed, 21 Oct 2026 10:07:25 -0300 Subject: [PATCH] fix: resolver tipos estaticos en modelos, importador y academic router (v3.8.4) --- CHANGELOG.md | 9 +++++++ MEMORY.md | 17 ++++++------- backend/app/__init__.py | 2 +- backend/app/models/career.py | 5 ++-- backend/app/models/subject.py | 4 ++-- backend/app/services/sheets_importer.py | 32 +++++++++++++++---------- backend/setup.py | 2 +- frontend/package.json | 2 +- frontend/src/app.js | 6 ++--- 9 files changed, 47 insertions(+), 32 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5728150..8987fd4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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)**: diff --git a/MEMORY.md b/MEMORY.md index 95c9385..83293f6 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -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. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 1a62b0b..43757af 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -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): diff --git a/backend/app/models/career.py b/backend/app/models/career.py index 69f3b38..907158a 100644 --- a/backend/app/models/career.py +++ b/backend/app/models/career.py @@ -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 } diff --git a/backend/app/models/subject.py b/backend/app/models/subject.py index 1c95c53..f7e06a0 100644 --- a/backend/app/models/subject.py +++ b/backend/app/models/subject.py @@ -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) diff --git a/backend/app/services/sheets_importer.py b/backend/app/services/sheets_importer.py index 0b60e49..21f2aac 100644 --- a/backend/app/services/sheets_importer.py +++ b/backend/app/services/sheets_importer.py @@ -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: diff --git a/backend/setup.py b/backend/setup.py index f8f6476..240c62e 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -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", diff --git a/frontend/package.json b/frontend/package.json index 5f6d6ef..84c5c61 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.3", + "version": "3.8.4", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 9e751aa..f7c871d 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -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);