36 Commits
Author SHA1 Message Date
carlostellocba 39c80f573b feat: release v3.5.0 - formal MVP Bedelia closure, SDD harness, cartelera export, docs cleanup & model fixes 2026-10-16 13:18:02 -03:00
carlostellocba 94009ec552 fix(audit): support status and extra kwargs in AuditService.log 2026-10-09 10:35:12 -03:00
carlostellocba be5da21649 fix(sheets-import): increase express payload limit to 50MB and add comprehensive incident diagnosis and system error audit 2026-10-09 10:31:52 -03:00
carlostellocba 1edd81516a feat(audit): implement institutional audit logging for logins and system operations v3.4.8 2026-10-09 09:53:54 -03:00
carlostellocba 47c21dd25a fix: remove redundant breadcrumbs and refine theme styles in buildings views 2026-10-08 10:50:54 -03:00
carlostellocba 5161460440 fix(v3.4.7): fix syntax in buildings.js route handler 2026-10-08 10:30:57 -03:00
carlostellocba ea9991e795 feat(v3.4.7): add interactive floors and classrooms panel in building edit and preselect room creation 2026-10-08 10:28:28 -03:00
carlostellocba 368dc71b14 fix(v3.4.6): fix reservation cascade, remove calendar mocks, strip auto meet links, friendly dates, dynamic building floors and career filter 2026-10-08 08:26:15 -03:00
carlostellocba 25039efdeb fix(optimizer): allow bedelia and operators access to ai room reservation optimizer v3.4.5 2026-10-08 07:49:50 -03:00
carlostellocba f2d0179154 fix(dashboard): expose filter_stats and tomorrow fallback in api and bff 2026-10-07 23:20:48 -03:00
carlostellocba f95711d77b feat(dashboard): add tomorrow filter to period switchers and schedule view v3.4.4 2026-10-07 23:13:16 -03:00
carlostellocba 22c545e2df feat(sheets): refactor google sheets importer with granular entities and interactive preview grid v3.4.3 2026-10-07 22:51:41 -03:00
carlostellocba e1c2c6e8c6 feat(schedule): group reservations by real time slots and clean date-time formatting v3.4.2 2026-10-07 22:26:52 -03:00
carlostellocba ec7a8ac7d4 docs: update MEMORY.md with v3.4.1 resolutions and deployment status 2026-10-07 21:01:28 -03:00
carlostellocba f82e1c414c fix: remove duplicate bedeliaData declaration in dashboard.js 2026-10-07 20:58:51 -03:00
carlostellocba 62de55bea8 feat: modularize dashboard templates by roles, fix google sheets import error, fix bedelia virtual classrooms, update constitution to v3.4.1 2026-10-07 20:55:57 -03:00
carlostellocba 21812ef02e docs: update MEMORY.md with sheets importer filtering and manual date evolution 2026-10-07 20:05:44 -03:00
carlostellocba 03078e3178 fix(ui): update import.html with interactive filters and active filter stats summary 2026-10-07 20:04:46 -03:00
carlostellocba cb77ba57de fix(bff): correctly pass all filter options to backend sync-sheets API 2026-10-07 20:00:41 -03:00
carlostellocba be3ec3fd89 feat(api): add sheets-inspect endpoint and filter params to sync-sheets 2026-10-07 19:57:57 -03:00
carlostellocba fcd752cda8 fix(bff): add sheets_inspect route in admin router 2026-10-07 19:56:25 -03:00
carlostellocba 576a7c0dd2 feat(sheets): add online career, subject, day filtering and manual date assignment controls 2026-10-07 19:53:42 -03:00
carlostellocba 6eef71bc7e docs: update MEMORY.md with dashboard day week month filtering features 2026-10-07 19:41:55 -03:00
carlostellocba c834fcdbc6 feat(dashboard): add day week month filtering for assigned and unassigned classrooms and commissions with clear dates 2026-10-07 19:39:34 -03:00
carlostellocba b6d7d8842e docs: update MEMORY.md with bedelia views fixes and production metrics 2026-10-07 19:24:00 -03:00
carlostellocba b935509e54 fix: close commTableMonth tag in dashboard.html 2026-10-07 19:22:43 -03:00
carlostellocba ff6480f591 fix: update bedelia views for today and weekly reservations, available rooms and unassigned commissions 2026-10-07 19:16:35 -03:00
carlostellocba 5764203232 fix(api): bind version and health endpoints to app.__version__ 2026-10-07 18:05:52 -03:00
carlostellocba a60a7cdc78 feat(v3.4.0): support multi-career subjects with subject_careers Many-to-Many and enhance Google Sheets importer for 6 days 2026-10-07 18:04:23 -03:00
carlostellocba 14bf7169c2 docs: update MEMORY.md with recent production fixes and deployment 2026-10-07 17:32:57 -03:00
carlostellocba b7f790eed1 fix(auth): strictly respect demo_access_enabled setting on login page and error redirects 2026-10-07 17:30:24 -03:00
carlostellocba eb239ddb21 fix(ui): move edit career modals outside table container to resolve modal flicker and backdrop dismissal 2026-10-07 17:23:39 -03:00
carlostellocba 29a2da3297 docs: update MEMORY.md with classrooms fix and rbac reorganization 2026-10-07 17:19:26 -03:00
carlostellocba fc94ca82fe feat(rbac-ui): add academic management to bedelia rbac, restyle role menus, display version badges, and fix classrooms template 2026-10-07 17:16:11 -03:00
carlostellocba e38572c93d docs: update MEMORY.md with deployment status 2026-10-07 17:04:22 -03:00
carlostellocba 8dc055cd1e feat(bedelia): associate careers to commissions and subjects, clean dashboard mock fallbacks, and update SSD documentation 2026-10-07 17:02:56 -03:00
99 changed files with 11393 additions and 2929 deletions
+75
View File
@@ -0,0 +1,75 @@
---
name: deploy
description: Procedimiento innegociable de bump semántico de versión, git push y despliegue continuo en producción (LXC 10.0.0.217) utilizando .credenciales.
---
# Skill: Despliegue Continuo, Bump de Versión y Git Push
Esta skill define el protocolo obligatorio para consolidar, versionar, publicar y desplegar cambios en **admin-edu-space**.
---
## Principio Rector (Principio 9 de la Constitución)
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
1. **Subir la versión semántica** de forma coordinada.
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev`).
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
---
## Paso 1: Bump Semántico de Versión
Incrementar la versión siguiendo SemVer (`X.Y.Z`) en todos los descriptores del proyecto:
- `frontend/package.json` (`"version": "X.Y.Z"`)
- `frontend/src/app.js` (`APP_VERSION`, `FRONTEND_VERSION`, `BACKEND_VERSION`)
- `backend/app/__init__.py` (`__version__ = "X.Y.Z"`)
- `backend/setup.py` (`version="X.Y.Z"`)
- `backend/app/routes/api/openapi.py` (`"version": "X.Y.Z"`)
- `CHANGELOG.md` (Nueva sección `## [X.Y.Z] - YYYY-MM-DD`)
- `MEMORY.md` (Registrar hito del sprint)
---
## Paso 2: Git Commit y Push
Ejecutar la suite de pruebas (`python -m pytest tests -v` en `backend`). Si está 100% en verde:
```powershell
git add .
git commit -m "feat/fix: descripción del cambio (vX.Y.Z)"
git push origin dev
```
---
## Paso 3: Despliegue en Servidor de Producción (LXC Edu-Admin-Space)
Consultar el archivo `.credenciales` en la raíz del proyecto para obtener la IP, usuario y contraseña del host:
- **Host / IP:** `10.0.0.217` (LXC Debian Edu-Admin-Space)
- **Dominio Público:** `https://eduspace.oemspot.com.ar`
- **Usuario SSH:** `root`
- **Acceso:** Credenciales de `.credenciales`
### Comandos de Despliegue Remoto:
1. Conectar vía SSH y sincronizar repositorio en el servidor:
```bash
ssh root@10.0.0.217 "cd /opt/admin-edu-space && git fetch && git checkout dev && git pull origin dev"
```
2. Si hubo cambios en dependencias o esquema:
```bash
ssh root@10.0.0.217 "cd /opt/admin-edu-space/backend && ./venv/bin/pip install -r requirements.txt && ./venv/bin/flask db upgrade"
ssh root@10.0.0.217 "cd /opt/admin-edu-space/frontend && npm install"
```
3. Reiniciar servicios systemd del Backend y Frontend:
```bash
ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend"
```
4. Verificar estado del servicio:
```bash
ssh root@10.0.0.217 "systemctl status admin-edu-space-backend --no-pager"
ssh root@10.0.0.217 "systemctl status admin-edu-space-frontend --no-pager"
```
---
## Paso 4: Verificación de Disponibilidad en Vivo (Smoke Test)
Comprobar que el endpoint público responde HTTP 200 con la nueva versión:
- Backend version: `https://eduspace.oemspot.com.ar/api/v1/version` o `http://10.0.0.217:5000/api/v1/version`
- Frontend version: `https://eduspace.oemspot.com.ar/version`
- Pantalla de login accesible: HTTP 200 en `https://eduspace.oemspot.com.ar/login`
+66
View File
@@ -0,0 +1,66 @@
---
name: sdd
description: Flujo de desarrollo guiado por especificaciones (Spec-Driven Development) basado en los principios de ingeniería de software con IA y sintaxis EARS.
---
# Skill: Spec-Driven Development (SDD)
Esta skill define el arnés metodológico innegociable para implementar, refactorizar o validar funcionalidades en **admin-edu-space**.
## Principio Fundamental
**La especificación manda**: Ninguna línea de código de negocio se escribe si no está precedida por una especificación aprobada (`spec.md`), un plan técnico (`plan.md`) y una lista de tareas atómicas (`tasks.md`).
---
## Flujo de Trabajo (7 Pasos)
```
1. Constitución (docs/constitution.md)
↓
2. Especificación (specs/NNN-nombre/spec.md)
↓
3. Clarificación (Revisión QA - detección de ambigüedades)
↓
4. Planificación (specs/NNN-nombre/plan.md)
↓
5. Desglose de Tareas (specs/NNN-nombre/tasks.md)
↓
6. Implementación (Tarea por tarea, Test-First)
↓
7. Validación (RF por RF + Criterios de Finalización)
```
---
## Sintaxis EARS (Easy Approach to Requirements Syntax)
Todo Requisito Funcional (RF) debe redactarse usando exclusivamente una de las 5 estructuras EARS en español:
1. **Ubicuo (Comportamiento permanente)**:
> `EL SISTEMA <comportamiento permanente>.`
> *Ejemplo:* EL SISTEMA registrará en `AuditLog` toda modificación de asignación de aula.
2. **Basado en Eventos (Disparado por una acción)**:
> `CUANDO <evento>, EL SISTEMA <respuesta>.`
> *Ejemplo:* CUANDO el usuario confirme una reserva con conflicto físico, EL SISTEMA bloqueará la operación y retornará un error HTTP 409 con el detalle de la superposición.
3. **Basado en Estados (Activo mientras se cumpla una condición)**:
> `MIENTRAS <estado>, EL SISTEMA <respuesta>.`
> *Ejemplo:* MIENTRAS una comisión posea co-docencia activa registrada, EL SISTEMA permitirá la superposición horaria del docente auxiliar.
4. **No Deseado / Excepciones (Manejo de errores y límites)**:
> `SI <condición no deseada>, ENTONCES EL SISTEMA <respuesta>.`
> *Ejemplo:* SI la matrícula de la comisión supera el aforo máximo del aula, ENTONCES EL SISTEMA impedirá el guardado y alertará al operador de Bedelía.
5. **Opcional (Funcionalidad dependiente de configuración o rol)**:
> `DONDE <característica opcional>, EL SISTEMA <respuesta>.`
> *Ejemplo:* DONDE el usuario posea rol Bedelia o Admin, EL SISTEMA habilitará el botón de reasignación directa de aulas libres.
---
## Reglas de Ejecución para Agentes
1. **No inventar**: Si falta información o un caso de uso no está cubierto, detenerse y marcar `[NECESITA ACLARACIÓN]`.
2. **Tareas pequeñas**: Cada tarea en `tasks.md` debe tener una duración estimada de 20-30 minutos y contar con su criterio *"Hecho cuando:"*.
3. **Test-First**: En la lógica de backend, escribir primero el test en rojo antes de tocar el código de la solución.
4. **Validación RF por RF**: Al finalizar, verificar cada RF de la especificación contra los tests y la interfaz gráfica.
5. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
6. **Bump de Versión, Git Push y Despliegue en Producción (Skill `deploy`)**: Conforme al Principio 9 de la Constitución, incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `CHANGELOG.md`), ejecutar `git push origin dev` al repositorio remoto y desplegar en producción al servidor institucional LXC (`10.0.0.217`) utilizando las credenciales de `.credenciales`.
+4 -1
View File
@@ -224,4 +224,7 @@ legacy_admin-edu-space/
.schemathesis/ .schemathesis/
AlumnosLS AlumnosLS
prerrequisitos apuntes
.credentials
.credenciales
+15
View File
@@ -0,0 +1,15 @@
---
description: Coordinador general del proyecto Admin Edu-Space. Dirige el flujo SDD orquestando al planificador, implementador y revisor sin tocar código directamente.
mode: primary
---
Eres el Agente Coordinador (Coordinator) de **admin-edu-space**.
Tu misión es guiar el avance hacia la entrega del MVP de Bedelía asegurando el cumplimiento de `docs/constitution.md` y `AGENTS.md`.
## Flujo de Trabajo
1. **Spec**: Delegar en `@planner` la redacción de `specs/NNN-nombre/spec.md`.
2. **Clarificación**: Delegar en `@reviewer` la revisión QA para eliminar ambigüedades.
3. **Plan y Tareas**: Delegar en `@planner` la confección de `plan.md` y `tasks.md`.
4. **Implementación**: Delegar en `@implementer` una tarea atómica a la vez.
5. **Validación**: Delegar en `@reviewer` la validación RF por RF.
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución.
+13
View File
@@ -0,0 +1,13 @@
---
description: Agente implementador de Admin Edu-Space. Ejecuta tareas atómicas individuales guiado por el plan y con enfoque Test-First.
mode: subagent
---
Eres el Agente Implementador (Implementer) de **admin-edu-space**.
Tu misión es ejecutar UNA tarea específica de `tasks.md` sin rediseñar el plan ni añadir alcance no solicitado.
## Reglas
- Lee la tarea asignada, `plan.md`, `docs/constitution.md` y `AGENTS.md`.
- Enfoque **Test-First**: si tocas lógica de negocio, crea o ajusta primero la prueba automatizada en `backend/tests/`.
- Ejecuta las pruebas (`python -m pytest tests -v` en backend) y asegura 100% de éxito.
- Marca la tarea con `[x]` en `tasks.md` al terminar y detén tu ejecución para supervisión.
+14
View File
@@ -0,0 +1,14 @@
---
description: Agente planificador SDD de Admin Edu-Space. Redacta especificaciones EARS, planes técnicos y tareas atómicas. No escribe código de aplicación.
mode: subagent
---
Eres el Agente Planificador (Planner) de **admin-edu-space**.
Tu objetivo es redactar especificaciones precisas, arquitecturas limpias y listas de tareas sin tocar el código fuente del backend ni del frontend.
## Reglas
- Lee siempre `docs/constitution.md`, `AGENTS.md` y `MEMORY.md`.
- Escribe las especificaciones en `specs/NNN-nombre/spec.md` con sintaxis EARS en español.
- Nunca incluyas nombres de archivos ni detalles de base de datos en `spec.md` (van en `plan.md`).
- Define criterios de aceptación verificables y delimita claramente el **Fuera de Alcance**.
- En `tasks.md`, desglosa tareas en bloques atómicos de 20 a 30 minutos con `[ ]` y criterio *"Hecho cuando:"*.
+16
View File
@@ -0,0 +1,16 @@
---
description: Agente revisor y auditor QA de Admin Edu-Space. Clarifica especificaciones y valida implementaciones RF por RF sin modificar archivos.
mode: subagent
---
Eres el Agente Revisor (Reviewer) de **admin-edu-space**.
Tu misión es actuar como QA profesional y auditor de calidad, garantizando que el software cumpla la especificación al 100%.
## Tareas
1. **En Clarificación de Spec**: Busca ambigüedades, contradicciones, lagunas en casos límite o choques con `docs/constitution.md`.
2. **En Validación de Implementación**:
- Revisa los cambios (`git diff`).
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
- Recorre cada RF de la especificación y emite un veredicto formal:
- `VEREDICTO: APROBADO`
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
+23
View File
@@ -0,0 +1,23 @@
---
description: Bump de versión, commit, git push y despliegue a producción usando .credenciales
agent: coordinator
---
Ejecuta el protocolo innegociable de despliegue continuo (Skill `deploy` y Principio 9):
1. Comprueba que la suite de pruebas esté en verde: `cd backend && pytest tests -v`.
2. Incrementa el número de versión semántica en:
- `frontend/package.json`
- `frontend/src/app.js`
- `backend/app/__init__.py`
- `backend/setup.py`
- `backend/app/routes/api/openapi.py`
- `CHANGELOG.md`
- `MEMORY.md`
3. Ejecuta `git add .`, `git commit` y `git push origin dev` al repositorio remoto.
4. Conéctate vía SSH al servidor de producción utilizando los datos del archivo `.credenciales`:
- Host LXC: `10.0.0.217`
- Usuario: `root`
5. Ejecuta en el servidor:
- `cd /opt/admin-edu-space && git pull origin dev`
- `systemctl restart admin-edu-space-backend admin-edu-space-frontend`
6. Verifica que `https://eduspace.oemspot.com.ar/version` responda HTTP 200 con la versión recién publicada.
+12
View File
@@ -0,0 +1,12 @@
---
description: SDD · Genera el plan técnico a partir de una spec aprobada
---
Lee `docs/constitution.md`, `AGENTS.md` y `specs/$1/spec.md`. NO escribas código.
Genera `specs/$1/plan.md` con:
1. Archivos que se crean o modifican y responsabilidad de cada uno.
2. Contratos de API (endpoints REST `/api/v1/`, métodos, payload JSON, códigos HTTP).
3. Componentes de UI / Vistas Nunjucks afectadas.
4. Decisiones técnicas justificadas (y la alternativa descartada).
5. Estrategia de tests automatizados (`pytest tests -v`).
6. Mapeo de qué Requisito Funcional (RF) cubre cada parte.
+12
View File
@@ -0,0 +1,12 @@
---
description: SDD · Genera o entrevista para crear una nueva spec (uso /sdd-spec 001-nombre idea)
---
NO escribas código en ningún momento. Lee `docs/constitution.md`, `AGENTS.md` y `MEMORY.md`, y utiliza la skill `sdd`.
Carpeta de la spec: `specs/$1/`
Idea inicial: $ARGUMENTS
Tu trabajo:
1. Haz preguntas de UNA en UNA para eliminar ambigüedades (casos límite, errores, qué queda fuera de alcance para el MVP). Máximo 5 preguntas.
2. Genera `specs/$1/spec.md` siguiendo la plantilla de SDD, con requisitos funcionales en notación EARS en español y "Estado: borrador".
3. Describe exclusivamente el QUÉ y el POR QUÉ: nada de nombres de archivo, modelos ni arquitectura (eso va en el plan).
+8
View File
@@ -0,0 +1,8 @@
---
description: SDD · Genera las tareas atómicas a partir de spec.md y plan.md
---
A partir de `specs/$1/spec.md` y `specs/$1/plan.md`, genera `specs/$1/tasks.md`:
1. Tareas pequeñas y atómicas (máximo 20-30 minutos cada una).
2. Ordenadas por dependencia lógica (Backend / Datos primero, luego Frontend BFF / UI, luego Tests y Validación).
3. Cada tarea debe indicar qué RFs cubre y una línea `"Hecho cuando:"` verificable.
4. Utiliza checkboxes `[ ]`.
+74
View File
@@ -0,0 +1,74 @@
# AGENTS.md - admin-edu-space (Rama dev / MVP)
Plataforma web de gestión de espacios áulicos, sincronización académica y asignación de cursadas para UniCABA, diseñada para reemplazar el uso de planillas Excel en Bedelía, orquestar calendarios en tiempo real y conectarse con Moodle 4.1 y Google Workspace.
## Stack y Estructura
- **Arquitectura**: Desacoplada (Backend Core REST API + Frontend BFF).
- **Backend Core**: Python 3.12, Flask 3.1, SQLAlchemy ORM, SQLite / PostgreSQL 15, Marshmallow/Pydantic DTOs, Flask-JWT-Extended (HS256 stateless).
- **Frontend BFF**: Node.js v20+, Express.js, motor de plantillas Nunjucks, cliente Axios con interceptores de autorización Bearer, Bootstrap 5 + Vanilla CSS.
- **Integraciones Clave**:
- Google OAuth 2.0 para autenticación institucional restringida a `@unicaba.edu.ar`.
- Moodle 4.1 REST API (`core_webservice_*`, `enrol_*`) con cola asíncrona resiliente (`MoodleSyncTask`), reintentos exponenciales, Dead Letter Queue (DLQ) y capa de caché híbrida (`CacheService` en Redis / memoria).
- Motor de Notificaciones SMTP dinámico (`EmailService`) con credenciales cifradas con Fernet en base de datos.
- Importador oficial de Google Sheets (`sheets_importer.py`) para ingesta masiva inicial.
- **Entorno de Ejecución**: Contenedores Linux LXC en Proxmox con Nginx como proxy inverso y terminación SSL (entorno productivo institucional: `eduspace.oemspot.com.ar`).
## Comandos de Desarrollo y Verificación
- **Levantar Backend (Flask API :5000)**:
```powershell
cd backend
.\venv\Scripts\activate
flask run --port 5000
```
- **Levantar Frontend BFF (Express :3000)**:
```powershell
cd frontend
npm run dev
```
- **Ejecutar Suite de Pruebas Automatizadas (Backend)**:
```powershell
cd backend
.\venv\Scripts\activate
pytest tests -v
```
- **Auditoría Automatizada de Seguridad (SAST / SCA / DAST)**:
```powershell
.\security_audit.bat --no-pause
```
## Convenciones de Desarrollo
- Nombres de variables, funciones, clases, tablas, endpoints y commits estrictamente en **inglés**.
- Los endpoints de la API deben seguir estándares RESTful puros bajo `/api/v1/` retornando exclusivamente JSON.
- Interfaz gráfica de usuario, etiquetas de formularios, mensajes de error y documentación operativa exclusivamente en **español**.
## 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`).
- **Autenticación**: Los flujos de acceso pasan por tokens JWT transportados en cookies seguras `HttpOnly`.
## Metodología SDD (Spec-Driven Development) y Arnés de Agentes
- **La especificación manda**: Ninguna feature se codifica sin su carpeta `specs/NNN-nombre/` conteniendo `spec.md` (requisitos en sintaxis **EARS** en español: Ubicuo, Eventos, Estado, No Deseado, Opcional), `plan.md` y `tasks.md` (skill `.agents/skills/sdd/SKILL.md`).
- **Flujo de Roles**:
- `Coordinator`: Conduce la interacción con el usuario y orquesta a los subagentes sin tocar código.
- `Planner`: Redacta specs, planes y tareas atómicas (20-30 min) con criterios verificables "Hecho cuando:".
- `Implementer`: Ejecuta tareas una a una con enfoque Test-First (`backend/tests/`).
- `Reviewer`: Clarifica specs como QA y valida la implementación emitiendo veredicto formal (`VEREDICTO: APROBADO / CAMBIOS NECESARIOS`).
## Despliegue en Producción y Git Push (Innegociable por Principio 9)
- Al completar cualquier tarea o hito verificado:
1. Incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py`).
2. Registrar cambios en `CHANGELOG.md` y `MEMORY.md`.
3. Ejecutar `git add .`, commit y **`git push origin dev`** al repositorio remoto.
4. Desplegar inmediatamente en producción al servidor institucional LXC (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos del archivo `.credenciales`, reiniciando los servicios `admin-edu-space-backend` y `admin-edu-space-frontend`, y verificando HTTP 200 en `/version`.
## Límites
- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa (`specs/`) antes de proponer o modificar código.
- **SIEMPRE**: Al finalizar la tarea, realizar bump de versión, `git push origin dev` y despliegue a producción con `.credenciales` (Skill `.agents/skills/deploy/SKILL.md`).
- **PREGUNTA ANTES DE**: Añadir nuevas dependencias a `requirements.txt` o `package.json`, alterar el esquema relacional de la base de datos o cambiar la estrategia de caché.
- **NUNCA**: Expongas contraseñas, tokens de Moodle, secretos de API o el contenido del archivo `.credenciales` en el código fuente, commits o logs públicos.
## Memoria
- Al empezar, lee `MEMORY.md` para conocer el estado actual de la rama y los objetivos del sprint.
- Al terminar cualquier tarea, actualízalo resumiendo las decisiones tomadas y los siguientes pasos.
+206 -1
View File
@@ -6,11 +6,216 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
--- ---
## [Unreleased] ## [Unreleased]
### Planificado (Fase 6 del Roadmap MVP) ### Planificado (Fase 6 del Roadmap)
- **Despliegue e Infraestructura (Fase 6):** `docker-compose.yml` productivo orquestando Flask (Gunicorn), Node.js BFF (PM2) y PostgreSQL 15, con proxy inverso Nginx, SSL/TLS y compresión. - **Despliegue e Infraestructura (Fase 6):** `docker-compose.yml` productivo orquestando Flask (Gunicorn), Node.js BFF (PM2) y PostgreSQL 15, con proxy inverso Nginx, SSL/TLS y compresión.
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.5.0] - 2026-10-16
### Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA)
- **Arnés de Ingeniería de Software con IA (Harness Engineering):**
- Incorporación de la skill formal de SDD (`.agents/skills/sdd/SKILL.md`) con las directivas de especificación, planificación y tareas.
- Implementación de comandos personalizados en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`).
- Configuración de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA).
- Actualización de `AGENTS.md` con las reglas mandatorias del flujo SDD y sintaxis EARS.
- **Especificación Formal de Cierre de MVP (`specs/001-cierre-mvp-bedelia/`):**
- Delimitación inamovible de los 10 Requisitos Funcionales en notación EARS y delimitación explícita de *Fuera de Alcance* para evitar el *Scope Creep*.
- **Herramientas de Exportación e Impresión para Bedelía y Portería:**
- Nuevo endpoint en Frontend BFF (`/schedule/export_csv`) que genera un archivo CSV con formato Excel nativo (UTF-8 con BOM `\uFEFF` y separador `;`) conteniendo la cartelera de clases del día/semana seleccionada.
- Botón "Excel / CSV" y botón "Imprimir" en `/schedule/today` (`today.html`).
- Hojas de estilo CSS `@media print` para impresión oficial limpia en hoja A4 con membrete institucional de UniCABA (oculta barras de navegación, botones y filtros).
- Accesos directos de exportación e impresión en el Dashboard Operativo de Bedelía (`dashbede.html`).
- **Verificación de Calidad:**
- 52 pruebas automatizadas en verde (`52 passed`) en pytest.
## [3.4.9] - 2026-10-09
### Corregido & Mejorado (Importador de Google Sheets & Sistema de Diagnóstico de Incidentes)
- **Corrección de Límite de Payload en Importación Masiva de Google Sheets (`PayloadTooLargeError`):**
- Ajuste de los analizadores de cuerpo en el Frontend BFF Express (`express.json({ limit: '50mb' })` y `express.urlencoded({ extended: true, limit: '50mb' })`), resolviendo el error 500 al enviar matrices de filas preseleccionadas (~154 KB que excedían el límite por defecto de 100 KB).
- **Sistema Institucional de Manejo de Incidentes y Diagnóstico Transparente:**
- Reemplazo de la pantalla genérica de error por una interfaz estructurada con código de ticket único (`INC-YYYYMMDD-XXXX`), código HTTP, síntesis contextual y recomendación de acción correctiva.
- Sección técnica colapsable de diagnóstico con Ruta, Marca de Tiempo, Usuario activo, IP del cliente y Stack Trace.
- Botón "Copiar Reporte para Soporte" con formateo estándar para agilizar la asistencia técnica por Bedelía o Soporte IT.
- Registro automático del incidente técnico en `AuditLog` (`action='SYSTEM_ERROR'`, `module='system'`) vía nuevo endpoint `/api/v1/admin/log-error`.
- **Auditoría Integral de Sincronización de Hojas de Cálculo (`/api/v1/dashboard/sync-sheets`):**
- Registro de eventos exitosos (`SHEETS_IMPORT`) con estadísticas de entidades procesadas (carreras, materias, comisiones, aulas, reservas) y filtros aplicados.
- Registro de errores de sincronización (`SHEETS_IMPORT_ERROR`) con detalle de la excepción para trazabilidad en la bitácora institucional.
## [3.4.8] - 2026-10-09
### Agregado & Mejorado (Registro de Auditoría Institucional y Trazabilidad Operativa)
- **Auditoría Completa de Autenticación y Sesiones (`AuditService` & `/api/v1/auth/`):**
- Registro sistemático de eventos de inicio de sesión exitosos (`LOGIN`), inicios vía Google SSO (`LOGIN_GOOGLE`) y Moodle delegado (`LOGIN_MOODLE`).
- Registro de intentos fallidos (`LOGIN_FAILED`) con captura de correo, IP de origen y motivo del rechazo (credenciales inválidas, dominio no autorizado o cuenta inactiva).
- Auditoría de accesos bloqueados por deshabilitación administrativa de contraseña local (`LOGIN_BLOCKED`).
- Auditoría de cierres de sesión (`LOGOUT`) y cambios de contraseña institucional por el usuario (`PASSWORD_CHANGE`).
- **Trazabilidad de Espacios Físicos, Aulas y Reservas:**
- Auditoría de altas, modificaciones, bajas y alternancia de estado en edificios (`buildings`) y aulas (`classrooms`).
- Auditoría de creación, edición, cancelación, confirmación y borrado de reservas (`reservations`).
- Auditoría de corridas (`OPTIMIZE_RUN`) y aplicación de asignaciones masivas (`OPTIMIZE_APPLY`) del Optimizador Genético IA.
- **Endpoint RESTful de Auditoría (`GET /api/v1/admin/audit-logs`):**
- Exposición de endpoints RESTful con soporte de filtros por módulo, acción, búsqueda multi-campo y paginación configurable.
- Implementación del método `to_dict()` en el modelo `AuditLog` para serialización JSON segura.
- **Interfaz Institucional de Auditoría (`/admin/audit_logs`):**
- Conexión del Frontend BFF con el Backend REST Core.
- Badges temáticos e intuitivos para cada acción institucional y módulo.
- Filtros rápidos por categorías (Sesiones, Fallos de Login, Reservas, Aulas, Sedes, Optimizador IA).
- Modal interactivo de inspección con visor JSON/texto formateado y botón para copiar al portapapeles.
- Paginación dinámica nativa compatible con Nunjucks que conserva los parámetros de búsqueda.
## [3.4.7] - 2026-10-08
### Agregado & Mejorado (Panel Interactivo de Plantas y Aulas en Edificios)
- **Gestión de Edificios (`/buildings/edit/:id` y `/buildings/add_building`):**
- Transformación del formulario de edición de edificio de un mero input numérico a un **Panel Interactivo de Plantas y Aulas de la Sede**.
- Visualización completa de cada planta física (Subsuelos, Planta Baja, Entrepisos, Pisos 1..N) con badges de código, cantidad de aulas y capacidad instalada en alumnos.
- Listado detallado de aulas asociadas por planta física con enlaces directos a ficha, edición y reservas.
- Botón de acción directa **`+ Nueva Aula en este Piso`** (`/classrooms/add_classroom?building_id=X&floor=Y`) que precarga automáticamente el edificio y el piso seleccionado.
- Configurador rápido de niveles físicos con presets (`PB`, `PB + 1`, `PB + 3`, `Virtual`), stepper dinámico y generador visual en tiempo real de la estructura proyectada.
- **Módulo de Aulas (`/classrooms/add_classroom`):**
- Soporte de preselección automática por URL (`building_id` y `floor`) para agilizar la creación de espacios desde la vista de edificios.
## [3.4.6] - 2026-10-08
### Corregido & Mejorado (Reservas, Relaciones Edificios/Aulas, Fechas y Filtros)
- **Módulo de Reservas (`/schedule/add_reservation` y `/schedule/edit`):**
- Corrección del fallo de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar el "Edificio Central". Inyección segura de `classroom_data_json` y `commission_data_json` sin escape de entidades HTML (`&quot;`), y matching ultra tolerante de pisos físicos y virtuales.
- **Calendario Académico (`/schedule/calendar_view` y `/schedule/calendar_data`):**
- Limpieza exhaustiva de datos mockeados y hardcodeados (`Arquitectura de Software ARQ-101`, `COM-A`, `Licenciatura en Sistemas`). El feed y los filtros ahora consumen estrictamente asignaturas, carreras, comisiones y aulas reales de la base de datos institucional.
- **Importador de Google Sheets (`sheets_importer.py`):**
- Eliminación de la autogeneración no deseada de enlaces de Google Meet / Zoom (`https://meet.google.com/edu-...`) en reservas importadas con celdas vacías (ej. `#9797 ASIG00215 - Marketing Digital`). Se respeta estrictamente el Sheet: solo se asocian enlaces virtuales si vienen explícitamente en el documento original.
- **UX/UI Ficha del Aula (`/classrooms/view_classroom`):**
- Formateo amigable en español institucional para las reservas y clases programadas (ej. `Viernes 04/09/2026 · 18:30 a 21:30 hs`) eliminando el formato ISO repetido y ampliando el rango de consulta a todo el ciclo lectivo 2026.
- **Gestión de Edificios, Aulas y Pisos Dinámicos (`/buildings/list_buildings` y `/buildings/view/:id`):**
- Corrección de la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas configuradas. Implementación del agrupador `floors_list` y `classrooms_by_floor`.
- Corrección del contador de "Pisos Presenciales" en el listado general de edificios para mostrar el conteo real (4 pisos) en lugar de 0.
- Soporte de niveles dinámicos alfanuméricos: creación y selección de "Planta Baja (PB)", "Entrepiso (EP)", "Subsuelo (SS)", etc., en modelos, datalists y vistas de detalle.
- **Filtros en Gestión de Comisiones (`/admin/commissions_list`):**
- Corrección de `UnboundLocalError` en `backend/app/routes/api/admin.py` dentro de `get_commissions` causado por importación interna tardía de `Career`, que provocaba error 500 al filtrar por carrera (`career_id=180, 181, 182`). Grilla ahora filtra correctamente sobre materias compartidas (`subject_careers`).
## [3.4.5] - 2026-10-08
### Corregido & Mejorado (Optimizador de Aulas por Inteligencia Artificial - IA)
- **Corrección de Permisos RBAC para Bedelía y Operadores en el Optimizador Genético:**
- Resolución del bloqueo que devolvía `403 Forbidden` a usuarios con rol `Bedelia`, `Docente` o Administradores con roles formateados en minúsculas en los endpoints `/api/genetic/commissions`, `/api/genetic/algorithm-status`, `/api/genetic/preview-optimization`, `/api/genetic/optimize` y `/api/genetic/apply-optimization`.
- Creación del helper de verificación de permisos `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` admitiendo a Administradores, Bedelía, Docentes y permisos RBAC personalizados.
- **Enriquecimiento del Listado de Comisiones para Asignación Áulica:**
- `GET /api/genetic/commissions` ahora expone `subject_name`, `subject_code`, `career_name`, `schedule` y `shift` para cada comisión activa.
- **Rediseño e Internacionalización de la Interfaz del Optimizador:**
- `frontend/views/genetic_optimizer.html`: Interfaz traducida integralmente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas interactivas de comisiones con badges de código, asignatura, carrera, turno, horario y aforo, buscador en vivo multi-criterio y manejo de errores visible.
- `frontend/public/js/genetic-algorithm.js`: Traducción de alertas, modales y tablas de resultados ("Resultados de la Optimización", "Previsualización", confirmación de aplicación directa a Bedelía).
- Protección de la ruta web `/genetic_optimizer` con `requireAuth` e inyección de datos de sesión en `frontend/src/app.js`.
## [3.4.4] - 2026-10-07
### Añadido & Mejorado (Dashboard Operativo de Bedelía y Admin)
- **Filtro Temporal "Mañana" en Switchers de Período y Cartelera:**
- Incorporación del botón de filtro temporal "Mañana" (`tomorrow`) de forma homogénea en los switchers de período del dashboard:
- **Panel de Percentiles de Ocupación de Aulas Físicas:** switcher con `Día (Hoy)`, `Mañana`, `Semana` y `Mes`, calculando métricas de ocupación y aulas libres para el día siguiente.
- **Panel de Comisiones Asignadas vs Sin Asignar:** visualización inmediata de comisiones con y sin aula asignada programadas para mañana.
- **Panel de Aulas Físicas Asignadas vs Libres:** tarjetas detalladas con aulas libres con botón de asignación directa y aulas en uso para el día de mañana.
- **Cartelera Operativa & Agenda de Clases:** pestaña "Clases de Mañana" con listado completo de cursadas presenciales y virtuales activas del día siguiente.
- Soporte completo en backend (`backend/app/routes/api/dashboard.py`): cálculo de `tomorrow_dt`, estadísticas en `filter_stats['tomorrow']`, `tomorrow_schedule_list` y soporte de sincronización de datos con frontend BFF.
## [3.4.3] - 2026-10-07
### Añadido & Refactorizado (Sincronización Google Sheets)
- **Selección Granular de Entidades a Importar:**
- Adopción del patrón visual de tarjetas checkbox (idéntico a la Herramienta de Reinicio y Purga Académica) con accesos rápidos "Marcar Todo" y "Desmarcar Todo".
- Toggles individuales para Asignaciones de aulas (`import_reservations`), Aulas físicas y virtuales (`import_classrooms`), Comisiones de cursada (`import_commissions`), Asignaturas / Materias (`import_subjects`) y Carreras académicas (`import_careers`).
- **Selector de Días de la Semana con Checkboxes Múltiples:**
- Sistema de checkboxes para procesar concurrentemente múltiples días de la semana (Lunes a Sábado) con selectores rápidos ("Todos", "Lun a Vie", "Limpiar").
- **Grilla de Previsualización Interactiva e Inspección Previa:**
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (`preview_rows`) de registros online.
- Selección por fila mediante checkboxes individuales y checkbox maestro superior.
- Modificación manual inline de fechas de cursada por fila mediante Datepicker (`<input type="date">`) y aplicador de fecha masiva a seleccionados.
- Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
- Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
- Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
- **Backend & BFF Endpoints:**
- `POST /api/v1/dashboard/sheets-inspect` retorna metadatos y `preview_rows` con inferencia de fechas, estados de validación y carreras compartidas.
- `POST /api/v1/dashboard/sync-sheets` procesa opcionalmente `selected_rows` con fechas editadas respetando la granularidad de entidades activadas.
## [3.4.2] - 2026-10-07
### Corregido & Mejorado (UX/UI)
- **Agrupación Cronológica de Reservas en Cartelera del Día (`/schedule/today_schedule`):**
- Corrección del bug que duplicaba visualmente una misma reserva por cada hora que abarcaba la cursada (eliminación del bucle `for` de franjas horarias artificiales de 1 hora).
- Implementación de agrupación nativa por franja horaria real de cursada (`grouped_slots`, ej. `08:00 - 11:00 hs`, `18:30 - 21:00 hs`).
- Cada reserva se muestra agrupada exactamente una sola vez en su bloque horario correspondiente, mostrando turno, duración, cupo, aula física/virtual, docente y enlace de videoconferencia.
- **Optimización de Formato de Fecha y Horario en el Sistema (`/schedule/list_reservations`, etc.):**
- Reemplazo del formato ISO crudo con 'T' y segundos (`2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs`) por formato amigable en español:
- Fecha: `Jueves 08/10/2026` / `08/10/2026`.
- Horario: `08:00 - 11:00 hs`.
- Creación de la función utilitaria `formatReservationDates` en el BFF y nuevos filtros Nunjucks (`format_date_human`, `format_time`, `format_time_range`).
- Actualización de las vistas de tabla y mosaico/tarjetas en `list.html`, `today.html` y `view.html`.
## [3.4.1] - 2026-10-07
### Corregido
- **Corrección de Bug en Importador de Google Sheets (`ReferenceError: availableCareers is not defined`):**
- Declaración e inicialización con ámbito de función de `availableCareers` y `availableSubjects` en `handleGoogleSheetsImport` (`frontend/src/routes/admin.js`).
- Eliminación del error 500 al acceder por GET a `/admin/google_sheets_import` o `/admin/import`.
- **Corrección de Conteo y Renderizado de Aulas Virtuales en Dashboard de Bedelía:**
- Corrección de la lógica de obtención de datos en `backend/app/routes/api/dashboard.py` para calcular las salas virtuales disponibles a partir de las 101 comisiones virtuales activas en Campus Virtual (Google Meet / Teams / Zoom) en lugar de limitarse a la única fila relacional en `classrooms`.
- Agregado del arreglo `virtual_rooms` con metadatos completos (código de comisión, asignatura, enlace Meet, docente, cupo y turno) a los datos de Bedelía.
- Incorporación de la pestaña *"Salas Virtuales (Campus Virtual)"* en el panel de Aulas de Bedelía (`dashbede.html`), permitiendo supervisar y acceder directamente a todas las salas de videoconferencia.
### Refactorizado
- **Modularización de Vistas por Roles (`dashboard.html` como Layout Padre):**
- División de la plantilla monolítica `dashboard.html` en 4 submódulos específicos por rol:
- `dashadm.html` (Administrador)
- `dashbede.html` (Bedelía)
- `dashprof.html` (Docente / Profesor)
- `dashalum.html` (Alumno / Estudiante)
- Implementación de inyección limpia de componentes en `dashboard.html` mediante directivas `{% include %}` de Nunjucks.
### Documentación y Workflow
- **Actualización de `docs/constitution.md` (Principio 9):**
- Inclusión obligatoria del control de versión semántica al momento de compilar.
- Inclusión obligatoria del despliegue inmediato al servidor institucional de producción al finalizar la compilació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
### Añadido
- **Estandarización del Flujo Secuencial de Bedelía (9 Pasos Operativos):**
- Formalización del circuito paso a paso para reemplazar el archivo Excel manual de uso diario:
1. **Sede / Edificio (`/buildings/list_buildings`):** Creación y administración del inmueble universitario.
2. **Aula (`/classrooms/list_classrooms`):** Alta de espacios físicos y aulas virtuales con control de aforo y recursos.
3. **Ciclo Lectivo (`/admin/academic_terms_list`):** Creación del período lectivo y activación del cuatrimestre corriente.
4. **Carrera / Titulación (`/admin/careers_list`):** Creación y administración del programa académico institucional.
5. **Asignatura / Materia (`/admin/subjects_list`):** Alta en plan de estudios asociada obligatoriamente a la Carrera.
6. **Comisión (`/admin/commissions_list`):** Creación de comisiones con cupos y vinculación a la materia, ciclo lectivo y carrera asociada, con filtros directos por titulación.
7. **Asociar Profesores (`/admin/commission_detail`):** Asignación del cuerpo docente y co-docentes con roles de cátedra.
8. **Asociar Alumnos (`/admin/commission_detail`):** Matriculación con validación de restricciones horarias y excepciones de Bedelía.
9. **Reserva de Espacios (`/schedule/add_reservation` o Drag & Drop en `/schedule/calendar_view`):** Asignación de aula y franja horaria en 1 clic con chequeo de conflictos.
- **Gestión Académica en RBAC y Reestructuración de Menús UX/UI:**
- Ampliación de permisos RBAC para rol **Bedelía** permitiendo la administración total de ciclos lectivos, carreras, materias, comisiones, docentes, alumnos y reservas.
- Reorganización de la barra lateral de navegación según las mejores prácticas de IT y arquitectura de la información: menús especializados y directos para **Administrador**, **Bedelía**, **Docente** y **Alumno**.
- **Control y Exposición de Versiones Institucionales (v3.3.0):**
- Estandarización de número de versión en Backend (`__version__ = "3.3.0"`, `/api/v1/version`, `/api/v1/health`) y Frontend BFF (`package.json`, `/version`).
- Badges de versión visibles y legibles en el pie del menú lateral (`sidebar-footer`) y en la pantalla de inicio de sesión (`login.html`).
- **Corrección de Error en Catálogo de Aulas (`/classrooms/list_classrooms`):**
- Resolución del error 500 (`Template render error: unknown block tag: endblock`) balanceando los bloques condicionales de Nunjucks entre los modos presencial y virtual.
- **Alineamiento de Documentación con SSD (Software System Design):**
- **Constitución del Sistema (`docs/constitution.md`):** Actualización con principios innegociables: arquitectura desacoplada REST + BFF, reemplazo definitivo del Excel, matriz de conflictos, caché de Moodle 4.1, y RBAC seguro.
- **Manual de Agentes (`AGENTS.md`):** Definición precisa del stack, comandos de desarrollo y pruebas, convenciones y límites.
- **Memoria Operativa (`MEMORY.md`):** Sincronización del estado de desarrollo para el Sprint Bedelía MVP.
- **Roadmap del Proyecto (`ROADMAP.md`):** Creación en la raíz del proyecto detallando el progreso y las metas del MVP.
- **Guía Operativa por Rol (`docs/GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md`):** Manual exhaustivo con paso a paso para Bedelía, Docentes y Alumnos.
- **Mantenimiento del Importador de Google Sheets:**
- Preservación del servicio `sheets_importer.py` para ingesta masiva inicial sin fricción para el personal.
--- ---
## [3.2.0] - 2026-09-23 ## [3.2.0] - 2026-09-23
+198
View File
@@ -0,0 +1,198 @@
# MEMORY.md - admin-edu-space
Memoria del proyecto entre sesiones para la rama `dev`.
## Estado actual
- Fases 0 a 5.1 del Roadmap completadas y estabilizadas:
- Arquitectura desacoplada: Backend Flask REST API (:5000) + Frontend BFF Node.js/Express (:3000).
- Cobertura 100% ABM: Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas.
- Matriz integral de conflictos (físico, docente con co-docencia, aforo y restricción diaria del alumno).
- 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: MVP del Sistema de Bedelía — Reemplazo Definitivo del Excel**:
- Reemplazar la planilla Excel manual como herramienta operativa diaria de Bedelía.
- La plataforma asume el rol de fuente única de verdad para la asignación y gestión de cursadas.
- Las planillas/Google Sheets se mantienen únicamente para importación masiva de datos iniciales.
## 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.
- **Asociación Explícita de Carreras**: Toda Asignatura se vincula a su Carrera y toda Comisión hereda y expone la Carrera, permitiendo filtros y búsquedas específicas por titulación.
- **Importador de Google Sheets Preservado**: Se conserva como ingestor inicial masivo sin fricción para no interrumpir el flujo actual del personal.
- **Guía Operativa por Rol**: Documentar explícitamente el procedimiento para Bedelía, Docentes y Alumnos para facilitar la adopción inmediata.
## Aprendizajes y errores a evitar
- **Colisiones Virtuales**: En aulas virtuales no debe aplicarse colisión física horaria; múltiples comisiones pueden cursar simultáneamente con enlaces independientes.
- **Manejo de Estados Vacíos (Empty States)**: Proteger siempre las vistas de plantillas en Nunjucks contra colecciones vacías para evitar errores 500 cuando se reinicializa la base.
- **Seguridad de Secretos**: Mantener `.credenciales` y `.env` estrictamente fuera del índice de Git.
- **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.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.
- **Corrección de Vistas de Bedelía (Reservas de Hoy, Semana, Aulas Libres y Comisiones Sin Aula)**:
- **Causa Raíz de Reservas Vacías**: `sheets_importer.py` generaba reservas únicamente para `weeks_to_generate = 4` a partir del 31 de agosto de 2026 (finalizando el 26 de septiembre). En la fecha actual de octubre de 2026 (`2026-10-07`), la base de datos tenía 0 reservas para el día y la semana. Se amplió a `weeks_to_generate = 16` cubriendo todo el 2° cuatrimestre regular (hasta el 19 de diciembre de 2026), generando **2464 reservas totales**, **34 clases para hoy** y **154 clases para la semana actual**.
- **Fecha Dinámica en Cartelera**: Se corrigió `handleTodaySchedule` en `frontend/src/routes/schedule.js` que tenía hardcodeado `2026-09-18` como fecha por defecto, reemplazándolo por la fecha actual ISO (`new Date().toISOString().split('T')[0]`) y añadiendo navegación interactiva entre días (`prev_date`, `next_date`, y botón "Hoy").
- **Panel Operativo de Cartelera & Agenda en Dashboard**: Se incorporó en el Dashboard de Bedelía la sección "Cartelera Operativa & Agenda de Clases" con tabs dinámicos para alternar entre "Clases de Hoy" y "Esta Semana", visualizando horario, aula física o sala virtual (con enlace directo a Meet), materia, comisión, turno y docente.
- **Aulas Disponibles por Período**: Se agregó el selector interactivo "Hoy" (con 18 aulas libres detectadas para el día), "Esta Semana" y "Este Mes" en el panel `#bedelia-available-classrooms`, permitiendo asignar aulas libres con un clic.
- **Comisiones Sin Aula Física ni Virtual**: Se agregó el tab "Sin Aula Física ni Virtual (General)" en `#bedelia-unassigned-commissions` para identificar comisiones sin asignación de espacio, y se añadió la columna "Espacio / Aula" con filtro rápido `unassigned_room=true` en `/admin/commissions_list`.
- **Filtrado Temporal de Aulas y Comisiones (Día, Semana y Mes)**:
- **Requerimiento**: Poder filtrar tanto **Aulas Asignadas** vs **Aulas Sin Asignar (Libres)** como **Comisiones Asignadas** vs **Comisiones Sin Asignar** por **Día**, **Semana** y **Mes**, con la opción de **Día por defecto** y aclarando la **fecha explícita** para fácil identificación de todos los usuarios.
- **Backend (`dashboard.py`)**: Se calculan estructuras `filter_stats` para los tres períodos (`today`, `week`, `month`) con métricas precisas (counts, porcentajes) y diccionarios legibles `date_labels` en español ("Hoy · Miércoles 07/10/2026", "Semana del 05/10 al 11/10/2026", "Mes de Octubre 2026").
- **Frontend BFF & UI (`dashboard.js`, `dashboard.html`)**:
- **Panel de Percentiles**: Switcher interactivo `[ Día (Hoy) ]` (activo por defecto), `[ Semana ]` y `[ Mes ]` con badge explícito de fecha y barras reactivas.
- **Panel de Comisiones**: Switcher `[ Día (Hoy) ]`, `[ Semana ]`, `[ Mes ]` con badge de fecha explícita, más pestañas para conmutar entre "Comisiones Asignadas (Con Aula)" y "Comisiones Sin Asignar (Pendientes)" con acciones directas para asignar espacio.
- **Panel de Aulas**: Switcher `[ Día (Hoy) ]`, `[ Semana ]`, `[ Mes ]` con badge de fecha explícita, más pestañas para conmutar entre "Aulas Sin Asignar (Libres)" y "Aulas Asignadas (En Uso)" con acceso directo a cartelera o asignación inmediata.
- **Validación en Producción**: Desplegado en `https://eduspace.oemspot.com.ar` y verificado con éxito (HTTP 200 en login de Bedelía y renderizado exacto de datos reales).
- **Evolución del Importador de Google Sheets (Filtros por Carrera, Materia, Día y Fecha Manual)**:
- **Requerimiento**: Permitir filtrar qué Carrera, qué Materia y qué Día importar desde el Google Sheet online de UniCABA, como así también agregar la fecha manualmente para corregir o evitar errores si el Sheet no tiene la fecha o se requiere asignar una clase puntual en el calendario.
- **Backend (`sheets_importer.py` & `dashboard.py`)**:
- Se implementó `inspect_sheet_content()` que descarga e inspecciona las 6 hojas del Sheet online en ~7s, descubriendo de forma dinámica todas las Carreras únicas (18 carreras detectadas) y Materias únicas (206 materias detectadas).
- Se agregaron los parámetros `filter_career`, `filter_subject`, `filter_day`, `manual_date` y `single_date_only` al método `sync(...)`.
- Normalización robusta de días con `normalize_day_name(...)` insensible a acentos y mayúsculas.
- Soporte de coincidencia parcial y sensible a carreras compuestas (ej: `DATOS (CCC)` coincide con asignaturas compartidas con `TEC. DIG.` y `VIDEOJUEGOS`).
- Soporte de asignación de fecha puntual manual (`single_date_only=True`), creando 1 única reserva para esa fecha exacta en vez de las 16 semanas regulares, o tomando la fecha manual como base del cuatrimestre.
- Nuevo endpoint REST `GET/POST /api/v1/dashboard/sheets-inspect` y actualización de `/api/v1/dashboard/sync-sheets`.
- **Frontend BFF & UI (`admin.js` & `import.html`)**:
- Panel interactivo "Sincronización Académica con Filtros Avanzados y Control de Fecha".
- Selectores dinámicos de Día (Todos, Lunes, Martes, etc.), inputs con autocompletado `<datalist>` para Carreras y Materias.
- Selector interactivo de Fecha Manual (`type="date"`) con switch toggle para "Importar ÚNICAMENTE para esta fecha puntual".
- Botón "Inspeccionar Sheet Online" con llamada AJAX a `/admin/sheets_inspect` que carga en vivo las carreras y materias descubiertas.
- Tarjeta de informe detallado post-sincronización con badges temáticos de "Filtros Activos", número de "Filas Coincidentes" vs totales, y modo de generación.
- **Validación en Producción**:
- Pruebas automatizadas de backend: 49 tests aprobados en pytest (100% passed).
- Desplegado en producción institucional (`https://eduspace.oemspot.com.ar`).
- Verificación online con `bedelia@edu-space.com`: HTTP 200 en `/admin/google_sheets_import`, endpoint `/admin/sheets_inspect` retornando 239 filas y 18 carreras, y sincronización filtrada con éxito (ej. Martes + DATOS procesando exactamente sus 3 filas coincidentes).
- **Sprint v3.4.1: Corrección de Bug en Import Sheet, Aulas Virtuales en Bedelía, Modularización de Vistas y Reglas de Workflow**:
- **Fix Bug Google Sheets Import (`Error loading Google Sheets sync view`)**:
- **Causa Raíz**: `availableCareers` y `availableSubjects` se declaraban únicamente dentro de un bloque condicional en `admin.js`, provocando `ReferenceError: availableCareers is not defined` en peticiones GET normales.
- **Solución**: Se declararon e inicializaron a nivel de función `handleGoogleSheetsImport` tanto en la consulta inicial de `Promise.allSettled` como en el refresh posterior a la sincronización.
- **Fix Bug Aulas Virtuales en Dashboard de Bedelía**:
- **Causa Raíz**: El conteo `virtual_classrooms` en `dashboard.py` calculaba `len(virtual_classrooms_list)` sobre la tabla relacional `classrooms`, que solo contiene 1 registro genérico (`id: 331, code: 'VIRTUAL', building: 'Campus Virtual'`).
- **Solución**: Se actualizó la lógica para calcular las salas virtuales a partir de las comisiones activas con modalidad virtual (Google Meet/Teams/Zoom) o reservas en Campus Virtual, reportando las 101 salas virtuales activas. Se incorporó el arreglo `virtual_rooms` en `role_data` de Bedelía y se agregó la pestaña *"Salas Virtuales (Campus Virtual)"* con 127 enlaces a Google Meet en el panel de Aulas (`dashbede.html`).
- **Modularización de la Arquitectura de Vistas (`dashboard.html` como Layout Padre)**:
- Se dividió el archivo monolítico `dashboard.html` de más de 2300 líneas en 4 componentes/subvistas según el rol del usuario:
- `dashadm.html` (Administrador)
- `dashbede.html` (Bedelía)
- `dashprof.html` (Docente / Profesor)
- `dashalum.html` (Alumno / Estudiante)
- `dashboard.html` actúa ahora como layout/plantilla padre limpia que inyecta la subvista correspondiente mediante `{% include %}` de Nunjucks.
- **Actualización de Reglas en `docs/constitution.md` (Principio 9)**:
- Se agregó el Principio 9 innegociable:
1) Siempre actualizar y guardar el control de la nueva versión semántica al momento de compilar.
2) Al finalizar la compilación, siempre subir y desplegar la nueva versión al servidor institucional de producción.
- **Despliegue y Verificación en Producción**:
- Versionado elevado a `v3.4.1`.
- Desplegado exitosamente en el servidor LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- Verificación HTTP 200 en `/version`, login admin, `/admin/google_sheets_import`, dashboards modularizados de los 4 roles y cuenta institucional de Bedelía.
- **Sprint UX/UI: Agrupación Cronológica de Reservas y Formato Limpio de Fechas (v3.4.2)**:
- **Problema 1: Duplicación de Reservas por Hora en Cartelera**:
- En `/schedule/today_schedule`, un bucle fijo `for (let hour = 7; hour <= 21; hour++)` insertaba la misma reserva en cada bloque horario de 1 hora que abarcaba la materia (ej. Marketing Digital de 08:00 a 11:00 hs aparecía repetida a las 8, 9 y 10).
- **Solución**: Se eliminó la clonación artificial y se introdujo la agrupación nativa por franja horaria real de cursada (`grouped_slots`, ej. `08:00 - 11:00 hs`, `18:30 - 21:00 hs`). Cada reserva aparece agrupada exactamente UNA SOLA VEZ en su bloque horario correspondiente con turno, duración, aula, cupo y enlace a Meet/Zoom.
- **Problema 2: Formato ISO Crudo en Listado de Reservas**:
- En `/schedule/list_reservations` (tabla y tarjetas) se mostraban strings crudos con 'T' y segundos (`2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs`).
- **Solución**: Se enriquecieron todas las reservas con la función `formatReservationDates` y nuevos filtros Nunjucks (`format_date_human`, `format_time`, `format_time_range`), mostrando fecha limpia (`Jueves 08/10/2026` / `08/10/2026`) y horario amigable (`08:00 - 11:00 hs`).
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.2` en Frontend y Backend.
- Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente.
- **Sprint Importador Google Sheets: Selección Granular y Grilla Interactiva (v3.4.3)**:
- **Selección Granular de Entidades (Tarjetas Checkbox)**:
- Réplica del diseño visual de la Herramienta de Purga con botones "Marcar Todo" y "Desmarcar Todo".
- Toggles individuales para Asignaciones de aulas (`import_reservations`), Aulas físicas y virtuales (`import_classrooms`), Comisiones (`import_commissions`), Asignaturas (`import_subjects`) y Carreras (`import_careers`).
- **Selector de Días de la Semana con Checkboxes Múltiples**:
- Reemplazo del selector simple por checkboxes individuales para Lunes a Sábado con accesos rápidos ("Todos", "Lun a Vie", "Limpiar").
- **Grilla de Previsualización Interactiva e Inspección Previa**:
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (`preview_rows`) de registros online.
- Selección individual por fila y checkbox maestro superior.
- Modificación manual inline de fechas de cursada por fila mediante Datepicker (`<input type="date">`) y aplicador de fecha masiva a seleccionados.
- Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
- Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
- Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
- **Backend y BFF REST**:
- `sheets_importer.py` ampliado para retornar `preview_rows` y procesar `selected_rows` con granularidad de entidades.
- Endpoints `POST /api/v1/dashboard/sheets-inspect` y `POST /api/v1/dashboard/sync-sheets`.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.3` en Frontend y Backend.
- Despliegue y verificación en caliente en el servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- **Sprint Dashboard Bedelía: Filtro Temporal "Mañana" en Switchers y Cartelera (v3.4.4)**:
- **Requerimiento**: Agregar "Mañana" en el filtro actual del dashboard que decía "Día (Hoy) / Semana / Mes".
- **Implementación**:
- **Backend API (`backend/app/routes/api/dashboard.py`)**: Cálculo de `tomorrow_dt` (00:00:00 a 23:59:59), agregando estadísticas en `filter_stats['tomorrow']` para percentiles de aulas físicas y comisiones asignadas/sin asignar, y `tomorrow_schedule_list` para la agenda de clases.
- **Frontend BFF & Vistas (`frontend/views/dashboard/dashbede.html`, `dashbede.html`, `dashadm.html`, `dashboard.html`)**:
- Switcher de percentiles: botón "Mañana" con actualización dinámica de percentiles de ocupación de aulas físicas.
- Switcher de comisiones: botón "Mañana" y bloques `#commBlock-tomorrow-unassigned` y `#commBlock-tomorrow-assigned`.
- Switcher de aulas físicas: botón "Mañana" y bloques `#classBlock-tomorrow-unassigned` (aulas libres con botón "Asignar") y `#classBlock-tomorrow-assigned` (aulas en uso).
- Cartelera Operativa & Agenda de Clases: botón "Clases de Mañana" y tabla `#bedeliaScheduleTomorrow` mostrando asignaturas, comisiones, docentes y enlaces para mañana.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.4` en Frontend y Backend.
- Despliegue al servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación en caliente.
- **Sprint Optimizador de Aulas IA: Corrección de Permisos y Carga de Comisiones (v3.4.5)**:
- **Problema Reportado**: AI Room Reservation Optimizer no mostraba comisiones y los indicadores de Available Classrooms, Active Commissions y Existing Reservations quedaban en `--`.
- **Causa Raíz Identificada**:
- En `backend/app/routes/genetic_algorithm.py` las rutas `@genetic_bp.route('/commissions')`, `/algorithm-status`, `/preview-optimization`, `/optimize` y `/apply-optimization` exigían de forma estricta `g.jwt_user.role in ['ADMIN', 'teacher']` o `g.jwt_user.role in ['ADMIN']`.
- Al ingresar como Bedelía (`role == 'Bedelia'`), Docentes o Administradores con rol en minúsculas, el backend devolvía `403 Forbidden`, bloqueando la llamada AJAX y dejando la interfaz vacía con `--`.
- En el Frontend BFF, la ruta `/genetic_optimizer` no requería `requireAuth` ni pasaba datos de sesión de usuario a la plantilla.
- **Solución Implementada**:
- Creación del helper `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` habilitando acceso a `admin`, `administrador`, `bedelia`, `docente`/`teacher` y permisos RBAC en 'optimizer'.
- `GET /api/genetic/commissions` ahora enriquece los objetos con `subject_name`, `subject_code`, `career_name`, `schedule` y `shift`.
- `frontend/views/genetic_optimizer.html`: Traducido íntegramente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas de comisiones con badges, buscador en vivo multi-criterio y manejo de errores visual.
- `frontend/public/js/genetic-algorithm.js`: Traducción de alertas, modales y tablas de resultados.
- `frontend/src/app.js`: Protección con `requireAuth` e inyección de sesión a la vista.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.5` en Frontend y Backend.
- Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente HTTP 200.
- **Sprint v3.4.6: Corrección Integral de Reservas, Pisos Dinámicos, Fechas Humanas y Filtro de Carreras**:
- **Incidencias Resueltas**:
1. `/schedule/add_reservation` y `/schedule/edit`: Corregido error de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar "Edificio Central". Inyección segura sin entities y matching resiliente de pisos físicos y virtuales.
2. `/schedule/calendar_view`: Limpieza de datos hardcodeados/mockeados (`Arquitectura de Software ARQ-101`, `COM-A`, `Licenciatura en Sistemas`). El feed y filtros ahora consumen asignaturas, carreras y comisiones reales de la BD.
3. `sheets_importer.py`: Eliminada la autogeneración no deseada de enlaces de Google Meet / Zoom (`meet.google.com/edu-...`) en reservas importadas cuando la celda original está vacía (ej. `#9797 ASIG00215 - Marketing Digital`).
4. `/classrooms/view_classroom`: Formateadas fechas y horarios a español legible (ej. `Viernes 04/09/2026 · 18:30 a 21:30 hs`) eliminando formato ISO repetido y ampliando rango a todo el semestre 2026.
5. `/buildings/list_buildings` y `/buildings/view/:id`: Corregida la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas físicas asociadas (`floors_list` y `classrooms_by_floor`), corregido el contador de "Pisos Presenciales" (4 pisos) y soporte completo de niveles dinámicos alfanuméricos (PB, EP, Subsuelo, etc.).
6. `/admin/commissions_list`: Corregido `UnboundLocalError` en `backend/app/routes/api/admin.py` por importación interna tardía de `Career`, que arrojaba HTTP 500 al filtrar por `career_id=180, 181, 182`.
- **Sprint v3.4.8: Registro de Auditoría Institucional y Trazabilidad Operativa**:
- **Incidencias y Mejoras**:
1. `/api/v1/admin/audit-logs`: Implementación del endpoint RESTful con paginación, filtros por módulo (`auth`, `reservations`, `classrooms`, `buildings`, `optimizer`, `admin`, etc.), acción (`LOGIN`, `LOGIN_FAILED`, `CREATE`, `UPDATE`, `DELETE`, `CONFIRM`, etc.) y búsqueda multi-campo.
2. Modelo `AuditLog`: Agregado método `to_dict()` para serialización JSON segura e ISO.
3. `AuditService`: Soporte de parámetros explícitos `user_id` y `user_email` para registrar eventos cuando el usuario no está autenticado o el intento de acceso falla.
4. `/api/v1/auth/`: Instrumentada la captura de inicios de sesión (`LOGIN`), Google OAuth (`LOGIN_GOOGLE`), Moodle delegado (`LOGIN_MOODLE`), fallos de inicio de sesión (`LOGIN_FAILED`), accesos bloqueados (`LOGIN_BLOCKED`), cierres de sesión (`LOGOUT`) y cambios de contraseña institucional (`PASSWORD_CHANGE`).
5. `/api/v1/reservations`: Auditoría de creación (`CREATE`), edición (`UPDATE`), cancelación (`CANCEL`), borrado permanente (`DELETE`) y confirmación oficial (`CONFIRM`).
6. `/api/v1/classrooms` y `/api/v1/buildings`: Auditoría de altas, modificaciones, alternancia de estado activo/inactivo (`TOGGLE`) y bajas.
7. Optimizador Genético IA: Auditoría de ejecuciones (`OPTIMIZE_RUN`) y aplicación de asignaciones masivas en base de datos (`OPTIMIZE_APPLY`).
8. Frontend BFF (`/admin/audit_logs`): Conexión del BFF con la REST API, badges temáticos e intuitivos, filtros rápidos por categorías, visor modal para detalles extensos o JSON, y paginador dinámico nativo que preserva parámetros de consulta.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.8` en Frontend y Backend.
- **Sprint v3.4.9: Solución de Límite de Payload en Importador de Sheets & Diagnóstico Transparente de Incidentes**:
- **Incidencias y Mejoras**:
1. `frontend/src/app.js`: Elevado límite de `express.json` y `express.urlencoded` de 100 KB por defecto a 50 MB (`{ limit: '50mb' }`), resolviendo el error `PayloadTooLargeError: request entity too large: expected 154166, length 154166, limit 102400` que provocaba HTTP 500 al enviar la matriz de filas preseleccionadas en `/admin/google_sheets_import`.
2. Manejo de Incidentes y Diagnóstico Transparente: Reemplazo total de la pantalla genérica de error por una interfaz estructurada con código de ticket único (`INC-YYYYMMDD-XXXX`), diagnóstico descriptivo clasificado, sección técnica de diagnóstico colapsable (Ruta, Timestamp, Usuario actuante, IP, Stack trace), botón para copiar reporte a soporte IT y enlace directo a la Auditoría Institucional.
3. `backend/app/routes/api/admin.py`: Nuevo endpoint `/api/v1/admin/log-error` para registrar incidentes técnicos no controlados del frontend directamente en `AuditLog` (`action='SYSTEM_ERROR'`, `module='system'`).
4. `backend/app/routes/api/dashboard.py`: Instrumentada auditoría completa en `sync_google_sheets` para registrar tanto importaciones exitosas (`SHEETS_IMPORT`) como fallos (`SHEETS_IMPORT_ERROR`) con desglose de estadísticas y excepciones.
- **Sprint v3.5.0: Cierre Formal del MVP de Bedelía & Adopción del Arnés SDD / IA**:
- **Metodología y Arnés de Ingeniería con IA (Apuntes Día 1, 2 y 3)**:
1. Creación de la Skill de SDD (`.agents/skills/sdd/SKILL.md`) con las plantillas de `spec.md`, `plan.md`, `tasks.md` y sintaxis formal **EARS** en español.
2. Creación de comandos reutilizables de agentes en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`).
3. Definición de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA).
4. Integración del arnés en `AGENTS.md`.
- **Diagnóstico y Cierre de Brecha del MVP**:
- Se identificó la causa raíz de la percepción de "estar lejos": el *Scope Creep* sin especificación formal de cierre y la falta de exportación/impresión de carteleras que forzaba a Bedelía a recurrir al Excel para imprimir o compartir partes con portería y docentes.
- Se formalizó la primera especificación oficial del proyecto en `specs/001-cierre-mvp-bedelia/` (`spec.md`, `plan.md`, `tasks.md`), delimitando de forma estricta los Requisitos Funcionales en **EARS** y estableciendo un perímetro cerrado de **Fuera de Alcance**.
- **Implementación Técnica**:
1. `frontend/src/routes/schedule.js`: Endpoint `/schedule/export_csv` con codificación UTF-8 BOM (`\uFEFF`) y delimitadores `;` para apertura nativa e inmediata en Microsoft Excel en español.
2. `frontend/views/schedule/today.html`: Botones directos `[ Excel / CSV ]` e `[ Imprimir ]`, acompañados de estilos CSS `@media print` que formatean la grilla de asignaciones en hoja A4 limpia con membrete institucional oficial de UniCABA.
3. `frontend/views/dashboard/dashbede.html`: Accesos rápidos en el Launchpad operativo de Bedelía para descargar la planilla del día e imprimir en 1 clic.
- **Calidad y Bump Semántico (Principio 9)**:
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`).
- Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
## Próximos pasos
1. Desplegar la versión `v3.5.0` al servidor institucional de producción (`10.0.0.217` / `eduspace.oemspot.com.ar`) conforme al Principio 9.
2. Realizar la prueba de aceptación en vivo con el personal de Bedelía imprimiendo y exportando la cartelera real.
3. Iniciar la Fase 6 de hardening y orquestación de contenedores en Docker-compose.
+11 -9
View File
@@ -4,22 +4,24 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor
El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo. El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
**Versión Actual:** `3.1.0` (Fases 0 a 5 completadas, Fase 5.1 Bedelía UX & ABMs finalizada) **Versión Actual:** `3.5.0` (Cierre Formal MVP Bedelía, SDD & Despliegue Continuo con `.credenciales`)
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
--- ---
## 🗺️ Estado del Roadmap MVP ## 🗺️ Estado del Roadmap MVP
``` ```
Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado) Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado)
Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado) Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado)
Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado) Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado)
Fase 3: Hitos Evaluativos y Calificaciones[████████████████████] 100% (Completado) Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
Fase 4: UI/UX Drag & Drop e Impersonación[████████████████████] 100% (Completado) Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado) Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
Fase 5.1: Bedelía UX, ABMs y Purga Datos [████████████████████] 100% (Completado) Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
Fase 6: Despliegue Producción e Infraest.[███████░░░░░░░░░░░░░] 35% (En Curso) Sprint MVP: Flujo 9 Pasos & Cierre de Bedelía [████████████████████] 100% (Entregado v3.5.0)
Fase 6: Despliegue Producción e Infraest. [███████░░░░░░░░░░░░░] 45% (En Curso)
``` ```
--- ---
+110
View File
@@ -0,0 +1,110 @@
# ROADMAP OFICIAL — Sistema Integral UniCABA (Admin Edu-Space)
## 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.5.0 (Cierre Formal MVP Bedelía, SDD & Exportador de Cartelera)
**Fecha de Actualización:** 16 de Octubre de 2026
**Rama Base:** `dev`
---
## 🗺️ Visión del Proyecto y Objetivo del Sprint
Consolidar la plataforma **Admin Edu-Space** como el sistema integral de gestión áulica y académica para **UniCABA**, **reemplazando definitivamente el archivo Excel que el personal de Bedelía utiliza para su gestión diaria**. A partir de este hito, la plataforma se convierte en la fuente única de verdad para la asignación de espacios, horarios y docentes, relegando las planillas externas a un simple mecanismo de importación masiva de datos iniciales.
---
## 📊 Estado Global de Progreso
```
Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado)
Fase 1: Paridad Legacy, Virtualidad y Dashboards[████████████████████] 100% (Completado)
Fase 2: Co-docencia y Matriz de Conflictos [████████████████████] 100% (Completado)
Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
Sprint MVP: Flujo Bedelía & Reemplazo Excel [████████████████████] 100% (Entregado v3.5.0)
Fase 6: Despliegue en Servidores y Hardening [█████████░░░░░░░░░░░] 45% (En Curso)
```
---
## 🚀 Detalle de Fases y Entregables
### Fase 0: Desacople y Arquitectura Base ✅ *(Completada)*
- [x] Backend Flask como API REST pura bajo `/api/v1/` retornando exclusivamente JSON.
- [x] Frontend BFF en Node.js + Express con renderizado de plantillas Nunjucks.
- [x] Autenticación desacoplada con tokens JWT en Cookie `HttpOnly` segura.
- [x] Pipeline de seguridad `SecurityFilterChain` con blindaje OWASP y rate limiting.
- [x] Cliente Axios centralizado con interceptor Bearer token automático.
### Fase 1: Paridad Legacy, Virtualidad y Dashboards Especializados ✅ *(Completada)*
- [x] Importador de Google Sheets corregido: eliminación de colisiones en aulas virtuales múltiples (`Campus Virtual · VIRTUAL`).
- [x] Dashboards específicos e interactivos para **Bedelía**, **Docente**, **Alumno** y **Administrador**.
- [x] Cartelera del Día (`today_schedule`) con bloques horarios (07:00 a 22:00 hs) y filtros dinámicos.
- [x] Generación y persistencia de enlaces de Google Meet institucional por comisión y reserva.
### Fase 2: Co-docencia, Matriz de Conflictos y Regla Diaria ✅ *(Completada)*
- [x] Tabla relacional `commission_teachers` para soportar múltiples docentes por comisión (titulares, adjuntos, ayudantes).
- [x] Matriz de conflictos con validación física estricta, chequeo de aforo de seguridad y superposición docente.
- [x] Excepción de superposición justificada por co-docencia activa.
- [x] Regla restrictiva de cursada diaria para estudiantes con bypass por curso corto (`is_short_course`) o excepción expresa de Bedelía.
### Fase 3: Hitos Evaluativos y Libro de Calificaciones (*Gradebook*) ✅ *(Completada)*
- [x] Programación y calendario de parciales, recuperatorios, entregas y exámenes finales.
- [x] Matriz de carga rápida de notas con autoguardado asíncrono y promedios en tiempo real.
- [x] Cierre formal e inmutable de actas con número oficial (`ACTA-YYYY-Sem-ID`) y registro de auditoría.
- [x] Consulta de calificaciones y estado de regularidad para alumnos.
### Fase 4: UI/UX Avanzada para Bedelía & Modo Impersonación ✅ *(Completada)*
- [x] Grilla semanal interactiva (Drag & Drop) con FullCalendar y barra lateral de comisiones sin aula.
- [x] Detección visual de colisiones en tiempo real con reversión automática y mensajes de alerta.
- [x] Modo de impersonación administrativa (*login as*) con cabecera `X-Impersonate-User` y banner visual ámbar.
- [x] Integración de Optimizador Genético heurístico acoplado a turnos académicos reales.
### Fase 5: Integración Auth, Email y Moodle 4.1 ✅ *(Completada)*
- [x] Panel de configuración global administrativa con contraseñas cifradas vía Fernet.
- [x] Capa de caché híbrida (`CacheService` en Redis/memoria) y cola asíncrona tolerante a fallos (`MoodleSyncTask` con DLQ).
- [x] Autenticación híbrida: Google OAuth 2.0 (`@unicaba.edu.ar`), Moodle SSO y Login Local con fallback.
- [x] Motor de notificaciones transaccionales por email (`EmailService`) para docentes.
### Fase 5.1: Cobertura ABM 100% y Mantenimiento Seguro ✅ *(Completada)*
- [x] ABMs completos y protegidos para **Sedes/Edificios**, **Aulas (físicas/virtuales)**, **Ciclos Lectivos**, **Carreras**, **Materias**, **Comisiones** y **Reservas**.
- [x] Módulo de Reinicio Total del Sistema (`POST /api/v1/admin/system/reset`) con validación obligatoria de contraseña de Administrador y preservación de cuentas y roles RBAC.
- [x] Soporte de inicialización limpia (`--empty-academic` / `--no-demo`) para arranque desde cero.
---
### Sprint Activo: Flujo Completo de Bedelía & Reemplazo Definitivo de Excel 🏛️ ⚡ *(En Curso)*
* **Objetivo:** Permitirle a Bedelía gestionar íntegramente el ciclo de asignaciones académicas sin depender de planillas de cálculo, estandarizando el flujo de trabajo en 9 pasos secuenciales:
1. [x] **Paso 1 — Sede / Edificio:** Alta y mantenimiento del espacio físico (`/buildings/list_buildings`).
2. [x] **Paso 2 — Aula (Física / Virtual):** Definición de espacios, capacidades de aforo y recursos (`/classrooms/list_classrooms`).
3. [x] **Paso 3 — Ciclo Lectivo:** Definición del período académico y activación del cuatrimestre vigente (`/admin/academic_terms_list`).
4. [x] **Paso 4 — Carrera / Titulación:** Alta del programa académico o plan de estudios (`/admin/careers_list`).
5. [x] **Paso 5 — Asignatura / Materia:** Alta en el plan de estudios vinculada obligatoriamente a la Carrera (`/admin/subjects_list`).
6. [x] **Paso 6 — Comisión:** Creación de comisiones vinculadas a la materia, carrera y ciclo lectivo con filtrado y visualización contextual (`/admin/commissions_list`).
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`).
* **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:**
- [x] Verificación en contenedor LXC productivo (`10.0.0.217` / `eduspace.oemspot.com.ar`).
---
### Fase 6: Despliegue en Servidores y Hardening 🏢 *(Planificada)*
- [ ] Automatización de workers persistentes en systemd para la cola asíncrona de Moodle.
- [ ] Configuración optimizada de `docker-compose.yml` de producción.
- [ ] Pruebas de estrés de concurrencia y validación final de performance sub-segundo.
+1
View File
@@ -6,6 +6,7 @@ from flask_babel import Babel, gettext as _
from config.config import Config from config.config import Config
# Initialize extensions # Initialize extensions
__version__ = "3.5.0"
db = SQLAlchemy() db = SQLAlchemy()
migrate = Migrate() migrate = Migrate()
cors = CORS() cors = CORS()
+3
View File
@@ -16,6 +16,9 @@ class AcademicTerm(db.Model):
is_active = db.Column(db.Boolean, default=True, nullable=False) is_active = db.Column(db.Boolean, default=True, nullable=False)
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
+28
View File
@@ -21,5 +21,33 @@ class AuditLog(db.Model):
# Relación con usuario # Relación con usuario
user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('audit_records', lazy='dynamic')) user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('audit_records', lazy='dynamic'))
def __init__(self, user_id=None, user_email=None, action=None, module=None, entity_id=None, details=None, ip_address=None, **kwargs):
super().__init__(
user_id=user_id,
user_email=user_email,
action=action,
module=module,
entity_id=entity_id,
details=details,
ip_address=ip_address,
**kwargs
)
def __repr__(self): def __repr__(self):
return f"<AuditLog #{self.id} {self.action} on {self.module} by {self.user_email or 'System'}>" return f"<AuditLog #{self.id} {self.action} on {self.module} by {self.user_email or 'System'}>"
def to_dict(self):
"""Serializa el registro de auditoría a diccionario JSON."""
return {
'id': self.id,
'user_id': self.user_id,
'user_email': self.user_email,
'action': self.action,
'module': self.module,
'entity_id': self.entity_id,
'details': self.details,
'ip_address': self.ip_address,
'created_at': self.created_at.strftime('%Y-%m-%d %H:%M:%S') if self.created_at else None,
'created_at_iso': self.created_at.isoformat() if self.created_at else None
}
+3
View File
@@ -17,6 +17,9 @@ class Building(db.Model):
# Relationships # Relationships
classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id') classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id')
def __init__(self, **kwargs):
super().__init__(**kwargs)
@property @property
def is_virtual(self): def is_virtual(self):
"""Identifica si la sede corresponde al Campus Virtual""" """Identifica si la sede corresponde al Campus Virtual"""
+3
View File
@@ -13,6 +13,9 @@ class Career(db.Model):
# Relationships # Relationships
subjects = db.relationship('Subject', backref='career_obj', lazy=True) subjects = db.relationship('Subject', backref='career_obj', lazy=True)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
+19 -5
View File
@@ -16,6 +16,9 @@ class Classroom(db.Model):
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
# Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms) # Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms)
@property @property
def building_rel(self): def building_rel(self):
@@ -30,13 +33,24 @@ class Classroom(db.Model):
@property @property
def floor_display(self): def floor_display(self):
"""Formato amigable para el piso: PB, Planta Baja, Piso X""" """Formato amigable y dinámico para el piso: PB, EP, Subsuelo, Piso X"""
if self.is_virtual:
return 'Campus Virtual'
f = str(self.floor).strip() if self.floor is not None else '' f = str(self.floor).strip() if self.floor is not None else ''
if f in ['0', 'PB', 'pb', 'Planta Baja', 'planta baja']: if not f:
return 'Planta Baja' return 'Planta Baja (PB)'
if f.lower().startswith('piso') or '°' in f: f_lower = f.lower()
if f in ['0', 'PB', 'pb'] or 'planta baja' in f_lower:
return 'Planta Baja (PB)'
if f in ['EP', 'ep'] or 'entrepiso' in f_lower:
return 'Entrepiso (EP)'
if f in ['SS', 'ss'] or 'subsuelo' in f_lower:
return f if 'subsuelo' in f_lower else 'Subsuelo (SS)'
if f_lower.startswith('piso') or f_lower.startswith('planta') or f_lower.startswith('nivel') or '°' in f:
return f return f
return f"Piso {f}" if f.isdigit():
return f"Piso {f}"
return f
@property @property
def is_virtual(self): def is_virtual(self):
+3
View File
@@ -35,6 +35,9 @@ class StudentEnrollment(db.Model):
student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan')) student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan')) commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
+3
View File
@@ -50,6 +50,9 @@ class MilestoneGrade(db.Model):
student = db.relationship('User', foreign_keys=[student_id], backref=db.backref('received_grades', lazy='dynamic')) student = db.relationship('User', foreign_keys=[student_id], backref=db.backref('received_grades', lazy='dynamic'))
graded_by = db.relationship('User', foreign_keys=[graded_by_user_id]) graded_by = db.relationship('User', foreign_keys=[graded_by_user_id])
def __init__(self, **kwargs):
super().__init__(**kwargs)
@property @property
def is_passed(self) -> bool: def is_passed(self) -> bool:
"""Determina si la nota está aprobada (>= 4.00 y no ausente).""" """Determina si la nota está aprobada (>= 4.00 y no ausente)."""
+6
View File
@@ -21,6 +21,9 @@ class MilestoneType(db.Model):
# Relación uno-a-muchos con AcademicMilestone # Relación uno-a-muchos con AcademicMilestone
milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan') milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan')
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
@@ -61,6 +64,9 @@ class AcademicMilestone(db.Model):
subject = db.relationship('Subject', backref=db.backref('milestones', lazy='dynamic')) subject = db.relationship('Subject', backref=db.backref('milestones', lazy='dynamic'))
commission = db.relationship('Commission', backref=db.backref('academic_milestones', lazy='dynamic', cascade='all, delete-orphan')) commission = db.relationship('Commission', backref=db.backref('academic_milestones', lazy='dynamic', cascade='all, delete-orphan'))
def __init__(self, **kwargs):
super().__init__(**kwargs)
@property @property
def tipo(self): def tipo(self):
return self.type_obj.name if self.type_obj else 'Otro' return self.type_obj.name if self.type_obj else 'Otro'
+3
View File
@@ -53,6 +53,9 @@ class Reservation(db.Model):
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
# Virtual property to convert status string to enum # Virtual property to convert status string to enum
@property @property
def status_enum(self): def status_enum(self):
+3
View File
@@ -97,6 +97,9 @@ class Role(db.Model):
permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan') permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan')
users = db.relationship('User', backref='role_obj', lazy='select') users = db.relationship('User', backref='role_obj', lazy='select')
def __init__(self, **kwargs):
super().__init__(**kwargs)
def get_permission(self, module): def get_permission(self, module):
"""Get access level string for a given module ('none', 'read', 'read_write')""" """Get access level string for a given module ('none', 'read', 'read_write')"""
for p in self.permissions: for p in self.permissions:
+3
View File
@@ -18,6 +18,9 @@ class SystemSetting(db.Model):
is_encrypted = db.Column(db.Boolean, default=False, nullable=True) is_encrypted = db.Column(db.Boolean, default=False, nullable=True)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
@classmethod @classmethod
def get_value(cls, key, default=None): def get_value(cls, key, default=None):
"""Retorna el valor tal como está almacenado en BD.""" """Retorna el valor tal como está almacenado en BD."""
+57
View File
@@ -1,6 +1,13 @@
from app import db from app import db
from datetime import datetime 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): class Subject(db.Model):
__tablename__ = 'subjects' __tablename__ = 'subjects'
@@ -18,9 +25,19 @@ class Subject(db.Model):
# Relationships # Relationships
commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan') commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan')
careers = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True))
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
"""Convert subject to dictionary""" """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 { return {
'id': self.id, 'id': self.id,
'code': self.code, 'code': self.code,
@@ -30,12 +47,18 @@ class Subject(db.Model):
'credits': self.credits, 'credits': self.credits,
'career_id': self.career_id, 'career_id': self.career_id,
'career_name': self.career_obj.name if self.career_obj else None, 'career_name': self.career_obj.name if self.career_obj else None,
'careers': all_careers,
'is_active': self.is_active, 'is_active': self.is_active,
'is_short_course': bool(self.is_short_course), 'is_short_course': bool(self.is_short_course),
'created_at': self.created_at.isoformat() if self.created_at else None, 'created_at': self.created_at.isoformat() if self.created_at else None,
'updated_at': self.updated_at.isoformat() if self.updated_at else None 'updated_at': self.updated_at.isoformat() if self.updated_at else None
} }
@property
def career(self):
"""Helper to access career_obj directly"""
return self.career_obj
def __repr__(self): def __repr__(self):
return f'<Subject {self.code}>' return f'<Subject {self.code}>'
@@ -68,6 +91,9 @@ class Commission(db.Model):
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
# Virtual property for compatibility # Virtual property for compatibility
@property @property
def is_active(self): def is_active(self):
@@ -116,6 +142,33 @@ class Commission(db.Model):
return "Sin asignar" return "Sin asignar"
return ", ".join([f"{t['name']} ({t['role']})" for t in t_list]) return ", ".join([f"{t['name']} ({t['role']})" for t in t_list])
@property
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
# Unique constraint # Unique constraint
__table_args__ = (db.UniqueConstraint('subject_id', 'code', 'semester', 'year'),) __table_args__ = (db.UniqueConstraint('subject_id', 'code', 'semester', 'year'),)
@@ -124,6 +177,10 @@ class Commission(db.Model):
return { return {
'id': self.id, 'id': self.id,
'subject_id': self.subject_id, '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, 'code': self.code,
'semester': self.semester, 'semester': self.semester,
'year': self.year, 'year': self.year,
+3
View File
@@ -26,6 +26,9 @@ class User(db.Model):
document_type = db.Column(db.String(20), default='DNI', nullable=True) document_type = db.Column(db.String(20), default='DNI', nullable=True)
document_number = db.Column(db.String(30), nullable=True, index=True) document_number = db.Column(db.String(30), nullable=True, index=True)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def get_first_name(self): def get_first_name(self):
if self.first_name: if self.first_name:
return self.first_name return self.first_name
+1 -1
View File
@@ -7,7 +7,7 @@ from app.models.role import Role, Permission, SYSTEM_MODULES, ACCESS_LEVELS
from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES
from app.models.audit_log import AuditLog from app.models.audit_log import AuditLog
from app.utils.decorators import admin_required, permission_required from app.utils.decorators import admin_required, permission_required
from sqlalchemy import or_ from sqlalchemy import or_, func
import re import re
admin_bp = Blueprint('admin', __name__, url_prefix='/admin') admin_bp = Blueprint('admin', __name__, url_prefix='/admin')
+272 -15
View File
@@ -7,10 +7,13 @@ from app.models.role import Role, Permission, SYSTEM_MODULES
from app.models.subject import Subject, Commission, CommissionTeacher from app.models.subject import Subject, Commission, CommissionTeacher
from app.models.career import Career from app.models.career import Career
from app.models.classroom import Classroom from app.models.classroom import Classroom
from app.models.building import Building
from app.models.reservation import Reservation, ReservationStatus from app.models.reservation import Reservation, ReservationStatus
from app.models.academic_term import AcademicTerm from app.models.academic_term import AcademicTerm
from app.models.milestone import MilestoneType, AcademicMilestone from app.models.milestone import MilestoneType, AcademicMilestone
from app.models.audit_log import AuditLog from app.models.audit_log import AuditLog
from app.services.audit_service import AuditService
from sqlalchemy import or_
from app.constants.document_types import DOCUMENT_TYPES, validate_document, format_document from app.constants.document_types import DOCUMENT_TYPES, validate_document, format_document
from app.services.enrollment_service import EnrollmentService from app.services.enrollment_service import EnrollmentService
from app.services.gradebook_service import GradebookService from app.services.gradebook_service import GradebookService
@@ -112,9 +115,14 @@ def get_subjects():
query = Subject.query query = Subject.query
if search: 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: 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': if active == 'true':
query = query.filter(Subject.is_active == True) query = query.filter(Subject.is_active == True)
elif active == 'false': elif active == 'false':
@@ -125,6 +133,12 @@ def get_subjects():
subjects_data = [] subjects_data = []
for s in subjects: 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({ subjects_data.append({
'id': s.id, 'id': s.id,
'code': s.code, 'code': s.code,
@@ -132,6 +146,8 @@ def get_subjects():
'career_id': s.career_id, 'career_id': s.career_id,
'career_name': s.career_obj.name if s.career_obj else (s.department or 'General'), '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, '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', 'department': s.department or 'General',
'description': getattr(s, 'description', '') or '', 'description': getattr(s, 'description', '') or '',
'credits': getattr(s, 'credits', 4), 'credits': getattr(s, 'credits', 4),
@@ -182,12 +198,17 @@ def get_careers():
def get_commissions(): def get_commissions():
search = request.args.get('search', '').strip().lower() search = request.args.get('search', '').strip().lower()
subject_id = request.args.get('subject_id', type=int) subject_id = request.args.get('subject_id', type=int)
career_id = request.args.get('career_id', type=int)
shift = request.args.get('shift', '').strip() shift = request.args.get('shift', '').strip()
active = request.args.get('active', '').strip().lower() active = request.args.get('active', '').strip().lower()
query = Commission.query query = Commission.query
if subject_id: if subject_id:
query = query.filter(Commission.subject_id == 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) | (Subject.careers.any(Career.id == career_id))
)
if shift: if shift:
query = query.filter(Commission.shift == shift) query = query.filter(Commission.shift == shift)
if active == 'true': if active == 'true':
@@ -195,9 +216,21 @@ def get_commissions():
elif active == 'false': elif active == 'false':
query = query.filter(Commission.active == False) query = query.filter(Commission.active == False)
unassigned_room = request.args.get('unassigned_room', '').strip().lower()
commissions = query.order_by(Commission.id.asc()).all() commissions = query.order_by(Commission.id.asc()).all()
subjects = Subject.query.order_by(Subject.name.asc()).all() subjects = Subject.query.order_by(Subject.name.asc()).all()
careers = Career.query.order_by(Career.name.asc()).all()
careers_data = [{'id': cr.id, 'name': cr.name, 'code': cr.code} for cr in careers]
# Pre-cargar reservas activas para enriquecer con asignación de aula
reservations_by_comm = {}
all_res = Reservation.query.filter(Reservation.commission_id.isnot(None)).order_by(Reservation.start_time.asc()).all()
for r in all_res:
if r.commission_id not in reservations_by_comm:
reservations_by_comm[r.commission_id] = r
commissions_data = [] commissions_data = []
for c in commissions: for c in commissions:
if search: if search:
@@ -206,9 +239,24 @@ def get_commissions():
if search not in s_name and search not in c_code: if search not in s_name and search not in c_code:
continue continue
career_name = 'Carrera General' res = reservations_by_comm.get(c.id)
if c.subject and hasattr(c.subject, 'career') and c.subject.career: c_room = res.classroom if res else None
career_name = c.subject.career.name c_code_val = c_room.code if c_room else None
is_virt_room = bool(c_room.is_virtual or 'virtual' in (c_room.code or '').lower() or 'virtual' in (c_room.building or '').lower()) if c_room else False
has_v_link = bool(c.virtual_link and c.virtual_link.strip())
has_classroom = bool(c_code_val or has_v_link)
if unassigned_room in ['true', '1'] and has_classroom:
continue
if unassigned_room in ['false', '0'] and not has_classroom:
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)
display_room = c_code_val or ('Campus Virtual' if has_v_link else 'Sin Aula')
commissions_data.append({ commissions_data.append({
'id': c.id, 'id': c.id,
@@ -217,7 +265,10 @@ def get_commissions():
'subject_id': c.subject_id, 'subject_id': c.subject_id,
'subject_name': c.subject.name if c.subject else 'Sin materia', 'subject_name': c.subject.name if c.subject else 'Sin materia',
'subject_code': c.subject.code if c.subject else '-', 'subject_code': c.subject.code if c.subject else '-',
'career_id': career_id_val,
'career_name': career_name, 'career_name': career_name,
'career_names': career_names,
'careers': careers_list,
'semester': getattr(c, 'semester', '1C') or '1C', 'semester': getattr(c, 'semester', '1C') or '1C',
'year': getattr(c, 'year', 2026) or 2026, 'year': getattr(c, 'year', 2026) or 2026,
'academic_term_id': getattr(c, 'academic_term_id', None), 'academic_term_id': getattr(c, 'academic_term_id', None),
@@ -230,16 +281,21 @@ def get_commissions():
'max_students': c.max_students or 35, 'max_students': c.max_students or 35,
'current_students': getattr(c, 'current_students', 0) or 0, 'current_students': getattr(c, 'current_students', 0) or 0,
'active': c.active, 'active': c.active,
'virtual_link': getattr(c, 'virtual_link', '') or '' 'virtual_link': getattr(c, 'virtual_link', '') or '',
'has_classroom': has_classroom,
'classroom_name': display_room,
'classroom_code': c_code_val,
'is_virtual': is_virt_room or has_v_link
}) })
subjects_data = [] subjects_data = []
for s in subjects: for s in subjects:
c_name = s.career.name if (hasattr(s, 'career') and s.career) else 'Carrera General' c_name = s.career_obj.name if (hasattr(s, 'career_obj') and s.career_obj) else 'Carrera General'
subjects_data.append({ subjects_data.append({
'id': s.id, 'id': s.id,
'name': s.name, 'name': s.name,
'code': s.code, 'code': s.code,
'career_id': s.career_id,
'career': c_name, 'career': c_name,
'career_name': c_name 'career_name': c_name
}) })
@@ -253,7 +309,8 @@ def get_commissions():
'total': len(commissions_data), 'total': len(commissions_data),
'commissions': commissions_data, 'commissions': commissions_data,
'subjects': subjects_data, 'subjects': subjects_data,
'academic_terms': terms_data 'academic_terms': terms_data,
'careers': careers_data
}), 200 }), 200
# --------------------------------------------------------- # ---------------------------------------------------------
@@ -712,6 +769,25 @@ def create_subject():
description=description, description=description,
is_active=bool(is_active) 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.add(subject)
db.session.commit() db.session.commit()
@@ -747,6 +823,26 @@ def update_subject(id):
c_id = data['career_id'] c_id = data['career_id']
subject.career_id = int(c_id) if c_id else None 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: if 'description' in data:
subject.description = data['description'].strip() subject.description = data['description'].strip()
@@ -844,11 +940,7 @@ def create_commission():
if not subject: if not subject:
return jsonify({'error': 'NotFound', 'message': f'La asignatura con ID {subject_id} no existe.'}), 404 return jsonify({'error': 'NotFound', 'message': f'La asignatura con ID {subject_id} no existe.'}), 404
# Generar enlace automático si no fue provisto virtual_link = (virtual_link or '').strip() or None
if not virtual_link:
s_clean = re.sub(r'[^a-zA-Z0-9]', '', subject.code).lower()[:6] or 'subj'
c_clean = re.sub(r'[^a-zA-Z0-9]', '', code).lower()[:4] or 'c1'
virtual_link = f"https://meet.google.com/edu-{s_clean}-{c_clean}"
existing = Commission.query.filter_by( existing = Commission.query.filter_by(
subject_id=int(subject_id), subject_id=int(subject_id),
@@ -2424,10 +2516,13 @@ def get_building(id):
building = Building.query.get(id) building = Building.query.get(id)
if not building: if not building:
return jsonify({'error': 'NotFound', 'message': f'Edificio con ID {id} no encontrado.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Edificio con ID {id} no encontrado.'}), 404
classrooms = Classroom.query.filter(
db.or_(Classroom.building_id == id, Classroom.building == building.name)
).order_by(Classroom.floor.asc(), Classroom.code.asc()).all()
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'building': building.to_dict(), 'building': building.to_dict(),
'classrooms': [c.to_dict() for c in building.classrooms] 'classrooms': [c.to_dict() for c in classrooms]
}), 200 }), 200
@@ -2463,6 +2558,14 @@ def create_building():
db.session.add(building) db.session.add(building)
db.session.commit() db.session.commit()
AuditService.log(
action='CREATE',
module='buildings',
entity_id=building.id,
user=g.jwt_user,
details=f"Nueva sede/edificio creado: '{building.name}' (Código: {building.code or 'S/C'}, Pisos: {building.floors})"
)
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'message': f'Edificio "{name}" creado con éxito.', 'message': f'Edificio "{name}" creado con éxito.',
@@ -2514,6 +2617,14 @@ def update_building(id):
db.session.commit() db.session.commit()
AuditService.log(
action='UPDATE',
module='buildings',
entity_id=building.id,
user=g.jwt_user,
details=f"Edificio/sede #{building.id} ('{building.name}') actualizado. Pisos: {building.floors}, Código: {building.code}"
)
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'message': f'Edificio "{building.name}" actualizado con éxito.', 'message': f'Edificio "{building.name}" actualizado con éxito.',
@@ -2533,6 +2644,14 @@ def toggle_building(id):
building.updated_at = datetime.utcnow() building.updated_at = datetime.utcnow()
db.session.commit() db.session.commit()
AuditService.log(
action='TOGGLE',
module='buildings',
entity_id=building.id,
user=g.jwt_user,
details=f"Edificio '{building.name}' {'activado' if building.is_active else 'desactivado'}"
)
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'message': f'Edificio "{building.name}" {"activado" if building.is_active else "desactivado"} exitosamente.', 'message': f'Edificio "{building.name}" {"activado" if building.is_active else "desactivado"} exitosamente.',
@@ -2558,12 +2677,21 @@ def delete_building(id):
'message': f'No se puede eliminar el edificio "{building.name}" porque tiene {count} aulas asociadas.' 'message': f'No se puede eliminar el edificio "{building.name}" porque tiene {count} aulas asociadas.'
}), 409 }), 409
b_name = building.name
db.session.delete(building) db.session.delete(building)
db.session.commit() db.session.commit()
AuditService.log(
action='DELETE',
module='buildings',
entity_id=id,
user=g.jwt_user,
details=f"Edificio/sede #{id} ('{b_name}') eliminado permanentemente"
)
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'message': f'Edificio "{building.name}" eliminado correctamente.' 'message': f'Edificio "{b_name}" eliminado correctamente.'
}), 200 }), 200
@@ -2698,3 +2826,132 @@ def reset_entire_system():
'message': f'Error durante la reinicialización de la base de datos: {str(e)}' 'message': f'Error durante la reinicialización de la base de datos: {str(e)}'
}), 500 }), 500
# ---------------------------------------------------------
# REGISTRO DE AUDITORÍA INSTITUCIONAL RESTful
# ---------------------------------------------------------
@api_admin_bp.route('/audit-logs', methods=['GET'])
@api_admin_bp.route('/audit_logs', methods=['GET'])
@jwt_required
def get_audit_logs():
"""
Endpoint RESTful para consultar la bitácora inmutable de auditoría institucional.
Soporta paginación, búsqueda multi-campo y filtrado por módulo y acción.
"""
page = request.args.get('page', 1, type=int)
per_page = min(request.args.get('per_page', 20, type=int), 100)
module_filter = request.args.get('module', '').strip().lower()
action_filter = request.args.get('action', '').strip().upper()
search = request.args.get('search', '').strip()
query = AuditLog.query
if module_filter:
query = query.filter(AuditLog.module == module_filter)
if action_filter:
query = query.filter(AuditLog.action == action_filter)
if search:
query = query.filter(
or_(
AuditLog.user_email.ilike(f'%{search}%'),
AuditLog.details.ilike(f'%{search}%'),
AuditLog.ip_address.ilike(f'%{search}%'),
AuditLog.action.ilike(f'%{search}%'),
AuditLog.module.ilike(f'%{search}%')
)
)
pagination = query.order_by(AuditLog.created_at.desc()).paginate(
page=page, per_page=per_page, error_out=False
)
modules_tuples = db.session.query(AuditLog.module).distinct().all()
actions_tuples = db.session.query(AuditLog.action).distinct().all()
modules = sorted(list(set([r[0].lower() for r in modules_tuples if r[0]])))
actions = sorted(list(set([r[0].upper() for r in actions_tuples if r[0]])))
default_modules = ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin', 'system', 'import']
for m in default_modules:
if m not in modules:
modules.append(m)
default_actions = [
'LOGIN', 'LOGIN_FAILED', 'LOGIN_BLOCKED', 'LOGIN_GOOGLE', 'LOGIN_MOODLE', 'LOGOUT',
'PASSWORD_CHANGE', 'IMPERSONATE_START', 'IMPERSONATE_END',
'CREATE', 'UPDATE', 'DELETE', 'CONFIRM', 'CANCEL', 'TOGGLE',
'OPTIMIZE_RUN', 'OPTIMIZE_APPLY', 'SYSTEM_RESET', 'SYSTEM_ERROR',
'SHEETS_IMPORT', 'SHEETS_IMPORT_ERROR'
]
for a in default_actions:
if a not in actions:
actions.append(a)
return jsonify({
'status': 'success',
'logs': [log.to_dict() for log in pagination.items],
'pagination': {
'page': pagination.page,
'per_page': pagination.per_page,
'total': pagination.total,
'pages': pagination.pages or 1,
'has_prev': pagination.has_prev,
'has_next': pagination.has_next
},
'modules': sorted(modules),
'actions': sorted(actions),
'current_module': module_filter,
'current_action': action_filter,
'search': search
}), 200
@api_admin_bp.route('/log-error', methods=['POST'])
def log_system_error():
"""
Endpoint para registrar incidentes técnicos o errores no controlados
provenientes del frontend BFF o subsistemas en AuditLog.
"""
try:
data = request.get_json(silent=True) or {}
incident_id = data.get('incident_id')
error_title = data.get('error_title', 'Error de Sistema')
error_message = data.get('error_message', 'Error desconocido')
status_code = data.get('status_code', 500)
path = data.get('path', '')
user_email = data.get('user_email') or 'anonymous'
ip_address = data.get('ip_address') or request.remote_addr
stack = data.get('stack', '')
details = {
'incident_id': incident_id,
'title': error_title,
'message': error_message,
'status_code': status_code,
'path': path,
'stack_preview': stack[:500] if stack else ''
}
AuditService.log(
action='SYSTEM_ERROR',
module='system',
user_email=user_email,
ip_address=ip_address,
details=details,
status='failed'
)
return jsonify({
'status': 'success',
'logged': True,
'incident_id': incident_id
}), 200
except Exception as e:
return jsonify({
'status': 'error',
'message': str(e)
}), 500
+87
View File
@@ -20,6 +20,7 @@ from app.services.user_service import UserService
from app.services.jwt_service import JWTService from app.services.jwt_service import JWTService
from app.services.cache_service import cache_service from app.services.cache_service import cache_service
from app.services.moodle_client import moodle_client from app.services.moodle_client import moodle_client
from app.services.audit_service import AuditService
from app.schemas.auth_dto import LoginDTO, RefreshTokenDTO from app.schemas.auth_dto import LoginDTO, RefreshTokenDTO
from app.utils.jwt_decorators import jwt_required from app.utils.jwt_decorators import jwt_required
@@ -69,6 +70,12 @@ def login():
user = user_service.authenticate(dto.email, dto.password) user = user_service.authenticate(dto.email, dto.password)
if not user: if not user:
AuditService.log(
action='LOGIN_FAILED',
module='auth',
user_email=dto.email,
details=f"Intento de inicio de sesión fallido para {dto.email}. Credenciales incorrectas o cuenta inactiva."
)
return jsonify({ return jsonify({
'error': 'Unauthorized', 'error': 'Unauthorized',
'message': 'Credenciales de acceso incorrectas o cuenta inactiva.' 'message': 'Credenciales de acceso incorrectas o cuenta inactiva.'
@@ -76,11 +83,26 @@ def login():
is_admin = user.is_admin() or getattr(user, 'role', '').upper() == 'ADMIN' is_admin = user.is_admin() or getattr(user, 'role', '').upper() == 'ADMIN'
if not local_enabled and not is_admin: if not local_enabled and not is_admin:
AuditService.log(
action='LOGIN_BLOCKED',
module='auth',
user=user,
entity_id=user.id,
details=f"Acceso local con contraseña bloqueado para {user.email}. Método deshabilitado por administración."
)
return jsonify({ return jsonify({
'error': 'Forbidden', 'error': 'Forbidden',
'message': 'El acceso local con contraseña está deshabilitado por el administrador. Inicie sesión mediante Google OAuth o Moodle.' 'message': 'El acceso local con contraseña está deshabilitado por el administrador. Inicie sesión mediante Google OAuth o Moodle.'
}), 403 }), 403
AuditService.log(
action='LOGIN',
module='auth',
user=user,
entity_id=user.id,
details=f"Inicio de sesión exitoso (Autenticación Local) - Rol: {user.role}"
)
tokens = JWTService.generate_tokens(user) tokens = JWTService.generate_tokens(user)
profile = user_service.get_profile_data(user) profile = user_service.get_profile_data(user)
@@ -130,6 +152,12 @@ def google_auth():
if allowed_domains and domain.lower() not in allowed_domains: if allowed_domains and domain.lower() not in allowed_domains:
logger.warning(f"[GoogleAuth] Access denied for {email}: domain {domain} not in {allowed_domains}") logger.warning(f"[GoogleAuth] Access denied for {email}: domain {domain} not in {allowed_domains}")
AuditService.log(
action='LOGIN_FAILED',
module='auth',
user_email=email,
details=f"Acceso Google OAuth denegado: dominio @{domain} no autorizado para {email}."
)
return jsonify({ return jsonify({
'error': 'Forbidden', 'error': 'Forbidden',
'message': f'Acceso denegado. El dominio @{domain} no está autorizado en esta institución.' 'message': f'Acceso denegado. El dominio @{domain} no está autorizado en esta institución.'
@@ -159,8 +187,23 @@ def google_auth():
logger.info(f"[GoogleAuth] Created new local user for {email} with role Docente.") logger.info(f"[GoogleAuth] Created new local user for {email} with role Docente.")
if not user.is_active: if not user.is_active:
AuditService.log(
action='LOGIN_FAILED',
module='auth',
user=user,
entity_id=user.id,
details=f"Acceso Google OAuth denegado: cuenta institucional desactivada para {email}."
)
return jsonify({'error': 'Unauthorized', 'message': 'Su cuenta se encuentra inactiva. Contacte a Bedelía.'}), 401 return jsonify({'error': 'Unauthorized', 'message': 'Su cuenta se encuentra inactiva. Contacte a Bedelía.'}), 401
AuditService.log(
action='LOGIN_GOOGLE',
module='auth',
user=user,
entity_id=user.id,
details=f"Inicio de sesión exitoso (Google OAuth SSO) - Rol: {user.role}"
)
tokens = JWTService.generate_tokens(user) tokens = JWTService.generate_tokens(user)
profile = user_service.get_profile_data(user) profile = user_service.get_profile_data(user)
@@ -220,6 +263,12 @@ def moodle_auth():
if 'error' in res_data or 'token' not in res_data: if 'error' in res_data or 'token' not in res_data:
err_msg = res_data.get('error', 'Credenciales inválidas en Moodle.') err_msg = res_data.get('error', 'Credenciales inválidas en Moodle.')
AuditService.log(
action='LOGIN_FAILED',
module='auth',
user_email=f"{username}@unicaba.edu.ar",
details=f"Intento de autenticación Moodle fallido para '{username}': {err_msg}"
)
return jsonify({'error': 'Unauthorized', 'message': f'Moodle: {err_msg}'}), 401 return jsonify({'error': 'Unauthorized', 'message': f'Moodle: {err_msg}'}), 401
moodle_user_token = res_data['token'] moodle_user_token = res_data['token']
@@ -265,8 +314,23 @@ def moodle_auth():
logger.info(f"[MoodleAuth] Created new local user for Moodle username '{username}' with role '{role_name}'.") logger.info(f"[MoodleAuth] Created new local user for Moodle username '{username}' with role '{role_name}'.")
if not user.is_active: if not user.is_active:
AuditService.log(
action='LOGIN_FAILED',
module='auth',
user=user,
entity_id=user.id,
details=f"Inicio de sesión Moodle denegado: cuenta institucional desactivada para {username}."
)
return jsonify({'error': 'Unauthorized', 'message': 'Su cuenta en Edu-Space está desactivada.'}), 401 return jsonify({'error': 'Unauthorized', 'message': 'Su cuenta en Edu-Space está desactivada.'}), 401
AuditService.log(
action='LOGIN_MOODLE',
module='auth',
user=user,
entity_id=user.id,
details=f"Inicio de sesión exitoso (Moodle Delegado) - Usuario: {username}, Rol: {user.role}"
)
tokens = JWTService.generate_tokens(user) tokens = JWTService.generate_tokens(user)
profile = user_service.get_profile_data(user) profile = user_service.get_profile_data(user)
@@ -336,6 +400,14 @@ def logout():
""" """
Session logout: revokes active access token and clears cookies. Session logout: revokes active access token and clears cookies.
""" """
if g.jwt_user:
AuditService.log(
action='LOGOUT',
module='auth',
user=g.jwt_user,
entity_id=g.jwt_user.id,
details=f"Cierre de sesión seguro de {g.jwt_user.email}"
)
JWTService.revoke_token(g.jwt_token) JWTService.revoke_token(g.jwt_token)
resp = make_response(jsonify({'message': 'Sesión finalizada y token revocado exitosamente.'}), 200) resp = make_response(jsonify({'message': 'Sesión finalizada y token revocado exitosamente.'}), 200)
resp.delete_cookie('refresh_token', path='/api/v1/auth/refresh') resp.delete_cookie('refresh_token', path='/api/v1/auth/refresh')
@@ -375,6 +447,13 @@ def change_password():
user = g.jwt_user user = g.jwt_user
if not user.check_password(current_password): if not user.check_password(current_password):
AuditService.log(
action='PASSWORD_FAILED',
module='auth',
user=user,
entity_id=user.id,
details="Intento fallido de cambio de contraseña: la contraseña actual no coincide."
)
return jsonify({ return jsonify({
'error': 'Unauthorized', 'error': 'Unauthorized',
'message': 'La contraseña actual ingresada es incorrecta.' 'message': 'La contraseña actual ingresada es incorrecta.'
@@ -383,6 +462,14 @@ def change_password():
user.set_password(new_password) user.set_password(new_password)
db.session.commit() db.session.commit()
AuditService.log(
action='PASSWORD_CHANGE',
module='auth',
user=user,
entity_id=user.id,
details="Cambio de contraseña institucional completado exitosamente."
)
logger.info(f"[Auth] Password successfully updated for user {user.email}") logger.info(f"[Auth] Password successfully updated for user {user.email}")
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
+29
View File
@@ -4,6 +4,7 @@ from pydantic import ValidationError
from app import db from app import db
from app.models.classroom import Classroom from app.models.classroom import Classroom
from app.services.classroom_service import ClassroomService from app.services.classroom_service import ClassroomService
from app.services.audit_service import AuditService
from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO, ClassroomResponseDTO from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO, ClassroomResponseDTO
from app.utils.jwt_decorators import jwt_required, jwt_role_required from app.utils.jwt_decorators import jwt_required, jwt_role_required
@@ -80,6 +81,13 @@ def create_classroom():
try: try:
classroom = classroom_service.create_classroom(dto) classroom = classroom_service.create_classroom(dto)
AuditService.log(
action='CREATE',
module='classrooms',
entity_id=classroom.id,
user=g.jwt_user,
details=f"Nueva aula creada: {classroom.code} en {classroom.building} (Piso {classroom.floor}, Capacidad: {classroom.capacity})"
)
return jsonify({ return jsonify({
'message': 'Aula creada exitosamente.', 'message': 'Aula creada exitosamente.',
'id': classroom.id, 'id': classroom.id,
@@ -101,6 +109,13 @@ def update_classroom(classroom_id: int):
try: try:
classroom = classroom_service.update_classroom(classroom_id, dto) classroom = classroom_service.update_classroom(classroom_id, dto)
AuditService.log(
action='UPDATE',
module='classrooms',
entity_id=classroom.id,
user=g.jwt_user,
details=f"Aula #{classroom.id} ({classroom.code}) actualizada. Capacidad: {classroom.capacity}, Piso: {classroom.floor}"
)
return jsonify({ return jsonify({
'message': 'Aula actualizada exitosamente.', 'message': 'Aula actualizada exitosamente.',
'id': classroom.id, 'id': classroom.id,
@@ -118,6 +133,13 @@ def delete_classroom(classroom_id: int):
if not deleted: if not deleted:
return jsonify({'error': 'NotFound', 'message': f'Aula {classroom_id} no encontrada.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Aula {classroom_id} no encontrada.'}), 404
AuditService.log(
action='DELETE',
module='classrooms',
entity_id=classroom_id,
user=g.jwt_user,
details=f"Aula #{classroom_id} eliminada/desactivada del sistema"
)
return jsonify({'message': f'Aula {classroom_id} eliminada/desactivada correctamente.'}), 200 return jsonify({'message': f'Aula {classroom_id} eliminada/desactivada correctamente.'}), 200
@api_classrooms_bp.route('/<int:classroom_id>/toggle', methods=['POST']) @api_classrooms_bp.route('/<int:classroom_id>/toggle', methods=['POST'])
@@ -127,6 +149,13 @@ def toggle_classroom(classroom_id: int):
classroom = Classroom.query.get_or_404(classroom_id) classroom = Classroom.query.get_or_404(classroom_id)
classroom.is_active = not classroom.is_active classroom.is_active = not classroom.is_active
db.session.commit() db.session.commit()
AuditService.log(
action='TOGGLE',
module='classrooms',
entity_id=classroom.id,
user=g.jwt_user,
details=f"Aula {classroom.code} {'activada' if classroom.is_active else 'desactivada'}"
)
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'id': classroom.id, 'id': classroom.id,
+435 -65
View File
@@ -1,10 +1,11 @@
from flask import Blueprint, jsonify, request from flask import Blueprint, jsonify, request, g
from app.utils.jwt_decorators import jwt_required from app.utils.jwt_decorators import jwt_required
from app.models.classroom import Classroom from app.models.classroom import Classroom
from app.models.subject import Subject from app.models.subject import Subject
from app.models.user import User from app.models.user import User
from app.models.reservation import Reservation from app.models.reservation import Reservation
from app.models.audit_log import AuditLog from app.models.audit_log import AuditLog
from app.services.audit_service import AuditService
from datetime import datetime, timedelta from datetime import datetime, timedelta
from sqlalchemy import func from sqlalchemy import func
from app import db from app import db
@@ -150,91 +151,350 @@ def get_stats():
upcoming_reservations = [serialize_reservation(r) for r in upcoming_reservations_q] upcoming_reservations = [serialize_reservation(r) for r in upcoming_reservations_q]
milestones = [serialize_milestone(m) for m in milestones_q] milestones = [serialize_milestone(m) for m in milestones_q]
# ---- Bedelía: Comisiones sin aula asignada (semana y mes) ---- # ---- Bedelía: Filtros completos de Aulas y Comisiones por Día (Hoy), Mañana, Semana y Mes ----
import calendar import calendar
# Calcular rango de semana actual (lunes a domingo)
today_dt = datetime.utcnow() today_dt = datetime.utcnow()
week_start = today_dt - timedelta(days=today_dt.weekday()) # lunes tomorrow_dt = today_dt + timedelta(days=1)
tomorrow_start = tomorrow_dt.replace(hour=0, minute=0, second=0, microsecond=0)
tomorrow_end = tomorrow_dt.replace(hour=23, minute=59, second=59, microsecond=0)
week_start = today_dt - timedelta(days=today_dt.weekday()) # Lunes
week_start = week_start.replace(hour=0, minute=0, second=0, microsecond=0) week_start = week_start.replace(hour=0, minute=0, second=0, microsecond=0)
week_end = week_start + timedelta(days=6, hours=23, minutes=59, seconds=59) week_end = week_start + timedelta(days=6, hours=23, minutes=59, seconds=59)
# Calcular rango del mes actual
month_start = today_dt.replace(day=1, hour=0, minute=0, second=0, microsecond=0) month_start = today_dt.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
last_day = calendar.monthrange(today_dt.year, today_dt.month)[1] last_day = calendar.monthrange(today_dt.year, today_dt.month)[1]
month_end = today_dt.replace(day=last_day, hour=23, minute=59, second=59, microsecond=0) month_end = today_dt.replace(day=last_day, hour=23, minute=59, second=59, microsecond=0)
# Comisiones activas totales # Etiquetas legibles de fecha en español
dias_esp = ['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado', 'Domingo']
meses_esp = ['', 'Enero', 'Febrero', 'Marzo', 'Abril', 'Mayo', 'Junio', 'Julio', 'Agosto', 'Septiembre', 'Octubre', 'Noviembre', 'Diciembre']
weekday_name = dias_esp[today_dt.weekday()]
month_name = meses_esp[today_dt.month]
tomorrow_weekday_name = dias_esp[tomorrow_dt.weekday()]
tomorrow_month_name = meses_esp[tomorrow_dt.month]
date_labels = {
'today': f"Hoy · {weekday_name} {today_dt.strftime('%d/%m/%Y')}",
'today_short': f"{weekday_name} {today_dt.strftime('%d/%m')}",
'today_full': f"{weekday_name}, {today_dt.day} de {month_name} de {today_dt.year}",
'tomorrow': f"Mañana · {tomorrow_weekday_name} {tomorrow_dt.strftime('%d/%m/%Y')}",
'tomorrow_short': f"{tomorrow_weekday_name} {tomorrow_dt.strftime('%d/%m')}",
'tomorrow_full': f"{tomorrow_weekday_name}, {tomorrow_dt.day} de {tomorrow_month_name} de {tomorrow_dt.year}",
'week': f"Semana del {week_start.strftime('%d/%m')} al {week_end.strftime('%d/%m/%Y')}",
'week_full': f"Semana del {week_start.strftime('%d/%m/%Y')} al {week_end.strftime('%d/%m/%Y')}",
'month': f"Mes de {month_name} {today_dt.year} ({month_start.strftime('%d/%m')} al {month_end.strftime('%d/%m/%Y')})",
'month_full': f"{month_name} de {today_dt.year}"
}
# Reservas por período
tomorrow_reservations_q = Reservation.query.filter(
Reservation.start_time >= tomorrow_start,
Reservation.start_time <= tomorrow_end
).order_by(Reservation.start_time.asc()).all()
tomorrow_schedule_list = [serialize_reservation(r) for r in tomorrow_reservations_q]
week_reservations_q = Reservation.query.filter(
Reservation.start_time >= week_start,
Reservation.start_time <= week_end
).order_by(Reservation.start_time.asc()).all()
week_schedule_list = [serialize_reservation(r) for r in week_reservations_q]
month_reservations_q = Reservation.query.filter(
Reservation.start_time >= month_start,
Reservation.start_time <= month_end
).order_by(Reservation.start_time.asc()).all()
# Mapas de reservas por aula en cada período
res_map_classroom_today = {}
for r in today_reservations_q:
if r.classroom_id:
res_map_classroom_today.setdefault(r.classroom_id, []).append(r)
res_map_classroom_tomorrow = {}
for r in tomorrow_reservations_q:
if r.classroom_id:
res_map_classroom_tomorrow.setdefault(r.classroom_id, []).append(r)
res_map_classroom_week = {}
for r in week_reservations_q:
if r.classroom_id:
res_map_classroom_week.setdefault(r.classroom_id, []).append(r)
res_map_classroom_month = {}
for r in month_reservations_q:
if r.classroom_id:
res_map_classroom_month.setdefault(r.classroom_id, []).append(r)
# Mapas de reservas por comisión en cada período
res_map_comm_today = {}
for r in today_reservations_q:
if r.commission_id:
res_map_comm_today.setdefault(r.commission_id, []).append(r)
res_map_comm_tomorrow = {}
for r in tomorrow_reservations_q:
if r.commission_id:
res_map_comm_tomorrow.setdefault(r.commission_id, []).append(r)
res_map_comm_week = {}
for r in week_reservations_q:
if r.commission_id:
res_map_comm_week.setdefault(r.commission_id, []).append(r)
res_map_comm_month = {}
for r in month_reservations_q:
if r.commission_id:
res_map_comm_month.setdefault(r.commission_id, []).append(r)
all_active_commissions = Commission.query.filter_by(active=True).all() all_active_commissions = Commission.query.filter_by(active=True).all()
total_active_commissions = len(all_active_commissions) total_active_commissions = len(all_active_commissions)
# IDs de comisiones que SÍ tienen reserva en la semana # Helper para serializar aula con info contextual
comm_ids_with_res_week = set( def build_classroom_item(c, res_list):
r[0] for r in db.session.query(Reservation.commission_id).filter( r_first = res_list[0] if res_list else None
Reservation.commission_id.isnot(None), assigned_summary = ''
Reservation.start_time >= week_start, if r_first:
Reservation.start_time <= week_end subj = (r_first.commission.subject.name if (r_first.commission and r_first.commission.subject) else r_first.purpose) or 'Clase'
).distinct().all() assigned_summary = f"{subj} ({r_first.start_time.strftime('%H:%M')} - {r_first.end_time.strftime('%H:%M')} hs)"
) return {
# IDs de comisiones que SÍ tienen reserva en el mes 'id': c.id,
comm_ids_with_res_month = set( 'code': c.code,
r[0] for r in db.session.query(Reservation.commission_id).filter( 'building': c.building or 'Sede Central',
Reservation.commission_id.isnot(None), 'floor': c.floor or '',
Reservation.start_time >= month_start, 'capacity': c.capacity or 0,
Reservation.start_time <= month_end 'is_virtual': getattr(c, 'is_virtual', False) or 'virtual' in (c.building or '').lower() or 'virtual' in (c.code or '').lower(),
).distinct().all() 'res_count': len(res_list),
) 'assigned_summary': assigned_summary
}
unassigned_commissions_week = [] # Helper para serializar comisión con info contextual
unassigned_commissions_month = [] def build_comm_item(comm, res_list):
for comm in all_active_commissions: has_v_link = bool(comm.virtual_link and comm.virtual_link.strip())
comm_data = { r_first = res_list[0] if res_list else None
assigned_room = ''
assigned_time = ''
if r_first:
assigned_room = r_first.classroom.code if r_first.classroom else 'Aula Virtual'
assigned_time = f"{r_first.start_time.strftime('%H:%M')} - {r_first.end_time.strftime('%H:%M')} hs"
return {
'id': comm.id, 'id': comm.id,
'code': comm.code, 'code': comm.code,
'full_code': comm.get_full_code(), 'full_code': comm.get_full_code(),
'subject_name': comm.subject.name if comm.subject else 'Sin materia', 'subject_name': comm.subject.name if comm.subject else 'Sin materia',
'subject_code': comm.subject.code if comm.subject else '', 'subject_code': comm.subject.code if comm.subject else '',
'teacher_name': comm.teacher_name, 'teacher_name': comm.teacher_name or 'Sin docente',
'schedule': comm.schedule or 'Sin horario', 'schedule': comm.schedule or 'Sin horario',
'shift': comm.shift or 'Sin turno', 'shift': comm.shift or 'Sin turno',
'max_students': comm.max_students, 'max_students': comm.max_students or 0,
'current_students': comm.current_students 'current_students': comm.current_students or 0,
'virtual_link': comm.virtual_link or '',
'has_virtual_link': has_v_link,
'res_count': len(res_list),
'assigned_room': assigned_room,
'assigned_time': assigned_time
} }
if comm.id not in comm_ids_with_res_week:
unassigned_commissions_week.append(comm_data)
if comm.id not in comm_ids_with_res_month:
unassigned_commissions_month.append(comm_data)
# ---- Bedelía: Aulas disponibles (sin reservas) en la semana y mes ---- # Construcción de Aulas Asignadas vs Sin Asignar para cada período (sobre aulas físicas)
classroom_ids_used_week = set( # 1. Hoy
r[0] for r in db.session.query(Reservation.classroom_id).filter( classrooms_assigned_today = [build_classroom_item(c, res_map_classroom_today[c.id]) for c in physical_classrooms_list if c.id in res_map_classroom_today]
Reservation.classroom_id.isnot(None), classrooms_unassigned_today = [build_classroom_item(c, []) for c in physical_classrooms_list if c.id not in res_map_classroom_today]
Reservation.start_time >= week_start, # 2. Mañana
Reservation.start_time <= week_end classrooms_assigned_tomorrow = [build_classroom_item(c, res_map_classroom_tomorrow[c.id]) for c in physical_classrooms_list if c.id in res_map_classroom_tomorrow]
).distinct().all() classrooms_unassigned_tomorrow = [build_classroom_item(c, []) for c in physical_classrooms_list if c.id not in res_map_classroom_tomorrow]
) # 3. Semana
classroom_ids_used_month = set( classrooms_assigned_week = [build_classroom_item(c, res_map_classroom_week[c.id]) for c in physical_classrooms_list if c.id in res_map_classroom_week]
r[0] for r in db.session.query(Reservation.classroom_id).filter( classrooms_unassigned_week = [build_classroom_item(c, []) for c in physical_classrooms_list if c.id not in res_map_classroom_week]
Reservation.classroom_id.isnot(None), # 4. Mes
Reservation.start_time >= month_start, classrooms_assigned_month = [build_classroom_item(c, res_map_classroom_month[c.id]) for c in physical_classrooms_list if c.id in res_map_classroom_month]
Reservation.start_time <= month_end classrooms_unassigned_month = [build_classroom_item(c, []) for c in physical_classrooms_list if c.id not in res_map_classroom_month]
# Construcción de Comisiones Asignadas vs Sin Asignar para cada período
# 1. Hoy
commissions_assigned_today = [build_comm_item(comm, res_map_comm_today[comm.id]) for comm in all_active_commissions if comm.id in res_map_comm_today]
commissions_unassigned_today = [build_comm_item(comm, []) for comm in all_active_commissions if comm.id not in res_map_comm_today]
# 2. Mañana
commissions_assigned_tomorrow = [build_comm_item(comm, res_map_comm_tomorrow[comm.id]) for comm in all_active_commissions if comm.id in res_map_comm_tomorrow]
commissions_unassigned_tomorrow = [build_comm_item(comm, []) for comm in all_active_commissions if comm.id not in res_map_comm_tomorrow]
# 3. Semana
commissions_assigned_week = [build_comm_item(comm, res_map_comm_week[comm.id]) for comm in all_active_commissions if comm.id in res_map_comm_week]
commissions_unassigned_week = [build_comm_item(comm, []) for comm in all_active_commissions if comm.id not in res_map_comm_week]
# 4. Mes
commissions_assigned_month = [build_comm_item(comm, res_map_comm_month[comm.id]) for comm in all_active_commissions if comm.id in res_map_comm_month]
commissions_unassigned_month = [build_comm_item(comm, []) for comm in all_active_commissions if comm.id not in res_map_comm_month]
# Identificar comisiones en modalidad virtual (por enlace Meet/Teams/Zoom o asignadas a Campus Virtual)
virtual_room_ids = set(c.id for c in virtual_classrooms_list)
comm_ids_virtual = set()
for comm in all_active_commissions:
if comm.virtual_link and comm.virtual_link.strip():
comm_ids_virtual.add(comm.id)
if virtual_room_ids:
comm_in_virtual_res = set(
r[0] for r in db.session.query(Reservation.commission_id).filter(
Reservation.classroom_id.in_(virtual_room_ids),
Reservation.commission_id.isnot(None)
).distinct().all()
)
comm_ids_virtual.update(comm_in_virtual_res)
virtual_rooms_data = []
for comm in all_active_commissions:
if comm.id in comm_ids_virtual:
res_today = res_map_comm_today.get(comm.id, [])
res_tomorrow = res_map_comm_tomorrow.get(comm.id, [])
res_week = res_map_comm_week.get(comm.id, [])
res_month = res_map_comm_month.get(comm.id, [])
v_link = comm.virtual_link or (res_today[0].virtual_link if res_today and res_today[0].virtual_link else '')
virtual_rooms_data.append({
'id': comm.id,
'commission_id': comm.id,
'code': comm.code,
'full_code': comm.get_full_code(),
'subject_name': comm.subject.name if comm.subject else 'Sin materia',
'subject_code': comm.subject.code if comm.subject else '',
'career_name': comm.subject.career.name if (comm.subject and comm.subject.career) else 'UniCABA',
'teacher_name': comm.teacher_name or 'Docente a confirmar',
'schedule': comm.schedule or 'Horario regular',
'shift': comm.shift or 'Tarde',
'max_students': comm.max_students or 35,
'capacity': comm.max_students or 35,
'virtual_link': v_link,
'is_virtual': True,
'building': 'Campus Virtual',
'floor': 'Remoto ∞',
'today_classes': len(res_today),
'tomorrow_classes': len(res_tomorrow),
'week_classes': len(res_week),
'month_classes': len(res_month),
'res_count': len(res_month),
'is_active_today': len(res_today) > 0,
'is_active_tomorrow': len(res_tomorrow) > 0,
'assigned_summary': f"{comm.subject.name if comm.subject else 'Clase Virtual'} ({comm.schedule or 'Remoto'})"
})
# Las salas virtuales disponibles corresponden a las salas de comisiones virtuales activas o catálogo virtual
if virtual_rooms_data:
virtual_classrooms = len(virtual_rooms_data)
# Comisiones huérfanas generales (sin ninguna reserva histórica ni link virtual)
comm_ids_with_any_res = set(
r[0] for r in db.session.query(Reservation.commission_id).filter(
Reservation.commission_id.isnot(None)
).distinct().all() ).distinct().all()
) )
unassigned_commissions_general = [
build_comm_item(comm, []) for comm in all_active_commissions
if comm.id not in comm_ids_with_any_res and not (comm.virtual_link and comm.virtual_link.strip())
]
available_classrooms_week = [] # Compatibilidad hacia atrás para vistas existentes
available_classrooms_month = [] available_classrooms_today = classrooms_unassigned_today
for c in all_active_classrooms: available_classrooms_tomorrow = classrooms_unassigned_tomorrow
c_data = { available_classrooms_week = classrooms_unassigned_week
'id': c.id, available_classrooms_month = classrooms_unassigned_month
'code': c.code, unassigned_commissions_tomorrow = commissions_unassigned_tomorrow
'building': c.building or 'Sin edificio', unassigned_commissions_week = commissions_unassigned_week
'floor': c.floor or '', unassigned_commissions_month = commissions_unassigned_month
'capacity': c.capacity,
'is_virtual': getattr(c, 'is_virtual', False) or 'virtual' in (c.building or '').lower() or 'virtual' in (c.code or '').lower() # Diccionario unificado filter_stats
} filter_stats = {
if c.id not in classroom_ids_used_week: 'date_labels': date_labels,
available_classrooms_week.append(c_data) 'today': {
if c.id not in classroom_ids_used_month: 'label': date_labels['today'],
available_classrooms_month.append(c_data) 'date_short': date_labels['today_short'],
'date_full': date_labels['today_full'],
'classrooms': {
'assigned': classrooms_assigned_today,
'unassigned': classrooms_unassigned_today,
'assigned_count': len(classrooms_assigned_today),
'unassigned_count': len(classrooms_unassigned_today),
'assigned_pct': round((len(classrooms_assigned_today) / max(1, total_physical_count)) * 100, 1),
'unassigned_pct': round((len(classrooms_unassigned_today) / max(1, total_physical_count)) * 100, 1),
'total': total_physical_count
},
'commissions': {
'assigned': commissions_assigned_today,
'unassigned': commissions_unassigned_today,
'assigned_count': len(commissions_assigned_today),
'unassigned_count': len(commissions_unassigned_today),
'assigned_pct': round((len(commissions_assigned_today) / max(1, total_active_commissions)) * 100, 1),
'unassigned_pct': round((len(commissions_unassigned_today) / max(1, total_active_commissions)) * 100, 1),
'total': total_active_commissions
}
},
'tomorrow': {
'label': date_labels['tomorrow'],
'date_short': date_labels['tomorrow_short'],
'date_full': date_labels['tomorrow_full'],
'classrooms': {
'assigned': classrooms_assigned_tomorrow,
'unassigned': classrooms_unassigned_tomorrow,
'assigned_count': len(classrooms_assigned_tomorrow),
'unassigned_count': len(classrooms_unassigned_tomorrow),
'assigned_pct': round((len(classrooms_assigned_tomorrow) / max(1, total_physical_count)) * 100, 1),
'unassigned_pct': round((len(classrooms_unassigned_tomorrow) / max(1, total_physical_count)) * 100, 1),
'total': total_physical_count
},
'commissions': {
'assigned': commissions_assigned_tomorrow,
'unassigned': commissions_unassigned_tomorrow,
'assigned_count': len(commissions_assigned_tomorrow),
'unassigned_count': len(commissions_unassigned_tomorrow),
'assigned_pct': round((len(commissions_assigned_tomorrow) / max(1, total_active_commissions)) * 100, 1),
'unassigned_pct': round((len(commissions_unassigned_tomorrow) / max(1, total_active_commissions)) * 100, 1),
'total': total_active_commissions
}
},
'week': {
'label': date_labels['week'],
'date_short': date_labels['week'],
'date_full': date_labels['week_full'],
'classrooms': {
'assigned': classrooms_assigned_week,
'unassigned': classrooms_unassigned_week,
'assigned_count': len(classrooms_assigned_week),
'unassigned_count': len(classrooms_unassigned_week),
'assigned_pct': round((len(classrooms_assigned_week) / max(1, total_physical_count)) * 100, 1),
'unassigned_pct': round((len(classrooms_unassigned_week) / max(1, total_physical_count)) * 100, 1),
'total': total_physical_count
},
'commissions': {
'assigned': commissions_assigned_week,
'unassigned': commissions_unassigned_week,
'assigned_count': len(commissions_assigned_week),
'unassigned_count': len(commissions_unassigned_week),
'assigned_pct': round((len(commissions_assigned_week) / max(1, total_active_commissions)) * 100, 1),
'unassigned_pct': round((len(commissions_unassigned_week) / max(1, total_active_commissions)) * 100, 1),
'total': total_active_commissions
}
},
'month': {
'label': date_labels['month'],
'date_short': date_labels['month'],
'date_full': date_labels['month_full'],
'classrooms': {
'assigned': classrooms_assigned_month,
'unassigned': classrooms_unassigned_month,
'assigned_count': len(classrooms_assigned_month),
'unassigned_count': len(classrooms_unassigned_month),
'assigned_pct': round((len(classrooms_assigned_month) / max(1, total_physical_count)) * 100, 1),
'unassigned_pct': round((len(classrooms_unassigned_month) / max(1, total_physical_count)) * 100, 1),
'total': total_physical_count
},
'commissions': {
'assigned': commissions_assigned_month,
'unassigned': commissions_unassigned_month,
'assigned_count': len(commissions_assigned_month),
'unassigned_count': len(commissions_unassigned_month),
'assigned_pct': round((len(commissions_assigned_month) / max(1, total_active_commissions)) * 100, 1),
'unassigned_pct': round((len(commissions_unassigned_month) / max(1, total_active_commissions)) * 100, 1),
'total': total_active_commissions
}
},
'virtual_rooms': virtual_rooms_data,
'virtual_rooms_count': len(virtual_rooms_data)
}
except Exception as e: except Exception as e:
print(f"Error fetching stats: {e}") print(f"Error fetching stats: {e}")
@@ -257,9 +517,12 @@ def get_stats():
audit_data = [] audit_data = []
pending_reservations = [] pending_reservations = []
today_schedule_list = [] today_schedule_list = []
week_schedule_list = []
upcoming_reservations = [] upcoming_reservations = []
unassigned_commissions_week = [] unassigned_commissions_week = []
unassigned_commissions_month = [] unassigned_commissions_month = []
unassigned_commissions_general = []
available_classrooms_today = []
available_classrooms_week = [] available_classrooms_week = []
available_classrooms_month = [] available_classrooms_month = []
total_active_commissions = 0 total_active_commissions = 0
@@ -300,40 +563,147 @@ def get_stats():
'assigned_today_pct': assigned_today_pct, 'assigned_today_pct': assigned_today_pct,
'unassigned_today_classrooms': unassigned_today_count, 'unassigned_today_classrooms': unassigned_today_count,
'unassigned_today_pct': unassigned_today_pct, 'unassigned_today_pct': unassigned_today_pct,
'total_active_commissions': total_active_commissions 'total_active_commissions': total_active_commissions,
'tomorrow_reservations': len(tomorrow_reservations_q) if 'tomorrow_reservations_q' in locals() else 0
}, },
'audit_logs': audit_data, 'audit_logs': audit_data,
'monthly_data': monthly_data, 'monthly_data': monthly_data,
'pending_reservations': pending_reservations, 'pending_reservations': pending_reservations,
'today_schedule_list': today_schedule_list, 'today_schedule_list': today_schedule_list,
'tomorrow_schedule_list': tomorrow_schedule_list if 'tomorrow_schedule_list' in locals() else [],
'week_schedule_list': week_schedule_list,
'upcoming_reservations': upcoming_reservations, 'upcoming_reservations': upcoming_reservations,
'milestones': milestones, 'milestones': milestones,
'filter_stats': filter_stats if 'filter_stats' in locals() else {},
'date_labels': date_labels if 'date_labels' in locals() else {},
'ui': { 'ui': {
'show_role_banner': SystemSetting.get_value('dashboard_role_banner_enabled', 'true') in ['true', 'True', '1', True] 'show_role_banner': SystemSetting.get_value('dashboard_role_banner_enabled', 'true') in ['true', 'True', '1', True]
}, },
'bedelia': { 'bedelia': {
'unassigned_commissions_tomorrow': unassigned_commissions_tomorrow if 'unassigned_commissions_tomorrow' in locals() else [],
'unassigned_commissions_week': unassigned_commissions_week, 'unassigned_commissions_week': unassigned_commissions_week,
'unassigned_commissions_month': unassigned_commissions_month, 'unassigned_commissions_month': unassigned_commissions_month,
'unassigned_commissions_general': unassigned_commissions_general,
'available_classrooms_today': available_classrooms_today,
'available_classrooms_tomorrow': available_classrooms_tomorrow if 'available_classrooms_tomorrow' in locals() else [],
'available_classrooms_week': available_classrooms_week, 'available_classrooms_week': available_classrooms_week,
'available_classrooms_month': available_classrooms_month 'available_classrooms_month': available_classrooms_month,
'virtual_rooms': virtual_rooms_data,
'virtual_rooms_count': len(virtual_rooms_data)
} }
}), 200 }), 200
@api_dashboard_bp.route('/sync-sheets', methods=['POST']) @api_dashboard_bp.route('/sync-sheets', methods=['POST'])
@jwt_required @jwt_required
def sync_google_sheets(): def sync_google_sheets():
"""Ejecuta la sincronización real con las hojas de cálculo de Google Sheets.""" """Ejecuta la sincronización real con las hojas de cálculo de Google Sheets con soporte de filtros y entidades."""
from app.services.sheets_importer import GoogleSheetsImporter from app.services.sheets_importer import GoogleSheetsImporter
try: try:
data = request.get_json(silent=True) or {} data = request.get_json(silent=True) or {}
custom_url = data.get('sheets_url') or data.get('base_url') custom_url = data.get('sheets_url') or data.get('base_url')
filter_career = data.get('filter_career')
filter_subject = data.get('filter_subject')
filter_day = data.get('filter_day')
filter_days = data.get('filter_days')
manual_date = data.get('manual_date')
single_date_only = bool(data.get('single_date_only', False))
# Opciones granulares de entidades
import_careers = data.get('import_careers', True)
import_subjects = data.get('import_subjects', True)
import_commissions = data.get('import_commissions', True)
import_classrooms = data.get('import_classrooms', True)
import_reservations = data.get('import_reservations', True)
selected_rows = data.get('selected_rows')
importer = GoogleSheetsImporter(base_url=custom_url) importer = GoogleSheetsImporter(base_url=custom_url)
stats = importer.sync() stats = importer.sync(
filter_career=filter_career,
filter_subject=filter_subject,
filter_day=filter_day,
filter_days=filter_days,
manual_date=manual_date,
single_date_only=single_date_only,
import_careers=import_careers,
import_subjects=import_subjects,
import_commissions=import_commissions,
import_classrooms=import_classrooms,
import_reservations=import_reservations,
selected_rows=selected_rows
)
user_info = getattr(g, 'current_user', {}) or {}
user_email = user_info.get('email') if isinstance(user_info, dict) else getattr(user_info, 'email', None)
AuditService.log(
action='SHEETS_IMPORT',
module='import',
user_email=user_email,
ip_address=request.remote_addr,
details={
'stats': stats,
'filter_career': filter_career,
'filter_subject': filter_subject,
'filter_day': filter_day,
'filter_days': filter_days,
'single_date_only': single_date_only,
'manual_date': manual_date
},
status='success'
)
return jsonify({ return jsonify({
'status': 'success', 'status': 'success',
'stats': stats, 'stats': stats,
'source_url': importer.base_url 'source_url': importer.base_url
}), 200 }), 200
except Exception as e:
user_info = getattr(g, 'current_user', {}) or {}
user_email = user_info.get('email') if isinstance(user_info, dict) else getattr(user_info, 'email', None)
AuditService.log(
action='SHEETS_IMPORT_ERROR',
module='import',
user_email=user_email,
ip_address=request.remote_addr,
details={
'error': str(e),
'filter_career': filter_career,
'filter_subject': filter_subject,
'filter_day': filter_day
},
status='failed'
)
return jsonify({
'status': 'error',
'message': str(e)
}), 500
@api_dashboard_bp.route('/sheets-inspect', methods=['GET', 'POST'])
@jwt_required
def inspect_google_sheets():
"""Devuelve metadatos, carreras, materias y previsualización de registros según los filtros aplicados."""
from app.services.sheets_importer import GoogleSheetsImporter
try:
data = request.get_json(silent=True) or {}
custom_url = data.get('sheets_url') or request.args.get('sheets_url')
filter_career = data.get('filter_career') or request.args.get('filter_career')
filter_subject = data.get('filter_subject') or request.args.get('filter_subject')
filter_day = data.get('filter_day') or request.args.get('filter_day')
filter_days = data.get('filter_days') or request.args.get('filter_days')
manual_date = data.get('manual_date') or request.args.get('manual_date')
importer = GoogleSheetsImporter(base_url=custom_url)
metadata = importer.inspect_sheet_content(
filter_career=filter_career,
filter_subject=filter_subject,
filter_day=filter_day,
filter_days=filter_days,
manual_date=manual_date
)
return jsonify({
'status': 'success',
'metadata': metadata,
'source_url': importer.base_url
}), 200
except Exception as e: except Exception as e:
return jsonify({ return jsonify({
'status': 'error', 'status': 'error',
+20 -1
View File
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
"info": { "info": {
"title": "Edu-Space REST API", "title": "Edu-Space REST API",
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
"version": "1.0.0" "version": "3.5.0"
}, },
"servers": [ "servers": [
{ {
@@ -240,3 +240,22 @@ OPENAPI_SPEC = {
def get_openapi_spec(): def get_openapi_spec():
"""Serves the OpenAPI 3.0 specification for Schemathesis / DAST and Swagger UI.""" """Serves the OpenAPI 3.0 specification for Schemathesis / DAST and Swagger UI."""
return jsonify(OPENAPI_SPEC) return jsonify(OPENAPI_SPEC)
from app import __version__
@api_openapi_bp.route('/version', methods=['GET'])
def get_api_version():
"""Returns the backend API version information."""
return jsonify({
"name": "Edu-Space REST API",
"version": __version__,
"status": "healthy"
}), 200
@api_openapi_bp.route('/health', methods=['GET'])
def get_api_health():
"""Liveness probe for backend API."""
return jsonify({
"status": "ok",
"version": __version__
}), 200
+53
View File
@@ -5,6 +5,7 @@ from pydantic import ValidationError
from app import db from app import db
from app.models.reservation import Reservation from app.models.reservation import Reservation
from app.services.reservation_service import ReservationService from app.services.reservation_service import ReservationService
from app.services.audit_service import AuditService
from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO
from app.utils.jwt_decorators import jwt_required, jwt_role_required from app.utils.jwt_decorators import jwt_required, jwt_role_required
@@ -86,6 +87,9 @@ def list_reservations():
'purpose': r.purpose, 'purpose': r.purpose,
'subject_name': r.subject_name, 'subject_name': r.subject_name,
'subject_code': r.subject_code, 'subject_code': r.subject_code,
'career_name': r.commission.career_name if (r.commission and hasattr(r.commission, 'career_name')) else '',
'career_names': r.commission.career_names if (r.commission and hasattr(r.commission, 'career_names')) else '',
'commission_code': r.commission.code if r.commission else '',
'status': str(r.status.value if hasattr(r.status, 'value') else r.status), 'status': str(r.status.value if hasattr(r.status, 'value') else r.status),
'shift': r.shift or 'Mañana', 'shift': r.shift or 'Mañana',
'virtual_link': r.virtual_link, 'virtual_link': r.virtual_link,
@@ -184,6 +188,13 @@ def create_reservation():
try: try:
reservation = reservation_service.create_reservation(dto) reservation = reservation_service.create_reservation(dto)
AuditService.log(
action='CREATE',
module='reservations',
entity_id=reservation.id,
user=g.jwt_user,
details=f"Nueva reserva creada #{reservation.id} en aula ID {reservation.classroom_id} ({reservation.start_time.strftime('%Y-%m-%d %H:%M')} a {reservation.end_time.strftime('%H:%M')}) - Motivo: {reservation.purpose}"
)
return jsonify({ return jsonify({
'message': 'Reserva creada exitosamente.', 'message': 'Reserva creada exitosamente.',
'id': reservation.id, 'id': reservation.id,
@@ -207,6 +218,13 @@ def update_reservation(reservation_id: int):
try: try:
reservation = reservation_service.update_reservation(reservation_id, dto) reservation = reservation_service.update_reservation(reservation_id, dto)
AuditService.log(
action='UPDATE',
module='reservations',
entity_id=reservation.id,
user=g.jwt_user,
details=f"Reserva #{reservation.id} modificada ({reservation.start_time.strftime('%Y-%m-%d %H:%M')} a {reservation.end_time.strftime('%H:%M')}) - Estado: {reservation.status}"
)
return jsonify({ return jsonify({
'message': 'Reserva actualizada exitosamente.', 'message': 'Reserva actualizada exitosamente.',
'id': reservation.id, 'id': reservation.id,
@@ -228,12 +246,26 @@ def cancel_reservation(reservation_id: int):
return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
db.session.delete(res) db.session.delete(res)
db.session.commit() db.session.commit()
AuditService.log(
action='DELETE',
module='reservations',
entity_id=reservation_id,
user=g.jwt_user,
details=f"Reserva #{reservation_id} eliminada permanentemente"
)
return jsonify({'message': f'Reserva {reservation_id} eliminada permanentemente.'}), 200 return jsonify({'message': f'Reserva {reservation_id} eliminada permanentemente.'}), 200
cancelled = reservation_service.cancel_reservation(reservation_id) cancelled = reservation_service.cancel_reservation(reservation_id)
if not cancelled: if not cancelled:
return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
AuditService.log(
action='CANCEL',
module='reservations',
entity_id=reservation_id,
user=g.jwt_user,
details=f"Reserva #{reservation_id} cancelada"
)
return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200 return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200
@api_reservations_bp.route('/<int:reservation_id>/delete', methods=['POST']) @api_reservations_bp.route('/<int:reservation_id>/delete', methods=['POST'])
@@ -245,6 +277,13 @@ def delete_reservation_post(reservation_id: int):
return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
db.session.delete(res) db.session.delete(res)
db.session.commit() db.session.commit()
AuditService.log(
action='DELETE',
module='reservations',
entity_id=reservation_id,
user=g.jwt_user,
details=f"Reserva #{reservation_id} eliminada permanentemente"
)
return jsonify({'message': f'Reserva {reservation_id} eliminada permanentemente.'}), 200 return jsonify({'message': f'Reserva {reservation_id} eliminada permanentemente.'}), 200
@api_reservations_bp.route('/<int:reservation_id>/cancel', methods=['POST']) @api_reservations_bp.route('/<int:reservation_id>/cancel', methods=['POST'])
@@ -255,6 +294,13 @@ def cancel_reservation_post(reservation_id: int):
if not cancelled: if not cancelled:
return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
AuditService.log(
action='CANCEL',
module='reservations',
entity_id=reservation_id,
user=g.jwt_user,
details=f"Reserva #{reservation_id} cancelada"
)
return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200 return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200
@api_reservations_bp.route('/<int:reservation_id>/confirm', methods=['POST']) @api_reservations_bp.route('/<int:reservation_id>/confirm', methods=['POST'])
@@ -265,6 +311,13 @@ def confirm_reservation(reservation_id: int):
if not confirmed: if not confirmed:
return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
AuditService.log(
action='CONFIRM',
module='reservations',
entity_id=reservation_id,
user=g.jwt_user,
details=f"Reserva #{reservation_id} confirmada oficialmente"
)
return jsonify({'message': f'Reserva {reservation_id} confirmada correctamente.'}), 200 return jsonify({'message': f'Reserva {reservation_id} confirmada correctamente.'}), 200
@api_reservations_bp.route('/check-conflicts', methods=['POST']) @api_reservations_bp.route('/check-conflicts', methods=['POST'])
+51 -7
View File
@@ -3,11 +3,39 @@ from datetime import datetime, timedelta
from app.models.genetic_algorithm import ReservationOptimizer from app.models.genetic_algorithm import ReservationOptimizer
from app.models.reservation import Reservation, ReservationStatus from app.models.reservation import Reservation, ReservationStatus
from app import db from app import db
from app.services.audit_service import AuditService
from app.utils.jwt_decorators import jwt_required from app.utils.jwt_decorators import jwt_required
genetic_bp = Blueprint('genetic_algorithm', __name__, url_prefix='/api/genetic') genetic_bp = Blueprint('genetic_algorithm', __name__, url_prefix='/api/genetic')
def check_optimizer_permission(user, requires_write=False):
"""
Verifica si el usuario tiene permiso para consultar o ejecutar el optimizador de reservas.
Permitido para Administradores, Bedelía, Docentes o usuarios con permisos RBAC en 'optimizer'.
"""
if not user:
return False
# 1. Administrador (método o rol)
if hasattr(user, 'is_admin') and user.is_admin():
return True
role = (getattr(user, 'role', '') or '').strip().lower()
if role in ['admin', 'administrador', 'bedelia']:
return True
if role in ['docente', 'teacher']:
return True
# 2. RBAC granular
if hasattr(user, 'has_permission'):
if requires_write:
return user.has_permission('optimizer', 'read_write')
return user.has_permission('optimizer', 'read') or user.has_permission('optimizer', 'read_write')
return False
@genetic_bp.route('/optimize', methods=['POST']) @genetic_bp.route('/optimize', methods=['POST'])
@jwt_required @jwt_required
def optimize_reservations(): def optimize_reservations():
@@ -39,8 +67,8 @@ def optimize_reservations():
except ValueError: except ValueError:
return jsonify({'error': 'Invalid end_date format. Use ISO format.'}), 400 return jsonify({'error': 'Invalid end_date format. Use ISO format.'}), 400
# Check if user has permission (admin, teacher or RBAC optimizer write) # Check if user has permission (admin, bedelia, teacher or RBAC optimizer write)
if not (g.jwt_user.is_admin() or g.jwt_user.has_permission('optimizer', 'read_write') or g.jwt_user.role in ['ADMIN', 'teacher']): if not check_optimizer_permission(g.jwt_user, requires_write=True):
return jsonify({'error': 'Insufficient permissions to optimize reservations'}), 403 return jsonify({'error': 'Insufficient permissions to optimize reservations'}), 403
# Initialize optimizer and run optimization # Initialize optimizer and run optimization
@@ -52,6 +80,13 @@ def optimize_reservations():
end_date=end_date end_date=end_date
) )
AuditService.log(
action='OPTIMIZE_RUN',
module='optimizer',
user=g.jwt_user,
details=f"Ejecución de algoritmo genético para {len(commission_ids)} comisiones. Fitness: {result.get('fitness_score', 0)}% (Asignadas: {len(result.get('assigned_reservations', []))})"
)
return jsonify({ return jsonify({
'success': True, 'success': True,
'data': { 'data': {
@@ -84,13 +119,20 @@ def apply_optimization():
return jsonify({'error': 'reservations must be a list'}), 400 return jsonify({'error': 'reservations must be a list'}), 400
# Check if user has permission # Check if user has permission
if not (g.jwt_user.is_admin() or g.jwt_user.has_permission('optimizer', 'read_write') or g.jwt_user.role in ['ADMIN', 'teacher']): if not check_optimizer_permission(g.jwt_user, requires_write=True):
return jsonify({'error': 'Insufficient permissions to apply reservations'}), 403 return jsonify({'error': 'Insufficient permissions to apply reservations'}), 403
# Initialize optimizer and apply reservations # Initialize optimizer and apply reservations
optimizer = ReservationOptimizer() optimizer = ReservationOptimizer()
applied_reservations = optimizer.apply_optimized_reservations(reservations_data) applied_reservations = optimizer.apply_optimized_reservations(reservations_data)
AuditService.log(
action='OPTIMIZE_APPLY',
module='optimizer',
user=g.jwt_user,
details=f"Consolidación de optimizador genético: {len(applied_reservations)} reservas aplicadas en base de datos."
)
return jsonify({ return jsonify({
'success': True, 'success': True,
'data': { 'data': {
@@ -124,7 +166,7 @@ def preview_optimization():
return jsonify({'error': 'commission_ids must be a non-empty list'}), 400 return jsonify({'error': 'commission_ids must be a non-empty list'}), 400
# Check if user has permission # Check if user has permission
if g.jwt_user.role not in ['ADMIN', 'teacher']: if not check_optimizer_permission(g.jwt_user, requires_write=False):
return jsonify({'error': 'Insufficient permissions to preview optimization'}), 403 return jsonify({'error': 'Insufficient permissions to preview optimization'}), 403
# Initialize optimizer and run optimization # Initialize optimizer and run optimization
@@ -171,7 +213,7 @@ def get_commissions():
"""Get available commissions for optimization""" """Get available commissions for optimization"""
try: try:
# Check if user has permission # Check if user has permission
if g.jwt_user.role not in ['ADMIN', 'teacher']: if not check_optimizer_permission(g.jwt_user, requires_write=False):
return jsonify({'error': 'Insufficient permissions'}), 403 return jsonify({'error': 'Insufficient permissions'}), 403
from app.models.subject import Commission, Subject from app.models.subject import Commission, Subject
@@ -183,6 +225,8 @@ def get_commissions():
for commission in commissions: for commission in commissions:
commission_dict = commission.to_dict() commission_dict = commission.to_dict()
commission_dict['get_full_code'] = commission.get_full_code() commission_dict['get_full_code'] = commission.get_full_code()
commission_dict['subject_name'] = commission.subject.name if commission.subject else 'Sin Asignatura'
commission_dict['subject_code'] = commission.subject.code if commission.subject else ''
commissions_data.append(commission_dict) commissions_data.append(commission_dict)
return jsonify({ return jsonify({
@@ -201,7 +245,7 @@ def get_algorithm_status():
"""Get genetic algorithm configuration status""" """Get genetic algorithm configuration status"""
try: try:
# Check if user has permission # Check if user has permission
if g.jwt_user.role not in ['ADMIN']: if not check_optimizer_permission(g.jwt_user, requires_write=False):
return jsonify({'error': 'Insufficient permissions'}), 403 return jsonify({'error': 'Insufficient permissions'}), 403
# Get system status # Get system status
@@ -249,7 +293,7 @@ genetic_web_bp = Blueprint('genetic_algorithm_web', __name__)
@jwt_required @jwt_required
def genetic_optimizer(): def genetic_optimizer():
"""Render the genetic algorithm optimizer interface""" """Render the genetic algorithm optimizer interface"""
if not (g.jwt_user.has_permission('optimizer', 'read') or (g.jwt_user.role and g.jwt_user.role.upper() == 'ADMIN')): if not check_optimizer_permission(g.jwt_user, requires_write=False):
return render_template('auth/403.html'), 403 return render_template('auth/403.html'), 403
return render_template('genetic_optimizer.html') return render_template('genetic_optimizer.html')
+13 -5
View File
@@ -12,19 +12,27 @@ class AuditService:
@staticmethod @staticmethod
def log(action: str, module: str, entity_id: Optional[int] = None, def log(action: str, module: str, entity_id: Optional[int] = None,
details: Optional[Any] = None, user: Optional[User] = None, details: Optional[Any] = None, user: Optional[User] = None,
ip_address: Optional[str] = None) -> AuditLog: ip_address: Optional[str] = None,
user_id: Optional[int] = None,
user_email: Optional[str] = None,
status: Optional[str] = None,
**kwargs) -> AuditLog:
""" """
Registra un evento de auditoría de forma segura, infiriendo el usuario e IP Registra un evento de auditoría de forma segura, infiriendo el usuario e IP
desde el contexto actual de la petición si no se especifican. desde el contexto actual de la petición si no se especifican.
""" """
user_id = None if status:
user_email = None if isinstance(details, dict):
details['status'] = status
elif details:
details = f"[{status.upper()}] {details}"
else:
details = {'status': status}
# 1. Determinar usuario actuante # 1. Determinar usuario actuante
if user: if user:
user_id = user.id user_id = user.id
user_email = user.email user_email = user.email
elif has_request_context(): elif not user_id and not user_email and has_request_context():
if hasattr(g, 'jwt_user') and g.jwt_user: if hasattr(g, 'jwt_user') and g.jwt_user:
user_id = g.jwt_user.id user_id = g.jwt_user.id
user_email = g.jwt_user.email user_email = g.jwt_user.email
+540 -117
View File
@@ -11,7 +11,57 @@ from app.models.subject import Subject, Commission
from app.models.reservation import Reservation, ReservationStatus from app.models.reservation import Reservation, ReservationStatus
from app.models.user import User 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 normalize_day_name(day_str):
"""Normaliza cualquier variante de día a su nombre canónico en español (Lunes..Sábado)"""
if not day_str:
return ''
d = day_str.strip().lower()
d = d.replace('á', 'a').replace('é', 'e').replace('í', 'i').replace('ó', 'o').replace('ú', 'u')
if 'lun' in d: return 'Lunes'
if 'mar' in d: return 'Martes'
if 'mie' in d: return 'Miércoles'
if 'jue' in d: return 'Jueves'
if 'vie' in d: return 'Viernes'
if 'sab' in d: return 'Sábado'
if 'dom' in d: return 'Domingo'
return day_str.strip()
def map_day_to_idx(day_str): def map_day_to_idx(day_str):
"""Mapea el nombre del día (o prefijo) a su índice numérico 0..6 (Lunes=0)""" """Mapea el nombre del día (o prefijo) a su índice numérico 0..6 (Lunes=0)"""
@@ -25,6 +75,36 @@ def map_day_to_idx(day_str):
if 'dom' in d: return 6 if 'dom' in d: return 6
return 0 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): def normalize_sheets_url(url):
""" """
Normaliza enlaces de Google Sheets (compartidos, de edición, con /u/1/, #gid=... o /pubhtml) Normaliza enlaces de Google Sheets (compartidos, de edición, con /u/1/, #gid=... o /pubhtml)
@@ -38,7 +118,7 @@ def normalize_sheets_url(url):
pub_match = re.search(r'/spreadsheets/(?:u/\d+/)?d/e/([a-zA-Z0-9-_]+)', url) pub_match = re.search(r'/spreadsheets/(?:u/\d+/)?d/e/([a-zA-Z0-9-_]+)', url)
if pub_match: if pub_match:
doc_id = pub_match.group(1) 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>/...) # 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) sheet_id_match = re.search(r'/spreadsheets/(?:u/\d+/)?d/([a-zA-Z0-9-_]+)', url)
@@ -61,8 +141,8 @@ TIME_REGEX = re.compile(r'(\d{1,2})(?::(\d{2}))?\s*(?:a|-|to)\s*(\d{1,2})(?::(\d
class GoogleSheetsImporter: class GoogleSheetsImporter:
""" """
Service to fetch, parse, and synchronize academic schedules, Servicio para descargar, parsear y sincronizar cursadas académicas,
classrooms, careers, and subjects from the official UniCABA Google Sheet. aulas, carreras y asignaturas compartidas desde el Google Sheet oficial de UniCABA.
""" """
def __init__(self, base_url=None): def __init__(self, base_url=None):
@@ -82,7 +162,7 @@ class GoogleSheetsImporter:
def get_sheets_config(self): def get_sheets_config(self):
""" """
Descubre las pestañas y GIDs dinámicamente desde /pubhtml si está disponible, 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) pub_match = re.search(r'/spreadsheets/d/e/([a-zA-Z0-9-_]+)', self.base_url)
if pub_match: if pub_match:
@@ -91,12 +171,12 @@ class GoogleSheetsImporter:
try: try:
req = urllib.request.Request( req = urllib.request.Request(
pubhtml_url, 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: with urllib.request.urlopen(req, timeout=12) as resp:
html_content = resp.read().decode('utf-8', errors='replace') html_content = resp.read().decode('utf-8', errors='replace')
# Extraer pares name y gid de Google Sheets pubhtml # 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: if found:
discovered = [] discovered = []
for name, gid in found: for name, gid in found:
@@ -121,7 +201,7 @@ class GoogleSheetsImporter:
raise ValueError(f"URL scheme not permitted: {url}") raise ValueError(f"URL scheme not permitted: {url}")
req = urllib.request.Request( req = urllib.request.Request(
url, 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 with urllib.request.urlopen(req, timeout=25) as resp: # nosec B310
return resp.read().decode('utf-8', errors='replace') return resp.read().decode('utf-8', errors='replace')
@@ -189,6 +269,14 @@ class GoogleSheetsImporter:
elif h < 13: elif h < 13:
record_shift = 'Mañana' record_shift = 'Mañana'
v_link_row = None
if len(row) > col_offset + 5:
for extra_c in row[col_offset + 5:]:
extra_clean = _clean(extra_c)
if any(x in extra_clean.lower() for x in ['http://', 'https://', 'zoom.us', 'meet.google.com', 'teams.microsoft.com']):
v_link_row = extra_clean
break
records.append({ records.append({
'dia': sheet_name, 'dia': sheet_name,
'codigo': codigo, 'codigo': codigo,
@@ -196,13 +284,14 @@ class GoogleSheetsImporter:
'aula': aula, 'aula': aula,
'carrera': carrera, 'carrera': carrera,
'horario': horario, 'horario': horario,
'turno': record_shift 'turno': record_shift,
'virtual_link': v_link_row
}) })
return records return records
def normalize_room(self, aula_raw): 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() 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']): if not aula_upper or any(x in aula_upper for x in ['FERIADO', 'SIN ACTIVIDAD', 'CONSULTAR EN BEDELIA']):
@@ -272,15 +361,212 @@ class GoogleSheetsImporter:
except Exception: except Exception:
return None, None return None, None
def sync(self): def inspect_sheet_content(self, filter_career=None, filter_subject=None, filter_day=None, filter_days=None, manual_date=None):
""" """
Main synchronization process: Descarga e inspecciona las hojas del Sheet online para extraer:
1. Fetches all 6 day sheets. - Días disponibles con cantidad de filas
2. Upserts Careers, Classrooms, Subjects, Commissions. - Carreras únicas
3. Generates Reservations in the calendar for the semester. - Materias únicas con sus códigos, nombres y carreras
- Grilla de pre-visualización interactiva (preview_rows) según los filtros aplicados
""" """
sheets_to_process = self.get_sheets_config()
days_info = []
careers_set = set()
subjects_map = {}
total_rows = 0
preview_rows = []
# Normalizar días seleccionados
allowed_days = None
if filter_days:
if isinstance(filter_days, str):
allowed_days = [normalize_day_name(d) for d in filter_days.split(',') if d.strip()]
elif isinstance(filter_days, (list, set)):
allowed_days = [normalize_day_name(d) for d in filter_days if d]
elif filter_day:
nd = normalize_day_name(filter_day)
if nd and nd.upper() not in ['ALL', 'TODOS', 'TODOS LOS DÍAS', 'TODOS LOS DIAS', '']:
allowed_days = [nd]
# Normalizar fecha manual para fecha inferida base
manual_dt = None
if manual_date:
try:
if isinstance(manual_date, (datetime, date)):
manual_dt = manual_date if isinstance(manual_date, date) else manual_date.date()
elif isinstance(manual_date, str) and manual_date.strip():
manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date()
except Exception:
pass
# Referencia de semana base: lunes 5 de octubre de 2026 (semana activa del 2° cuatrimestre)
ref_monday = date(2026, 10, 5)
if manual_dt:
ref_monday = manual_dt - timedelta(days=manual_dt.weekday())
row_counter = 0
for sheet_cfg in sheets_to_process:
day_name = sheet_cfg['name']
norm_day = normalize_day_name(day_name)
day_idx = sheet_cfg.get('day_idx', 0)
try:
csv_data = self.fetch_sheet_csv(sheet_cfg['gid'])
rows = self.parse_sheet_rows(csv_data, day_name)
total_rows += len(rows)
days_info.append({
'name': day_name,
'gid': sheet_cfg['gid'],
'day_idx': day_idx,
'rows_count': len(rows),
'status': 'OK'
})
# Si este día no está entre los permitidos, no lo agregamos a preview_rows
if allowed_days and norm_day not in allowed_days:
continue
for r in rows:
carreras = parse_careers_list(r.get('carrera', ''))
for c in carreras:
if c and c != 'General':
careers_set.add(c)
code = r.get('codigo', '').strip()
name = r.get('asignatura', '').strip()
if code and name:
if code not in subjects_map:
subjects_map[code] = {
'code': code,
'name': name,
'careers': carreras,
'day': day_name
}
# Evaluar coincidencia de filtros de Carrera y Materia para la pre-visualización
if filter_career:
fc = filter_career.strip().upper()
match_c = any(fc in c.upper() or c.upper() in fc for c in carreras) or (fc in r.get('carrera', '').upper())
if not match_c:
continue
if filter_subject:
fs = filter_subject.strip().upper()
sub_codes = parse_subject_codes(code)
match_s = (fs in code.upper()) or (fs in name.upper()) or any(fs in sc.upper() for sc in sub_codes)
if not match_s:
continue
row_counter += 1
aula_raw = r.get('aula', '').strip()
room_info = self.normalize_room(aula_raw)
is_virtual = bool(room_info and ('VIRTUAL' in room_info.get('code', '').upper() or room_info.get('building') == 'Campus Virtual'))
# Calcular fecha tentativa
target_date = ref_monday + timedelta(days=day_idx)
if manual_dt and norm_day == normalize_day_name(['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado'][manual_dt.weekday()]):
target_date = manual_dt
# Validaciones
is_valid = True
has_warning = False
warning_msg = None
if not code or not name:
is_valid = False
warning_msg = "Falta código o nombre de asignatura"
elif not room_info or not aula_raw or any(x in aula_raw.upper() for x in ['FERIADO', 'SIN ACTIVIDAD', 'CONSULTAR']):
has_warning = True
warning_msg = f"Aula pendiente o sin asignar ({aula_raw or 'Vacía'})"
preview_rows.append({
'id': row_counter,
'dia': norm_day,
'day_idx': day_idx,
'codigo': code,
'asignatura': name,
'aula': aula_raw or (room_info['code'] if room_info else 'Sin Aula'),
'aula_normalizada': room_info['code'] if room_info else 'Sin Aula',
'is_virtual': is_virtual,
'carrera': r.get('carrera', 'General'),
'carreras_list': carreras,
'horario': r.get('horario', ''),
'turno': r.get('turno', 'Mañana'),
'inferred_date': target_date.strftime('%Y-%m-%d'),
'is_valid': is_valid,
'has_warning': has_warning,
'warning_msg': warning_msg
})
except Exception as e:
days_info.append({
'name': day_name,
'gid': sheet_cfg['gid'],
'day_idx': day_idx,
'rows_count': 0,
'status': 'Error',
'error': str(e)
})
return {
'total_rows': total_rows,
'matching_rows': len(preview_rows),
'days': days_info,
'careers': sorted(list(careers_set)),
'subjects': sorted(list(subjects_map.values()), key=lambda x: x['code']),
'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):
"""
Proceso principal de sincronización con soporte de filtros, entidades granulares y filas seleccionadas:
: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 import_careers: Booleano para importar/crear carreras
:param import_subjects: Booleano para importar/crear asignaturas
:param import_commissions: Booleano para importar/crear comisiones
:param import_classrooms: Booleano para importar/crear aulas
:param import_reservations: Booleano para importar/crear reservas
:param selected_rows: Lista de filas específicas pre-seleccionadas desde la grilla interactiva
"""
dias_esp = ['Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado', 'Domingo']
# Normalizar fecha manual si fue provista
manual_dt = None
if manual_date:
try:
if isinstance(manual_date, (datetime, date)):
manual_dt = manual_date if isinstance(manual_date, date) else manual_date.date()
elif isinstance(manual_date, str) and manual_date.strip():
manual_dt = datetime.strptime(manual_date.strip(), '%Y-%m-%d').date()
except Exception:
pass
# Normalizar días permitidos
allowed_days = None
if filter_days:
if isinstance(filter_days, str):
allowed_days = [normalize_day_name(d) for d in filter_days.split(',') if d.strip()]
elif isinstance(filter_days, (list, set)):
allowed_days = [normalize_day_name(d) for d in filter_days if d]
elif filter_day:
nd = normalize_day_name(filter_day)
if nd and nd.upper() not in ['ALL', 'TODOS', 'TODOS LOS DÍAS', 'TODOS LOS DIAS', '']:
allowed_days = [nd]
# Si el usuario no especificó días pero ingresó fecha manual puntual, inferir día
if not allowed_days and manual_dt and single_date_only:
manual_w = manual_dt.weekday()
if manual_w < 6:
allowed_days = [dias_esp[manual_w]]
stats = { stats = {
'total_rows_processed': 0, 'total_rows_processed': 0,
'matching_rows': 0,
'careers_created': 0, 'careers_created': 0,
'careers_updated': 0, 'careers_updated': 0,
'classrooms_created': 0, 'classrooms_created': 0,
@@ -289,19 +575,62 @@ class GoogleSheetsImporter:
'subjects_updated': 0, 'subjects_updated': 0,
'commissions_created': 0, 'commissions_created': 0,
'reservations_created': 0, 'reservations_created': 0,
'by_day': {},
'errors': [], 'errors': [],
'sample_records': [] 'sample_records': [],
'filters_applied': {
'career': filter_career.strip() if filter_career else None,
'subject': filter_subject.strip() if filter_subject else None,
'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),
'entities': {
'careers': bool(import_careers),
'subjects': bool(import_subjects),
'commissions': bool(import_commissions),
'classrooms': bool(import_classrooms),
'reservations': bool(import_reservations)
}
}
} }
all_raw_records = [] all_raw_records = []
sheets_to_process = self.get_sheets_config()
for sheet_cfg in sheets_to_process: if selected_rows and isinstance(selected_rows, list) and len(selected_rows) > 0:
try: # Modo grilla interactiva: se procesan las filas explícitamente seleccionadas por el usuario
csv_data = self.fetch_sheet_csv(sheet_cfg['gid']) for r in selected_rows:
rows = self.parse_sheet_rows(csv_data, sheet_cfg['name']) d_name = r.get('dia') or 'Lunes'
all_raw_records.extend([(r, sheet_cfg['day_idx']) for r in rows]) d_idx = map_day_to_idx(d_name)
except Exception as e: all_raw_records.append((r, d_idx))
stats['errors'].append(f"Error al descargar o procesar la hoja de {sheet_cfg['name']}: {str(e)}") if d_name not in stats['by_day']:
stats['by_day'][d_name] = {'rows_count': 0, 'status': 'OK'}
stats['by_day'][d_name]['rows_count'] += 1
else:
# Modo descarga general desde Google Sheets
sheets_to_process = self.get_sheets_config()
if allowed_days:
sheets_to_process = [s for s in sheets_to_process if normalize_day_name(s['name']) in allowed_days]
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, 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:
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) stats['total_rows_processed'] = len(all_raw_records)
if not all_raw_records: if not all_raw_records:
@@ -344,30 +673,62 @@ class GoogleSheetsImporter:
classrooms_cache = {(c.building.strip().upper(), c.code.strip().upper()): c for c in Classroom.query.all()} 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()} subjects_cache = {s.code.strip().upper(): s for s in Subject.query.all()}
# Calculate current semester dates (anchored on academic year 2026) # Calculate semester dates (anchored on academic year 2026 or manual date base)
# Week starting Monday 2026-08-31 to Saturday 2026-09-05
base_monday = date(2026, 8, 31) base_monday = date(2026, 8, 31)
weeks_to_generate = 4 # Generate reservations for 4 consecutive weeks 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
for rec, day_idx in all_raw_records: for rec, day_idx in all_raw_records:
try: try:
codigo = rec['codigo'] codigo = rec['codigo']
asignatura = rec['asignatura'] asignatura = rec['asignatura']
aula_raw = rec['aula'] aula_raw = rec['aula']
carrera_name = rec['carrera'].strip() carrera_raw = rec['carrera'].strip()
horario_raw = rec['horario'] horario_raw = rec['horario']
dia = rec['dia'] dia = rec['dia'] or (dias_esp[manual_dt.weekday()] if manual_dt else 'Lunes')
turno = rec.get('turno', 'Mañana') turno = rec.get('turno', 'Mañana')
# 1. Upsert Career # Si el registro no traía día pero hay fecha manual, asignar día de la fecha
carrera_key = carrera_name.upper() if day_idx is None and manual_dt:
career = careers_cache.get(carrera_key) day_idx = manual_dt.weekday()
if not career:
career = Career(name=carrera_name) # --- FILTRO 1: Filtrar por Carrera si fue especificada ---
db.session.add(career) carreras_list = parse_careers_list(carrera_raw)
db.session.flush() if filter_career:
careers_cache[carrera_key] = career fc = filter_career.strip().upper()
stats['careers_created'] += 1 match_c = any(fc in c.upper() or c.upper() in fc for c in carreras_list) or (fc in carrera_raw.upper())
if not match_c:
continue
# --- FILTRO 2: Filtrar por Materia si fue especificada ---
sub_codes = parse_subject_codes(codigo)
if filter_subject:
fs = filter_subject.strip().upper()
match_s = (fs in codigo.upper()) or (fs in asignatura.upper()) or any(fs in sc.upper() for sc in sub_codes)
if not match_s:
continue
stats['matching_rows'] += 1
# 1. Upsert Careers (Desglosar carreras múltiples normalizadas)
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 and import_careers:
career = Career(name=c_name)
db.session.add(career)
db.session.flush()
stats['careers_created'] += 1
if career:
careers_cache[c_key] = career
if career:
career_objs.append(career)
primary_career = career_objs[0] if career_objs else None
# 2. Upsert Classroom # 2. Upsert Classroom
room_info = self.normalize_room(aula_raw) room_info = self.normalize_room(aula_raw)
@@ -377,100 +738,158 @@ class GoogleSheetsImporter:
classroom = classrooms_cache.get(room_key) classroom = classrooms_cache.get(room_key)
b_entity = buildings_cache.get(room_info['building'].upper()) b_entity = buildings_cache.get(room_info['building'].upper())
if not classroom: if not classroom:
classroom = Classroom( if import_classrooms:
building=room_info['building'], classroom = Classroom(
building_id=b_entity.id if b_entity else None, building=room_info['building'],
floor=room_info['floor'], building_id=b_entity.id if b_entity else None,
capacity=room_info['capacity'], floor=room_info['floor'],
description=room_info['description'], capacity=room_info['capacity'],
is_active=True description=room_info['description'],
) is_active=True
classroom.code = room_info['code'] )
db.session.add(classroom) classroom.code = room_info['code']
db.session.flush() db.session.add(classroom)
classrooms_cache[room_key] = classroom db.session.flush()
stats['classrooms_created'] += 1 classrooms_cache[room_key] = classroom
stats['classrooms_created'] += 1
else:
classroom = Classroom.query.filter_by(code=room_info['code']).first()
else: else:
classroom.capacity = max(classroom.capacity, room_info['capacity']) if import_classrooms:
if not classroom.building_id and b_entity: classroom.capacity = max(classroom.capacity, room_info['capacity'])
classroom.building_id = b_entity.id 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() subject_key = codigo.upper()
subject = subjects_cache.get(subject_key) subject = subjects_cache.get(subject_key)
if not subject: if not subject:
subject = Subject( for sc in sub_codes:
code=codigo, if sc.upper() in subjects_cache:
name=asignatura, subject = subjects_cache[sc.upper()]
career_id=career.id, break
department=career.name,
credits=4, if not subject:
is_active=True subject = Subject.query.filter_by(code=codigo).first()
) if not subject:
db.session.add(subject) for sc in sub_codes:
db.session.flush() subj_by_sc = Subject.query.filter_by(code=sc).first()
subjects_cache[subject_key] = subject if subj_by_sc:
stats['subjects_created'] += 1 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:
if import_subjects:
subject = Subject(
code=codigo,
name=asignatura,
career_id=primary_career.id if primary_career else None,
department=department_str,
credits=4,
is_active=True
)
if career_objs:
subject.careers = career_objs
db.session.add(subject)
db.session.flush()
stats['subjects_created'] += 1
else: else:
if subject.name != asignatura: if import_subjects:
subject.name = asignatura if subject.name != asignatura:
stats['subjects_updated'] += 1 subject.name = asignatura
subject.career_id = career.id stats['subjects_updated'] += 1
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 si existe
if subject:
subjects_cache[subject_key] = subject
for sc in sub_codes:
subjects_cache[sc.upper()] = subject
# 4. Upsert Commission # 4. Upsert Commission
# Identify commission subcode e.g. from code suffix or default 'C1' commission = None
comm_code = 'C1' if subject:
if '-E' in codigo: comm_code = 'C1'
comm_code = codigo.split('-')[-1] if '-E' in codigo:
comm_code = codigo.split('-')[-1]
elif '-0' in codigo:
comm_code = 'C' + codigo.split('-')[-1]
commission = Commission.query.filter_by( commission = Commission.query.filter_by(
subject_id=subject.id,
code=comm_code,
semester='2026-2',
year=2026
).first()
if not commission:
commission = Commission(
subject_id=subject.id, subject_id=subject.id,
code=comm_code, code=comm_code,
semester='2026-2', semester='2026-2',
year=2026, year=2026
teacher_id=default_user_id, ).first()
max_students=classroom.capacity if classroom else 35,
current_students=0,
schedule=f"{dia} {horario_raw}",
shift=turno,
active=True
)
db.session.add(commission)
db.session.flush()
stats['commissions_created'] += 1
else:
commission.schedule = f"{dia} {horario_raw}"
commission.shift = turno
# 5. Generate Calendar Reservations if not commission:
if import_commissions:
commission = Commission(
subject_id=subject.id,
code=comm_code,
semester='2026-2',
year=2026,
teacher_id=default_user_id,
max_students=classroom.capacity if classroom else 35,
current_students=0,
schedule=f"{dia} {horario_raw}",
shift=turno,
active=True
)
db.session.add(commission)
db.session.flush()
stats['commissions_created'] += 1
else:
if import_commissions:
commission.schedule = f"{dia} {horario_raw}"
commission.shift = turno
if classroom:
commission.max_students = max(commission.max_students or 0, classroom.capacity)
# 5. Generar Reservas de Calendario
t_start, t_end = self.parse_time_range(horario_raw) t_start, t_end = self.parse_time_range(horario_raw)
if classroom and t_start and t_end and day_idx is not None: effective_day_idx = day_idx if day_idx is not None else (manual_dt.weekday() if manual_dt else 0)
if import_reservations and classroom and subject and commission and t_start and t_end:
is_room_virtual = bool(classroom.is_virtual or 'VIRTUAL' in (classroom.code or '').upper()) 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 # Respetar estrictamente los datos del Sheet: si no hay enlace explícito en el documento, NO autogenerar ninguno
v_link = None v_link = rec.get('virtual_link') or None
if is_room_virtual: if v_link and not commission.virtual_link:
clean_subj = re.sub(r'[^a-zA-Z0-9]', '', subject.code or 'cls').lower() commission.virtual_link = v_link
clean_comm = re.sub(r'[^a-zA-Z0-9]', '', commission.code or 'c1').lower()
v_link = f"https://meet.google.com/edu-{clean_subj}-{clean_comm}"
if not commission.virtual_link:
commission.virtual_link = v_link
for w in range(weeks_to_generate): # Determinar fechas a generar: específica de la fila (datepicker), puntual o 16 semanas
class_date = base_monday + timedelta(days=day_idx, weeks=w) dates_to_generate = []
row_specific_date = None
raw_row_date = rec.get('date') or rec.get('inferred_date')
if raw_row_date:
try:
if isinstance(raw_row_date, (datetime, date)):
row_specific_date = raw_row_date if isinstance(raw_row_date, date) else raw_row_date.date()
elif isinstance(raw_row_date, str) and raw_row_date.strip():
row_specific_date = datetime.strptime(raw_row_date.strip(), '%Y-%m-%d').date()
except Exception:
pass
if row_specific_date:
dates_to_generate = [row_specific_date]
elif single_date_only and manual_dt:
dates_to_generate = [manual_dt]
else:
dates_to_generate = [base_monday + timedelta(days=effective_day_idx, weeks=w) for w in range(weeks_to_generate)]
for class_date in dates_to_generate:
dt_start = datetime.combine(class_date, t_start) dt_start = datetime.combine(class_date, t_start)
dt_end = datetime.combine(class_date, t_end) 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: if is_room_virtual:
existing_res = Reservation.query.filter_by( existing_res = Reservation.query.filter_by(
classroom_id=classroom.id, classroom_id=classroom.id,
@@ -485,6 +904,10 @@ class GoogleSheetsImporter:
end_time=dt_end end_time=dt_end
).first() ).first()
c_desc = ", ".join([c.name for c in career_objs]) if career_objs else 'General'
note_suffix = f" [Fecha asignada: {class_date.strftime('%d/%m/%Y')}]" if (manual_dt and single_date_only) else ""
note_text = f"Clase {'puntual ' if (single_date_only and manual_dt) else 'semanal '}{dia} ({turno}) - Carreras: {c_desc}{note_suffix}"
if not existing_res: if not existing_res:
res = Reservation( res = Reservation(
classroom_id=classroom.id, classroom_id=classroom.id,
@@ -497,22 +920,22 @@ class GoogleSheetsImporter:
expected_attendees=min(classroom.capacity, 30) if not is_room_virtual else 35, expected_attendees=min(classroom.capacity, 30) if not is_room_virtual else 35,
shift=turno, shift=turno,
virtual_link=v_link, virtual_link=v_link,
notes=f"Clase semanal {dia} ({turno}) - Carrera: {career.name}" notes=note_text
) )
db.session.add(res) db.session.add(res)
stats['reservations_created'] += 1 stats['reservations_created'] += 1
else: else:
existing_res.shift = turno existing_res.shift = turno
existing_res.notes = f"Clase semanal {dia} ({turno}) - Carrera: {career.name}" existing_res.notes = note_text
if is_room_virtual and not existing_res.virtual_link: if v_link:
existing_res.virtual_link = v_link existing_res.virtual_link = v_link
if len(stats['sample_records']) < 10: if len(stats['sample_records']) < 15:
stats['sample_records'].append({ stats['sample_records'].append({
'dia': dia, 'dia': dia,
'codigo': codigo, 'codigo': codigo,
'asignatura': asignatura, 'asignatura': asignatura,
'carrera': career.name, 'carreras': [c.name for c in career_objs],
'aula': classroom.code_display if classroom else aula_raw, 'aula': classroom.code_display if classroom else aula_raw,
'horario': horario_raw 'horario': horario_raw
}) })
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="1.0.0", version="3.5.0",
description="Administrative interface for Edu-Space Classroom Management System", description="Administrative interface for Edu-Space Classroom Management System",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+86
View File
@@ -0,0 +1,86 @@
import unittest
from datetime import datetime
from app import create_app, db
from app.models.user import User
from app.models.audit_log import AuditLog
from app.services.audit_service import AuditService
from app.services.jwt_service import JWTService
class TestAuditLogs(unittest.TestCase):
@classmethod
def setUpClass(cls):
cls.app = create_app()
cls.app.config['TESTING'] = True
cls.app_context = cls.app.app_context()
cls.app_context.push()
db.create_all()
cls.client = cls.app.test_client()
# Crear o recuperar admin
cls.admin = User.query.filter_by(email='audit_admin@unicaba.edu.ar').first()
if not cls.admin:
cls.admin = User(
name='Admin Audit',
email='audit_admin@unicaba.edu.ar',
role='ADMIN',
is_active=True
)
cls.admin.set_password('Password123!')
db.session.add(cls.admin)
db.session.commit()
cls.tokens = JWTService.generate_tokens(cls.admin)
cls.headers = {'Authorization': f"Bearer {cls.tokens['access_token']}"}
@classmethod
def tearDownClass(cls):
db.session.remove()
cls.app_context.pop()
def test_01_audit_log_to_dict_and_service(self):
log = AuditService.log(
action='LOGIN_TEST',
module='auth',
details='Test audit log entry',
user_email='test@unicaba.edu.ar'
)
self.assertIsNotNone(log.id)
d = log.to_dict()
self.assertEqual(d['action'], 'LOGIN_TEST')
self.assertEqual(d['module'], 'auth')
self.assertEqual(d['user_email'], 'test@unicaba.edu.ar')
self.assertIn('created_at', d)
def test_02_audit_logs_api_endpoint(self):
AuditService.log('LOGIN', 'auth', user=self.admin, details='Login local exitoso')
AuditService.log('LOGIN_FAILED', 'auth', user_email='unknown@test.com', details='Credenciales invalidas')
res = self.client.get('/api/v1/admin/audit-logs', headers=self.headers)
self.assertEqual(res.status_code, 200)
data = res.get_json()
self.assertEqual(data['status'], 'success')
self.assertIn('logs', data)
self.assertIn('pagination', data)
self.assertIn('modules', data)
self.assertIn('actions', data)
self.assertTrue(any(l['action'] == 'LOGIN_FAILED' for l in data['logs']))
def test_03_login_creates_audit_log(self):
# Intento fallido
res = self.client.post('/api/v1/auth/login', json={
'email': 'bad_user@unicaba.edu.ar',
'password': 'wrongpassword'
})
self.assertEqual(res.status_code, 401)
failed_log = AuditLog.query.filter_by(action='LOGIN_FAILED', user_email='bad_user@unicaba.edu.ar').first()
self.assertIsNotNone(failed_log)
# Intento exitoso
res_ok = self.client.post('/api/v1/auth/login', json={
'email': 'audit_admin@unicaba.edu.ar',
'password': 'Password123!'
})
self.assertEqual(res_ok.status_code, 200)
success_log = AuditLog.query.filter_by(action='LOGIN', user_email='audit_admin@unicaba.edu.ar').order_by(AuditLog.id.desc()).first()
self.assertIsNotNone(success_log)
+175 -173
View File
@@ -1,208 +1,210 @@
# GUÍA OPERATIVA DE SISTEMA, RELEVAMIENTO DE BEDELÍA Y ROADMAP DE EVOLUCIÓN # GUÍA OPERATIVA DE SISTEMA, MANUAL DE PROCEDIMIENTOS Y ROADMAP DE EVOLUCIÓN
## Plataforma Admin Edu-Space — UniCABA ## Plataforma Admin Edu-Space — UniCABA
**Documento de Operaciones y Prospectiva Tecnológica** **Documento de Operaciones, Flujo Secuencial de Bedelía y Manual de Usuario**
**Versión:** 1.0 (Producción MVP) **Versión:** 3.3.0 (Producción MVP)
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
--- ---
## 1. Guía de Procedimientos del Programa por Rol ## 1. Guía de Procedimientos Operativos por Rol
### 1.1. Para el Personal de Bedelía (Gestores de Espacios) ---
El personal de Bedelía es el corazón operativo de la infraestructura física universitaria. Su flujo de trabajo en Edu-Space sigue el siguiente ciclo: ### 1.1. Para el Personal de Bedelía (Gestores de Espacios y Cursadas)
El personal de Bedelía es el corazón operativo de la infraestructura física y académica. El objetivo central de este sprint es **reemplazar definitivamente el archivo Excel que Bedelía utiliza actualmente para sus gestiones diarias**. A partir de ahora, la plataforma es la fuente única de verdad para administrar sedes, aulas, ciclos lectivos, materias, comisiones, docentes, alumnos y reservas.
``` ```
[ Inicio de Cuatrimestre ] [ 1. Sede / Edificio ] ──▶ [ 2. Aula (Física/Virtual) ]
│ │ │
▼ ▼ ▼
1. Configuración del Ciclo Lectivo [ 3. Ciclo Lectivo ] ──▶ [ 4. Carrera / Titulación ]
(Fechas de inicio, fin, feriados y recesos) │ │
│ ▼ ▼
▼ [ 5. Asignatura / Materia ] (Vinculada a la Carrera)
2. Carga/Actualización de Aulas y Sede │
(Capacidad física, proyectores, computadoras, AC) ▼
│ [ 6. Crear Comisión ] (Vinculada a Materia, Carrera y Ciclo)
▼ │
3. Importación o Carga de Comisiones y Materias ┌───────────────┴───────────────┐
(Docente a cargo, alumnos inscriptos, días y turnos) ▼ ▼
│ [ 7. Asociar Profesores ] [ 8. Asociar Alumnos ]
▼ │ │
4. Ejecución del Optimizador Genético └───────────────┬───────────────┘
(Distribución automatizada sin colisiones ni solapamientos) ▼
│ [ 9. Reserva de Espacios ]
▼ (Asignación en Aula & Horario)
5. Publicación y Monitoreo en Tiempo Real
(Cartelera digital activa y gestión de contingencias/reparaciones)
``` ```
#### Paso a Paso Operativo: ---
1. **Configuración de Ciclo Lectivo:**
- Navegar al menú **Ciclos Lectivos** en la barra lateral. #### 📋 Flujo Secuencial de 9 Pasos (Paso a Paso Detallado):
- Definir el ciclo activo (ej: `2026 - 2C`), fijando las fechas de inicio de clases, exámenes finales y cierres de actas.
2. **Inventario de Aulas y Recursos:** #### Paso 1: Crear Sitio / Sede (Edificio)
- En **Gestión de Aulas**, registrar cada aula con su capacidad real de asientos, tipo de pizarrón, presencia de proyector, conectividad de red y climatización. 1. **Acceso:** Ir al menú lateral ➔ **Espacios & Sedes** (o **Administración**) ➔ **Sedes / Edificios** (`/buildings/list_buildings`).
- Marcar aulas en estado `Mantenimiento` en caso de fallas edilicias para excluirlas del algoritmo de asignación. 2. **Acción:** Presionar el botón `+ Nueva Sede`.
3. **Carga y Verificación de Comisiones:** 3. **Completar Datos:**
- Ingresar a **Comisiones / Horarios** para verificar la nómina de materias activas, sus horarios (Turno Mañana, Tarde o Noche) y la cantidad estimada de matriculados. - **Nombre:** Ej. *Sede Central UniCABA*.
4. **Asignación Asistida por IA (Optimizador Genético):** - **Dirección / Código:** Ej. *Paseo Colón 255* / *SEDE-CENTRAL*.
- Acceder al módulo **Optimizador Genético**. - **Estado:** Activo.
- Seleccionar el ciclo lectivo y pulsar **"Ejecutar Optimización"**. 4. **Guardar:** Presionar `Guardar Sede`. El edificio queda registrado para albergar aulas físicas.
- El sistema evaluará millones de combinaciones en segundos, priorizando que los grupos más numerosos ocupen las aulas mayores y minimizando distancias de traslado de docentes.
- Bedelía puede revisar el cronograma propuesto y confirmarlo con un clic. #### Paso 2: Crear Aula (Espacios Físicos o Virtuales)
5. **Atención de Cambios de Último Momento:** 1. **Acceso:** Ir al menú lateral ➔ **Espacios & Sedes** ➔ **Catálogo de Aulas** (`/classrooms/list_classrooms`).
- Si un docente requiere cambio de aula o si un equipo multimedia falla, Bedelía ingresa a **Reservas / Asignaciones**, busca la franja horaria y reubica la comisión en un aula alternativa libre sugerida por el sistema. 2. **Acción:** Presionar el botón `+ Nueva Aula` (`/classrooms/add_classroom`).
3. **Seleccionar Tipo de Espacio:**
- **Espacio Físico:** Seleccionar la Sede creada en el Paso 1, indicar el Piso (ej. *1° Piso*), el Código/Nombre del aula (ej. *Aula 101*), Capacidad máxima de bancos (ej. *40*) y Recursos (Proyector, Aire Acondicionado, PCs).
- **Espacio Virtual:** Marcar el casillero `¿Es espacio virtual / remoto?`. El sistema lo vinculará al entorno institucional remoto (Campus Virtual).
4. **Guardar:** Presionar `Crear Aula`. Queda lista para recibir reservas.
#### Paso 3: Crear Ciclo Lectivo (Período Académico)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Ciclos Lectivos** (`/admin/academic_terms_list`).
2. **Acción:** Presionar el botón `+ Nuevo Ciclo Lectivo`.
3. **Completar Datos:**
- **Nombre:** Ej. *2026 - 2° Cuatrimestre* o *2026 - 1C*.
- **Fecha de Inicio y Fin:** Fechas formales del cuatrimestre.
- **Activar:** Marcar como `Ciclo Actual / Activo`. Todas las nuevas comisiones se asignarán por defecto a este ciclo.
4. **Guardar:** Presionar `Guardar Período`.
#### Paso 4: Crear Carrera (Programa Académico / Titulación)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Carreras** (`/admin/careers_list`).
2. **Acción:** Presionar el botón `+ Nueva Carrera`.
3. **Completar Datos:**
- **Nombre de la Carrera:** Ej. *Licenciatura en Tecnologías Informáticas* o *Tecnicatura Universitaria en Ciberseguridad*.
- **Código Institucional:** Ej. *LTI* o *TUC*.
- **Descripción:** Objetivos del plan de estudios.
4. **Guardar:** Presionar `Crear Carrera`. Las materias y comisiones quedarán agrupadas bajo esta carrera.
#### Paso 5: Crear Asignatura / Materia (Vinculada a la Carrera)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Asignaturas** (`/admin/subjects_list`).
2. **Acción:** Presionar el botón `+ Nueva Asignatura`.
3. **Completar Datos:**
- **Código de Materia:** Ej. *PROG-VANG-2026*.
- **Nombre de la Materia:** Ej. *Programación de Vanguardia*.
- **Carrera Vinculada:** Seleccionar obligatoriamente la Carrera creada en el Paso 4 (ej. *Licenciatura en Tecnologías Informáticas*).
- **Departamento / Créditos:** Indicar departamento y créditos académicos.
- **¿Es Curso Corto / Taller?:** Marcar si aplica para habilitar excepciones de cursada en el mismo día.
4. **Guardar:** Presionar `Crear Asignatura`.
#### Paso 6: Crear Comisión (Asociada a Materia, Carrera y Ciclo)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Comisiones** (`/admin/commissions_list`).
2. **Acción:** Presionar el botón `+ Nueva Comisión`.
3. **Completar Datos:**
- **Asignatura / Materia:** Seleccionar la Asignatura creada en el Paso 5 (el sistema muestra su carrera asociada).
- **Código de Comisión:** Ej. *Comisión A* o *K3001*.
- **Ciclo Lectivo:** Seleccionar el ciclo activo creado en el Paso 3.
- **Turno:** *Mañana* (08:00 - 12:00), *Tarde* (14:00 - 18:00) o *Noche / Vespertino* (18:30 - 22:30).
- **Docente Titular (Opcional en este paso):** Puede asignarse de inmediato o más tarde.
- **Cupo Máximo:** Cantidad estimada de matriculados (ej. *35*).
- **Enlace Virtual:** Enlace opcional de Google Meet, Zoom o Teams si cursará en modalidad remota o híbrida.
4. **Guardar:** Presionar `Crear y Asociar Comisión`. La comisión hereda la carrera y el plan de estudios.
#### Paso 7: Asociar Profesores (Equipo Docente / Co-docencia)
1. **Acceso:** En la lista de comisiones (`/admin/commissions_list`), hacer clic en la tuerca o nombre de la comisión para ingresar al **Detalle de Comisión** (`/admin/commission_detail?id=...`).
2. **Sección:** Localizar la tarjeta **"Equipo Docente / Cátedra"**.
3. **Acción:** Seleccionar al profesor en el desplegable de docentes, elegir su rol académico (*Titular*, *Adjunto*, *JTP*, *Ayudante*) y marcar si es el docente principal.
4. **Asignar:** Presionar `+ Vincular Docente`.
- *Nota de Co-docencia:* Si la comisión tiene múltiples docentes registrados, el sistema activará automáticamente la tolerancia de superposición horaria en la matriz de conflictos.
#### Paso 8: Asociar Alumnos (Matriculación de Estudiantes)
1. **Acceso:** Dentro de la misma vista de **Detalle de Comisión** (`/admin/commission_detail`), localizar la tarjeta **"Alumnos Matriculados"**.
2. **Acción:** Presionar `Inscribir Alumno` y seleccionar al estudiante registrado en el sistema.
3. **Validación Automática:** El sistema comprobará si el alumno ya cursa otra materia regular el mismo día.
- Si no hay conflicto: La matriculación se efectiviza inmediatamente.
- Si existe superposición de día: El sistema solicita autorización expresa de Bedelía activando el switch `Autorizar excepción de cursada en el mismo día` e ingresando el motivo institucional.
4. **Confirmar:** Presionar `Inscribir`.
#### Paso 9: Reserva de Espacios (Asignación de Aula y Horario)
Bedelía dispone de **3 modalidades complementarias** para efectuar la reserva según la conveniencia:
1. **Modalidad Rápida desde Comisiones:**
- En `/admin/commissions_list`, pulsar el botón con ícono de calendario `Asignar Aula` (`bi-calendar-plus`) en la fila de la comisión.
- El sistema redirige a `/schedule/add_reservation` precargando automáticamente la comisión, el cupo, la carrera y los datos de la materia.
- Seleccionar Edificio ➔ Piso ➔ Aula, día de la semana y franja horaria.
- Presionar `Confirmar Reserva`. La matriz de conflictos valida en tiempo real y confirma la reserva.
2. **Modalidad Interactiva (Drag & Drop en Calendario Semanal):**
- Ir a **Reservas / Calendario** (`/schedule/calendar`).
- En la barra lateral izquierda se muestran las *Comisiones Pendientes de Aula*.
- Arrastrar la tarjeta de la comisión directamente a la grilla horaria del aula deseada.
- El sistema valida instantáneamente; si no hay solapamiento ni choque de docentes, la reserva queda confirmada. Si hay colisión, revierte el movimiento y muestra una alerta clara en pantalla.
3. **Modalidad Automatizada con Inteligencia Artificial (Optimizador Genético):**
- Ir a **Optimizador de Aulas** (`/genetic-optimizer`).
- Seleccionar el ciclo lectivo y pulsar `Ejecutar Optimización`.
- El algoritmo heurístico evalúa millones de combinaciones, asignando las aulas de mayor capacidad a los grupos más numerosos y evitando todo solapamiento.
- Bedelía previsualiza el resultado y confirma la asignación masiva con 1 clic.
---
#### 📥 Ingesta Masiva desde Google Sheets / Planillas:
- Para no interrumpir la dinámica durante la transición, Bedelía puede usar la importación oficial desde Google Sheets:
- Ir a **Administración** ➔ **Configuración Global** (`/admin/settings`).
- Verificar la URL de la planilla oficial publicada.
- Ejecutar la sincronización masiva para poblar comisiones y horarios.
- *A partir de ese momento, toda modificación, reemplazo o ajuste se realiza exclusivamente en Edu-Space*, dejando la planilla congelada como copia de respaldo.
--- ---
### 1.2. Para el Cuerpo Docente (Profesores) ### 1.2. Para el Cuerpo Docente (Profesores)
1. **Consulta de Aulas Asignadas:** 1. **Consulta Inmediata de Aulas Asignadas:**
- Iniciar sesión con la cuenta docente. En el **Dashboard de Cátedra**, el profesor ve inmediatamente su agenda semanal: nombre de la materia, número de comisión, aula física asignada, piso y capacidad. - Iniciar sesión en la plataforma con cuenta institucional.
2. **Clases Virtuales e Híbridas (Google Meet):** - En el **Dashboard de Cátedra** (`/dashboard?role=docente`), el docente visualiza su agenda del día y de la semana:
- Para las materias con modalidad combinada, el sistema genera y exhibe el enlace directo de **Google Meet**. El docente puede iniciarlo con un solo clic sin necesidad de crear salas manualmente. - Nombre de la materia y número de comisión.
3. **Solicitud de Asistencia o Recursos:** - Aula física exacta asignada, piso y sede.
- Desde la ficha de su clase, el profesor puede reportar incidencias (ej: falta de marcadores, proyector averiado) notificando directamente al panel de Bedelía. - Cantidad de alumnos matriculados y equipamiento disponible.
2. **Clases Virtuales y Enlace a Google Meet:**
- Si la comisión es virtual o híbrida, el docente visualiza el botón destacado `Unirse a Clase Virtual (Meet)`.
- Con un solo clic se abre la sala de Google Meet oficial vinculada a la comisión.
3. **Libro de Calificaciones (*Gradebook*) y Actas de Notas:**
- Acceder al menú **Mis Materias** ➔ Seleccionar la comisión ➔ Pulsar `Libro de Calificaciones (Actas)`.
- Cargar las notas de exámenes parciales, recuperatorios y TPs en la grilla interactiva.
- El sistema realiza autoguardado asíncrono y calcula promedios y condición académica (*Promocionado*, *Regular*, *Libre*).
- Al finalizar el cuatrimestre, pulsar `Cerrar y Sellar Acta Oficial`. Se genera un identificador inmutable (`ACTA-2026-2C-XXXX`) registrado en auditoría.
4. **Solicitud de Asistencia o Incidencias:**
- Desde la ficha de la clase, el docente puede reportar cualquier falla edilicia (proyector averiado, aire acondicionado, falta de bancos) para que Bedelía actúe de inmediato.
--- ---
### 1.3. Para los Estudiantes (Alumnado) ### 1.3. Para los Estudiantes (Alumnado)
1. **Localización de Aula en Tiempo Real:** 1. **Brújula de Cursada "¿Dónde curso hoy?":**
- Desde cualquier smartphone o computadora, el alumno ingresa a `eduspace.oemspot.com.ar` y visualiza en su pantalla principal el aula de cursada del día, evitando aglomeraciones en los pasillos de entrada. - Desde su teléfono inteligente o computadora, el estudiante ingresa a `eduspace.oemspot.com.ar`.
2. **Calendario Académico y Fechas de Parciales:** - En la pantalla principal visualiza inmediatamente:
- El alumno consulta los días confirmados de exámenes parciales, recuperatorios y entregas de trabajos prácticos fijados por sus cátedras. - Aula exacta de cursada del día, piso y sede (ej. *Aula 203 - 2° Piso - Sede Central*).
3. **Cartelera de Avisos:** - Horario de inicio y fin de la clase.
- Acceso a novedades institucionales y eventuales traslados de aula notificados al instante. - Nombre de la materia y docente a cargo.
2. **Acceso a Clases Virtuales:**
- Si la clase del día es virtual, en lugar del aula física se despliega el botón `Ingresar a la Clase Virtual`.
3. **Calendario Académico y Próximos Exámenes:**
- Visualización de la cuenta regresiva para exámenes parciales, fechas de entrega de trabajos prácticos y recesos.
4. **Consulta de Notas y Certificados:**
- En la sección **Mis Calificaciones**, el alumno puede revisar sus notas de parciales, condición final y número de acta oficial sellada por el docente.
--- ---
## 2. Relevamiento y Cuestionario para Entrevista con Bedelía ## 2. Relevamiento Operativo y Adaptación Institucional
Para perfeccionar la aplicación y adaptarla de forma quirúrgica a las particularidades de UniCABA, se diseñó la siguiente guía de preguntas para entrevistar al equipo de Bedelía: Para asegurar una transición sin fricción desde el Excel hacia Edu-Space en UniCABA, se definen los siguientes criterios operativos:
### Bloque A: Dinámica y Cuellos de Botella Actuales ### Criterios Clave de Usabilidad para Bedelía:
1. *¿Cuál es el proceso exacto que utilizan hoy cuando se abre un nuevo cuatrimestre? ¿Cuánto tiempo les demanda asignar manualmente todas las aulas?* 1. **Intercambio Rápido de Aulas:** Permite permutar dos comisiones de aula en la misma franja horaria sin tener que desasignar y reasignar individualmente.
2. *¿Cuáles son los conflictos más frecuentes que ocurren durante las dos primeras semanas de clase? (Ej: grupos que superan la capacidad del aula, docentes que piden proyector sin aviso previo, ruidos molestos).* 2. **Semáforo Visual de Aforo:** Alertas de color (Verde: < 80% ocupación, Amarillo: 80-95%, Rojo: > 95% o exceso de capacidad).
3. *¿Cómo gestionan hoy los cambios de aula imprevistos? (¿Cartel de papel en la puerta, aviso por WhatsApp, grupos de delegados?)* 3. **Exportación Imprimible:** Generador de reportes de cartelera en formato apaisado para impresión en papel ante contingencias eléctricas o de red.
### Bloque B: Reglas de Negocio y Restricciones Específicas
4. *¿Existen docentes que por razones de movilidad reducida o edad deban tener asignadas aulas exclusivamente en Planta Baja o cerca de ascensores?*
5. *¿Hay cátedras que requieran software específico o laboratorios fijos que no puedan dictarse en aulas convencionales?*
6. *¿Qué margen de tolerancia de capacidad prefieren? (Ej: ¿Es aceptable ubicar a 30 alumnos en un aula de 32 bancos, o exigen un 15% de margen de seguridad libre?)*
### Bloque C: Integración con Sistemas Institucionales
7. *¿De qué sistema extraen la nómina de alumnos inscriptos? (¿SIU Guaraní, planillas CSV/Excel, sistema propio de la Ciudad de Buenos Aires?)*
8. *¿Qué formato de reporte o planilla deben entregar a Dirección Académica al cerrar la planificación?*
### Bloque D: Propuestas de Mejora Identificadas para Modificar en Edu-Space
* **Petición detectada:** Incorporación de un botón de "Intercambio Rápido de Aulas" entre dos comisiones simultáneas sin tener que desasignar y volver a asignar a ambas individualmente.
* **Petición detectada:** Alerta visual con código de colores cuando un aula física supere el 95% de aforo de seguridad.
* **Petición detectada:** Exportador directo en PDF imprimible con formato oficial apaisado para pegar en las carteleras de corcho tradicionales para aquellos alumnos sin batería en el móvil.
--- ---
## 3. Especificación: Módulo y Pestaña de Beneficios Universitarios ## 3. Especificación: Módulo de Beneficios Universitarios (Futuro)
- Pestaña para centralizar convenios estudiantiles (Librerías, Software estudiantil, Comedor universitario, Biblioteca digital).
### 3.1. Propósito y Justificación - Tarjetas con códigos de validación y mapa de canje.
Uno de los principales factores de permanencia y bienestar estudiantil es el acceso ágil a los convenios y beneficios que brinda la comunidad académica. La incorporación de la pestaña **Beneficios** dentro del ecosistema Edu-Space centraliza esta información en la misma plataforma donde el alumno consulta su vida académica diaria.
```
┌────────────────────────────────────────────────────────────────────────┐
│ PESTAÑA DE BENEFICIOS EDU-SPACE │
├──────────────────┬──────────────────┬─────────────────┬────────────────┤
│ 🏷️ COMERCIO │ 💻 LICENCIAS │ ☕ COMEDOR │ 📚 BIBLIOTECA │
│ Y LIBRERÍA │ DE SOFTWARE │ UNIVERSITARIO │ DIGITAL │
├──────────────────┼──────────────────┼─────────────────┼────────────────┤
│ 20% en fotocopias│ GitHub Student │ Menú estudiantil│ Préstamo de │
│ y apuntes con el │ Pack, JetBrains │ subsidiado con │ e-books y salas│
│ carnet digital. │ Pro y Office 365 │ reserva previa. │ de estudio. │
└──────────────────┴──────────────────┴─────────────────┴────────────────┘
```
### 3.2. Modelo de Datos Propuesto (Entidades)
* **Tabla `beneficio`:**
- `id`: Clave primaria autoincremental.
- `categoria`: Enum (`Librería`, `Gastronomía`, `Software/Tecnología`, `Salud/Deportes`, `Cultura`).
- `titulo`: Nombre del beneficio (ej: *Descuento 20% en Fotocopiadora Central*).
- `descripcion`: Condiciones de uso y letra chica.
- `validez_hasta`: Fecha límite de vigencia.
- `codigo_descuento`: Cupón alfanumérico o enlace de validación.
- `convenio_empresa`: Nombre del proveedor o área universitaria.
- `activo`: Booleano para activar/pausar la visualización.
### 3.3. Interfaz de Usuario (UI)
* Tarjetas dinámicas (*Cards*) con estética Glassmorphism, botón de "Copiar Código", botón de "Ver Mapa de Canje" y filtros por categoría.
--- ---
## 4. Innovación a Futuro: Credencial Digital con QR y Rol "Recepción" ## 4. Innovación a Futuro: Credencial Digital con QR y Rol "Recepción"
- Credencial QR inteligente con token dinámico TOTP (HMAC-SHA256) que cambia cada 30 segundos en la pantalla del alumno.
### 4.1. Arquitectura de Acceso Seguro mediante QR Dinámico - Rol de usuario `recepcion` en tablets de molinete para validar ingreso, registrar aforo edilicio en tiempo real y guiar al estudiante a su aula asignada.
Para modernizar el control de ingreso al edificio de UniCABA y erradicar las credenciales plásticas costosas y extraviables, se proyecta el módulo de **Credencial QR Inteligente**:
```
[ Pantalla Alumno (Edu-Space) ]
Generación de Token TOTP Cifrado (HMAC-SHA256)
(Cambia cada 30 segundos para evitar capturas de pantalla compartidas)
│
▼ Muestra Código QR en Pantalla
[ Puesto de Acceso / Molinete ]
│
▼ Escaneo con Cámara Web o Lector Óptico 2D
[ Tablet / Terminal Rol "Recepción" ]
- Valida firma criptográfica con la API
- Consulta estado del estudiante: ¿Alumno Regular Activo? ¿Tiene clase en esta sede hoy?
│
▼
✅ ACCESO PERMITIDO: Nombre, Foto, Carrera y Aula asignada ("Aula 104 - 1° Piso")
❌ ACCESO DENEGADO / ALERTA: Matrícula suspendida o no regular
```
### 4.2. Especificación del Nuevo Rol de Usuario: `recepcion`
* **Permisos del Rol:**
- Acceso restringido exclusivamente a la pantalla de escaneo (`/reception/scanner`) y al monitor de aforo edilicio en vivo (`/reception/headcount`).
- Imposibilidad de alterar notas, comisiones o configuraciones de Bedelía.
* **Beneficios de Seguridad Institucional:**
- **Control de Aforo en Tiempo Real:** El personal de portería y seguridad conoce en todo momento la cantidad exacta de personas dentro del edificio, dato crítico ante evacuaciones por siniestros.
- **Guía al Ingresante:** Al momento del escaneo, el sistema le muestra en pantalla al recepcionista a qué aula debe dirigirse el estudiante, permitiendo orientarlo amablemente en el momento del ingreso.
--- ---
## 5. Aplicación Móvil en Ionic (Capacitor) para Android e iOS ## 5. Aplicación Móvil Híbrida en Ionic (Capacitor)
- Envoltorio Capacitor multiplataforma para Android e iOS reutilizando la interfaz web responsiva de Edu-Space.
### 5.1. ¿Por Qué Ionic Framework + Capacitor? - Notificaciones Push institucionales ante traslados o cancelaciones de aula de último momento.
Para llevar Edu-Space a los dispositivos móviles de los estudiantes y profesores sin duplicar el costo de desarrollo en lenguajes nativos independientes (Kotlin/Swift), la elección óptima de ingeniería es **Ionic con Capacitor**: - Modo de consulta offline del cronograma semanal almacenado en caché interna del teléfono.
1. **Reutilización del Código y UI Web:** El diseño responsivo ya desarrollado en HTML5/CSS/JavaScript se compila directamente dentro de un contenedor webview de alto rendimiento nativo.
2. **Acceso a Hardware Nativo mediante Plugins Capacitor:**
- `@capacitor/camera`: Para que el personal de recepción o docentes escaneen códigos QR directamente con el lente del celular.
- `@capacitor/push-notifications`: Notificaciones Push en tiempo real emitidas por Firebase Cloud Messaging (FCM) ante avisos urgentes (ej: *"Tu clase de Algoritmos se trasladó al Aula 201"*).
- `@capacitor/preferences` / `@capacitor-community/sqlite`: Almacenamiento local para permitir al alumno consultar sus horarios sin consumir datos móviles o en zonas del edificio con baja señal de red.
### 5.2. Arquitectura de Distribución
```
┌──────────────────────────────────┐
│ Código Base Edu-Space Frontend │
└─────────────────┬────────────────┘
│
▼
┌──────────────────────────────────┐
│ Capacitor Bridge CLI │
└────────┬────────────────┬────────┘
│ │
┌───────────────▼──┐ ┌──▼────────────────┐
│ Proyecto Nativo│ │ Proyecto Nativo │
│ Android │ │ iOS │
│ (Gradle/APK) │ │ (Xcode/Archive) │
└───────┬──────────┘ └──┬────────────────┘
│ │
▼ ▼
Google Play Store Apple App Store
```
### 5.3. Fases de Implementación Móvil
* **Fase 1 (Empaquetado y Notificaciones):** Inicialización de Capacitor en el proyecto, configuración de iconos adaptativos y recepción de notificaciones Push de cambios de aula.
* **Fase 2 (Modo Desconectado / Offline):** Caché del cronograma semanal en almacenamiento interno del dispositivo para consulta sin internet.
* **Fase 3 (Publicación):** Firma digital de binarios (`.aab` para Android y `.ipa` para iOS) y subida a las consolas de Google Play y Apple Developer.
+22
View File
@@ -0,0 +1,22 @@
# Documentación Oficial — Admin Edu-Space (UniCABA)
Directorio central de especificaciones, arquitectura, manuales de usuario y seguridad.
---
## 🏛️ Documentos Rectores y Arquitectura
- **[constitution.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/constitution.md)**: Principios mandatorios e innegociables del sistema (SSD, flujo de 9 pasos, matriz de conflictos, testing, control de versiones semánticas y despliegue a producción con `.credenciales`).
- **[ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md)**: Arquitectura desacoplada (Backend Flask API RESTful + Frontend BFF Express/Nunjucks).
- **[DEPLOYMENT_AUDIT.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/DEPLOYMENT_AUDIT.md)**: Topología de contenedores LXC Proxmox (`10.0.0.217` y `10.0.0.207`), Nginx proxy inverso y configuración de producción.
## 📋 Manuales y Operatoria de Bedelía
- **[GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md)**: Manual del circuito secuencial de 9 pasos para el personal de Bedelía, guía de cátedra docente y estudiante.
- **[SCHEDULE_INTEGRATION_GUIDE.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/SCHEDULE_INTEGRATION_GUIDE.md)**: Guía técnica de la cartelera del día, calendario interactivo y gestión de asignaciones de aulas.
- **[GENETIC_ALGORITHM_README.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/GENETIC_ALGORITHM_README.md)**: Optimizador heurístico inteligente para asignación masiva de aulas y resolución de conflictos.
## 🔒 Seguridad e Informes Institucionales
- **[SECURITY_AUDIT_REPORT.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/SECURITY_AUDIT_REPORT.md)**: Reporte formal de auditoría de seguridad OWASP (SAST / SCA / DAST / Bitácora de Auditoría).
- **[REPORTE_CATEDRA_PROGRAMACION_DE_VANGUARDIA.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/REPORTE_CATEDRA_PROGRAMACION_DE_VANGUARDIA.md)**: Informe académico institucional sobre la materia de vanguardia tecnológica.
## 🗄️ Historial y Archivo
- **[archive/](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/archive/)**: Archivos históricos de sesiones anteriores, minutas de depuración de errores y versiones pasadas de changelogs.
+47
View File
@@ -0,0 +1,47 @@
# Constitución de admin-edu-space
Principios innegociables y mandatorios del Software System Design (SSD). Toda especificación, diseño, plan y tarea del agente debe cumplirlos estrictamente sin excepción.
---
### 1. La Especificación y el SSD Mandan
Nada se implementa, refactoriza o modifica en la plataforma si no está documentado en la especificación activa o alineado con el Software System Design (SSD). Si se detecta un caso de uso no previsto o una ambigüedad en los requerimientos, se detiene la ejecución y se consulta al responsable del proyecto antes de avanzar.
### 2. Arquitectura Desacoplada (Backend RESTful + Frontend BFF)
El sistema opera bajo una arquitectura desacoplada de dos capas:
- **Backend Core API (Python / Flask + SQLAlchemy)**: Expone exclusivamente servicios RESTful bajo el prefijo `/api/v1/`, retornando respuestas JSON estructuradas con serializadores/DTOs. Gestiona la autenticación stateless mediante tokens JWT (HS256), la integridad referencial en base de datos y el pipeline de blindaje `SecurityFilterChain`.
- **Frontend BFF (Node.js / Express + Nunjucks)**: Orquesta la presentación y la experiencia de usuario (UX), mantiene la sesión mediante cookies seguras `HttpOnly`, inyecta encabezados de autorización Bearer en llamadas Axios hacia el backend y adapta las vistas según el rol del usuario autenticado.
### 3. Reemplazo Definitivo del Excel como Herramienta Operativa
El objetivo primordial del sistema es erradicar el uso del archivo Excel/planilla como herramienta de gestión cotidiana de Bedelía, convirtiendo a la plataforma en la **única fuente de verdad** (Single Source of Truth) para la administración de espacios, comisiones y cursadas a través del ciclo estructurado de 9 pasos (Sedes -> Aulas -> Ciclos Lectivos -> Carreras -> Asignaturas -> Comisiones -> Profesores -> Alumnos -> Reservas). Toda asignatura debe pertenecer a su carrera y toda comisión hereda y expone esta pertenencia institucional para filtros y reportes académicos.
- La importación desde Google Sheets / planillas externas se mantiene exclusivamente como mecanismo de **ingesta masiva inicial y compatibilidad**, mientras que todas las altas, modificaciones, cancelaciones y reubicaciones deben realizarse directamente en la plataforma.
### 4. Matriz Infranqueable de Conflictos Académicos y Espaciales
La asignación de reservas de aulas debe validar en tiempo real e impedir de forma determinística:
1. **Conflicto Físico**: Doble asignación horaria en una misma aula presencial para el mismo día y bloque horario.
2. **Conflicto de Aforo**: Asignación de una comisión cuyo cupo estimado supere la capacidad física del aula.
3. **Conflicto Docente**: Superposición horaria de un profesor en múltiples espacios simultáneos, permitiendo excepción **únicamente** cuando la comisión cuenta con co-docencia activa registrada en `CommissionTeacher`.
4. **Restricción Diaria del Alumno**: Bloqueo de cursada de dos asignaturas regulares en el mismo día de la semana, exceptuando talleres/cursos cortos (`is_short_course`) o autorización expresa y justificada de Bedelía (`allow_same_day_exception`).
### 5. Caché First y Resiliencia en Servicios Externos (Moodle 4.1 & SMTP)
- Toda consulta de datos o perfiles provenientes de Moodle 4.1 debe consultar en primer término la capa de caché (`CacheService` en Redis o memoria).
- Toda operación de sincronización hacia Moodle debe encolarse de forma asíncrona no bloqueante (`MoodleSyncTask`) utilizando reintentos exponenciales (*Exponential Backoff*) y derivación a Dead Letter Queue (DLQ) ante indisponibilidad.
- Prohibidas las peticiones síncronas bloqueantes a servicios externos dentro de las transacciones de los controladores web.
- El servicio de correo transaccional (`EmailService`) debe utilizar credenciales dinámicas descifradas con Fernet sin impactar los tiempos de respuesta.
### 6. Privacidad Estricta, Blindaje RBAC y Trazabilidad
- Los datos de alumnos, docentes y credenciales de acceso son de máxima confidencialidad. Ningún endpoint debe exponer contraseñas, secretos o información privada a roles no autorizados.
- La autenticación institucional de Google Workspace debe validar estrictamente los dominios institucionales autorizados (`@unicaba.edu.ar`).
- Toda acción sensible (reseteo de sistema, impersonación de usuarios, reapertura/cierre de actas de notas) debe quedar registrada de forma inmutable en la tabla de auditoría (`AuditLog`).
### 7. Convenciones de Código e Idioma
- **Código Fuente**: Nombres de variables, clases, métodos, commits y pruebas en **inglés**.
- **Interfaz y Documentación**: Vistas, mensajes de error, respuestas al usuario, correos electrónicos y documentación operativa en **español**.
### 8. Testing Automatizado como Puerta de Enlace (Quality Gate)
- La suite de pruebas automatizadas (`pytest backend/tests`) y los controles de seguridad SAST/DAST/SCA (`security_audit.bat`) son mandatorios.
- Queda terminantemente prohibido cerrar una tarea o fusionar cambios a la rama de integración con pruebas fallando o vulnerabilidades críticas no remediadas.
### 9. Control de Versiones, Git Push y Despliegue Obligatorio a Servidor
- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py` y `CHANGELOG.md`).
- **Git Push Obligatorio**: Ejecutar siempre `git push origin dev` al repositorio remoto una vez que los tests automatizados (`pytest tests -v`) estén 100% aprobados.
- **Subida y Despliegue Inmediato al Servidor de Producción**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos y claves definidos en el archivo `.credenciales`, reiniciando los servicios del sistema (`systemctl restart admin-edu-space-backend admin-edu-space-frontend`) y verificando el estado operativo en vivo (HTTP 200 en `/version`) antes de dar cualquier tarea por concluida.
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "1.0.0", "version": "3.5.0",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+88 -82
View File
@@ -143,7 +143,7 @@ class GeneticAlgorithmManager {
const commissionIds = this.getSelectedCommissionIds(); const commissionIds = this.getSelectedCommissionIds();
if (commissionIds.length === 0) { if (commissionIds.length === 0) {
this.showAlert('Please select at least one commission to optimize.', 'warning'); this.showAlert('Por favor seleccione al menos una comisión para optimizar.', 'warning');
return; return;
} }
@@ -153,12 +153,12 @@ class GeneticAlgorithmManager {
if (result.success) { if (result.success) {
this.displayOptimizationResults(result.data); this.displayOptimizationResults(result.data);
this.showAlert('Optimization completed successfully!', 'success'); this.showAlert('¡Optimización de reservas completada con éxito!', 'success');
} else { } else {
this.showAlert('Optimization failed: ' + (result.error || 'Unknown error'), 'danger'); this.showAlert('Fallo en la optimización: ' + (result.error || 'Error desconocido'), 'danger');
} }
} catch (error) { } catch (error) {
this.showAlert('Error during optimization: ' + error.message, 'danger'); this.showAlert('Error durante la optimización: ' + error.message, 'danger');
} finally { } finally {
this.showLoading(false); this.showLoading(false);
} }
@@ -169,7 +169,7 @@ class GeneticAlgorithmManager {
const commissionIds = this.getSelectedCommissionIds(); const commissionIds = this.getSelectedCommissionIds();
if (commissionIds.length === 0) { if (commissionIds.length === 0) {
this.showAlert('Please select at least one commission to preview.', 'warning'); this.showAlert('Por favor seleccione al menos una comisión para previsualizar.', 'warning');
return; return;
} }
@@ -179,12 +179,12 @@ class GeneticAlgorithmManager {
if (result.success) { if (result.success) {
this.displayPreviewResults(result.data); this.displayPreviewResults(result.data);
this.showAlert('Preview generated successfully!', 'success'); this.showAlert('¡Previsualización generada con éxito!', 'success');
} else { } else {
this.showAlert('Preview failed: ' + (result.error || 'Unknown error'), 'danger'); this.showAlert('Fallo en la previsualización: ' + (result.error || 'Error desconocido'), 'danger');
} }
} catch (error) { } catch (error) {
this.showAlert('Error during preview: ' + error.message, 'danger'); this.showAlert('Error durante la previsualización: ' + error.message, 'danger');
} finally { } finally {
this.showLoading(false); this.showLoading(false);
} }
@@ -195,11 +195,11 @@ class GeneticAlgorithmManager {
const pendingReservations = this.getPendingReservations(); const pendingReservations = this.getPendingReservations();
if (!pendingReservations || pendingReservations.length === 0) { if (!pendingReservations || pendingReservations.length === 0) {
this.showAlert('No pending reservations to apply.', 'warning'); this.showAlert('No hay reservas optimizadas pendientes de aplicar.', 'warning');
return; return;
} }
if (!confirm('Are you sure you want to apply these reservations? This will create actual reservation records.')) { if (!confirm('¿Está seguro de que desea aplicar estas asignaciones optimizadas? Se crearán las reservas definitivas en el sistema.')) {
return; return;
} }
@@ -208,15 +208,15 @@ class GeneticAlgorithmManager {
const result = await this.applyOptimization(pendingReservations); const result = await this.applyOptimization(pendingReservations);
if (result.success) { if (result.success) {
this.showAlert(`Successfully applied ${result.data.applied_count} reservations!`, 'success'); this.showAlert(`¡Se aplicaron con éxito ${result.data.applied_count} reservas en Bedelía!`, 'success');
this.clearPendingReservations(); this.clearPendingReservations();
// Redirect to reservations page // Redirigir al listado de reservas
window.location.href = '/schedule'; window.location.href = '/schedule/list_reservations';
} else { } else {
this.showAlert('Failed to apply reservations: ' + (result.error || 'Unknown error'), 'danger'); this.showAlert('Fallo al aplicar reservas: ' + (result.error || 'Error desconocido'), 'danger');
} }
} catch (error) { } catch (error) {
this.showAlert('Error applying reservations: ' + error.message, 'danger'); this.showAlert('Error al aplicar reservas: ' + error.message, 'danger');
} finally { } finally {
this.showLoading(false); this.showLoading(false);
} }
@@ -252,47 +252,53 @@ class GeneticAlgorithmManager {
const scorePercentage = (data.fitness_score * 100).toFixed(1); const scorePercentage = (data.fitness_score * 100).toFixed(1);
resultsContainer.innerHTML = ` resultsContainer.innerHTML = `
<div class="card"> <div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-success text-white"> <div class="card-header bg-success text-white py-3">
<h5 class="mb-0">Optimization Results</h5> <h5 class="mb-0 h6 fw-bold"><i class="bi bi-check-circle-fill me-2"></i>Resultados de la Optimización</h5>
</div> </div>
<div class="card-body"> <div class="card-body p-4">
<div class="row mb-3"> <div class="row g-3 mb-4 text-center">
<div class="col-md-4"> <div class="col-md-4">
<div class="text-center"> <div class="p-3 rounded bg-primary bg-opacity-10 border border-primary-subtle">
<h4 class="text-primary">${data.assigned_reservations}</h4> <h3 class="fw-bold text-primary mb-1">${data.assigned_reservations}</h3>
<p class="mb-0">Reservations Assigned</p> <p class="mb-0 text-muted small fw-semibold">Reservas Asignadas</p>
</div> </div>
</div> </div>
<div class="col-md-4"> <div class="col-md-4">
<div class="text-center"> <div class="p-3 rounded bg-info bg-opacity-10 border border-info-subtle">
<h4 class="text-info">${scorePercentage}%</h4> <h3 class="fw-bold text-info mb-1">${scorePercentage}%</h3>
<p class="mb-0">Fitness Score</p> <p class="mb-0 text-muted small fw-semibold">Puntaje de Aptitud (Fitness)</p>
</div> </div>
</div> </div>
<div class="col-md-4"> <div class="col-md-4">
<div class="text-center"> <div class="p-3 rounded bg-warning bg-opacity-10 border border-warning-subtle">
<h4 class="text-warning">${data.total_requests}</h4> <h3 class="fw-bold text-warning mb-1">${data.total_requests}</h3>
<p class="mb-0">Total Requests</p> <p class="mb-0 text-muted small fw-semibold">Total de Solicitudes</p>
</div> </div>
</div> </div>
</div> </div>
${data.conflicts.length > 0 ? ` ${data.conflicts.length > 0 ? `
<div class="alert alert-warning"> <div class="alert alert-warning d-flex align-items-center">
<strong>Warning:</strong> ${data.conflicts.length} potential conflicts detected. <i class="bi bi-exclamation-triangle-fill fs-5 me-2"></i>
<div><strong>Atención:</strong> Se detectaron ${data.conflicts.length} conflictos potenciales no resueltos.</div>
</div> </div>
` : ''} ` : `
<div class="alert alert-success d-flex align-items-center">
<i class="bi bi-check-circle-fill fs-5 me-2"></i>
<div><strong>Excelente:</strong> ¡0 conflictos detectados! Todas las asignaciones cumplen aforo y disponibilidad.</div>
</div>
`}
<div class="d-flex gap-2"> <div class="d-flex gap-2 flex-wrap">
<button class="btn btn-primary" onclick="geneticManager.viewReservationDetails()"> <button class="btn btn-outline-primary" onclick="geneticManager.viewReservationDetails()">
View Details <i class="bi bi-eye me-1"></i>Ver Detalle de Reservas
</button> </button>
<button class="btn btn-success" onclick="geneticManager.handleApplyOptimization()"> <button class="btn btn-success fw-bold px-4" onclick="geneticManager.handleApplyOptimization()">
Apply Reservations <i class="bi bi-check-circle me-1"></i>Aplicar Reservas en Bedelía
</button> </button>
<button class="btn btn-secondary" onclick="geneticManager.clearResults()"> <button class="btn btn-outline-secondary" onclick="geneticManager.clearResults()">
Clear <i class="bi bi-trash me-1"></i>Limpiar
</button> </button>
</div> </div>
</div> </div>
@@ -306,30 +312,30 @@ class GeneticAlgorithmManager {
const commissionsHtml = data.commission_details.map(commission => ` const commissionsHtml = data.commission_details.map(commission => `
<tr> <tr>
<td>${commission.code}</td> <td class="font-monospace fw-bold text-primary">${commission.code}</td>
<td>${commission.name}</td> <td>${commission.name}</td>
<td>${commission.current_students}/${commission.max_students}</td> <td><span class="badge bg-secondary">${commission.current_students || 0}/${commission.max_students}</span></td>
</tr> </tr>
`).join(''); `).join('');
const optimization = data.optimization_result; const optimization = data.optimization_result;
previewContainer.innerHTML = ` previewContainer.innerHTML = `
<div class="card"> <div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-info text-white"> <div class="card-header bg-info text-white py-3">
<h5 class="mb-0">Optimization Preview</h5> <h5 class="mb-0 h6 fw-bold"><i class="bi bi-eye-fill me-2"></i>Previsualización de la Optimización</h5>
</div> </div>
<div class="card-body"> <div class="card-body p-4">
<div class="row mb-4"> <div class="row g-4 mb-4">
<div class="col-md-6"> <div class="col-md-7">
<h6>Commissions to Optimize</h6> <h6 class="fw-bold text-muted text-uppercase small mb-2">Comisiones a Optimizar</h6>
<div class="table-responsive"> <div class="table-responsive border rounded">
<table class="table table-sm"> <table class="table table-hover table-sm mb-0">
<thead> <thead class="table-light">
<tr> <tr>
<th>Code</th> <th>Código</th>
<th>Name</th> <th>Asignatura</th>
<th>Students</th> <th>Estudiantes</th>
</tr> </tr>
</thead> </thead>
<tbody> <tbody>
@@ -338,20 +344,20 @@ class GeneticAlgorithmManager {
</table> </table>
</div> </div>
</div> </div>
<div class="col-md-6"> <div class="col-md-5">
<h6>Expected Results</h6> <h6 class="fw-bold text-muted text-uppercase small mb-2">Resultados Estimados</h6>
<ul class="list-group"> <ul class="list-group shadow-sm">
<li class="list-group-item d-flex justify-content-between"> <li class="list-group-item d-flex justify-content-between align-items-center py-2">
<span>Reservations Created:</span> <span>Reservas Creadas:</span>
<strong>${optimization.assigned_reservations}</strong> <strong class="text-primary font-monospace fs-6">${optimization.assigned_reservations}</strong>
</li> </li>
<li class="list-group-item d-flex justify-content-between"> <li class="list-group-item d-flex justify-content-between align-items-center py-2">
<span>Fitness Score:</span> <span>Puntaje de Aptitud:</span>
<strong>${(optimization.fitness_score * 100).toFixed(1)}%</strong> <strong class="text-info font-monospace fs-6">${(optimization.fitness_score * 100).toFixed(1)}%</strong>
</li> </li>
<li class="list-group-item d-flex justify-content-between"> <li class="list-group-item d-flex justify-content-between align-items-center py-2">
<span>Conflicts:</span> <span>Conflictos:</span>
<strong class="${optimization.conflicts.length > 0 ? 'text-danger' : 'text-success'}"> <strong class="font-monospace fs-6 ${optimization.conflicts.length > 0 ? 'text-danger' : 'text-success'}">
${optimization.conflicts.length} ${optimization.conflicts.length}
</strong> </strong>
</li> </li>
@@ -361,10 +367,10 @@ class GeneticAlgorithmManager {
<div class="d-flex gap-2"> <div class="d-flex gap-2">
<button class="btn btn-primary" onclick="geneticManager.handleOptimizeReservations()"> <button class="btn btn-primary" onclick="geneticManager.handleOptimizeReservations()">
Run Full Optimization <i class="bi bi-play-circle me-1"></i>Ejecutar Optimización Completa
</button> </button>
<button class="btn btn-secondary" onclick="geneticManager.clearPreview()"> <button class="btn btn-outline-secondary" onclick="geneticManager.clearPreview()">
Close Preview <i class="bi bi-x-circle me-1"></i>Cerrar Previsualización
</button> </button>
</div> </div>
</div> </div>
@@ -375,7 +381,7 @@ class GeneticAlgorithmManager {
viewReservationDetails() { viewReservationDetails() {
const reservations = this.getPendingReservations(); const reservations = this.getPendingReservations();
if (!reservations || reservations.length === 0) { if (!reservations || reservations.length === 0) {
this.showAlert('No reservation details available.', 'info'); this.showAlert('No hay detalles de reserva disponibles.', 'info');
return; return;
} }
@@ -383,11 +389,11 @@ class GeneticAlgorithmManager {
const detailsHtml = reservations.map((res, index) => ` const detailsHtml = reservations.map((res, index) => `
<tr> <tr>
<td>${index + 1}</td> <td>${index + 1}</td>
<td>${res.purpose}</td> <td>${res.purpose || 'Cursada Académica'}</td>
<td>Classroom ${res.classroom_id}</td> <td><span class="badge bg-primary">Aula ID ${res.classroom_id}</span></td>
<td>${new Date(res.start_time).toLocaleString()}</td> <td class="small font-monospace">${new Date(res.start_time).toLocaleString('es-AR')}</td>
<td>${new Date(res.end_time).toLocaleString()}</td> <td class="small font-monospace">${new Date(res.end_time).toLocaleString('es-AR')}</td>
<td>${res.expected_attendees}</td> <td><span class="badge bg-secondary">${res.expected_attendees || 0}</span></td>
</tr> </tr>
`).join(''); `).join('');
@@ -395,15 +401,15 @@ class GeneticAlgorithmManager {
if (modal) { if (modal) {
modal.querySelector('.modal-body').innerHTML = ` modal.querySelector('.modal-body').innerHTML = `
<div class="table-responsive"> <div class="table-responsive">
<table class="table"> <table class="table table-hover table-sm">
<thead> <thead class="table-light">
<tr> <tr>
<th>#</th> <th>#</th>
<th>Purpose</th> <th>Propósito</th>
<th>Classroom</th> <th>Aula Asignada</th>
<th>Start Time</th> <th>Inicio</th>
<th>End Time</th> <th>Fin</th>
<th>Attendees</th> <th>Asistentes</th>
</tr> </tr>
</thead> </thead>
<tbody> <tbody>
+287 -28
View File
@@ -68,9 +68,9 @@ app.post('/auth/login', authLimiter);
app.post('/auth/moodle', authLimiter); app.post('/auth/moodle', authLimiter);
app.use('/api', generalLimiter); app.use('/api', generalLimiter);
// Configuración de middlewares // Configuración de middlewares con soporte para importaciones masivas y payloads extensos
app.use(express.json()); app.use(express.json({ limit: '50mb' }));
app.use(express.urlencoded({ extended: true })); app.use(express.urlencoded({ extended: true, limit: '50mb' }));
app.use(cookieParser()); app.use(cookieParser());
// Configuración de archivos estáticos // Configuración de archivos estáticos
@@ -84,6 +84,15 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
watch: process.env.NODE_ENV !== 'production' watch: process.env.NODE_ENV !== 'production'
}); });
// Versiones institucionales del sistema
const APP_VERSION = '3.5.0';
const FRONTEND_VERSION = '3.5.0';
const BACKEND_VERSION = '3.5.0';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
env.addGlobal('backend_version', BACKEND_VERSION);
// Nunjucks custom filters/helpers // Nunjucks custom filters/helpers
env.addFilter('get', function(obj, key, defaultVal) { env.addFilter('get', function(obj, key, defaultVal) {
if (!obj) return defaultVal; if (!obj) return defaultVal;
@@ -120,20 +129,73 @@ env.addFilter('format', function(str, ...args) {
const formatDateHelper = function(d, fmt) { const formatDateHelper = function(d, fmt) {
if (!d) return ''; if (!d) return '';
if (typeof d === 'string') return d.split('T')[0]; let str = String(d);
return new Date(d).toISOString().split('T')[0]; let datePart = str.includes('T') ? str.split('T')[0] : (str.includes(' ') ? str.split(' ')[0] : str);
if (datePart.match(/^\d{4}-\d{2}-\d{2}$/)) {
const [y, m, day] = datePart.split('-');
const year = parseInt(y, 10);
const month = parseInt(m, 10);
const dayNum = parseInt(day, 10);
const dObj = new Date(year, month - 1, dayNum);
const daysNames = ['Domingo', 'Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado'];
const monthsNames = ['Enero', 'Febrero', 'Marzo', 'Abril', 'Mayo', 'Junio', 'Julio', 'Agosto', 'Septiembre', 'Octubre', 'Noviembre', 'Diciembre'];
const dayName = daysNames[dObj.getDay()] || '';
const monthName = monthsNames[month - 1] || '';
const dayPad = String(dayNum).padStart(2, '0');
const monthPad = String(month).padStart(2, '0');
if (fmt === 'long' || fmt === 'human') {
return `${dayName} ${dayPad}/${monthPad}/${year}`;
}
if (fmt === 'full') {
return `${dayName}, ${dayPad} de ${monthName} de ${year}`;
}
return `${dayPad}/${monthPad}/${year}`;
}
return datePart;
}; };
const formatDateTimeHelper = function(d, fmt) { const formatDateTimeHelper = function(d, fmt) {
if (!d) return ''; if (!d) return '';
if (typeof d === 'string') return d.replace('T', ' ').substring(0, 16); let str = String(d);
return new Date(d).toLocaleString(); let datePart = formatDateHelper(str);
let timePart = '';
if (str.includes('T')) {
timePart = str.split('T')[1].substring(0, 5) + ' hs';
} else if (str.includes(' ')) {
timePart = str.split(' ')[1].substring(0, 5) + ' hs';
}
return timePart ? `${datePart} ${timePart}` : datePart;
};
const formatTimeCleanHelper = function(d) {
if (!d) return '';
let str = String(d);
if (str.includes('T')) return str.split('T')[1].substring(0, 5) + ' hs';
if (str.includes(' ')) return str.split(' ')[1].substring(0, 5) + ' hs';
if (str.match(/^\d{2}:\d{2}/)) return str.substring(0, 5) + ' hs';
return str;
};
const formatTimeRangeHelper = function(start, end) {
if (!start) return '';
let s = String(start);
let e = String(end || '');
let st = s.includes('T') ? s.split('T')[1].substring(0, 5) : (s.includes(' ') ? s.split(' ')[1].substring(0, 5) : s.substring(0, 5));
let et = e.includes('T') ? e.split('T')[1].substring(0, 5) : (e.includes(' ') ? e.split(' ')[1].substring(0, 5) : e.substring(0, 5));
return et ? `${st} - ${et} hs` : `${st} hs`;
}; };
env.addGlobal('format_date', formatDateHelper); env.addGlobal('format_date', formatDateHelper);
env.addGlobal('format_datetime', formatDateTimeHelper); env.addGlobal('format_datetime', formatDateTimeHelper);
env.addGlobal('format_time', formatTimeCleanHelper);
env.addGlobal('format_time_range', formatTimeRangeHelper);
env.addFilter('format_date', formatDateHelper); env.addFilter('format_date', formatDateHelper);
env.addFilter('format_datetime', formatDateTimeHelper); env.addFilter('format_datetime', formatDateTimeHelper);
env.addFilter('format_date_human', function(d) { return formatDateHelper(d, 'human'); });
env.addFilter('format_time', formatTimeCleanHelper);
env.addFilter('format_time_range', formatTimeRangeHelper);
env.addFilter('tojson', function(val) { env.addFilter('tojson', function(val) {
return JSON.stringify(val !== undefined ? val : null); return JSON.stringify(val !== undefined ? val : null);
@@ -222,9 +284,22 @@ app.use((req, res, next) => {
res.locals.impersonated_user = impersonatedUser; res.locals.impersonated_user = impersonatedUser;
res.locals.session = { get: (k, d) => d }; res.locals.session = { get: (k, d) => d };
res.locals.occupancy_metrics = { get: (k, d) => d }; res.locals.occupancy_metrics = { get: (k, d) => d };
res.locals.app_version = APP_VERSION;
res.locals.frontend_version = FRONTEND_VERSION;
res.locals.backend_version = BACKEND_VERSION;
next(); next();
}); });
// Endpoint público de verificación de versiones
app.get('/version', (req, res) => {
res.json({
app: APP_VERSION,
frontend: FRONTEND_VERSION,
backend: BACKEND_VERSION,
status: 'ok'
});
});
// Rutas Principales // Rutas Principales
const indexRoutes = require('./routes/index'); const indexRoutes = require('./routes/index');
const authRoutes = require('./routes/auth'); const authRoutes = require('./routes/auth');
@@ -277,16 +352,22 @@ app.get(['/main/dashboard', '/main'], (req, res) => {
res.redirect('/dashboard' + query); res.redirect('/dashboard' + query);
}); });
const { requireAuth } = require('./middlewares/authMiddleware');
// Módulo Predictivo y Optimizador // Módulo Predictivo y Optimizador
app.get('/predictive', (req, res) => { app.get('/predictive', requireAuth, (req, res) => {
res.render('predictive/index', { res.render('predictive/index', {
title: 'Dashboard Predictivo - Edu-Space Admin' title: 'Dashboard Predictivo - Edu-Space Admin',
user: req.user,
user_role: (req.user?.role || 'admin').toLowerCase()
}); });
}); });
app.get(['/genetic_optimizer', '/genetic_algorithm_web/genetic_optimizer'], (req, res) => { app.get(['/genetic_optimizer', '/genetic_algorithm_web/genetic_optimizer'], requireAuth, (req, res) => {
res.render('genetic_optimizer', { res.render('genetic_optimizer', {
title: 'Optimizador de Aulas (IA) - Edu-Space Admin' title: 'Optimizador de Aulas (IA) - Edu-Space Admin',
user: req.user,
user_role: (req.user?.role || 'admin').toLowerCase()
}); });
}); });
@@ -506,37 +587,215 @@ app.use((req, res) => {
`); `);
}); });
// Middleware Global de Error 500 // Middleware Global de Error 500 & Diagnóstico Institucional
app.use((err, req, res, next) => { app.use(async (err, req, res, next) => {
console.error('Error no capturado en BFF:', err); const incidentId = 'INC-' + new Date().toISOString().slice(0, 10).replace(/-/g, '') + '-' + Math.random().toString(36).substring(2, 7).toUpperCase();
res.status(500).send(` const timestampStr = new Date().toLocaleString('es-AR', { timeZone: 'America/Argentina/Buenos_Aires' });
const userEmail = req.user?.email || (req.cookies?.refresh_token ? 'Usuario con sesión activa' : 'No autenticado');
const reqPath = `${req.method} ${req.originalUrl || req.url}`;
const clientIp = req.headers['x-forwarded-for'] || req.ip || req.socket?.remoteAddress || '-';
console.error(`[BFF Error ${incidentId}] en ${reqPath}:`, err);
// Clasificación y mensaje amigable
let statusCode = err.status || err.statusCode || 500;
let errorTitle = 'Eventualidad en la Aplicación';
let errorSummary = 'Ocurrió un error inesperado al procesar la operación solicitada.';
let errorResolution = 'Por favor intente nuevamente o comuníquese con Soporte / Bedelía indicando el código de incidente.';
if (err.type === 'entity.too.large' || statusCode === 413) {
statusCode = 413;
errorTitle = 'Tamaño de Datos Excedido (Payload Too Large)';
const lengthKb = err.length ? (err.length / 1024).toFixed(1) + ' KB' : 'desconocido';
const limitKb = err.limit ? (err.limit / 1024).toFixed(1) + ' KB' : 'desconocido';
errorSummary = `El volumen de datos enviado (${lengthKb}) superó la capacidad de recepción configurada (${limitKb}).`;
errorResolution = 'Si está importando planillas masivas de Google Sheets, aplique filtros por día o carrera, o solicite a Soporte que amplíe el límite de transferencia.';
} else if (err.code === 'ECONNREFUSED' || err.code === 'ETIMEDOUT') {
statusCode = 503;
errorTitle = 'Fallo de Comunicación con Backend Core';
errorSummary = 'No fue posible conectarse con la API central de Edu-Space en el puerto 5000.';
errorResolution = 'El servicio backend podría estar reiniciándose o en mantenimiento. Aguarde unos segundos y vuelva a intentar.';
} else if (err.response && err.response.data) {
errorTitle = `Respuesta del Servidor Central (${err.response.status})`;
errorSummary = err.response.data.message || err.response.data.error || err.message;
errorResolution = 'Revise los parámetros ingresados o consulte el registro de auditoría si posee permisos de administrador.';
} else if (err.message) {
errorSummary = err.message;
}
// Registro asíncrono no bloqueante en AuditLog del backend
try {
const backendBase = process.env.BACKEND_URL || 'http://localhost:5000/api/v1';
axios.post(`${backendBase}/admin/log-error`, {
incident_id: incidentId,
error_title: errorTitle,
error_message: err.message || errorSummary,
status_code: statusCode,
path: reqPath,
user_email: userEmail,
ip_address: clientIp,
stack: err.stack ? err.stack.slice(0, 1000) : null
}, { timeout: 3000 }).catch(() => {});
} catch (_) {}
// Si la petición espera JSON, responder en JSON estructurado
if (req.xhr || (req.headers.accept && req.headers.accept.includes('application/json'))) {
return res.status(statusCode).json({
status: 'error',
incident_id: incidentId,
title: errorTitle,
message: errorSummary,
resolution: errorResolution,
path: reqPath,
timestamp: timestampStr
});
}
// Renderizar pantalla institucional de diagnóstico
res.status(statusCode).send(`
<!DOCTYPE html> <!DOCTYPE html>
<html lang="es"> <html lang="es">
<head> <head>
<meta charset="UTF-8"> <meta charset="UTF-8">
<title>Error del Sistema — Edu-Space</title> <meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Error del Sistema — Edu-Space UniCABA</title>
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet"> <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css">
<style> <style>
body { background: #0f172a; color: #f8fafc; font-family: system-ui, -apple-system, sans-serif; min-height: 100vh; display: flex; align-items: center; justify-content: center; margin: 0; } :root { --bs-body-bg: #0f172a; --bs-body-color: #f8fafc; }
.card-error { background: #1e293b; border: 1px solid #334155; border-radius: 16px; box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.5); } body { background: #0f172a; color: #f8fafc; font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif; min-height: 100vh; display: flex; align-items: center; justify-content: center; padding: 1.5rem; }
.card-diagnostic { background: #1e293b; border: 1px solid #334155; border-radius: 16px; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.7); max-width: 760px; width: 100%; }
.code-box { background: #0b1120; border: 1px solid #334155; color: #38bdf8; border-radius: 8px; font-family: monospace; font-size: 0.85rem; }
.incident-badge { background: #3b82f6; color: white; letter-spacing: 0.05em; font-family: monospace; }
.accordion-button { background: #1e293b; color: #94a3b8; }
.accordion-button:not(.collapsed) { background: #0f172a; color: #f8fafc; }
.accordion-item { border-color: #334155; background: transparent; }
</style> </style>
</head> </head>
<body> <body>
<div class="container text-center p-4" style="max-width: 520px;"> <div class="card card-diagnostic p-4 p-md-5">
<div class="card card-error p-4 p-md-5"> <!-- Header con branding institucional -->
<div class="mb-3 text-danger"> <div class="d-flex align-items-center justify-content-between border-bottom border-secondary pb-3 mb-4 flex-wrap gap-2">
<i class="bi bi-exclamation-triangle-fill fs-1"></i> <div class="d-flex align-items-center gap-2">
<span class="fs-4 fw-bold text-primary">Edu-Space</span>
<span class="badge bg-secondary-subtle text-secondary border border-secondary font-monospace">UniCABA</span>
</div> </div>
<h1 class="h3 fw-bold mb-2">Error en la Aplicación</h1> <div>
<p class="text-secondary small mb-4"> <span class="badge incident-badge px-3 py-2 rounded-pill fs-6" id="badgeIncidentId">
Ocurrió una eventualidad procesando la solicitud. Nuestro equipo técnico ha sido notificado. <i class="bi bi-ticket-perforated me-1"></i>${incidentId}
</span>
</div>
</div>
<!-- Título y síntesis del incidente -->
<div class="text-center mb-4">
<div class="mb-3">
<span class="d-inline-flex align-items-center justify-content-center rounded-circle bg-danger-subtle text-danger p-3" style="width: 64px; height: 64px;">
<i class="bi bi-exclamation-triangle-fill fs-2"></i>
</span>
</div>
<div class="d-flex align-items-center justify-content-center gap-2 mb-2">
<span class="badge bg-danger">HTTP ${statusCode}</span>
<h1 class="h4 fw-bold mb-0 text-white">${errorTitle}</h1>
</div>
<p class="text-light fs-6 mb-2 text-start bg-dark p-3 rounded border border-secondary-subtle">
<i class="bi bi-info-circle text-info me-2"></i>${errorSummary}
</p> </p>
<a href="/dashboard" class="btn btn-primary px-4 fw-semibold"> <p class="text-secondary small mb-0 text-start">
<i class="bi bi-house-door me-1"></i>Volver al Panel <strong>Acción recomendada:</strong> ${errorResolution}
</a> </p>
</div>
<!-- Sección colapsable de Diagnóstico Técnico -->
<div class="accordion mb-4" id="diagnosticAccordion">
<div class="accordion-item rounded overflow-hidden">
<h2 class="accordion-header" id="headingOne">
<button class="accordion-button collapsed py-2 small fw-semibold" type="button" data-bs-toggle="collapse" data-bs-target="#collapseDiag" aria-expanded="false" aria-controls="collapseDiag">
<i class="bi bi-cpu me-2"></i>Detalles Técnicos y Diagnóstico del Servidor
</button>
</h2>
<div id="collapseDiag" class="accordion-collapse collapse" aria-labelledby="headingOne" data-bs-parent="#diagnosticAccordion">
<div class="accordion-body p-3 bg-dark">
<div class="row g-2 small mb-3">
<div class="col-sm-6">
<span class="text-secondary">Ruta / Solicitud:</span>
<div class="font-monospace text-light">${reqPath}</div>
</div>
<div class="col-sm-6">
<span class="text-secondary">Fecha y Hora:</span>
<div class="font-monospace text-light">${timestampStr}</div>
</div>
<div class="col-sm-6">
<span class="text-secondary">Usuario Actuante:</span>
<div class="font-monospace text-light">${userEmail}</div>
</div>
<div class="col-sm-6">
<span class="text-secondary">Dirección IP:</span>
<div class="font-monospace text-light">${clientIp}</div>
</div>
</div>
<label class="text-secondary small fw-bold mb-1">Traza de Error (Stack Trace):</label>
<pre class="code-box p-3 mb-0" style="max-height: 180px; overflow-y: auto;">${(err.stack || err.message || 'Sin traza disponible').replace(/</g, '&lt;').replace(/>/g, '&gt;')}</pre>
</div>
</div>
</div>
</div>
<!-- Acciones Rápidas y Copia de Reporte -->
<div class="d-flex flex-wrap gap-2 justify-content-between align-items-center pt-2 border-top border-secondary">
<div class="d-flex gap-2 flex-wrap">
<button type="button" class="btn btn-outline-info btn-sm fw-semibold" onclick="copyDiagnosticReport()">
<i class="bi bi-clipboard-check me-1"></i>Copiar Reporte para Soporte
</button>
<a href="/admin/audit_logs" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-shield-check me-1"></i>Ver Auditoría
</a>
</div>
<div class="d-flex gap-2">
<button type="button" class="btn btn-secondary btn-sm" onclick="history.back()">
<i class="bi bi-arrow-left me-1"></i>Atrás
</button>
<button type="button" class="btn btn-outline-light btn-sm" onclick="location.reload()">
<i class="bi bi-arrow-clockwise me-1"></i>Reintentar
</button>
<a href="/dashboard" class="btn btn-primary btn-sm fw-semibold">
<i class="bi bi-house-door me-1"></i>Panel Principal
</a>
</div>
</div> </div>
</div> </div>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
<script>
function copyDiagnosticReport() {
const report = [
'=== REPORTE DE INCIDENTE EDU-SPACE (UniCABA) ===',
'Código: ' + '${incidentId}',
'Fecha/Hora: ' + '${timestampStr}',
'Estado HTTP: ' + '${statusCode}',
'Título: ' + '${errorTitle}',
'Resumen: ' + '${errorSummary.replace(/'/g, "\\'")}',
'Ruta Solicitada: ' + '${reqPath}',
'Usuario: ' + '${userEmail}',
'IP Cliente: ' + '${clientIp}',
'Error Stack:',
'${(err.stack || err.message || '').replace(/'/g, "\\'").replace(/\n/g, '\\n')}',
'=================================================='
].join('\\n');
navigator.clipboard.writeText(report).then(() => {
alert('Reporte copiado al portapapeles. Puede pegarlo y enviarlo al equipo de Soporte IT o Bedelía.');
}).catch(() => {
const ta = document.createElement('textarea');
ta.value = report;
document.body.appendChild(ta);
ta.select();
document.execCommand('copy');
document.body.removeChild(ta);
alert('Reporte copiado al portapapeles.');
});
}
</script>
</body> </body>
</html> </html>
`); `);
+9 -5
View File
@@ -44,18 +44,22 @@ const buildUserSession = (decoded) => {
has_permission: (module, action) => { has_permission: (module, action) => {
if (isAdmin) return true; if (isAdmin) return true;
if (isBedelia) { if (isBedelia) {
if (module === 'reservations' || module === 'classrooms' || module === 'schedule') return true; if ([
if (module === 'academic' && action === 'read') return true; 'reservations', 'classrooms', 'schedule', 'academic',
'enrollment', 'subjects', 'careers', 'commissions',
'buildings', 'import', 'milestone_types', 'metrics'
].includes(module)) return true;
} }
if (isDocente) { if (isDocente) {
if (module === 'my_subjects' || module === 'academic') return true; if (['my_subjects', 'academic', 'gradebook'].includes(module)) return true;
if (module === 'reservations' && action === 'read') return true; if ((module === 'reservations' || module === 'schedule') && action === 'read') return true;
} }
if (isAlumno) { if (isAlumno) {
if (module === 'my_subjects' && action === 'read') return true; if (['my_subjects', 'schedule', 'grades'].includes(module)) return true;
} }
return false; return false;
}, },
can_manage_academic: () => canManage,
can_edit_reservation: (res) => { can_edit_reservation: (res) => {
if (isAdmin || isBedelia) return true; if (isAdmin || isBedelia) return true;
if (isDocente && res && (res.user_id === decoded?.sub || res.user?.id === decoded?.sub)) return true; if (isDocente && res && (res.user_id === decoded?.sub || res.user?.id === decoded?.sub)) return true;
+167 -32
View File
@@ -22,6 +22,8 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => {
let totalSubjects = 0; let totalSubjects = 0;
let totalCommissions = 0; let totalCommissions = 0;
let recentSubjects = []; let recentSubjects = [];
let availableCareers = [];
let availableSubjects = [];
let sheetsConfig = { let sheetsConfig = {
active_url: 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv', active_url: 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv',
default_url: 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv', default_url: 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv',
@@ -45,12 +47,13 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => {
totalReservations = resRes.value.data.reservations.length; totalReservations = resRes.value.data.reservations.length;
} }
if (carRes.status === 'fulfilled' && carRes.value.data?.careers) { if (carRes.status === 'fulfilled' && carRes.value.data?.careers) {
totalCareers = carRes.value.data.careers.length; availableCareers = carRes.value.data.careers;
totalCareers = availableCareers.length;
} }
if (subjRes.status === 'fulfilled' && subjRes.value.data?.subjects) { if (subjRes.status === 'fulfilled' && subjRes.value.data?.subjects) {
const subjs = subjRes.value.data.subjects; availableSubjects = subjRes.value.data.subjects;
totalSubjects = subjs.length; totalSubjects = availableSubjects.length;
recentSubjects = subjs.slice(0, 15); recentSubjects = availableSubjects.slice(0, 15);
} }
if (commRes.status === 'fulfilled' && commRes.value.data?.commissions) { if (commRes.status === 'fulfilled' && commRes.value.data?.commissions) {
totalCommissions = commRes.value.data.commissions.length; totalCommissions = commRes.value.data.commissions.length;
@@ -83,8 +86,33 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => {
if (justSynced) { if (justSynced) {
try { try {
const syncPayload = {}; const syncPayload = {};
if (req.body && req.body.sheets_url) { if (req.body) {
syncPayload.sheets_url = req.body.sheets_url; if (req.body.sheets_url) syncPayload.sheets_url = req.body.sheets_url;
if (req.body.filter_career) syncPayload.filter_career = req.body.filter_career.trim();
if (req.body.filter_subject) syncPayload.filter_subject = req.body.filter_subject.trim();
if (req.body.filter_day) syncPayload.filter_day = req.body.filter_day.trim();
if (req.body.filter_days) {
syncPayload.filter_days = Array.isArray(req.body.filter_days) ? req.body.filter_days : [req.body.filter_days];
}
if (req.body.manual_date) syncPayload.manual_date = req.body.manual_date.trim();
if (req.body.single_date_only === 'true' || req.body.single_date_only === true || req.body.single_date_only === 'on') {
syncPayload.single_date_only = true;
}
// 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';
syncPayload.import_commissions = req.body.import_commissions === 'true' || req.body.import_commissions === true || req.body.import_commissions === 'on';
syncPayload.import_classrooms = req.body.import_classrooms === 'true' || req.body.import_classrooms === true || req.body.import_classrooms === 'on';
syncPayload.import_reservations = req.body.import_reservations === 'true' || req.body.import_reservations === true || req.body.import_reservations === 'on';
// Filas preseleccionadas desde la grilla interactiva
if (req.body.selected_rows_json) {
try {
syncPayload.selected_rows = JSON.parse(req.body.selected_rows_json);
} catch (e) {
console.warn('Could not parse selected_rows_json:', e.message);
}
}
} }
const syncRes = await req.apiClient.post('/dashboard/sync-sheets', syncPayload, { timeout: 90000 }); const syncRes = await req.apiClient.post('/dashboard/sync-sheets', syncPayload, { timeout: 90000 });
if (syncRes.data && syncRes.data.stats) { if (syncRes.data && syncRes.data.stats) {
@@ -101,13 +129,17 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => {
]); ]);
if (cR.status === 'fulfilled') metrics.total_classrooms = cR.value.data?.classrooms?.length || 0; if (cR.status === 'fulfilled') metrics.total_classrooms = cR.value.data?.classrooms?.length || 0;
if (rR.status === 'fulfilled') metrics.total_reservations = rR.value.data?.reservations?.length || 0; if (rR.status === 'fulfilled') metrics.total_reservations = rR.value.data?.reservations?.length || 0;
if (crR.status === 'fulfilled') metrics.total_careers = crR.value.data?.careers?.length || 0; if (crR.status === 'fulfilled') {
availableCareers = crR.value.data?.careers || [];
metrics.total_careers = availableCareers.length;
}
if (sR.status === 'fulfilled') { if (sR.status === 'fulfilled') {
metrics.total_subjects = sR.value.data?.subjects?.length || 0; availableSubjects = sR.value.data?.subjects || [];
recentSubjects = (sR.value.data?.subjects || []).slice(0, 15); metrics.total_subjects = availableSubjects.length;
recentSubjects = availableSubjects.slice(0, 15);
} }
if (cmR.status === 'fulfilled') metrics.total_commissions = cmR.value.data?.commissions?.length || 0; if (cmR.status === 'fulfilled') metrics.total_commissions = cmR.value.data?.commissions?.length || 0;
} catch (e) {} } catch (e) { }
} catch (err) { } catch (err) {
console.error('Backend sync-sheets API error:', err.response?.data || err.message); console.error('Backend sync-sheets API error:', err.response?.data || err.message);
syncError = err.response?.data?.message || err.message; syncError = err.response?.data?.message || err.message;
@@ -124,6 +156,14 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => {
sync_error: syncError, sync_error: syncError,
sheets_config: sheetsConfig, sheets_config: sheetsConfig,
recent_subjects: recentSubjects.length > 0 ? recentSubjects : MOCK_RECENT_SUBJECTS, recent_subjects: recentSubjects.length > 0 ? recentSubjects : MOCK_RECENT_SUBJECTS,
available_careers: availableCareers,
available_subjects: availableSubjects,
filter_career: req.body?.filter_career || '',
filter_subject: req.body?.filter_subject || '',
filter_day: req.body?.filter_day || '',
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',
flash_msg: flashMsg, flash_msg: flashMsg,
flash_type: flashType flash_type: flashType
}); });
@@ -136,6 +176,29 @@ const handleGoogleSheetsImport = async (req, res, justSynced = false) => {
router.get(['/google_sheets_import', '/import'], (req, res) => handleGoogleSheetsImport(req, res, false)); router.get(['/google_sheets_import', '/import'], (req, res) => handleGoogleSheetsImport(req, res, false));
router.post(['/google_sheets_import', '/import'], (req, res) => handleGoogleSheetsImport(req, res, true)); router.post(['/google_sheets_import', '/import'], (req, res) => handleGoogleSheetsImport(req, res, true));
// Endpoint AJAX para inspeccionar Google Sheets en vivo
router.post('/sheets_inspect', async (req, res) => {
try {
const payload = {};
if (req.body) {
if (req.body.sheets_url) payload.sheets_url = req.body.sheets_url;
if (req.body.filter_career) payload.filter_career = req.body.filter_career;
if (req.body.filter_subject) payload.filter_subject = req.body.filter_subject;
if (req.body.filter_day) payload.filter_day = req.body.filter_day;
if (req.body.filter_days) payload.filter_days = req.body.filter_days;
if (req.body.manual_date) payload.manual_date = req.body.manual_date;
}
const resp = await req.apiClient.post('/dashboard/sheets-inspect', payload, { timeout: 45000 });
res.json(resp.data);
} catch (err) {
console.error('Error inspecting sheets in BFF:', err.response?.data || err.message);
res.status(err.response?.status || 500).json({
status: 'error',
message: err.response?.data?.message || err.message
});
}
});
// Guardar configuración del enlace de Google Sheets // Guardar configuración del enlace de Google Sheets
router.post('/google_sheets_config', async (req, res) => { router.post('/google_sheets_config', async (req, res) => {
try { try {
@@ -276,9 +339,9 @@ router.get(['/occupancy_metrics', '/occupancy-metrics', '/metrics/occupancy'], h
const MOCK_ROLES = [ const MOCK_ROLES = [
{ id: 1, name: 'Administrador', description: 'Acceso total al sistema', user_count: 2, is_system: true, permissions: { classrooms: 'read_write', schedule: 'read_write', admin: 'read_write', buildings: 'read_write' } }, { id: 1, name: 'Administrador', description: 'Acceso total al sistema', user_count: 2, is_system: true, permissions: { classrooms: 'read_write', schedule: 'read_write', admin: 'read_write', buildings: 'read_write' } },
{ id: 2, name: 'Bedel', description: 'Gestión de reservas y aulas', user_count: 5, is_system: false, permissions: { classrooms: 'read_write', schedule: 'read_write', admin: 'read', buildings: 'read' } }, { id: 2, name: 'Bedel', description: 'Gestión de reservas y aulas', user_count: 5, is_system: false, permissions: { classrooms: 'read_write', schedule: 'read_write', admin: 'read', buildings: 'read' } },
{ id: 3, name: 'Docente', description: 'Visualización de horarios', user_count: 18, is_system: false, permissions: { classrooms: 'read', schedule: 'read', admin: 'none', buildings: 'read' } }, { id: 3, name: 'Docente', description: 'Visualización de horarios', user_count: 18, is_system: false, permissions: { classrooms: 'read', schedule: 'read', admin: 'none', buildings: 'read' } },
{ id: 4, name: 'Invitado', description: 'Solo lectura', user_count: 3, is_system: false, permissions: { classrooms: 'read', schedule: 'none', admin: 'none', buildings: 'none' } } { id: 4, name: 'Invitado', description: 'Solo lectura', user_count: 3, is_system: false, permissions: { classrooms: 'read', schedule: 'none', admin: 'none', buildings: 'none' } }
]; ];
const MOCK_USERS = [ const MOCK_USERS = [
@@ -349,7 +412,7 @@ const handleUsersList = async (req, res) => {
if (role_filter) { if (role_filter) {
filtered = filtered.filter(u => String(u.role_id) === String(role_filter)); filtered = filtered.filter(u => String(u.role_id) === String(role_filter));
} }
if (status_filter === 'active') filtered = filtered.filter(u => u.is_active); if (status_filter === 'active') filtered = filtered.filter(u => u.is_active);
if (status_filter === 'inactive') filtered = filtered.filter(u => !u.is_active); if (status_filter === 'inactive') filtered = filtered.filter(u => !u.is_active);
res.render('admin/users/list', { res.render('admin/users/list', {
@@ -518,12 +581,12 @@ router.post(['/users/:id/password', '/users/password', '/user_password', '/user_
// ─── 4. ROLES ───────────────────────────────────────────────────────────────── // ─── 4. ROLES ─────────────────────────────────────────────────────────────────
const MODULES = [ const MODULES = [
{ id: 'classrooms', name: 'Aulas', icon: 'bi-door-open' }, { id: 'classrooms', name: 'Aulas', icon: 'bi-door-open' },
{ id: 'schedule', name: 'Horarios', icon: 'bi-calendar3' }, { id: 'schedule', name: 'Horarios', icon: 'bi-calendar3' },
{ id: 'buildings', name: 'Edificios', icon: 'bi-buildings' }, { id: 'buildings', name: 'Edificios', icon: 'bi-buildings' },
{ id: 'admin', name: 'Admin', icon: 'bi-shield-lock' }, { id: 'admin', name: 'Admin', icon: 'bi-shield-lock' },
{ id: 'users', name: 'Usuarios', icon: 'bi-people' }, { id: 'users', name: 'Usuarios', icon: 'bi-people' },
{ id: 'reports', name: 'Reportes', icon: 'bi-graph-up' } { id: 'reports', name: 'Reportes', icon: 'bi-graph-up' }
]; ];
const handleRolesList = async (req, res) => { const handleRolesList = async (req, res) => {
@@ -830,18 +893,21 @@ const handleCommissionsList = async (req, res) => {
try { try {
const search = (req.query.search || '').trim(); const search = (req.query.search || '').trim();
const subject_id = req.query.subject_id || ''; const subject_id = req.query.subject_id || '';
const career_id = req.query.career_id || '';
const shift = req.query.shift || ''; const shift = req.query.shift || '';
const active = req.query.active || ''; const active = req.query.active || '';
const unassigned_room = req.query.unassigned_room || '';
const created = req.query.created === '1'; const created = req.query.created === '1';
let commissions = []; let commissions = [];
let subjects = []; let subjects = [];
let teachers = []; let teachers = [];
let academic_terms = []; let academic_terms = [];
let careers = [];
try { try {
const [cRes, uRes] = await Promise.allSettled([ const [cRes, uRes] = await Promise.allSettled([
req.apiClient.get('/commissions', { params: { search, subject_id, shift, active } }), req.apiClient.get('/commissions', { params: { search, subject_id, career_id, shift, active, unassigned_room } }),
req.apiClient.get('/users') req.apiClient.get('/users')
]); ]);
@@ -849,10 +915,18 @@ const handleCommissionsList = async (req, res) => {
commissions = (cRes.value.data.commissions || []).map(c => ({ commissions = (cRes.value.data.commissions || []).map(c => ({
...c, ...c,
get_full_code: () => c.full_code || c.code, get_full_code: () => c.full_code || c.code,
career_id: c.career_id,
career_name: c.career_name || 'Carrera General',
classroom_name: c.classroom_name || 'Sin Aula Asignada',
has_classroom: Boolean(c.has_classroom),
is_virtual: Boolean(c.is_virtual),
virtual_link: c.virtual_link || '',
schedule: c.schedule || 'Sin horario',
subject: { subject: {
id: c.subject_id, id: c.subject_id,
name: c.subject_name, name: c.subject_name,
code: c.subject_code, code: c.subject_code,
career_id: c.career_id,
career_name: c.career_name || 'Carrera General' career_name: c.career_name || 'Carrera General'
}, },
teacher: c.teacher_name ? { name: c.teacher_name } : null, teacher: c.teacher_name ? { name: c.teacher_name } : null,
@@ -860,6 +934,15 @@ const handleCommissionsList = async (req, res) => {
})); }));
subjects = cRes.value.data.subjects || []; subjects = cRes.value.data.subjects || [];
academic_terms = cRes.value.data.academic_terms || []; academic_terms = cRes.value.data.academic_terms || [];
careers = cRes.value.data.careers || [];
}
// Fallback para careers si no vinieron en la respuesta de commissions
if (!careers || careers.length === 0) {
try {
const carRes = await req.apiClient.get('/careers');
careers = carRes.data?.careers || [];
} catch (carErr) { }
} }
// Si por alguna razón no vinieron academic_terms en commissions, intentar fallback // Si por alguna razón no vinieron academic_terms en commissions, intentar fallback
@@ -867,7 +950,7 @@ const handleCommissionsList = async (req, res) => {
try { try {
const termsRes = await req.apiClient.get('/academic-terms'); const termsRes = await req.apiClient.get('/academic-terms');
academic_terms = termsRes.data?.terms || termsRes.data?.academic_terms || []; academic_terms = termsRes.data?.terms || termsRes.data?.academic_terms || [];
} catch (tErr) {} } catch (tErr) { }
} }
if (uRes.status === 'fulfilled' && uRes.value.data) { if (uRes.status === 'fulfilled' && uRes.value.data) {
@@ -887,10 +970,13 @@ const handleCommissionsList = async (req, res) => {
subjects, subjects,
teachers, teachers,
academic_terms, academic_terms,
careers,
search, search,
subject_filter: subject_id ? parseInt(subject_id, 10) : '', subject_filter: subject_id ? parseInt(subject_id, 10) : '',
career_filter: career_id ? parseInt(career_id, 10) : '',
shift_filter: shift, shift_filter: shift,
active_filter: active, active_filter: active,
unassigned_room_filter: unassigned_room,
created, created,
msg: req.query.msg || (created ? 'created' : ''), msg: req.query.msg || (created ? 'created' : ''),
error: req.query.error || '', error: req.query.error || '',
@@ -1355,16 +1441,65 @@ const handleAuditLogs = async (req, res) => {
const search = req.query.search || ''; const search = req.query.search || '';
const current_module = req.query.module || ''; const current_module = req.query.module || '';
const current_action = req.query.action || ''; const current_action = req.query.action || '';
res.render('admin/audit_logs', { const page = parseInt(req.query.page, 10) || 1;
title: 'Bitácora de Auditoría - Edu-Space Admin',
logs: [], try {
modules: ['classrooms', 'reservations', 'users', 'auth', 'academic', 'optimizer'], const resp = await req.apiClient.get('/admin/audit-logs', {
actions: ['CREATE', 'UPDATE', 'DELETE', 'LOGIN', 'LOGOUT'], params: {
current_module, page,
current_action, per_page: 25,
search, search,
pagination: { pages: 1, page: 1, total: 0, has_prev: false, has_next: false } module: current_module,
}); action: current_action
}
});
const data = resp.data || {};
const audit_logs = data.logs || [];
const pagination = data.pagination || { pages: 1, page: 1, total: 0, has_prev: false, has_next: false };
// Generar lista de números de páginas para la plantilla Nunjucks
const pages_list = [];
const totalPages = pagination.pages || 1;
const maxPages = 7;
let startPage = Math.max(1, page - Math.floor(maxPages / 2));
let endPage = Math.min(totalPages, startPage + maxPages - 1);
if (endPage - startPage + 1 < maxPages) {
startPage = Math.max(1, endPage - maxPages + 1);
}
for (let i = startPage; i <= endPage; i++) {
pages_list.push(i);
}
pagination.pages_list = pages_list;
const modules = (data.modules && data.modules.length > 0) ? data.modules : ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin'];
const actions = (data.actions && data.actions.length > 0) ? data.actions : ['LOGIN', 'LOGIN_FAILED', 'LOGOUT', 'CREATE', 'UPDATE', 'DELETE', 'CONFIRM', 'CANCEL'];
res.render('admin/audit_logs', {
title: 'Registro de Auditoría Institucional - Edu-Space Admin',
audit_logs,
logs: audit_logs,
modules,
actions,
current_module,
current_action,
search,
pagination
});
} catch (err) {
console.warn('[Admin] Error fetching audit logs from backend:', err.response?.data || err.message);
res.render('admin/audit_logs', {
title: 'Registro de Auditoría Institucional - Edu-Space Admin',
audit_logs: [],
logs: [],
modules: ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin'],
actions: ['LOGIN', 'LOGIN_FAILED', 'LOGOUT', 'CREATE', 'UPDATE', 'DELETE', 'CONFIRM', 'CANCEL'],
current_module,
current_action,
search,
pagination: { pages: 1, page: 1, total: 0, has_prev: false, has_next: false, pages_list: [1] }
});
}
}; };
router.get(['/audit_logs', '/audit-logs', '/audit'], handleAuditLogs); router.get(['/audit_logs', '/audit-logs', '/audit'], handleAuditLogs);
+5 -8
View File
@@ -11,7 +11,7 @@ const isSecureCookie = (req) => {
router.get('/login', async (req, res) => { router.get('/login', async (req, res) => {
let providers = { local: true, google: false, moodle: false }; let providers = { local: true, google: false, moodle: false };
let google_client_id = ''; let google_client_id = '';
let demo_access_enabled = true; let demo_access_enabled = false;
try { try {
const resp = await apiClient.get('/auth/providers'); const resp = await apiClient.get('/auth/providers');
if (resp.data) { if (resp.data) {
@@ -24,7 +24,7 @@ router.get('/login', async (req, res) => {
} }
} }
} catch (e) { } catch (e) {
// Fallback default console.warn('Providers fetch notice in login:', e.message);
} }
res.render('auth/login', { res.render('auth/login', {
@@ -58,14 +58,11 @@ router.post('/login', async (req, res) => {
return res.redirect('/dashboard'); return res.redirect('/dashboard');
} }
res.render('auth/login', { error: 'Autenticación fallida' }); return res.redirect('/auth/login?error=' + encodeURIComponent('Autenticación fallida'));
} catch (error) { } catch (error) {
console.error('Login error:', error.response?.data || error.message); console.error('Login error:', error.response?.data || error.message);
const errorMsg = error.response?.data?.message || 'Error en el servidor de autenticación'; const errorMsg = error.response?.data?.message || 'Credenciales de acceso incorrectas o cuenta inactiva.';
res.render('auth/login', { return res.redirect('/auth/login?error=' + encodeURIComponent(errorMsg));
error: errorMsg,
providers: { local: true, google: false, moodle: false }
});
} }
}); });
+142 -1
View File
@@ -85,12 +85,17 @@ const handleListBuildings = async (req, res) => {
.filter(b => !b.is_virtual) .filter(b => !b.is_virtual)
.reduce((acc, b) => acc + (b.physical_capacity || b.total_capacity || 0), 0); .reduce((acc, b) => acc + (b.physical_capacity || b.total_capacity || 0), 0);
const total_floors = stats.total_floors || buildings
.filter(b => !b.is_virtual)
.reduce((acc, b) => acc + (parseInt(b.floors, 10) || 0), 0);
res.render('buildings/list', { res.render('buildings/list', {
title: 'Gestión de Edificios - Edu-Space Admin', title: 'Gestión de Edificios - Edu-Space Admin',
buildings, buildings,
total_classrooms: stats.total_classrooms || buildings.reduce((a, b) => a + (b.classrooms_count || 0), 0), total_classrooms: stats.total_classrooms || buildings.reduce((a, b) => a + (b.classrooms_count || 0), 0),
total_capacity: total_physical_capacity, total_capacity: total_physical_capacity,
total_physical_capacity, total_physical_capacity,
total_floors,
search, search,
status_filter: status status_filter: status
}); });
@@ -102,6 +107,7 @@ const handleListBuildings = async (req, res) => {
total_classrooms: 31, total_classrooms: 31,
total_capacity: 1250, total_capacity: 1250,
total_physical_capacity: 1250, total_physical_capacity: 1250,
total_floors: 4,
search: '', search: '',
status_filter: '' status_filter: ''
}); });
@@ -146,6 +152,117 @@ router.post(['/add', '/add_building'], async (req, res) => {
} }
}); });
// Función auxiliar para agrupar y sintetizar los pisos / niveles físicos y sus aulas
const buildFloorsList = (building, classrooms = []) => {
const is_virtual = Boolean(building.is_virtual || (building.code && building.code.toUpperCase() === 'VIRTUAL') || (building.name && building.name.toUpperCase().includes('VIRTUAL')));
if (is_virtual) {
return [{
floor_code: 'Digital',
floor_name: 'Campus Virtual (Digital)',
classrooms: classrooms,
total_capacity: 0,
classrooms_count: classrooms.length
}];
}
const floorsMap = new Map();
// 1. Incorporar todas las aulas reales existentes agrupadas por su piso
classrooms.forEach(c => {
let code = String(c.floor !== undefined && c.floor !== null ? c.floor : 'PB').trim();
let name = c.floor_display;
if (!name) {
const fLower = code.toLowerCase();
if (code === '0' || code.toUpperCase() === 'PB' || fLower.includes('planta baja')) {
name = 'Planta Baja (PB)';
code = 'PB';
} else if (code.toUpperCase() === 'EP' || fLower.includes('entrepiso')) {
name = 'Entrepiso (EP)';
code = 'EP';
} else if (code.toUpperCase() === 'SS' || fLower.includes('subsuelo')) {
name = 'Subsuelo (SS)';
code = 'SS';
} else if (fLower.startsWith('piso')) {
name = code;
} else if (/^\d+$/.test(code)) {
name = `Piso ${code}`;
} else {
name = code;
}
}
if (!floorsMap.has(code)) {
floorsMap.set(code, {
floor_code: code,
floor_name: name,
classrooms: [],
total_capacity: 0
});
}
const fEntry = floorsMap.get(code);
fEntry.classrooms.push(c);
fEntry.total_capacity += (c.capacity || 0);
});
// 2. Si el edificio tiene floors > 0, asegurar niveles básicos esperados (PB y Pisos 1..N)
const numFloors = parseInt(building.floors, 10) || 1;
if (numFloors >= 1 && !floorsMap.has('PB') && !floorsMap.has('0')) {
floorsMap.set('PB', {
floor_code: 'PB',
floor_name: 'Planta Baja (PB)',
classrooms: [],
total_capacity: 0
});
}
for (let i = 1; i < numFloors; i++) {
const floorStr = String(i);
if (!floorsMap.has(floorStr)) {
floorsMap.set(floorStr, {
floor_code: floorStr,
floor_name: `Piso ${i}`,
classrooms: [],
total_capacity: 0
});
}
}
if (numFloors === 1 && floorsMap.size === 0) {
floorsMap.set('PB', {
floor_code: 'PB',
floor_name: 'Planta Baja (PB)',
classrooms: [],
total_capacity: 0
});
}
// Ordenar pisos: Subsuelos primero, Planta Baja, Entrepisos, luego numéricos
const sortedFloors = Array.from(floorsMap.values()).sort((a, b) => {
const cA = String(a.floor_code).toUpperCase();
const cB = String(b.floor_code).toUpperCase();
const nA = String(a.floor_name).toUpperCase();
const nB = String(b.floor_name).toUpperCase();
if (cA.includes('SUB') || cA.includes('SS') || nA.includes('SUB')) return -1;
if (cB.includes('SUB') || cB.includes('SS') || nB.includes('SUB')) return 1;
if (cA === 'PB' || cA === '0' || nA.includes('PLANTA BAJA')) return -1;
if (cB === 'PB' || cB === '0' || nB.includes('PLANTA BAJA')) return 1;
if (cA === 'EP' || nA.includes('ENTRE')) return -1;
if (cB === 'EP' || nB.includes('ENTRE')) return 1;
const numA = parseInt(a.floor_code, 10);
const numB = parseInt(b.floor_code, 10);
if (!isNaN(numA) && !isNaN(numB)) return numA - numB;
return a.floor_name.localeCompare(b.floor_name, undefined, { numeric: true });
});
sortedFloors.forEach(f => {
f.classrooms_count = f.classrooms.length;
});
return sortedFloors;
};
// 3. View Building // 3. View Building
router.get(['/view/:id', '/view_building', '/:id'], async (req, res) => { router.get(['/view/:id', '/view_building', '/:id'], async (req, res) => {
const id = parseInt(req.params.id || req.query.id, 10) || 1; const id = parseInt(req.params.id || req.query.id, 10) || 1;
@@ -174,10 +291,18 @@ router.get(['/view/:id', '/view_building', '/:id'], async (req, res) => {
floors_display: is_virtual ? 'Digital' : String(building.floors ?? 1) floors_display: is_virtual ? 'Digital' : String(building.floors ?? 1)
}; };
const floors_list = buildFloorsList(building, classrooms);
const classrooms_by_floor = {};
floors_list.forEach(f => {
classrooms_by_floor[f.floor_name] = f.classrooms;
});
res.render('buildings/view', { res.render('buildings/view', {
title: `Edificio ${building.name} - Edu-Space Admin`, title: `Edificio ${building.name} - Edu-Space Admin`,
building, building,
classrooms classrooms,
classrooms_by_floor,
floors_list
}); });
}); });
@@ -185,11 +310,13 @@ router.get(['/view/:id', '/view_building', '/:id'], async (req, res) => {
const handleEditBuildingGet = async (req, res) => { const handleEditBuildingGet = async (req, res) => {
const id = parseInt(req.params.id || req.query.id, 10) || 1; const id = parseInt(req.params.id || req.query.id, 10) || 1;
let building = null; let building = null;
let classrooms = [];
try { try {
const apiRes = await req.apiClient.get(`/buildings/${id}`); const apiRes = await req.apiClient.get(`/buildings/${id}`);
if (apiRes.data && apiRes.data.building) { if (apiRes.data && apiRes.data.building) {
building = apiRes.data.building; building = apiRes.data.building;
classrooms = apiRes.data.classrooms || [];
} }
} catch (e) { } catch (e) {
building = defaultBuildings.find(b => b.id === id) || defaultBuildings[0]; building = defaultBuildings.find(b => b.id === id) || defaultBuildings[0];
@@ -199,6 +326,17 @@ const handleEditBuildingGet = async (req, res) => {
return res.redirect('/buildings/list_buildings'); return res.redirect('/buildings/list_buildings');
} }
const is_virtual = Boolean(building.is_virtual || (building.code && building.code.toUpperCase() === 'VIRTUAL') || (building.name && building.name.toUpperCase().includes('VIRTUAL')));
building = {
...building,
is_virtual,
capacity_display: is_virtual ? 'Ilimitada (Virtual)' : String(building.physical_capacity || building.total_capacity || 0),
floors_display: is_virtual ? 'Digital' : String(building.floors ?? 1)
};
const floors_list = buildFloorsList(building, classrooms);
const total_physical_capacity = is_virtual ? 0 : classrooms.reduce((acc, c) => acc + (c.capacity || 0), 0);
const form = createFormMock({ const form = createFormMock({
name: building.name, name: building.name,
code: building.code, code: building.code,
@@ -211,6 +349,9 @@ const handleEditBuildingGet = async (req, res) => {
res.render('buildings/form', { res.render('buildings/form', {
title: `Editar Edificio - ${building.name}`, title: `Editar Edificio - ${building.name}`,
building, building,
classrooms,
floors_list,
total_physical_capacity,
form form
}); });
}; };
+54 -10
View File
@@ -350,9 +350,14 @@ const handleAddClassroom = async (req, res) => {
{ value: 'new', text: '+ Crear nuevo edificio / sede' } { value: 'new', text: '+ Crear nuevo edificio / sede' }
]; ];
const preselectedBuildingId = req.query.building_id || '';
const preselectedFloor = req.query.floor || '';
const form = createFormMock({ const form = createFormMock({
is_active: true, is_active: true,
capacity: 35 capacity: 35,
building_id: preselectedBuildingId,
floor: preselectedFloor
}, { }, {
building_id: buildingOptions building_id: buildingOptions
}); });
@@ -361,7 +366,9 @@ const handleAddClassroom = async (req, res) => {
title: 'Add Classroom - Edu-Space Admin', title: 'Add Classroom - Edu-Space Admin',
form, form,
buildings, buildings,
building_floors: buildingFloors building_floors: buildingFloors,
preselected_building_id: preselectedBuildingId,
preselected_floor: preselectedFloor
}); });
} catch (error) { } catch (error) {
console.error('Error rendering add classroom:', error.message); console.error('Error rendering add classroom:', error.message);
@@ -456,16 +463,53 @@ const handleViewClassroom = async (req, res) => {
classroom.code_display = classroom.code_display || classroom.code || `Aula-${classroomId}`; classroom.code_display = classroom.code_display || classroom.code || `Aula-${classroomId}`;
classroom.building_entity = classroom.building_entity || null; classroom.building_entity = classroom.building_entity || null;
// Fetch upcoming reservations for this classroom // Fetch upcoming reservations for this classroom (encompassing full 2026 academic term)
try { try {
const rRes = await req.apiClient.get(`/reservations?classroom_id=${classroomId}&start_date=2026-08-31&end_date=2026-10-01`); const rRes = await req.apiClient.get(`/reservations?classroom_id=${classroomId}&start_date=2026-08-01&end_date=2026-12-31`);
const allClassroomRes = (rRes.data && (rRes.data.reservations || rRes.data)) || []; const allClassroomRes = (rRes.data && (rRes.data.reservations || rRes.data)) || [];
upcomingReservations = allClassroomRes.map(r => ({ const dayNames = ['Domingo', 'Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado'];
...r,
date_display: r.start_time ? r.start_time.split('T')[0] : '', upcomingReservations = allClassroomRes.map(r => {
start_time_display: r.start_time ? (r.start_time.includes('T') ? r.start_time.split('T')[1].substring(0, 5) : r.start_time) : '', let dateDisplayFriendly = '';
end_time_display: r.end_time ? (r.end_time.includes('T') ? r.end_time.split('T')[1].substring(0, 5) : r.end_time) : '' let timeRangeFriendly = '';
})).sort((a, b) => a.start_time.localeCompare(b.start_time)).slice(0, 20); let fullDisplay = '';
if (r.start_time) {
try {
const rawStart = String(r.start_time).replace(' ', 'T');
const rawEnd = r.end_time ? String(r.end_time).replace(' ', 'T') : '';
const dtStart = new Date(rawStart);
const dtEnd = rawEnd ? new Date(rawEnd) : null;
const dayName = dayNames[dtStart.getDay()];
const d = String(dtStart.getDate()).padStart(2, '0');
const m = String(dtStart.getMonth() + 1).padStart(2, '0');
const y = dtStart.getFullYear();
dateDisplayFriendly = `${dayName} ${d}/${m}/${y}`;
const sH = String(dtStart.getHours()).padStart(2, '0');
const sM = String(dtStart.getMinutes()).padStart(2, '0');
const eH = dtEnd ? String(dtEnd.getHours()).padStart(2, '0') : '';
const eM = dtEnd ? String(dtEnd.getMinutes()).padStart(2, '0') : '';
timeRangeFriendly = dtEnd ? `${sH}:${sM} a ${eH}:${eM} hs` : `${sH}:${sM} hs`;
fullDisplay = `${dateDisplayFriendly} · ${timeRangeFriendly}`;
} catch (e) {
dateDisplayFriendly = r.start_time.split('T')[0] || r.start_time;
timeRangeFriendly = r.end_time ? `${r.start_time} - ${r.end_time}` : r.start_time;
fullDisplay = `${dateDisplayFriendly} · ${timeRangeFriendly}`;
}
}
return {
...r,
date_display: r.start_time ? r.start_time.split('T')[0] : '',
date_display_friendly: dateDisplayFriendly,
time_range_friendly: timeRangeFriendly,
full_display: fullDisplay,
start_time_display: r.start_time ? (r.start_time.includes('T') ? r.start_time.split('T')[1].substring(0, 5) : r.start_time) : '',
end_time_display: r.end_time ? (r.end_time.includes('T') ? r.end_time.split('T')[1].substring(0, 5) : r.end_time) : ''
};
}).sort((a, b) => (a.start_time || '').localeCompare(b.start_time || '')).slice(0, 30);
} catch (e) { } catch (e) {
console.warn('Could not fetch reservations for classroom:', e.message); console.warn('Could not fetch reservations for classroom:', e.message);
} }
+46 -129
View File
@@ -39,7 +39,9 @@ router.get('/', async (req, res) => {
const today_reservations = backendStats.today_reservations ?? 19; const today_reservations = backendStats.today_reservations ?? 19;
const pending_count = backendStats.pending_count ?? 3; const pending_count = backendStats.pending_count ?? 3;
const physical_classrooms = backendStats.physical_classrooms ?? Math.max(1, total_classrooms - 4); const physical_classrooms = backendStats.physical_classrooms ?? Math.max(1, total_classrooms - 4);
const virtual_classrooms_count = backendStats.virtual_classrooms ?? 4; const bedeliaData = apiData.bedelia || {};
const virtual_rooms_list = bedeliaData.virtual_rooms || apiData.virtual_rooms || [];
const virtual_classrooms_count = bedeliaData.virtual_rooms_count || virtual_rooms_list.length || backendStats.virtual_classrooms || 0;
const occupancy_rate = backendStats.occupancy_rate ?? 68; const occupancy_rate = backendStats.occupancy_rate ?? 68;
const assigned_classrooms = backendStats.assigned_classrooms ?? 26; const assigned_classrooms = backendStats.assigned_classrooms ?? 26;
@@ -68,8 +70,20 @@ router.get('/', async (req, res) => {
? apiData.milestones ? apiData.milestones
: null; : null;
// Bedelía-specific data // Filter stats (today, week, month) & date labels for classrooms and commissions
const bedeliaData = apiData.bedelia || {}; const filter_stats = apiData.filter_stats || backendStats.filter_stats || bedeliaData.filter_stats || {
date_labels: {
today: 'Hoy',
tomorrow: 'Mañana',
week: 'Esta Semana',
month: 'Este Mes'
},
today: { label: 'Hoy', classrooms: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 }, commissions: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 } },
tomorrow: { label: 'Mañana', classrooms: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 }, commissions: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 } },
week: { label: 'Esta Semana', classrooms: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 }, commissions: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 } },
month: { label: 'Este Mes', classrooms: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 }, commissions: { assigned: [], unassigned: [], assigned_count: 0, unassigned_count: 0, assigned_pct: 0, unassigned_pct: 0, total: 0 } }
};
const date_labels = apiData.date_labels || backendStats.date_labels || filter_stats.date_labels || {};
// Consolidated and role-specific stats // Consolidated and role-specific stats
const stats = { const stats = {
@@ -93,13 +107,17 @@ router.get('/', async (req, res) => {
my_total_reservations: 8, my_total_reservations: 8,
virtual_rooms_count: virtual_classrooms_count, virtual_rooms_count: virtual_classrooms_count,
today_classes_count: apiTodaySchedule ? Math.min(4, apiTodaySchedule.length) : 2, today_classes_count: apiTodaySchedule ? Math.min(4, apiTodaySchedule.length) : 2,
milestones_count: apiMilestones ? apiMilestones.length : 3 milestones_count: apiMilestones ? apiMilestones.length : 3,
filter_stats,
date_labels
}; };
let role_data = {}; let role_data = {};
if (role === 'admin') { if (role === 'admin') {
role_data = { role_data = {
filter_stats,
date_labels,
recent_audits: audit_logs.length > 0 ? audit_logs : [ recent_audits: audit_logs.length > 0 ? audit_logs : [
{ created_at: '2026-09-18 21:15', action_type: 'UPDATE_PERMISSION', user_email: 'admin@edu-space.com', ip_address: '127.0.0.1' }, { created_at: '2026-09-18 21:15', action_type: 'UPDATE_PERMISSION', user_email: 'admin@edu-space.com', ip_address: '127.0.0.1' },
{ created_at: '2026-09-18 20:30', action_type: 'CREATE_COMMISSION', user_email: 'admin@edu-space.com', ip_address: '127.0.0.1' }, { created_at: '2026-09-18 20:30', action_type: 'CREATE_COMMISSION', user_email: 'admin@edu-space.com', ip_address: '127.0.0.1' },
@@ -107,75 +125,34 @@ router.get('/', async (req, res) => {
] ]
}; };
} else if (role === 'bedelia') { } else if (role === 'bedelia') {
const apiTomorrowSchedule = Array.isArray(apiData.tomorrow_schedule_list) ? apiData.tomorrow_schedule_list : [];
const apiWeekSchedule = Array.isArray(apiData.week_schedule_list) ? apiData.week_schedule_list : [];
role_data = { role_data = {
pending_reservations: apiPending || [ filter_stats,
{ date_labels,
id: 101, pending_reservations: apiPending || [],
start_time: '08:00', today_schedule_list: apiTodaySchedule || [],
end_time: '12:00', tomorrow_schedule_list: apiTomorrowSchedule,
classroom: { code: 'Aula 101' }, week_schedule_list: apiWeekSchedule,
subject_name: 'Arquitectura de Computadoras', unassigned_commissions_tomorrow: bedeliaData.unassigned_commissions_tomorrow || [],
user: { name: 'Prof. Gabriel Martínez' }
},
{
id: 102,
start_time: '14:00',
end_time: '18:00',
classroom: { code: 'Lab Informática 2' },
subject_name: 'Bases de Datos II',
user: { name: 'Dra. Laura Blanco' }
},
{
id: 103,
start_time: '18:30',
end_time: '22:00',
classroom: { code: 'Aula Magna' },
subject_name: 'Seminario de Ciberseguridad',
user: { name: 'Lic. Fernando Gómez' }
}
],
today_schedule_list: apiTodaySchedule || [
{ start_time: '08:00', end_time: '12:00', classroom: { code: 'Aula 102' }, subject_name: 'Algoritmos y Estructuras de Datos', user: { name: 'Prof. Ana Vega' } },
{ start_time: '08:30', end_time: '12:30', classroom: { code: 'Aula 204' }, subject_name: 'Matemática Discreta', user: { name: 'Prof. Carlos López' } },
{ start_time: '14:00', end_time: '18:00', classroom: { code: 'Lab Redes' }, subject_name: 'Redes y Telecomunicaciones', user: { name: 'Ing. Marcos Ruiz' } }
],
unassigned_commissions_week: bedeliaData.unassigned_commissions_week || [], unassigned_commissions_week: bedeliaData.unassigned_commissions_week || [],
unassigned_commissions_month: bedeliaData.unassigned_commissions_month || [], unassigned_commissions_month: bedeliaData.unassigned_commissions_month || [],
unassigned_commissions_general: bedeliaData.unassigned_commissions_general || [],
available_classrooms_today: bedeliaData.available_classrooms_today || [],
available_classrooms_tomorrow: bedeliaData.available_classrooms_tomorrow || [],
available_classrooms_week: bedeliaData.available_classrooms_week || [], available_classrooms_week: bedeliaData.available_classrooms_week || [],
available_classrooms_month: bedeliaData.available_classrooms_month || [] available_classrooms_month: bedeliaData.available_classrooms_month || [],
virtual_rooms: virtual_rooms_list,
virtual_rooms_count: virtual_classrooms_count
}; };
} else if (role === 'docente') { } else if (role === 'docente') {
const myClasses = apiTodaySchedule ? apiTodaySchedule.slice(0, 3) : null; const myClasses = apiTodaySchedule ? apiTodaySchedule.slice(0, 3) : [];
role_data = { role_data = {
my_today_classes: myClasses || [ my_today_classes: myClasses,
{ virtual_classrooms: []
id: 201,
start_time: '08:30',
end_time: '12:00',
subject_name: 'Algoritmos y Estructuras de Datos',
subject_code: 'AED-102',
commission: { code: 'COM-A' },
classroom: { is_virtual: false, location_display: 'Piso 1 · Aula 104' },
virtual_link: ''
},
{
id: 202,
start_time: '18:30',
end_time: '22:00',
subject_name: 'Programación Concurrente y Distribuida',
subject_code: 'PCD-301',
commission: { code: 'COM-D' },
classroom: { is_virtual: true, location_display: 'Campus Virtual' },
virtual_link: 'https://meet.google.com/edu-space-pcd'
}
],
virtual_classrooms: [
{ code: 'Sala Virtual 1', link: 'https://meet.google.com/edu-space-v1' },
{ code: 'Sala Virtual 2', link: 'https://meet.google.com/edu-space-v2' }
]
}; };
} else if (role === 'alumno') { } else if (role === 'alumno') {
const studentClasses = apiTodaySchedule ? apiTodaySchedule.slice(0, 4) : null; const studentClasses = apiTodaySchedule ? apiTodaySchedule.slice(0, 4) : [];
let upcomingMilestonesList = []; let upcomingMilestonesList = [];
try { try {
const mResp = await req.apiClient.get('/students/my-upcoming-milestones'); const mResp = await req.apiClient.get('/students/my-upcoming-milestones');
@@ -196,75 +173,13 @@ router.get('/', async (req, res) => {
console.warn('Student milestones fetch notice:', e.message); console.warn('Student milestones fetch notice:', e.message);
} }
if (upcomingMilestonesList.length === 0) {
upcomingMilestonesList = [
{
title: 'Primer Examen Parcial',
materia_codigo: 'BDR-201',
subject_name: 'Bases de Datos Relacionales',
date: '25/09/2026',
days_remaining: 2,
type_obj: { name: 'Examen Parcial', color: '#dc3545' },
milestone_type: { name: 'Examen Parcial', color: '#dc3545' },
notes: 'Traer DNI y calculadora',
classroom: 'Piso 2 · Aula 204'
},
{
title: 'Entrega TP Grupal Nº 2',
materia_codigo: 'AED-102',
subject_name: 'Algoritmos y Estructuras de Datos',
date: '30/09/2026',
days_remaining: 7,
type_obj: { name: 'Trabajo Práctico', color: '#198754' },
milestone_type: { name: 'Trabajo Práctico', color: '#198754' },
notes: 'Subir código al repositorio',
classroom: 'Campus Virtual',
link: 'https://campus.edu-space.com/tps'
},
{
title: 'Recuperatorio Parcial 1',
materia_codigo: 'RYT-302',
subject_name: 'Redes y Telecomunicaciones',
date: '08/10/2026',
days_remaining: 15,
type_obj: { name: 'Recuperatorio', color: '#fd7e14' },
milestone_type: { name: 'Recuperatorio', color: '#fd7e14' },
notes: 'Piso 2 · Aula 204',
classroom: 'Piso 2 · Aula 204'
}
];
}
role_data = { role_data = {
today_classes: studentClasses || [ today_classes: studentClasses,
{
start_time: '08:00',
end_time: '12:00',
subject_name: 'Bases de Datos Relacionales',
subject_code: 'BDR-201',
commission: { code: 'COM-1' },
classroom: { is_virtual: false, location_display: 'Piso 2 · Laboratorio 3' },
virtual_link: ''
},
{
start_time: '18:30',
end_time: '22:30',
subject_name: 'Redes y Telecomunicaciones',
subject_code: 'RYT-302',
commission: { code: 'COM-2' },
classroom: { is_virtual: true, location_display: 'Campus Virtual (Google Meet)' },
virtual_link: 'https://meet.google.com/edu-space-demo'
}
],
upcoming_milestones: upcomingMilestonesList upcoming_milestones: upcomingMilestonesList
}; };
} }
const upcoming_reservations = apiUpcoming || [ const upcoming_reservations = apiUpcoming || [];
{ start_time: '08:00', end_time: '12:00', date_display: '22/09', subject_name: 'Matemática Discreta', subject_code: 'MAT-101', shift: 'Mañana', commission: { code: 'COM-1' }, status: 'CONFIRMED', classroom: { code: 'Aula 101' }, user: { name: 'Prof. Carlos López' } },
{ start_time: '14:00', end_time: '18:00', date_display: '23/09', subject_name: 'Sistemas Operativos', subject_code: 'SO-202', shift: 'Tarde', commission: { code: 'COM-2' }, status: 'CONFIRMED', classroom: { code: 'Lab 2' }, user: { name: 'Dra. Ana Vega' } },
{ start_time: '18:30', end_time: '22:30', date_display: '24/09', subject_name: 'Ingeniería de Software', subject_code: 'IS-301', shift: 'Noche', commission: { code: 'COM-3' }, status: 'PENDING', classroom: { code: 'Aula Magna' }, user: { name: 'Ing. Marcos Ruiz' } }
];
let show_role_banner = true; let show_role_banner = true;
if (apiData && apiData.ui && apiData.ui.show_role_banner !== undefined) { if (apiData && apiData.ui && apiData.ui.show_role_banner !== undefined) {
@@ -284,7 +199,9 @@ router.get('/', async (req, res) => {
role_data, role_data,
monthly_data, monthly_data,
audit_logs, audit_logs,
upcoming_reservations upcoming_reservations,
filter_stats,
date_labels
}); });
}); });
+311 -46
View File
@@ -29,6 +29,23 @@ const handleCalendarView = async (req, res) => {
console.warn('Could not fetch unassigned commissions for calendar:', e.message); console.warn('Could not fetch unassigned commissions for calendar:', e.message);
} }
let careers = [];
let subjects = [];
try {
const [carRes, subRes] = await Promise.allSettled([
req.apiClient.get('/careers'),
req.apiClient.get('/subjects')
]);
if (carRes.status === 'fulfilled' && carRes.value.data) {
careers = carRes.value.data.careers || [];
}
if (subRes.status === 'fulfilled' && subRes.value.data) {
subjects = subRes.value.data.subjects || [];
}
} catch (e) {
console.warn('Could not fetch real careers/subjects for calendar filters:', e.message);
}
res.render('schedule/calendar', { res.render('schedule/calendar', {
title: 'Reservations Calendar - Edu-Space Admin', title: 'Reservations Calendar - Edu-Space Admin',
today_date: new Date().toISOString().split('T')[0], today_date: new Date().toISOString().split('T')[0],
@@ -39,15 +56,8 @@ const handleCalendarView = async (req, res) => {
capacity: c.capacity || 40 capacity: c.capacity || 40
})), })),
unassigned_commissions: unassignedCommissions, unassigned_commissions: unassignedCommissions,
subjects: [ subjects,
{ id: 1, name: 'Arquitectura de Software', code: 'ARQ-101' }, careers,
{ id: 2, name: 'Bases de Datos II', code: 'BD-201' },
{ id: 3, name: 'Programación Avanzada', code: 'PRG-301' }
],
careers: [
{ id: 1, name: 'Licenciatura en Sistemas' },
{ id: 2, name: 'Tecnicatura Universitaria en Desarrollo de Software' }
],
buildings: Array.from(buildingsMap.values()), buildings: Array.from(buildingsMap.values()),
available_floors: Array.from(floorsSet).sort(), available_floors: Array.from(floorsSet).sort(),
session: { get: (k, d) => d } session: { get: (k, d) => d }
@@ -89,27 +99,34 @@ const handleCalendarData = async (req, res) => {
if (r.status === 'PENDING') eventColor = '#F59E0B'; if (r.status === 'PENDING') eventColor = '#F59E0B';
else if (isVirtual) eventColor = '#6366F1'; else if (isVirtual) eventColor = '#6366F1';
const subjectName = r.subject_name || r.purpose || 'Clase Regular';
const subjectCode = r.subject_code || '';
const careerName = (r.commission && r.commission.career_names) || (r.commission && r.commission.career_name) || r.career_names || r.career_name || '';
const commissionCode = (r.commission && r.commission.code) || r.commission_code || '';
const roomName = r.classroom_name || (r.classroom ? r.classroom.code : 'Aula');
const locationDisplay = (r.classroom && r.classroom.location_display) || (r.classroom && r.classroom.building) || r.classroom_name || 'Edificio Central';
return { return {
id: r.id, id: r.id,
title: `${r.purpose || 'Clase Regular'} - ${r.classroom_name || 'Aula'}`, title: `${subjectName} - ${roomName}`,
start: r.start_time, start: r.start_time,
end: r.end_time, end: r.end_time,
backgroundColor: eventColor, backgroundColor: eventColor,
borderColor: eventColor, borderColor: eventColor,
extendedProps: { extendedProps: {
subject_name: 'Arquitectura de Software', subject_name: subjectName,
subject_code: 'ARQ-101', subject_code: subjectCode,
classroom: r.classroom_name || 'Aula Principal', classroom: roomName,
is_virtual: isVirtual, is_virtual: isVirtual,
location_display: r.classroom_name || 'Edificio Central', location_display: locationDisplay,
career: 'Licenciatura en Sistemas', career: careerName,
commission: 'COM-A', commission: commissionCode,
shift: r.shift || 'Noche', shift: r.shift || 'Mañana',
status: (r.status || 'CONFIRMED').toUpperCase(), status: (r.status || 'CONFIRMED').toUpperCase(),
purpose: r.purpose || 'Clase Regular', purpose: r.purpose || subjectName,
attendees: r.expected_attendees || 35, attendees: r.expected_attendees || 30,
teacher: r.teacher_name || 'Profesor Titular', teacher: r.teacher_name || '',
virtual_link: r.virtual_link || '', virtual_link: r.effective_virtual_link || r.virtual_link || '',
cancel_url: `/schedule/cancel_reservation?id=${r.id}` cancel_url: `/schedule/cancel_reservation?id=${r.id}`
} }
}; };
@@ -125,11 +142,132 @@ const handleCalendarData = async (req, res) => {
router.get('/calendar_data', handleCalendarData); router.get('/calendar_data', handleCalendarData);
router.get('/calendar-data', handleCalendarData); router.get('/calendar-data', handleCalendarData);
// Función utilitaria para normalizar y formatear fechas, horarios y atributos de una reserva
function formatReservationDates(r) {
if (!r) return r;
const rawStart = r.start_time ? String(r.start_time) : '';
const rawEnd = r.end_time ? String(r.end_time) : '';
// Extraer fecha 'YYYY-MM-DD'
let dateStr = '';
if (rawStart.includes('T')) {
dateStr = rawStart.split('T')[0];
} else if (rawStart.includes(' ')) {
dateStr = rawStart.split(' ')[0];
} else if (rawStart.match(/^\d{4}-\d{2}-\d{2}/)) {
dateStr = rawStart.substring(0, 10);
}
// Extraer horas HH:mm
let startTimeStr = '08:00';
let endTimeStr = '10:00';
if (rawStart.includes('T')) {
startTimeStr = rawStart.split('T')[1].substring(0, 5);
} else if (rawStart.includes(' ')) {
startTimeStr = rawStart.split(' ')[1].substring(0, 5);
} else if (rawStart.match(/^\d{2}:\d{2}/)) {
startTimeStr = rawStart.substring(0, 5);
}
if (rawEnd.includes('T')) {
endTimeStr = rawEnd.split('T')[1].substring(0, 5);
} else if (rawEnd.includes(' ')) {
endTimeStr = rawEnd.split(' ')[1].substring(0, 5);
} else if (rawEnd.match(/^\d{2}:\d{2}/)) {
endTimeStr = rawEnd.substring(0, 5);
}
// Formatear fecha en español
let date_short = dateStr;
let date_display = dateStr;
let date_full = dateStr;
if (dateStr && dateStr.includes('-')) {
const parts = dateStr.split('-');
if (parts.length === 3) {
const year = parseInt(parts[0], 10);
const month = parseInt(parts[1], 10);
const day = parseInt(parts[2], 10);
const dObj = new Date(year, month - 1, day);
const daysNames = ['Domingo', 'Lunes', 'Martes', 'Miércoles', 'Jueves', 'Viernes', 'Sábado'];
const monthsNames = ['Enero', 'Febrero', 'Marzo', 'Abril', 'Mayo', 'Junio', 'Julio', 'Agosto', 'Septiembre', 'Octubre', 'Noviembre', 'Diciembre'];
const dayName = daysNames[dObj.getDay()] || '';
const monthName = monthsNames[month - 1] || '';
const dayPad = String(day).padStart(2, '0');
const monthPad = String(month).padStart(2, '0');
date_short = `${dayPad}/${monthPad}/${year}`;
date_display = `${dayName} ${dayPad}/${monthPad}/${year}`;
date_full = `${dayName}, ${dayPad} de ${monthName} de ${year}`;
}
}
// Calcular duración amigable
let durationMinutes = 0;
if (startTimeStr && endTimeStr) {
const [sh, sm] = startTimeStr.split(':').map(Number);
const [eh, em] = endTimeStr.split(':').map(Number);
durationMinutes = (eh * 60 + em) - (sh * 60 + sm);
if (durationMinutes < 0) durationMinutes += 24 * 60;
}
let duration_display = '2 hs';
if (durationMinutes > 0) {
const hours = Math.floor(durationMinutes / 60);
const mins = durationMinutes % 60;
if (mins === 0) {
duration_display = `${hours} hs`;
} else {
duration_display = `${hours}h ${mins}m`;
}
}
const isVirt = Boolean(r.is_virtual || (r.classroom && r.classroom.is_virtual) || (r.classroom_name && r.classroom_name.includes('VIRTUAL')));
const startHour = parseInt(startTimeStr.split(':')[0], 10) || 8;
let inferredShift = r.shift;
if (!inferredShift) {
if (startHour >= 18) inferredShift = 'Noche';
else if (startHour >= 13) inferredShift = 'Tarde';
else inferredShift = 'Mañana';
}
return {
...r,
raw_start_time: rawStart,
raw_end_time: rawEnd,
start_time: startTimeStr,
end_time: endTimeStr,
start_time_clean: startTimeStr,
end_time_clean: endTimeStr,
start_time_display: `${startTimeStr} hs`,
end_time_display: `${endTimeStr} hs`,
time_display: `${startTimeStr} - ${endTimeStr} hs`,
time_range: `${startTimeStr} - ${endTimeStr} hs`,
duration_minutes: durationMinutes,
duration_display,
date_raw: dateStr,
date_short,
date_display,
date_full,
shift: inferredShift,
is_virtual: isVirt,
subject_name: r.subject_name || r.purpose || 'Clase Regular',
subject_code: r.subject_code || '',
effective_virtual_link: r.effective_virtual_link || r.virtual_link || '',
classroom: r.classroom || {
code: r.classroom_name || (isVirt ? 'VIRTUAL' : 'Sin Aula'),
floor: isVirt ? 0 : 1,
is_virtual: isVirt,
building: isVirt ? 'Campus Virtual' : 'Edificio Central'
},
user: r.user || { name: r.teacher_name || 'Docente' }
};
}
// 3. Vista de Lista de Reservas // 3. Vista de Lista de Reservas
const handleReservationsList = async (req, res) => { const handleReservationsList = async (req, res) => {
try { try {
const response = await req.apiClient.get('/reservations'); const response = await req.apiClient.get('/reservations');
const reservations = (response.data && response.data.reservations) || []; const rawReservations = (response.data && response.data.reservations) || [];
const reservations = rawReservations.map(formatReservationDates);
res.render('schedule/list', { res.render('schedule/list', {
title: 'Listado de Reservas - Edu-Space Admin', title: 'Listado de Reservas - Edu-Space Admin',
@@ -164,11 +302,21 @@ router.get('/list_reservations', handleReservationsList);
// 4. Vista de Hoy (Cartelera del Día) // 4. Vista de Hoy (Cartelera del Día)
const handleTodaySchedule = async (req, res) => { const handleTodaySchedule = async (req, res) => {
try { try {
const todayStr = req.query.date || '2026-09-18'; const defaultTodayStr = new Date().toISOString().split('T')[0];
const todayStr = req.query.date || defaultTodayStr;
const hide_virtual = req.query.hide_virtual === '1' || req.query.hide_virtual === 'true'; const hide_virtual = req.query.hide_virtual === '1' || req.query.hide_virtual === 'true';
const floor_filter = req.query.floor || ''; const floor_filter = req.query.floor || '';
const shift_filter = req.query.shift || ''; const shift_filter = req.query.shift || '';
// Fechas anterior y siguiente para navegación
const currentDateObj = new Date(todayStr + 'T00:00:00');
const prevDateObj = new Date(currentDateObj);
prevDateObj.setDate(prevDateObj.getDate() - 1);
const nextDateObj = new Date(currentDateObj);
nextDateObj.setDate(nextDateObj.getDate() + 1);
const prevDateStr = prevDateObj.toISOString().split('T')[0];
const nextDateStr = nextDateObj.toISOString().split('T')[0];
const params = { const params = {
start_date: todayStr, start_date: todayStr,
end_date: todayStr end_date: todayStr
@@ -180,35 +328,46 @@ const handleTodaySchedule = async (req, res) => {
const response = await req.apiClient.get('/reservations', { params }); const response = await req.apiClient.get('/reservations', { params });
let rawReservations = (response.data && response.data.reservations) || []; let rawReservations = (response.data && response.data.reservations) || [];
// Format each reservation for the template // Formatear cada reserva con atributos enriquecidos
const reservations = rawReservations.map(r => { const reservations = rawReservations.map(formatReservationDates);
const st = r.start_time.includes('T') ? r.start_time.split('T')[1].substring(0, 5) : r.start_time;
const et = r.end_time.includes('T') ? r.end_time.split('T')[1].substring(0, 5) : r.end_time; // Agrupar en franjas horarias reales (Time Slots) para que cada reserva aparezca agrupada y una sola vez
const isVirt = Boolean(r.is_virtual || (r.classroom && r.classroom.is_virtual)); const slotsMap = new Map();
return { reservations.forEach(r => {
...r, const slotKey = `${r.start_time} - ${r.end_time}`;
start_time: st, if (!slotsMap.has(slotKey)) {
end_time: et, slotsMap.set(slotKey, {
subject_name: r.subject_name || r.purpose || 'Clase Regular', key: slotKey,
subject_code: r.subject_code || '', start_time: r.start_time,
effective_virtual_link: r.effective_virtual_link || r.virtual_link || '', end_time: r.end_time,
is_virtual: isVirt, time_display: r.time_display,
classroom: r.classroom || { code: r.classroom_name || (isVirt ? 'VIRTUAL' : 'Sin Aula'), floor: isVirt ? 0 : 1, is_virtual: isVirt }, duration_display: r.duration_display,
user: r.user || { name: r.teacher_name || 'Docente' } shift: r.shift,
}; items: []
});
}
slotsMap.get(slotKey).items.push({
reservation: r,
classroom: r.classroom,
commission: r.commission,
user: r.user
});
}); });
// Build time_blocks for hours 7 to 21 // Ordenar slots cronológicamente por horario de inicio y fin
const grouped_slots = Array.from(slotsMap.values()).sort((a, b) => {
return a.start_time.localeCompare(b.start_time) || a.end_time.localeCompare(b.end_time);
});
// Mantener time_blocks por compatibilidad (asigna a la hora de inicio sin duplicar)
const time_blocks = {}; const time_blocks = {};
for (let hour = 7; hour <= 21; hour++) { for (let hour = 7; hour <= 21; hour++) {
time_blocks[hour] = []; time_blocks[hour] = [];
} }
reservations.forEach(r => { reservations.forEach(r => {
const startHour = parseInt(r.start_time.split(':')[0], 10) || 8; const startHour = parseInt(r.start_time.split(':')[0], 10) || 8;
const endHour = parseInt(r.end_time.split(':')[0], 10) || (startHour + 2); if (time_blocks[startHour]) {
for (let h = Math.max(7, startHour); h <= Math.min(21, endHour - 1); h++) { time_blocks[startHour].push({
time_blocks[h].push({
reservation: r, reservation: r,
classroom: r.classroom, classroom: r.classroom,
commission: r.commission, commission: r.commission,
@@ -217,7 +376,7 @@ const handleTodaySchedule = async (req, res) => {
} }
}); });
// Compute stats // Computar estadísticas
const confirmed = reservations.filter(r => r.status === 'CONFIRMED').length; const confirmed = reservations.filter(r => r.status === 'CONFIRMED').length;
const pending = reservations.filter(r => r.status === 'PENDING').length; const pending = reservations.filter(r => r.status === 'PENDING').length;
const occupied_classrooms = new Set(reservations.map(r => r.classroom_id).filter(Boolean)).size; const occupied_classrooms = new Set(reservations.map(r => r.classroom_id).filter(Boolean)).size;
@@ -235,9 +394,13 @@ const handleTodaySchedule = async (req, res) => {
res.render('schedule/today', { res.render('schedule/today', {
title: 'Cartelera del Día - Edu-Space Admin', title: 'Cartelera del Día - Edu-Space Admin',
reservations, reservations,
grouped_slots,
time_blocks, time_blocks,
stats, stats,
today: todayStr, today: todayStr,
prev_date: prevDateStr,
next_date: nextDateStr,
default_today: defaultTodayStr,
hide_virtual, hide_virtual,
floor_filter, floor_filter,
shift_filter, shift_filter,
@@ -246,12 +409,17 @@ const handleTodaySchedule = async (req, res) => {
}); });
} catch (error) { } catch (error) {
console.error('Error fetching today reservations:', error.message); console.error('Error fetching today reservations:', error.message);
const fallbackToday = new Date().toISOString().split('T')[0];
res.render('schedule/today', { res.render('schedule/today', {
title: 'Cartelera del Día (Offline)', title: 'Cartelera del Día (Offline)',
reservations: [], reservations: [],
grouped_slots: [],
time_blocks: {}, time_blocks: {},
stats: { total_reservations: 0, confirmed: 0, pending: 0, occupied_classrooms: 0, total_classrooms: 59 }, stats: { total_reservations: 0, confirmed: 0, pending: 0, occupied_classrooms: 0, total_classrooms: 59 },
today: '2026-09-18', today: fallbackToday,
prev_date: fallbackToday,
next_date: fallbackToday,
default_today: fallbackToday,
hide_virtual: false, hide_virtual: false,
floor_filter: '', floor_filter: '',
shift_filter: '', shift_filter: '',
@@ -264,6 +432,87 @@ const handleTodaySchedule = async (req, res) => {
router.get('/today', handleTodaySchedule); router.get('/today', handleTodaySchedule);
router.get('/today_schedule', handleTodaySchedule); router.get('/today_schedule', handleTodaySchedule);
// Exportar cartelera a CSV compatible con Excel (UTF-8 con BOM)
const handleExportScheduleCsv = async (req, res) => {
try {
const dateStr = req.query.date || new Date().toISOString().split('T')[0];
const params = { start_date: dateStr, end_date: dateStr };
if (req.query.hide_virtual === '1') params.hide_virtual = '1';
if (req.query.floor) params.floor = req.query.floor;
if (req.query.shift) params.shift = req.query.shift;
const response = await req.apiClient.get('/reservations', { params });
const rawReservations = (response.data && response.data.reservations) || [];
const reservations = rawReservations.map(formatReservationDates);
reservations.sort((a, b) => (a.start_time || '').localeCompare(b.start_time || ''));
const headers = [
'Fecha',
'Horario',
'Turno',
'Aula / Espacio',
'Piso / Sede',
'Modalidad',
'Materia',
'Código Materia',
'Comisión',
'Carrera',
'Docente / Cátedra',
'Alumnos Estimados',
'Estado',
'Enlace Virtual'
];
const escapeCsv = (val) => {
if (val === null || val === undefined) return '""';
const s = String(val).replace(/"/g, '""');
return `"${s}"`;
};
const rows = reservations.map(r => {
const isVirtual = Boolean(r.virtual_link || (r.classroom_name && r.classroom_name.includes('VIRTUAL')));
const roomName = r.classroom_name || (r.classroom ? r.classroom.code : 'Aula');
const building = (r.classroom && r.classroom.building) || 'Sede Central';
const subjectName = r.subject_name || r.purpose || 'Clase Regular';
const subjectCode = r.subject_code || (r.commission && r.commission.subject_code) || '';
const commissionCode = (r.commission && r.commission.code) || r.commission_code || '';
const careerName = (r.commission && r.commission.career_names) || (r.commission && r.commission.career_name) || r.career_names || r.career_name || '';
const teacherName = r.teacher_name || (r.user ? r.user.full_name : '');
const virtualLink = r.effective_virtual_link || r.virtual_link || '';
return [
escapeCsv(r.date_display || dateStr),
escapeCsv(r.time_display || `${r.start_time} - ${r.end_time}`),
escapeCsv(r.shift || 'Mañana'),
escapeCsv(roomName),
escapeCsv(building),
escapeCsv(isVirtual ? 'Virtual' : 'Presencial'),
escapeCsv(subjectName),
escapeCsv(subjectCode),
escapeCsv(commissionCode),
escapeCsv(careerName),
escapeCsv(teacherName),
escapeCsv(r.expected_attendees || 30),
escapeCsv(r.status || 'CONFIRMED'),
escapeCsv(virtualLink)
].join(';');
});
// BOM UTF-8 (\uFEFF) para abrir directamente en Microsoft Excel sin problemas de encoding
const csvContent = '\uFEFF' + [headers.join(';'), ...rows].join('\r\n');
res.setHeader('Content-Type', 'text/csv; charset=utf-8');
res.setHeader('Content-Disposition', `attachment; filename="cartelera_unicaba_${dateStr}.csv"`);
res.status(200).send(csvContent);
} catch (error) {
console.error('Error generating schedule CSV:', error.message);
res.status(500).send('Error al exportar la cartelera');
}
};
router.get('/export_csv', handleExportScheduleCsv);
const { createFormMock } = require('../utils/formHelper'); const { createFormMock } = require('../utils/formHelper');
// 5. Vista de Crear Reserva // 5. Vista de Crear Reserva
@@ -377,11 +626,18 @@ const handleAddReservation = async (req, res) => {
commission_id: commissionOptions commission_id: commissionOptions
}); });
const classroomDataMap = {};
classroomList.forEach(c => { classroomDataMap[c.id] = c; });
const commissionDataMap = {};
commissionList.forEach(c => { commissionDataMap[c.id] = c; });
res.render('schedule/add', { res.render('schedule/add', {
title: 'New Reservation - Edu-Space Admin', title: 'New Reservation - Edu-Space Admin',
form, form,
classroom_list: classroomList, classroom_list: classroomList,
commission_list: commissionList, commission_list: commissionList,
classroom_data_json: JSON.stringify(classroomDataMap),
commission_data_json: JSON.stringify(commissionDataMap),
buildings: Array.from(buildingsMap.values()), buildings: Array.from(buildingsMap.values()),
initial_commission_id: initialCommissionId, initial_commission_id: initialCommissionId,
initial_classroom_id: initialClassroomId initial_classroom_id: initialClassroomId
@@ -444,9 +700,11 @@ const handleViewReservation = async (req, res) => {
const response = await req.apiClient.get(`/reservations/${id}`); const response = await req.apiClient.get(`/reservations/${id}`);
const r = response.data; const r = response.data;
const formatted = formatReservationDates(r);
const resObj = { const resObj = {
...r, ...r,
...formatted,
status: { status: {
value: (r.status || 'CONFIRMED').toUpperCase(), value: (r.status || 'CONFIRMED').toUpperCase(),
toString: () => (r.status || 'CONFIRMED').toUpperCase() toString: () => (r.status || 'CONFIRMED').toUpperCase()
@@ -584,12 +842,19 @@ const handleEditReservation = async (req, res) => {
commission_id: commissionOptions commission_id: commissionOptions
}); });
const classroomDataMap = {};
classroomList.forEach(c => { classroomDataMap[c.id] = c; });
const commissionDataMap = {};
commissionList.forEach(c => { commissionDataMap[c.id] = c; });
res.render('schedule/edit', { res.render('schedule/edit', {
title: `Modificar Reserva #${id} - Edu-Space Admin`, title: `Modificar Reserva #${id} - Edu-Space Admin`,
reservation, reservation,
form, form,
classroom_list: classroomList, classroom_list: classroomList,
commission_list: commissionList, commission_list: commissionList,
classroom_data_json: JSON.stringify(classroomDataMap),
commission_data_json: JSON.stringify(commissionDataMap),
buildings: Array.from(buildingsMap.values()) buildings: Array.from(buildingsMap.values())
}); });
} catch (error) { } catch (error) {
+315 -47
View File
@@ -1,39 +1,53 @@
{% extends "base.html" %} {% extends "base.html" %}
{% block title %}Bitácora de Auditoría - Edu-Space Admin{% endblock %} {% block title %}Registro de Auditoría Institucional - Edu-Space Admin{% endblock %}
{% block content %} {% block content %}
<div class="container-fluid pt-5 mt-4"> <div class="container-fluid pt-5 mt-4">
<!-- Header --> <!-- Header Institucional -->
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2"> <div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
<div> <div>
<h1 class="h3 mb-1"> <h1 class="h3 mb-1">
<i class="bi bi-shield-check text-primary me-2"></i>Registro de Auditoría Institucional <i class="bi bi-shield-check text-primary me-2"></i>Registro de Auditoría Institucional
</h1> </h1>
<p class="text-muted small mb-0">Trazabilidad completa de operaciones, modificaciones y eventos de seguridad</p> <p class="text-muted small mb-0">Trazabilidad inmutable de inicios de sesión, cambios en espacios, reservas y operaciones del sistema</p>
</div> </div>
<div> <div class="d-flex gap-2">
<a href="/main/dashboard" class="btn btn-outline-secondary btn-sm"> <a href="/admin/audit_logs" class="btn btn-outline-secondary btn-sm" title="Recargar eventos">
<i class="bi bi-arrow-clockwise me-1"></i>Actualizar
</a>
<a href="/main/dashboard" class="btn btn-outline-primary btn-sm">
<i class="bi bi-arrow-left me-1"></i>Volver al Panel <i class="bi bi-arrow-left me-1"></i>Volver al Panel
</a> </a>
</div> </div>
</div> </div>
<!-- Filtros --> <!-- Filtros y Búsqueda -->
<div class="card border-0 shadow-sm mb-4"> <div class="card border-0 shadow-sm mb-4">
<div class="card-body p-3"> <div class="card-body p-3">
<form method="GET" action="/admin/audit_logs" class="row g-2 align-items-center"> <form method="GET" action="/admin/audit_logs" class="row g-2 align-items-center">
<div class="col-md-4"> <div class="col-md-4">
<div class="input-group input-group-sm"> <div class="input-group input-group-sm">
<span class="input-group-text bg-transparent"><i class="bi bi-search"></i></span> <span class="input-group-text bg-transparent"><i class="bi bi-search"></i></span>
<input type="text" name="search" class="form-control" placeholder="Buscar por email, IP o detalles..." value="{{ search }}"> <input type="text" name="search" class="form-control" placeholder="Buscar por usuario, IP, acción o detalle..." value="{{ search }}">
</div> </div>
</div> </div>
<div class="col-md-3"> <div class="col-md-3">
<select name="module" class="form-select form-select-sm"> <select name="module" class="form-select form-select-sm">
<option value="">Todos los módulos</option> <option value="">Todos los módulos</option>
{% for mod in modules %} {% for mod in modules %}
<option value="{{ mod }}" {% if current_module == mod %}selected{% endif %}>{{ mod|capitalize }}</option> <option value="{{ mod }}" {% if current_module == mod %}selected{% endif %}>
{% if mod == 'auth' %}Autenticación y Sesiones
{% elif mod == 'reservations' %}Reservas de Aulas
{% elif mod == 'classrooms' %}Gestión de Aulas
{% elif mod == 'buildings' %}Sedes y Edificios
{% elif mod == 'optimizer' %}Optimizador Genético IA
{% elif mod == 'users' %}Usuarios y Roles
{% elif mod == 'academic' %}Ciclos y Carreras
{% elif mod == 'admin' %}Sistema y Reinicio
{% else %}{{ mod|capitalize }}
{% endif %}
</option>
{% endfor %} {% endfor %}
</select> </select>
</div> </div>
@@ -41,13 +55,34 @@
<select name="action" class="form-select form-select-sm"> <select name="action" class="form-select form-select-sm">
<option value="">Todas las acciones</option> <option value="">Todas las acciones</option>
{% for act in actions %} {% for act in actions %}
<option value="{{ act }}" {% if current_action == act %}selected{% endif %}>{{ act }}</option> <option value="{{ act }}" {% if current_action == act %}selected{% endif %}>
{% if act == 'LOGIN' %}Inicio de Sesión (Local)
{% elif act == 'LOGIN_GOOGLE' %}Inicio de Sesión (Google)
{% elif act == 'LOGIN_MOODLE' %}Inicio de Sesión (Moodle)
{% elif act == 'LOGIN_FAILED' %}Inicio de Sesión Fallido
{% elif act == 'LOGIN_BLOCKED' %}Acceso Bloqueado
{% elif act == 'LOGOUT' %}Cierre de Sesión
{% elif act == 'PASSWORD_CHANGE' %}Cambio de Contraseña
{% elif act == 'IMPERSONATE_START' %}Inicio Impersonación
{% elif act == 'IMPERSONATE_END' %}Fin Impersonación
{% elif act == 'CREATE' %}Creación (Alta)
{% elif act == 'UPDATE' %}Modificación (Edición)
{% elif act == 'DELETE' %}Eliminación (Baja)
{% elif act == 'CANCEL' %}Cancelación
{% elif act == 'CONFIRM' %}Confirmación
{% elif act == 'TOGGLE' %}Alternar Estado
{% elif act == 'OPTIMIZE_RUN' %}Ejecución Optimizador IA
{% elif act == 'OPTIMIZE_APPLY' %}Aplicación Optimizador IA
{% elif act == 'SYSTEM_RESET' %}Reinicio del Sistema
{% else %}{{ act }}
{% endif %}
</option>
{% endfor %} {% endfor %}
</select> </select>
</div> </div>
<div class="col-md-2 d-flex gap-1"> <div class="col-md-2 d-flex gap-1">
<button type="submit" class="btn btn-primary btn-sm flex-grow-1"> <button type="submit" class="btn btn-primary btn-sm flex-grow-1">
<i class="bi bi-filter me-1"></i>Filtrar <i class="bi bi-funnel me-1"></i>Filtrar
</button> </button>
{% if search or current_module or current_action %} {% if search or current_module or current_action %}
<a href="/admin/audit_logs" class="btn btn-outline-secondary btn-sm" title="Limpiar filtros"> <a href="/admin/audit_logs" class="btn btn-outline-secondary btn-sm" title="Limpiar filtros">
@@ -56,58 +91,195 @@
{% endif %} {% endif %}
</div> </div>
</form> </form>
<!-- Acceso Rápido por Categorías -->
<div class="d-flex flex-wrap gap-1 mt-3 pt-2 border-top">
<span class="text-muted small align-self-center me-2"><i class="bi bi-lightning-charge me-1"></i>Filtros rápidos:</span>
<a href="/admin/audit_logs?module=auth" class="badge rounded-pill text-decoration-none {% if current_module == 'auth' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-key me-1"></i>Sesiones y Accesos
</a>
<a href="/admin/audit_logs?action=LOGIN_FAILED" class="badge rounded-pill text-decoration-none {% if current_action == 'LOGIN_FAILED' %}bg-danger text-white{% else %}bg-light text-danger border{% endif %}">
<i class="bi bi-shield-x me-1"></i>Fallos de Login
</a>
<a href="/admin/audit_logs?module=reservations" class="badge rounded-pill text-decoration-none {% if current_module == 'reservations' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-calendar-event me-1"></i>Reservas
</a>
<a href="/admin/audit_logs?module=classrooms" class="badge rounded-pill text-decoration-none {% if current_module == 'classrooms' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-door-open me-1"></i>Aulas
</a>
<a href="/admin/audit_logs?module=buildings" class="badge rounded-pill text-decoration-none {% if current_module == 'buildings' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-building me-1"></i>Sedes
</a>
<a href="/admin/audit_logs?module=optimizer" class="badge rounded-pill text-decoration-none {% if current_module == 'optimizer' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-cpu me-1"></i>Optimizador IA
</a>
</div>
</div> </div>
</div> </div>
<!-- Tabla de Auditoría --> <!-- Tabla de Auditoría -->
<div class="card border-0 shadow-sm"> <div class="card border-0 shadow-sm">
<div class="card-body p-0"> <div class="card-body p-0">
{% if audit_logs %} {% if audit_logs and audit_logs.length > 0 %}
<div class="table-responsive"> <div class="table-responsive">
<table class="table table-hover align-middle mb-0"> <table class="table table-hover align-middle mb-0">
<thead class="table-light small text-uppercase"> <thead class="table-light small text-uppercase">
<tr> <tr>
<th class="ps-3">Fecha / Hora</th> <th class="ps-3" style="width: 170px;">Fecha / Hora</th>
<th>Usuario</th> <th style="min-width: 180px;">Usuario</th>
<th>Acción</th> <th style="width: 160px;">Acción</th>
<th>Módulo</th> <th style="width: 130px;">Módulo</th>
<th>ID Entidad</th> <th style="width: 90px;">ID</th>
<th>Detalles</th> <th>Detalles de la Operación</th>
<th class="pe-3">IP</th> <th class="pe-3 text-end" style="width: 130px;">IP Origen</th>
</tr> </tr>
</thead> </thead>
<tbody> <tbody>
{% for log in audit_logs %} {% for log in audit_logs %}
<tr> <tr>
<td class="ps-3 text-nowrap"> <td class="ps-3 text-nowrap">
<span class="small font-monospace">{{ log.created_at }}</span> <span class="small font-monospace text-dark fw-semibold">
{{ log.created_at or log.created_at_iso or '-' }}
</span>
</td> </td>
<td> <td>
<div class="fw-semibold small">{{ log.user_email or 'Sistema' }}</div> <div class="d-flex align-items-center gap-2">
<div class="avatar-sm rounded-circle d-flex align-items-center justify-content-center small {% if 'FAILED' in log.action or 'BLOCKED' in log.action %}bg-danger-subtle text-danger{% elif 'LOGIN' in log.action %}bg-success-subtle text-success{% else %}bg-primary-subtle text-primary{% endif %}" style="width: 28px; height: 28px;">
{% if 'LOGIN' in log.action %}
<i class="bi bi-person-check"></i>
{% elif 'FAILED' in log.action %}
<i class="bi bi-person-x"></i>
{% elif 'IMPERSONATE' in log.action %}
<i class="bi bi-person-badge"></i>
{% else %}
<i class="bi bi-person"></i>
{% endif %}
</div>
<div>
<div class="fw-semibold small text-truncate" style="max-width: 200px;" title="{{ log.user_email or 'Sistema' }}">
{{ log.user_email or 'Sistema' }}
</div>
{% if log.user_id %}
<span class="text-muted" style="font-size: 0.75rem;">ID Usuario: #{{ log.user_id }}</span>
{% endif %}
</div>
</div>
</td> </td>
<td> <td>
{% if log.action == 'CREATE' %} {% if log.action == 'CREATE' %}
<span class="badge bg-success-subtle text-success border border-success-subtle">{{ log.action }}</span> <span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
<i class="bi bi-plus-circle me-1"></i>ALTA
</span>
{% elif log.action == 'UPDATE' %} {% elif log.action == 'UPDATE' %}
<span class="badge bg-primary-subtle text-primary border border-primary-subtle">{{ log.action }}</span> <span class="badge bg-primary-subtle text-primary border border-primary-subtle px-2 py-1">
<i class="bi bi-pencil-square me-1"></i>EDICIÓN
</span>
{% elif log.action == 'DELETE' %} {% elif log.action == 'DELETE' %}
<span class="badge bg-danger-subtle text-danger border border-danger-subtle">{{ log.action }}</span> <span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
{% elif 'LOGIN' in log.action %} <i class="bi bi-trash me-1"></i>BAJA
<span class="badge bg-info-subtle text-info border border-info-subtle">{{ log.action }}</span> </span>
{% elif log.action == 'CANCEL' %}
<span class="badge bg-warning-subtle text-warning-emphasis border border-warning-subtle px-2 py-1">
<i class="bi bi-dash-circle me-1"></i>CANCELACIÓN
</span>
{% elif log.action == 'CONFIRM' %}
<span class="badge bg-info-subtle text-info-emphasis border border-info-subtle px-2 py-1">
<i class="bi bi-check-circle me-1"></i>CONFIRMADA
</span>
{% elif log.action == 'TOGGLE' %}
<span class="badge bg-secondary-subtle text-secondary border px-2 py-1">
<i class="bi bi-toggle-on me-1"></i>ESTADO
</span>
{% elif log.action == 'LOGIN' %}
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
<i class="bi bi-box-arrow-in-right me-1"></i>LOGIN LOCAL
</span>
{% elif log.action == 'LOGIN_GOOGLE' %}
<span class="badge bg-info-subtle text-primary border border-info-subtle px-2 py-1">
<i class="bi bi-google me-1"></i>LOGIN GOOGLE
</span>
{% elif log.action == 'LOGIN_MOODLE' %}
<span class="badge bg-warning-subtle text-dark border border-warning-subtle px-2 py-1">
<i class="bi bi-mortarboard me-1"></i>LOGIN MOODLE
</span>
{% elif log.action == 'LOGIN_FAILED' %}
<span class="badge bg-danger text-white px-2 py-1">
<i class="bi bi-shield-x me-1"></i>LOGIN FALLIDO
</span>
{% elif log.action == 'LOGIN_BLOCKED' %}
<span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
<i class="bi bi-slash-circle me-1"></i>BLOQUEADO
</span>
{% elif log.action == 'LOGOUT' %}
<span class="badge bg-secondary-subtle text-secondary border px-2 py-1">
<i class="bi bi-box-arrow-right me-1"></i>LOGOUT
</span>
{% elif log.action == 'PASSWORD_CHANGE' %}
<span class="badge bg-purple-subtle text-purple border px-2 py-1" style="background-color: #f3e8ff; color: #6b21a8;">
<i class="bi bi-key me-1"></i>CAMBIO CLAVE
</span>
{% elif log.action == 'IMPERSONATE_START' %}
<span class="badge bg-warning text-dark px-2 py-1">
<i class="bi bi-person-badge me-1"></i>IMPERSONACIÓN
</span>
{% elif log.action == 'IMPERSONATE_END' %}
<span class="badge bg-light text-dark border px-2 py-1">
<i class="bi bi-person-check me-1"></i>FIN IMPERSON.
</span>
{% elif log.action == 'OPTIMIZE_RUN' %}
<span class="badge bg-info text-white px-2 py-1">
<i class="bi bi-cpu me-1"></i>CORRIDA IA
</span>
{% elif log.action == 'OPTIMIZE_APPLY' %}
<span class="badge bg-success text-white px-2 py-1">
<i class="bi bi-magic me-1"></i>APLICACIÓN IA
</span>
{% elif log.action == 'SYSTEM_RESET' %}
<span class="badge bg-danger text-white px-2 py-1">
<i class="bi bi-arrow-counterclockwise me-1"></i>REINICIO SISTEMA
</span>
{% else %} {% else %}
<span class="badge bg-secondary-subtle text-secondary border">{{ log.action }}</span> <span class="badge bg-secondary-subtle text-secondary border px-2 py-1">{{ log.action }}</span>
{% endif %} {% endif %}
</td> </td>
<td> <td>
<span class="badge bg-body-secondary text-body border font-monospace small">{{ log.module }}</span> {% if log.module == 'auth' %}
<span class="badge bg-primary-subtle text-primary border font-monospace small">auth</span>
{% elif log.module == 'reservations' %}
<span class="badge bg-info-subtle text-info border font-monospace small">reservas</span>
{% elif log.module == 'classrooms' %}
<span class="badge bg-success-subtle text-success border font-monospace small">aulas</span>
{% elif log.module == 'buildings' %}
<span class="badge bg-warning-subtle text-dark border font-monospace small">sedes</span>
{% elif log.module == 'optimizer' %}
<span class="badge bg-dark text-white font-monospace small">optimizador</span>
{% else %}
<span class="badge bg-body-secondary text-body border font-monospace small">{{ log.module }}</span>
{% endif %}
</td> </td>
<td class="font-monospace small text-muted"> <td class="font-monospace small text-muted">
{{ log.entity_id or '-' }} {{ log.entity_id or '-' }}
</td> </td>
<td class="small text-muted" style="max-width: 320px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;" title="{{ log.details }}"> <td>
{{ log.details or '-' }} <div class="d-flex align-items-center justify-content-between gap-2">
<div class="small text-muted text-truncate" style="max-width: 480px;" title="{{ log.details }}">
{{ log.details or '-' }}
</div>
{% if log.details and log.details.length > 50 %}
<button type="button" class="btn btn-link btn-sm p-0 text-decoration-none text-primary btn-view-log-detail"
data-log-id="{{ log.id }}"
data-log-action="{{ log.action }}"
data-log-module="{{ log.module }}"
data-log-user="{% if log.user_email %}{{ log.user_email }}{% else %}Sistema{% endif %}"
data-log-time="{{ log.created_at }}"
data-log-ip="{{ log.ip_address or '-' }}"
data-log-details="{{ log.details | escape }}">
<i class="bi bi-eye"></i>
</button>
{% endif %}
</div>
</td> </td>
<td class="pe-3 font-monospace small text-muted"> <td class="pe-3 text-end font-monospace small text-muted">
{{ log.ip_address or '-' }} {{ log.ip_address or '-' }}
</td> </td>
</tr> </tr>
@@ -116,31 +288,29 @@
</table> </table>
</div> </div>
<!-- Paginación --> <!-- Paginación Dinámica -->
{% if pagination.pages > 1 %} {% if pagination.pages > 1 %}
<div class="p-3 border-top d-flex justify-content-between align-items-center"> <div class="p-3 border-top d-flex justify-content-between align-items-center flex-wrap gap-2">
<small class="text-muted"> <small class="text-muted">
Mostrando página {{ pagination.page }} de {{ pagination.pages }} ({{ pagination.total }} registros) Mostrando página {{ pagination.page }} de {{ pagination.pages }} (Total: <strong>{{ pagination.total }}</strong> eventos registrados)
</small> </small>
<nav> <nav aria-label="Navegación de auditoría">
<ul class="pagination pagination-sm mb-0"> <ul class="pagination pagination-sm mb-0">
<li class="page-item {% if not pagination.has_prev %}disabled{% endif %}"> <li class="page-item {% if not pagination.has_prev %}disabled{% endif %}">
<a class="page-link" href="/admin/audit_logs"> <a class="page-link" href="/admin/audit_logs?page={{ pagination.page - 1 }}{% if search %}&search={{ search }}{% endif %}{% if current_module %}&module={{ current_module }}{% endif %}{% if current_action %}&action={{ current_action }}{% endif %}">
&laquo; &laquo; Anterior
</a> </a>
</li> </li>
{% for p in pagination.iter_pages(left_edge=2, left_current=2, right_current=3, right_edge=2) %} {% for p in pagination.pages_list %}
{% if p %} <li class="page-item {% if p == pagination.page %}active{% endif %}">
<li class="page-item {% if p == pagination.page %}active{% endif %}"> <a class="page-link" href="/admin/audit_logs?page={{ p }}{% if search %}&search={{ search }}{% endif %}{% if current_module %}&module={{ current_module }}{% endif %}{% if current_action %}&action={{ current_action }}{% endif %}">
<a class="page-link" href="/admin/audit_logs">{{ p }}</a> {{ p }}
</li> </a>
{% else %} </li>
<li class="page-item disabled"><span class="page-link">…</span></li>
{% endif %}
{% endfor %} {% endfor %}
<li class="page-item {% if not pagination.has_next %}disabled{% endif %}"> <li class="page-item {% if not pagination.has_next %}disabled{% endif %}">
<a class="page-link" href="/admin/audit_logs"> <a class="page-link" href="/admin/audit_logs?page={{ pagination.page + 1 }}{% if search %}&search={{ search }}{% endif %}{% if current_module %}&module={{ current_module }}{% endif %}{% if current_action %}&action={{ current_action }}{% endif %}">
&raquo; Siguiente &raquo;
</a> </a>
</li> </li>
</ul> </ul>
@@ -152,10 +322,108 @@
<div class="text-center py-5"> <div class="text-center py-5">
<i class="bi bi-shield-slash text-muted fs-1 d-block mb-2"></i> <i class="bi bi-shield-slash text-muted fs-1 d-block mb-2"></i>
<h6 class="fw-bold">No se encontraron registros de auditoría</h6> <h6 class="fw-bold">No se encontraron registros de auditoría</h6>
<p class="text-muted small">Los eventos del sistema se registrarán automáticamente a medida que ocurran cambios.</p> <p class="text-muted small">Los eventos de inicio de sesión y modificaciones de espacios áulicos se registrarán automáticamente a medida que ocurran.</p>
{% if search or current_module or current_action %}
<a href="/admin/audit_logs" class="btn btn-outline-primary btn-sm mt-2">
<i class="bi bi-x-circle me-1"></i>Limpiar filtros de búsqueda
</a>
{% endif %}
</div> </div>
{% endif %} {% endif %}
</div> </div>
</div> </div>
</div> </div>
<!-- Modal de Detalle Extendido -->
<div class="modal fade" id="logDetailModal" tabindex="-1" aria-labelledby="logDetailModalLabel" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered modal-lg">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="logDetailModalLabel">
<i class="bi bi-info-circle text-primary me-2"></i>Detalle del Registro de Auditoría
</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Cerrar"></button>
</div>
<div class="modal-body">
<div class="row g-2 mb-3 small">
<div class="col-sm-6">
<span class="text-muted">Fecha y Hora:</span>
<div class="fw-semibold font-monospace" id="modalLogTime">-</div>
</div>
<div class="col-sm-6">
<span class="text-muted">Usuario Actuante:</span>
<div class="fw-semibold" id="modalLogUser">-</div>
</div>
<div class="col-sm-4">
<span class="text-muted">Acción:</span>
<div class="fw-semibold" id="modalLogAction">-</div>
</div>
<div class="col-sm-4">
<span class="text-muted">Módulo:</span>
<div class="fw-semibold" id="modalLogModule">-</div>
</div>
<div class="col-sm-4">
<span class="text-muted">IP de Conexión:</span>
<div class="fw-semibold font-monospace" id="modalLogIp">-</div>
</div>
</div>
<div>
<label class="form-label small fw-semibold text-muted">Contenido del Evento / Payload:</label>
<pre class="bg-light p-3 rounded border font-monospace small mb-0" id="modalLogDetails" style="max-height: 300px; overflow-y: auto; white-space: pre-wrap; word-break: break-word;"></pre>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-outline-secondary btn-sm" onclick="copyModalDetails()">
<i class="bi bi-clipboard me-1"></i>Copiar Detalle
</button>
<button type="button" class="btn btn-secondary btn-sm" data-bs-dismiss="modal">Cerrar</button>
</div>
</div>
</div>
</div>
<script>
function showLogDetailModal(id, action, module, user, time, ip, details) {
document.getElementById('modalLogTime').textContent = time || '-';
document.getElementById('modalLogUser').textContent = user || 'Sistema';
document.getElementById('modalLogAction').textContent = action || '-';
document.getElementById('modalLogModule').textContent = module || '-';
document.getElementById('modalLogIp').textContent = ip || '-';
let formatted = details || '';
try {
const parsed = JSON.parse(details);
formatted = JSON.stringify(parsed, null, 2);
} catch(e) {
// es texto plano
}
document.getElementById('modalLogDetails').textContent = formatted;
const modal = new bootstrap.Modal(document.getElementById('logDetailModal'));
modal.show();
}
function copyModalDetails() {
const text = document.getElementById('modalLogDetails').textContent;
navigator.clipboard.writeText(text).then(() => {
alert('Detalle copiado al portapapeles.');
});
}
document.addEventListener('DOMContentLoaded', function() {
document.querySelectorAll('.btn-view-log-detail').forEach(function(btn) {
btn.addEventListener('click', function() {
showLogDetailModal(
this.dataset.logId,
this.dataset.logAction,
this.dataset.logModule,
this.dataset.logUser,
this.dataset.logTime,
this.dataset.logIp,
this.dataset.logDetails
);
});
});
});
</script>
{% endblock %} {% endblock %}
+41 -35
View File
@@ -158,41 +158,6 @@
</button> </button>
{% endif %} {% endif %}
</div> </div>
<!-- Modal Editar Carrera -->
<div class="modal fade text-start" id="modalEditCareer{{ career.id }}" tabindex="-1" aria-hidden="true">
<div class="modal-dialog">
<div class="modal-content">
<form method="POST" action="/admin/career_edit">
<input type="hidden" name="id" value="{{ career.id }}">
<div class="modal-header">
<h5 class="modal-title h6 fw-bold">
<i class="bi bi-pencil-square text-primary me-2"></i>Editar Carrera
</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label class="form-label small fw-semibold">Nombre de la Carrera *</label>
<input type="text" name="name" class="form-control" value="{{ career.name }}" required>
</div>
<div class="mb-3">
<label class="form-label small fw-semibold">Código / Sigla</label>
<input type="text" name="code" class="form-control" value="{{ career.code or '' }}" placeholder="ej. LIC-SIS, PUEP">
</div>
<div class="mb-3">
<label class="form-label small fw-semibold">Descripción</label>
<textarea name="description" class="form-control" rows="3">{{ career.description or '' }}</textarea>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-sm btn-secondary" data-bs-dismiss="modal">Cancelar</button>
<button type="submit" class="btn btn-sm btn-primary">Guardar Cambios</button>
</div>
</form>
</div>
</div>
</div>
</td> </td>
{% endif %} {% endif %}
</tr> </tr>
@@ -210,6 +175,47 @@
</div> </div>
</div> </div>
<!-- Modales de Edición de Carreras (Colocados fuera de la tabla para evitar conflictos de stacking context en Bootstrap) -->
{% if can_edit %}
{% for career in careers %}
<div class="modal fade text-start" id="modalEditCareer{{ career.id }}" tabindex="-1" aria-labelledby="modalEditCareerLabel{{ career.id }}" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content shadow border-0">
<form method="POST" action="/admin/career_edit">
<input type="hidden" name="id" value="{{ career.id }}">
<div class="modal-header">
<h5 class="modal-title h6 fw-bold" id="modalEditCareerLabel{{ career.id }}">
<i class="bi bi-pencil-square text-primary me-2"></i>Editar Carrera
</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body">
<div class="mb-3">
<label class="form-label small fw-semibold">Nombre de la Carrera *</label>
<input type="text" name="name" class="form-control" value="{{ career.name }}" required>
</div>
<div class="mb-3">
<label class="form-label small fw-semibold">Código / Sigla</label>
<input type="text" name="code" class="form-control font-monospace" value="{{ career.code or '' }}" placeholder="ej. LIC-SIS, PUEP">
</div>
<div class="mb-3">
<label class="form-label small fw-semibold">Descripción</label>
<textarea name="description" class="form-control" rows="3">{{ career.description or '' }}</textarea>
</div>
</div>
<div class="modal-footer bg-light py-2">
<button type="button" class="btn btn-sm btn-secondary" data-bs-dismiss="modal">Cancelar</button>
<button type="submit" class="btn btn-sm btn-primary">
<i class="bi bi-check-lg me-1"></i>Guardar Cambios
</button>
</div>
</form>
</div>
</div>
</div>
{% endfor %}
{% endif %}
<!-- Modal Nueva Carrera --> <!-- Modal Nueva Carrera -->
{% if can_edit %} {% if can_edit %}
<div class="modal fade" id="modalAddCareer" tabindex="-1" aria-hidden="true"> <div class="modal fade" id="modalAddCareer" tabindex="-1" aria-hidden="true">
+6 -3
View File
@@ -65,9 +65,12 @@
</div> </div>
<div class="card-body"> <div class="card-body">
<h5 class="fw-bold mb-1">{{ commission.subject.name }}</h5> <h5 class="fw-bold mb-1">{{ commission.subject.name }}</h5>
<p class="text-muted small mb-3">{{ commission.subject.code }} <div class="d-flex align-items-center gap-2 mb-3 flex-wrap">
{% if commission.subject.career_obj %}— {{ commission.subject.career_obj.name }}{% endif %} <span class="badge bg-secondary-subtle text-secondary font-monospace border">{{ commission.subject.code }}</span>
</p> <span class="badge bg-primary-subtle text-primary border">
<i class="bi bi-mortarboard me-1"></i>{{ commission.career_name or (commission.subject.career_obj.name if commission.subject.career_obj else 'Carrera General') }}
</span>
</div>
<div class="d-flex flex-wrap gap-2 mb-3"> <div class="d-flex flex-wrap gap-2 mb-3">
{% if commission.shift %} {% if commission.shift %}
+56 -6
View File
@@ -102,6 +102,19 @@
</div> </div>
</div> </div>
<div class="col-6 col-md-3"> <div class="col-6 col-md-3">
<label class="form-label small fw-semibold mb-1">
<i class="bi bi-mortarboard text-primary me-1"></i>Carrera
</label>
<select name="career_id" class="form-select form-select-sm" id="career-filter" onchange="this.form.submit()">
<option value="">Todas las carreras</option>
{% for car in careers %}
<option value="{{ car.id }}" {% if career_filter == car.id %}selected{% endif %}>
{{ car.name }}
</option>
{% endfor %}
</select>
</div>
<div class="col-6 col-md-2">
<label class="form-label small fw-semibold mb-1">Asignatura</label> <label class="form-label small fw-semibold mb-1">Asignatura</label>
<select name="subject_id" class="form-select form-select-sm" id="subject-filter"> <select name="subject_id" class="form-select form-select-sm" id="subject-filter">
<option value="">Todas</option> <option value="">Todas</option>
@@ -112,7 +125,7 @@
{% endfor %} {% endfor %}
</select> </select>
</div> </div>
<div class="col-6 col-md-2"> <div class="col-6 col-md-1">
<label class="form-label small fw-semibold mb-1">Turno</label> <label class="form-label small fw-semibold mb-1">Turno</label>
<select name="shift" class="form-select form-select-sm" id="shift-filter"> <select name="shift" class="form-select form-select-sm" id="shift-filter">
<option value="">Todos</option> <option value="">Todos</option>
@@ -122,6 +135,16 @@
</select> </select>
</div> </div>
<div class="col-6 col-md-2"> <div class="col-6 col-md-2">
<label class="form-label small fw-semibold mb-1">
<i class="bi bi-door-open text-primary me-1"></i>Aula / Espacio
</label>
<select name="unassigned_room" class="form-select form-select-sm" id="unassigned-room-filter">
<option value="" {% if not unassigned_room_filter %}selected{% endif %}>Todas las comisiones</option>
<option value="true" {% if unassigned_room_filter == 'true' %}selected{% endif %}>⚠️ Sin Aula Asignada</option>
<option value="false" {% if unassigned_room_filter == 'false' %}selected{% endif %}>✅ Con Aula Asignada</option>
</select>
</div>
<div class="col-6 col-md-1">
<label class="form-label small fw-semibold mb-1">Estado</label> <label class="form-label small fw-semibold mb-1">Estado</label>
<select name="active" class="form-select form-select-sm" id="active-filter"> <select name="active" class="form-select form-select-sm" id="active-filter">
<option value="true" {% if active_filter == 'true' %}selected{% endif %}>Activas</option> <option value="true" {% if active_filter == 'true' %}selected{% endif %}>Activas</option>
@@ -129,11 +152,11 @@
<option value="" {% if not active_filter %}selected{% endif %}>Todas</option> <option value="" {% if not active_filter %}selected{% endif %}>Todas</option>
</select> </select>
</div> </div>
<div class="col-6 col-md-2 d-flex gap-2"> <div class="col-12 col-md-1 d-flex gap-1">
<button type="submit" class="btn btn-primary btn-sm flex-fill" id="filter-btn"> <button type="submit" class="btn btn-primary btn-sm flex-fill" id="filter-btn" title="Aplicar filtros">
<i class="bi bi-funnel me-1"></i>Filtrar <i class="bi bi-funnel"></i>
</button> </button>
<a href="/admin/commissions_list" class="btn btn-outline-secondary btn-sm"> <a href="/admin/commissions_list" class="btn btn-outline-secondary btn-sm" title="Limpiar filtros">
<i class="bi bi-x"></i> <i class="bi bi-x"></i>
</a> </a>
</div> </div>
@@ -158,6 +181,7 @@
<tr> <tr>
<th class="ps-3">Comisión</th> <th class="ps-3">Comisión</th>
<th>Asignatura</th> <th>Asignatura</th>
<th>Espacio / Aula</th>
<th>Docente</th> <th>Docente</th>
<th class="text-center">Turno</th> <th class="text-center">Turno</th>
<th class="text-center">Alumnos</th> <th class="text-center">Alumnos</th>
@@ -177,10 +201,36 @@
<div class="fw-semibold text-primary">{{ comm.subject.name }}</div> <div class="fw-semibold text-primary">{{ comm.subject.name }}</div>
<div class="d-flex align-items-center gap-1 mt-1 flex-wrap"> <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> <span class="badge bg-secondary-subtle text-secondary border font-monospace">{{ comm.subject.code }}</span>
<span class="badge bg-body-tertiary text-muted border">{{ comm.subject.career_name or 'Carrera General' }}</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> <small class="text-muted ms-1">{{ comm.semester }} {{ comm.year }}</small>
</div> </div>
</td> </td>
<td>
{% if comm.has_classroom %}
{% if comm.is_virtual %}
<span class="badge bg-info-subtle text-info border">
<i class="bi bi-camera-video me-1"></i>{{ comm.classroom_name }}
</span>
{% if comm.virtual_link %}
<a href="{{ comm.virtual_link }}" target="_blank" class="text-info ms-1 small" title="Enlace Videoconferencia"><i class="bi bi-box-arrow-up-right"></i></a>
{% endif %}
{% else %}
<span class="badge bg-success-subtle text-success border font-monospace">
<i class="bi bi-door-open me-1"></i>{{ comm.classroom_name }}
</span>
{% endif %}
{% else %}
<span class="badge bg-danger-subtle text-danger border">
<i class="bi bi-exclamation-triangle-fill me-1"></i>Sin Aula
</span>
{% endif %}
</td>
<td> <td>
{% if comm.teachers and comm.teachers | length > 0 %} {% if comm.teachers and comm.teachers | length > 0 %}
<div class="d-flex flex-column gap-1"> <div class="d-flex flex-column gap-1">
File diff suppressed because it is too large Load Diff
+9 -1
View File
@@ -148,7 +148,15 @@
{% endif %} {% endif %}
</td> </td>
<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"> <span class="badge bg-secondary-subtle text-secondary border">
<i class="bi bi-mortarboard me-1"></i>{{ s.career_obj.name }} <i class="bi bi-mortarboard me-1"></i>{{ s.career_obj.name }}
</span> </span>
+6 -1
View File
@@ -190,7 +190,7 @@
</div> </div>
{% endif %} {% endif %}
{% if demo_access_enabled is not defined or demo_access_enabled %} {% if demo_access_enabled %}
<!-- Accesos Rápidos Institucionales (Demo) --> <!-- Accesos Rápidos Institucionales (Demo) -->
<div class="p-3 bg-body-tertiary rounded-3 border mt-3"> <div class="p-3 bg-body-tertiary rounded-3 border mt-3">
<div class="d-flex justify-content-between align-items-center mb-2"> <div class="d-flex justify-content-between align-items-center mb-2">
@@ -223,6 +223,11 @@
<i class="bi bi-shield-check text-primary me-1"></i> <i class="bi bi-shield-check text-primary me-1"></i>
Acceso institucional seguro • Actividad auditada Acceso institucional seguro • Actividad auditada
</small> </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.4.1' }} <span class="opacity-75">(FE: {{ frontend_version or '3.4.1' }} | BE: {{ backend_version or '3.4.1' }})</span>
</span>
</div>
</div> </div>
</div> </div>
</div> </div>
+167 -59
View File
@@ -900,98 +900,200 @@
<ul class="sidebar-nav" id="sidebarNav"> <ul class="sidebar-nav" id="sidebarNav">
{% set user_role = role if role else (auth_user.role if auth_user else 'admin') %} {% set user_role = role if role else (auth_user.role if auth_user else 'admin') %}
{% if user_role == 'admin' %} {% if user_role == 'admin' %}
<!-- ADMIN --> <!-- ADMINISTRADOR -->
<li class="nav-item"> <li class="nav-item">
<a class="nav-link" href="/dashboard"><i class="bi bi-speedometer2 text-primary"></i> <span class="nav-text">Panel General</span></a> <a class="nav-link" href="/dashboard"><i class="bi bi-speedometer2 text-primary"></i> <span class="nav-text">Panel General</span></a>
</li> </li>
<li class="nav-item"> <li class="nav-item">
<a class="nav-link collapsed" href="#menuEspacios" data-bs-toggle="collapse" role="button" aria-expanded="false"> <a class="nav-link collapsed" href="#menuEspacios" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-door-open text-info"></i> <span class="nav-text flex-grow-1">Espacios & Sedes</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i> <i class="bi bi-door-open text-info"></i> <span class="nav-text flex-grow-1">Espacios &amp; Sedes</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a> </a>
<div class="collapse" id="menuEspacios" data-bs-parent="#sidebarNav"> <div class="collapse" id="menuEspacios" data-bs-parent="#sidebarNav">
<div class="flyout-header text-info d-none"><i class="bi bi-door-open me-1"></i>Espacios & Sedes</div> <div class="flyout-header text-info d-none"><i class="bi bi-door-open me-1"></i>Espacios &amp; Sedes</div>
<ul class="sidebar-submenu"> <ul class="sidebar-submenu">
<li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=physical">Presenciales</a></li> <li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=physical"><i class="bi bi-building me-1"></i>Presenciales</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=virtual">Virtuales</a></li> <li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=virtual"><i class="bi bi-camera-video me-1"></i>Virtuales</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms">Todas las Aulas</a></li> <li><a class="nav-link" href="/classrooms/list_classrooms"><i class="bi bi-door-closed me-1"></i>Todas las Aulas</a></li>
<li><a class="nav-link text-success" href="/classrooms/add_classroom"><i class="bi bi-plus-circle me-1" style="min-width:auto; font-size:1rem;"></i>Nueva Aula</a></li> <li><a class="nav-link text-success" href="/classrooms/add_classroom"><i class="bi bi-plus-circle me-1"></i>Nueva Aula</a></li>
<li><a class="nav-link" href="/buildings/list_buildings">Edificios</a></li> <li><a class="nav-link" href="/buildings/list_buildings"><i class="bi bi-buildings me-1"></i>Sedes / Edificios</a></li>
<li><a class="nav-link" href="/admin/occupancy_metrics">Métricas</a></li> <li><a class="nav-link" href="/admin/occupancy_metrics"><i class="bi bi-pie-chart me-1"></i>Métricas de Ocupación</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuReservas" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-calendar3 text-warning"></i> <span class="nav-text flex-grow-1">Reservas</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuReservas" data-bs-parent="#sidebarNav">
<div class="flyout-header text-warning d-none"><i class="bi bi-calendar3 me-1"></i>Reservas</div>
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/schedule/calendar_view">Calendario</a></li>
<li><a class="nav-link" href="/schedule/today_schedule">Cartelera</a></li>
<li><a class="nav-link" href="/schedule/list_reservations">Gestión</a></li>
<li><a class="nav-link text-success" href="/schedule/add_reservation"><i class="bi bi-plus-circle me-1" style="min-width:auto; font-size:1rem;"></i>Nueva</a></li>
<li><a class="nav-link" href="/schedule/commissions_view">Comisiones</a></li>
<li><a class="nav-link text-info fw-semibold" href="/genetic_algorithm_web/genetic_optimizer"><i class="bi bi-cpu me-1" style="min-width:auto; font-size:1rem;"></i>IA Optimizer</a></li>
</ul> </ul>
</div> </div>
</li> </li>
<li class="nav-item"> <li class="nav-item">
<a class="nav-link collapsed" href="#menuAcademica" data-bs-toggle="collapse" role="button" aria-expanded="false"> <a class="nav-link collapsed" href="#menuAcademica" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-mortarboard text-success"></i> <span class="nav-text flex-grow-1">Académica</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i> <i class="bi bi-mortarboard text-success"></i> <span class="nav-text flex-grow-1">Estructura Académica</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a> </a>
<div class="collapse" id="menuAcademica" data-bs-parent="#sidebarNav"> <div class="collapse" id="menuAcademica" data-bs-parent="#sidebarNav">
<div class="flyout-header text-success d-none"><i class="bi bi-mortarboard me-1"></i>Académica</div> <div class="flyout-header text-success d-none"><i class="bi bi-mortarboard me-1"></i>Estructura Académica</div>
<ul class="sidebar-submenu"> <ul class="sidebar-submenu">
<li><a class="nav-link" href="/admin/careers_list">Carreras</a></li> <li><a class="nav-link" href="/admin/academic_terms_list"><i class="bi bi-calendar-range me-1"></i>Ciclos Lectivos</a></li>
<li><a class="nav-link" href="/admin/subjects_list">Asignaturas</a></li> <li><a class="nav-link" href="/admin/careers_list"><i class="bi bi-mortarboard me-1"></i>Carreras</a></li>
<li><a class="nav-link" href="/admin/commissions_list">Comisiones</a></li> <li><a class="nav-link" href="/admin/subjects_list"><i class="bi bi-book me-1"></i>Asignaturas</a></li>
<li><a class="nav-link" href="/admin/academic_terms_list">Ciclo Lectivo</a></li> <li><a class="nav-link" href="/admin/commissions_list"><i class="bi bi-diagram-3 me-1"></i>Comisiones</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuReservas" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-calendar3 text-warning"></i> <span class="nav-text flex-grow-1">Reservas &amp; Calendario</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuReservas" data-bs-parent="#sidebarNav">
<div class="flyout-header text-warning d-none"><i class="bi bi-calendar3 me-1"></i>Reservas</div>
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-calendar-day me-1"></i>Cartelera del Día</a></li>
<li><a class="nav-link" href="/schedule/calendar_view"><i class="bi bi-calendar-week me-1"></i>Calendario Semanal</a></li>
<li><a class="nav-link" href="/schedule/list_reservations"><i class="bi bi-list-check me-1"></i>Gestión de Reservas</a></li>
<li><a class="nav-link text-success" href="/schedule/add_reservation"><i class="bi bi-plus-circle me-1"></i>Nueva Reserva</a></li>
<li><a class="nav-link" href="/schedule/commissions_view"><i class="bi bi-clock-history me-1"></i>Comisiones en Horario</a></li>
<li><a class="nav-link text-info fw-semibold" href="/genetic_algorithm_web/genetic_optimizer"><i class="bi bi-cpu me-1"></i>Optimizador IA</a></li>
</ul> </ul>
</div> </div>
</li> </li>
<li class="nav-item"> <li class="nav-item">
<a class="nav-link collapsed" href="#menuAdmin" data-bs-toggle="collapse" role="button" aria-expanded="false"> <a class="nav-link collapsed" href="#menuAdmin" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-shield-lock text-secondary"></i> <span class="nav-text flex-grow-1">Administración</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i> <i class="bi bi-shield-lock text-secondary"></i> <span class="nav-text flex-grow-1">Gobierno &amp; Sistema</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a> </a>
<div class="collapse" id="menuAdmin" data-bs-parent="#sidebarNav"> <div class="collapse" id="menuAdmin" data-bs-parent="#sidebarNav">
<div class="flyout-header text-secondary d-none"><i class="bi bi-shield-lock me-1"></i>Administración</div> <div class="flyout-header text-secondary d-none"><i class="bi bi-shield-lock me-1"></i>Gobierno &amp; Sistema</div>
<ul class="sidebar-submenu"> <ul class="sidebar-submenu">
<li><a class="nav-link" href="/admin/users_list">Usuarios</a></li> <li><a class="nav-link" href="/admin/users_list"><i class="bi bi-people me-1"></i>Usuarios</a></li>
<li><a class="nav-link" href="/admin/roles_list">Roles RBAC</a></li> <li><a class="nav-link" href="/admin/roles_list"><i class="bi bi-shield-check me-1"></i>Roles RBAC</a></li>
<li><a class="nav-link" href="/admin/milestone_types_list">Tipos Hitos</a></li> <li><a class="nav-link" href="/admin/milestone_types_list"><i class="bi bi-bookmark-star me-1"></i>Tipos de Hitos</a></li>
<li><a class="nav-link" href="/admin/google_sheets_import">Sincro Sheets</a></li> <li><a class="nav-link" href="/admin/google_sheets_import"><i class="bi bi-file-earmark-spreadsheet me-1"></i>Sincro Sheets</a></li>
<li><a class="nav-link" href="/admin/audit_logs">Auditoría</a></li> <li><a class="nav-link" href="/admin/audit_logs"><i class="bi bi-journal-text me-1"></i>Auditoría</a></li>
<li><a class="nav-link text-primary fw-semibold" href="/admin/settings"><i class="bi bi-gear-wide-connected me-1" style="min-width:auto; font-size:1rem;"></i>Config. Global</a></li> <li><a class="nav-link text-primary fw-semibold" href="/admin/settings"><i class="bi bi-gear-wide-connected me-1"></i>Config. Global</a></li>
</ul> </ul>
</div> </div>
</li> </li>
{% elif user_role == 'bedelia' %} {% elif user_role == 'bedelia' %}
<!-- BEDELIA --> <!-- BEDELÍA (FLUJO OPERATIVO NATURAL DE 9 PASOS) -->
<li class="nav-item"><a class="nav-link" href="/dashboard"><i class="bi bi-speedometer2 text-warning"></i> <span class="nav-text">Panel Bedelía</span></a></li> <li class="nav-item">
<li class="nav-item"><a class="nav-link" href="/classrooms/list_classrooms"><i class="bi bi-door-open text-primary"></i> <span class="nav-text">Aulas y Espacios</span></a></li> <a class="nav-link" href="/dashboard"><i class="bi bi-speedometer2 text-warning"></i> <span class="nav-text">Panel Bedelía</span></a>
<li class="nav-item"><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-calendar-day text-info"></i> <span class="nav-text">Cartelera Diaria</span></a></li> </li>
<li class="nav-item"><a class="nav-link" href="/schedule/list_reservations"><i class="bi bi-list-check text-success"></i> <span class="nav-text">Gestión Reservas</span></a></li> <li class="nav-item">
<li class="nav-item"><a class="nav-link" href="/schedule/add_reservation"><i class="bi bi-plus-circle text-success"></i> <span class="nav-text">Nueva Reserva</span></a></li> <a class="nav-link collapsed" href="#menuEspaciosBedelia" data-bs-toggle="collapse" role="button" aria-expanded="false">
<li class="nav-item"><a class="nav-link" href="/admin/commissions_list"><i class="bi bi-diagram-3 text-primary"></i> <span class="nav-text">Comisiones</span></a></li> <i class="bi bi-door-open text-info"></i> <span class="nav-text flex-grow-1">Espacios Físicos &amp; Aulas</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuEspaciosBedelia" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/buildings/list_buildings"><i class="bi bi-building me-1"></i>Sedes / Edificios</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=physical"><i class="bi bi-door-closed me-1"></i>Aulas Presenciales</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=virtual"><i class="bi bi-camera-video me-1"></i>Aulas Virtuales</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms"><i class="bi bi-grid me-1"></i>Catálogo de Aulas</a></li>
<li><a class="nav-link text-success" href="/classrooms/add_classroom"><i class="bi bi-plus-circle me-1"></i>Nueva Aula</a></li>
<li><a class="nav-link" href="/admin/occupancy_metrics"><i class="bi bi-pie-chart me-1"></i>Métricas de Ocupación</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuAcademicaBedelia" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-mortarboard text-success"></i> <span class="nav-text flex-grow-1">Gestión Académica</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuAcademicaBedelia" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/admin/academic_terms_list"><i class="bi bi-calendar-range me-1"></i>Ciclos Lectivos</a></li>
<li><a class="nav-link" href="/admin/careers_list"><i class="bi bi-mortarboard me-1"></i>Carreras</a></li>
<li><a class="nav-link" href="/admin/subjects_list"><i class="bi bi-book me-1"></i>Asignaturas</a></li>
<li><a class="nav-link" href="/admin/commissions_list"><i class="bi bi-diagram-3 me-1"></i>Comisiones &amp; Cursadas</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuReservasBedelia" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-calendar3 text-warning"></i> <span class="nav-text flex-grow-1">Reservas &amp; Operaciones</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuReservasBedelia" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-calendar-day me-1"></i>Cartelera del Día</a></li>
<li><a class="nav-link" href="/schedule/calendar_view"><i class="bi bi-calendar-week me-1"></i>Calendario Semanal</a></li>
<li><a class="nav-link" href="/schedule/list_reservations"><i class="bi bi-list-check me-1"></i>Gestión de Reservas</a></li>
<li><a class="nav-link text-success" href="/schedule/add_reservation"><i class="bi bi-plus-circle me-1"></i>Nueva Reserva</a></li>
<li><a class="nav-link text-info fw-semibold" href="/genetic_algorithm_web/genetic_optimizer"><i class="bi bi-cpu me-1"></i>Optimizador Genético IA</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuHerramientasBedelia" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-tools text-secondary"></i> <span class="nav-text flex-grow-1">Herramientas Operativas</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuHerramientasBedelia" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/admin/google_sheets_import"><i class="bi bi-file-earmark-spreadsheet me-1"></i>Importador Google Sheets</a></li>
<li><a class="nav-link" href="/admin/milestone_types_list"><i class="bi bi-bookmark-star me-1"></i>Tipos de Hitos Evaluativos</a></li>
</ul>
</div>
</li>
{% elif user_role == 'docente' %} {% elif user_role == 'docente' %}
<!-- DOCENTE --> <!-- PROFESOR / DOCENTE -->
<li class="nav-item"><a class="nav-link" href="/dashboard"><i class="bi bi-speedometer2 text-info"></i> <span class="nav-text">Panel Docente</span></a></li> <li class="nav-item">
<li class="nav-item"><a class="nav-link" href="/schedule/list_reservations"><i class="bi bi-calendar2-check text-primary"></i> <span class="nav-text">Mis Reservas</span></a></li> <a class="nav-link" href="/dashboard"><i class="bi bi-speedometer2 text-info"></i> <span class="nav-text">Panel Docente</span></a>
<li class="nav-item"><a class="nav-link" href="/schedule/add_reservation"><i class="bi bi-plus-circle text-success"></i> <span class="nav-text">Solicitar Reserva</span></a></li> </li>
<li class="nav-item"><a class="nav-link" href="/schedule/commissions_view"><i class="bi bi-diagram-3 text-info"></i> <span class="nav-text">Mis Comisiones</span></a></li> <li class="nav-item">
<li class="nav-item"><a class="nav-link" href="/my_subjects/my_subjects_list"><i class="bi bi-mortarboard text-warning"></i> <span class="nav-text">Mis Materias</span></a></li> <a class="nav-link collapsed" href="#menuDocenteCursada" data-bs-toggle="collapse" role="button" aria-expanded="false">
<li class="nav-item"><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-geo-alt text-danger"></i> <span class="nav-text">Cartelera Hoy</span></a></li> <i class="bi bi-mortarboard text-warning"></i> <span class="nav-text flex-grow-1">Mi Actividad Académica</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuDocenteCursada" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/my_subjects/my_subjects_list"><i class="bi bi-book me-1"></i>Mis Materias &amp; Comisiones</a></li>
<li><a class="nav-link" href="/schedule/gradebook"><i class="bi bi-journal-check me-1"></i>Libro de Calificaciones</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuDocenteEspacios" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-calendar-week text-primary"></i> <span class="nav-text flex-grow-1">Horarios &amp; Espacios</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuDocenteEspacios" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-calendar-day me-1"></i>Clases de Hoy</a></li>
<li><a class="nav-link" href="/schedule/calendar_view"><i class="bi bi-calendar-range me-1"></i>Cronograma Semanal</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=virtual"><i class="bi bi-camera-video me-1"></i>Campus Virtual &amp; Aulas</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuDocenteReservas" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-calendar2-check text-success"></i> <span class="nav-text flex-grow-1">Mis Reservas</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuDocenteReservas" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/schedule/list_reservations"><i class="bi bi-list-task me-1"></i>Mis Reservas Solicitadas</a></li>
<li><a class="nav-link text-success" href="/schedule/add_reservation"><i class="bi bi-plus-circle me-1"></i>Solicitar Espacio</a></li>
</ul>
</div>
</li>
{% else %} {% else %}
<!-- ALUMNO --> <!-- ALUMNO / ESTUDIANTE -->
<li class="nav-item"><a class="nav-link" href="/dashboard"><i class="bi bi-house-door text-success"></i> <span class="nav-text">Mi Portal</span></a></li> <li class="nav-item">
<li class="nav-item"><a class="nav-link" href="/my_subjects/my_subjects_list"><i class="bi bi-mortarboard text-primary"></i> <span class="nav-text">Mis Materias</span></a></li> <a class="nav-link" href="/dashboard"><i class="bi bi-house-door text-success"></i> <span class="nav-text">Mi Portal</span></a>
<li class="nav-item"><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-geo-alt text-danger"></i> <span class="nav-text">Cartelera Hoy</span></a></li> </li>
<li class="nav-item"><a class="nav-link" href="/schedule/calendar_view"><i class="bi bi-calendar-week text-info"></i> <span class="nav-text">Cronograma</span></a></li> <li class="nav-item">
<li class="nav-item"><a class="nav-link" href="/classrooms/list_classrooms"><i class="bi bi-camera-video text-secondary"></i> <span class="nav-text">Aulas Virtuales</span></a></li> <a class="nav-link collapsed" href="#menuAlumnoCursada" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-mortarboard text-primary"></i> <span class="nav-text flex-grow-1">Mi Trayectoria</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuAlumnoCursada" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/my_subjects/my_subjects_list"><i class="bi bi-journal-bookmark me-1"></i>Mis Materias Inscritas</a></li>
<li><a class="nav-link" href="/schedule/my_grades"><i class="bi bi-award me-1"></i>Mis Calificaciones e Hitos</a></li>
</ul>
</div>
</li>
<li class="nav-item">
<a class="nav-link collapsed" href="#menuAlumnoHorarios" data-bs-toggle="collapse" role="button" aria-expanded="false">
<i class="bi bi-clock text-info"></i> <span class="nav-text flex-grow-1">Horarios &amp; Campus</span> <i class="bi bi-chevron-down nav-caret ms-auto fs-6"></i>
</a>
<div class="collapse" id="menuAlumnoHorarios" data-bs-parent="#sidebarNav">
<ul class="sidebar-submenu">
<li><a class="nav-link" href="/schedule/today_schedule"><i class="bi bi-calendar-day me-1"></i>Clases de Hoy</a></li>
<li><a class="nav-link" href="/schedule/calendar_view"><i class="bi bi-calendar-week me-1"></i>Cronograma Semanal</a></li>
<li><a class="nav-link" href="/classrooms/list_classrooms?view_mode=virtual"><i class="bi bi-camera-video me-1"></i>Campus Virtual &amp; Aulas</a></li>
</ul>
</div>
</li>
{% endif %} {% endif %}
</ul> </ul>
</div> </div>
@@ -1022,6 +1124,12 @@
<li><a class="dropdown-item text-danger" href="/auth/logout"><i class="bi bi-box-arrow-right me-2"></i>Cerrar Sesión</a></li> <li><a class="dropdown-item text-danger" href="/auth/logout"><i class="bi bi-box-arrow-right me-2"></i>Cerrar Sesión</a></li>
</ul> </ul>
</div> </div>
<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.4.9' }} <span class="opacity-75">(FE: {{ frontend_version or '3.4.9' }} · BE: {{ backend_version or '3.4.9' }})</span>
</span>
</div>
</div> </div>
</aside> </aside>
+360 -21
View File
@@ -7,25 +7,41 @@
{% block content %} {% block content %}
<div class="container-fluid pt-5 mt-4"> <div class="container-fluid pt-5 mt-4">
<div class="row"> <div class="row">
<div class="col-lg-8 mx-auto"> <div class="col-xl-9 col-lg-11 mx-auto">
<div class="d-flex justify-content-between align-items-center mb-4"> <!-- Encabezado Principal Limpio (Sin breadcrumbs redundantes) -->
<h1 class="h3 mb-0"> <div class="d-flex flex-wrap justify-content-between align-items-center mb-4 pb-2 border-bottom border-light-subtle gap-3">
<i class="bi bi-buildings text-primary me-2"></i> <div>
{% if building %}Editar Edificio{% else %}Nuevo Edificio{% endif %} <h1 class="h3 mb-1">
</h1> <i class="bi bi-buildings text-primary me-2"></i>
<a href="/buildings/list_buildings" class="btn btn-outline-secondary"> {% if building %}
<i class="bi bi-arrow-left me-1"></i>Volver a Edificios Editar Edificio: <span class="text-primary">{{ building.name }}</span>
</a> {% else %}
Nuevo Edificio / Sede
{% endif %}
</h1>
<p class="text-muted small mb-0">Gestión de sede institucional, plantas físicas y distribución de aulas asociadas.</p>
</div>
<div class="d-flex gap-2">
{% if building %}
<a href="/buildings/view/{{ building.id }}" class="btn btn-outline-primary btn-sm">
<i class="bi bi-eye me-1"></i>Ver Ficha
</a>
{% endif %}
<a href="/buildings/list_buildings" class="btn btn-outline-secondary btn-sm">
<i class="bi bi-arrow-left me-1"></i>Volver a Edificios
</a>
</div>
</div> </div>
<div class="card border-0 shadow-sm"> <!-- Card 1: Formulario Principal del Edificio -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3"> <div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold"> <h5 class="mb-0 h6 fw-bold">
<i class="bi bi-info-circle text-primary me-2"></i>Información del Edificio / Sede <i class="bi bi-info-circle text-primary me-2"></i>Información del Edificio / Sede
</h5> </h5>
</div> </div>
<div class="card-body p-4"> <div class="card-body p-4">
<form method="POST" action="{% if building %}/buildings/edit/{{ building.id }}{% else %}/buildings/add_building{% endif %}" novalidate> <form method="POST" action="{% if building %}/buildings/edit/{{ building.id }}{% else %}/buildings/add_building{% endif %}" id="buildingForm" novalidate>
{% if building %} {% if building %}
<input type="hidden" name="id" value="{{ building.id }}"> <input type="hidden" name="id" value="{{ building.id }}">
{% endif %} {% endif %}
@@ -33,7 +49,7 @@
<div class="row g-3"> <div class="row g-3">
<div class="col-md-8"> <div class="col-md-8">
{{ form.name.label(class="form-label fw-semibold") }} {{ form.name.label(class="form-label fw-semibold") }}
{{ form.name(class="form-control" + (" is-invalid" if form.name.errors else ""), placeholder="ej. Edificio Central, Pabellón de Ciencias, Sede Norte") }} {{ form.name(class="form-control" + (" is-invalid" if form.name.errors else ""), id="buildingNameInput", placeholder="ej. Edificio Central, Pabellón de Ciencias, Sede Norte") }}
{% if form.name.errors %} {% if form.name.errors %}
<div class="invalid-feedback">{{ form.name.errors[0] }}</div> <div class="invalid-feedback">{{ form.name.errors[0] }}</div>
{% endif %} {% endif %}
@@ -41,30 +57,60 @@
<div class="col-md-4"> <div class="col-md-4">
{{ form.code.label(class="form-label fw-semibold") }} {{ form.code.label(class="form-label fw-semibold") }}
{{ form.code(class="form-control" + (" is-invalid" if form.code.errors else ""), placeholder="ej. CENTRAL, VIRTUAL, PAB-A") }} {{ form.code(class="form-control" + (" is-invalid" if form.code.errors else ""), id="buildingCodeInput", placeholder="ej. CENTRAL, VIRTUAL, PAB-A") }}
{% if form.code.errors %} {% if form.code.errors %}
<div class="invalid-feedback">{{ form.code.errors[0] }}</div> <div class="invalid-feedback">{{ form.code.errors[0] }}</div>
{% endif %} {% endif %}
<small class="text-muted">Código identificador corto</small> <small class="text-muted">Código identificador corto</small>
</div> </div>
<div class="col-md-8"> <div class="col-md-7">
{{ form.address.label(class="form-label fw-semibold") }} {{ form.address.label(class="form-label fw-semibold") }}
{{ form.address(class="form-control" + (" is-invalid" if form.address.errors else ""), placeholder="ej. Av. Paseo Colón 255, CABA o campus.unicaba.edu.ar") }} {{ form.address(class="form-control" + (" is-invalid" if form.address.errors else ""), placeholder="ej. Tte. Gral. Juan Domingo Perón 802, CABA o campus.unicaba.edu.ar") }}
{% if form.address.errors %} {% if form.address.errors %}
<div class="invalid-feedback">{{ form.address.errors[0] }}</div> <div class="invalid-feedback">{{ form.address.errors[0] }}</div>
{% endif %} {% endif %}
</div> </div>
<div class="col-md-4"> <!-- Selector de Plantas Físicas -->
{{ form.floors.label(class="form-label fw-semibold") }} <div class="col-md-5">
{{ form.floors(class="form-control" + (" is-invalid" if form.floors.errors else ""), min=0, max=100) }} <label for="floorsInput" class="form-label fw-semibold d-flex justify-content-between align-items-center mb-1">
<span><i class="bi bi-layers me-1 text-primary"></i>Plantas Físicas</span>
<span class="badge bg-secondary-subtle text-secondary-emphasis" id="floorModeBadge">
{% if building and building.is_virtual %}Campus Virtual{% else %}Presencial{% endif %}
</span>
</label>
<div class="input-group">
<button class="btn btn-outline-secondary" type="button" id="btnFloorDec" title="Disminuir planta">-</button>
{{ form.floors(class="form-control text-center fw-bold" + (" is-invalid" if form.floors.errors else ""), id="floorsInput", min=0, max=100) }}
<button class="btn btn-outline-secondary" type="button" id="btnFloorInc" title="Aumentar planta">+</button>
</div>
{% if form.floors.errors %} {% if form.floors.errors %}
<div class="invalid-feedback">{{ form.floors.errors[0] }}</div> <div class="invalid-feedback d-block">{{ form.floors.errors[0] }}</div>
{% endif %} {% endif %}
<small class="text-muted">Plantas físicas (0 para Campus Virtual)</small> <small class="text-muted d-block mt-1">Niveles estructurales (0 para Campus Virtual)</small>
</div> </div>
{% if not building %}
<!-- Presets Rápidos solo para Nuevo Edificio -->
<div class="col-12">
<div class="p-3 bg-body-tertiary rounded border border-light-subtle">
<div class="d-flex flex-wrap justify-content-between align-items-center mb-2 gap-2">
<div class="small fw-semibold text-secondary">
<i class="bi bi-lightning-charge me-1"></i>Presets Rápidos de Estructura:
</div>
<div class="d-flex flex-wrap gap-1">
<button type="button" class="btn btn-outline-primary btn-sm py-0 px-2" id="presetPB">Solo PB (1)</button>
<button type="button" class="btn btn-outline-primary btn-sm py-0 px-2" id="presetPBplus1">PB + 1 (2)</button>
<button type="button" class="btn btn-outline-primary btn-sm py-0 px-2" id="presetPBplus3">PB + 3 (4)</button>
<button type="button" class="btn btn-outline-secondary btn-sm py-0 px-2" id="presetVirtual">Campus Virtual (0)</button>
</div>
</div>
<div class="d-flex flex-wrap align-items-center gap-1" id="floorLevelChips"></div>
</div>
</div>
{% endif %}
<div class="col-12"> <div class="col-12">
{{ form.description.label(class="form-label fw-semibold") }} {{ form.description.label(class="form-label fw-semibold") }}
{{ form.description(class="form-control", rows=3, placeholder="Información relevante, accesos, comodidades o departamentos alojados...") }} {{ form.description(class="form-control", rows=3, placeholder="Información relevante, accesos, comodidades o departamentos alojados...") }}
@@ -75,7 +121,7 @@
<div class="col-12"> <div class="col-12">
<div class="form-check form-switch pt-2"> <div class="form-check form-switch pt-2">
{{ form.is_active(class="form-check-input", role="switch") }} {{ form.is_active(class="form-check-input", role="switch", id="isActiveInput") }}
{{ form.is_active.label(class="form-check-label fw-semibold") }} {{ form.is_active.label(class="form-check-label fw-semibold") }}
</div> </div>
</div> </div>
@@ -91,7 +137,300 @@
</form> </form>
</div> </div>
</div> </div>
<!-- Card 2: Panel de Plantas Físicas y Distribución de Aulas (para Edificio Existente) -->
{% if building %}
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3 d-flex flex-wrap justify-content-between align-items-center gap-2">
<div>
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-layers-fill text-primary me-2"></i>Plantas Físicas y Distribución de Aulas
</h5>
<small class="text-muted">Espacios físicos asignados a cada planta del edificio</small>
</div>
<div class="d-flex flex-wrap align-items-center gap-2">
<span class="badge bg-primary-subtle text-primary border border-primary-subtle px-2 py-1">
<i class="bi bi-building me-1"></i>{{ floors_list|length }} Niveles
</span>
<span class="badge bg-info-subtle text-info border border-info-subtle px-2 py-1">
<i class="bi bi-door-open me-1"></i>{{ classrooms|length }} Aulas
</span>
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
<i class="bi bi-people me-1"></i>{{ total_physical_capacity }} Plazas
</span>
{% if not building.is_virtual %}
<a href="/classrooms/add_classroom?building_id={{ building.id }}" class="btn btn-sm btn-success">
<i class="bi bi-plus-circle me-1"></i>Crear Nueva Aula
</a>
{% endif %}
</div>
</div>
<div class="card-body p-4">
{% if building.is_virtual %}
<div class="alert alert-info border-0 shadow-sm d-flex align-items-center justify-content-between">
<div>
<i class="bi bi-cloud-check fs-4 me-2"></i>
<strong>Sede Virtual:</strong> Las aulas de esta sede operan en el Campus Digital institucional (Moodle, Meet y MS Teams).
</div>
<a href="/classrooms/add_classroom?building_id={{ building.id }}&floor=Digital" class="btn btn-sm btn-outline-primary">
<i class="bi bi-plus-lg me-1"></i>Nueva Sala Virtual
</a>
</div>
{% endif %}
{% if floors_list and floors_list|length > 0 %}
<div class="d-flex flex-column gap-3">
{% for f in floors_list %}
<div class="card border border-light-subtle shadow-none">
<!-- Cabecera de la Planta -->
<div class="card-header bg-body py-2 px-3 d-flex flex-wrap justify-content-between align-items-center gap-2">
<div class="d-flex align-items-center">
{% if 'SUB' in f.floor_code|upper or 'SS' in f.floor_code|upper %}
<i class="bi bi-box-arrow-in-down text-warning fs-5 me-2"></i>
{% elif 'PB' in f.floor_code|upper or 'PLANTA' in f.floor_name|upper %}
<i class="bi bi-door-closed text-primary fs-5 me-2"></i>
{% elif 'EP' in f.floor_code|upper or 'ENTRE' in f.floor_name|upper %}
<i class="bi bi-stack text-info fs-5 me-2"></i>
{% elif f.floor_code == 'Digital' %}
<i class="bi bi-cloud text-info fs-5 me-2"></i>
{% else %}
<i class="bi bi-layers text-secondary fs-5 me-2"></i>
{% endif %}
<div>
<span class="fw-bold fs-6">{{ f.floor_name }}</span>
<span class="badge bg-secondary-subtle text-secondary-emphasis border border-secondary-subtle ms-2">Nivel {{ f.floor_code }}</span>
</div>
</div>
<div class="d-flex align-items-center gap-2">
<span class="badge bg-secondary-subtle text-secondary-emphasis border border-secondary-subtle">
<i class="bi bi-door-open me-1"></i>{{ f.classrooms|length }} aulas
</span>
<span class="badge bg-secondary-subtle text-secondary-emphasis border border-secondary-subtle">
<i class="bi bi-people me-1"></i>{{ f.total_capacity }} plazas
</span>
<a href="/classrooms/add_classroom?building_id={{ building.id }}&floor={{ f.floor_code }}"
class="btn btn-sm btn-outline-success py-1 px-2"
title="Crear un aula directamente en {{ f.floor_name }}">
<i class="bi bi-plus-lg me-1"></i>+ Nueva Aula en este Piso
</a>
</div>
</div>
<!-- Listado de Aulas en esta Planta -->
<div class="card-body p-0">
{% if f.classrooms and f.classrooms|length > 0 %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0 table-sm">
<thead class="bg-body-tertiary">
<tr>
<th class="ps-3 py-2 small fw-semibold text-secondary" style="width: 32%;">Aula / Espacio</th>
<th class="py-2 small fw-semibold text-secondary" style="width: 22%;">Capacidad</th>
<th class="py-2 small fw-semibold text-secondary" style="width: 22%;">Estado</th>
<th class="text-end pe-3 py-2 small fw-semibold text-secondary" style="width: 24%;">Acciones</th>
</tr>
</thead>
<tbody>
{% for c in f.classrooms %}
<tr>
<td class="ps-3 py-2">
<a href="/classrooms/view_classroom?id={{ c.id }}" class="fw-semibold text-decoration-none text-primary">
<i class="bi bi-door-open me-1"></i>{{ c.code_display or c.code or c.room_number }}
</a>
{% if c.description %}
<small class="text-muted d-block" style="font-size: 0.75rem;">{{ c.description }}</small>
{% endif %}
</td>
<td class="py-2">
<span class="badge bg-primary-subtle text-primary border border-primary-subtle">
{{ c.capacity }} alumnos
</span>
</td>
<td class="py-2">
{% if c.is_active %}
<span class="badge bg-success-subtle text-success border border-success-subtle">
<i class="bi bi-check-circle me-1"></i>Activa
</span>
{% else %}
<span class="badge bg-secondary-subtle text-secondary border border-secondary-subtle">
<i class="bi bi-pause-circle me-1"></i>Inactiva
</span>
{% endif %}
</td>
<td class="text-end pe-3 py-2">
<div class="btn-group btn-group-sm">
<a href="/classrooms/edit/{{ c.id }}" class="btn btn-outline-secondary py-0 px-2" title="Editar detalles del aula">
<i class="bi bi-pencil me-1"></i>Editar
</a>
<a href="/schedule/add_reservation?classroom_id={{ c.id }}" class="btn btn-outline-primary py-0 px-2" title="Reservar espacio">
<i class="bi bi-calendar-plus me-1"></i>Reservar
</a>
</div>
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="p-3 text-center bg-body-tertiary text-muted small">
<i class="bi bi-inbox me-1"></i>Este nivel aún no tiene aulas asignadas.
<a href="/classrooms/add_classroom?building_id={{ building.id }}&floor={{ f.floor_code }}" class="fw-semibold text-primary ms-1 text-decoration-none">
+ Añadir la primera aula aquí &rarr;
</a>
</div>
{% endif %}
</div>
</div>
{% endfor %}
</div>
{% else %}
<div class="text-center py-4 bg-body-tertiary rounded border border-dashed text-muted">
<i class="bi bi-building-slash fs-3 d-block mb-2 text-secondary"></i>
No se han registrado plantas físicas aún para esta sede.
<div class="mt-2">
<a href="/classrooms/add_classroom?building_id={{ building.id }}" class="btn btn-sm btn-primary">
<i class="bi bi-plus-circle me-1"></i>Crear Primera Aula
</a>
</div>
</div>
{% endif %}
</div>
</div>
{% else %}
<!-- Card Informativa para Edificio Nuevo -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-layers-fill text-primary me-2"></i>Estructura Proyectada de Plantas
</h5>
</div>
<div class="card-body p-4 text-center">
<div class="py-2">
<i class="bi bi-diagram-3 fs-2 text-primary mb-2 d-block"></i>
<h6 class="fw-bold mb-1">Previsualización de Niveles Físicos</h6>
<p class="text-muted small mb-3">
Ajusta el número de plantas arriba para previsualizar los niveles que compondrán este edificio. Al guardar la sede, podrás incorporar aulas directamente en cada una de sus plantas.
</p>
<div class="d-inline-flex flex-wrap gap-2 justify-content-center p-3 bg-body-tertiary rounded border border-light-subtle" id="newBuildingFloorsPreview">
<!-- Poblado dinámicamente -->
</div>
</div>
</div>
</div>
{% endif %}
</div> </div>
</div> </div>
</div> </div>
{% endblock %} {% endblock %}
{% block extra_js %}
<script>
document.addEventListener('DOMContentLoaded', function() {
const floorsInput = document.getElementById('floorsInput');
const btnFloorInc = document.getElementById('btnFloorInc');
const btnFloorDec = document.getElementById('btnFloorDec');
const floorModeBadge = document.getElementById('floorModeBadge');
const floorLevelChips = document.getElementById('floorLevelChips');
const newBuildingPreview = document.getElementById('newBuildingFloorsPreview');
const buildingCodeInput = document.getElementById('buildingCodeInput');
const buildingNameInput = document.getElementById('buildingNameInput');
function isVirtualTarget() {
const c = (buildingCodeInput ? buildingCodeInput.value : '').toUpperCase();
const n = (buildingNameInput ? buildingNameInput.value : '').toUpperCase();
return c.includes('VIRTUAL') || n.includes('VIRTUAL');
}
function renderLevelChips(val) {
const count = parseInt(val, 10) || 0;
if (count === 0 || isVirtualTarget()) {
if (floorModeBadge) floorModeBadge.textContent = 'Campus Virtual';
if (floorLevelChips) {
floorLevelChips.innerHTML = '<span class="badge bg-info-subtle text-info border border-info-subtle px-2 py-1"><i class="bi bi-cloud-check me-1"></i>Campus Virtual (Nivel Digital)</span>';
}
if (newBuildingPreview) {
newBuildingPreview.innerHTML = '<span class="badge bg-info-subtle text-info border px-3 py-2"><i class="bi bi-cloud me-1"></i>Campus Virtual (100% Remoto)</span>';
}
return;
}
if (floorModeBadge) floorModeBadge.textContent = 'Presencial (' + count + ' pisos)';
const levels = [];
levels.push({ code: 'PB', name: 'Planta Baja (PB)' });
for (let i = 1; i < count; i++) {
levels.push({ code: String(i), name: 'Piso ' + i });
}
if (floorLevelChips) {
floorLevelChips.innerHTML = '';
levels.forEach(function(lvl) {
const chip = document.createElement('span');
chip.className = 'badge bg-primary-subtle text-primary border border-primary-subtle px-2 py-1';
chip.innerHTML = '<i class="bi bi-layers me-1"></i>' + lvl.name;
floorLevelChips.appendChild(chip);
});
}
if (newBuildingPreview) {
newBuildingPreview.innerHTML = '';
levels.forEach(function(lvl) {
const bChip = document.createElement('div');
bChip.className = 'p-2 rounded bg-body border text-center shadow-sm';
bChip.style.minWidth = '110px';
bChip.innerHTML = '<i class="bi bi-layers text-primary d-block mb-1"></i><small class="fw-bold d-block">' + lvl.name + '</small><span class="badge bg-secondary-subtle text-secondary border" style="font-size: 0.7rem;">Nivel ' + lvl.code + '</span>';
newBuildingPreview.appendChild(bChip);
});
}
}
if (floorsInput) {
floorsInput.addEventListener('input', function() {
renderLevelChips(this.value);
});
if (btnFloorInc) {
btnFloorInc.addEventListener('click', function() {
let v = parseInt(floorsInput.value, 10) || 0;
floorsInput.value = v + 1;
renderLevelChips(floorsInput.value);
});
}
if (btnFloorDec) {
btnFloorDec.addEventListener('click', function() {
let v = parseInt(floorsInput.value, 10) || 0;
if (v > 0) {
floorsInput.value = v - 1;
renderLevelChips(floorsInput.value);
}
});
}
const pPB = document.getElementById('presetPB');
const pPB1 = document.getElementById('presetPBplus1');
const pPB3 = document.getElementById('presetPBplus3');
const pVirt = document.getElementById('presetVirtual');
if (pPB) pPB.addEventListener('click', function() { floorsInput.value = 1; renderLevelChips(1); });
if (pPB1) pPB1.addEventListener('click', function() { floorsInput.value = 2; renderLevelChips(2); });
if (pPB3) pPB3.addEventListener('click', function() { floorsInput.value = 4; renderLevelChips(4); });
if (pVirt) pVirt.addEventListener('click', function() { floorsInput.value = 0; renderLevelChips(0); });
renderLevelChips(floorsInput.value);
}
if (buildingCodeInput) {
buildingCodeInput.addEventListener('input', function() {
if (isVirtualTarget() && floorsInput) {
floorsInput.value = 0;
}
if (floorsInput) renderLevelChips(floorsInput.value);
});
}
});
</script>
{% endblock %}
+1 -1
View File
@@ -97,7 +97,7 @@
</div> </div>
<div> <div>
<div class="text-muted small fw-semibold">Pisos Presenciales</div> <div class="text-muted small fw-semibold">Pisos Presenciales</div>
<h3 class="fw-bold mb-0 text-warning">{{ buildings|sum(attribute='floors') }}</h3> <h3 class="fw-bold mb-0 text-warning">{{ total_floors or 4 }}</h3>
<small class="text-muted" style="font-size: 0.72rem;">Plantas físicas activas</small> <small class="text-muted" style="font-size: 0.72rem;">Plantas físicas activas</small>
</div> </div>
</div> </div>
+23 -22
View File
@@ -4,17 +4,11 @@
{% block content %} {% block content %}
<div class="container-fluid pt-5 mt-4"> <div class="container-fluid pt-5 mt-4">
<!-- Breadcrumb & Header --> <!-- Header Limpio sin breadcrumbs redundantes -->
<div class="row mb-4 align-items-center"> <div class="row mb-4 align-items-center pb-2 border-bottom border-light-subtle">
<div class="col-md-7"> <div class="col-md-7">
<nav aria-label="breadcrumb"> <h1 class="h3 mb-1 d-flex align-items-center flex-wrap gap-2">
<ol class="breadcrumb mb-1 small"> <i class="bi bi-buildings text-primary me-1"></i> {{ building.name }}
<li class="breadcrumb-item"><a href="/buildings/list_buildings">Edificios</a></li>
<li class="breadcrumb-item active">{{ building.name }}</li>
</ol>
</nav>
<h1 class="h3 mb-0 d-flex align-items-center flex-wrap gap-2">
<i class="bi bi-building text-primary"></i> {{ building.name }}
<span class="badge bg-secondary-subtle text-secondary font-monospace border fs-6">{{ building.code or 'EDIF' }}</span> <span class="badge bg-secondary-subtle text-secondary font-monospace border fs-6">{{ building.code or 'EDIF' }}</span>
{% if building.is_active %} {% if building.is_active %}
<span class="badge bg-success-subtle text-success border border-success-subtle fs-6"> <span class="badge bg-success-subtle text-success border border-success-subtle fs-6">
@@ -26,13 +20,17 @@
</span> </span>
{% endif %} {% endif %}
</h1> </h1>
<p class="text-muted small mb-0">{{ building.address or 'Sede institucional UniCABA' }}</p>
</div> </div>
<div class="col-md-5 text-md-end mt-3 mt-md-0"> <div class="col-md-5 text-md-end mt-3 mt-md-0">
<a href="/buildings/list_buildings" class="btn btn-outline-secondary btn-sm me-2">
<i class="bi bi-arrow-left me-1"></i>Volver a Edificios
</a>
{% if user.has_permission('classrooms', 'read_write') or user.is_admin() or user.is_bedelia() %} {% if user.has_permission('classrooms', 'read_write') or user.is_admin() or user.is_bedelia() %}
<a href="/buildings/edit/{{ building.id }}" class="btn btn-outline-secondary me-2"> <a href="/buildings/edit/{{ building.id }}" class="btn btn-outline-primary btn-sm me-2">
<i class="bi bi-pencil me-1"></i>Editar Edificio <i class="bi bi-pencil me-1"></i>Editar Edificio
</a> </a>
<a href="/classrooms/add_classroom" class="btn btn-primary"> <a href="/classrooms/add_classroom?building_id={{ building.id }}" class="btn btn-success btn-sm">
<i class="bi bi-plus-circle me-1"></i>Nueva Aula <i class="bi bi-plus-circle me-1"></i>Nueva Aula
</a> </a>
{% endif %} {% endif %}
@@ -97,27 +95,27 @@
<span class="badge badge-brand">{{ classrooms|length }} aulas configuradas</span> <span class="badge badge-brand">{{ classrooms|length }} aulas configuradas</span>
</div> </div>
<div class="card-body p-4"> <div class="card-body p-4">
{% if classrooms_by_floor %} {% if floors_list and (classrooms|length > 0) %}
{% for floor_num in classrooms_by_floor|sort %} {% for fl in floors_list %}
<div class="mb-4"> <div class="mb-4">
<div class="d-flex align-items-center mb-3"> <div class="d-flex align-items-center mb-3">
<span class="badge bg-dark bg-opacity-75 fs-6 px-3 py-2 me-2"> <span class="badge bg-dark bg-opacity-75 fs-6 px-3 py-2 me-2">
<i class="bi bi-layer-forward me-1"></i> <i class="bi bi-layer-forward me-1"></i>
{% if floor_num == 0 %}Planta Baja{% else %}Piso {{ floor_num }}{% endif %} {{ fl.floor_name }}
</span> </span>
<div class="border-bottom flex-grow-1"></div> <div class="border-bottom flex-grow-1"></div>
<small class="text-muted ms-2">{{ classrooms_by_floor[floor_num]|length }} aulas</small> <small class="text-muted ms-2">{{ fl.classrooms|length }} aula(s)</small>
</div> </div>
<div class="row g-3"> <div class="row g-3">
{% for c in classrooms_by_floor[floor_num] %} {% for c in fl.classrooms %}
<div class="col-md-6 col-xl-4"> <div class="col-md-6 col-xl-4">
<div class="card border border-light-subtle shadow-sm h-100"> <div class="card border border-light-subtle shadow-sm h-100">
<div class="card-body p-3"> <div class="card-body p-3">
<div class="d-flex justify-content-between align-items-start mb-2"> <div class="d-flex justify-content-between align-items-start mb-2">
<h6 class="fw-bold mb-0"> <h6 class="fw-bold mb-0">
<a href="/classrooms/view_classroom" class="text-decoration-none text-primary"> <a href="/classrooms/view_classroom?id={{ c.id }}" class="text-decoration-none text-primary">
<i class="bi bi-door-open me-1"></i>{{ c.code }} <i class="bi bi-door-open me-1"></i>{{ c.code or c.room_number or ('Aula ' + c.id) }}
</a> </a>
</h6> </h6>
{% if c.is_active %} {% if c.is_active %}
@@ -128,7 +126,7 @@
</div> </div>
<div class="small text-muted mb-2"> <div class="small text-muted mb-2">
<i class="bi bi-people me-1"></i>Capacidad: <strong>{{ c.capacity }}</strong> estudiantes <i class="bi bi-people me-1"></i>Capacidad: <strong>{{ c.capacity or 35 }}</strong> estudiantes
</div> </div>
{% if c.description %} {% if c.description %}
@@ -136,11 +134,14 @@
{% endif %} {% endif %}
<div class="d-flex justify-content-between align-items-center pt-2 border-top"> <div class="d-flex justify-content-between align-items-center pt-2 border-top">
<a href="/classrooms/view_classroom" class="btn btn-outline-primary btn-sm py-0 px-2"> <a href="/classrooms/view_classroom?id={{ c.id }}" class="btn btn-outline-primary btn-sm py-0 px-2">
<small>Ver Ficha</small> <small>Ver Ficha</small>
</a> </a>
<a href="/schedule/add_reservation?classroom_id={{ c.id }}" class="btn btn-outline-success btn-sm py-0 px-2">
<small><i class="bi bi-calendar-plus me-1"></i>Reservar</small>
</a>
{% if user.has_permission('classrooms', 'read_write') %} {% if user.has_permission('classrooms', 'read_write') %}
<a href="/classrooms/edit_classroom" class="btn btn-outline-secondary btn-sm py-0 px-2"> <a href="/classrooms/edit_classroom?id={{ c.id }}" class="btn btn-outline-secondary btn-sm py-0 px-2">
<small>Editar</small> <small>Editar</small>
</a> </a>
{% endif %} {% endif %}
+16 -5
View File
@@ -195,10 +195,12 @@ document.addEventListener('DOMContentLoaded', function() {
if (!floorDatalist) return; if (!floorDatalist) return;
floorDatalist.innerHTML = ''; floorDatalist.innerHTML = '';
var floors = buildingFloors[bId] || []; var floors = buildingFloors[bId] || [];
floors.forEach(function(f) { var dynamicDefaults = ['Planta Baja (PB)', 'Entrepiso (EP)', 'Subsuelo', 'Piso 1', 'Piso 2', 'Piso 3', 'Piso 4'];
var allOptions = Array.from(new Set([...dynamicDefaults, ...floors]));
allOptions.forEach(function(f) {
var opt = document.createElement('option'); var opt = document.createElement('option');
opt.value = f; opt.value = f;
opt.textContent = (f === '0' || f === 'PB') ? 'Planta Baja' : 'Piso ' + f; opt.textContent = f;
floorDatalist.appendChild(opt); floorDatalist.appendChild(opt);
}); });
} }
@@ -239,9 +241,18 @@ document.addEventListener('DOMContentLoaded', function() {
} }
} }
if (newBuildingNameInput) newBuildingNameInput.addEventListener('input', updatePreview); // Preselección de edificio y piso desde URL o backend
if (floorInput) floorInput.addEventListener('input', updatePreview); var urlParams = new URLSearchParams(window.location.search);
if (roomInput) roomInput.addEventListener('input', updatePreview); var targetBId = urlParams.get('building_id') || '{{ preselected_building_id or "" }}';
var targetFloor = urlParams.get('floor') || '{{ preselected_floor or "" }}';
if (targetBId && buildingSelect) {
buildingSelect.value = targetBId;
updateFloorsDatalist(targetBId);
}
if (targetFloor && floorInput) {
floorInput.value = targetFloor;
}
updatePreview(); updatePreview();
+4 -2
View File
@@ -188,10 +188,12 @@ document.addEventListener('DOMContentLoaded', function() {
if (!floorDatalist) return; if (!floorDatalist) return;
floorDatalist.innerHTML = ''; floorDatalist.innerHTML = '';
var floors = buildingFloors[bId] || []; var floors = buildingFloors[bId] || [];
floors.forEach(function(f) { var dynamicDefaults = ['Planta Baja (PB)', 'Entrepiso (EP)', 'Subsuelo', 'Piso 1', 'Piso 2', 'Piso 3', 'Piso 4'];
var allOptions = Array.from(new Set([...dynamicDefaults, ...floors]));
allOptions.forEach(function(f) {
var opt = document.createElement('option'); var opt = document.createElement('option');
opt.value = f; opt.value = f;
opt.textContent = (f === '0' || f === 'PB') ? 'Planta Baja' : 'Piso ' + f; opt.textContent = f;
floorDatalist.appendChild(opt); floorDatalist.appendChild(opt);
}); });
} }
+36 -34
View File
@@ -593,6 +593,42 @@
</div> </div>
{% endif %} {% endif %}
<!-- Modales de Eliminación de Aulas Físicas -->
{% if classrooms and classrooms.items and (classrooms.items|length > 0) %}
{% for classroom in classrooms.items %}
<div class="modal fade text-start" id="modalDeleteClassroom{{ classroom.id }}" tabindex="-1" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content border-0 shadow">
<div class="modal-header bg-danger text-white py-2">
<h6 class="modal-title fw-bold">
<i class="bi bi-exclamation-triangle-fill me-2"></i>Confirmar Eliminación de Aula
</h6>
<button type="button" class="btn-close btn-close-white" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body p-4">
<p class="mb-2">¿Está seguro de que desea eliminar el aula <strong>{{ classroom.code }}</strong> ({{ classroom.building_name }} · {{ classroom.floor_display }})?</p>
<div class="alert alert-warning small mb-0 mt-3 d-flex align-items-center gap-2">
<i class="bi bi-shield-exclamation fs-5"></i>
<div>
Si el espacio cuenta con reservas históricas o cursadas registradas, se <strong>desactivará</strong> automáticamente para mantener la integridad académica del sistema.
</div>
</div>
</div>
<div class="modal-footer py-2 bg-light">
<button type="button" class="btn btn-sm btn-secondary" data-bs-dismiss="modal">Cancelar</button>
<form method="POST" action="/classrooms/delete_classroom" class="d-inline">
<input type="hidden" name="classroom_id" value="{{ classroom.id }}">
<button type="submit" class="btn btn-sm btn-danger">
<i class="bi bi-trash me-1"></i>Confirmar Eliminación
</button>
</form>
</div>
</div>
</div>
</div>
{% endfor %}
{% endif %}
<!-- ========================================================================= --> <!-- ========================================================================= -->
<!-- VISTA 2: CAMPUS VIRTUAL (AULAS A DEMANDA · INFINITAS) --> <!-- VISTA 2: CAMPUS VIRTUAL (AULAS A DEMANDA · INFINITAS) -->
<!-- ========================================================================= --> <!-- ========================================================================= -->
@@ -1007,40 +1043,6 @@
</div> </div>
{% endif %} {% endif %}
<!-- Modales de Eliminación de Aulas Físicas -->
{% if classrooms and classrooms.items and (classrooms.items|length > 0) %}
{% for classroom in classrooms.items %}
<div class="modal fade text-start" id="modalDeleteClassroom{{ classroom.id }}" tabindex="-1" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered">
<div class="modal-content border-0 shadow">
<div class="modal-header bg-danger text-white py-2">
<h6 class="modal-title fw-bold">
<i class="bi bi-exclamation-triangle-fill me-2"></i>Confirmar Eliminación de Aula
</h6>
<button type="button" class="btn-close btn-close-white" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body p-4">
<p class="mb-2">¿Está seguro de que desea eliminar el aula <strong>{{ classroom.code }}</strong> ({{ classroom.building_name }} · {{ classroom.floor_display }})?</p>
<div class="alert alert-warning small mb-0 mt-3 d-flex align-items-center gap-2">
<i class="bi bi-shield-exclamation fs-5"></i>
<div>
Si el espacio cuenta con reservas históricas o cursadas registradas, se <strong>desactivará</strong> automáticamente para mantener la integridad académica del sistema.
</div>
</div>
</div>
<div class="modal-footer py-2 bg-light">
<button type="button" class="btn btn-sm btn-secondary" data-bs-dismiss="modal">Cancelar</button>
<form method="POST" action="/classrooms/delete_classroom" class="d-inline">
<input type="hidden" name="classroom_id" value="{{ classroom.id }}">
<button type="submit" class="btn btn-sm btn-danger">
<i class="bi bi-trash me-1"></i>Confirmar Eliminación
</button>
</form>
</div>
</div>
</div>
</div>
{% endfor %}
{% endif %} {% endif %}
</div> </div>
+4 -4
View File
@@ -122,11 +122,11 @@
{% for res in upcoming_reservations %} {% for res in upcoming_reservations %}
<tr> <tr>
<td class="ps-3"> <td class="ps-3">
<div class="fw-bold font-monospace text-primary fs-6 mb-1"> <div class="fw-bold text-primary fs-6 mb-1">
<i class="bi bi-calendar-event text-primary me-1"></i>{{ res.start_time }} <i class="bi bi-calendar-event text-primary me-1"></i>{{ res.date_display_friendly or res.date_display or res.start_time }}
</div> </div>
<div class="small font-monospace text-body-secondary"> <div class="small text-body-secondary font-monospace">
<i class="bi bi-clock text-warning me-1"></i>{{ res.start_time }} - {{ res.end_time }} hs <i class="bi bi-clock text-warning me-1"></i>{{ res.time_range_friendly or (res.start_time_display + ' a ' + res.end_time_display + ' hs') }}
</div> </div>
</td> </td>
<td> <td>
+352
View File
@@ -0,0 +1,352 @@
<!-- ========================= [A] ADMIN DASHBOARD ========================= -->
<!-- Admin KPI Cards -->
<div class="row mb-4 g-3">
<div class="col-md-6 col-xl-3">
<a href="/classrooms/list_classrooms" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Aulas Totales</span>
<h2 class="mb-0 fw-bold mt-1 text-primary">{{ stats.total_classrooms }}</h2>
</div>
<div class="bg-primary bg-opacity-10 rounded-circle p-3 text-primary">
<i class="bi bi-door-open fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-primary small fw-semibold">
<span>Ver catálogo de espacios</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-xl-3">
<a href="/admin/subjects_list" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Oferta de Materias</span>
<h2 class="mb-0 fw-bold mt-1 text-success">{{ stats.total_subjects }}</h2>
</div>
<div class="bg-success bg-opacity-10 rounded-circle p-3 text-success">
<i class="bi bi-book fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-success small fw-semibold">
<span>Gestión académica</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-xl-3">
<a href="/admin/users_list" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Usuarios Activos</span>
<h2 class="mb-0 fw-bold mt-1 text-info">{{ stats.total_users or 1 }}</h2>
</div>
<div class="bg-info bg-opacity-10 rounded-circle p-3 text-info">
<i class="bi bi-people fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-info small fw-semibold">
<span>Control de usuarios y roles</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-xl-3">
<a href="/schedule/today_schedule" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Reservas de Hoy</span>
<h2 class="mb-0 fw-bold mt-1 text-warning">{{ stats.today_reservations }}</h2>
</div>
<div class="bg-warning bg-opacity-10 rounded-circle p-3 text-warning">
<i class="bi bi-calendar-check fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-warning small fw-semibold">
<span>Cartelera en tiempo real</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
</div>
<!-- Panel de Balance y Percentiles de Asignación de Aulas (Admin) -->
<div class="card border-0 shadow-sm mb-4" id="admin-classrooms-percentiles">
<div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center flex-wrap gap-2">
<div class="d-flex align-items-center gap-2">
<i class="bi bi-pie-chart-fill text-primary fs-5"></i>
<div>
<h5 class="mb-0 h6 fw-bold">Estado y Percentiles de Asignación de Aulas Físicas</h5>
<small class="text-muted">Balance operativo en Edificio Central (Total: {{ filter_stats.today.classrooms.total }} aulas físicas)</small>
</div>
</div>
<div class="d-flex gap-2 align-items-center flex-wrap">
<!-- Switcher de período Día / Semana / Mes (Día activo por defecto) -->
<div class="btn-group btn-group-sm" role="group" id="adminPctPeriodSwitcher">
<button type="button" class="btn btn-outline-primary active" data-period="today" onclick="switchAdminPercentiles('today')">
<i class="bi bi-calendar-day me-1"></i>Día (Hoy)
</button>
<button type="button" class="btn btn-outline-primary" data-period="tomorrow" onclick="switchAdminPercentiles('tomorrow')">
<i class="bi bi-calendar-event me-1"></i>Mañana
</button>
<button type="button" class="btn btn-outline-primary" data-period="week" onclick="switchAdminPercentiles('week')">
<i class="bi bi-calendar-week me-1"></i>Semana
</button>
<button type="button" class="btn btn-outline-primary" data-period="month" onclick="switchAdminPercentiles('month')">
<i class="bi bi-calendar-month me-1"></i>Mes
</button>
</div>
<!-- Badge explícito de fecha del período seleccionado -->
<span id="adminPctDateBadge" class="badge bg-primary text-white border px-2 py-1 font-monospace">
<i class="bi bi-calendar3 me-1"></i><span id="adminPctDateText">{{ filter_stats.today.label }}</span>
</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3 align-items-center">
<!-- Tarjeta 1: Asignadas -->
<div class="col-md-3">
<a href="/classrooms/list_classrooms?view_mode=physical" class="text-decoration-none text-reset d-block h-100">
<div class="p-3 rounded bg-success bg-opacity-10 border border-success-subtle h-100 text-center transition-all">
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="text-success small fw-bold text-uppercase">Aulas Asignadas</span>
<span class="badge bg-success text-white font-monospace" id="adminPctAssignedPct">{{ filter_stats.today.classrooms.assigned_pct }}%</span>
</div>
<div class="d-flex align-items-baseline justify-content-center gap-2 my-2">
<h2 class="mb-0 fw-bold text-success" id="adminPctAssignedCount">{{ filter_stats.today.classrooms.assigned_count }}</h2>
<span class="text-muted small">/ {{ filter_stats.today.classrooms.total }} aulas</span>
</div>
<div class="text-success small pt-2 border-top border-success-subtle d-flex align-items-center justify-content-between">
<span>Con cursadas activas</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</a>
</div>
<!-- Tarjeta 2: Sin Asignar -->
<div class="col-md-3">
<a href="/classrooms/list_classrooms?view_mode=physical" class="text-decoration-none text-reset d-block h-100">
<div class="p-3 rounded bg-warning bg-opacity-10 border border-warning-subtle h-100 text-center transition-all">
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="text-warning-emphasis small fw-bold text-uppercase">Aulas Sin Asignar</span>
<span class="badge bg-warning text-dark font-monospace" id="adminPctUnassignedPct">{{ filter_stats.today.classrooms.unassigned_pct }}%</span>
</div>
<div class="d-flex align-items-baseline justify-content-center gap-2 my-2">
<h2 class="mb-0 fw-bold text-warning-emphasis" id="adminPctUnassignedCount">{{ filter_stats.today.classrooms.unassigned_count }}</h2>
<span class="text-muted small">/ {{ filter_stats.today.classrooms.total }} aulas</span>
</div>
<div class="text-warning-emphasis small pt-2 border-top border-warning-subtle d-flex align-items-center justify-content-between">
<span>Espacios disponibles</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</a>
</div>
<!-- Tarjeta 3: Barras Comparativas de Percentil -->
<div class="col-md-6">
<div class="p-3 rounded bg-body-tertiary border h-100 d-flex flex-column justify-content-center">
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="small fw-semibold text-body">
<i class="bi bi-pie-chart me-1 text-primary"></i>Ocupación en <span id="adminPctPeriodTitle">Día (Hoy)</span>:
</span>
<span class="small font-monospace text-muted" id="adminPctLegendText">
<strong class="text-success" id="adminPctLegendAssigned">{{ filter_stats.today.classrooms.assigned_count }} asignadas ({{ filter_stats.today.classrooms.assigned_pct }}%)</strong> · <strong class="text-warning-emphasis" id="adminPctLegendUnassigned">{{ filter_stats.today.classrooms.unassigned_count }} libres ({{ filter_stats.today.classrooms.unassigned_pct }}%)</strong>
</span>
</div>
<div class="progress mb-3" style="height: 14px;">
<div id="adminPctProgressBarAssigned" class="progress-bar bg-success progress-bar-striped" role="progressbar"
{{ ('style="width: ' ~ (filter_stats.today.classrooms.assigned_pct or 0) ~ '%;"') | safe }}
aria-valuenow="{{ filter_stats.today.classrooms.assigned_pct }}" aria-valuemin="0" aria-valuemax="100">
<span id="adminPctBarTextAssigned">{{ filter_stats.today.classrooms.assigned_pct }}%</span>
</div>
<div id="adminPctProgressBarUnassigned" class="progress-bar bg-warning" role="progressbar"
{{ ('style="width: ' ~ (filter_stats.today.classrooms.unassigned_pct or 0) ~ '%;"') | safe }}
aria-valuenow="{{ filter_stats.today.classrooms.unassigned_pct }}" aria-valuemin="0" aria-valuemax="100">
<span id="adminPctBarTextUnassigned">{{ filter_stats.today.classrooms.unassigned_pct }}%</span>
</div>
</div>
<!-- Comparador de referencia cuatrimestral -->
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="small fw-semibold text-secondary">
<i class="bi bi-calendar-range me-1"></i>Referencia Cuatrimestral Global:
</span>
<span class="small font-monospace text-muted">
{{ stats.assigned_classrooms_pct }}% asignadas · {{ stats.unassigned_classrooms_pct }}% libres
</span>
</div>
<div class="progress" style="height: 8px;">
<div class="progress-bar bg-secondary" role="progressbar" {{ ('style="width: ' ~ (stats.assigned_classrooms_pct or 0) ~ '%;"') | safe }}></div>
<div class="progress-bar bg-secondary-subtle" role="progressbar" {{ ('style="width: ' ~ (stats.unassigned_classrooms_pct or 0) ~ '%;"') | safe }}></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<!-- Admin Visual Menu Launchpad -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<div class="d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-grid-3x3-gap-fill text-primary me-2"></i>Módulos de Gestión & Visualización de Menús
</h5>
<span class="badge bg-primary-subtle text-primary border border-primary-subtle">Vista Administrador</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3">
<div class="col-md-6 col-lg-3">
<a href="/classrooms/list_classrooms" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-primary-subtle text-primary me-3">
<i class="bi bi-door-open fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Espacios & Sedes</h6>
<p class="text-muted small mb-0">Aulas físicas, virtuales y edificios</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/calendar_view" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-info-subtle text-info me-3">
<i class="bi bi-calendar-week fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cronograma & Reservas</h6>
<p class="text-muted small mb-0">Calendario, cartelera y reservas</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/genetic_algorithm_web/genetic_optimizer" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-warning-subtle text-warning me-3">
<i class="bi bi-cpu fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Optimizador IA</h6>
<p class="text-muted small mb-0">Asignación genética inteligente</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/admin/audit_logs" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-danger-subtle text-danger me-3">
<i class="bi bi-shield-lock fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Auditoría & RBAC</h6>
<p class="text-muted small mb-0">Trazabilidad y control de permisos</p>
</div>
</div>
</a>
</div>
</div>
</div>
</div>
<!-- Admin Analytics & Audit Row -->
<div class="row mb-4">
<!-- Monthly Chart -->
<div class="col-lg-8 mb-4 mb-lg-0">
<div class="card border-0 shadow-sm h-100 glass-card">
<div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-graph-up text-primary me-2"></i>Tendencia de Ocupación y Reservas Mensuales
</h5>
<a href="/admin/occupancy_metrics" class="btn btn-sm btn-outline-primary">
<i class="bi bi-bar-chart me-1"></i>Métricas Detalladas
</a>
</div>
<div class="card-body p-3">
<div style="position: relative; height: 260px; max-height: 260px; width: 100%;">
<canvas id="monthlyChart"></canvas>
</div>
</div>
</div>
</div>
<!-- Recent Audit Logs -->
<div class="col-lg-4">
<div class="card border-0 shadow-sm h-100 glass-card">
<div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-shield-check text-success me-2"></i>Últimos Eventos de Auditoría
</h5>
<a href="/admin/audit_logs" class="btn btn-sm btn-outline-secondary py-0 px-2">
Ver todo
</a>
</div>
<div class="card-body p-0">
{% if role_data.recent_audits %}
<ul class="list-group list-group-flush small">
{% for audit in role_data.recent_audits %}
<li class="list-group-item d-flex justify-content-between align-items-center py-2 px-3">
<div>
<div class="fw-semibold text-truncate" style="max-width: 180px;">
{{ audit.user_email or 'Sistema' }}
</div>
<span class="text-muted font-monospace" style="font-size: 0.72rem;">
{{ audit.created_at }} · {{ audit.module }}
</span>
</div>
<div>
{% if audit.action == 'CREATE' %}
<span class="badge bg-success-subtle text-success border">{{ audit.action }}</span>
{% elif audit.action == 'UPDATE' %}
<span class="badge bg-primary-subtle text-primary border">{{ audit.action }}</span>
{% elif audit.action == 'DELETE' %}
<span class="badge bg-danger-subtle text-danger border">{{ audit.action }}</span>
{% else %}
<span class="badge bg-secondary-subtle text-secondary border">{{ audit.action }}</span>
{% endif %}
</div>
</li>
{% endfor %}
</ul>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-shield-check fs-2 d-block mb-1 text-secondary"></i>
<span class="small">No hay registros recientes.</span>
</div>
{% endif %}
</div>
</div>
</div>
</div>
+297
View File
@@ -0,0 +1,297 @@
<!-- ========================= [D] ALUMNO DASHBOARD ========================= -->
<!-- Alumno Welcome Compass: ¿Dónde curso hoy? -->
<div class="card border-primary border-opacity-25 shadow-sm mb-4">
<div class="card-header bg-primary bg-opacity-10 border-0 py-3 d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold text-primary">
<i class="bi bi-compass-fill me-2"></i>¿Dónde curso hoy? - Cartelera del Alumno
</h5>
<a href="/schedule/today_schedule" class="btn btn-sm btn-primary">
<i class="bi bi-calendar-day me-1"></i>Cartelera Completa
</a>
</div>
<div class="card-body p-0">
{% if role_data.today_classes %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small">
<tr>
<th class="ps-3">Horario</th>
<th>Asignatura / Carrera</th>
<th>Comisión</th>
<th>Edificio · Piso · Aula</th>
<th class="text-end pe-3">Acceso</th>
</tr>
</thead>
<tbody>
{% for cls in role_data.today_classes %}
<tr>
<td class="ps-3 font-monospace fw-bold text-primary">
<i class="bi bi-clock-fill text-warning me-1"></i>{{ cls.start_time }} - {{ cls.end_time }} hs
</td>
<td>
<div class="fw-semibold text-body">{{ cls.subject_name }}</div>
<small class="text-muted font-monospace">{{ cls.subject_code }}</small>
</td>
<td>
<span class="badge bg-secondary-subtle text-secondary border">
{{ cls.commission.code if cls.commission else 'C1' }}
</span>
</td>
<td>
{% if cls.classroom and cls.classroom.is_virtual %}
<span class="badge bg-info-subtle text-info border font-monospace">
<i class="bi bi-camera-video me-1"></i>Campus Virtual (Videollamada)
</span>
{% elif cls.classroom %}
<span class="badge bg-success-subtle text-success border font-monospace">
<i class="bi bi-building me-1"></i>{{ cls.classroom.location_display }}
</span>
{% else %}
<span class="badge bg-warning-subtle text-warning border">A confirmar</span>
{% endif %}
</td>
<td class="text-end pe-3">
{% if cls.virtual_link %}
<a href="{{ cls.virtual_link }}" target="_blank" class="btn btn-sm btn-info text-white py-1 px-2">
<i class="bi bi-box-arrow-up-right me-1"></i>Unirse a Clase
</a>
{% else %}
<span class="badge bg-body-tertiary text-muted border">
<i class="bi bi-geo-alt"></i> Presencial
</span>
{% endif %}
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-calendar-check fs-2 d-block mb-1 text-success"></i>
<p class="mb-0 fw-semibold">¡No tienes clases asignadas para el día de hoy!</p>
<small class="text-muted">Consulta el cronograma semanal para ver tus próximas fechas y horarios.</small>
</div>
{% endif %}
</div>
</div>
<!-- Alumno Visual Menu Launchpad -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<div class="d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-mortarboard text-success me-2"></i>Menú del Alumno & Herramientas de Cursada
</h5>
<span class="badge bg-success-subtle text-success border border-success-subtle">Vista Alumno</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3">
<div class="col-md-6 col-lg-3">
<a href="/schedule/today_schedule" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-primary-subtle text-primary me-3">
<i class="bi bi-geo-alt fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cartelera de Hoy</h6>
<p class="text-muted small mb-0">Dónde cursas hoy, piso y aula</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/calendar_view" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-success-subtle text-success me-3">
<i class="bi bi-calendar3 fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cronograma Semanal</h6>
<p class="text-muted small mb-0">Calendario general de cursadas</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/classrooms/list_classrooms" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-info-subtle text-info me-3">
<i class="bi bi-camera-video fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Aulas Virtuales</h6>
<p class="text-muted small mb-0">Salas y videollamadas Meet/Teams</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/my_grades" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-warning-subtle text-warning me-3">
<i class="bi bi-journal-check fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Mis Calificaciones</h6>
<p class="text-muted small mb-0">Notas, regularidad y actas</p>
</div>
</div>
</a>
</div>
</div>
</div>
</div>
<!-- Alumno Upcoming Milestones (Exámenes y Entregas) -->
{% if role_data.upcoming_milestones %}
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-bell-fill text-warning me-2"></i>Próximos Hitos Académicos & Exámenes
</h5>
</div>
<div class="card-body p-0">
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small">
<tr>
<th class="ps-3">Fecha & Cuenta Regresiva</th>
<th>Tipo de Hito</th>
<th>Materia / Código</th>
<th>Aula / Enlace</th>
<th class="pe-3">Notas</th>
</tr>
</thead>
<tbody>
{% for m in role_data.upcoming_milestones %}
<tr>
<td class="ps-3 font-monospace fw-bold text-primary">
<div>{{ m.date }}</div>
{% if m.days_remaining is not none and m.days_remaining is defined %}
{% if m.days_remaining == 0 %}
<span class="badge bg-danger text-white small">¡Hoy!</span>
{% elif m.days_remaining == 1 %}
<span class="badge bg-warning text-dark small">¡Mañana!</span>
{% elif m.days_remaining > 1 %}
<span class="badge bg-info-subtle text-info border small">Faltan {{ m.days_remaining }} días</span>
{% endif %}
{% endif %}
</td>
<td>
<span class="badge" data-color="{{ m.type_obj.color if m.type_obj else '#0d6efd' }}" style="background-color:var(--badge-bg,#0d6efd);color:#fff;">
{{ m.type_obj.name if m.type_obj else 'Evaluación' }}
</span>
</td>
<td>
<div class="fw-semibold">{{ m.title or m.materia_codigo }}</div>
<small class="text-muted font-monospace">{{ m.materia_codigo }}</small>
</td>
<td>
{% if m.link %}
<a href="{{ m.link }}" target="_blank" class="btn btn-sm btn-outline-info py-0 px-2">
<i class="bi bi-box-arrow-up-right me-1"></i>Enlace
</a>
{% else %}
<span class="text-muted small">{{ m.classroom or 'Sede Central' }}</span>
{% endif %}
</td>
<td class="pe-3 small text-muted">{{ m.notes or '-' }}</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
</div>
</div>
{% endif %}
<!-- ========================================================================= -->
<!-- 3. UPCOMING RESERVATIONS (ALL ROLES GENERAL FEED) -->
<!-- ========================================================================= -->
<div class="row">
<div class="col-12">
<div class="card border-0 shadow-sm">
<div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-clock-history text-info me-2"></i>Próximas Reservas del Campus (Próximos 7 Días)
</h5>
<a href="/schedule/calendar_view" class="btn btn-sm btn-outline-primary">
<i class="bi bi-calendar3 me-1"></i>Ver en Calendario
</a>
</div>
<div class="card-body p-0">
{% if upcoming_reservations %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small text-uppercase">
<tr>
<th class="ps-3">Fecha & Horario</th>
<th>Aula</th>
<th>Asignatura / Código</th>
<th>Turno / Comisión</th>
<th>Estado</th>
<th class="text-end pe-3">Acciones</th>
</tr>
</thead>
<tbody>
{% for reservation in upcoming_reservations %}
<tr>
<td class="ps-3">
<div class="fw-bold font-monospace text-primary small">
<i class="bi bi-calendar-event text-secondary me-1"></i>{{ reservation.start_time }}
<span class="ms-1 text-body">{{ reservation.start_time }} - {{ reservation.end_time }} hs</span>
</div>
</td>
<td>
<span class="badge bg-secondary-subtle text-secondary border font-monospace">
{{ reservation.classroom.code if reservation.classroom else 'Sin Aula' }}
</span>
</td>
<td>
<div class="fw-semibold text-primary">{{ reservation.subject_name }}</div>
<small class="text-muted font-monospace">{{ reservation.subject_code }}</small>
</td>
<td>
<span class="badge bg-info-subtle text-info border me-1">
{{ reservation.shift or 'Tarde' }}
</span>
<small class="text-muted">{{ reservation.commission.code if reservation.commission else 'C1' }}</small>
</td>
<td>
{% if reservation.status == 'CONFIRMED' or reservation.status.value == 'CONFIRMED' %}
<span class="badge bg-success-subtle text-success border border-success-subtle">
<i class="bi bi-check-circle me-1"></i>Confirmada
</span>
{% else %}
<span class="badge bg-warning-subtle text-warning border border-warning-subtle">
<i class="bi bi-clock me-1"></i>Pendiente
</span>
{% endif %}
</td>
<td class="text-end pe-3">
<a href="/schedule/view_reservation?id={{ res.id }}"
class="btn btn-sm btn-outline-secondary py-0 px-2" title="Ver Ficha">
<i class="bi bi-eye"></i>
</a>
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="text-center py-5">
<i class="bi bi-calendar-x text-muted fs-1 d-block mb-2"></i>
<h6 class="fw-bold">No hay reservas para los próximos 7 días</h6>
<p class="text-muted small">Puedes programar nuevas reservas desde el calendario.</p>
</div>
{% endif %}
</div>
</div>
</div>
</div>
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
+352
View File
@@ -0,0 +1,352 @@
<!-- ========================= [A] ADMIN DASHBOARD ========================= -->
<!-- Admin KPI Cards -->
<div class="row mb-4 g-3">
<div class="col-md-6 col-xl-3">
<a href="/classrooms/list_classrooms" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Aulas Totales</span>
<h2 class="mb-0 fw-bold mt-1 text-primary">{{ stats.total_classrooms }}</h2>
</div>
<div class="bg-primary bg-opacity-10 rounded-circle p-3 text-primary">
<i class="bi bi-door-open fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-primary small fw-semibold">
<span>Ver catálogo de espacios</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-xl-3">
<a href="/admin/subjects_list" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Oferta de Materias</span>
<h2 class="mb-0 fw-bold mt-1 text-success">{{ stats.total_subjects }}</h2>
</div>
<div class="bg-success bg-opacity-10 rounded-circle p-3 text-success">
<i class="bi bi-book fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-success small fw-semibold">
<span>Gestión académica</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-xl-3">
<a href="/admin/users_list" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Usuarios Activos</span>
<h2 class="mb-0 fw-bold mt-1 text-info">{{ stats.total_users or 1 }}</h2>
</div>
<div class="bg-info bg-opacity-10 rounded-circle p-3 text-info">
<i class="bi bi-people fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-info small fw-semibold">
<span>Control de usuarios y roles</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-xl-3">
<a href="/schedule/today_schedule" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Reservas de Hoy</span>
<h2 class="mb-0 fw-bold mt-1 text-warning">{{ stats.today_reservations }}</h2>
</div>
<div class="bg-warning bg-opacity-10 rounded-circle p-3 text-warning">
<i class="bi bi-calendar-check fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-warning small fw-semibold">
<span>Cartelera en tiempo real</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
</div>
<!-- Panel de Balance y Percentiles de Asignación de Aulas (Admin) -->
<div class="card border-0 shadow-sm mb-4" id="admin-classrooms-percentiles">
<div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center flex-wrap gap-2">
<div class="d-flex align-items-center gap-2">
<i class="bi bi-pie-chart-fill text-primary fs-5"></i>
<div>
<h5 class="mb-0 h6 fw-bold">Estado y Percentiles de Asignación de Aulas Físicas</h5>
<small class="text-muted">Balance operativo en Edificio Central (Total: {{ filter_stats.today.classrooms.total }} aulas físicas)</small>
</div>
</div>
<div class="d-flex gap-2 align-items-center flex-wrap">
<!-- Switcher de período Día / Semana / Mes (Día activo por defecto) -->
<div class="btn-group btn-group-sm" role="group" id="adminPctPeriodSwitcher">
<button type="button" class="btn btn-outline-primary active" data-period="today" onclick="switchAdminPercentiles('today')">
<i class="bi bi-calendar-day me-1"></i>Día (Hoy)
</button>
<button type="button" class="btn btn-outline-primary" data-period="tomorrow" onclick="switchAdminPercentiles('tomorrow')">
<i class="bi bi-calendar-event me-1"></i>Mañana
</button>
<button type="button" class="btn btn-outline-primary" data-period="week" onclick="switchAdminPercentiles('week')">
<i class="bi bi-calendar-week me-1"></i>Semana
</button>
<button type="button" class="btn btn-outline-primary" data-period="month" onclick="switchAdminPercentiles('month')">
<i class="bi bi-calendar-month me-1"></i>Mes
</button>
</div>
<!-- Badge explícito de fecha del período seleccionado -->
<span id="adminPctDateBadge" class="badge bg-primary text-white border px-2 py-1 font-monospace">
<i class="bi bi-calendar3 me-1"></i><span id="adminPctDateText">{{ filter_stats.today.label }}</span>
</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3 align-items-center">
<!-- Tarjeta 1: Asignadas -->
<div class="col-md-3">
<a href="/classrooms/list_classrooms?view_mode=physical" class="text-decoration-none text-reset d-block h-100">
<div class="p-3 rounded bg-success bg-opacity-10 border border-success-subtle h-100 text-center transition-all">
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="text-success small fw-bold text-uppercase">Aulas Asignadas</span>
<span class="badge bg-success text-white font-monospace" id="adminPctAssignedPct">{{ filter_stats.today.classrooms.assigned_pct }}%</span>
</div>
<div class="d-flex align-items-baseline justify-content-center gap-2 my-2">
<h2 class="mb-0 fw-bold text-success" id="adminPctAssignedCount">{{ filter_stats.today.classrooms.assigned_count }}</h2>
<span class="text-muted small">/ {{ filter_stats.today.classrooms.total }} aulas</span>
</div>
<div class="text-success small pt-2 border-top border-success-subtle d-flex align-items-center justify-content-between">
<span>Con cursadas activas</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</a>
</div>
<!-- Tarjeta 2: Sin Asignar -->
<div class="col-md-3">
<a href="/classrooms/list_classrooms?view_mode=physical" class="text-decoration-none text-reset d-block h-100">
<div class="p-3 rounded bg-warning bg-opacity-10 border border-warning-subtle h-100 text-center transition-all">
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="text-warning-emphasis small fw-bold text-uppercase">Aulas Sin Asignar</span>
<span class="badge bg-warning text-dark font-monospace" id="adminPctUnassignedPct">{{ filter_stats.today.classrooms.unassigned_pct }}%</span>
</div>
<div class="d-flex align-items-baseline justify-content-center gap-2 my-2">
<h2 class="mb-0 fw-bold text-warning-emphasis" id="adminPctUnassignedCount">{{ filter_stats.today.classrooms.unassigned_count }}</h2>
<span class="text-muted small">/ {{ filter_stats.today.classrooms.total }} aulas</span>
</div>
<div class="text-warning-emphasis small pt-2 border-top border-warning-subtle d-flex align-items-center justify-content-between">
<span>Espacios disponibles</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</a>
</div>
<!-- Tarjeta 3: Barras Comparativas de Percentil -->
<div class="col-md-6">
<div class="p-3 rounded bg-body-tertiary border h-100 d-flex flex-column justify-content-center">
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="small fw-semibold text-body">
<i class="bi bi-pie-chart me-1 text-primary"></i>Ocupación en <span id="adminPctPeriodTitle">Día (Hoy)</span>:
</span>
<span class="small font-monospace text-muted" id="adminPctLegendText">
<strong class="text-success" id="adminPctLegendAssigned">{{ filter_stats.today.classrooms.assigned_count }} asignadas ({{ filter_stats.today.classrooms.assigned_pct }}%)</strong> · <strong class="text-warning-emphasis" id="adminPctLegendUnassigned">{{ filter_stats.today.classrooms.unassigned_count }} libres ({{ filter_stats.today.classrooms.unassigned_pct }}%)</strong>
</span>
</div>
<div class="progress mb-3" style="height: 14px;">
<div id="adminPctProgressBarAssigned" class="progress-bar bg-success progress-bar-striped" role="progressbar"
{{ ('style="width: ' ~ (filter_stats.today.classrooms.assigned_pct or 0) ~ '%;"') | safe }}
aria-valuenow="{{ filter_stats.today.classrooms.assigned_pct }}" aria-valuemin="0" aria-valuemax="100">
<span id="adminPctBarTextAssigned">{{ filter_stats.today.classrooms.assigned_pct }}%</span>
</div>
<div id="adminPctProgressBarUnassigned" class="progress-bar bg-warning" role="progressbar"
{{ ('style="width: ' ~ (filter_stats.today.classrooms.unassigned_pct or 0) ~ '%;"') | safe }}
aria-valuenow="{{ filter_stats.today.classrooms.unassigned_pct }}" aria-valuemin="0" aria-valuemax="100">
<span id="adminPctBarTextUnassigned">{{ filter_stats.today.classrooms.unassigned_pct }}%</span>
</div>
</div>
<!-- Comparador de referencia cuatrimestral -->
<div class="d-flex justify-content-between align-items-center mb-1">
<span class="small fw-semibold text-secondary">
<i class="bi bi-calendar-range me-1"></i>Referencia Cuatrimestral Global:
</span>
<span class="small font-monospace text-muted">
{{ stats.assigned_classrooms_pct }}% asignadas · {{ stats.unassigned_classrooms_pct }}% libres
</span>
</div>
<div class="progress" style="height: 8px;">
<div class="progress-bar bg-secondary" role="progressbar" {{ ('style="width: ' ~ (stats.assigned_classrooms_pct or 0) ~ '%;"') | safe }}></div>
<div class="progress-bar bg-secondary-subtle" role="progressbar" {{ ('style="width: ' ~ (stats.unassigned_classrooms_pct or 0) ~ '%;"') | safe }}></div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
<!-- Admin Visual Menu Launchpad -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<div class="d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-grid-3x3-gap-fill text-primary me-2"></i>Módulos de Gestión & Visualización de Menús
</h5>
<span class="badge bg-primary-subtle text-primary border border-primary-subtle">Vista Administrador</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3">
<div class="col-md-6 col-lg-3">
<a href="/classrooms/list_classrooms" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-primary-subtle text-primary me-3">
<i class="bi bi-door-open fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Espacios & Sedes</h6>
<p class="text-muted small mb-0">Aulas físicas, virtuales y edificios</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/calendar_view" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-info-subtle text-info me-3">
<i class="bi bi-calendar-week fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cronograma & Reservas</h6>
<p class="text-muted small mb-0">Calendario, cartelera y reservas</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/genetic_algorithm_web/genetic_optimizer" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-warning-subtle text-warning me-3">
<i class="bi bi-cpu fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Optimizador IA</h6>
<p class="text-muted small mb-0">Asignación genética inteligente</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/admin/audit_logs" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-danger-subtle text-danger me-3">
<i class="bi bi-shield-lock fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Auditoría & RBAC</h6>
<p class="text-muted small mb-0">Trazabilidad y control de permisos</p>
</div>
</div>
</a>
</div>
</div>
</div>
</div>
<!-- Admin Analytics & Audit Row -->
<div class="row mb-4">
<!-- Monthly Chart -->
<div class="col-lg-8 mb-4 mb-lg-0">
<div class="card border-0 shadow-sm h-100 glass-card">
<div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-graph-up text-primary me-2"></i>Tendencia de Ocupación y Reservas Mensuales
</h5>
<a href="/admin/occupancy_metrics" class="btn btn-sm btn-outline-primary">
<i class="bi bi-bar-chart me-1"></i>Métricas Detalladas
</a>
</div>
<div class="card-body p-3">
<div style="position: relative; height: 260px; max-height: 260px; width: 100%;">
<canvas id="monthlyChart"></canvas>
</div>
</div>
</div>
</div>
<!-- Recent Audit Logs -->
<div class="col-lg-4">
<div class="card border-0 shadow-sm h-100 glass-card">
<div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-shield-check text-success me-2"></i>Últimos Eventos de Auditoría
</h5>
<a href="/admin/audit_logs" class="btn btn-sm btn-outline-secondary py-0 px-2">
Ver todo
</a>
</div>
<div class="card-body p-0">
{% if role_data.recent_audits %}
<ul class="list-group list-group-flush small">
{% for audit in role_data.recent_audits %}
<li class="list-group-item d-flex justify-content-between align-items-center py-2 px-3">
<div>
<div class="fw-semibold text-truncate" style="max-width: 180px;">
{{ audit.user_email or 'Sistema' }}
</div>
<span class="text-muted font-monospace" style="font-size: 0.72rem;">
{{ audit.created_at }} · {{ audit.module }}
</span>
</div>
<div>
{% if audit.action == 'CREATE' %}
<span class="badge bg-success-subtle text-success border">{{ audit.action }}</span>
{% elif audit.action == 'UPDATE' %}
<span class="badge bg-primary-subtle text-primary border">{{ audit.action }}</span>
{% elif audit.action == 'DELETE' %}
<span class="badge bg-danger-subtle text-danger border">{{ audit.action }}</span>
{% else %}
<span class="badge bg-secondary-subtle text-secondary border">{{ audit.action }}</span>
{% endif %}
</div>
</li>
{% endfor %}
</ul>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-shield-check fs-2 d-block mb-1 text-secondary"></i>
<span class="small">No hay registros recientes.</span>
</div>
{% endif %}
</div>
</div>
</div>
</div>
+297
View File
@@ -0,0 +1,297 @@
<!-- ========================= [D] ALUMNO DASHBOARD ========================= -->
<!-- Alumno Welcome Compass: ¿Dónde curso hoy? -->
<div class="card border-primary border-opacity-25 shadow-sm mb-4">
<div class="card-header bg-primary bg-opacity-10 border-0 py-3 d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold text-primary">
<i class="bi bi-compass-fill me-2"></i>¿Dónde curso hoy? - Cartelera del Alumno
</h5>
<a href="/schedule/today_schedule" class="btn btn-sm btn-primary">
<i class="bi bi-calendar-day me-1"></i>Cartelera Completa
</a>
</div>
<div class="card-body p-0">
{% if role_data.today_classes %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small">
<tr>
<th class="ps-3">Horario</th>
<th>Asignatura / Carrera</th>
<th>Comisión</th>
<th>Edificio · Piso · Aula</th>
<th class="text-end pe-3">Acceso</th>
</tr>
</thead>
<tbody>
{% for cls in role_data.today_classes %}
<tr>
<td class="ps-3 font-monospace fw-bold text-primary">
<i class="bi bi-clock-fill text-warning me-1"></i>{{ cls.start_time }} - {{ cls.end_time }} hs
</td>
<td>
<div class="fw-semibold text-body">{{ cls.subject_name }}</div>
<small class="text-muted font-monospace">{{ cls.subject_code }}</small>
</td>
<td>
<span class="badge bg-secondary-subtle text-secondary border">
{{ cls.commission.code if cls.commission else 'C1' }}
</span>
</td>
<td>
{% if cls.classroom and cls.classroom.is_virtual %}
<span class="badge bg-info-subtle text-info border font-monospace">
<i class="bi bi-camera-video me-1"></i>Campus Virtual (Videollamada)
</span>
{% elif cls.classroom %}
<span class="badge bg-success-subtle text-success border font-monospace">
<i class="bi bi-building me-1"></i>{{ cls.classroom.location_display }}
</span>
{% else %}
<span class="badge bg-warning-subtle text-warning border">A confirmar</span>
{% endif %}
</td>
<td class="text-end pe-3">
{% if cls.virtual_link %}
<a href="{{ cls.virtual_link }}" target="_blank" class="btn btn-sm btn-info text-white py-1 px-2">
<i class="bi bi-box-arrow-up-right me-1"></i>Unirse a Clase
</a>
{% else %}
<span class="badge bg-body-tertiary text-muted border">
<i class="bi bi-geo-alt"></i> Presencial
</span>
{% endif %}
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-calendar-check fs-2 d-block mb-1 text-success"></i>
<p class="mb-0 fw-semibold">¡No tienes clases asignadas para el día de hoy!</p>
<small class="text-muted">Consulta el cronograma semanal para ver tus próximas fechas y horarios.</small>
</div>
{% endif %}
</div>
</div>
<!-- Alumno Visual Menu Launchpad -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<div class="d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-mortarboard text-success me-2"></i>Menú del Alumno & Herramientas de Cursada
</h5>
<span class="badge bg-success-subtle text-success border border-success-subtle">Vista Alumno</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3">
<div class="col-md-6 col-lg-3">
<a href="/schedule/today_schedule" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-primary-subtle text-primary me-3">
<i class="bi bi-geo-alt fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cartelera de Hoy</h6>
<p class="text-muted small mb-0">Dónde cursas hoy, piso y aula</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/calendar_view" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-success-subtle text-success me-3">
<i class="bi bi-calendar3 fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cronograma Semanal</h6>
<p class="text-muted small mb-0">Calendario general de cursadas</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/classrooms/list_classrooms" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-info-subtle text-info me-3">
<i class="bi bi-camera-video fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Aulas Virtuales</h6>
<p class="text-muted small mb-0">Salas y videollamadas Meet/Teams</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/my_grades" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-warning-subtle text-warning me-3">
<i class="bi bi-journal-check fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Mis Calificaciones</h6>
<p class="text-muted small mb-0">Notas, regularidad y actas</p>
</div>
</div>
</a>
</div>
</div>
</div>
</div>
<!-- Alumno Upcoming Milestones (Exámenes y Entregas) -->
{% if role_data.upcoming_milestones %}
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-bell-fill text-warning me-2"></i>Próximos Hitos Académicos & Exámenes
</h5>
</div>
<div class="card-body p-0">
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small">
<tr>
<th class="ps-3">Fecha & Cuenta Regresiva</th>
<th>Tipo de Hito</th>
<th>Materia / Código</th>
<th>Aula / Enlace</th>
<th class="pe-3">Notas</th>
</tr>
</thead>
<tbody>
{% for m in role_data.upcoming_milestones %}
<tr>
<td class="ps-3 font-monospace fw-bold text-primary">
<div>{{ m.date }}</div>
{% if m.days_remaining is not none and m.days_remaining is defined %}
{% if m.days_remaining == 0 %}
<span class="badge bg-danger text-white small">¡Hoy!</span>
{% elif m.days_remaining == 1 %}
<span class="badge bg-warning text-dark small">¡Mañana!</span>
{% elif m.days_remaining > 1 %}
<span class="badge bg-info-subtle text-info border small">Faltan {{ m.days_remaining }} días</span>
{% endif %}
{% endif %}
</td>
<td>
<span class="badge" data-color="{{ m.type_obj.color if m.type_obj else '#0d6efd' }}" style="background-color:var(--badge-bg,#0d6efd);color:#fff;">
{{ m.type_obj.name if m.type_obj else 'Evaluación' }}
</span>
</td>
<td>
<div class="fw-semibold">{{ m.title or m.materia_codigo }}</div>
<small class="text-muted font-monospace">{{ m.materia_codigo }}</small>
</td>
<td>
{% if m.link %}
<a href="{{ m.link }}" target="_blank" class="btn btn-sm btn-outline-info py-0 px-2">
<i class="bi bi-box-arrow-up-right me-1"></i>Enlace
</a>
{% else %}
<span class="text-muted small">{{ m.classroom or 'Sede Central' }}</span>
{% endif %}
</td>
<td class="pe-3 small text-muted">{{ m.notes or '-' }}</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
</div>
</div>
{% endif %}
<!-- ========================================================================= -->
<!-- 3. UPCOMING RESERVATIONS (ALL ROLES GENERAL FEED) -->
<!-- ========================================================================= -->
<div class="row">
<div class="col-12">
<div class="card border-0 shadow-sm">
<div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-clock-history text-info me-2"></i>Próximas Reservas del Campus (Próximos 7 Días)
</h5>
<a href="/schedule/calendar_view" class="btn btn-sm btn-outline-primary">
<i class="bi bi-calendar3 me-1"></i>Ver en Calendario
</a>
</div>
<div class="card-body p-0">
{% if upcoming_reservations %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small text-uppercase">
<tr>
<th class="ps-3">Fecha & Horario</th>
<th>Aula</th>
<th>Asignatura / Código</th>
<th>Turno / Comisión</th>
<th>Estado</th>
<th class="text-end pe-3">Acciones</th>
</tr>
</thead>
<tbody>
{% for reservation in upcoming_reservations %}
<tr>
<td class="ps-3">
<div class="fw-bold font-monospace text-primary small">
<i class="bi bi-calendar-event text-secondary me-1"></i>{{ reservation.start_time }}
<span class="ms-1 text-body">{{ reservation.start_time }} - {{ reservation.end_time }} hs</span>
</div>
</td>
<td>
<span class="badge bg-secondary-subtle text-secondary border font-monospace">
{{ reservation.classroom.code if reservation.classroom else 'Sin Aula' }}
</span>
</td>
<td>
<div class="fw-semibold text-primary">{{ reservation.subject_name }}</div>
<small class="text-muted font-monospace">{{ reservation.subject_code }}</small>
</td>
<td>
<span class="badge bg-info-subtle text-info border me-1">
{{ reservation.shift or 'Tarde' }}
</span>
<small class="text-muted">{{ reservation.commission.code if reservation.commission else 'C1' }}</small>
</td>
<td>
{% if reservation.status == 'CONFIRMED' or reservation.status.value == 'CONFIRMED' %}
<span class="badge bg-success-subtle text-success border border-success-subtle">
<i class="bi bi-check-circle me-1"></i>Confirmada
</span>
{% else %}
<span class="badge bg-warning-subtle text-warning border border-warning-subtle">
<i class="bi bi-clock me-1"></i>Pendiente
</span>
{% endif %}
</td>
<td class="text-end pe-3">
<a href="/schedule/view_reservation?id={{ res.id }}"
class="btn btn-sm btn-outline-secondary py-0 px-2" title="Ver Ficha">
<i class="bi bi-eye"></i>
</a>
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="text-center py-5">
<i class="bi bi-calendar-x text-muted fs-1 d-block mb-2"></i>
<h6 class="fw-bold">No hay reservas para los próximos 7 días</h6>
<p class="text-muted small">Puedes programar nuevas reservas desde el calendario.</p>
</div>
{% endif %}
</div>
</div>
</div>
</div>
File diff suppressed because it is too large Load Diff
+211
View File
@@ -0,0 +1,211 @@
<!-- ========================= [C] DOCENTE DASHBOARD ========================= -->
<!-- Docente KPI Cards -->
<div class="row mb-4 g-3">
<div class="col-md-4 col-xl-4">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Mis Clases Hoy</span>
<h2 class="mb-0 fw-bold mt-1 text-primary">{{ stats.my_today_count }}</h2>
</div>
<div class="bg-primary bg-opacity-10 rounded-circle p-3 text-primary">
<i class="bi bi-clock-history fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-primary small fw-semibold">
<span>Sesiones del día</span>
<i class="bi bi-check2-circle"></i>
</div>
</div>
</div>
</div>
<div class="col-md-4 col-xl-4">
<a href="/schedule/list_reservations" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Mis Reservas Activas</span>
<h2 class="mb-0 fw-bold mt-1 text-success">{{ stats.my_total_reservations }}</h2>
</div>
<div class="bg-success bg-opacity-10 rounded-circle p-3 text-success">
<i class="bi bi-calendar-check fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-success small fw-semibold">
<span>Ver todas mis reservas</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-4 col-xl-4">
<a href="/classrooms/list_classrooms?view_mode=virtual" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Aulas Virtuales</span>
<h2 class="mb-0 fw-bold mt-1 text-info">{{ stats.virtual_rooms_count }}</h2>
</div>
<div class="bg-info bg-opacity-10 rounded-circle p-3 text-info">
<i class="bi bi-camera-video fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-info small fw-semibold">
<span>Acceso a salas virtuales</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
</div>
<!-- Docente Launchpad -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<div class="d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-compass text-info me-2"></i>Accesos Directos de Docencia & Visualización de Menús
</h5>
<span class="badge bg-info-subtle text-info border border-info-subtle">Vista Profesor</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3">
<div class="col-md-6 col-lg-3">
<a href="/schedule/add_reservation" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-success-subtle text-success me-3">
<i class="bi bi-calendar-plus fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Solicitar Aula</h6>
<p class="text-muted small mb-0">Reserva de espacio o laboratorio</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/commissions_view" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-primary-subtle text-primary me-3">
<i class="bi bi-diagram-3 fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Mis Comisiones</h6>
<p class="text-muted small mb-0">Ver comisiones y turnos asignados</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/today_schedule" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-info-subtle text-info me-3">
<i class="bi bi-calendar-day fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cartelera del Día</h6>
<p class="text-muted small mb-0">Consulta de aulas asignadas</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/classrooms/list_classrooms" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-warning-subtle text-warning me-3">
<i class="bi bi-camera-video fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Aulas Virtuales</h6>
<p class="text-muted small mb-0">Salas y enlaces de reunión</p>
</div>
</div>
</a>
</div>
</div>
</div>
</div>
<!-- Docente: Mis Clases de Hoy -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-calendar-check text-primary me-2"></i>Mis Clases Programadas para Hoy
</h5>
<span class="badge bg-primary-subtle text-primary border">{{ role_data.my_today_classes|length }} hoy</span>
</div>
<div class="card-body p-0">
{% if role_data.my_today_classes %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small">
<tr>
<th class="ps-3">Horario</th>
<th>Materia & Código</th>
<th>Comisión / Turno</th>
<th>Ubicación / Aula</th>
<th class="text-end pe-3">Acción</th>
</tr>
</thead>
<tbody>
{% for c in role_data.my_today_classes %}
<tr>
<td class="ps-3 font-monospace fw-bold text-primary">
<i class="bi bi-clock me-1 text-warning"></i>{{ c.start_time }} - {{ c.end_time }} hs
</td>
<td>
<div class="fw-semibold">{{ c.subject_name }}</div>
<small class="text-muted font-monospace">{{ c.subject_code }}</small>
</td>
<td>
<span class="badge bg-secondary-subtle text-secondary border">{{ c.commission.code if c.commission else 'C1' }}</span>
</td>
<td>
{% if c.classroom and c.classroom.is_virtual %}
<span class="badge bg-info-subtle text-info border">
<i class="bi bi-camera-video me-1"></i>Aula Virtual
</span>
{% elif c.classroom %}
<span class="badge bg-primary-subtle text-primary border">
<i class="bi bi-geo-alt me-1"></i>{{ c.classroom.location_display }}
</span>
{% else %}
<span class="text-muted small">Sin aula asignada</span>
{% endif %}
</td>
<td class="text-end pe-3">
{% if c.virtual_link %}
<a href="{{ c.virtual_link }}" target="_blank" class="btn btn-sm btn-info text-white py-1 px-2">
<i class="bi bi-box-arrow-up-right me-1"></i>Ingresar a Reunión
</a>
{% else %}
<a href="/schedule/view_reservation?id={{ c.id }}" class="btn btn-sm btn-outline-secondary py-1 px-2">
<i class="bi bi-eye"></i>
</a>
{% endif %}
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-cup-hot fs-2 d-block mb-1 text-primary"></i>
<p class="mb-0 fw-semibold">No tienes clases programadas para hoy.</p>
<small class="text-muted">Puedes revisar tus reservas futuras en el calendario institucional.</small>
</div>
{% endif %}
</div>
</div>
+211
View File
@@ -0,0 +1,211 @@
<!-- ========================= [C] DOCENTE DASHBOARD ========================= -->
<!-- Docente KPI Cards -->
<div class="row mb-4 g-3">
<div class="col-md-4 col-xl-4">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Mis Clases Hoy</span>
<h2 class="mb-0 fw-bold mt-1 text-primary">{{ stats.my_today_count }}</h2>
</div>
<div class="bg-primary bg-opacity-10 rounded-circle p-3 text-primary">
<i class="bi bi-clock-history fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-primary small fw-semibold">
<span>Sesiones del día</span>
<i class="bi bi-check2-circle"></i>
</div>
</div>
</div>
</div>
<div class="col-md-4 col-xl-4">
<a href="/schedule/list_reservations" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Mis Reservas Activas</span>
<h2 class="mb-0 fw-bold mt-1 text-success">{{ stats.my_total_reservations }}</h2>
</div>
<div class="bg-success bg-opacity-10 rounded-circle p-3 text-success">
<i class="bi bi-calendar-check fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-success small fw-semibold">
<span>Ver todas mis reservas</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
<div class="col-md-4 col-xl-4">
<a href="/classrooms/list_classrooms?view_mode=virtual" class="text-decoration-none text-reset d-block h-100">
<div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all glass-card">
<div class="card-body p-3">
<div class="d-flex justify-content-between align-items-center">
<div>
<span class="text-muted small fw-semibold text-uppercase">Aulas Virtuales</span>
<h2 class="mb-0 fw-bold mt-1 text-info">{{ stats.virtual_rooms_count }}</h2>
</div>
<div class="bg-info bg-opacity-10 rounded-circle p-3 text-info">
<i class="bi bi-camera-video fs-3"></i>
</div>
</div>
<div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-info small fw-semibold">
<span>Acceso a salas virtuales</span>
<i class="bi bi-arrow-right"></i>
</div>
</div>
</div>
</a>
</div>
</div>
<!-- Docente Launchpad -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3">
<div class="d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-compass text-info me-2"></i>Accesos Directos de Docencia & Visualización de Menús
</h5>
<span class="badge bg-info-subtle text-info border border-info-subtle">Vista Profesor</span>
</div>
</div>
<div class="card-body p-3">
<div class="row g-3">
<div class="col-md-6 col-lg-3">
<a href="/schedule/add_reservation" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-success-subtle text-success me-3">
<i class="bi bi-calendar-plus fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Solicitar Aula</h6>
<p class="text-muted small mb-0">Reserva de espacio o laboratorio</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/commissions_view" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-primary-subtle text-primary me-3">
<i class="bi bi-diagram-3 fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Mis Comisiones</h6>
<p class="text-muted small mb-0">Ver comisiones y turnos asignados</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/schedule/today_schedule" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-info-subtle text-info me-3">
<i class="bi bi-calendar-day fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Cartelera del Día</h6>
<p class="text-muted small mb-0">Consulta de aulas asignadas</p>
</div>
</div>
</a>
</div>
<div class="col-md-6 col-lg-3">
<a href="/classrooms/list_classrooms" class="card h-100 p-3 action-menu-card bg-body">
<div class="d-flex align-items-center">
<div class="quick-icon-circle bg-warning-subtle text-warning me-3">
<i class="bi bi-camera-video fs-4"></i>
</div>
<div>
<h6 class="mb-1 fw-bold text-body">Aulas Virtuales</h6>
<p class="text-muted small mb-0">Salas y enlaces de reunión</p>
</div>
</div>
</a>
</div>
</div>
</div>
</div>
<!-- Docente: Mis Clases de Hoy -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-calendar-check text-primary me-2"></i>Mis Clases Programadas para Hoy
</h5>
<span class="badge bg-primary-subtle text-primary border">{{ role_data.my_today_classes|length }} hoy</span>
</div>
<div class="card-body p-0">
{% if role_data.my_today_classes %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small">
<tr>
<th class="ps-3">Horario</th>
<th>Materia & Código</th>
<th>Comisión / Turno</th>
<th>Ubicación / Aula</th>
<th class="text-end pe-3">Acción</th>
</tr>
</thead>
<tbody>
{% for c in role_data.my_today_classes %}
<tr>
<td class="ps-3 font-monospace fw-bold text-primary">
<i class="bi bi-clock me-1 text-warning"></i>{{ c.start_time }} - {{ c.end_time }} hs
</td>
<td>
<div class="fw-semibold">{{ c.subject_name }}</div>
<small class="text-muted font-monospace">{{ c.subject_code }}</small>
</td>
<td>
<span class="badge bg-secondary-subtle text-secondary border">{{ c.commission.code if c.commission else 'C1' }}</span>
</td>
<td>
{% if c.classroom and c.classroom.is_virtual %}
<span class="badge bg-info-subtle text-info border">
<i class="bi bi-camera-video me-1"></i>Aula Virtual
</span>
{% elif c.classroom %}
<span class="badge bg-primary-subtle text-primary border">
<i class="bi bi-geo-alt me-1"></i>{{ c.classroom.location_display }}
</span>
{% else %}
<span class="text-muted small">Sin aula asignada</span>
{% endif %}
</td>
<td class="text-end pe-3">
{% if c.virtual_link %}
<a href="{{ c.virtual_link }}" target="_blank" class="btn btn-sm btn-info text-white py-1 px-2">
<i class="bi bi-box-arrow-up-right me-1"></i>Ingresar a Reunión
</a>
{% else %}
<a href="/schedule/view_reservation?id={{ c.id }}" class="btn btn-sm btn-outline-secondary py-1 px-2">
<i class="bi bi-eye"></i>
</a>
{% endif %}
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-cup-hot fs-2 d-block mb-1 text-primary"></i>
<p class="mb-0 fw-semibold">No tienes clases programadas para hoy.</p>
<small class="text-muted">Puedes revisar tus reservas futuras en el calendario institucional.</small>
</div>
{% endif %}
</div>
</div>
+221 -150
View File
@@ -1,6 +1,6 @@
{% extends "base.html" %} {% extends "base.html" %}
{% block title %}AI Room Reservation Optimizer - Edu-Space Admin{% endblock %} {% block title %}Optimizador de Aulas (IA) - Edu-Space Admin{% endblock %}
{% block extra_css %} {% block extra_css %}
<style> <style>
@@ -39,7 +39,8 @@
left: 0; left: 0;
width: 100%; width: 100%;
height: 100%; height: 100%;
background-color: rgba(0, 0, 0, 0.7); background-color: rgba(0, 0, 0, 0.75);
backdrop-filter: blur(4px);
display: none; display: none;
justify-content: center; justify-content: center;
align-items: center; align-items: center;
@@ -47,8 +48,8 @@
} }
.hero-banner { .hero-banner {
background: linear-gradient(135deg, rgba(37, 99, 235, 0.2) 0%, rgba(30, 41, 59, 0.9) 100%); background: linear-gradient(135deg, rgba(37, 99, 235, 0.15) 0%, rgba(30, 41, 59, 0.85) 100%);
border: 1px solid rgba(255, 255, 255, 0.1); border: 1px solid rgba(255, 255, 255, 0.12);
border-radius: 12px; border-radius: 12px;
} }
</style> </style>
@@ -56,21 +57,21 @@
{% block content %} {% block content %}
<div class="container-fluid pt-5 mt-4"> <div class="container-fluid pt-5 mt-4">
<!-- Header --> <!-- Hero Header -->
<div class="row mb-4"> <div class="row mb-4">
<div class="col-12"> <div class="col-12">
<div class="card hero-banner border-0 shadow-sm p-3"> <div class="card hero-banner border-0 shadow-sm p-3">
<div class="card-body"> <div class="card-body">
<div class="d-flex align-items-center mb-2"> <div class="d-flex align-items-center mb-2 flex-wrap gap-3">
<div class="bg-primary bg-opacity-25 rounded-3 p-3 me-3 text-primary"> <div class="bg-primary bg-opacity-25 rounded-3 p-3 text-primary">
<i class="bi bi-cpu fs-2"></i> <i class="bi bi-cpu fs-1"></i>
</div> </div>
<div> <div>
<h1 class="h3 mb-1 fw-bold"> <h1 class="h3 mb-1 fw-bold">
AI Room Reservation Optimizer Optimizador Inteligente de Asignación de Aulas (IA)
</h1> </h1>
<p class="text-muted mb-0"> <p class="text-muted mb-0">
Use genetic algorithms to automatically optimize room assignments based on capacity, availability, and student enrollment. Utiliza algoritmos genéticos evolutivos para optimizar la asignación física de espacios áulicos según aforo, turnos y disponibilidad horaria de UniCABA.
</p> </p>
</div> </div>
</div> </div>
@@ -81,126 +82,140 @@
<!-- Algorithm Status & Commission Selection --> <!-- Algorithm Status & Commission Selection -->
<div class="row mb-4"> <div class="row mb-4">
<!-- Algorithm Status Card --> <!-- Columna Izquierda: Estado del Algoritmo y Controles -->
<div class="col-lg-4 mb-4"> <div class="col-lg-4 mb-4">
<div class="algorithm-status" style="z-index: 10;"> <div class="algorithm-status" style="z-index: 10;">
<!-- Tarjeta 1: Estado del Sistema -->
<div class="card border-0 shadow-sm mb-4"> <div class="card border-0 shadow-sm mb-4">
<div class="card-header bg-body-tertiary border-0 py-3"> <div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold"> <h5 class="mb-0 h6 fw-bold">
<i class="bi bi-gear-wide-connected text-primary me-2"></i> <i class="bi bi-gear-wide-connected text-primary me-2"></i>
Algorithm Status Estado del Algoritmo
</h5> </h5>
</div>
<div class="card-body">
<div class="mb-4">
<small class="text-muted text-uppercase fw-semibold d-block mb-2">System Status</small>
<div class="d-flex justify-content-between align-items-center py-1 border-bottom border-body-secondary">
<span>Available Classrooms</span>
<span class="badge bg-success" id="available-classrooms">--</span>
</div>
<div class="d-flex justify-content-between align-items-center py-1 border-bottom border-body-secondary">
<span>Active Commissions</span>
<span class="badge bg-info" id="active-commissions">--</span>
</div>
<div class="d-flex justify-content-between align-items-center py-1">
<span>Existing Reservations</span>
<span class="badge bg-secondary" id="existing-reservations">--</span>
</div>
</div> </div>
<div class="card-body">
<div class="mb-4"> <div class="mb-3">
<small class="text-muted text-uppercase fw-semibold d-block mb-2">Algorithm Configuration</small> <small class="text-muted text-uppercase fw-semibold d-block mb-2">Métricas del Sistema</small>
<div class="d-flex justify-content-between align-items-center py-1 border-bottom border-body-secondary"> <div class="d-flex justify-content-between align-items-center py-2 border-bottom border-body-secondary">
<span>Population Size</span> <span class="small fw-semibold"><i class="bi bi-door-open text-success me-1"></i>Aulas Disponibles</span>
<span class="text-muted">50</span> <span class="badge bg-success font-monospace fs-6" id="available-classrooms">--</span>
</div> </div>
<div class="d-flex justify-content-between align-items-center py-1 border-bottom border-body-secondary"> <div class="d-flex justify-content-between align-items-center py-2 border-bottom border-body-secondary">
<span>Generations</span> <span class="small fw-semibold"><i class="bi bi-diagram-3 text-info me-1"></i>Comisiones Activas</span>
<span class="text-muted">100</span> <span class="badge bg-info font-monospace fs-6" id="active-commissions">--</span>
</div> </div>
<div class="d-flex justify-content-between align-items-center py-1"> <div class="d-flex justify-content-between align-items-center py-2">
<span>Mutation Rate</span> <span class="small fw-semibold"><i class="bi bi-calendar-check text-secondary me-1"></i>Reservas Confirmadas</span>
<span class="text-muted">10%</span> <span class="badge bg-secondary font-monospace fs-6" id="existing-reservations">--</span>
</div>
</div>
<button class="btn btn-sm btn-outline-primary w-100" onclick="window.refreshStatus()">
<i class="bi bi-arrow-clockwise me-1"></i>
Refresh Status
</button>
</div>
</div>
<!-- Optimization Controls -->
<div class="card border-0 shadow-sm">
<div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-sliders text-primary me-2"></i>
Optimization Controls
</h5>
</div>
<div class="card-body">
<div class="row align-items-center mb-3">
<div class="col-12">
<div class="mb-3">
<label for="start-date" class="form-label">Start Date</label>
<input type="datetime-local" class="form-control" id="start-date" name="start_date">
</div> </div>
</div> </div>
<div class="col-12">
<div class="mb-3"> <div class="mb-3">
<label for="end-date" class="form-label">End Date</label> <small class="text-muted text-uppercase fw-semibold d-block mb-2">Parámetros Evolutivos</small>
<input type="datetime-local" class="form-control" id="end-date" name="end_date"> <div class="d-flex justify-content-between align-items-center py-1 border-bottom border-body-secondary small">
<span>Tamaño de Población</span>
<span class="font-monospace fw-bold">50 individuos</span>
</div>
<div class="d-flex justify-content-between align-items-center py-1 border-bottom border-body-secondary small">
<span>Generaciones</span>
<span class="font-monospace fw-bold">100 iteraciones</span>
</div>
<div class="d-flex justify-content-between align-items-center py-1 small">
<span>Tasa de Mutación</span>
<span class="font-monospace fw-bold">10%</span>
</div> </div>
</div> </div>
</div>
<div class="d-grid gap-2"> <button class="btn btn-sm btn-outline-primary w-100" onclick="window.refreshStatus()">
<button class="btn btn-info text-white" id="preview-optimization-btn"> <i class="bi bi-arrow-clockwise me-1"></i>
<i class="bi bi-eye me-1"></i> Actualizar Estado
Preview
</button>
<button class="btn btn-success" id="optimize-assignments-btn">
<i class="bi bi-play-circle me-1"></i>
Run Full Optimization
</button>
<button class="btn btn-warning" id="apply-optimization-btn" style="display: none;">
<i class="bi bi-check-circle me-1"></i>
Apply
</button>
<button class="btn btn-outline-secondary" onclick="resetOptimization()">
<i class="bi bi-arrow-counterclockwise me-1"></i>
Reset
</button> </button>
</div> </div>
</div> </div>
<!-- Tarjeta 2: Controles de Optimización -->
<div class="card border-0 shadow-sm">
<div class="card-header bg-body-tertiary border-0 py-3">
<h5 class="mb-0 h6 fw-bold">
<i class="bi bi-sliders text-primary me-2"></i>
Controles de Optimización
</h5>
</div>
<div class="card-body">
<div class="row align-items-center mb-3">
<div class="col-12">
<div class="mb-2">
<label for="start-date" class="form-label small fw-semibold">Fecha y Hora de Inicio</label>
<input type="datetime-local" class="form-control form-control-sm" id="start-date" name="start_date">
</div>
</div>
<div class="col-12">
<div class="mb-2">
<label for="end-date" class="form-label small fw-semibold">Fecha y Hora de Fin</label>
<input type="datetime-local" class="form-control form-control-sm" id="end-date" name="end_date">
</div>
</div>
</div>
<div class="d-grid gap-2">
<button class="btn btn-info text-white fw-semibold" id="preview-optimization-btn">
<i class="bi bi-eye me-1"></i>
Previsualizar Asignación
</button>
<button class="btn btn-success fw-semibold" id="optimize-assignments-btn">
<i class="bi bi-play-circle me-1"></i>
Ejecutar Optimización Completa
</button>
<button class="btn btn-warning fw-bold" id="apply-optimization-btn" style="display: none;">
<i class="bi bi-check-circle me-1"></i>
Aplicar Asignaciones
</button>
<button class="btn btn-outline-secondary btn-sm" onclick="resetOptimization()">
<i class="bi bi-arrow-counterclockwise me-1"></i>
Restablecer Selección
</button>
</div>
</div>
</div>
</div> </div>
</div> </div>
</div>
<!-- Commission Selection --> <!-- Columna Derecha: Selección de Comisiones -->
<div class="col-lg-8"> <div class="col-lg-8">
<div class="card border-0 shadow-sm"> <div class="card border-0 shadow-sm">
<div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center"> <div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center flex-wrap gap-2">
<h5 class="mb-0 h6 fw-bold"> <div>
<i class="bi bi-list-check text-primary me-2"></i> <h5 class="mb-0 h6 fw-bold">
Select Commissions to Optimize <i class="bi bi-list-check text-primary me-2"></i>
</h5> Seleccionar Comisiones a Optimizar
</h5>
<small class="text-muted" id="commissions-count-badge">Cargando comisiones de cursada...</small>
</div>
<div class="d-flex gap-2"> <div class="d-flex gap-2">
<button class="btn btn-sm btn-outline-primary" onclick="selectAllCommissions()"> <button class="btn btn-sm btn-outline-primary" onclick="selectAllCommissions()">
Select All <i class="bi bi-check-all me-1"></i>Seleccionar Todas
</button> </button>
<button class="btn btn-sm btn-outline-secondary" onclick="deselectAllCommissions()"> <button class="btn btn-sm btn-outline-secondary" onclick="deselectAllCommissions()">
Deselect All <i class="bi bi-dash me-1"></i>Deseleccionar
</button> </button>
</div> </div>
</div> </div>
<div class="card-body">
<div id="commissions-list" class="row"> <!-- Buscador rápido en vivo -->
<!-- Commissions will be loaded here --> <div class="card-body border-bottom bg-body-tertiary py-2">
<div class="input-group input-group-sm">
<span class="input-group-text bg-body border-end-0"><i class="bi bi-search text-muted"></i></span>
<input type="text" class="form-control border-start-0" id="comm-search-input"
placeholder="Filtrar por código, asignatura, carrera o turno..." oninput="filterCommissions(this.value)">
</div>
</div>
<div class="card-body p-3">
<div id="commissions-list" class="row g-3">
<!-- Las comisiones se cargan aquí dinámicamente -->
<div class="col-12 text-center text-muted py-5"> <div class="col-12 text-center text-muted py-5">
<div class="spinner-border spinner-border-sm me-2 text-primary" role="status"></div> <div class="spinner-border spinner-border-sm me-2 text-primary" role="status"></div>
Loading commissions... Cargando comisiones activas...
</div> </div>
</div> </div>
</div> </div>
@@ -208,9 +223,7 @@
</div> </div>
</div> </div>
<!-- Resultados Section -->
<!-- Results Section -->
<div class="row mb-4"> <div class="row mb-4">
<div class="col-12"> <div class="col-12">
<div id="preview-results"></div> <div id="preview-results"></div>
@@ -223,29 +236,25 @@
<!-- Loading Spinner Overlay --> <!-- Loading Spinner Overlay -->
<div class="spinner-overlay" id="loading-spinner"> <div class="spinner-overlay" id="loading-spinner">
<div class="text-center text-white"> <div class="text-center text-white">
<div class="spinner-border text-primary" style="width: 3rem; height: 3rem;" role="status"></div> <div class="spinner-border text-primary" style="width: 3.5rem; height: 3.5rem;" role="status"></div>
<p class="mt-3 mb-1 fw-bold fs-5">Running genetic algorithm optimization...</p> <p class="mt-3 mb-1 fw-bold fs-5">Ejecutando algoritmo genético de optimización...</p>
<small class="text-white-50">This may take a few moments</small> <small class="text-white-50">Calculando función de aptitud y evaluando combinaciones áulicas sin colisiones...</small>
</div> </div>
</div> </div>
<!-- Details Modal --> <!-- Details Modal -->
<div class="modal fade" id="detailsModal" tabindex="-1" aria-labelledby="detailsModalLabel" aria-hidden="true"> <div class="modal fade" id="detailsModal" tabindex="-1" aria-labelledby="detailsModalLabel" aria-hidden="true">
<div class="modal-dialog modal-lg"> <div class="modal-dialog modal-lg modal-dialog-centered">
<div class="modal-content"> <div class="modal-content">
<div class="modal-header"> <div class="modal-header">
<h5 class="modal-title" id="detailsModalLabel">Reservation Details</h5> <h5 class="modal-title fw-bold" id="detailsModalLabel"><i class="bi bi-calendar3 me-2 text-primary"></i>Detalle de Reservas Optimizadas</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button> <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div> </div>
<div class="modal-body"> <div class="modal-body">
<!-- Content populated dynamically --> <!-- Contenido dinámico -->
</div> </div>
<div class="modal-footer"> <div class="modal-footer">
<button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button> <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Cerrar</button>
<button type="button" class="btn btn-primary" onclick="downloadReservations()">
<i class="bi bi-download me-1"></i>
Download
</button>
</div> </div>
</div> </div>
</div> </div>
@@ -255,11 +264,16 @@
{% block extra_js %} {% block extra_js %}
<script src="/js/genetic-algorithm.js"></script> <script src="/js/genetic-algorithm.js"></script>
<script> <script>
let allCommissionsData = [];
function selectAllCommissions() { function selectAllCommissions() {
const checkboxes = document.querySelectorAll('input[name="commission_ids"]'); const checkboxes = document.querySelectorAll('input[name="commission_ids"]');
checkboxes.forEach(cb => { checkboxes.forEach(cb => {
cb.checked = true; const itemCol = cb.closest('.comm-card-col');
updateCommissionCard(cb.value, true); if (!itemCol || itemCol.style.display !== 'none') {
cb.checked = true;
updateCommissionCard(cb.value, true);
}
}); });
} }
@@ -282,14 +296,35 @@ function updateCommissionCard(commissionId, selected) {
} }
} }
function filterCommissions(query) {
const term = (query || '').toLowerCase().trim();
const cols = document.querySelectorAll('.comm-card-col');
let visibleCount = 0;
cols.forEach(col => {
const text = col.getAttribute('data-search-text') || '';
if (!term || text.includes(term)) {
col.style.display = '';
visibleCount++;
} else {
col.style.display = 'none';
}
});
const cntBadge = document.getElementById('commissions-count-badge');
if (cntBadge) {
cntBadge.textContent = `${visibleCount} comisiones encontradas`;
}
}
function resetOptimization() { function resetOptimization() {
deselectAllCommissions(); deselectAllCommissions();
if (window.geneticManager) { if (window.geneticManager) {
geneticManager.clearResults && geneticManager.clearResults(); geneticManager.clearResults && geneticManager.clearResults();
geneticManager.clearPreview && geneticManager.clearPreview(); geneticManager.clearPreview && geneticManager.clearPreview();
} }
document.getElementById('start-date').value = ''; const sInput = document.getElementById('start-date');
document.getElementById('end-date').value = ''; const eInput = document.getElementById('end-date');
if (sInput) sInput.value = '';
if (eInput) eInput.value = '';
} }
window.refreshStatus = async function() { window.refreshStatus = async function() {
@@ -298,15 +333,18 @@ window.refreshStatus = async function() {
const statusResult = await geneticManager.getAlgorithmStatus(); const statusResult = await geneticManager.getAlgorithmStatus();
if (statusResult && statusResult.success && statusResult.data) { if (statusResult && statusResult.success && statusResult.data) {
const sysStats = statusResult.data.system_status; const sysStats = statusResult.data.system_status;
document.getElementById('available-classrooms').textContent = sysStats.available_classrooms; const acEl = document.getElementById('available-classrooms');
document.getElementById('active-commissions').textContent = sysStats.active_commissions; const coEl = document.getElementById('active-commissions');
document.getElementById('existing-reservations').textContent = sysStats.confirmed_reservations; const reEl = document.getElementById('existing-reservations');
if (acEl) acEl.textContent = sysStats.available_classrooms;
if (coEl) coEl.textContent = sysStats.active_commissions;
if (reEl) reEl.textContent = sysStats.confirmed_reservations;
} }
} catch (e) { } catch (e) {
console.error("Error refreshing status:", e); console.error("Error al refrescar estado del algoritmo:", e);
} }
} }
} };
document.addEventListener('DOMContentLoaded', async function() { document.addEventListener('DOMContentLoaded', async function() {
await loadCommissions(); await loadCommissions();
@@ -314,50 +352,83 @@ document.addEventListener('DOMContentLoaded', async function() {
}); });
async function loadCommissions() { async function loadCommissions() {
const commissionsList = document.getElementById('commissions-list');
const countBadge = document.getElementById('commissions-count-badge');
try { try {
const response = await fetch('/api/genetic/commissions'); const response = await fetch('/api/genetic/commissions');
if (!response.ok) {
const errJson = await response.json().catch(() => ({}));
throw new Error(errJson.error || errJson.message || `HTTP ${response.status}`);
}
const data = await response.json(); const data = await response.json();
const commissionsList = document.getElementById('commissions-list');
const isSpanish = '{{ session.language or "es" }}' === 'es';
if (data.success && data.commissions && data.commissions.length > 0) { if (data.success && data.commissions && data.commissions.length > 0) {
const commissionsHtml = data.commissions.map(commission => ` allCommissionsData = data.commissions;
<div class="col-md-6 mb-3"> if (countBadge) {
<div class="card commission-item border-0 shadow-sm" data-commission-id="${commission.id}"> countBadge.textContent = `${data.commissions.length} comisiones activas disponibles para optimización`;
<div class="card-body"> }
<div class="form-check">
<input class="form-check-input" type="checkbox" name="commission_ids" const commissionsHtml = data.commissions.map(commission => {
const fullCode = commission.get_full_code || commission.full_code || commission.code;
const subjName = commission.subject_name || commission.subject?.name || 'Asignatura no especificada';
const careerName = commission.career_name || commission.career_names || (commission.careers && commission.careers[0]?.name) || '';
const schedule = commission.schedule || 'Sin horario asignado';
const shift = commission.shift || 'General';
const teacher = commission.teacher_name || commission.teacher_names || '';
const students = `${commission.current_students || 0}/${commission.max_students || 0}`;
const searchText = `${fullCode} ${subjName} ${careerName} ${schedule} ${shift} ${teacher}`.toLowerCase();
return `
<div class="col-md-6 comm-card-col" data-search-text="${searchText}">
<div class="card commission-item border-0 shadow-sm h-100 p-2" data-commission-id="${commission.id}">
<div class="card-body p-2">
<div class="form-check d-flex align-items-start gap-2">
<input class="form-check-input mt-1 flex-shrink-0" type="checkbox" name="commission_ids"
value="${commission.id}" id="commission-${commission.id}" value="${commission.id}" id="commission-${commission.id}"
onchange="updateCommissionCard('${commission.id}', this.checked)"> onchange="updateCommissionCard('${commission.id}', this.checked)">
<label class="form-check-label" for="commission-${commission.id}"> <label class="form-check-label w-100 cursor-pointer" for="commission-${commission.id}">
<strong class="text-primary">${commission.get_full_code || commission.code}</strong> <div class="d-flex justify-content-between align-items-center mb-1">
<br> <span class="badge bg-primary font-monospace fw-bold">${fullCode}</span>
<small class="text-muted">${commission.subject?.name || (isSpanish ? 'Materia Desconocida' : 'Unknown Subject')}</small> <span class="badge bg-secondary-subtle text-secondary border small">${shift}</span>
<br> </div>
<span class="badge bg-info mt-1">${commission.current_students || 0}/${commission.max_students} ${isSpanish ? 'estudiantes' : 'students'}</span> <div class="fw-bold text-body mb-1" style="font-size: 0.95rem;">${subjName}</div>
${commission.teacher_name ? `<span class="badge bg-secondary ms-2">${commission.teacher_name}</span>` : ''} ${careerName ? `<div class="small text-muted mb-1"><i class="bi bi-mortarboard me-1"></i>${careerName}</div>` : ''}
<div class="d-flex justify-content-between align-items-center pt-2 mt-1 border-top small">
<span class="text-primary fw-semibold"><i class="bi bi-clock me-1"></i>${schedule}</span>
<span class="badge bg-info-subtle text-info border">${students} estudiantes</span>
</div>
${teacher ? `<div class="small text-muted mt-1"><i class="bi bi-person me-1"></i>${teacher}</div>` : ''}
</label> </label>
</div> </div>
</div> </div>
</div> </div>
</div> </div>
`).join(''); `;
}).join('');
commissionsList.innerHTML = commissionsHtml; commissionsList.innerHTML = commissionsHtml;
} else { } else {
if (countBadge) countBadge.textContent = '0 comisiones';
commissionsList.innerHTML = ` commissionsList.innerHTML = `
<div class="col-12 text-center text-muted py-5"> <div class="col-12 text-center text-muted py-5">
<i class="bi bi-inbox fs-1 d-block mb-2"></i> <i class="bi bi-inbox fs-1 d-block mb-2 text-secondary"></i>
${isSpanish ? 'No se encontraron comisiones activas.' : 'No active commissions found.'} <h6 class="fw-bold">No se encontraron comisiones activas</h6>
<p class="small text-muted mb-0">No hay comisiones de cursada activas para optimizar en este ciclo lectivo.</p>
</div> </div>
`; `;
} }
} catch (error) { } catch (error) {
console.error('Error loading commissions:', error); console.error('Error cargando comisiones:', error);
document.getElementById('commissions-list').innerHTML = ` if (countBadge) countBadge.textContent = 'Error al cargar';
<div class="col-12 text-center text-danger py-4"> commissionsList.innerHTML = `
<i class="bi bi-exclamation-triangle fs-2 d-block mb-2"></i> <div class="col-12 text-center text-danger py-5">
Error al cargar comisiones: ${error.message} <i class="bi bi-exclamation-triangle-fill fs-1 d-block mb-2 text-danger"></i>
<h6 class="fw-bold">Error al cargar comisiones</h6>
<p class="small text-muted mb-3">${error.message}</p>
<button class="btn btn-sm btn-outline-primary" onclick="loadCommissions()">
<i class="bi bi-arrow-clockwise me-1"></i>Reintentar
</button>
</div> </div>
`; `;
} }
+28 -38
View File
@@ -248,36 +248,11 @@
{% block extra_js %} {% block extra_js %}
<script type="application/json" id="classroom-data"> <script type="application/json" id="classroom-data">
{ {{ classroom_data_json | safe }}
{% for c in classroom_list %}
"{{ c.id }}": {
"id": {{ c.id }},
"building_id": {{ (c.building_id or 0)|tojson }},
"building_name": {{ c.building_name|tojson }},
"floor": {{ c.floor|tojson }},
"floor_display": {{ c.floor_display|tojson }},
"code": {{ c.code|tojson }},
"code_display": {{ c.code_display|tojson }},
"location_display": {{ c.location_display|tojson }},
"capacity": {{ c.capacity_display|tojson }},
"capacity_num": {{ c.capacity }},
"is_virtual": {{ c.is_virtual|tojson }}
}{% if not loop.last %},{% endif %}
{% endfor %}
}
</script> </script>
<script type="application/json" id="commission-data"> <script type="application/json" id="commission-data">
{ {{ commission_data_json | safe }}
{% for c in commission_list %}
"{{ c.id }}": {
"id": {{ c.id }},
"code": {{ c.code|tojson }},
"virtual_link": {{ (c.virtual_link or '')|tojson }},
"max_students": {{ c.max_students }}
}{% if not loop.last %},{% endif %}
{% endfor %}
}
</script> </script>
<script type="application/json" id="i18n-strings"> <script type="application/json" id="i18n-strings">
@@ -386,21 +361,30 @@ $(document).ready(function() {
// Extraer pisos únicos de este edificio // Extraer pisos únicos de este edificio
const buildingFloors = []; const buildingFloors = [];
Object.values(classroomData).forEach(c => { Object.values(classroomData).forEach(c => {
if (c.building_id == selectedBuildingId && c.floor) { const matchesBuilding = (String(c.building_id) === String(selectedBuildingId)) ||
if (!buildingFloors.some(f => f.floor === c.floor)) { (!c.is_virtual && String(selectedBuildingId) === '1') ||
(c.building_name && c.building_name.toLowerCase().includes('central') && String(selectedBuildingId) === '1');
if (matchesBuilding && c.floor) {
if (!buildingFloors.some(f => String(f.floor).toLowerCase() === String(c.floor).toLowerCase())) {
buildingFloors.push({ buildingFloors.push({
floor: c.floor, floor: c.floor,
floor_display: c.floor_display floor_display: c.floor_display || `Piso ${c.floor}`
}); });
} }
} }
}); });
// Ordenar pisos: PB primero, luego numérico // Ordenar pisos: Subsuelos, PB, Entrepisos, luego numéricos
buildingFloors.sort((a, b) => { buildingFloors.sort((a, b) => {
if (a.floor === '0' || a.floor.toUpperCase() === 'PB') return -1; const fA = String(a.floor || '').toUpperCase();
if (b.floor === '0' || b.floor.toUpperCase() === 'PB') return 1; const fB = String(b.floor || '').toUpperCase();
return a.floor.localeCompare(b.floor, undefined, { numeric: true }); if (fA.includes('SUB') || fA === 'SS') return -1;
if (fB.includes('SUB') || fB === 'SS') return 1;
if (fA === '0' || fA.includes('PB') || fA.includes('PLANTA BAJA')) return -1;
if (fB === '0' || fB.includes('PB') || fB.includes('PLANTA BAJA')) return 1;
if (fA.includes('EP') || fA.includes('ENTRE')) return -1;
if (fB.includes('EP') || fB.includes('ENTRE')) return 1;
return fA.localeCompare(fB, undefined, { numeric: true });
}); });
buildingFloors.forEach(f => { buildingFloors.forEach(f => {
@@ -412,7 +396,10 @@ $(document).ready(function() {
// Poblar aulas de este edificio inicialmente // Poblar aulas de este edificio inicialmente
Object.values(classroomData).forEach(c => { Object.values(classroomData).forEach(c => {
if (c.building_id == selectedBuildingId) { const matchesBuilding = (String(c.building_id) === String(selectedBuildingId)) ||
(!c.is_virtual && String(selectedBuildingId) === '1') ||
(c.building_name && c.building_name.toLowerCase().includes('central') && String(selectedBuildingId) === '1');
if (matchesBuilding) {
$classroom.append($('<option>', { $classroom.append($('<option>', {
value: c.id, value: c.id,
text: `${c.code} · ${c.floor_display} (Cap: ${c.capacity})` text: `${c.code} · ${c.floor_display} (Cap: ${c.capacity})`
@@ -434,13 +421,16 @@ $(document).ready(function() {
let lastId = null; let lastId = null;
Object.values(classroomData).forEach(c => { Object.values(classroomData).forEach(c => {
const matchesBuilding = !selectedBuildingId || c.building_id == selectedBuildingId; const matchesBuilding = !selectedBuildingId ||
const matchesFloor = !selectedFloor || c.floor == selectedFloor; (String(c.building_id) === String(selectedBuildingId)) ||
(!c.is_virtual && String(selectedBuildingId) === '1') ||
(c.building_name && c.building_name.toLowerCase().includes('central') && String(selectedBuildingId) === '1');
const matchesFloor = !selectedFloor || String(c.floor).toLowerCase() === String(selectedFloor).toLowerCase();
if (matchesBuilding && matchesFloor) { if (matchesBuilding && matchesFloor) {
$classroom.append($('<option>', { $classroom.append($('<option>', {
value: c.id, value: c.id,
text: `${c.code} (Cap: ${c.capacity})` text: `${c.code} · ${c.floor_display} (Cap: ${c.capacity})`
})); }));
lastId = c.id; lastId = c.id;
count++; count++;
+21 -32
View File
@@ -260,36 +260,11 @@
{% block extra_js %} {% block extra_js %}
<script type="application/json" id="classroom-data"> <script type="application/json" id="classroom-data">
{ {{ classroom_data_json | safe }}
{% for c in classroom_list %}
"{{ c.id }}": {
"id": {{ c.id }},
"building_id": {{ (c.building_id or 0)|tojson }},
"building_name": {{ c.building_name|tojson }},
"floor": {{ c.floor|tojson }},
"floor_display": {{ c.floor_display|tojson }},
"code": {{ c.code|tojson }},
"code_display": {{ c.code_display|tojson }},
"location_display": {{ c.location_display|tojson }},
"capacity": {{ c.capacity_display|tojson }},
"capacity_num": {{ c.capacity }},
"is_virtual": {{ c.is_virtual|tojson }}
}{% if not loop.last %},{% endif %}
{% endfor %}
}
</script> </script>
<script type="application/json" id="commission-data"> <script type="application/json" id="commission-data">
{ {{ commission_data_json | safe }}
{% for c in commission_list %}
"{{ c.id }}": {
"id": {{ c.id }},
"code": {{ c.code|tojson }},
"virtual_link": {{ (c.virtual_link or '')|tojson }},
"max_students": {{ c.max_students }}
}{% if not loop.last %},{% endif %}
{% endfor %}
}
</script> </script>
<script> <script>
@@ -334,15 +309,24 @@ $(document).ready(function() {
const floors = new Set(); const floors = new Set();
Object.values(classroomData).forEach(function(room) { Object.values(classroomData).forEach(function(room) {
if (String(room.building_id) === String(selectedBldg)) { const matchesBuilding = (String(room.building_id) === String(selectedBldg)) ||
(!room.is_virtual && String(selectedBldg) === '1') ||
(room.building_name && room.building_name.toLowerCase().includes('central') && String(selectedBldg) === '1');
if (matchesBuilding && room.floor) {
floors.add(room.floor); floors.add(room.floor);
} }
}); });
const sortedFloors = Array.from(floors).sort(function(a, b) { const sortedFloors = Array.from(floors).sort(function(a, b) {
if (a === '0' || a === 'PB') return -1; const fA = String(a || '').toUpperCase();
if (b === '0' || b === 'PB') return 1; const fB = String(b || '').toUpperCase();
return String(a).localeCompare(String(b), undefined, {numeric: true}); if (fA.includes('SUB') || fA === 'SS') return -1;
if (fB.includes('SUB') || fB === 'SS') return 1;
if (fA === '0' || fA.includes('PB') || fA.includes('PLANTA BAJA')) return -1;
if (fB === '0' || fB.includes('PB') || fB.includes('PLANTA BAJA')) return 1;
if (fA.includes('EP') || fA.includes('ENTRE')) return -1;
if (fB.includes('EP') || fB.includes('ENTRE')) return 1;
return fA.localeCompare(fB, undefined, {numeric: true});
}); });
sortedFloors.forEach(function(fl) { sortedFloors.forEach(function(fl) {
@@ -368,7 +352,12 @@ $(document).ready(function() {
} }
const matchingRooms = Object.values(classroomData).filter(function(room) { const matchingRooms = Object.values(classroomData).filter(function(room) {
return String(room.building_id) === String(selectedBldg) && String(room.floor) === String(selectedFloor); const matchesBuilding = !selectedBldg ||
(String(room.building_id) === String(selectedBldg)) ||
(!room.is_virtual && String(selectedBldg) === '1') ||
(room.building_name && room.building_name.toLowerCase().includes('central') && String(selectedBldg) === '1');
const matchesFloor = String(room.floor).toLowerCase() === String(selectedFloor).toLowerCase();
return matchesBuilding && matchesFloor;
}); });
matchingRooms.sort(function(a, b) { return a.code.localeCompare(b.code); }); matchingRooms.sort(function(a, b) { return a.code.localeCompare(b.code); });
+8 -4
View File
@@ -173,8 +173,12 @@
{% for reservation in reservations.items %} {% for reservation in reservations.items %}
<tr> <tr>
<td class="ps-3"> <td class="ps-3">
<div class="fw-bold">{{ reservation.start_time }}</div> <div class="fw-bold text-dark text-nowrap">
<small class="text-muted font-monospace">{{ reservation.start_time }} - {{ reservation.end_time }} hs</small> <i class="bi bi-calendar-event me-1 text-primary"></i>{{ reservation.date_display or reservation.date_short or format_date_human(reservation.start_time) }}
</div>
<span class="badge bg-light text-dark border font-monospace mt-1">
<i class="bi bi-clock me-1 text-primary"></i>{{ reservation.time_display or (reservation.start_time ~ ' - ' ~ reservation.end_time ~ ' hs') }}
</span>
</td> </td>
<td> <td>
<span class="badge bg-secondary-subtle text-secondary border font-monospace"> <span class="badge bg-secondary-subtle text-secondary border font-monospace">
@@ -258,10 +262,10 @@
<div class="d-flex justify-content-between align-items-start mb-2"> <div class="d-flex justify-content-between align-items-start mb-2">
<div> <div>
<span class="badge bg-primary text-white font-monospace mb-1"> <span class="badge bg-primary text-white font-monospace mb-1">
<i class="bi bi-calendar-event me-1"></i>{{ reservation.start_time }} <i class="bi bi-calendar-event me-1"></i>{{ reservation.date_display or reservation.date_short or format_date_human(reservation.start_time) }}
</span> </span>
<div class="small fw-bold text-muted font-monospace"> <div class="small fw-bold text-muted font-monospace">
<i class="bi bi-clock me-1"></i>{{ reservation.start_time }} - {{ reservation.end_time }} hs <i class="bi bi-clock me-1 text-primary"></i>{{ reservation.time_display or (reservation.start_time ~ ' - ' ~ reservation.end_time ~ ' hs') }}
</div> </div>
</div> </div>
{% if reservation.status == 'CONFIRMED' or reservation.status.value == 'CONFIRMED' %} {% if reservation.status == 'CONFIRMED' or reservation.status.value == 'CONFIRMED' %}
+159 -51
View File
@@ -4,6 +4,13 @@
{% block content %} {% block content %}
<div class="container-fluid px-0"> <div class="container-fluid px-0">
<!-- Membrete exclusivo para impresión A4 de recepción y bedelía -->
<div class="print-header text-center mb-4">
<h2 class="fw-bold mb-1">Universidad de la Ciudad de Buenos Aires (UniCABA)</h2>
<h4 class="text-secondary mb-1">Cartelera Oficial de Asignación de Aulas y Cursadas</h4>
<p class="mb-0 fs-6">Fecha: <strong>{{ format_date(today, format='full')|capitalize }}</strong> — Plataforma Admin Edu-Space Bedelía</p>
</div>
<!-- Header --> <!-- Header -->
<div class="row mb-3 align-items-center"> <div class="row mb-3 align-items-center">
<div class="col-md-7"> <div class="col-md-7">
@@ -14,6 +21,12 @@
<p class="text-muted small mb-0">Cronograma de clases y asignación de aulas activas para el día de hoy</p> <p class="text-muted small mb-0">Cronograma de clases y asignación de aulas activas para el día de hoy</p>
</div> </div>
<div class="col-md-5 text-md-end mt-3 mt-md-0"> <div class="col-md-5 text-md-end mt-3 mt-md-0">
<a href="/schedule/export_csv?date={{ today }}{% if hide_virtual %}&hide_virtual=1{% endif %}{% if floor_filter %}&floor={{ floor_filter }}{% endif %}{% if shift_filter %}&shift={{ shift_filter }}{% endif %}" class="btn btn-outline-success me-2" title="Descargar como planilla Excel/CSV">
<i class="bi bi-file-earmark-excel me-1"></i>Excel / CSV
</a>
<button type="button" class="btn btn-outline-dark me-2" onclick="window.print()" title="Imprimir cartelera del día">
<i class="bi bi-printer me-1"></i>Imprimir
</button>
{% if user.has_permission('reservations', 'read_write') %} {% if user.has_permission('reservations', 'read_write') %}
<a href="/schedule/add_reservation" class="btn btn-success me-2"> <a href="/schedule/add_reservation" class="btn btn-success me-2">
<i class="bi bi-plus-circle me-1"></i>Nueva Reserva <i class="bi bi-plus-circle me-1"></i>Nueva Reserva
@@ -88,8 +101,29 @@
<div class="card border-0 shadow-sm mb-4"> <div class="card border-0 shadow-sm mb-4">
<div class="card-body p-3"> <div class="card-body p-3">
<form method="GET" action="/schedule/today_schedule" class="row g-2 align-items-center"> <form method="GET" action="/schedule/today_schedule" class="row g-2 align-items-center">
<!-- Selector de Fecha y Navegación de Días -->
<div class="col-lg-3 col-md-6">
<label for="dateSelect" class="form-label small fw-bold text-muted mb-1">
<i class="bi bi-calendar-event text-primary me-1"></i>Fecha de la Cartelera
</label>
<div class="input-group input-group-sm">
<a href="/schedule/today_schedule?date={{ prev_date }}&floor={{ floor_filter }}&shift={{ shift_filter }}{% if hide_virtual %}&hide_virtual=1{% endif %}" class="btn btn-outline-secondary" title="Día Anterior">
<i class="bi bi-chevron-left"></i>
</a>
<input type="date" name="date" id="dateSelect" class="form-control form-control-sm font-monospace text-center fw-bold" value="{{ today }}" onchange="this.form.submit()">
<a href="/schedule/today_schedule?date={{ next_date }}&floor={{ floor_filter }}&shift={{ shift_filter }}{% if hide_virtual %}&hide_virtual=1{% endif %}" class="btn btn-outline-secondary" title="Día Siguiente">
<i class="bi bi-chevron-right"></i>
</a>
{% if today != default_today %}
<a href="/schedule/today_schedule" class="btn btn-primary btn-sm" title="Volver al Día de Hoy">
Hoy
</a>
{% endif %}
</div>
</div>
<!-- Filter by Floor --> <!-- Filter by Floor -->
<div class="col-lg-3 col-md-4"> <div class="col-lg-2 col-md-3">
<label for="floorSelect" class="form-label small fw-bold text-muted mb-1"> <label for="floorSelect" class="form-label small fw-bold text-muted mb-1">
<i class="bi bi-layers text-secondary me-1"></i>Piso / Planta <i class="bi bi-layers text-secondary me-1"></i>Piso / Planta
</label> </label>
@@ -104,7 +138,7 @@
</div> </div>
<!-- Filter by Turno --> <!-- Filter by Turno -->
<div class="col-lg-3 col-md-4"> <div class="col-lg-2 col-md-3">
<label for="shiftSelect" class="form-label small fw-bold text-muted mb-1"> <label for="shiftSelect" class="form-label small fw-bold text-muted mb-1">
<i class="bi bi-brightness-high text-warning me-1"></i>Turno <i class="bi bi-brightness-high text-warning me-1"></i>Turno
</label> </label>
@@ -116,7 +150,7 @@
</div> </div>
<!-- Hide Virtual Classrooms Toggle --> <!-- Hide Virtual Classrooms Toggle -->
<div class="col-lg-4 col-md-4 pt-md-3"> <div class="col-lg-3 col-md-6 pt-md-3">
<div class="form-check form-switch pt-1"> <div class="form-check form-switch pt-1">
<input class="form-check-input" type="checkbox" role="switch" name="hide_virtual" value="1" id="hideVirtualToday" {% if hide_virtual %}checked{% endif %} onchange="this.form.submit()"> <input class="form-check-input" type="checkbox" role="switch" name="hide_virtual" value="1" id="hideVirtualToday" {% if hide_virtual %}checked{% endif %} onchange="this.form.submit()">
<label class="form-check-label fw-semibold small text-dark" for="hideVirtualToday"> <label class="form-check-label fw-semibold small text-dark" for="hideVirtualToday">
@@ -127,7 +161,7 @@
</div> </div>
<!-- Actions --> <!-- Actions -->
<div class="col-lg-2 col-md-12 pt-md-3 text-lg-end d-flex gap-2"> <div class="col-lg-2 col-md-6 pt-md-3 text-lg-end d-flex gap-2">
<button type="submit" class="btn btn-primary btn-sm flex-fill"> <button type="submit" class="btn btn-primary btn-sm flex-fill">
<i class="bi bi-funnel me-1"></i>Filtrar <i class="bi bi-funnel me-1"></i>Filtrar
</button> </button>
@@ -158,25 +192,35 @@
</button> </button>
</div> </div>
</div> </div>
</div>
<div class="card-body p-3"> <div class="card-body p-3">
<!-- Timeline View --> <!-- Timeline View: Agrupado por franja horaria real sin repeticiones -->
<div id="timeline-view"> <div id="timeline-view">
{% for hour in range(7, 22) %} {% for slot in grouped_slots %}
<div class="row border-bottom py-3 align-items-start {% if time_blocks[hour] %}bg-light-subtle{% endif %}"> <div class="row border-bottom py-3 align-items-stretch bg-light-subtle mb-3 rounded border mx-0">
<div class="col-md-2 col-3"> <div class="col-lg-2 col-md-3 col-12 mb-3 mb-md-0 d-flex flex-column justify-content-center">
<div class="text-center p-2 rounded bg-body-tertiary border"> <div class="text-center p-3 rounded bg-body-tertiary border shadow-sm h-100 d-flex flex-column justify-content-center">
<strong class="h5 text-primary mb-0 font-monospace">{% if hour < 10 %}0{% endif %}{{ hour }}:00</strong> <div class="badge bg-primary-subtle text-primary border border-primary-subtle mb-2 font-monospace">
<div class="small text-muted font-monospace">{{ hour+1 }}:00 hs</div> <i class="bi bi-clock me-1"></i>{{ slot.shift }}
</div>
<strong class="h4 text-primary d-block mb-0 font-monospace">{{ slot.start_time }}</strong>
<div class="small fw-bold text-dark font-monospace">a {{ slot.end_time }} hs</div>
<div class="badge bg-secondary-subtle text-secondary border mt-2 align-self-center font-monospace" style="font-size: 0.75rem;">
<i class="bi bi-hourglass-split me-1"></i>{{ slot.duration_display }}
</div>
<div class="mt-2">
<span class="badge bg-light text-muted border" style="font-size: 0.72rem;">
{{ slot.items | length }} {% if slot.items | length == 1 %}asignatura{% else %}asignaturas{% endif %}
</span>
</div>
</div> </div>
</div> </div>
<div class="col-md-10 col-9"> <div class="col-lg-10 col-md-9 col-12">
{% if time_blocks[hour] %} <div class="row g-2">
<div class="row g-2"> {% for item in slot.items %}
{% for item in time_blocks[hour] %} <div class="col-md-6 col-xl-6">
<div class="col-md-6"> <div class="card border-0 shadow-sm h-100 border-start border-4 {% if item.reservation.is_virtual %}border-info{% else %}border-primary{% endif %}">
<div class="card border-0 shadow-sm h-100 border-start border-4 border-primary"> <div class="card-body p-3 d-flex flex-column justify-content-between">
<div class="card-body p-3"> <div>
<div class="d-flex justify-content-between align-items-start mb-2"> <div class="d-flex justify-content-between align-items-start mb-2">
<div> <div>
<h6 class="card-title fw-bold mb-1 text-primary"> <h6 class="card-title fw-bold mb-1 text-primary">
@@ -186,62 +230,76 @@
{{ item.reservation.subject_code }} {{ item.reservation.subject_code }}
</span> </span>
<span class="badge bg-info-subtle text-info border"> <span class="badge bg-info-subtle text-info border">
{{ item.reservation.shift or 'Tarde' }} {{ item.reservation.shift or slot.shift }}
</span> </span>
{% if item.reservation.commission %}
<span class="badge bg-light text-dark border font-monospace">
{{ item.reservation.commission.code or item.reservation.commission.name }}
</span>
{% endif %}
</div> </div>
<span class="badge bg-{% if item.reservation.status == 'CONFIRMED' or item.reservation.status.value == 'CONFIRMED' %}success-subtle text-success border border-success-subtle{% else %}warning-subtle text-warning border border-warning-subtle{% endif %}"> <span class="badge bg-{% if item.reservation.status == 'CONFIRMED' or item.reservation.status.value == 'CONFIRMED' %}success-subtle text-success border border-success-subtle{% else %}warning-subtle text-warning border border-warning-subtle{% endif %}">
{% if item.reservation.status == 'CONFIRMED' or item.reservation.status.value == 'CONFIRMED' %} {% if item.reservation.status == 'CONFIRMED' or item.reservation.status.value == 'CONFIRMED' %}
Confirmada <i class="bi bi-check-circle me-1"></i>Confirmada
{% else %} {% else %}
Pendiente <i class="bi bi-clock me-1"></i>Pendiente
{% endif %} {% endif %}
</span> </span>
</div> </div>
<div class="small text-muted mb-2"> <div class="small text-muted mb-2">
<span class="fw-semibold text-dark me-2"> <span class="fw-semibold text-dark me-2">
{% if item.reservation.is_virtual %}
<i class="bi bi-laptop me-1 text-info"></i>{{ item.classroom.code }}
{% else %}
<i class="bi bi-door-open me-1 text-success"></i>{{ item.classroom.code }} <i class="bi bi-door-open me-1 text-success"></i>{{ item.classroom.code }}
{% endif %}
</span> </span>
<span class="me-2"> <span class="me-2">
<i class="bi bi-layers me-1"></i>{% if item.classroom.floor == 0 %}PB{% else %}Piso {{ item.classroom.floor }}{% endif %} <i class="bi bi-layers me-1"></i>{% if item.classroom.floor == 0 %}PB{% else %}Piso {{ item.classroom.floor }}{% endif %}
{% if item.classroom.building %} · {{ item.classroom.building }}{% endif %}
</span> </span>
<span> <span>
<i class="bi bi-clock me-1 text-warning"></i>{{ item.reservation.start_time }} - {{ item.reservation.end_time }} hs <i class="bi bi-clock me-1 text-warning"></i>{{ item.reservation.time_display }}
</span> </span>
</div> </div>
</div>
<div class="d-flex justify-content-between align-items-center pt-2 border-top"> <div class="d-flex justify-content-between align-items-center pt-2 border-top mt-2">
<span class="small text-muted"> <span class="small text-muted">
<i class="bi bi-people me-1"></i>{{ item.reservation.expected_attendees }} estudiantes <i class="bi bi-people me-1"></i>{{ item.reservation.expected_attendees }} estudiantes
</span> {% if item.reservation.teacher_name or item.user.name %}
<div class="d-flex gap-1"> · <i class="bi bi-person me-1"></i>{{ item.reservation.teacher_name or item.user.name }}
{% if item.reservation.effective_virtual_link %} {% endif %}
<a href="{{ item.reservation.effective_virtual_link }}" target="_blank" class="btn btn-sm btn-outline-success py-0 px-2 d-inline-flex align-items-center" title="Unirse a Videollamada (Zoom / Meet)"> </span>
<i class="bi bi-camera-video me-1"></i>Zoom/Meet <div class="d-flex gap-1">
</a> {% if item.reservation.effective_virtual_link %}
{% endif %} <a href="{{ item.reservation.effective_virtual_link }}" target="_blank" class="btn btn-sm btn-outline-success py-0 px-2 d-inline-flex align-items-center" title="Unirse a Videollamada (Zoom / Meet)">
{% if user.can_edit_reservation(item.reservation) %} <i class="bi bi-camera-video me-1"></i>Zoom/Meet
<a href="/schedule/edit_reservation?id={{ item.reservation.id }}" class="btn btn-sm btn-outline-warning py-0 px-2" title="Modificar Reserva"> </a>
<i class="bi bi-pencil"></i> {% endif %}
</a> {% if user.can_edit_reservation(item.reservation) %}
{% endif %} <a href="/schedule/edit_reservation?id={{ item.reservation.id }}" class="btn btn-sm btn-outline-warning py-0 px-2" title="Modificar Reserva">
<a href="/schedule/view_reservation?id={{ item.reservation.id }}" class="btn btn-sm btn-outline-secondary py-0 px-2" title="Ver Ficha Detallada"> <i class="bi bi-pencil"></i>
<i class="bi bi-eye me-1"></i>Detalles </a>
</a> {% endif %}
</div> <a href="/schedule/view_reservation?id={{ item.reservation.id }}" class="btn btn-sm btn-outline-secondary py-0 px-2" title="Ver Ficha Detallada">
<i class="bi bi-eye me-1"></i>Detalles
</a>
</div> </div>
</div> </div>
</div> </div>
</div> </div>
{% endfor %}
</div> </div>
{% else %} {% endfor %}
<div class="text-muted py-2 small ps-2"> </div>
<i class="bi bi-dash-circle me-1"></i>Sin clases programadas en este horario
</div>
{% endif %}
</div> </div>
</div> </div>
{% else %}
<div class="text-center py-4 text-muted">
<i class="bi bi-calendar-check fs-2 d-block mb-2"></i>
No hay clases programadas para esta fecha con los filtros aplicados.
</div>
{% endfor %} {% endfor %}
</div> </div>
@@ -263,15 +321,16 @@
<tbody> <tbody>
{% for reservation in reservations %} {% for reservation in reservations %}
<tr> <tr>
<td class="ps-3 font-monospace fw-bold"> <td class="ps-3 font-monospace fw-bold text-nowrap">
{{ reservation.start_time }} - {{ reservation.end_time }} hs <i class="bi bi-clock me-1 text-primary"></i>{{ reservation.time_display }}
</td> </td>
<td> <td>
<span class="badge bg-secondary-subtle text-secondary font-monospace border"> <span class="badge bg-secondary-subtle text-secondary font-monospace border">
{{ reservation.classroom.code if reservation.classroom else 'Sin Aula' }} {{ reservation.classroom.code if reservation.classroom else 'Sin Aula' }}
</span> </span>
<small class="text-muted d-block"> <small class="text-muted d-block">
{% if reservation.classroom and reservation.classroom.floor == 0 %}Planta Baja{% elif reservation.classroom %}Piso {{ reservation.classroom.floor }}{% endif %} {% if reservation.classroom and reservation.classroom.floor == 0 %}PB{% elif reservation.classroom %}Piso {{ reservation.classroom.floor }}{% endif %}
{% if reservation.classroom and reservation.classroom.building %} · {{ reservation.classroom.building }}{% endif %}
</small> </small>
</td> </td>
<td> <td>
@@ -380,4 +439,53 @@ document.addEventListener('DOMContentLoaded', function() {
} }
}); });
</script> </script>
<style>
@media print {
body {
background-color: #ffffff !important;
color: #000000 !important;
font-size: 10pt !important;
}
.sidebar, .navbar, .btn, .breadcrumb, form, .card-footer, #refresh-btn, #toggle-view-btn, .pagination, .alert, .badge.bg-opacity-10 {
display: none !important;
}
.main-content, .container-fluid, .content-wrapper, main {
margin: 0 !important;
padding: 0 !important;
width: 100% !important;
max-width: 100% !important;
}
.print-header {
display: block !important;
margin-bottom: 1.5rem !important;
border-bottom: 2px solid #000 !important;
padding-bottom: 0.5rem !important;
}
.card {
border: 1px solid #cccccc !important;
box-shadow: none !important;
break-inside: avoid;
margin-bottom: 1rem !important;
}
.table {
border-collapse: collapse !important;
width: 100% !important;
}
.table td, .table th {
border: 1px solid #dddddd !important;
padding: 6px 8px !important;
color: #000 !important;
}
a {
text-decoration: none !important;
color: #000 !important;
}
}
@media screen {
.print-header {
display: none !important;
}
}
</style>
{% endblock %} {% endblock %}
+4 -4
View File
@@ -56,11 +56,11 @@
</p> </p>
</div> </div>
<div class="col-md-6 mb-3"> <div class="col-md-6 mb-3">
<label class="text-muted small">Date & Time</label> <label class="text-muted small">Fecha y Horario</label>
<p class="mb-0"> <p class="mb-0">
<i class="bi bi-clock"></i> <i class="bi bi-clock me-1 text-primary"></i>
{{ format_date(reservation.start_time, format='long')|capitalize }}<br> <span class="fw-bold">{{ reservation.date_display or format_date(reservation.start_time, 'human') }}</span><br>
{{ reservation.start_time }} - {{ reservation.end_time }} <span class="font-monospace text-muted">{{ reservation.time_display or (reservation.start_time ~ ' - ' ~ reservation.end_time ~ ' hs') }}</span>
</p> </p>
</div> </div>
<div class="col-md-6 mb-3"> <div class="col-md-6 mb-3">
+57
View File
@@ -0,0 +1,57 @@
# Plan Técnico 001 — Cierre del MVP de Bedelía
Basado en: `specs/001-cierre-mvp-bedelia/spec.md` y `docs/constitution.md`.
---
## 1. Análisis de Brecha (Gap Analysis)
Al contrastar la especificación `spec.md` con el estado real del repositorio:
- **Flujo de 9 Pasos**: Está implementado en un 95%. Requiere una prueba de recorrido integral (*smoke test*) para asegurar que no haya fallas de integración.
- **Matriz de Conflictos**: 100% implementada y validada en `test_phase2_rules.py`.
- **Cartelera del Día**: Agrupa franjas horarias y soporta filtros de fecha, pero **carece de exportación / impresión limpia**, lo cual fuerza a Bedelía a mantener planillas manuales para entregar a recepción.
- **Exportación / Impresión**: Falta agregar la vista de impresión optimizada (`@media print`) y la descarga directa de CSV/Excel de la agenda áulica del día/semana.
---
## 2. Modificaciones de Archivos y Responsabilidades
### A. Frontend BFF & Vistas
1. `frontend/src/routes/schedule.js`:
- Endpoint `GET /schedule/export_csv`: Genera y descarga un archivo CSV con las columnas: `Fecha`, `Horario`, `Turno`, `Aula / Espacio`, `Piso`, `Materia`, `Código`, `Comisión`, `Carrera`, `Docentes`, `Enlace Virtual`.
- Inyección de cabecera `Content-Type: text/csv; charset=utf-8` y `Content-Disposition: attachment; filename="cartelera_unicaba_YYYY-MM-DD.csv"`.
2. `frontend/views/schedule/today_schedule.html`:
- Incorporar en el encabezado los botones de acción rápida:
- `[ Imprimir Cartelera ]` (dispara `window.print()` con estilos CSS `@media print`).
- `[ Descargar Planilla CSV ]` (enlace directo a `/schedule/export_csv?date=...`).
- Agregar bloque de estilos CSS para impresión:
- Oculta sidebar, navbar, filtros y botones interactivos al imprimir.
- Imprime membrete formal: *"Universidad de la Ciudad de Buenos Aires (UniCABA) - Cartelera de Asignación de Aulas"*.
- Formato de tabla claro, legible y ajustado a hoja A4/Oficio.
3. `frontend/views/dashboard/dashbede.html`:
- Agregar botón de acceso directo *"Exportar Planilla de Hoy"* junto a la agenda operativa de Bedelía.
### B. Backend REST API
1. `backend/app/routes/api/reservations.py` o `backend/app/routes/api/dashboard.py`:
- Asegurar que el endpoint que nutre la agenda retorne la carrera, turno y docentes de forma plana para serialización inmediata.
### C. Suite de Pruebas
1. `backend/tests/test_cartelera_export.py`:
- Prueba unitaria/integración que valide la generación y completitud de datos de agenda diaria y semanal.
---
## 3. Decisiones Técnicas y Alternativas Descartadas
1. **Generación de PDF en Servidor vs. Impresión Nativa del Navegador (`window.print`)**:
- *Alternativa Descartada*: Librería pesada de generación de PDF en Node.js (Puppeteer o PDFKit), que consume más de 200MB de RAM y puede fallar en entornos LXC mínimos.
- *Decisión Adoptada*: Hoja de estilo CSS `@media print` optimizada para el navegador del usuario + exportación de datos crudos en CSV con UTF-8 con BOM (para compatibilidad total con Microsoft Excel en español).
2. **Exportador CSV en Frontend BFF vs. Backend**:
- *Decisión Adoptada*: El Frontend BFF puede construir y enviar el stream CSV directamente a partir de la respuesta del endpoint `/api/v1/dashboard/today-schedule`, reduciendo la carga del backend y aprovechando los formateadores de fecha en español ya existentes.
---
## 4. Cobertura de Requisitos Funcionales
- **RF-1, RF-2**: Verificados mediante el flujo de 9 pasos en UI.
- **RF-3, RF-4, RF-5, RF-6**: Cubiertos por `tests/test_phase2_rules.py`.
- **RF-7, RF-8**: Cubiertos por la nueva funcionalidad de exportación e impresión limpia.
- **RF-9**: Cubierto por el panel de comisiones sin aula en `dashbede.html`.
- **RF-10**: Cubierto por `sheets_importer.py` y `admin.js`.
+84
View File
@@ -0,0 +1,84 @@
# Spec 001 — Cierre y Entrega Definitiva del MVP de Bedelía
Estado: Aprobada para Ejecución
---
## 1. Contexto y Objetivo
El proyecto **Admin Edu-Space** de UniCABA tiene como meta fundacional erradicar el uso del archivo Excel manual que el personal de Bedelía utiliza diariamente para coordinar la asignación de espacios, aulas, comisiones y docentes. Aunque la plataforma cuenta con una arquitectura desacoplada sólida (v3.4.9) y más de 50 pruebas superadas, el equipo percibe que *"el MVP está lejos"* debido a la ausencia de una delimitación estricta de alcance (*Scope Creep*), la falta de herramientas para exportar/imprimir la cartelera diaria requerida en portería y pasillos, y la necesidad de certificar que el circuito operativo de 9 pasos puede ejecutarse de punta a punta sin recurrir a planillas auxiliares.
Esta especificación formaliza el perímetro exacto e inamovible para la entrega del **MVP Productivo de Bedelía**, fijando criterios de aceptación verificables bajo la metodología SDD (**Spec-Driven Development**) y sintaxis **EARS**.
---
## 2. Usuarios / Actores
- **Personal de Bedelía (Actor Primario)**: Administra la asignación física y virtual de aulas, verifica comisiones sin aula, resuelve colisiones horarias y emite los partes de ocupación diarios y semanales.
- **Cuerpo Docente (Actor Secundario)**: Consulta su aula asignada (o enlace Meet), registra notas en el libro de calificaciones y reporta incidencias de aula.
- **Estudiantes (Actor de Consulta)**: Consultan su aula en la cartelera del día y acceden al enlace virtual correspondiente.
- **Administrador del Sistema (Auditor/Soporte)**: Supervisa métricas globales, gestiona usuarios y audita operaciones sensibles en `AuditLog`.
---
## 3. Historias de Usuario
- **HU-1**: Como responsable de Bedelía, quiero gestionar el ciclo académico completo (Sedes, Aulas, Ciclos, Carreras, Materias, Comisiones, Docentes, Alumnos y Reservas) en la plataforma web para no depender de planillas de cálculo.
- **HU-2**: Como responsable de Bedelía, quiero ver en el Dashboard de forma inmediata las aulas libres y las comisiones sin aula del día y la semana para reasignar espacios en menos de tres clics.
- **HU-3**: Como personal de Bedelía, quiero imprimir o exportar a CSV/PDF la cartelera de clases del día y de la semana para entregarla a seguridad/recepción y publicarla en los pasillos de la sede.
- **HU-4**: Como docente, quiero ingresar con mi cuenta institucional y ver exactamente en qué aula física o enlace de Meet me toca dictar clase hoy sin consultar planillas en Bedelía.
- **HU-5**: Como estudiante, quiero consultar la cartelera áulica en mi móvil para saber en qué aula y piso curso hoy de forma inequívoca.
---
## 4. Requisitos Funcionales (Criterios de Aceptación en Notación EARS)
### Módulo 1: Flujo Operativo de 9 Pasos
- **RF-1 (EARS Ubicuo)**: EL SISTEMA mantendrá la integridad referencial relacional entre Sede ➔ Aula ➔ Ciclo Lectivo ➔ Carrera ➔ Materia ➔ Comisión ➔ Docentes (con co-docencia) ➔ Alumnos ➔ Reserva de Espacio en todas las operaciones.
- **RF-2 (EARS Basado en Eventos)**: CUANDO Bedelía cree una comisión desde `/admin/commissions_list`, EL SISTEMA asociará obligatoriamente la Asignatura, heredará y expondrá la Carrera en la interfaz y precargará el Ciclo Lectivo vigente.
- **RF-3 (EARS No Deseado)**: SI un alumno intenta ser matriculado en dos materias regulares en el mismo día, ENTONCES EL SISTEMA bloqueará la operación a menos que la materia sea curso corto (`is_short_course`) o Bedelía marque expresamente `allow_same_day_exception` con motivo justificado.
### Módulo 2: Matriz Infranqueable de Conflictos
- **RF-4 (EARS Basado en Eventos)**: CUANDO el operador intente guardar una reserva que solape físicamente un aula presencial en la misma fecha y bloque horario, EL SISTEMA rechazará la solicitud (HTTP 409) indicando la reserva en conflicto.
- **RF-5 (EARS Basado en Eventos)**: CUANDO se intente asignar una reserva a un docente que ya tiene otra clase presencial simultánea, EL SISTEMA bloqueará la asignación, SALVO que la comisión cuente con co-docencia activa registrada en `commission_teachers`.
- **RF-6 (EARS Basado en Estados)**: MIENTRAS la reserva corresponda al entorno `Campus Virtual (VIRTUAL)`, EL SISTEMA permitirá la concurrencia de múltiples comisiones en el mismo horario con enlaces de Google Meet independientes.
### Módulo 3: Cartelera, Aulas Libres y Exportación
- **RF-7 (EARS Basado en Eventos)**: CUANDO Bedelía o recepción consulte `/schedule/today_schedule`, EL SISTEMA agrupará las reservas por franja horaria real de cursada (`08:00 - 11:00 hs`, etc.), ordenadas cronológicamente y sin duplicaciones de fila.
- **RF-8 (EARS Ubicuo)**: EL SISTEMA dispondrá de un botón de exportación rápida a formato descargable (CSV estructurado) e impresión limpia (CSS print-friendly) en la Cartelera del Día y Semanal para emisión física inmediata.
- **RF-9 (EARS Basado en Estados)**: MIENTRAS existan comisiones sin espacio asignado para la fecha seleccionada, EL SISTEMA las listará en la pestaña *"Comisiones Sin Asignar"* del Dashboard de Bedelía con acceso directo al formulario de asignación en 1 clic.
### Módulo 4: Importación y Respaldo
- **RF-10 (EARS Opcional)**: DONDE Bedelía requiera importar masivamente la oferta cuatrimestral desde Google Sheets, EL SISTEMA proveerá previsualización interactiva con filtros por Carrera, Materia y Día antes de impactar en la base de datos.
---
## 5. Requisitos No Funcionales (RNF)
- **RNF-1 (Seguridad)**: Toda sesión de usuario debe gestionarse mediante JWT en cookie `HttpOnly` y registrarse en `AuditLog`.
- **RNF-2 (Rendimiento)**: Las consultas del Dashboard y Cartelera del Día deben responder en menos de 500 ms con una concurrencia estimada de 200 usuarios concurrentes.
- **RNF-3 (Compatibilidad)**: Interfaz adaptativa (Responsive) optimizada para terminales móviles (375px) y pantallas de recepción (1920x1080).
- **RNF-4 (Idioma)**: Todo mensaje, etiqueta, alerta y reporte debe estar redactado en español institucional rioplatense.
---
## 6. Casos Límite y Reglas Especiales
1. **Reinicio de Ciclo Lectivo**: Si la base se reinicia o está vacía, ninguna vista debe arrojar error 500; deben mostrarse componentes de estado vacío (*empty states*) con llamada a la acción clara.
2. **Asignaturas Compartidas**: Si una materia pertenece a múltiples carreras (Many-to-Many en `subject_careers`), la cartelera y el detalle de comisión deben exhibir todas las titulaciones asociadas.
3. **Pisos Alfanuméricos**: Aulas ubicadas en pisos no numéricos (PB, EP, Subsuelo, Piso 1) deben agruparse correctamente en los selectores en cascada.
---
## 7. FUERA DE ALCANCE (Out of Scope para el MVP)
Para garantizar la entrega inmediata y evitar demoras innecesarias, los siguientes aspectos quedan formalmente **excluidos** de esta entrega y se derivan a la Fase 6 / Roadmap v4.0:
- ❌ Sincronización continua de dos vías en segundo plano con Moodle WebServices mediante Daemons systemd persistentes (la importación inicial y SSO cubren la necesidad del MVP).
- ❌ Aplicación móvil nativa compilada para Android/iOS (el diseño web responsive cubre el 100% del acceso móvil).
- ❌ Módulo de pagos o aranceles de matrícula.
- ❌ Gestión de inventario de activos físicos dentro de las aulas (PCs, proyectores, cables HDMI).
---
## 8. Criterios de Finalización (Definition of Done)
El MVP se considerará **100% ENTREGADO** cuando:
1. [ ] El flujo completo de 9 pasos de Bedelía pueda ser ejecutado por un operador sin errores en consola ni en logs.
2. [ ] La cartelera del día cuente con el botón de **Impresión / Exportación** funcionando.
3. [ ] Todas las 52 pruebas automatizadas de backend (`pytest tests -v`) pasen en verde.
4. [ ] La suite de auditoría de seguridad (`security_audit.bat`) no registre vulnerabilidades críticas.
5. [ ] La versión esté desplegada y verificada en el servidor de producción institucional (`https://eduspace.oemspot.com.ar`).
6. [ ] La memoria del proyecto (`MEMORY.md`) y el `CHANGELOG.md` queden actualizados reflejando el cierre del MVP.
+37
View File
@@ -0,0 +1,37 @@
# Tareas de Implementación 001 — Cierre del MVP de Bedelía
Basado en: `specs/001-cierre-mvp-bedelia/spec.md` y `plan.md`.
---
## Lista de Tareas Atómicas
- [x] **T1 — Endpoint de Exportación CSV en Frontend BFF (`/schedule/export_csv`)**
- **Archivos:** `frontend/src/routes/schedule.js`
- **RF Cubiertos:** RF-8
- **Descripción:** Implementar el endpoint que toma el parámetro `date` (o fecha actual), consulta el cronograma real de la API backend, y retorna un archivo CSV estructurado con cabeceras en español (`Fecha`, `Horario`, `Turno`, `Aula`, `Piso`, `Materia`, `Código`, `Comisión`, `Carrera`, `Docentes`, `Modalidad/Meet`) y prefijo UTF-8 BOM (`\uFEFF`) para compatibilidad directa con Microsoft Excel.
- **Hecho cuando:** Una petición GET a `/schedule/export_csv?date=2026-10-16` responda con HTTP 200, cabecera `Content-Disposition: attachment` y el contenido CSV formateado con las reservas del día.
- [x] **T2 — Botones de Impresión y Descarga en Cartelera del Día (`today_schedule.html`)**
- **Archivos:** `frontend/views/schedule/today_schedule.html`
- **RF Cubiertos:** RF-7, RF-8
- **Descripción:** Añadir en la barra superior de acciones de la cartelera los botones `Imprimir Cartelera` (icono `bi-printer`, ejecuta `window.print()`) y `Descargar Planilla CSV` (icono `bi-file-earmark-excel`). Agregar estilos `@media print` para ocultar la barra lateral, botones y pie de página, mostrando un membrete institucional limpio para recepción.
- **Hecho cuando:** Al presionar `Imprimir`, la vista previa de impresión muestre únicamente la grilla de asignaciones sin elementos de navegación, y al presionar `Descargar Planilla`, se descargue el archivo `.csv`.
- [x] **T3 — Botón de Exportación en Dashboard de Bedelía (`dashbede.html`)**
- **Archivos:** `frontend/views/dashboard/dashbede.html`
- **RF Cubiertos:** RF-8, RF-9
- **Descripción:** Agregar un botón destacado de exportación en la sección de Cartelera & Agenda de Bedelía para descargar o imprimir el parte del día en 1 clic.
- **Hecho cuando:** El botón sea visible en el Dashboard de Bedelía y redirija a la descarga o apertura de la cartelera imprimible.
- [x] **T4 — Verificación de Calidad y Pruebas Automatizadas**
- **Archivos:** `backend/tests/`
- **RF Cubiertos:** Todos (RF-1 al RF-10)
- **Descripción:** Ejecutar la suite completa de pruebas del backend (`python -m pytest tests -v`) verificando 0 fallos.
- **Hecho cuando:** La suite ejecute 52 tests y reporte 100% passed.
- [x] **T5 — Cierre de Versión, Actualización de Memoria y Principio 9 de la Constitución**
- **Archivos:** `package.json`, `app.js`, `backend/__init__.py`, `MEMORY.md`, `CHANGELOG.md`
- **RF Cubiertos:** RNF-1, RNF-4, Principio 9
- **Descripción:** Incrementar la versión semántica a `v3.5.0` (Cierre Formal MVP Bedelía), registrar las decisiones en `MEMORY.md` y detallar los cambios en `CHANGELOG.md`.
- **Hecho cuando:** La versión `v3.5.0` esté registrada en todos los descriptores y el reporte final esté listo para despliegue.