feat(v3.4.0): support multi-career subjects with subject_careers Many-to-Many and enhance Google Sheets importer for 6 days
This commit is contained in:
@@ -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`).
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 `<td>` 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.
|
||||
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/`).
|
||||
+11
-5
@@ -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`).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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()
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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()
|
||||
|
||||
|
||||
@@ -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": [
|
||||
{
|
||||
|
||||
@@ -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/<SPREADSHEET_ID>/...)
|
||||
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)
|
||||
# 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(name=carrera_name)
|
||||
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()
|
||||
careers_cache[carrera_key] = career
|
||||
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
|
||||
})
|
||||
|
||||
+1
-1
@@ -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",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "frontend",
|
||||
"version": "3.3.0",
|
||||
"version": "3.4.0",
|
||||
"description": "",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
|
||||
+3
-3
@@ -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);
|
||||
|
||||
@@ -190,7 +190,13 @@
|
||||
<div class="fw-semibold text-primary">{{ comm.subject.name }}</div>
|
||||
<div class="d-flex align-items-center gap-1 mt-1 flex-wrap">
|
||||
<span class="badge bg-secondary-subtle text-secondary border font-monospace">{{ comm.subject.code }}</span>
|
||||
{% if comm.careers and (comm.careers | length > 0) %}
|
||||
{% for c_obj in comm.careers %}
|
||||
<span class="badge bg-primary-subtle text-primary border" title="Carrera"><i class="bi bi-mortarboard me-1"></i>{{ c_obj.name }}</span>
|
||||
{% endfor %}
|
||||
{% else %}
|
||||
<span class="badge bg-primary-subtle text-primary border" title="Carrera"><i class="bi bi-mortarboard me-1"></i>{{ comm.career_name or comm.subject.career_name or 'Carrera General' }}</span>
|
||||
{% endif %}
|
||||
<small class="text-muted ms-1">{{ comm.semester }} {{ comm.year }}</small>
|
||||
</div>
|
||||
</td>
|
||||
|
||||
@@ -222,6 +222,28 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{% if stats.by_day %}
|
||||
<div class="card bg-body-tertiary border mb-3">
|
||||
<div class="card-header bg-transparent py-2 border-bottom">
|
||||
<h6 class="mb-0 small fw-bold text-dark"><i class="bi bi-calendar3 me-2 text-primary"></i>Desglose Semanal por Día de Cursada:</h6>
|
||||
</div>
|
||||
<div class="card-body p-2">
|
||||
<div class="row g-2 text-center">
|
||||
{% for day_name, d_info in stats.by_day %}
|
||||
<div class="col-md-2 col-4">
|
||||
<div class="p-2 border rounded bg-white shadow-sm">
|
||||
<span class="fw-bold d-block text-secondary small">{{ day_name }}</span>
|
||||
<span class="badge {% if d_info.status == 'OK' %}bg-success-subtle text-success border border-success-subtle{% else %}bg-danger-subtle text-danger border border-danger-subtle{% endif %}">
|
||||
{{ d_info.rows_count }} filas
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
{% endfor %}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
{% endif %}
|
||||
|
||||
{% if stats.errors and (stats.errors|length > 0) %}
|
||||
<div class="alert alert-warning mb-0 small">
|
||||
<h6 class="alert-heading fw-bold mb-1"><i class="bi bi-exclamation-triangle me-1"></i>Advertencias o incidencias detectadas:</h6>
|
||||
|
||||
@@ -148,7 +148,15 @@
|
||||
{% endif %}
|
||||
</td>
|
||||
<td>
|
||||
{% if s.career_obj %}
|
||||
{% if s.careers and (s.careers|length > 0) %}
|
||||
<div class="d-flex flex-wrap gap-1">
|
||||
{% for c_obj in s.careers %}
|
||||
<span class="badge bg-secondary-subtle text-secondary border">
|
||||
<i class="bi bi-mortarboard me-1"></i>{{ c_obj.name }}
|
||||
</span>
|
||||
{% endfor %}
|
||||
</div>
|
||||
{% elif s.career_obj %}
|
||||
<span class="badge bg-secondary-subtle text-secondary border">
|
||||
<i class="bi bi-mortarboard me-1"></i>{{ s.career_obj.name }}
|
||||
</span>
|
||||
|
||||
@@ -225,7 +225,7 @@
|
||||
</small>
|
||||
<div class="mt-2">
|
||||
<span class="badge bg-body-tertiary text-secondary border font-monospace" style="font-size: 0.68rem;" title="Versión de Edu-Space">
|
||||
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.3.0' }} <span class="opacity-75">(FE: {{ frontend_version or '3.3.0' }} | BE: {{ backend_version or '3.3.0' }})</span>
|
||||
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.4.0' }} <span class="opacity-75">(FE: {{ frontend_version or '3.4.0' }} | BE: {{ backend_version or '3.4.0' }})</span>
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -1127,7 +1127,7 @@
|
||||
|
||||
<div class="sidebar-footer-text mt-3 pt-2 border-top border-secondary-subtle text-center">
|
||||
<span class="badge bg-secondary-subtle text-secondary-emphasis font-monospace px-2 py-1" style="font-size:0.68rem;" title="Versión Institucional de Edu-Space">
|
||||
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.3.0' }} <span class="opacity-75">(FE: {{ frontend_version or '3.3.0' }} · BE: {{ backend_version or '3.3.0' }})</span>
|
||||
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.4.0' }} <span class="opacity-75">(FE: {{ frontend_version or '3.4.0' }} · BE: {{ backend_version or '3.4.0' }})</span>
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user