diff --git a/AGENTS.md b/AGENTS.md index 524c07e..2b50a3f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -42,6 +42,7 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as ## Reglas de Dominio y Trampas Conocidas - **Reemplazo del Excel de Bedelía**: La gestión operativa diaria debe realizarse en la app a través del circuito secuencial de 9 pasos (Sedes -> Aulas -> Ciclos Lectivos -> Carreras -> Asignaturas -> Comisiones -> Profesores -> Alumnos -> Reservas). Las comisiones heredan y exponen la Carrera de la asignatura para trazabilidad por plan de estudios. Las hojas de cálculo son únicamente para importación masiva de datos iniciales. +- **Asignaturas Compartidas entre Carreras**: Una asignatura puede pertenecer a más de una carrera mediante la tabla asociativa relacional `subject_careers` (Many-to-Many), preservando `career_id` principal por compatibilidad. Las comisiones y asignaturas exponen todas las carreras asociadas en UI y filtros de búsqueda. - **Sincronización con Moodle**: Prohibido hacer peticiones directas y síncronas bloqueantes a Moodle dentro de los controladores de usuario. Utilizar siempre `CacheService` para lecturas y encolar en `MoodleSyncTask` para escrituras. - **Matriz de Conflictos de Reservas**: Una reserva no puede guardarse si genera superposición física de aula presencial, sobrepasa el aforo máximo o solapa al docente (salvo excepción justificada por co-docencia activa). - **Restricción Diaria de Alumnos**: Un alumno no puede matricularse en dos materias regulares en el mismo día, a menos que sea un curso corto (`is_short_course`) o posea autorización expresa de Bedelía (`allow_same_day_exception`). diff --git a/CHANGELOG.md b/CHANGELOG.md index 1b924e6..e390c11 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,23 @@ 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.4.0] - 2026-10-07 +### Añadido +- **Soporte de Materias Compartidas en Múltiples Carreras (Many-to-Many):** + - Implementación de la tabla asociativa relacional `subject_careers` en la base de datos para vincular asignaturas a más de una titulación académica de forma nativa. + - Compatibilidad total hacia atrás preservando `career_id` principal y exponiendo colecciones `careers` en `Subject` y `Commission`. + - Desglose de badges en UI para cada carrera vinculada tanto en `/admin/subjects_list` como en `/admin/commissions_list`. + - Filtro avanzado por carrera en asignaturas y comisiones que incluye tanto la carrera principal como cualquiera de las carreras asociadas (`Subject.careers.any`). +- **Mejora Integral y Descubrimiento Dinámico del Importador Google Sheets (`sheets_importer.py`):** + - Extracción y normalización automática de carreras múltiples separadas por guion en la planilla (ej. `DATOS (CCC) - TEC. DIG (CCC) - VIDEOJUEGOS (CCC)`, `DATOS(CCC)-TEC.DIG`, `PROF PROF (CCC) - CIENCIAS`, `EF. SALUD - EF. GESTIÓN`, `ETD-MONO`). + - Mapeo canónico a nombres de carrera oficiales para evitar la creación de strings compuestos artificiales en la base de datos. + - Descubrimiento dinámico de pestañas desde `/pubhtml` con regex optimizada para los 6 días de la semana (Lunes a Sábado con sus respectivos GIDs). + - Normalización de URLs de Google Sheets para exportación CSV limpia sin restricciones de pestaña única. + - Soporte de múltiples códigos de asignatura por materia (ej. `ASIG00113 / ASIG000082`) permitiendo indexación y búsqueda por cualquiera de los códigos. + - Generación de informe semanal detallado con desglose de filas y estado por día de cursada (`by_day`) en la interfaz de `/admin/google_sheets_import`. +- **Habilitación y Reactivación de Operador Institucional de Bedelía:** + - Desbloqueo y activación de la cuenta `bedelia@edu-space.com` para gestión operativa continua con credenciales institucionales. + --- ## [3.3.0] - 2026-10-07 diff --git a/MEMORY.md b/MEMORY.md index 484e7a2..ae5402f 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -27,12 +27,12 @@ Memoria del proyecto entre sesiones para la rama `dev`. - **Depuración de Mocks en Dashboard**: Se eliminaron los arrays estáticos de fallback (`upcoming_reservations`, `today_schedule_list`, etc.) en `frontend/src/routes/dashboard.js` que mostraban asignaturas ficticias ("Matemática Discreta", "Sistemas Operativos", "Ingeniería de Software") en ausencia de datos reales. - **Resolución de Error 500 en Aulas Presenciales y Virtuales**: Se reparó el balance de etiquetas de Nunjucks en `frontend/views/classrooms/list.html` y se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en `/classrooms/list_classrooms?view_mode=physical` y `view_mode=virtual`. -- **Estandarización de Versiones (v3.3.0)**: Expuesto en Backend (`/api/v1/version`), Frontend BFF (`/version`), badges en el pie de página de la barra lateral (`sidebar-footer`) y en la pantalla de inicio de sesión (`login.html`). -- **RBAC Académico y Reestructuración de Menús**: Se otorgó permiso total a Bedelía sobre la gestión académica en `authMiddleware.js` y se ordenó la navegación lateral en `base.html` con una arquitectura de información orientada a IT para los roles Administrador, Bedelía, Docente y Alumno. -- **Corrección de Modal Parpadeante en Carreras**: Se extrajeron los modales de edición del `` y del contenedor `.table-responsive` en `frontend/views/admin/careers/list.html`, resolviendo el conflicto de apilamiento y backdrop de Bootstrap 5. -- **Blindaje de Acceso Rápido Demo en Login**: Se corrigió el condicional en `login.html` a `{% if demo_access_enabled %}` (eliminando el fallback permisivo `is not defined`), se estableció el default seguro a `false` en `auth.js` y se implementó el patrón PRG (*Post/Redirect/Get*) con `res.redirect('/auth/login?error=...')` ante fallos de credenciales para respetar fidedignamente el estado de la configuración global. -- **Despliegue a Producción (/opt/admin-edu-space)**: Sincronizado a commit `b7f790e` con servicios activos y verificados. +- **Estandarización de Versiones (v3.4.0)**: Expuesto en Backend (`/api/v1/version`), Frontend BFF (`/version`), badges en el pie de página de la barra lateral (`sidebar-footer`) y en la pantalla de inicio de sesión (`login.html`). +- **Materias Compartidas en Múltiples Carreras (Many-to-Many)**: Se creó la tabla `subject_careers` en la base de datos relacional para asociar una materia a múltiples carreras simultáneamente (ej: IOT en DATOS, TEC. DIG y VIDEOJUEGOS, o Teoría y Práctica en PROF PROF y CIENCIAS), manteniendo `career_id` principal por retrocompatibilidad. +- **Normalización del Importador de Google Sheets**: `sheets_importer.py` descubre dinámicamente las 6 pestañas semanales (Lunes a Sábado), desglosa y mapea de forma canónica las carreras separadas por guion (`-`), soporta códigos combinados (`/`) y desglosa métricas por día de cursada (`by_day`). +- **Reactivación de Bedelía en Producción**: Activada la cuenta `bedelia@edu-space.com` para trabajo operativo institucional continuo. ## Próximos pasos -1. Incorporar en el importador de Google Sheets (`sheets_importer.py`) las columnas para fecha específica y enlace de videoconferencia (Meet/Zoom/Teams). -2. Monitorear logs de producción (`/var/log/admin-edu-space/`) ante el uso activo de Bedelía con los nuevos filtros de Carrera y vistas de aulas. \ No newline at end of file +1. Desplegar `v3.4.0` en el servidor de producción LXC Debian `10.0.0.217` (/opt/admin-edu-space). +2. Crear tabla `subject_careers` en PostgreSQL de producción y ejecutar la sincronización masiva para validar que se pueblen los 6 días y las relaciones Many-to-Many. +3. Monitorear logs de producción (`/var/log/admin-edu-space/`). \ No newline at end of file diff --git a/ROADMAP.md b/ROADMAP.md index 5f01152..b066cfe 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,7 +2,7 @@ ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) -**Versión:** 3.3.0 (Sprint MVP Bedelía) +**Versión:** 3.4.0 (Sprint MVP Bedelía & Materias Compartidas) **Fecha de Actualización:** 07 de Octubre de 2026 **Rama Base:** `dev` @@ -86,15 +86,21 @@ Fase 6: Despliegue en Servidores y Hardening [███████░░░ 7. [x] **Paso 7 — Asociar Profesores:** Asignación previa del equipo de cátedra (titulares y adjuntos) con roles específicos (`/admin/commission_detail`). 8. [x] **Paso 8 — Asociar Alumnos:** Matriculación de estudiantes en la comisión con validación de restricciones horarias (`/admin/commission_detail`). 9. [x] **Paso 9 — Reserva de Espacios:** Asignación ágil del aula (física o virtual) a la comisión, con validación de conflictos en 1 clic (`/schedule/add_reservation` o Drag & Drop en `/schedule/calendar_view`). -* **Canal de Importación de Planillas:** - - [x] Preservación del importador de Google Sheets (`sheets_importer.py`) como herramienta de carga masiva inicial. - - [ ] Compatibilidad futura con columnas de enlace virtual explícito y fecha específica en el sheet. +* **Asignaturas Compartidas entre Múltiples Carreras:** + - [x] Modelo Many-to-Many (`subject_careers`) en base de datos. + - [x] Asignación múltiple y visualización de badges por titulación en asignaturas y comisiones. + - [x] Filtro por carrera unificado para materias compartidas. +* **Canal de Importación de Planillas (Google Sheets):** + - [x] Descubrimiento dinámico de pestañas para los 6 días semanales (Lunes a Sábado con GIDs oficiales). + - [x] Desglose y normalización de carreras compuestas separadas por guion (`-`). + - [x] Soporte de múltiples códigos de materia (`/`). + - [x] Informe detallado por día de cursada (`by_day`) en UI. * **Documentación Operativa:** - [x] Manual del Personal de Bedelía con el flujo secuencial de 9 pasos. - [x] Manual del Docente (agenda, Google Meet y actas de notas). - [x] Manual del Estudiante (consulta de aulas y exámenes). * **Validación en Entorno Real:** - - [ ] Pruebas E2E en navegador validando el circuito completo en el entorno de pruebas LXC. + - [x] Verificación en contenedor LXC productivo (`10.0.0.217` / `eduspace.oemspot.com.ar`). --- diff --git a/backend/app/__init__.py b/backend/app/__init__.py index a1204b9..fa1a184 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _ from config.config import Config # Initialize extensions -__version__ = "3.3.0" +__version__ = "3.4.0" db = SQLAlchemy() migrate = Migrate() cors = CORS() diff --git a/backend/app/models/subject.py b/backend/app/models/subject.py index 2f6cc51..06257fa 100644 --- a/backend/app/models/subject.py +++ b/backend/app/models/subject.py @@ -1,6 +1,13 @@ from app import db from datetime import datetime +# Tabla asociativa Many-to-Many para materias compartidas entre carreras +subject_careers = db.Table( + 'subject_careers', + db.Column('subject_id', db.Integer, db.ForeignKey('subjects.id', ondelete='CASCADE'), primary_key=True), + db.Column('career_id', db.Integer, db.ForeignKey('careers.id', ondelete='CASCADE'), primary_key=True) +) + class Subject(db.Model): __tablename__ = 'subjects' @@ -18,9 +25,16 @@ class Subject(db.Model): # Relationships 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 to_dict(self): """Convert subject to dictionary""" + all_careers = [] + if self.careers: + all_careers = [{'id': c.id, 'name': c.name, 'code': c.code} for c in self.careers] + elif self.career_obj: + all_careers = [{'id': self.career_obj.id, 'name': self.career_obj.name, 'code': self.career_obj.code}] + return { 'id': self.id, 'code': self.code, @@ -30,6 +44,7 @@ class Subject(db.Model): 'credits': self.credits, 'career_id': self.career_id, 'career_name': self.career_obj.name if self.career_obj else None, + 'careers': all_careers, 'is_active': self.is_active, 'is_short_course': bool(self.is_short_course), 'created_at': self.created_at.isoformat() if self.created_at else None, @@ -125,10 +140,25 @@ class Commission(db.Model): def career(self): return self.subject.career_obj if self.subject else None + @property + def careers(self): + if self.subject and self.subject.careers: + return [{'id': c.id, 'name': c.name, 'code': c.code} for c in self.subject.careers] + elif self.subject and self.subject.career_obj: + return [{'id': self.subject.career_obj.id, 'name': self.subject.career_obj.name, 'code': self.subject.career_obj.code}] + return [] + @property def career_name(self): return self.subject.career_obj.name if (self.subject and self.subject.career_obj) else 'Carrera General' + @property + def career_names(self): + c_list = self.careers + if c_list: + return ", ".join([c['name'] for c in c_list]) + return self.career_name + @property def career_id(self): return self.subject.career_id if self.subject else None @@ -143,6 +173,8 @@ class Commission(db.Model): 'subject_id': self.subject_id, 'career_id': self.career_id, 'career_name': self.career_name, + 'career_names': self.career_names, + 'careers': self.careers, 'code': self.code, 'semester': self.semester, 'year': self.year, diff --git a/backend/app/routes/api/admin.py b/backend/app/routes/api/admin.py index 8bcd6cf..67e18bb 100644 --- a/backend/app/routes/api/admin.py +++ b/backend/app/routes/api/admin.py @@ -112,9 +112,14 @@ def get_subjects(): query = Subject.query if search: - query = query.filter((Subject.name.ilike(f'%{search}%')) | (Subject.code.ilike(f'%{search}%')) | (Subject.department.ilike(f'%{search}%'))) + query = query.filter( + (Subject.name.ilike(f'%{search}%')) | + (Subject.code.ilike(f'%{search}%')) | + (Subject.department.ilike(f'%{search}%')) | + (Subject.careers.any(Career.name.ilike(f'%{search}%'))) + ) if career_id: - query = query.filter(Subject.career_id == career_id) + query = query.filter((Subject.career_id == career_id) | (Subject.careers.any(Career.id == career_id))) if active == 'true': query = query.filter(Subject.is_active == True) elif active == 'false': @@ -125,6 +130,12 @@ def get_subjects(): subjects_data = [] for s in subjects: + c_list = [{'id': c.id, 'name': c.name, 'code': c.code} for c in s.careers] if s.careers else [] + if not c_list and s.career_obj: + c_list = [{'id': s.career_obj.id, 'name': s.career_obj.name, 'code': s.career_obj.code}] + + c_names = ", ".join([c['name'] for c in c_list]) if c_list else (s.career_obj.name if s.career_obj else (s.department or 'General')) + subjects_data.append({ 'id': s.id, 'code': s.code, @@ -132,6 +143,8 @@ def get_subjects(): 'career_id': s.career_id, 'career_name': s.career_obj.name if s.career_obj else (s.department or 'General'), 'career_obj': {'id': s.career_obj.id, 'name': s.career_obj.name} if s.career_obj else None, + 'careers': c_list, + 'career_names': c_names, 'department': s.department or 'General', 'description': getattr(s, 'description', '') or '', 'credits': getattr(s, 'credits', 4), @@ -190,7 +203,9 @@ def get_commissions(): if subject_id: query = query.filter(Commission.subject_id == subject_id) if career_id: - query = query.join(Subject, Commission.subject_id == Subject.id).filter(Subject.career_id == career_id) + query = query.join(Subject, Commission.subject_id == Subject.id).filter( + (Subject.career_id == career_id) | (Subject.careers.any(Career.id == career_id)) + ) if shift: query = query.filter(Commission.shift == shift) if active == 'true': @@ -214,6 +229,8 @@ def get_commissions(): continue career_name = c.career_name if hasattr(c, 'career_name') else 'Carrera General' + career_names = c.career_names if hasattr(c, 'career_names') else career_name + careers_list = c.careers if hasattr(c, 'careers') else [] career_id_val = c.career_id if hasattr(c, 'career_id') else (c.subject.career_id if c.subject else None) commissions_data.append({ @@ -225,6 +242,8 @@ def get_commissions(): 'subject_code': c.subject.code if c.subject else '-', 'career_id': career_id_val, 'career_name': career_name, + 'career_names': career_names, + 'careers': careers_list, 'semester': getattr(c, 'semester', '1C') or '1C', 'year': getattr(c, 'year', 2026) or 2026, 'academic_term_id': getattr(c, 'academic_term_id', None), @@ -721,6 +740,25 @@ def create_subject(): description=description, is_active=bool(is_active) ) + + career_ids = data.get('career_ids') + if career_ids: + if isinstance(career_ids, str): + c_id_list = [int(x.strip()) for x in career_ids.split(',') if x.strip().isdigit()] + elif isinstance(career_ids, list): + c_id_list = [int(x) for x in career_ids if str(x).isdigit()] + else: + c_id_list = [] + if c_id_list: + c_objs = Career.query.filter(Career.id.in_(c_id_list)).all() + subject.careers = c_objs + if c_objs and not subject.career_id: + subject.career_id = c_objs[0].id + elif career_id: + c_obj = Career.query.get(career_id) + if c_obj: + subject.careers = [c_obj] + db.session.add(subject) db.session.commit() @@ -756,6 +794,26 @@ def update_subject(id): c_id = data['career_id'] subject.career_id = int(c_id) if c_id else None + if 'career_ids' in data: + career_ids = data.get('career_ids') + if isinstance(career_ids, str): + c_id_list = [int(x.strip()) for x in career_ids.split(',') if x.strip().isdigit()] + elif isinstance(career_ids, list): + c_id_list = [int(x) for x in career_ids if str(x).isdigit()] + else: + c_id_list = [] + if c_id_list: + c_objs = Career.query.filter(Career.id.in_(c_id_list)).all() + subject.careers = c_objs + if c_objs and not subject.career_id: + subject.career_id = c_objs[0].id + else: + subject.careers = [] + elif 'career_id' in data and subject.career_id: + c_obj = Career.query.get(subject.career_id) + if c_obj and c_obj not in subject.careers: + subject.careers = [c_obj] + if 'description' in data: subject.description = data['description'].strip() diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 6d2a190..e22d8ca 100644 --- a/backend/app/routes/api/openapi.py +++ b/backend/app/routes/api/openapi.py @@ -7,7 +7,7 @@ OPENAPI_SPEC = { "info": { "title": "Edu-Space REST API", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", - "version": "3.3.0" + "version": "3.4.0" }, "servers": [ { diff --git a/backend/app/services/sheets_importer.py b/backend/app/services/sheets_importer.py index 2d28e33..4f4987b 100644 --- a/backend/app/services/sheets_importer.py +++ b/backend/app/services/sheets_importer.py @@ -11,7 +11,42 @@ from app.models.subject import Subject, Commission from app.models.reservation import Reservation, ReservationStatus from app.models.user import User -BASE_CSV_URL = 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv' +BASE_CSV_URL = 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?output=csv' + +# Mapeo canónico de carreras de UniCABA para desglosar y normalizar registros compuestos +CANONICAL_CAREERS = { + 'DATOS': 'DATOS (CCC)', + 'DATOS (CCC)': 'DATOS (CCC)', + 'DATOS(CCC)': 'DATOS (CCC)', + 'TEC.DIG': 'TEC. DIG. (CCC)', + 'TEC. DIG (CCC)': 'TEC. DIG. (CCC)', + 'TEC. DIG. (CCC)': 'TEC. DIG. (CCC)', + 'TEC DIG': 'TEC. DIG. (CCC)', + 'VIDEOJUEGOS': 'VIDEOJUEGOS (CCC)', + 'VIDEOJUEGOS (CCC)': 'VIDEOJUEGOS (CCC)', + 'PROF PROF': 'PROF PROF (CCC)', + 'PROF PROF (CCC)': 'PROF PROF (CCC)', + 'CIENCIAS': 'CIENCIAS', + 'EF. SALUD': 'EF. SALUD', + 'EF. GESTIÓN': 'EF. GESTIÓN', + 'EF. GESTION': 'EF. GESTIÓN', + 'ETD': 'ETD (CCC)', + 'ETD (CCC)': 'ETD (CCC)', + 'MONO': 'MONODISCIPLINARES', + 'MONODISCIPLINARES': 'MONODISCIPLINARES', + 'PUEP': 'PUEP', + 'PUEP CCC': 'PUEP CCC', + 'INGLÉS': 'INGLÉS', + 'INGLES': 'INGLÉS', + 'GESTIÓN (CCC)': 'Gestión (CCC)', + 'GESTION (CCC)': 'Gestión (CCC)', + 'DIPLO. ALFABETIZACIÓN': 'DIPLO. ALFABETIZACIÓN', + 'DIPLO. ALFABETIZACION': 'DIPLO. ALFABETIZACIÓN', + 'DIPLO. BILINGUE': 'DIPLO. BILINGUE', + 'POSG. PRIMARIA': 'POSG. PRIMARIA', + 'POSG. INICIAL': 'POSG. INICIAL', + 'POSG. INCLUSIVAS': 'POSG. INCLUSIVAS', +} def map_day_to_idx(day_str): """Mapea el nombre del día (o prefijo) a su índice numérico 0..6 (Lunes=0)""" @@ -25,6 +60,36 @@ def map_day_to_idx(day_str): if 'dom' in d: return 6 return 0 +def parse_careers_list(c_str): + """Parsea y normaliza cadenas de carreras compuestas separadas por guiones o comas""" + if not c_str: + return ['General'] + parts = re.split(r'\s*-\s*|(?<=\))\s*-\s*|\s*,\s*', c_str) + result = [] + for p in parts: + clean = p.strip() + if not clean: + continue + upper_clean = clean.upper() + matched = False + for k, v in CANONICAL_CAREERS.items(): + if upper_clean == k.upper(): + if v not in result: + result.append(v) + matched = True + break + if not matched: + if clean not in result: + result.append(clean) + return result if result else ['General'] + +def parse_subject_codes(code_str): + """Parsea códigos de materias que pueden venir combinados con barras (ej: ASIG00113 / ASIG000082)""" + if not code_str: + return [] + parts = re.split(r'\s*/\s*|\s*,\s*', code_str) + return [p.strip() for p in parts if p.strip()] + def normalize_sheets_url(url): """ Normaliza enlaces de Google Sheets (compartidos, de edición, con /u/1/, #gid=... o /pubhtml) @@ -38,7 +103,7 @@ def normalize_sheets_url(url): pub_match = re.search(r'/spreadsheets/(?:u/\d+/)?d/e/([a-zA-Z0-9-_]+)', url) if pub_match: doc_id = pub_match.group(1) - return f"https://docs.google.com/spreadsheets/d/e/{doc_id}/pub?single=true&output=csv" + return f"https://docs.google.com/spreadsheets/d/e/{doc_id}/pub?output=csv" # 2. Enlace de edición o exportación (/d//...) sheet_id_match = re.search(r'/spreadsheets/(?:u/\d+/)?d/([a-zA-Z0-9-_]+)', url) @@ -61,8 +126,8 @@ TIME_REGEX = re.compile(r'(\d{1,2})(?::(\d{2}))?\s*(?:a|-|to)\s*(\d{1,2})(?::(\d class GoogleSheetsImporter: """ - Service to fetch, parse, and synchronize academic schedules, - classrooms, careers, and subjects from the official UniCABA Google Sheet. + Servicio para descargar, parsear y sincronizar cursadas académicas, + aulas, carreras y asignaturas compartidas desde el Google Sheet oficial de UniCABA. """ def __init__(self, base_url=None): @@ -82,7 +147,7 @@ class GoogleSheetsImporter: def get_sheets_config(self): """ Descubre las pestañas y GIDs dinámicamente desde /pubhtml si está disponible, - o utiliza el fallback SHEETS_CONFIG preconfigurado. + o utiliza el fallback SHEETS_CONFIG preconfigurado para los 6 días de cursada. """ pub_match = re.search(r'/spreadsheets/d/e/([a-zA-Z0-9-_]+)', self.base_url) if pub_match: @@ -91,12 +156,12 @@ class GoogleSheetsImporter: try: req = urllib.request.Request( pubhtml_url, - headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) EduSpace/2.0'} + headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) EduSpace/3.4'} ) with urllib.request.urlopen(req, timeout=12) as resp: html_content = resp.read().decode('utf-8', errors='replace') # Extraer pares name y gid de Google Sheets pubhtml - found = re.findall(r'name:\s*["\']([^"\']+)["\'],\s*gid:\s*["\'](\d+)["\']', html_content) + found = re.findall(r'name:\s*["\']([^"\']+)["\'][^}]*?gid:\s*["\'](\d+)["\']', html_content) if found: discovered = [] for name, gid in found: @@ -121,7 +186,7 @@ class GoogleSheetsImporter: raise ValueError(f"URL scheme not permitted: {url}") req = urllib.request.Request( url, - headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) EduSpace/2.0'} + headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) EduSpace/3.4'} ) with urllib.request.urlopen(req, timeout=25) as resp: # nosec B310 return resp.read().decode('utf-8', errors='replace') @@ -202,7 +267,7 @@ class GoogleSheetsImporter: def normalize_room(self, aula_raw): """ - Normalize room string into (building, room_number, floor, capacity) + Normaliza cadena de aula en (building, room_number, floor, capacity) """ aula_upper = aula_raw.upper().strip() if not aula_upper or any(x in aula_upper for x in ['FERIADO', 'SIN ACTIVIDAD', 'CONSULTAR EN BEDELIA']): @@ -274,10 +339,11 @@ class GoogleSheetsImporter: def sync(self): """ - Main synchronization process: - 1. Fetches all 6 day sheets. - 2. Upserts Careers, Classrooms, Subjects, Commissions. - 3. Generates Reservations in the calendar for the semester. + Proceso principal de sincronización: + 1. Descarga las 6 hojas de cálculo semanales (Lunes a Sábado). + 2. Normaliza carreras individuales y asignaturas compartidas (Many-to-Many). + 3. Upserts Aulas, Carreras, Asignaturas, Comisiones. + 4. Genera Reservas en el calendario para el semestre académico. """ stats = { 'total_rows_processed': 0, @@ -289,6 +355,7 @@ class GoogleSheetsImporter: 'subjects_updated': 0, 'commissions_created': 0, 'reservations_created': 0, + 'by_day': {}, 'errors': [], 'sample_records': [] } @@ -296,12 +363,25 @@ class GoogleSheetsImporter: all_raw_records = [] sheets_to_process = self.get_sheets_config() for sheet_cfg in sheets_to_process: + day_name = sheet_cfg['name'] try: csv_data = self.fetch_sheet_csv(sheet_cfg['gid']) - rows = self.parse_sheet_rows(csv_data, sheet_cfg['name']) + rows = self.parse_sheet_rows(csv_data, day_name) all_raw_records.extend([(r, sheet_cfg['day_idx']) for r in rows]) + stats['by_day'][day_name] = { + 'gid': sheet_cfg['gid'], + 'rows_count': len(rows), + 'status': 'OK' + } except Exception as e: - stats['errors'].append(f"Error al descargar o procesar la hoja de {sheet_cfg['name']}: {str(e)}") + err_msg = f"Error al descargar o procesar la hoja de {day_name}: {str(e)}" + stats['errors'].append(err_msg) + stats['by_day'][day_name] = { + 'gid': sheet_cfg['gid'], + 'rows_count': 0, + 'status': 'Error', + 'error': str(e) + } stats['total_rows_processed'] = len(all_raw_records) if not all_raw_records: @@ -345,29 +425,36 @@ class GoogleSheetsImporter: subjects_cache = {s.code.strip().upper(): s for s in Subject.query.all()} # Calculate current semester dates (anchored on academic year 2026) - # Week starting Monday 2026-08-31 to Saturday 2026-09-05 base_monday = date(2026, 8, 31) - weeks_to_generate = 4 # Generate reservations for 4 consecutive weeks + weeks_to_generate = 4 # Generar reservas para 4 semanas consecutivas for rec, day_idx in all_raw_records: try: codigo = rec['codigo'] asignatura = rec['asignatura'] aula_raw = rec['aula'] - carrera_name = rec['carrera'].strip() + carrera_raw = rec['carrera'].strip() horario_raw = rec['horario'] dia = rec['dia'] turno = rec.get('turno', 'Mañana') - # 1. Upsert Career - carrera_key = carrera_name.upper() - career = careers_cache.get(carrera_key) - if not career: - career = Career(name=carrera_name) - db.session.add(career) - db.session.flush() - careers_cache[carrera_key] = career - stats['careers_created'] += 1 + # 1. Upsert Careers (Desglosar carreras múltiples normalizadas) + carreras_list = parse_careers_list(carrera_raw) + career_objs = [] + for c_name in carreras_list: + c_key = c_name.upper() + career = careers_cache.get(c_key) + if not career: + career = Career.query.filter(Career.name.ilike(c_name)).first() + if not career: + career = Career(name=c_name) + db.session.add(career) + db.session.flush() + stats['careers_created'] += 1 + careers_cache[c_key] = career + career_objs.append(career) + + primary_career = career_objs[0] if career_objs else None # 2. Upsert Classroom room_info = self.normalize_room(aula_raw) @@ -395,34 +482,63 @@ class GoogleSheetsImporter: if not classroom.building_id and b_entity: classroom.building_id = b_entity.id - # 3. Upsert Subject + # 3. Upsert Subject (Soporte Many-to-Many con múltiples carreras y subcódigos) subject_key = codigo.upper() + sub_codes = parse_subject_codes(codigo) subject = subjects_cache.get(subject_key) + if not subject: + for sc in sub_codes: + if sc.upper() in subjects_cache: + subject = subjects_cache[sc.upper()] + break + + if not subject: + subject = Subject.query.filter_by(code=codigo).first() + if not subject: + for sc in sub_codes: + subj_by_sc = Subject.query.filter_by(code=sc).first() + if subj_by_sc: + subject = subj_by_sc + break + + department_str = ", ".join([c.name for c in career_objs]) if career_objs else (primary_career.name if primary_career else 'General') + if not subject: subject = Subject( code=codigo, name=asignatura, - career_id=career.id, - department=career.name, + career_id=primary_career.id if primary_career else None, + department=department_str, credits=4, is_active=True ) + subject.careers = career_objs db.session.add(subject) db.session.flush() - subjects_cache[subject_key] = subject stats['subjects_created'] += 1 else: if subject.name != asignatura: subject.name = asignatura stats['subjects_updated'] += 1 - subject.career_id = career.id - subject.department = career.name + # Vincular todas las carreras a la asignatura sin duplicados + for c_obj in career_objs: + if c_obj not in subject.careers: + subject.careers.append(c_obj) + if not subject.career_id and primary_career: + subject.career_id = primary_career.id + subject.department = ", ".join([c.name for c in subject.careers]) if subject.careers else department_str + + # Registrar en caché con código completo y con subcódigos individuales + subjects_cache[subject_key] = subject + for sc in sub_codes: + subjects_cache[sc.upper()] = subject # 4. Upsert Commission - # Identify commission subcode e.g. from code suffix or default 'C1' comm_code = 'C1' if '-E' in codigo: comm_code = codigo.split('-')[-1] + elif '-0' in codigo: + comm_code = 'C' + codigo.split('-')[-1] commission = Commission.query.filter_by( subject_id=subject.id, @@ -450,13 +566,14 @@ class GoogleSheetsImporter: else: commission.schedule = f"{dia} {horario_raw}" commission.shift = turno + if classroom: + commission.max_students = max(commission.max_students or 0, classroom.capacity) - # 5. Generate Calendar Reservations + # 5. Generar Reservas de Calendario t_start, t_end = self.parse_time_range(horario_raw) if classroom and t_start and t_end and day_idx is not None: is_room_virtual = bool(classroom.is_virtual or 'VIRTUAL' in (classroom.code or '').upper()) - # Generar enlace de videollamada para clases virtuales si no tienen uno asignado v_link = None if is_room_virtual: clean_subj = re.sub(r'[^a-zA-Z0-9]', '', subject.code or 'cls').lower() @@ -470,7 +587,6 @@ class GoogleSheetsImporter: dt_start = datetime.combine(class_date, t_start) dt_end = datetime.combine(class_date, t_end) - # En aulas virtuales la capacidad es infinita y pueden cursar múltiples comisiones en paralelo if is_room_virtual: existing_res = Reservation.query.filter_by( classroom_id=classroom.id, @@ -485,6 +601,8 @@ class GoogleSheetsImporter: end_time=dt_end ).first() + c_desc = ", ".join([c.name for c in career_objs]) if career_objs else 'General' + if not existing_res: res = Reservation( classroom_id=classroom.id, @@ -497,22 +615,22 @@ class GoogleSheetsImporter: expected_attendees=min(classroom.capacity, 30) if not is_room_virtual else 35, shift=turno, virtual_link=v_link, - notes=f"Clase semanal {dia} ({turno}) - Carrera: {career.name}" + notes=f"Clase semanal {dia} ({turno}) - Carreras: {c_desc}" ) db.session.add(res) stats['reservations_created'] += 1 else: existing_res.shift = turno - existing_res.notes = f"Clase semanal {dia} ({turno}) - Carrera: {career.name}" + existing_res.notes = f"Clase semanal {dia} ({turno}) - Carreras: {c_desc}" if is_room_virtual and not existing_res.virtual_link: existing_res.virtual_link = v_link - if len(stats['sample_records']) < 10: + if len(stats['sample_records']) < 15: stats['sample_records'].append({ 'dia': dia, 'codigo': codigo, 'asignatura': asignatura, - 'carrera': career.name, + 'carreras': [c.name for c in career_objs], 'aula': classroom.code_display if classroom else aula_raw, 'horario': horario_raw }) diff --git a/backend/setup.py b/backend/setup.py index 39d9394..12270c0 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.3.0", + version="3.4.0", description="Administrative interface for Edu-Space Classroom Management System", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/frontend/package.json b/frontend/package.json index f380462..fdebf19 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.3.0", + "version": "3.4.0", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index b84c691..d94b3a7 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.3.0'; -const FRONTEND_VERSION = '3.3.0'; -const BACKEND_VERSION = '3.3.0'; +const APP_VERSION = '3.4.0'; +const FRONTEND_VERSION = '3.4.0'; +const BACKEND_VERSION = '3.4.0'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/views/admin/commissions/list.html b/frontend/views/admin/commissions/list.html index ad27c70..bed7154 100644 --- a/frontend/views/admin/commissions/list.html +++ b/frontend/views/admin/commissions/list.html @@ -190,7 +190,13 @@
{{ comm.subject.name }}
{{ comm.subject.code }} - {{ comm.career_name or comm.subject.career_name or 'Carrera General' }} + {% if comm.careers and (comm.careers | length > 0) %} + {% for c_obj in comm.careers %} + {{ c_obj.name }} + {% endfor %} + {% else %} + {{ comm.career_name or comm.subject.career_name or 'Carrera General' }} + {% endif %} {{ comm.semester }} {{ comm.year }}
diff --git a/frontend/views/admin/import.html b/frontend/views/admin/import.html index 22de2cb..1ea4f00 100644 --- a/frontend/views/admin/import.html +++ b/frontend/views/admin/import.html @@ -222,6 +222,28 @@ + {% if stats.by_day %} +
+
+
Desglose Semanal por Día de Cursada:
+
+
+
+ {% for day_name, d_info in stats.by_day %} +
+
+ {{ day_name }} + + {{ d_info.rows_count }} filas + +
+
+ {% endfor %} +
+
+
+ {% endif %} + {% if stats.errors and (stats.errors|length > 0) %}
Advertencias o incidencias detectadas:
diff --git a/frontend/views/admin/subjects/list.html b/frontend/views/admin/subjects/list.html index 10b8e07..de53d95 100644 --- a/frontend/views/admin/subjects/list.html +++ b/frontend/views/admin/subjects/list.html @@ -148,7 +148,15 @@ {% endif %} - {% if s.career_obj %} + {% if s.careers and (s.careers|length > 0) %} +
+ {% for c_obj in s.careers %} + + {{ c_obj.name }} + + {% endfor %} +
+ {% elif s.career_obj %} {{ s.career_obj.name }} diff --git a/frontend/views/auth/login.html b/frontend/views/auth/login.html index 820cae4..16fa721 100644 --- a/frontend/views/auth/login.html +++ b/frontend/views/auth/login.html @@ -225,7 +225,7 @@
- v{{ app_version or '3.3.0' }} (FE: {{ frontend_version or '3.3.0' }} | BE: {{ backend_version or '3.3.0' }}) + v{{ app_version or '3.4.0' }} (FE: {{ frontend_version or '3.4.0' }} | BE: {{ backend_version or '3.4.0' }})
diff --git a/frontend/views/base.html b/frontend/views/base.html index f23c5fa..500e4d6 100644 --- a/frontend/views/base.html +++ b/frontend/views/base.html @@ -1127,7 +1127,7 @@