diff --git a/CHANGELOG.md b/CHANGELOG.md index 121276e..5728150 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,18 @@ 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.3] - 2026-10-19 +### Added +- **Alcance Temporal Flexible en Importador de Bedelía (`/admin/import`) (Spec 005)**: + - **Por Semanas**: Input numérico para elegir el número exacto de semanas a generar (1 a 30, defecto 16) con botones de acceso rápido (1 semana, 4 semanas, 8 semanas, 16 semanas cuatrimestre regular). + - **Por Rango de Fechas (Desde - Hasta)**: Datepickers para acotar la generación de reservas estrictamente dentro de un período cerrado `[date_from, date_to]`, calculando los días de cursada correspondientes. + - **Fecha Puntual Única**: Opción para crear exactamente 1 sola asignación por fila en la fecha puntual seleccionada. + - **Validación Semántica de Rango**: Bloqueo con código `400 Bad Request` en backend y alerta en UI si `date_from > date_to`. + +### Fixed +- **Error en Materias Multi-Carrera (`_sa_instance_state`)**: + - `backend/app/models/subject.py` y `backend/app/models/career.py`: Tipado explícito `List['Career']` y `List['Subject']` con `uselist=True` en la relación Many-to-Many `subject_careers`, resolviendo la excepción `'list' object has no attribute '_sa_instance_state'` al importar filas complejas (ej. `ASIG00125`). + ## [3.8.2] - 2026-10-19 ### Changed - **Depuración de Inicialización Limpia de Base de Datos**: diff --git a/MEMORY.md b/MEMORY.md index 2c88795..95c9385 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -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. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index cb2586a..1a62b0b 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.2" +__version__ = "3.8.3" class DummyContext: def __enter__(self): diff --git a/backend/app/models/career.py b/backend/app/models/career.py index 36cc138..69f3b38 100644 --- a/backend/app/models/career.py +++ b/backend/app/models/career.py @@ -16,7 +16,7 @@ class Career(db.Model): created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc).replace(tzinfo=None)) # Relationships - subjects: Any = db.relationship('Subject', backref='career_obj', lazy=True) + subjects: List['Subject'] = db.relationship('Subject', backref='career_obj', lazy=True) def __init__(self, **kwargs): super().__init__(**kwargs) diff --git a/backend/app/models/subject.py b/backend/app/models/subject.py index 1d446b9..1c95c53 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: Any = db.relationship('Commission', backref='subject', lazy=True, uselist=True, cascade='all, delete-orphan') - careers: Any = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True)) + 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)) def __init__(self, **kwargs): super().__init__(**kwargs) diff --git a/backend/app/services/dashboard_service.py b/backend/app/services/dashboard_service.py index 91d1700..874f226 100644 --- a/backend/app/services/dashboard_service.py +++ b/backend/app/services/dashboard_service.py @@ -626,6 +626,9 @@ class DashboardService: filter_days = data.get('filter_days') manual_date = data.get('manual_date') single_date_only = bool(data.get('single_date_only', False)) + weeks_to_generate = data.get('weeks_to_generate', 16) + date_from = data.get('date_from') + date_to = data.get('date_to') custom_url = data.get('sheets_url') or data.get('base_url') import_careers = data.get('import_careers', True) @@ -646,6 +649,9 @@ class DashboardService: filter_days=filter_days, manual_date=manual_date, single_date_only=single_date_only, + weeks_to_generate=weeks_to_generate, + date_from=date_from, + date_to=date_to, import_careers=import_careers, import_subjects=import_subjects, import_commissions=import_commissions, @@ -666,7 +672,10 @@ class DashboardService: 'filter_day': filter_day, 'filter_days': filter_days, 'single_date_only': single_date_only, - 'manual_date': manual_date + 'manual_date': manual_date, + 'weeks_to_generate': weeks_to_generate, + 'date_from': date_from, + 'date_to': date_to }, status='success' ) diff --git a/backend/app/services/sheets_importer.py b/backend/app/services/sheets_importer.py index 3422028..0b60e49 100644 --- a/backend/app/services/sheets_importer.py +++ b/backend/app/services/sheets_importer.py @@ -518,15 +518,35 @@ class GoogleSheetsImporter: 'preview_rows': preview_rows } - def sync(self, filter_career=None, filter_subject=None, filter_day=None, filter_days=None, manual_date=None, single_date_only=False, import_careers=True, import_subjects=True, import_commissions=True, import_classrooms=True, import_reservations=True, selected_rows=None): + def sync( + self, + filter_career=None, + filter_subject=None, + filter_day=None, + filter_days=None, + manual_date=None, + single_date_only=False, + weeks_to_generate=16, + date_from=None, + date_to=None, + import_careers=True, + import_subjects=True, + import_commissions=True, + import_classrooms=True, + import_reservations=True, + selected_rows=None + ): """ - Proceso principal de sincronización con soporte de filtros, entidades granulares y filas seleccionadas: + Proceso principal de sincronización con soporte de filtros, entidades granulares y alcance temporal: :param filter_career: Filtrar por carrera específica (ej. 'DATOS (CCC)') :param filter_subject: Filtrar por código o nombre de materia (ej. 'ASIG00113') :param filter_day: Filtrar por día específico ('Lunes'..'Sábado' o 'ALL') :param filter_days: Lista o cadena de días específicos (ej. ['Lunes', 'Martes']) :param manual_date: Fecha manual específica (YYYY-MM-DD o objeto date) :param single_date_only: Si es True y hay manual_date, crea reserva solo para esa fecha puntual + :param weeks_to_generate: Número de semanas consecutivas a generar (1..30, defecto 16) + :param date_from: Fecha de inicio de rango (YYYY-MM-DD) + :param date_to: Fecha de fin de rango (YYYY-MM-DD) :param import_careers: Booleano para importar/crear carreras :param import_subjects: Booleano para importar/crear asignaturas :param import_commissions: Booleano para importar/crear comisiones @@ -547,6 +567,38 @@ class GoogleSheetsImporter: except Exception: pass + # Normalizar rango de fechas (date_from y date_to) + date_from_dt = 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() + 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 + if date_to: + try: + if isinstance(date_to, (datetime, date)): + date_to_dt = date_to if isinstance(date_to, date) else date_to.date() + elif isinstance(date_to, str) and date_to.strip(): + date_to_dt = datetime.strptime(date_to.strip(), '%Y-%m-%d').date() + except Exception: + pass + + if date_from_dt and date_to_dt and date_from_dt > date_to_dt: + date_from_dt, date_to_dt = date_to_dt, date_from_dt + + # Normalizar número de semanas a generar + num_weeks = 16 + if weeks_to_generate is not None: + try: + num_weeks = max(1, min(30, int(weeks_to_generate))) + except (ValueError, TypeError): + num_weeks = 16 + # Normalizar días permitidos allowed_days = None if filter_days: @@ -585,6 +637,10 @@ class GoogleSheetsImporter: 'days': allowed_days or ['Todos los Días'], 'manual_date': manual_dt.strftime('%Y-%m-%d') if manual_dt else None, 'single_date_only': bool(single_date_only and manual_dt), + 'weeks_to_generate': num_weeks, + 'date_from': date_from_dt.strftime('%Y-%m-%d') if date_from_dt else None, + 'date_to': date_to_dt.strftime('%Y-%m-%d') if date_to_dt else None, + 'temporal_scope': 'single_date' if (single_date_only and manual_dt) else ('date_range' if (date_from_dt and date_to_dt) else 'weeks'), 'entities': { 'careers': bool(import_careers), 'subjects': bool(import_subjects), @@ -674,11 +730,13 @@ class GoogleSheetsImporter: classrooms_cache = {(c.building.strip().upper(), c.code.strip().upper()): c for c in Classroom.query.all()} subjects_cache = {s.code.strip().upper(): s for s in Subject.query.all()} - # Calculate semester dates (anchored on academic year 2026 or manual date base) + # Calculate semester dates (anchored on academic year 2026, manual date, or date_from) base_monday = date(2026, 8, 31) if manual_dt and not single_date_only: base_monday = manual_dt - timedelta(days=manual_dt.weekday()) - weeks_to_generate = 16 # Generar reservas para 16 semanas + elif date_from_dt: + base_monday = date_from_dt - timedelta(days=date_from_dt.weekday()) + weeks_to_generate = num_weeks for rec, day_idx in all_raw_records: try: @@ -886,8 +944,17 @@ class GoogleSheetsImporter: dates_to_generate = [row_specific_date] elif single_date_only and manual_dt: dates_to_generate = [manual_dt] + elif date_from_dt and date_to_dt: + # Rango de fechas: calcular todos los días correspondientes a effective_day_idx entre date_from_dt y date_to_dt + days_ahead = (effective_day_idx - date_from_dt.weekday()) % 7 + first_date = date_from_dt + timedelta(days=days_ahead) + dates_to_generate = [] + cur = first_date + while cur <= date_to_dt: + dates_to_generate.append(cur) + cur += timedelta(days=7) else: - dates_to_generate = [base_monday + timedelta(days=effective_day_idx, weeks=w) for w in range(weeks_to_generate)] + dates_to_generate = [base_monday + timedelta(days=effective_day_idx, weeks=w) for w in range(num_weeks)] for class_date in dates_to_generate: dt_start = datetime.combine(class_date, t_start) @@ -944,6 +1011,8 @@ class GoogleSheetsImporter: }) except Exception as row_err: + import traceback + traceback.print_exc() stats['errors'].append(f"Error en fila '{rec.get('codigo', '?')}': {str(row_err)}") db.session.commit() diff --git a/backend/routers/dashboard.py b/backend/routers/dashboard.py index 8460dd1..a19bac3 100644 --- a/backend/routers/dashboard.py +++ b/backend/routers/dashboard.py @@ -27,6 +27,14 @@ def sync_google_sheets( current_user: User = Depends(get_current_user) ): """Ejecuta la sincronización con Google Sheets con filtros y selección granular.""" + date_from = payload.get('date_from') + date_to = payload.get('date_to') + if date_from and date_to and str(date_from).strip() > str(date_to).strip(): + raise HTTPException( + status_code=status.HTTP_400_BAD_REQUEST, + detail="La fecha de inicio (date_from) no puede ser posterior a la fecha de fin (date_to)." + ) + try: ip = request.client.host if request.client else '127.0.0.1' return dashboard_service.sync_google_sheets(payload, current_user=current_user, ip_address=ip) diff --git a/backend/setup.py b/backend/setup.py index 41a7bdf..f8f6476 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.2", + version="3.8.3", 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/backend/tests/test_sheets_import_temporal_scope.py b/backend/tests/test_sheets_import_temporal_scope.py new file mode 100644 index 0000000..8aeeed1 --- /dev/null +++ b/backend/tests/test_sheets_import_temporal_scope.py @@ -0,0 +1,152 @@ +import pytest +from datetime import date, datetime, timedelta +from app import db +from app.models.career import Career +from app.models.classroom import Classroom +from app.models.subject import Subject, Commission +from app.models.reservation import Reservation +from app.models.building import Building +from app.models.user import User +from app.services.sheets_importer import GoogleSheetsImporter + +def _ensure_seed(): + admin = User.query.filter_by(email='admin@edu-space.com').first() + if not admin: + admin = User(email='admin@edu-space.com', name='Admin', role='ADMIN', is_active=True) + admin.set_password('admin123') + db.session.add(admin) + b = Building.query.filter_by(name='Edificio Central').first() + if not b: + b = Building(name='Edificio Central', code='CENTRAL', floors=4) + db.session.add(b) + db.session.flush() + c = Classroom.query.filter_by(code='101').first() + if not c: + c = Classroom(code='101', building='Edificio Central', building_id=b.id, floor='1', capacity=35, is_active=True) + db.session.add(c) + db.session.commit() + +def test_sync_single_date_only_creates_one_reservation(init_database, app_context): + _ensure_seed() + importer = GoogleSheetsImporter() + row = { + 'dia': 'Lunes', + 'codigo': 'TEST-001', + 'asignatura': 'Materia Test Puntual', + 'aula': '101', + 'carrera': 'DATOS (CCC)', + 'horario': '08:00 a 10:00hs', + 'turno': 'Mañana' + } + manual_dt_str = '2026-10-19' + stats = importer.sync( + selected_rows=[row], + manual_date=manual_dt_str, + single_date_only=True + ) + assert len(stats['errors']) == 0 + assert stats['reservations_created'] == 1 + + res_list = Reservation.query.filter(Reservation.purpose.like('%TEST-001%')).all() + assert len(res_list) == 1 + assert res_list[0].start_time.date() == date(2026, 10, 19) + +def test_sync_custom_weeks_creates_n_reservations(init_database, app_context): + _ensure_seed() + importer = GoogleSheetsImporter() + row = { + 'dia': 'Martes', + 'codigo': 'TEST-002', + 'asignatura': 'Materia Test Semanas', + 'aula': '101', + 'carrera': 'DATOS (CCC)', + 'horario': '10:00 a 12:00hs', + 'turno': 'Mañana' + } + stats = importer.sync( + selected_rows=[row], + weeks_to_generate=4, + single_date_only=False + ) + assert len(stats['errors']) == 0 + assert stats['reservations_created'] == 4 + + res_list = Reservation.query.filter(Reservation.purpose.like('%TEST-002%')).order_by(Reservation.start_time.asc()).all() + assert len(res_list) == 4 + # Verify 7-day delta between consecutive reservations + for i in range(len(res_list) - 1): + delta = res_list[i+1].start_time.date() - res_list[i].start_time.date() + assert delta == timedelta(days=7) + +def test_sync_date_range_creates_reservations_within_interval(init_database, app_context): + _ensure_seed() + importer = GoogleSheetsImporter() + # Miércoles en octubre 2026: 7, 14, 21, 28 + row = { + 'dia': 'Miércoles', + 'codigo': 'TEST-003', + 'asignatura': 'Materia Test Rango', + 'aula': '101', + 'carrera': 'DATOS (CCC)', + 'horario': '14:00 a 16:00hs', + 'turno': 'Tarde' + } + # Intervalo del 10 al 25 de octubre -> debe incluir 14 y 21 de octubre (2 miércoles) + stats = importer.sync( + selected_rows=[row], + date_from='2026-10-10', + date_to='2026-10-25' + ) + assert len(stats['errors']) == 0 + assert stats['reservations_created'] == 2 + + res_list = Reservation.query.filter(Reservation.purpose.like('%TEST-003%')).order_by(Reservation.start_time.asc()).all() + assert len(res_list) == 2 + dates = [r.start_time.date() for r in res_list] + assert dates == [date(2026, 10, 14), date(2026, 10, 21)] + +def test_sync_multi_career_assignment_without_sa_instance_state_error(init_database, app_context): + _ensure_seed() + importer = GoogleSheetsImporter() + row = { + 'dia': 'Jueves', + 'codigo': 'ASIG00125', + 'asignatura': 'Taller: Emprendedurismo en innovación digital', + 'aula': '101', + 'carrera': 'DATOS (CCC) - TEC. DIG (CCC) - VIDEOJUEGOS (CCC)', + 'horario': '18:30 a 21:30hs', + 'turno': 'Tarde' + } + stats = importer.sync(selected_rows=[row], weeks_to_generate=1) + assert len(stats['errors']) == 0 + + subj = Subject.query.filter_by(code='ASIG00125').first() + assert subj is not None + assert len(subj.careers) == 3 + c_names = [c.name for c in subj.careers] + assert 'DATOS (CCC)' in c_names + assert 'TEC. DIG. (CCC)' in c_names or 'TEC. DIG (CCC)' in c_names + assert 'VIDEOJUEGOS (CCC)' in c_names + +def test_sync_sheets_api_date_from_greater_than_date_to_returns_400(init_database, app_context): + from fastapi.testclient import TestClient + from main import app as fastapi_app + from app.services.jwt_service import JWTService + _ensure_seed() + + admin = User.query.filter_by(role='ADMIN').first() + assert admin is not None + token = JWTService.create_access_token(user=admin) + + client = TestClient(fastapi_app) + response = client.post( + '/api/v1/dashboard/sync-sheets', + json={ + 'date_from': '2026-10-25', + 'date_to': '2026-10-10' + }, + headers={'Authorization': f'Bearer {token}'} + ) + assert response.status_code == 400 + assert 'La fecha de inicio (date_from) no puede ser posterior a la fecha de fin (date_to).' in response.json()['detail'] + diff --git a/frontend/package.json b/frontend/package.json index 61e8fe5..5f6d6ef 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.2", + "version": "3.8.3", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 411803d..9e751aa 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.2'; -const FRONTEND_VERSION = '3.8.2'; -const BACKEND_VERSION = '3.8.2'; +const APP_VERSION = '3.8.3'; +const FRONTEND_VERSION = '3.8.3'; +const BACKEND_VERSION = '3.8.3'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/src/routes/admin.js b/frontend/src/routes/admin.js index 0ce50e8..8200270 100644 --- a/frontend/src/routes/admin.js +++ b/frontend/src/routes/admin.js @@ -98,6 +98,11 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => { if (req.body.single_date_only === 'true' || req.body.single_date_only === true || req.body.single_date_only === 'on') { syncPayload.single_date_only = true; } + if (req.body.weeks_to_generate) { + syncPayload.weeks_to_generate = parseInt(req.body.weeks_to_generate, 10); + } + if (req.body.date_from) syncPayload.date_from = req.body.date_from.trim(); + if (req.body.date_to) syncPayload.date_to = req.body.date_to.trim(); // Toggles granulares de entidades syncPayload.import_careers = req.body.import_careers === 'true' || req.body.import_careers === true || req.body.import_careers === 'on'; syncPayload.import_subjects = req.body.import_subjects === 'true' || req.body.import_subjects === true || req.body.import_subjects === 'on'; @@ -164,6 +169,9 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => { filter_days: req.body?.filter_days || ['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado'], manual_date: req.body?.manual_date || '', single_date_only: req.body?.single_date_only === 'true' || req.body?.single_date_only === 'on', + weeks_to_generate: req.body?.weeks_to_generate || 16, + date_from: req.body?.date_from || '', + date_to: req.body?.date_to || '', flash_msg: flashMsg, flash_type: flashType }); diff --git a/frontend/views/admin/import.html b/frontend/views/admin/import.html index 2bde095..1d8ab99 100644 --- a/frontend/views/admin/import.html +++ b/frontend/views/admin/import.html @@ -310,15 +310,127 @@ + +
+
+
+
+ + Elija el número de semanas a importar, un rango de fechas (Desde - Hasta) o importe para una fecha puntual. +
+
+ + + + + + + + +
+
+ + +
+
+
+ +
+ + + semanas +
+
+
+ +
+ + + + +
+
+
+
+ Genera $N$ clases consecutivas para el día de cursada a partir de la fecha base de cuatrimestre o la fecha manual sugerida. +
+
+ + +
+
+
+ + +
+
+ + +
+
+ +
+
+
+ El sistema calcula automáticamente todos los días de cursada correspondientes a cada comisión dentro del intervalo cerrado [Desde, Hasta]. +
+
+ + +
+
+
+
+ + +
+ + Crea exactamente 1 sola asignación por fila en lugar del cuatrimestre regular (16 semanas). + +
+
+ + +
+
+
+
+
+
-
- - - Crea 1 sola asignación por fila en lugar del cuatrimestre regular (16 semanas). +
+ + {% if single_date_only %} + Alcance: 1 sola asignación puntual {{ '(' + manual_date + ')' if manual_date else '' }} + {% elif date_from and date_to %} + Alcance: Rango {{ date_from }} a {{ date_to }} + {% else %} + Alcance: {{ weeks_to_generate or 16 }} semanas regulares + {% endif %} +
Generación: - - {{ 'Fecha puntual única (1 asignación)' if stats.filters_applied.single_date_only else 'Cuatrimestre regular (16 semanas)' }} + + {% if stats.filters_applied.temporal_scope == 'single_date' or stats.filters_applied.single_date_only %} + Fecha puntual única (1 asignación) + {% elif stats.filters_applied.temporal_scope == 'date_range' %} + Rango de fechas ({{ stats.filters_applied.date_from }} al {{ stats.filters_applied.date_to }}) + {% else %} + Semanas regulares ({{ stats.filters_applied.weeks_to_generate or 16 }} semanas) + {% endif %}
@@ -849,6 +967,15 @@ if (m) m.value = ''; const single = document.getElementById('single_date_only'); if (single) single.checked = false; + const df = document.getElementById('date_from'); + if (df) df.value = ''; + const dt = document.getElementById('date_to'); + if (dt) dt.value = ''; + const w = document.getElementById('weeks_to_generate'); + if (w) w.value = 16; + const radWeeks = document.getElementById('mode_weeks'); + if (radWeeks) radWeeks.checked = true; + if (typeof onTemporalModeChange === 'function') onTemporalModeChange('weeks'); setDaysSelection('all'); } @@ -1186,6 +1313,89 @@ alert('Se aplicó la fecha ' + val + ' a ' + updatedCount + ' fila(s) seleccionada(s).'); } + // Gestión de Alcance Temporal (Por Semanas, Rango de Fechas, Fecha Puntual) + function onTemporalModeChange(mode) { + const pWeeks = document.getElementById('panel_temporal_weeks'); + const pRange = document.getElementById('panel_temporal_range'); + const pSingle = document.getElementById('panel_temporal_single'); + const chkSingle = document.getElementById('single_date_only'); + const badge = document.getElementById('temporalSummaryBadge'); + + if (pWeeks) pWeeks.classList.add('d-none'); + if (pRange) pRange.classList.add('d-none'); + if (pSingle) pSingle.classList.add('d-none'); + + if (mode === 'weeks') { + if (pWeeks) pWeeks.classList.remove('d-none'); + if (chkSingle) chkSingle.checked = false; + const w = document.getElementById('weeks_to_generate')?.value || 16; + if (badge) badge.innerHTML = 'Alcance: ' + w + ' semanas regulares'; + } else if (mode === 'range') { + if (pRange) pRange.classList.remove('d-none'); + if (chkSingle) chkSingle.checked = false; + const df = document.getElementById('date_from')?.value; + const dt = document.getElementById('date_to')?.value; + if (badge) badge.innerHTML = 'Alcance: Rango ' + (df && dt ? (df + ' a ' + dt) : 'personalizado'); + } else if (mode === 'single') { + if (pSingle) pSingle.classList.remove('d-none'); + if (chkSingle) chkSingle.checked = true; + const mDate = document.getElementById('manual_date')?.value; + const sDate = document.getElementById('single_punctual_date'); + if (sDate && mDate) sDate.value = mDate; + if (badge) badge.innerHTML = 'Alcance: 1 sola asignación puntual' + (mDate ? ' (' + mDate + ')' : ''); + } + } + + function setWeeksValue(val) { + const input = document.getElementById('weeks_to_generate'); + if (input) { + input.value = val; + const badge = document.getElementById('temporalSummaryBadge'); + if (badge) badge.innerHTML = 'Alcance: ' + val + ' semanas regulares'; + } + } + + function onWeeksInputChange(val) { + const badge = document.getElementById('temporalSummaryBadge'); + if (badge) badge.innerHTML = 'Alcance: ' + (val || 16) + ' semanas regulares'; + } + + function onRangeInputChange() { + const df = document.getElementById('date_from')?.value; + const dt = document.getElementById('date_to')?.value; + const badge = document.getElementById('temporalSummaryBadge'); + if (badge) badge.innerHTML = 'Alcance: Rango ' + (df && dt ? (df + ' a ' + dt) : 'personalizado'); + } + + function clearDateRange() { + const df = document.getElementById('date_from'); + const dt = document.getElementById('date_to'); + if (df) df.value = ''; + if (dt) dt.value = ''; + const badge = document.getElementById('temporalSummaryBadge'); + if (badge) badge.innerHTML = 'Alcance: Rango personalizado'; + } + + function onSingleDateSwitchChange() { + const chk = document.getElementById('single_date_only'); + const badge = document.getElementById('temporalSummaryBadge'); + if (chk && !chk.checked) { + const radWeeks = document.getElementById('mode_weeks'); + if (radWeeks) radWeeks.checked = true; + onTemporalModeChange('weeks'); + } else { + const mDate = document.getElementById('manual_date')?.value; + if (badge) badge.innerHTML = 'Alcance: 1 sola asignación puntual' + (mDate ? ' (' + mDate + ')' : ''); + } + } + + function syncSingleDateToManualDate(val) { + const mDate = document.getElementById('manual_date'); + if (mDate) mDate.value = val; + const badge = document.getElementById('temporalSummaryBadge'); + if (badge) badge.innerHTML = 'Alcance: 1 sola asignación puntual' + (val ? ' (' + val + ')' : ''); + } + // Modal de Confirmación de Sincronización function openSyncConfirmModal() { const hasInspected = (window.inspectedRows && window.inspectedRows.length > 0); @@ -1196,6 +1406,15 @@ return; } + // Validación de Rango de Fechas + const modeRange = document.getElementById('mode_range')?.checked; + const dateFrom = document.getElementById('date_from')?.value; + const dateTo = document.getElementById('date_to')?.value; + if (modeRange && dateFrom && dateTo && dateFrom > dateTo) { + alert('Error: La fecha de inicio (Desde: ' + dateFrom + ') no puede ser posterior a la fecha de fin (Hasta: ' + dateTo + ').'); + return; + } + // Resumen de entidades marcadas const chkRes = document.getElementById('chk_import_reservations')?.checked; const chkCls = document.getElementById('chk_import_classrooms')?.checked; @@ -1212,6 +1431,19 @@ html += '
  • Sincronización completa de las pestañas de días seleccionadas.
  • '; } + // Resumen de alcance temporal + const chkSingle = document.getElementById('single_date_only')?.checked; + const weeks = document.getElementById('weeks_to_generate')?.value || 16; + const manualDate = document.getElementById('manual_date')?.value; + + if (chkSingle) { + html += '
  • Alcance Temporal: 1 sola asignación puntual' + (manualDate ? ' (' + manualDate + ')' : '') + '
  • '; + } else if (dateFrom && dateTo) { + html += '
  • Alcance Temporal: Rango de fechas del ' + dateFrom + ' al ' + dateTo + '
  • '; + } else { + html += '
  • Alcance Temporal: ' + weeks + ' semanas consecutivas
  • '; + } + html += '
  • Entidades a crear / sincronizar:
  • '; if (chkRes) html += '
  • Asignaciones de aulas (Reservas en Calendario)
  • '; if (chkCls) html += '
  • Aulas físicas y virtuales
  • '; diff --git a/specs/005-importador-semanas-rango/plan.md b/specs/005-importador-semanas-rango/plan.md new file mode 100644 index 0000000..258e4ef --- /dev/null +++ b/specs/005-importador-semanas-rango/plan.md @@ -0,0 +1,71 @@ +# Plan Técnico: 005-importador-semanas-rango + +## 1. Arquitectura y Componentes Afectados + +### 1.1. Backend Core (`backend/`) +- **`app/models/subject.py` & `app/models/career.py`**: + - Garantizar `uselist=True` en `Subject.careers` y `Career.subjects` con anotaciones de lista explícitas (`List['Career']`, `List['Subject']`). *(Ya aplicado y verificado)*. +- **`app/services/sheets_importer.py`**: + - Ampliar firma de `sync(...)`: + ```python + def sync( + self, + filter_career=None, + filter_subject=None, + filter_day=None, + filter_days=None, + manual_date=None, + single_date_only=False, + weeks_to_generate=16, + date_from=None, + date_to=None, + import_careers=True, + import_subjects=True, + import_commissions=True, + import_classrooms=True, + import_reservations=True, + selected_rows=None + ): + ``` + - Lógica de cálculo de fechas por fila (`dates_to_generate`): + 1. Si `row_specific_date` está presente en la fila: `[row_specific_date]`. + 2. Si `single_date_only` y `manual_dt`: `[manual_dt]`. + 3. Si `date_from_dt` y `date_to_dt`: + Calcular todas las fechas $d$ en el intervalo $[date\_from\_dt, date\_to\_dt]$ tales que $d.weekday() == effective\_day\_idx$. + 4. En otro caso (por número de semanas): + Tomar $W = \max(1, \min(30, int(weeks\_to\_generate or 16)))$. + Generar $[base\_monday + timedelta(days=effective\_day\_idx, weeks=w) \text{ para } w \in [0..W-1]]$. +- **`app/services/dashboard_service.py`**: + - En `sync_sheets_data(data)`: + Extraer `weeks_to_generate`, `date_from`, `date_to` del payload y enviarlos al importador. + Reflejar `temporal_mode`, `weeks_to_generate`, `date_from`, `date_to` en las estadísticas retornadas (`stats['filters_applied']`). +- **`routers/admin.py`**: + - Validar los parámetros opcionales en el endpoint `/api/v1/admin/sync-sheets`. + +### 1.2. Frontend BFF (`frontend/`) +- **`src/routes/admin.js`**: + - Propagar `weeks_to_generate`, `date_from`, `date_to`, `single_date_only`, `manual_date`, `time_scope_mode` en el payload de sincronización hacia el backend Core. +- **`views/admin/import.html`**: + - Incorporar selector de modalidad temporal mediante controles visuales Bootstrap 5: + - **Modo 1: Por Semanas**: Input numérico para $N$ semanas con badges de selección rápida (1 sem, 4 sem, 8 sem, 16 sem). + - **Modo 2: Rango de Fechas**: Dos campos `date_from` (Desde) y `date_to` (Hasta). + - **Modo 3: Fecha Puntual Única**: `single_date_only` activado con campo de fecha única puntual. + - Sincronización reactiva en JavaScript: al cambiar de modo, se habilitan o deshabilitan los inputs correspondientes y se actualiza el resumen del modal de confirmación. + +--- + +## 2. Estrategia de Pruebas (Test-First) +- Crear `backend/tests/test_sheets_import_temporal_scope.py`: + 1. `test_sync_single_date_only_creates_one_reservation()` + 2. `test_sync_custom_weeks_count_creates_n_reservations()` + 3. `test_sync_date_range_creates_reservations_within_range()` + 4. `test_sync_multi_career_assignment_without_sa_instance_state_error()` +- Ejecución completa con `pytest tests -v` (61 tests esperados pasando). + +--- + +## 3. Despliegue y Validación +- Bump a `v3.8.3`. +- Actualizar `CHANGELOG.md` y `MEMORY.md`. +- `git push origin dev` y despliegue SSH a `10.0.0.217`. +- Smoke test HTTP 200 en `/version` y verificación visual en `/admin/import`. diff --git a/specs/005-importador-semanas-rango/spec.md b/specs/005-importador-semanas-rango/spec.md new file mode 100644 index 0000000..788e534 --- /dev/null +++ b/specs/005-importador-semanas-rango/spec.md @@ -0,0 +1,41 @@ +# Espec: 005-importador-semanas-rango - Selección de Semanas, Rango de Fechas y Fecha Puntual en Importador + +## 1. Visión General y Propósito +El importador de Google Sheets oficial de Bedelía actualmente generaba de manera rígida 16 semanas (cuatrimestre completo) o 1 sola asignación cuando se marcaba la opción de fecha puntual. +Bedelía requiere flexibilidad operativa total para poder: +1. **Elegir el número exacto de semanas a importar** (ej. 1, 2, 4, 8, 12, 16 semanas). +2. **Definir un rango de fechas explícito ("Desde" y "Hasta")** para importar reservas que caigan dentro de un período o corte de calendario específico. +3. **Importar ÚNICAMENTE para fecha puntual** (1 sola asignación por fila). +4. Resolver el error de asignación de carreras múltiples en asignaturas (`'list' object has no attribute '_sa_instance_state'`). + +--- + +## 2. Requisitos en Sintaxis EARS (Español Estricto) + +### 2.1. Estrategias Temporales de Importación +- **RF-01 (Ubicuo)**: EL SISTEMA dispondrá en la interfaz de Bedelía (`/admin/import`) de tres modos de alcance temporal para la generación de reservas: + 1. *Número de Semanas*: Permite ingresar un entero positivo (por defecto 16). + 2. *Rango de Fechas (Desde - Hasta)*: Permite ingresar fecha de inicio (`date_from`) y fecha de fin (`date_to`). + 3. *Fecha Puntual Única*: Crea 1 sola asignación por fila en la fecha especificada (`manual_date`). +- **RF-02 (Basado en Eventos)**: CUANDO el usuario elija el modo por número de semanas y defina $N$ semanas, EL SISTEMA generará reservas para las primeras $N$ semanas a partir de la fecha base del cuatrimestre o la fecha sugerida. +- **RF-03 (Basado en Eventos)**: CUANDO el usuario elija el modo por rango de fechas (`date_from` y `date_to`), EL SISTEMA calculará todas las fechas que correspondan al día de la semana de cada comisión dentro del intervalo cerrado `[date_from, date_to]` y generará las reservas correspondientes. +- **RF-04 (Basado en Eventos)**: CUANDO el usuario active "Importar ÚNICAMENTE para fecha puntual" (`single_date_only`), EL SISTEMA creará exactamente 1 reserva por fila en la fecha puntual designada. +- **RF-05 (No Deseado / Excepciones)**: SI el usuario ingresa un rango de fechas donde `date_from > date_to`, ENTONCES EL SISTEMA bloqueará la sincronización y mostrará una alerta indicando que la fecha inicial no puede ser posterior a la fecha final. +- **RF-06 (No Deseado / Excepciones)**: SI el número de semanas configurado es menor a 1 o superior a 30, ENTONCES EL SISTEMA limitará automáticamente el valor a los extremos válidos (1 a 30 semanas). + +### 2.2. Robustez del Modelo de Asignaturas y Carreras +- **RF-07 (Ubicuo)**: EL SISTEMA preservará la relación Many-to-Many entre `Subject` y `Career` configurada con colección explícita (`uselist=True`), garantizando que la importación de asignaturas multi-carrera (ej. `ASIG00125`) asigne la lista de carreras sin arrojar excepciones de tipo `'list' object has no attribute '_sa_instance_state'`. + +--- + +## 3. Criterios de Aceptación y Finalización (DoD) +1. Selector interactivo en la vista `/admin/import` con opciones claras: "Cuatrimestre / Por Semanas", "Rango de Fechas (Desde - Hasta)" y "Fecha Puntual Única". +2. Endpoint `/api/v1/admin/sync-sheets` y servicio `GoogleSheetsImporter.sync()` procesando `weeks_to_generate`, `date_from`, `date_to`, `manual_date` y `single_date_only`. +3. Pruebas unitarias y de integración que verifiquen: + - Importación con 4 semanas generando exactamente 4 reservas. + - Importación con rango de fechas generando las fechas intermedias exactas. + - Importación con fecha puntual generando 1 sola reserva. + - Importación de materias multi-carrera sin errores de estado en SQLAlchemy. +4. Cero errores en `@[current_problems]` y Pyright (`0 errors, 0 warnings`). +5. Suite de tests automatizados al 100% aprobada. +6. Despliegue en producción institucional verificado en `https://eduspace.oemspot.com.ar`. diff --git a/specs/005-importador-semanas-rango/tasks.md b/specs/005-importador-semanas-rango/tasks.md new file mode 100644 index 0000000..83e42b0 --- /dev/null +++ b/specs/005-importador-semanas-rango/tasks.md @@ -0,0 +1,47 @@ +# Tareas de Implementación: 005-importador-semanas-rango + +- [x] **Tarea 1: Pruebas Automatizadas (Test-First)** + - Archivo: `backend/tests/test_sheets_import_temporal_scope.py` + - Contenido: + - Test de importación con `single_date_only=True` (1 asignación por fila). + - Test de importación con `weeks_to_generate=4` (4 asignaciones consecutivas). + - Test de importación con rango `date_from` y `date_to` (asignaciones estrictamente dentro del rango). + - Test de importación de materia con múltiples carreras (`ASIG00125` o similar) sin errores de `_sa_instance_state`. + - Hecho cuando: Los tests reflejen la especificación y fallen o validen según corresponda. + +- [x] **Tarea 2: Backend Core - Servicio `sheets_importer.py`** + - Archivos: `backend/app/services/sheets_importer.py` + - Contenido: + - Agregar parámetros `weeks_to_generate`, `date_from`, `date_to` a `sync(...)`. + - Implementar parser y normalización de fechas `date_from` y `date_to`. + - Generar fechas correspondientes al día lectivo dentro del intervalo o por cantidad de semanas. + - Exponer en `stats['filters_applied']` la configuración temporal seleccionada. + - Hecho cuando: `sheets_importer.py` genere las fechas precisas según el modo indicado. + +- [x] **Tarea 3: Backend Core - Servicio y Routers** + - Archivos: `backend/app/services/dashboard_service.py`, `backend/routers/admin.py` + - Contenido: + - Extraer parámetros temporales en `sync_sheets_data(data)` y pasarlos a `importer.sync(...)`. + - Validar en router que si se envía `date_from` y `date_to`, `date_from <= date_to`. + - Hecho cuando: El endpoint `/api/v1/admin/sync-sheets` acepte y aplique los parámetros temporales. + +- [x] **Tarea 4: Frontend BFF e Interfaz de Usuario** + - Archivos: `frontend/src/routes/admin.js`, `frontend/views/admin/import.html` + - Contenido: + - Diseñar bloque de configuración temporal en `import.html` con 3 opciones claras: + 1. Por Semanas (Input numérico + badges rápidos: 1, 4, 8, 16 semanas). + 2. Rango de Fechas (Campos Desde y Hasta con datepickers). + 3. Fecha Puntual Única (Switch `single_date_only` + campo de fecha puntual). + - Manejar la interacción JavaScript para alternar visibilidad o habilitación de campos según la opción elegida. + - Actualizar modal de confirmación mostrando el resumen temporal. + - Adaptar `admin.js` para recibir y enviar los campos en el payload JSON. + - Hecho cuando: Bedelía pueda elegir visualmente semanas, rango o fecha puntual y ver el resultado exacto en el resumen. + +- [x] **Tarea 5: Verificación Integral, Cero Diagnósticos y Despliegue** + - Contenido: + - Ejecutar suite completa `pytest tests -v` (100% aprobada). + - Verificar `npx pyright` con 0 errores y 0 advertencias. + - Incrementar versión semántica a `v3.8.3` en backend y frontend. + - Actualizar `CHANGELOG.md` y `MEMORY.md`. + - `git push origin dev` y despliegue SSH a `10.0.0.217` con reinicio de servicios y smoke test HTTP 200 en `/version`. + - Hecho cuando: El servidor de producción esté corriendo `v3.8.3` activo y verificado.