Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
59fc2b9e45 |
@@ -1,84 +0,0 @@
|
|||||||
---
|
|
||||||
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 (Principios 9 y 10 de la Constitución)
|
|
||||||
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
|
|
||||||
0. **Tolerancia Cero a Errores en Código (`@[current_problems]`):** Es mandatorio verificar y resolver al 100% cualquier error de linter, compilación, imports o advertencias críticas antes de compilar o empaquetar. Nunca dar una tarea por terminada si hay errores en el código.
|
|
||||||
1. **Subir la versión semántica** de forma coordinada.
|
|
||||||
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev` y `main`).
|
|
||||||
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Paso 0: Verificación de Código Limpio (Zero Errors)
|
|
||||||
Antes de proceder con el bump de versión:
|
|
||||||
- Inspeccionar y limpiar todos los problemas reportados en `@[current_problems]`.
|
|
||||||
- Ejecutar suite de pruebas: `cd backend && .\venv\Scripts\python.exe -m pytest tests -v`.
|
|
||||||
- Verificar que el compilador no reporte errores de sintaxis ni de tipos: `py_compile`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 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`
|
|
||||||
@@ -1,87 +0,0 @@
|
|||||||
---
|
|
||||||
name: moodle-replicator
|
|
||||||
description: Procedimiento y script de automatización para exportar participantes, materias y carreras desde Moodle Producción UniCABA y replicarlos en el Moodle Local (10.0.0.207) con DNI y credenciales mockeadas.
|
|
||||||
---
|
|
||||||
|
|
||||||
# Skill: Replicador de Datos de Moodle Producción a Local
|
|
||||||
|
|
||||||
## Propósito
|
|
||||||
Automatizar la extracción de participantes (estudiantes y docentes), asignaturas y carreras desde el campus virtual institucional de UniCABA en producción (`https://campus.udelaciudad.edu.ar/`) y replicar su estructura y usuarios en el entorno de pruebas local de Moodle (`http://10.0.0.207/moodle`), permitiendo validar la integración y concurrencia con **Admin Edu Space**.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. Mapeo Oficial de Entidades (16 Cursos de la Carrera)
|
|
||||||
|
|
||||||
| Entidad | Nombre Oficial | ID Producción | ID Local |
|
|
||||||
| :--- | :--- | :---: | :---: |
|
|
||||||
| **Carrera** | Mi carrera - Lic. en Tecnologías Digitales (CCC) | `922` | `19` |
|
|
||||||
| **Escuela** | Escuela de Tecnología e Industrias Digitales | `187` | `3` |
|
|
||||||
| **Materia 1/2025** | ASIG00120 - Gestión de Sistemas de Información_1/2025 | `3218` | `4` |
|
|
||||||
| **Materia 1/2025** | ASIG00121 - Análisis de Datos I - TEC.DIG._1/2025 | `3220` | `5` |
|
|
||||||
| **Materia 1/2025** | ASIG00122 - Taller: Gestión de Proyectos Digitales - E1_1/2025 | `3221` | `6` |
|
|
||||||
| **Materia 1/2025** | ASIG00215 - Marketing Digital - OPTATIVA -1/2025 | `3665` | `7` |
|
|
||||||
| **Materia 2/2025** | ASIG00123 - Administración de Negocios Digitales_2/2025 | `3945` | `8` |
|
|
||||||
| **Materia 2/2025** | ASIG00124 - Sistemas Digitales_2/2025 | `3944` | `9` |
|
|
||||||
| **Materia 2/2025** | ASIG00125 - Taller: Emprendedurismo en Innovación Digital_2/2025 | `3943` | `10` |
|
|
||||||
| **Materia 2/2025** | ASIG00205 - Gestión del Talento Humano en la Industria digital-2/2025 | `3933` | `11` |
|
|
||||||
| **Materia 1/2026** | ASIG00121 - Análisis de Datos I - TEC.DIG._1/2026 | `4565` | `12` |
|
|
||||||
| **Materia 1/2026** | ASIG00123 - Administración de Negocios Digitales_1/2026 | `4569` | `13` |
|
|
||||||
| **Materia 1/2026** | ASIG00125 - Taller: Emprendedurismo en Innovación Digital_1/2026 | `4571` | `14` |
|
|
||||||
| **Materia 1/2026** | ASIG00296 - Gestión de Redes Informáticas - Equipo 1_1/2026 | `4582` | `15` |
|
|
||||||
| **Materia 2/2026** | ASIG00124 - Sistemas Digitales_2/2026 | `5311` | `16` |
|
|
||||||
| **Materia 2/2026** | ASIG00126 - Seguridad de la Información_2/2026 | `5313` | `17` |
|
|
||||||
| **Materia 2/2026** | ASIG00127 - Programación de Vanguardia - E1_2/2026 | `5314` | `18` |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. Reglas de Negocio, User-Agent y Mocking
|
|
||||||
|
|
||||||
1. **User-Agent y Credenciales en Producción**:
|
|
||||||
- Cabecera HTTP fija: `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)`.
|
|
||||||
- Obtenidas exclusivamente de `.credenciales` (sección `Login Moodle del Campus UniCABA en producción`).
|
|
||||||
- Flujo de dos pasos: `GET /login/index.php` para extraer `logintoken` pre-sesión -> `POST` de credenciales manteniendo la cookie `MoodleSession`.
|
|
||||||
|
|
||||||
2. **Descarga Directa de Participantes**:
|
|
||||||
- Invocación al endpoint de exportación `/user/action_redir.php` con `bulkchange.php?operation=download_participants&dataformat=json` pasando los checkboxes de usuarios extraídos con `perpage=5000`.
|
|
||||||
- Fusión con los datos de rol extraídos de la tabla HTML para distinguir `Profesor Universidad` (`editingteacher`, ID 3) de `Estudiante Universidad` (`student`, ID 5).
|
|
||||||
|
|
||||||
3. **Generación Determinística de DNI**:
|
|
||||||
- Para todo participante que no posea DNI explícito: `DNI = 90 + ID_Moodle_6_digitos` (ej. `moodle_id=12740` -> `90012740`).
|
|
||||||
- **Regla de Acceso Local**: `username = DNI` y `password = DNI`.
|
|
||||||
- Si el usuario cuenta con DNI real conocido (ej. Carlos Tello: `34247025`), se preserva su DNI real.
|
|
||||||
|
|
||||||
4. **Alta y Matriculación en Moodle Local**:
|
|
||||||
- Consumo de la REST API institucional en `http://10.0.0.207/moodle/webservice/rest/server.php`.
|
|
||||||
- Funciones: `core_user_create_users` y `enrol_manual_enrol_users`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. Comandos de Ejecución
|
|
||||||
|
|
||||||
### Modo Simulación (Dry-Run):
|
|
||||||
```powershell
|
|
||||||
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --dry-run
|
|
||||||
```
|
|
||||||
|
|
||||||
### Exportar y Guardar en Archivo JSON:
|
|
||||||
```powershell
|
|
||||||
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --export-json participantes_moodle.json --dry-run
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ejecutar Replicación Completa en Moodle Local:
|
|
||||||
```powershell
|
|
||||||
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py
|
|
||||||
```
|
|
||||||
|
|
||||||
### Replicar Curso Específico:
|
|
||||||
```powershell
|
|
||||||
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --course 5311
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 4. Verificación en Moodle Local
|
|
||||||
Para verificar que los usuarios fueron importados y matriculados correctamente:
|
|
||||||
```powershell
|
|
||||||
plink.exe -ssh -batch -pw "Unicaba2026*" root@10.0.0.207 "mysql -u moodleuser -p'MoodlePass2026!Segura' moodle -e 'SELECT c.fullname, COUNT(ue.id) as matriculados FROM mdl_course c JOIN mdl_enrol e ON e.courseid=c.id JOIN mdl_user_enrolments ue ON ue.enrolid=e.id WHERE c.id IN (16,17,18,19) GROUP BY c.id;'"
|
|
||||||
```
|
|
||||||
@@ -1,68 +0,0 @@
|
|||||||
---
|
|
||||||
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. **Tolerancia Cero a Errores de Código (`@[current_problems]`) (Principio 10 de la Constitución)**: Es estrictamente inadmisible declarar una tarea o spec como completada si persisten errores en la terminal o problemas de diagnóstico. Todos los errores de importación, narrowing de tipos, NoneType y linter deben ser resueltos antes de dar el veredicto de aprobación.
|
|
||||||
6. **Diseño Modular y Contratos Fuertes (Principio 11 de la Constitución)**: Toda nueva API o endpoint debe dividirse en 4 capas desacopladas (`main.py`, `routers/`, `schemas/`, `storage.py`), usar `Pydantic` (`BaseModel` + `Field`) para validar bodies y query params con tipado estricto, levantar `HTTPException` controladas (404/422/400) sin retornar `null` ante fallos, y documentarse automáticamente en Swagger UI (`/docs`). Las integraciones con modelos de lenguaje (LLMs) deben implementarse con clientes asíncronos `httpx`, timeouts generosos (600s), formato estándar de roles e integrarse con la pestaña de IA en Configuración Global.
|
|
||||||
7. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
|
|
||||||
8. **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`.
|
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
FLASK_APP=app.py
|
||||||
|
FLASK_ENV=development
|
||||||
|
SECRET_KEY=your-secret-key-here-please-change-in-production
|
||||||
|
DATABASE_URL=postgresql://postgres:password@localhost:5432/classrooms_db
|
||||||
|
DB_USERNAME=postgres
|
||||||
|
DB_PASSWORD=password
|
||||||
|
API_BASE_URL=http://localhost:8080/api
|
||||||
@@ -4,7 +4,7 @@
|
|||||||
# ==============================================================================
|
# ==============================================================================
|
||||||
|
|
||||||
# Entorno Flask
|
# Entorno Flask
|
||||||
FLASK_APP=wsgi.py
|
FLASK_APP=app.py
|
||||||
FLASK_ENV=production
|
FLASK_ENV=production
|
||||||
|
|
||||||
# Seguridad: Clave secreta para sesiones y protección CSRF
|
# Seguridad: Clave secreta para sesiones y protección CSRF
|
||||||
|
|||||||
@@ -1,73 +0,0 @@
|
|||||||
name: Edu-Space Automated Security Audit (Gitea Local)
|
|
||||||
|
|
||||||
on:
|
|
||||||
push:
|
|
||||||
branches: [ main, develop ]
|
|
||||||
pull_request:
|
|
||||||
branches: [ main, develop ]
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
security-scan:
|
|
||||||
# Usamos la etiqueta estándar para contenedores Ubuntu en Gitea Runner
|
|
||||||
runs-on: ubuntu-latest
|
|
||||||
|
|
||||||
steps:
|
|
||||||
# 1. Clonar el código del repositorio local
|
|
||||||
- name: Checkout Code
|
|
||||||
uses: actions/checkout@v4
|
|
||||||
|
|
||||||
# 2. Preparar el entorno de paquetes del sistema (Linux)
|
|
||||||
- name: Install System Dependencies (Python & Node.js)
|
|
||||||
run: |
|
|
||||||
apt-get update && apt-get install -y python3 python3-pip python3-venv nodejs npm curl
|
|
||||||
python3 -m pip install --upgrade pip
|
|
||||||
|
|
||||||
# 3. Instalar librerías de Python y herramientas de seguridad
|
|
||||||
- name: Install Python Dependencies & Security Tools
|
|
||||||
run: |
|
|
||||||
pip3 install -r backend/requirements.txt
|
|
||||||
pip3 install -r backend/requirements-dev.txt
|
|
||||||
|
|
||||||
# 4. Instalar librerías de Node.js (Express BFF)
|
|
||||||
- name: Install Node.js Dependencies
|
|
||||||
run: |
|
|
||||||
cd frontend
|
|
||||||
npm ci
|
|
||||||
|
|
||||||
# --- EJECUCIÓN DE CONTROLES (SAST & SCA) ---
|
|
||||||
|
|
||||||
- name: [1/5] Python SAST (Bandit)
|
|
||||||
run: bandit -r ./backend/app -ll -ii
|
|
||||||
|
|
||||||
- name: [2/5] Python SCA (Pip-Audit)
|
|
||||||
run: pip-audit -s osv --progress-spinner off -r backend/requirements.txt
|
|
||||||
|
|
||||||
- name: [3/5] Node.js SAST (Njsscan)
|
|
||||||
run: njsscan ./frontend/src
|
|
||||||
|
|
||||||
- name: [4/5] Node.js SCA (Npm Audit)
|
|
||||||
run: |
|
|
||||||
cd frontend
|
|
||||||
npm audit --audit-level=high
|
|
||||||
|
|
||||||
# --- CONTROL DINÁMICO DAST (Schemathesis) ---
|
|
||||||
|
|
||||||
- name: [5/5] Start Flask App & Run DAST (Schemathesis)
|
|
||||||
env:
|
|
||||||
PYTHONUTF8: 1
|
|
||||||
FLASK_APP: backend/app # Ajustar a la ruta de inicio de tu Flask si varía
|
|
||||||
run: |
|
|
||||||
# Levantar Flask en segundo plano dentro del contenedor local
|
|
||||||
# Usamos 'python3 -m flask run' para asegurar el bindeo local
|
|
||||||
cd backend
|
|
||||||
python3 -m flask run --host=127.0.0.1 --port=5000 &
|
|
||||||
|
|
||||||
# Esperar 5 segundos a que la API responda
|
|
||||||
echo "Esperando a que el backend de Flask inicie en el entorno local..."
|
|
||||||
sleep 5
|
|
||||||
|
|
||||||
# Verificar con un curl rápido si el JSON de OpenAPI está disponible
|
|
||||||
curl -s http://127.0.0.1:5000/api/v1/openapi.json > /dev/null
|
|
||||||
|
|
||||||
# Ejecutar Schemathesis contra la instancia local efímera
|
|
||||||
schemathesis run http://127.0.0.1:5000/api/v1/openapi.json --checks not_a_server_error --max-examples=10
|
|
||||||
@@ -57,9 +57,6 @@ cover/
|
|||||||
*.mo
|
*.mo
|
||||||
*.pot
|
*.pot
|
||||||
|
|
||||||
# Examples
|
|
||||||
example/
|
|
||||||
|
|
||||||
# Django stuff:
|
# Django stuff:
|
||||||
*.log
|
*.log
|
||||||
local_settings.py
|
local_settings.py
|
||||||
@@ -210,23 +207,3 @@ cython_debug/
|
|||||||
marimo/_static/
|
marimo/_static/
|
||||||
marimo/_lsp/
|
marimo/_lsp/
|
||||||
__marimo__/
|
__marimo__/
|
||||||
|
|
||||||
# Node.js / Frontend
|
|
||||||
node_modules/
|
|
||||||
npm-debug.log
|
|
||||||
.env
|
|
||||||
.env.*
|
|
||||||
!.env.example
|
|
||||||
frontend/.env
|
|
||||||
|
|
||||||
legacy_admin-edu-space/
|
|
||||||
.vscode/
|
|
||||||
.schemathesis/
|
|
||||||
|
|
||||||
AlumnosLS
|
|
||||||
apuntes
|
|
||||||
|
|
||||||
.credentials
|
|
||||||
.credenciales
|
|
||||||
participantes_export.json
|
|
||||||
*export.json␍
|
|
||||||
@@ -1,15 +0,0 @@
|
|||||||
---
|
|
||||||
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`), asegurar cero errores en `@[current_problems]` (Principio 10: no es admisible dar una tarea o hito por completado con errores), validar estándares del Principio 11 (arquitectura modular, contratos Pydantic e IA asíncrona), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución (bump, git push y despliegue continuo).
|
|
||||||
@@ -1,15 +0,0 @@
|
|||||||
---
|
|
||||||
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.
|
|
||||||
- **Principio 10 (Tolerancia Cero)**: Repara activamente todos los problemas reportados en la terminal o Language Server (`@[current_problems]`). Es estrictamente inadmisible decir que una tarea está terminada o completada si hay errores o fallos en el código.
|
|
||||||
- **Principio 11 (Arquitectura de APIs y LLMs)**: Diseña APIs modulares (`main.py`, `routers/`, `schemas/`, `storage.py`), utiliza Pydantic (`BaseModel` + `Field`) para validar bodies y query params tipados, responde con códigos de estado HTTP explícitos (201/200/204/404/422), levanta `HTTPException` descriptivas sin retornar `null` en fallos y utiliza `httpx` asíncrono con timeouts generosos (600s) para llamadas a modelos de lenguaje (LLMs).
|
|
||||||
- Marca la tarea con `[x]` en `tasks.md` al terminar únicamente si no hay ningún error y detén tu ejecución para supervisión.
|
|
||||||
@@ -1,15 +0,0 @@
|
|||||||
---
|
|
||||||
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 `plan.md`, estructura siempre el diseño técnico bajo las 4 capas del Principio 11 (`main.py`, `routers/`, `schemas/`, `storage.py`), definiendo contratos Pydantic (`BaseModel` con `Field`), códigos de estado HTTP semánticos (201, 204, 404, 422), y para módulos de IA prever clientes `httpx` asíncronos con timeouts generosos (600s) y la pestaña correspondiente en Configuración Global.
|
|
||||||
- En `tasks.md`, desglosa tareas en bloques atómicos de 20 a 30 minutos con `[ ]` y criterio *"Hecho cuando:"*.
|
|
||||||
@@ -1,18 +0,0 @@
|
|||||||
---
|
|
||||||
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`).
|
|
||||||
- Verifica activamente que no existan errores ni problemas en la terminal o Language Server (`@[current_problems]`). Si persisten errores de sintaxis, imports, tipos o `NoneType`, emitir obligatoriamente `VEREDICTO: CAMBIOS NECESARIOS`.
|
|
||||||
- Verifica el cumplimiento del **Principio 11**: arquitectura modular (`routers/`, `schemas/`, `storage.py`), validación con Pydantic `BaseModel` + `Field`, uso estricto de códigos HTTP (201/200/204/404/422), manejo controlado de excepciones (`HTTPException`) sin retornar `null` ante fallos, y uso de `httpx` asíncrono con timeouts generosos (600s) en integraciones con LLMs.
|
|
||||||
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
|
|
||||||
- Recorre cada RF de la especificación y emite un veredicto formal:
|
|
||||||
- `VEREDICTO: APROBADO` (solo admisible si pruebas pasan al 100%, cero problemas en `@[current_problems]` y cumplimiento estricto de la Constitución).
|
|
||||||
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
|
|
||||||
@@ -1,23 +0,0 @@
|
|||||||
---
|
|
||||||
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.
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
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.
|
|
||||||
@@ -1,12 +0,0 @@
|
|||||||
---
|
|
||||||
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).
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
---
|
|
||||||
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 `[ ]`.
|
|
||||||
@@ -1,8 +1,6 @@
|
|||||||
{
|
{
|
||||||
"python.defaultInterpreterPath": "${workspaceFolder}\\backend\\venv\\Scripts\\python.exe",
|
"python.defaultInterpreterPath": "${workspaceFolder}\\venv\\Scripts\\python.exe",
|
||||||
"python.analysis.extraPaths": [
|
"python.analysis.extraPaths": [
|
||||||
"${workspaceFolder}\\backend",
|
"${workspaceFolder}\\venv\\Lib\\site-packages"
|
||||||
"${workspaceFolder}\\scripts",
|
|
||||||
"${workspaceFolder}\\backend\\venv\\Lib\\site-packages"
|
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,96 +0,0 @@
|
|||||||
# 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 y Buenas Prácticas de APIs
|
|
||||||
- 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**.
|
|
||||||
- **Arquitectura Modular en 4 Capas (Separación Estricta de Responsabilidades)**:
|
|
||||||
- `main.py`: Inicialización de la aplicación y registro de routers. No colocar lógica de negocio en el archivo principal ni en el frontend.
|
|
||||||
- `routers/`: Endpoints agrupados por dominio utilizando `APIRouter` (o Blueprints) con prefijos comunes (`prefix="/products"`, `prefix="/llm"`) y etiquetas (`tags=["..."]`) para una documentación limpia en Swagger UI.
|
|
||||||
- `schemas/` (`schemas.py`): Modelos de datos y validaciones con `Pydantic` (`BaseModel`).
|
|
||||||
- `storage.py` (o capa de persistencia `models/`): Centralización del acceso a datos y base de datos.
|
|
||||||
- **Validación de Datos con Pydantic y Tipado Fuerte**:
|
|
||||||
- Heredar de `BaseModel` para el cuerpo (body) de las peticiones.
|
|
||||||
- Uso mandatorio de `Field` para restricciones de negocio: `min_length`, `max_length`, `gt=0`, `ge=0`, etc.
|
|
||||||
- Manejo de parámetros: Path Parameters obligatorios en la URL y Query Parameters opcionales con defaults tipados (`limit: int = 10`).
|
|
||||||
- Validación y captura automática: ante datos inválidos responder con código `422 Unprocessable Entity` detallando el atributo exacto y la falla.
|
|
||||||
- **Códigos de Estado HTTP y Manejo de Excepciones**:
|
|
||||||
- Códigos de estado HTTP semánticos: `201 Created` en POST exitosos, `200 OK` en lecturas/actualizaciones, `204 No Content` en eliminaciones sin cuerpo.
|
|
||||||
- Prohibido retornar `null` o respuestas vacías ante fallos lógicos: levantar siempre excepciones controladas (`HTTPException`) con código adecuado (ej. `404 Not Found` con `detail="Recurso no encontrado"`, `400 Bad Request`, `409 Conflict`).
|
|
||||||
- **Documentación Interactiva Automática**:
|
|
||||||
- Contratos OpenAPI expuestos en `/docs` (Swagger UI) listos para pruebas en vivo (*Try it out*) y visualización de esquemas.
|
|
||||||
|
|
||||||
## 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`.
|
|
||||||
- **Integración Asíncrona con Modelos de IA Locales (LLMs) y Asistente en la App**:
|
|
||||||
- **Pestaña en Configuración Global**: Incluir una pestaña específica en la Configuración Global de la app para gestionar la integración con modelos de IA (servidor/URL, modelo seleccionado, tokens y timeout), sentando las bases para el futuro asistente virtual que guiará al usuario en la plataforma.
|
|
||||||
- **Cliente HTTP Asíncrono no Bloqueante (`httpx`)**: Toda llamada a servidores de inferencia locales (Ollama, llama.cpp, vLLM) o APIs de IA debe realizarse de forma asíncrona (`httpx.AsyncClient` con `async def` / `await`) para no bloquear el hilo de ejecución principal ni degradar la concurrencia.
|
|
||||||
- **Timeouts Generosos**: Fijar un tiempo de espera (`timeout`) amplio (mínimo 600 segundos en entornos locales) previendo la carga de modelos en VRAM o inferencias de prompts extensos.
|
|
||||||
- **Estructura de Roles Estándar**: Formatear el payload JSON enviando el modelo y los mensajes con roles explícitos (`role: "system" | "user" | "assistant"`, `content: prompt`).
|
|
||||||
|
|
||||||
## 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 (Principio 10 - Tolerancia Cero)**: Repara activamente todos los problemas y errores reportados en la terminal / Language Server (`@[current_problems]`). **Es estrictamente inadmisible decir que una tarea está terminada o completada si hay errores o problemas en el código.**
|
|
||||||
- **SIEMPRE (Principio 11 - Contratos Fuertes e IA)**: Implementar endpoints desacoplados en routers modulares, validar payloads con Pydantic `BaseModel` y `Field`, retornar códigos de estado HTTP semánticos (201, 204, 404, 422), exponer contratos en OpenAPI `/docs` y emplear `httpx` asíncrono con timeouts generosos (600s) para integraciones con LLMs.
|
|
||||||
- **SIEMPRE**: Al finalizar la tarea (con cero problemas en el código), 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.
|
|
||||||
@@ -1,644 +0,0 @@
|
|||||||
# Changelog Oficial — Admin Edu-Space (UniCABA)
|
|
||||||
|
|
||||||
Todas las modificaciones notables a este proyecto serán documentadas en este archivo.
|
|
||||||
El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y este proyecto se adhiere a [Semantic Versioning](https://semver.org/lang/es/).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [Unreleased]
|
|
||||||
### 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.
|
|
||||||
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
|
|
||||||
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
|
|
||||||
|
|
||||||
## [3.5.7] - 2026-10-16
|
|
||||||
### Added
|
|
||||||
- **Principio 11 de la Constitución: Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
|
|
||||||
- **Arquitectura Modular en 4 Capas**: Desacople estricto en `main.py` (arranque/routers), `routers/` (APIRouters por dominio con prefijo y tags), `schemas/` (Pydantic `BaseModel`) y `storage.py` (acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos.
|
|
||||||
- **Contratos Fuertes y Pydantic**: Uso mandatorio de `Field` para validación (`min_length`, `max_length`, `gt`, `ge`), diferenciación estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados), y respuestas automáticas de error `422 Unprocessable Entity` detalladas.
|
|
||||||
- **Semántica HTTP y Excepciones**: Uso estricto de códigos `201 Created` en POST, `200 OK`, `204 No Content` en DELETE y excepciones controladas `HTTPException` (404 con mensaje explícito, 400, 409) prohibiendo el retorno de `null` o respuestas vacías ambiguas.
|
|
||||||
- **Documentación Interactiva Automática**: Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo.
|
|
||||||
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
|
|
||||||
- Incorporación al Roadmap (Fase 7) de la pestaña de IA en la Configuración Global administrativa (URL de inferencia local Ollama/llama.cpp, modelo, token/clave API, switch de activación y timeout).
|
|
||||||
- Uso obligatorio de clientes asíncronos no bloqueantes `httpx.AsyncClient` (`async def` / `await`).
|
|
||||||
- Configuración de timeout generoso de 600 segundos previendo carga de modelos en VRAM o inferencia de prompts extensos.
|
|
||||||
- Estructura de payload estandarizada por historial de roles (`system`, `user`, `assistant`).
|
|
||||||
- Sincronización documental integral en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` y `MEMORY.md`.
|
|
||||||
|
|
||||||
## [3.5.6] - 2026-10-16
|
|
||||||
### Added
|
|
||||||
- **Principio 10 de la Constitución: Tolerancia Cero a Errores de Código y Diagnóstico (`@[current_problems]`)**:
|
|
||||||
- Incorporada directiva mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y definiciones de agentes en `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
|
|
||||||
- Prohibición estricta e infranqueable de declarar cualquier tarea o sprint como "terminado" o "completado" si persisten errores en el código o en el analizador de la IDE.
|
|
||||||
- Pre-verificación de Quality Gate `Paso 0: Verificación de Código Limpio (Zero Errors)` en el skill de despliegue antes de cualquier bump de versión o push.
|
|
||||||
|
|
||||||
### Changed & Fixed
|
|
||||||
- **Robustez en `SystemSetting`**:
|
|
||||||
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase (`SystemSetting.get_decrypted_value('key')`) o como método de instancia (`setting.get_decrypted_value()`), garantizando el paso del 100% de los tests de integración de la Fase 5.
|
|
||||||
- **Tipado estricto en `scripts/moodle_replicator.py`**:
|
|
||||||
- Corregido casteo a `int` en `local_course_id` y `role_id` en las líneas 586 y 607, satisfaciendo la firma de `enrol_user(local_uid: int, local_course_id: int, role_id: int)`.
|
|
||||||
- **Estabilidad de concurrencia en tests de SQLite**:
|
|
||||||
- Añadida espera explícita del worker asíncrono en `test_05_api_async_job_submission_and_polling` (`backend/tests/test_sprint4_optimizer_and_concurrency.py`) para evitar bloqueo de tablas en SQLite durante `tearDown`.
|
|
||||||
- Suite de pruebas de backend con 52 tests pasando al 100% (`52 passed`).
|
|
||||||
|
|
||||||
## [3.5.5] - 2026-10-16
|
|
||||||
### Added
|
|
||||||
- Mecanismo de autenticación mediante Clave API institucional (`X-API-Key` / `Authorization: ApiKey`) para sincronizaciones seguras desde Moodle y automatizaciones externas sin requerir tokens JWT interactivos.
|
|
||||||
- Endpoints de gestión de clave API: `GET /api/v1/admin/settings/moodle/api-key` y `POST /api/v1/admin/settings/moodle/api-key/regenerate`.
|
|
||||||
- Alias de sincronización `POST /api/v1/admin/settings/moodle/sync` consumible nativamente desde el botón de la interfaz web en la pantalla de Ajustes.
|
|
||||||
- Catálogo extendido de Web Services en Moodle Local (`10.0.0.207`) para el servicio `moodle_api`: añadidas funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`.
|
|
||||||
- Blindaje de seguridad en Moodle mediante restricción de IP (`iprestriction = 10.0.0.0/24`) en los tokens del servicio `moodle_api`.
|
|
||||||
|
|
||||||
### Changed & Fixed
|
|
||||||
- Eliminadas las 6 tareas residuales pendientes de prueba en la tabla `moodle_sync_tasks` de `classrooms_db`.
|
|
||||||
- Resolución de type narrowings (`loader` en `moodle_replicator.py` y `role_obj` en `admin.py`) y configuración integral de paths de scripts y venv en `pyrightconfig.json`.
|
|
||||||
|
|
||||||
## [3.5.4] - 2026-10-16
|
|
||||||
### Added
|
|
||||||
- Integración completa bidireccional con el Web Service `moodle_api` de Moodle Local (`10.0.0.207`) usando token dedicado `810428346d3601c68a37a315fcba8d4391629f46`.
|
|
||||||
- Soporte para autenticación delegada Moodle (`/api/v1/auth/moodle`) con fallback dinámico entre `moodle_api` y `moodle_mobile_app`, y matching por número de documento (DNI) y prefijo de usuario.
|
|
||||||
- Endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle` para sincronización directa de usuarios, roles y catálogo de cursos desde Moodle hacia la base de datos `classrooms_db`.
|
|
||||||
- Métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
|
|
||||||
- Otorgamiento de capability `moodle/webservice:createtoken` al rol autenticado de Moodle en `10.0.0.207` y habilitación de Web Services para login token.
|
|
||||||
|
|
||||||
### Fixed
|
|
||||||
- Corrección de firma en `MoodleClient.test_connection(server_url, token)` que causaba TypeError al recibir argumentos opcionales desde el panel de ajustes.
|
|
||||||
- Solución al error de resolución de módulos de Pyright/Pylance en `scripts/import_moodle_to_app.py` mediante configuración de `.vscode/settings.json` y carga modular dinámica.
|
|
||||||
|
|
||||||
## [3.5.3] - 2026-10-16
|
|
||||||
### Agregado & Corregido (Sincronización de Roles Moodle-App, Limpieza Admin & Hardening)
|
|
||||||
- **Importador y Sincronización de Roles con la App (`scripts/import_moodle_to_app.py` & flag `--sync-app`):**
|
|
||||||
- Mapeo directo y coherente de roles académicos: docentes de Moodle (`editingteacher`) asignados a `Docente` (`role_id=2`) y estudiantes (`student`) asignados a `Alumno` (`role_id=6`) en el modelo RBAC de PostgreSQL de la App (`classrooms_db`).
|
|
||||||
- Ingesta exitosa de **653 usuarios únicos** (15 Docentes y 640 Alumnos) con contraseñas seguras PBKDF2 coincidentes con el DNI, nombres, apellidos y correos personales reales.
|
|
||||||
- Habilitada la vinculación inmediata con comisiones (`commission_teachers`), reservas docentes e inscripciones de cursada (`student_enrollments`).
|
|
||||||
- **Desmatriculación Total de la Cuenta Admin en Moodle Local (`10.0.0.207`):**
|
|
||||||
- Removidas todas las asociaciones y enrolamientos espurios de la cuenta `admin` en asignaturas académicas y cursos institucionales (conteo reducido a 0 matriculaciones).
|
|
||||||
- Eliminado el curso dummy residual `Prueba matriculaciones masivas` (ID 22).
|
|
||||||
- Preservados estrictamente los 16 cursos legítimos de la carrera Licenciatura en Tecnologías Digitales (CCC).
|
|
||||||
|
|
||||||
## [3.5.2] - 2026-10-16
|
|
||||||
### Corregido & Mejorado (Replicación Integral de Carreras y Materias, User-Agent Mozilla/5.0, Login Local Fix)
|
|
||||||
- **Replicación Completa de los 16 Cursos de la Carrera:**
|
|
||||||
- Ampliado el catálogo de cursos de la Licenciatura en Tecnologías Digitales (CCC) de 4 a 16 asignaturas completas (1/2025, 2/2025, 1/2026 y 2/2026).
|
|
||||||
- Resuelto el problema de alumnos (ej. `90010202` - Carlos Guillermo Terzano) que solo veían la carrera y no sus materias cursadas: ahora cuentan con sus asignaturas y comisiones reales replicadas y matriculadas en Moodle Local (`10.0.0.207`).
|
|
||||||
- Más de 1.100 matriculaciones procesadas y verificadas con éxito en tiempo real.
|
|
||||||
- **Corrección de Inicio de Sesión de Alumnos en Moodle Local:**
|
|
||||||
- Solucionada la desincronización de contraseña del usuario `34247025`: restablecida y verificada con éxito tanto por CLI como vía API para que el DNI opere idénticamente como `username` y `password`.
|
|
||||||
- Mecanismo en `get_or_create_user` para forzar la actualización de contraseña y correo de cuentas existentes evitando bloqueos por credenciales obsoletas.
|
|
||||||
- **Personalización de Cabeceras HTTP (User-Agent):**
|
|
||||||
- Configurado estrictamente el encabezado `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)` en todas las sesiones y scripts hacia el Campus Virtual UniCABA, eliminando la firma por defecto de `python-requests`.
|
|
||||||
- **Pre-caché y Optimización de Extracción:**
|
|
||||||
- Carga automática de correos previamente cacheados desde `participantes_export.json` para reducir en un 80% las consultas HTTP a producción y evitar timeouts.
|
|
||||||
|
|
||||||
## [3.5.1] - 2026-10-16
|
|
||||||
### Agregado & Mejorado (Replicador de Moodle Producción a Entorno Local con Usuarios y Correos Reales)
|
|
||||||
- **Skill y Script de Replicación (`.agents/skills/moodle-replicator/SKILL.md` & `scripts/moodle_replicator.py`):**
|
|
||||||
- Autenticación automatizada en Moodle Producción (`https://campus.udelaciudad.edu.ar/`) mediante extracción de `logintoken` pre-sesión.
|
|
||||||
- Extracción híbrida: descarga masiva JSON vía `action_redir.php` + scraping optimizado de perfiles de usuario.
|
|
||||||
- **Correos Electrónicos Reales**: Consulta concurrente de perfiles para capturar el email real y personal de cada estudiante y docente (omitiendo emails sintéticos o inventados).
|
|
||||||
- **Mocking Determinístico de DNI**: Generación de DNI de 8 dígitos (`90{moodle_id:06d}`) como `username` y `password` para el entorno local, preservando el DNI real de Carlos Tello (`34247025`).
|
|
||||||
- **Carga en Moodle Local (`10.0.0.207`)**: Creación y actualización de cuentas mediante `core_user_create_users` y `core_user_update_users` con enrolamiento manual (`enrol_manual_enrol_users`) con roles de estudiante (`student`, ID 5) y profesor (`editingteacher`, ID 3).
|
|
||||||
- 504 matriculaciones completadas exitosamente en 4 cursos: Carrera Lic. en Tecnologías Digitales (922 -> 19), ASIG00124 (5311 -> 16), ASIG00126 (5313 -> 17) y ASIG00127 (5314 -> 18).
|
|
||||||
- Verificación de login exitosa de alumnos en Moodle local (`http://10.0.0.207/moodle/login/index.php`).
|
|
||||||
- **Especificación SDD (`specs/002-moodle-export-sync/`):**
|
|
||||||
- `spec.md` con 6 Requisitos Funcionales en sintaxis EARS, plan de arquitectura y tareas verificables completadas al 100%.
|
|
||||||
|
|
||||||
## [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 (`"`), 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
|
|
||||||
### Añadido
|
|
||||||
- **Función de Reinicialización Total del Sistema (`POST /api/v1/admin/system/reset`):**
|
|
||||||
- **Módulo de Mantenimiento en Configuración Global (`/admin/settings`):** Nueva pestaña "Mantenimiento & Reinicio" con tarjeta de "Zona de Peligro" y advertencia sobre el alcance de la purga.
|
|
||||||
- **Requisito Estricto de Seguridad Institucional:** Exige obligatoriamente la validación de la **contraseña del usuario Administrador en sesión** antes de ejecutar la acción; retorna 401 y aborta ante claves incorrectas registrando el evento `SYSTEM_RESET_FAILED`.
|
|
||||||
- **Purga Referencial Completa:** Vacía de forma segura y en orden estricto de claves foráneas: historiales previos (`AuditLog`), reservas (`Reservation`), hitos evaluativos (`AcademicMilestone`), notas (`MilestoneGrade`), matrículas (`StudentEnrollment`), asignaciones docentes (`CommissionTeacher`), comisiones (`Commission`), materias (`Subject`), carreras (`Career`), recursos de aula (`ClassroomResource`), aulas (`Classroom`), sedes/edificios (`Building`), ciclos lectivos (`AcademicTerm`) y colas de sincronización Moodle (`MoodleSyncTask`).
|
|
||||||
- **Preservación Estricta de Administración y Cuentas:** Mantiene 100% intactas todas las cuentas de usuario (`User` con hashes de contraseñas), roles RBAC (`Role`), permisos (`Permission`), tipos de hitos (`MilestoneType`), configuraciones globales (`SystemSetting`) y todos los módulos de la pestaña Administración.
|
|
||||||
- **Trazabilidad Inmutable:** Genera automáticamente un nuevo registro en `AuditLog` con la acción `SYSTEM_RESET`, asociando el correo del administrador ejecutor, su IP y el recuento de entidades purgadas.
|
|
||||||
- **Interfaz de Usuario y Modal Interactivo:** Diálogo modal `#modalResetSystem` con campo de contraseña enmascarada, switch de visibilidad, casilla de confirmación explícita y botón de confirmación con estado de carga (spinner).
|
|
||||||
|
|
||||||
### Corregido
|
|
||||||
- **Blindaje de Espacios y Sedes Vacíos (Presenciales y Virtuales):**
|
|
||||||
- **Prevención de Excepciones TypeError:** Se corrigieron accesos inseguros a propiedades nulas o no definidas (`c.code.includes`, `r.start_time.startsWith`, `localeCompare`) en `frontend/src/routes/classrooms.js`, permitiendo navegar a `/classrooms/list_classrooms?view_mode=physical` y `/classrooms/list_classrooms?view_mode=virtual` sin caídas ante bases vacías.
|
|
||||||
- **Corrección de Evaluación de Longitud en Nunjucks:** Actualizadas las directivas condicionales en `frontend/views/classrooms/list.html` a `classrooms.items|length > 0` y `virtual_rooms|length > 0`, garantizando el despliegue de los *Empty States* institucionales con botones de alta cuando no existen aulas registradas.
|
|
||||||
- **Mapeo Dinámico de Sedes:** `handleAddClassroom` y `handleClassroomsList` ahora sincronizan con el catálogo `/buildings`, ofreciendo la creación guiada de sedes y vinculación dinámica en el alta de aulas físicas.
|
|
||||||
- **Blindaje del Fallback Offline:** En caso de fallas o demoras en la API, el manejador de captura provee valores predeterminados seguros para `global_virtual_metrics` y `virtual_rooms`, impidiendo errores 500 no controlados.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [3.1.0] - 2026-09-23
|
|
||||||
### Añadido
|
|
||||||
- **ABM Integral de Ciclos Lectivos (`AcademicTerm`):**
|
|
||||||
- **Gestión End-to-End de Períodos Académicos:** Implementación de ciclo de vida completo para ciclos lectivos: Alta, Edición, Establecimiento de Ciclo Actual, Toggle de Habilitación rápida y Eliminación protegida (`DELETE /api/v1/admin/academic-terms/<id>` y `POST /api/v1/admin/academic-terms/<id>/toggle`).
|
|
||||||
- **Integridad Relacional Protegida:** Bloqueo de eliminación si el ciclo es el activo corriente, y fallback seguro a desactivación (`is_active = False`) si el ciclo tiene comisiones históricas asociadas.
|
|
||||||
- **Interfaz Enriquecida en Bedelía / Admin:** Botones de acción contextuales, switches y modales interactivos de confirmación (`#modalDeleteTerm`) en `frontend/views/admin/academic_terms/list.html`.
|
|
||||||
- **ABM Completo de Espacios y Aulas (`Classroom`):**
|
|
||||||
- **Control de Estado y Borrado Seguro:** Incorporación de toggle activo/inactivo (`POST /api/v1/classrooms/<id>/toggle`) y endpoint de baja de aulas integrado con el frontend BFF (`/classrooms/toggle_classroom` y `/classrooms/delete_classroom`).
|
|
||||||
- **Acciones Rápidas en Vista Lista y Ficha:** Botones de edición, alternancia de estado y eliminación con modales de advertencia en las vistas de cuadrícula/tabla (`list.html`) y detalle (`view.html`).
|
|
||||||
- **ABM Completo de Reservas (`Reservation`):**
|
|
||||||
- **Eliminación Definitiva (Hard Delete):** Soporte en backend para purga física de reservas (`DELETE /api/v1/reservations/<id>?hard=true` y `POST /api/v1/reservations/<id>/delete`) complementando el flujo de cancelación lógica (`CANCELLED`).
|
|
||||||
- **Control Operativo en Vista Detalle:** Botón de "Eliminar Reserva Definitivamente" con diálogo modal de confirmación en `/schedule/view.html`.
|
|
||||||
- **Auditoría y Cobertura 100% de ABMs en la Plataforma:**
|
|
||||||
- Verificación y garantía de operaciones ABM completas en todos los componentes centrales: **Sedes/Edificios** (`Building`), **Aulas** (`Classroom`), **Ciclos Lectivos** (`AcademicTerm`), **Carreras** (`Career`), **Materias** (`Subject`), **Comisiones** (`Commission`) y **Reservas** (`Reservation`).
|
|
||||||
- **Circuito Integral y Simplificado de Bedelía:**
|
|
||||||
- **Flujo Operativo Ágil para Bedelía:**
|
|
||||||
- Circuito intuitivo de 3 pasos: Catálogo de Aulas (`/classrooms/list_classrooms`) -> Creación/Edición con validación física/virtual y aforo real -> Asignación de Comisiones (`/schedule/add_reservation`).
|
|
||||||
- Botón de acción rápida `Asignar Aula` (`bi-calendar-plus`) en cada fila de `/admin/commissions_list`, permitiendo asignar espacio y horario a cualquier comisión en 1 solo clic.
|
|
||||||
- Sincronización bidireccional de parámetros por URL (`?commission_id=...` y `?classroom_id=...`) precargando automáticamente en el formulario de reserva la materia, código, cupo máximo de alumnos y enlace virtual de Google Meet / Teams.
|
|
||||||
- Selectores inteligentes en cascada en `/schedule/add.html` con autoselección de Edificio, Piso y Aula al navegar desde el catálogo de espacios.
|
|
||||||
- **Conexión REST en Vivo para Reservas:**
|
|
||||||
- Sustitución de listas fijas/mockeadas en `frontend/src/routes/schedule.js` por consulta dinámica a `/commissions` en vivo, permitiendo reservar aulas para cualquiera de las comisiones reales de la plataforma.
|
|
||||||
- **Soporte Multisede Consistente en Aulas:**
|
|
||||||
- Resolución robusta de `building_id` y flag `is_virtual` en `frontend/src/routes/classrooms.js`, eliminando hardcodes y asegurando que las aulas físicas pertenezcan a la sede seleccionada.
|
|
||||||
- **Inicialización de Base de Datos Limpia sin Datos Demo (`--empty-academic` / `--no-demo`):**
|
|
||||||
- **Soporte en `install.sh` y Menú Interactivo:** Incorporación de la opción `sudo bash install.sh --empty-academic` (o `--no-demo`) y opción `[3]` en el menú interactivo para crear la base de datos limpia desde cero, omitiendo la inyección de snapshots con carreras, materias, comisiones, aulas o reservas heredadas.
|
|
||||||
- **Inicializador de Esquema `init_db.py`:** Nuevo flag `--empty-academic` que genera el esquema de tablas completo, los roles y permisos RBAC, los usuarios institucionales y las tipificaciones de hitos, purgando y omitiendo cualquier edificio, aula física o virtual, carrera, materia, comisión o reserva demo por defecto.
|
|
||||||
- **Personalización de Interfaz y Saludo en Dashboard (Configuración Global):**
|
|
||||||
- **Nueva Pestaña de Interfaz & Dashboard (`/admin/settings`):** Módulo en el panel de configuración global para personalizar elementos visuales del sistema.
|
|
||||||
- **Desactivación Opcional del Saludo y Selector de Rol:** Switch interactivo para habilitar o deshabilitar el banner superior `¡Hola, {Usuario}!` y el selector de perspectiva de roles en `dashboard.html`. Al deshabilitarlo, el usuario accede directamente a los indicadores y accesos operativos de su rol sin distracciones ni dudas de contexto.
|
|
||||||
- **Persistencia y Endpoint REST:** Parámetro `dashboard_role_banner_enabled` administrado vía `POST /api/v1/admin/settings/ui`, respaldado por `SystemSetting` y registrado en `AuditLog`.
|
|
||||||
|
|
||||||
### Corregido
|
|
||||||
- **Motor de Purga y Reinicio de Datos Académicos:**
|
|
||||||
- **Solución al botón inerte de Purga:** En `/admin/google_sheets_import`, el botón *"Ejecutar Purga de Datos Seleccionados"* llamaba a `openPurgeModal()`, el cual no ejecutaba ninguna acción por ausencia del modal `#purgeConfirmModal` en el DOM. Se incorporó el modal interactivo completo con desglose dinámico de elementos marcados para borrado, advertencia de preservación de usuarios y estado de carga (spinner).
|
|
||||||
- **Integridad Referencial en Purga Backend:** En `backend/scripts/reset_academic_data.py`, se reordenó la secuencia de borrado para respetar las restricciones de clave foránea (FK): `Reservation` -> `MilestoneGrade` / `AcademicMilestone` -> `CommissionTeacher` -> `StudentEnrollment` -> `Commission` -> `Subject` -> `Career` -> `ClassroomResource` / `Classroom`. Esto previene fallos silenciosos por FK y garantiza que las carreras, asignaturas y comisiones se eliminen de manera limpia cuando son seleccionadas.
|
|
||||||
- **Preservación de Usuarios y Roles:** La purga garantiza que ningún usuario (`User`), contraseña administrativa ni rol (`Role`) sea alterado o eliminado durante el reseteo académico.
|
|
||||||
- **Saneamiento de Métricas y Edición de Edificios:**
|
|
||||||
- Corrección de métricas de edificios en `/buildings/list_buildings`: la capacidad virtual (9999) ya no distorsiona el cómputo de bancos físicos ni los percentiles de ocupación institucional.
|
|
||||||
- Formulario de edición de sedes (`/buildings/edit/:id`) corregido y persistido adecuadamente.
|
|
||||||
- **Instalador `install.sh`:**
|
|
||||||
- Inclusión de banderas `--keep-db` y `--keep-users` para evitar sobreescritura de contraseñas y usuarios en reinstalaciones o actualizaciones.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [3.0.0] - 2026-09-23
|
|
||||||
### Añadido
|
|
||||||
- **Fase 5 — Integración Auth, Email & Moodle Backend:**
|
|
||||||
- **Épica 1: Panel de Configuración Global (Perfil ADMIN):**
|
|
||||||
- Cifrado simétrico de credenciales y secretos con Fernet (`CryptoService` en `backend/app/services/crypto_service.py`).
|
|
||||||
- Migración y extensión de `SystemSetting` con columnas `category` e `is_encrypted`, junto con métodos polimórficos `get_decrypted_value()` y `get_masked_value()`.
|
|
||||||
- Endpoints REST `/api/v1/admin/settings/*` para administración dinámica de parámetros SMTP, toggles de proveedores SSO, Google OAuth y Web Services de Moodle 4.1.
|
|
||||||
- Nueva vista responsiva `frontend/views/admin/settings/global_config.html` con soporte optimizado para pantallas 720p, 1360x768 y 1080p, y enlace integrado en el menú de navegación lateral.
|
|
||||||
- **Épica 2: Infraestructura Asíncrona y Caché:**
|
|
||||||
- Servicio híbrido de caché `CacheService` con integración Redis y fallback en memoria/TTL.
|
|
||||||
- Modelo `MoodleSyncTask` y procesador asíncrono `MoodleQueueService` con Exponential Backoff y Dead Letter Queue (DLQ).
|
|
||||||
- Métricas en vivo y reintentos manuales individuales y masivos para tareas en DLQ.
|
|
||||||
- **Épica 3: Autenticación Híbrida (SSO & Local):**
|
|
||||||
- Login nativo como fallback con contingencia para cuentas con rol ADMIN.
|
|
||||||
- Integración de Google OAuth 2.0 basada en la arquitectura de AlumnosLS con filtrado estricto por dominios institucionales (`google_allowed_domains`).
|
|
||||||
- Autenticación delegada contra Moodle 4.1 vía `/login/token.php`, mapeo inicial de roles (Admin/Docente/Alumno) y gestión de roles 100% desacoplada en Edu-Space.
|
|
||||||
- **Épica 4: Integración Bidireccional Moodle 4.1:**
|
|
||||||
- Adaptador `MoodleClient` con Web Services de Moodle 4.1 (`core_user_*`, `enrol_manual_*`, `core_enrol_*`, `core_role_*`).
|
|
||||||
- Encolado no bloqueante de sincronización al crear o editar usuarios en Edu-Space.
|
|
||||||
- **Épica 5: Motor de Notificaciones (Email Server):**
|
|
||||||
- Cliente SMTP dinámico en `EmailService` con desencriptación en caliente de contraseñas.
|
|
||||||
- Plantillas HTML transaccionales para asignación de comisiones a profesores, citación a exámenes y pruebas en vivo de conectividad.
|
|
||||||
- **Pruebas y Verificación:**
|
|
||||||
- Suite de integración automatizada `backend/tests/test_phase6_integration.py` con 7 pruebas aprobadas al 100%. Regresión completa de 30 pruebas en verde en los módulos core.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.8.0] - 2026-09-23
|
|
||||||
### Añadido
|
|
||||||
- **Fase 4 del Roadmap MVP — UI/UX Avanzada para Bedelía & Modo Impersonación:**
|
|
||||||
- **Estadio 4.1 — Grilla Semanal Interactiva (Drag-and-Drop) con Detección de Colisiones:**
|
|
||||||
- Activación de arrastre y edición interactiva en FullCalendar (`editable: true`, `droppable: true`, `eventDurationEditable: true`).
|
|
||||||
- Panel lateral integrado de comisiones sin aula asignada (`unassigned_commissions`) con arrastre fluido hacia la grilla semanal o diaria.
|
|
||||||
- Endpoint REST `POST /api/v1/reservations/drag-update` con validación previa de la matriz integral de conflictos (`ReservationService.check_full_conflicts_matrix`): colisión física de aula, colisión de horario docente y aforo de estudiantes.
|
|
||||||
- Si existe colisión, retorna HTTP 409 (`status: conflict`), revierte automáticamente la posición del evento en la grilla (`info.revert()`) y notifica al usuario con un Toast detallado del motivo del choque.
|
|
||||||
- Si el espacio está disponible, actualiza o crea la reserva en base de datos, asienta la acción en `AuditLog` y muestra confirmación visual de éxito.
|
|
||||||
- **Estadio 4.2 — Modo Impersonación del Superadmin:**
|
|
||||||
- Soporte completo de cabecera `X-Impersonate-User` en el decorador JWT del Backend Flask (`jwt_required`) para administradores.
|
|
||||||
- Endpoints administrativos `POST /api/v1/admin/impersonate` y `POST /api/v1/admin/stop-impersonating` con registro estricto en `AuditLog` bajo las acciones `IMPERSONATE_START` e `IMPERSONATE_END`.
|
|
||||||
- Inyección contextual de impersonación en el Frontend BFF (`authMiddleware` y proxy transparente `/api`) mediante cookies seguras `impersonate_user_id` e `impersonate_user_data`.
|
|
||||||
- Banner de advertencia visual permanente en la barra superior (`base.html`) indicando el usuario y rol impersonado, con botón de salida inmediata hacia la sesión del administrador.
|
|
||||||
- Botón de acceso directo para impersonar (`bi-incognito`) en cada fila de usuario activo en `/admin/users_list`.
|
|
||||||
- **Estadio 4.3 — Acople del Optimizador Genético a Datos y Turnos Reales:**
|
|
||||||
- Algoritmo genético (`ReservationOptimizer`) adaptado a las franjas horarias y turnos institucionales reales de UniCABA (`Mañana` 08:00-12:00, `Tarde` 14:00-18:00, `Vespertino`/`Noche` 18:30-22:30).
|
|
||||||
- Soporte de guardado masivo en base de datos (`POST /api/genetic/apply-optimization` y `apply_optimized_reservations`) con prevención de solapamientos físicos y conversión estricta de fechas ISO.
|
|
||||||
- **Suite de Pruebas Unitarias de Fase 4:**
|
|
||||||
- Archivo `backend/tests/test_phase4_interactive_impersonation.py` con 6 tests unitarios cubriendo los criterios de aceptación: impersonación como docente y estudiante, trazabilidad en auditoría, rechazo de impersonación para usuarios no administradores, finalización de impersonación, drag-update con bloqueo por colisión 409 y drag-update exitoso 200.
|
|
||||||
- Regresión global de 18 tests (Fases 2, 3 y 4) aprobada al 100% (18/18 OK).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.7.0] - 2026-09-23
|
|
||||||
### Añadido
|
|
||||||
- **Fase 3 del Roadmap MVP — Gestión de Hitos Evaluativos y Libro de Calificaciones (*Gradebook*):**
|
|
||||||
- **Estadio 3.1 — Calendario de Evaluación y Notificaciones Preventivas:**
|
|
||||||
- Modelo relacional `MilestoneGrade` (`milestone_grades`) asociado a estudiantes (`User`) y reservas de tipo hito (`Reservation`).
|
|
||||||
- Servicio `GradebookService.get_student_upcoming_milestones`: consulta inteligente de exámenes parciales, recuperatorios y entregas de TP de las comisiones en las que el alumno está matriculado.
|
|
||||||
- Endpoint REST `GET /api/v1/students/my-upcoming-milestones` con cálculo de días restantes (`days_remaining`).
|
|
||||||
- Cartelera y Widget de Próximos Exámenes en el Dashboard del Alumno (`/dashboard?role=alumno`) con badges dinámicos de cuenta regresiva (*¡Hoy!*, *¡Mañana!*, *Faltan X días*).
|
|
||||||
- **Estadio 3.2 — Libro de Calificaciones (*Gradebook*) y Cierre de Actas:**
|
|
||||||
- Extensiones al modelo `Commission`: campos `grades_closed` (booleano), `grades_closed_at` (timestamp), `grades_closed_by` (ID usuario) y `acta_number` (código oficial de acta).
|
|
||||||
- Servicio académico `GradebookService` (`backend/app/services/gradebook_service.py`):
|
|
||||||
- `get_commission_gradebook`: matriz bidimensional consolidada de alumnos inscriptos y notas por hito evaluativo.
|
|
||||||
- `save_single_grade` y `bulk_save_grades`: registro y actualización de calificaciones con validación estricta de escala (1.0 a 10.0), flag de ausente (`is_absent`) y soporte de retroalimentación pedagógica (`feedback`).
|
|
||||||
- Bloqueo por inmutabilidad: rechazo de modificaciones cuando el acta se encuentra cerrada.
|
|
||||||
- `close_gradebook`: sellado oficial del acta con generación de identificador inmutable (`ACTA-YYYY-Sem-ID`), registro de auditoría en `AuditLog` y congelamiento de calificaciones.
|
|
||||||
- `reopen_gradebook`: reapertura excepcional para Bedelía/Admin con justificación administrativa obligatoria y registro en auditoría.
|
|
||||||
- `get_student_grades`: consolidado para el alumno de todas sus materias cursadas, notas por evaluación, promedio general y condición académica final (*Promocionado*, *Regular*, *Libre*).
|
|
||||||
- Endpoints REST de Calificaciones:
|
|
||||||
- `GET /api/v1/commissions/<id>/gradebook`: estructura completa para la matriz del libro de calificaciones.
|
|
||||||
- `PUT /api/v1/commissions/<id>/gradebook/grades`: guardado masivo o individual de notas vía JSON.
|
|
||||||
- `POST /api/v1/commissions/<id>/gradebook/close`: cierre formal de acta.
|
|
||||||
- `POST /api/v1/commissions/<id>/gradebook/reopen`: reapertura justificada de acta.
|
|
||||||
- `GET /api/v1/students/my-grades`: consulta individual de notas y regularidad del estudiante.
|
|
||||||
- Interfaz de Usuario y Vistas Frontend BFF:
|
|
||||||
- Vista `/schedule/gradebook/:id`: matriz interactiva con cálculo de promedio en tiempo real en el DOM, asignación de condición en vivo, autoguardado asíncrono debounced (500ms) con indicador flotante de estado (*Guardando...*, *✓ Todos los cambios guardados*), filtro de búsqueda instantánea por alumno/legajo, modal de cierre formal de acta y modal de reapertura.
|
|
||||||
- Vista `/schedule/my_grades` (`/mis-materias/mis-notas`): portal del estudiante para consultar calificaciones por hito, promedios finales, condición de cursada y actas emitidas, con soporte de impresión de certificado de cursada.
|
|
||||||
- Acceso directo integrado al Libro de Calificaciones en la tarjeta de comisión de `/admin/commission_detail`.
|
|
||||||
- Acceso directo a "Mis Calificaciones" en el launchpad de navegación del alumno en `/dashboard`.
|
|
||||||
- Script de migración de base de datos SQLite `backend/migrate_phase3_fields.py`.
|
|
||||||
- **Suite de Pruebas Unitarias de Fase 3:**
|
|
||||||
- Archivo `backend/tests/test_phase3_gradebook.py` con 6 tests unitarios cubriendo los criterios de aceptación de Fase 3: estructura de matriz, autoguardado de notas, validaciones de rango numérico, cierre formal de acta e inmutabilidad, consulta individual de notas y cuenta regresiva de próximos exámenes. 100% de tests aprobados (12/12 en suite global Fase 2 + Fase 3).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.6.1] - 2026-09-23
|
|
||||||
### Modificado
|
|
||||||
- **Optimización de Espacio Vertical y Compatibilidad de Pantallas (720p / 1360x768 y 1080p):**
|
|
||||||
- **Navbar Compacta:** Reducción de altura a 46px eliminando desperdicio de espacio superior para maximizar el área visible de trabajo de Bedelía.
|
|
||||||
- **Botón de Toggle de Sidebar:** Reingeniería visual del botón de alternancia del menú lateral con diseño circular limpio, micro-animación en hover y centrado perfecto.
|
|
||||||
- **Soporte Multipantalla:** Media queries CSS especializadas para resoluciones compactas habituales en puestos de trabajo de administración y bedelía argentina (1360x768 / 1366x768) y escalado equilibrado a 1920x1080 Full HD.
|
|
||||||
- **Densidad de Información:** Espaciados y márgenes optimizados para evitar scrolling innecesario en formularios y catálogos de comisiones y aulas.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.6.0] - 2026-09-19
|
|
||||||
### Añadido
|
|
||||||
- **Fase 2 del Roadmap MVP — Co-docencia, Matriz de Conflictos y Regla Diaria:**
|
|
||||||
- **Estadio 2.1 — Modelo y Gestión Integral de Co-docencia:**
|
|
||||||
- Modelo relacional `CommissionTeacher` (`commission_teachers`) con roles de cátedra (`Titular`, `Adjunto`, `JTP`, `Ayudante`) y flags de docente principal.
|
|
||||||
- Endpoints REST de cátedra: `POST /api/v1/commissions/<id>/teachers` y `DELETE /api/v1/commissions/<id>/teachers/<user_id>` con control de duplicados y asignación dinámica.
|
|
||||||
- Integración visual en el detalle de la comisión (`/admin/commission_detail`) con tarjeta interactiva para vincular/desvincular integrantes del equipo docente y badges de rol en la grilla general (`/admin/commissions_list`).
|
|
||||||
- **Estadio 2.2 — Matriz de Conflictos y Validación Integral:**
|
|
||||||
- **Conflicto Físico Estricto:** Bloqueo estricto de superposición horaria en la misma aula física (`ReservationRepository.find_overlapping` & `check_physical_conflicts`).
|
|
||||||
- **Conflicto Docente Inteligente:** Detección de doble reserva simultánea para un mismo profesor (`ReservationRepository.find_teacher_conflicts` & `check_teacher_conflicts`).
|
|
||||||
- **Excepción Justificada por Co-docencia:** Si un docente asignado presenta solapamiento pero la comisión cuenta con co-docentes registrados en `CommissionTeacher`, el motor de conflictos autoriza la reserva validando la cobertura del equipo de cátedra.
|
|
||||||
- **Conflicto de Aforo:** Bloqueo estricto cuando la cantidad de asistentes esperados (`expected_attendees`) excede la capacidad física declarada del aula (`classroom.capacity`).
|
|
||||||
- Endpoint unificado `POST /api/v1/reservations/check-conflicts` para pre-validación asíncrona de conflictos físicos, docentes y de capacidad antes del guardado.
|
|
||||||
- **Estadio 2.3 — Regla de Restricción Diaria del Alumno y Motor de Excepciones:**
|
|
||||||
- Servicio académico `EnrollmentService` (`backend/app/services/enrollment_service.py`) para control de cupos, inscripciones activas y análisis de días de cursada.
|
|
||||||
- **Regla Diaria:** Un alumno no puede matricularse en dos materias regulares programadas para el mismo día de la semana.
|
|
||||||
- **Excepción Automática por Curso Corto:** Indicador `is_short_course` en modelo `Subject`; si una de las asignaturas es un taller, seminario o curso corto, el sistema autoriza automáticamente la cursada simultánea en el mismo día.
|
|
||||||
- **Excepción Expresa de Bedelía:** Parámetros `allow_same_day_exception` y `exception_reason` en el modelo `StudentEnrollment`, permitiendo a Bedelía inscribir alumnos con justificación administrativa expresa (cambio de plan, equivalencias, etc.).
|
|
||||||
- Endpoints de gestión de matrículas por comisión: `GET /api/v1/commissions/<id>/enrollments`, `POST /api/v1/commissions/<id>/enrollments`, `DELETE /api/v1/commissions/<id>/enrollments/<student_id>` y `PUT /api/v1/commissions/<id>/enrollments/<student_id>`.
|
|
||||||
- Adaptación completa de UI en `/admin/commission_detail` con selector de estudiantes, toggle interactivo de excepción de Bedelía, campo de motivo justificado, y tabla de estudiantes matriculados con badges de excepción.
|
|
||||||
- **Suite de Pruebas Unitarias e Integrales de Reglas de Negocio:**
|
|
||||||
- Archivo `backend/tests/test_phase2_rules.py` con 6 tests completos verificando: bloqueo físico, conflicto de aforo, detección docente con bypass de co-docencia, restricción diaria de cursada, excepción por curso corto y excepción por autorización manual de Bedelía. 100% de tests aprobados.
|
|
||||||
- **Mejoras UI/UX en Dashboard de Bedelía:**
|
|
||||||
- Paneles interactivos para visualizar **Comisiones Sin Reserva de Aula** y **Aulas Disponibles** con soporte de filtrado temporal (Semana/Mes) directamente consumiendo estadísticas en tiempo real del motor backend.
|
|
||||||
- **Fase 1: Auditoría y Seguridad Automatizada:**
|
|
||||||
- **Control de Entorno Dev:** Aislamiento de herramientas de seguridad en `requirements-dev.txt`.
|
|
||||||
- **Automatización Local e Integración Continua:** Correcciones de evaluación en `security_audit.bat` para Windows y actualización de `.gitea/workflows/security-audit.yaml` para asegurar la correcta ejecución del stack de auditoría (Bandit, pip-audit, njsscan y Schemathesis).
|
|
||||||
## [2.5.0] - 2026-09-19
|
|
||||||
### Añadido
|
|
||||||
- **Auditoría y Seguridad Automatizada Completa (Python & Node.js):**
|
|
||||||
- **Python SAST (`bandit`):** Escaneo estático del backend Flask de más de 8.400 líneas. Corrección de vulnerabilidad B310 en `sheets_importer.py` mediante validación estricta de esquema HTTP/HTTPS para prevenir ataques de tipo SSRF. Resultado: 0 fallos detectados.
|
|
||||||
- **Python SCA (`pip-audit`):** Análisis de dependencias con base OSV; detección de 24 CVEs históricas en paquetes desactualizados y actualización completa a versiones seguras (`Flask>=3.1.3`, `Werkzeug>=3.1.8`, `requests>=2.34.2`, `bleach>=6.4.0`, `python-dotenv>=1.2.3`). Resultado: 0 CVEs activas.
|
|
||||||
- **Python DAST / Fuzzing (`schemathesis`):** Especificación OpenAPI 3.0.3 en `backend/app/routes/api/openapi.py` (`/api/v1/openapi.json`). Ejecución de 114 casos de prueba dinámicos con mutación de datos. Detección y corrección de caída 500 por payload de tipo JSON inválido en `/auth/login`. Resultado: 114/114 pruebas aprobadas con 0 errores de servidor.
|
|
||||||
- **Node.js SAST (`njsscan`):** Análisis de patrones de código inseguro en el BFF Express (`frontend/src`). Resultado: 0 hallazgos.
|
|
||||||
- **Node.js SCA (`npm audit`):** Auditoría continua de paquetes npm con 0 vulnerabilidades reportadas.
|
|
||||||
- **Blindaje Activo (`helmet` & `express-rate-limit`):** Incorporación de cabeceras HTTP defensivas (`HSTS`, `nosniff`, `SAMEORIGIN`, `X-Permitted-Cross-Domain-Policies`) y limitadores de tasa ante fuerza bruta en `/auth/login` (30 req / 15 min) y `/api` (180 req / min).
|
|
||||||
- **Script Unificado de Auditoría (`security_audit.bat`):** Ejecutable centralizado para correr los 5 controles en un solo comando.
|
|
||||||
- **Documento Formal de Seguridad (`SECURITY_AUDIT_REPORT.md`):** Reporte ejecutivo de auditoría y controles continuos.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.4.0] - 2026-09-19
|
|
||||||
### Añadido
|
|
||||||
- **Perfil Extendido de Usuarios y Tipificaciones de Documentos Oficiales (Argentina y Extranjeros):**
|
|
||||||
- Incorporación en el modelo `User` de los campos: `first_name` (Nombre), `last_name` (Apellido), `email` (Email Institucional de acceso), `personal_email` (Email Personal/Particular de contacto), `phone` (Teléfono con código de área), `address` (Domicilio/Dirección), `document_type` (Tipo de documento) y `document_number` (Número de documento validado).
|
|
||||||
- Catálogo formal de reglas de negocio en `backend/app/constants/document_types.py` con tipificaciones oficiales de Argentina y extranjeros (DNI, CUIL, Pasaporte Argentino, Pasaporte Extranjero, DNI Extranjero, Cédula de Identidad PFA, Cédula Mercosur, Libreta Cívica y Libreta de Enrolamiento).
|
|
||||||
- Validaciones de formato, expresiones regulares, y verificación de unicidad de documento por tipo en endpoints `POST /api/v1/users` y `PUT /api/v1/users/<id>`.
|
|
||||||
- Búsqueda dinámica en `/admin/users_list` habilitada para filtrar por número de documento o email personal/institucional además de nombre.
|
|
||||||
- Rediseño del formulario `/admin/users/form` estructurado en secciones: Identidad y Documentación, Contacto y Domicilio (con Teléfono, Email Personal y Dirección), y Cuenta y Rol Institucional (con Email Institucional y Clave), permitiendo al Administrador General gestionar la totalidad de los datos.
|
|
||||||
- Script de migración SQLite `backend/migrate_user_profile_fields.py` para agregar las columnas e inicializar nombres desglosados de los usuarios existentes.
|
|
||||||
- **Co-Docencia y Cátedras Múltiples en Comisiones:**
|
|
||||||
- Creación del modelo relacional `CommissionTeacher` (`commission_teachers`) para asociar múltiples docentes a una misma comisión con roles académicos diferenciados (`Titular`, `Adjunto`, `JTP`, `Ayudante`).
|
|
||||||
- Nuevos endpoints en la API REST: `POST /api/v1/commissions/<id>/teachers` y `DELETE /api/v1/commissions/<id>/teachers/<user_id>`, junto con la serialización completa de cátedras en `GET /api/v1/commissions`.
|
|
||||||
- Nueva tarjeta interactiva *"Equipo Docente / Cátedra"* en el detalle de la comisión (`/admin/commission_detail?id=...`) permitiendo agregar y desvincular docentes con sus respectivos roles.
|
|
||||||
- Actualización de la grilla de comisiones (`/admin/commissions_list`) para exhibir a todos los profesores asignados con badges distintivos de rol.
|
|
||||||
- **Eliminación y Gestión Segura de Asignaturas:**
|
|
||||||
- Incorporación de botón y modal interactivo de confirmación de eliminación de asignaturas en `/admin/subjects_list`.
|
|
||||||
- Implementación de regla de negocio de integridad académica: eliminación física si la materia no tiene comisiones asociadas, o desactivación automática si posee historial o cursadas vinculadas.
|
|
||||||
|
|
||||||
### Corregido
|
|
||||||
- **Bug Visual en Modificación de Asignaturas (`/admin/subjects_list`):**
|
|
||||||
- Solucionado el problema de modales recortados o cubiertos por el fondo oscuro (`modal-backdrop`), originado por la presencia de 206 modales inline dentro de celdas `<td>` en una tabla con `overflow` (`.table-responsive`). Se refactorizó hacia un único modal global `#modalEditSubject` instanciado fuera de la tabla e inicializado dinámicamente con JavaScript.
|
|
||||||
### Añadido
|
|
||||||
- **Monitoreo y Percentiles de Asignación de Aulas Físicas (Admin & Bedelía):**
|
|
||||||
- Panel analítico *"Estado y Percentiles de Asignación de Aulas Físicas"* incorporado en los dashboards de Administrador (`/dashboard?role=admin`) y Bedelía (`/dashboard?role=bedelia`).
|
|
||||||
- Cálculo dinámico en tiempo real de **Aulas Asignadas** en número y percentil (**26 aulas · 96.3%**) con enlace directo a cursadas activas.
|
|
||||||
- Cálculo dinámico en tiempo real de **Aulas Sin Asignar / Libres** en número y percentil (**1 aula · 3.7%**) con enlace directo al formulario de asignación de espacios.
|
|
||||||
- Barras de progreso visuales con desglose dual: **Planificación Cuatrimestral** (96.3% asignado vs 3.7% disponible) y **Ocupación Operativa del Día** (aulas con clases hoy vs aulas libres).
|
|
||||||
- Exposición de métricas de asignación y percentiles en el endpoint de la API REST `GET /api/v1/dashboard/stats`.
|
|
||||||
- **Módulo de Cursadas Asignadas y Métricas Reales en Catálogo Presencial (`/classrooms/list_classrooms?view_mode=physical`):**
|
|
||||||
- Incorporación de la sección *"Cursadas Asignadas"* dentro de cada tarjeta de aula física y columna en vista de tabla, detallando asignaturas, comisiones y turnos.
|
|
||||||
- Métricas de ocupación física real por período (Día, Semana, Mes) con porcentajes calculados dinámicamente (6%, 11%, 17%, 22% según la carga horaria del aula).
|
|
||||||
- Botones de acción directa con ID dinámico: **Ficha** (`/classrooms/view_classroom?id=...`), **Horarios en Calendario** (`/schedule/calendar_view?classroom_id=...`) y **Editar**.
|
|
||||||
- Conexión de la tabla *"Próximas Clases y Reservas"* en la ficha individual del aula (`/classrooms/view_classroom`) con las reservas reales del cuatrimestre y enlaces a cada reserva (`/schedule/view_reservation?id=...`).
|
|
||||||
|
|
||||||
### Modificado
|
|
||||||
- **Dashboard Docente (`/dashboard?role=docente`):**
|
|
||||||
- Eliminado el botón flotante *"Reservar Aula / Solicitar espacio para clase"* (`/schedule/add_reservation`) a petición de los requerimientos funcionales del cuerpo docente.
|
|
||||||
- Reorganizada la grilla superior a 3 columnas simétricas (`col-md-4`) para las tarjetas de *Mis Clases Hoy*, *Mis Reservas Activas* y *Aulas Virtuales*.
|
|
||||||
|
|
||||||
### Corregido
|
|
||||||
- **Fallo Crítico de Renderizado en Nunjucks (`memberLookup` con `.items`):**
|
|
||||||
- Solucionada la incompatibilidad de `nunjucks/src/jinja-compat` que interceptaba la propiedad `.items` convirtiendo `classrooms.items` en una función interna en lugar de un array, lo que impedía dibujar las tarjetas de aulas presenciales en `frontend/views/classrooms/list.html`.
|
|
||||||
- Implementado interceptor en `memberLookup` en `frontend/src/app.js` para preservar arrays intactos.
|
|
||||||
- **Clasificación Errónea de Reservas Físicas como Virtuales (`is_virtual`):**
|
|
||||||
- Corregida la propiedad `@property is_virtual` en `Reservation` (`backend/app/models/reservation.py`) para garantizar que si una reserva tiene aula física asignada (`self.classroom and not self.classroom.is_virtual`), siempre sea clasificada como presencial (`is_virtual = False`), evitando falsos positivos cuando la comisión posee un enlace virtual predeterminado.
|
|
||||||
- **Excepción de SQLAlchemy en Estadísticas de Dashboard:**
|
|
||||||
- Corregido el error de ejecución generado al invocar `.ilike()` sobre la propiedad Python `@property Classroom.room_number` en `backend/app/routes/api/dashboard.py`, migrando la clasificación de aulas presenciales y virtuales a una evaluación robusta en memoria Python (`Classroom.code` y `Classroom.building`).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.2.0] - 2026-09-19
|
|
||||||
### Añadido
|
|
||||||
- **Herramienta de Purga y Reinicio de Datos Académicos (`reset_academic_data`):**
|
|
||||||
- Script CLI `backend/scripts/reset_academic_data.py` con argumentos de limpieza granular (`--all`, `--reservations`, `--classrooms`, `--careers`, `--yes`).
|
|
||||||
- Endpoint de API `POST /api/v1/admin/reset-academic-data` protegido por JWT (rol `admin`) con registro en `AuditLog`.
|
|
||||||
- Panel interactivo "Zona de Reinicio y Purga Académica" en `/admin/google_sheets_import` con checkboxes independientes para reservas, aulas, comisiones, asignaturas y carreras.
|
|
||||||
- Modal modal de confirmación con advertencias de seguridad para prevenir purgas accidentales.
|
|
||||||
- Preservación íntegra de usuarios del sistema, credenciales de acceso, roles RBAC y registros de auditoría.
|
|
||||||
- **Configuración Global Dinámica de Google Sheets:**
|
|
||||||
- Nuevo modelo `SystemSetting` (`backend/app/models/setting.py`) para almacenamiento persistente clave-valor en base de datos.
|
|
||||||
- Endpoints `GET /api/v1/admin/sheets-config` y `POST /api/v1/admin/sheets-config`.
|
|
||||||
- Normalizador de enlaces en `GoogleSheetsImporter` compatible con URLs compartidas de edición (`/spreadsheets/d/.../edit`) o enlaces publicados (`/pub?output=csv`).
|
|
||||||
- Interfaz web con formulario de edición de URL, botón de guardado en caliente, restauración a URL oficial predeterminada y acceso directo a Google Docs.
|
|
||||||
- **Visualización de Asignaturas Reales:**
|
|
||||||
- Tabla de asignaturas recientemente sincronizadas conectada a la base de datos real en lugar de datos de muestra (*mock*).
|
|
||||||
|
|
||||||
### Corregido
|
|
||||||
- **Fallo por Timeout en Google Sheets Academic Sync:**
|
|
||||||
- Solucionado el corte prematuro de conexión en el BFF (`frontend/src/services/apiClient.js`), aumentando el timeout base a 25s y el timeout específico de sincronización a 90s (anteriormente limitado a 5s en operaciones que toman ~6.7s).
|
|
||||||
- Eliminado el enmascaramiento silencioso de errores en el BFF, permitiendo reportar fallos reales o éxitos detallados (+carreras, +aulas, +materias, +comisiones, +reservas).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.1.0] - 2026-09-19
|
|
||||||
### Añadido
|
|
||||||
- **Ficha Detallada de Reserva (`schedule.view_reservation`):**
|
|
||||||
- Implementación en BFF Node.js de la ruta `/schedule/view_reservation` (soportando parámetros `:id`, `?id=` o selección automática del primer registro).
|
|
||||||
- Vistas y controladores para modificar reservas con selectores en cascada (`/schedule/edit_reservation`).
|
|
||||||
- Endpoints de acción rápida en backend y BFF: `POST /schedule/confirm_reservation` y `POST /schedule/cancel_reservation`.
|
|
||||||
- Actualización de enlaces en `today.html`, `list.html`, `dashboard.html` y `view.html` para navegar directamente con el identificador de la reserva (`?id=...`).
|
|
||||||
- **Creación y Asociación de Comisiones a Asignaturas (`admin/commissions_list`):**
|
|
||||||
- Botón destacado `+ Nueva Comisión` en el encabezado y en el estado vacío de la tabla.
|
|
||||||
- Modal interactivo `#modalAddCommission` con selección obligatoria y clara de la **Asignatura / Materia Asociada** (`<select name="subject_id" required>`), mostrando código oficial, nombre y carrera.
|
|
||||||
- Campos completos de cursada: cuatrimestre (1C/2C/Anual), año lectivo, turno, docente a cargo, cupo máximo y días/horarios.
|
|
||||||
- Generación y configuración automática de enlace a Google Meet institucional cuando no se ingresa un enlace personalizado.
|
|
||||||
- Alerta de confirmación visual (`?created=1`) al registrar y vincular una comisión exitosamente.
|
|
||||||
- Tabla de comisiones actualizada con visualización explícita del código de materia, nombre y badge de carrera.
|
|
||||||
- **Enriquecimiento de la API REST:**
|
|
||||||
- Endpoint `GET /api/v1/reservations/<id>` ampliado con objetos relacionales anidados: `classroom` (código, edificio, piso, capacidad, descripción, virtualidad), `commission` (código, código compuesto, materia), `user` (docente, nombre, apellido, correo), duración en minutos y enlaces virtuales.
|
|
||||||
- Endpoint `POST /api/v1/admin/commissions` con validación estricta de existencia de asignatura y resolución inteligente de unicidad.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [2.0.0] - 2026-09-18
|
|
||||||
### Añadido
|
|
||||||
- **Reingeniería de Arquitectura Fullstack (Desacople Monolito -> Backend + BFF):**
|
|
||||||
- Desacople completo del backend Python/Flask como una **API REST pura** bajo `/api/v1/` retornando exclusivamente JSON.
|
|
||||||
- Implementación del **Frontend BFF** en Node.js + Express con renderizado de servidor mediante Nunjucks.
|
|
||||||
- Autenticación sin estado (*Stateless*) basada en tokens JWT firmados con algoritmo HS256.
|
|
||||||
- Almacenamiento seguro del token de acceso en cookies del navegador con directivas `HttpOnly`, `SameSite=Lax` y `Secure`.
|
|
||||||
- Inyección transparente del token `Bearer` en peticiones internas mediante cliente Axios centralizado.
|
|
||||||
- **Dashboards Personalizados por Rol Institucional:**
|
|
||||||
- **Dashboard de Bedelía (`/dashboard?role=bedelia`):** Métricas operativas de campus físico y virtual, cartelera del día y panel de aprobación de solicitudes pendientes.
|
|
||||||
- **Dashboard de Docente (`/dashboard?role=docente`):** Sesiones del día con botones directos para ingresar a reuniones virtuales (Meet/Teams/Zoom) y formulario de solicitud de aulas.
|
|
||||||
- **Dashboard de Alumno (`/dashboard?role=alumno`):** Brújula de cursada *"¿Dónde curso hoy?"* con ubicación por piso/aula o enlace virtual, junto al calendario de exámenes y entregas.
|
|
||||||
- **Dashboard de Administrador (`/dashboard?role=admin`):** Cockpit institucional de capacidad, usuarios, auditoría RBAC y distribución de comisiones.
|
|
||||||
- Selector dinámico de vista previa de roles en el banner superior para administradores.
|
|
||||||
- **Cartelera del Día Interactiva (`/schedule/today_schedule`):**
|
|
||||||
- Grilla estructurada en bloques horarios (07:00 a 21:00 hs) con métricas en tiempo real de ocupación y reservas confirmadas/pendientes.
|
|
||||||
- Filtro dinámico para ocultar clases virtuales (`hide_virtual=1`) y segmentación por pisos o turnos.
|
|
||||||
- **Seguridad Enterprise (SecurityFilterChain):**
|
|
||||||
- Pipeline centralizado de cabeceras de blindaje OWASP (`nosniff`, `SAMEORIGIN`, `X-XSS-Protection`, `Strict-Transport-Security`).
|
|
||||||
- Rate limiting dinámico contra ataques de fuerza bruta en endpoints de autenticación.
|
|
||||||
|
|
||||||
### Corregido
|
|
||||||
- **Resolución de Colisión de Horarios en Clases Virtuales (Importador de Google Sheets):**
|
|
||||||
- Corrección de la búsqueda de duplicados en `sheets_importer.py` que limitaba indebidamente la unicidad a `(classroom_id, start_time, end_time)`.
|
|
||||||
- Habilitación de concurrencia ilimitada para el aula virtual (`Campus Virtual · VIRTUAL`) mediante discriminación por `commission_id`.
|
|
||||||
- El total de reservas registradas aumentó de **363 a 643** (incorporando **280 clases virtuales** que eran descartadas por falso conflicto).
|
|
||||||
- Generación y guardado automático de enlaces institucionales de Google Meet (`https://meet.google.com/edu-{materia}-{comision}`).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## [1.0.0] - 2026-09-04
|
|
||||||
### Añadido
|
|
||||||
- **Versión Monolítica Base (`legacy_admin-edu-space`):**
|
|
||||||
- Aplicación monolítica en Flask con plantillas Jinja2 y persistencia SQLAlchemy (SQLite / PostgreSQL).
|
|
||||||
- Modelado de datos inicial para sedes, aulas físicas, materias, comisiones, usuarios y reservas.
|
|
||||||
- Sistema de roles inicial (Admin, Bedelía, Docente, Alumno) basado en sesión tradicional de Flask-Login.
|
|
||||||
- Calendario de reservas mensual y semanal con FullCalendar.
|
|
||||||
- Prototipo experimental de algoritmo genético para optimización de ocupación áulica.
|
|
||||||
- Módulo de sincronización inicial con planillas de Google Sheets.
|
|
||||||
@@ -0,0 +1,253 @@
|
|||||||
|
# Resumen de Cambios - Sesión de Desarrollo (Rama `dev`)
|
||||||
|
|
||||||
|
**Fecha:** 2026-09-02 / 2026-09-03
|
||||||
|
**Proyecto:** Admin Edu-Space (Flask + PostgreSQL)
|
||||||
|
**Rama:** `dev`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Auditoría Git y Puesta en Producción
|
||||||
|
* **Informe Técnico Completo (`DEPLOYMENT_AUDIT.md`):**
|
||||||
|
* Análisis de ramas locales y remotas (`main`, `dev`, `origin/planning`, `origin/commissions`, `origin/spanish`).
|
||||||
|
* Manual de despliegue en producción con arquitectura WSGI (Gunicorn), Nginx como proxy inverso, Systemd unit y contenedorización Docker / Docker Compose.
|
||||||
|
* **Archivos Base:**
|
||||||
|
* Creación de `.env.example` con todas las variables requeridas (PostgreSQL, Flask, Secret Key, Babel).
|
||||||
|
* Creación y posterior actualización de `init_db.py` para bootstrap inicial seguro de base de datos, roles RBAC y usuario administrador por defecto (`admin@edu-space.com` / `admin123`).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Base de Datos y Modelos
|
||||||
|
* **Preferencia de Idioma Persistente:**
|
||||||
|
* Migración en PostgreSQL agregando la columna `preferred_language VARCHAR(10)` a la tabla `users`.
|
||||||
|
* Actualización del modelo `User` en `app/models/user.py` con el campo `preferred_language`.
|
||||||
|
* **Preferencia de Tema Visual Persistente:**
|
||||||
|
* Migración agregando la columna `theme_preference VARCHAR(10) DEFAULT 'auto' NOT NULL` a la tabla `users`.
|
||||||
|
* Soporte en el modelo `User` para valores `'auto'`, `'light'` y `'dark'`.
|
||||||
|
* **Control de Acceso Basado en Roles (RBAC):**
|
||||||
|
* Migración creando las tablas `roles` y `permissions`, y agregando la clave foránea `role_id` a la tabla `users`.
|
||||||
|
* Modelos `Role` y `Permission` en `app/models/role.py`.
|
||||||
|
* Métodos `has_permission(module, min_level)` y `can_manage()` en `User`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Implementación de Vistas y Plantillas
|
||||||
|
* **Perfil de Usuario (`app/templates/auth/profile.html`):**
|
||||||
|
* Vista completa con datos del usuario, rol, estado, fecha de registro y reservas recientes.
|
||||||
|
* Formulario integral para configurar **Idioma de la interfaz** (*Detectar automáticamente del navegador*, *Español*, *English*) y **Tema visual** (*Automático*, *Modo Claro*, *Modo Oscuro*).
|
||||||
|
* **Cambio de Contraseña (`app/templates/auth/change_password.html`):**
|
||||||
|
* Formulario seguro para actualización de credenciales.
|
||||||
|
* **Manejo de Errores (`app/templates/auth/403.html`):**
|
||||||
|
* Pantalla de error 403 Forbidden estilizada e integrada con el sistema de diseño.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Correcciones de UX, Linter y Bugs de Rutas
|
||||||
|
* **Navbar Limpio (`app/templates/base.html`):**
|
||||||
|
* Eliminación del bloque duplicado del menú de usuario `System Administrator`.
|
||||||
|
* **Corrección de BuildError en Comisiones:**
|
||||||
|
* En `app/routes/classrooms.py`, se agregó el alias de ruta `@classrooms_bp.route('/', endpoint='index')` para resolver enlaces a `classrooms.index`.
|
||||||
|
* En `app/templates/schedule/commissions.html`, se reemplazó el filtro inválido de Django `truncatewords(20)` por el filtro estándar de Jinja2 `truncate(100)`.
|
||||||
|
* **Corrección Visual en `/genetic-optimizer` (`app/templates/genetic_optimizer.html`):**
|
||||||
|
* Se agregó el espaciado `pt-5 mt-4` evitando que la barra fija superior se monte sobre el contenido.
|
||||||
|
* Rediseño de tarjeta hero con contraste óptimo y reemplazo de iconos faltantes por Bootstrap Icons (`bi bi-...`).
|
||||||
|
* **Corrección de Errores del Linter en `schedule/add.html` y `schedule/view.html`:**
|
||||||
|
* En `add.html`: Desacople de iteraciones Jinja a `<script type="application/json" id="classroom-data">` y parseo con `JSON.parse()`, eliminando 19 errores sintácticos del editor.
|
||||||
|
* En `view.html`: Formateo de la propiedad inline `style` en barras de progreso para cumplir con el validador CSS.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Rediseño UI/UX, Assets Institucionales y Modo Claro/Oscuro
|
||||||
|
* **Exploración e Integración de Assets Gráficos:**
|
||||||
|
* Sincronización desde `app/resources` hacia `app/static/img/`:
|
||||||
|
* `logo_unicaba.png`: Logo institucional principal para el login.
|
||||||
|
* `logo_unicaba_mini.png`: Isotipo oficial para el navbar.
|
||||||
|
* `favicon.png`: Favicon vinculado en las plantillas base.
|
||||||
|
* `icons/`: Paquete de resoluciones WebApp/PWA.
|
||||||
|
* **Sistema de Diseño y Tokens de Color (`app/static/css/theme.css`):**
|
||||||
|
* Paleta institucional basada en Magenta/Uva (`#B43E8E`), acentos violetas (`#682CAD` / `#AE7FFF`) y secundarios magentas.
|
||||||
|
* Tokens CSS para `:root` (Modo Claro) y `[data-bs-theme="dark"]` (Modo Oscuro).
|
||||||
|
* Clases especializadas: `.auth-card`, `.navbar-app`, `.user-avatar-small`, `.theme-toggle-btn`, `.badge-brand`.
|
||||||
|
* **Modo Claro / Modo Oscuro Dinámico (`app/static/js/theme-toggle.js`):**
|
||||||
|
* Script anti-flickering en `<head>` para evitar parpadeos visuales al cargar la página.
|
||||||
|
* Botón toggle interactivo con persistencia en `localStorage`.
|
||||||
|
* En Modo Claro: Isotipo del navbar con filtro blanco puro (`brightness(0) invert(1)`) sobre el fondo magenta.
|
||||||
|
* Selector de idioma (`#languageDropdown`) con fondo y bordes de alto contraste y tilde de verificación blanca (`bi-check-lg`) visible **únicamente** en el idioma activo sobre gradiente magenta.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Internacionalización (i18n), Localización y Formateo de Fechas
|
||||||
|
* **Detección Inteligente de Subtags Regionales (`get_locale` en `app/__init__.py`):**
|
||||||
|
* Extracción del subtag primario (`es` a partir de `es-419`, `es-AR`, `es-ES`), resolviendo el fallo donde Werkzeug saltaba erróneamente a inglés.
|
||||||
|
* Configuración institucional: `BABEL_DEFAULT_LOCALE = 'es'` y `LANGUAGES = ['es', 'en']`.
|
||||||
|
* **Reglas de Idioma para la Pantalla de Login:**
|
||||||
|
* Resuelve según el navegador del visitante o recurre a español por defecto.
|
||||||
|
* Inmunidad contra cookies o sesiones residuales de otros usuarios.
|
||||||
|
* Flash messages traducidos (`¡Bienvenido de nuevo!`, `Has cerrado sesión correctamente`).
|
||||||
|
* **Formateador de Fechas Localizadas en Jinja2:**
|
||||||
|
* Registro de `format_date` y `format_datetime` de Flask-Babel.
|
||||||
|
* Fechas en español natural en `schedule/today.html` (`Jueves, 3 de septiembre de 2026`), `view.html` y `list.html`.
|
||||||
|
* **Traducción Integral de `schedule/add.html`:**
|
||||||
|
* Formulario y textos de ayuda 100% traducidos.
|
||||||
|
* Caja dinámica de resumen (JavaScript e `i18n-strings`) con cálculo de duración y validación de sobrecupo en español.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Módulo de Gestión de Accesos (RBAC) con Matriz FortiGate
|
||||||
|
* **Modelos y Persistencia:**
|
||||||
|
* Módulo `app/models/role.py` con `Role` y `Permission`.
|
||||||
|
* Roles iniciales sembrados: `Admin` (total, protegido), `Docente` (reservas y horarios), `Operador` (aulas y reservas), `Consulta` (solo lectura).
|
||||||
|
* Vinculación del usuario inicial `admin@edu-space.com` al rol `Admin`.
|
||||||
|
* **Matriz de Permisos Estilo FortiGate (`/admin/roles/edit/<id>`):**
|
||||||
|
* Tabla interactiva con columnas **Access Control** y **Permissions**.
|
||||||
|
* Segmented control por módulo con tres estados: `🚫 None`, `👁️ Read` y `✏️ Read/Write`.
|
||||||
|
* Color activo verde esmeralda FortiGate (`#2D9F6F`) con texto e icono en blanco puro.
|
||||||
|
* Menú desplegable masivo **Set All ▾** (*Set All to None*, *Set All to Read*, *Set All to Read/Write*).
|
||||||
|
* **Módulo de Administración (`app/routes/admin.py`):**
|
||||||
|
* `/admin/roles`: Listado de roles, conteo de miembros, visualización de permisos en badges (RW, R, -) y modal de borrado seguro.
|
||||||
|
* `/admin/users`: Listado de cuentas con filtros por nombre, rol y estado (Activo/Inactivo), paginación y switch rápido para alternar accesos.
|
||||||
|
* `/admin/users/add` y `/admin/users/edit/<id>`: Formularios de alta y edición con asignación de rol y contraseña opcional.
|
||||||
|
* **Seguridad y Decoradores (`app/utils/decorators.py`):**
|
||||||
|
* `@permission_required(module, min_level)` y `@admin_required`.
|
||||||
|
* Pestaña **Management** en el navbar visible exclusivamente para administradores.
|
||||||
|
* Botones de acción sensibles en el navbar (*Add Classroom*, *New Reservation*) condicionados a permisos de escritura.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Sincronización y Actualización de `init_db.py`
|
||||||
|
* Migraciones DDL automáticas (`ALTER TABLE ... ADD COLUMN IF NOT EXISTS`) para `preferred_language`, `theme_preference`, `role_id`, y para la tabla `careers` y columna `career_id` en `subjects`.
|
||||||
|
* Creación y siembra de roles institucionales y permisos en PostgreSQL.
|
||||||
|
* Configuración de salida con codificación UTF-8 segura en Windows para evitar excepciones de `cp1252`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. Sincronización e Importación de Datos Académicos (Google Sheets)
|
||||||
|
* **Modelo `Career` (`app/models/career.py`):**
|
||||||
|
* Entidad de carreras universitarias vinculada con `Subject` vía relación uno a muchos.
|
||||||
|
* Migración en PostgreSQL de la tabla `careers` y campo `career_id` en `subjects`.
|
||||||
|
* **Servicio de Extracción ([app/services/sheets_importer.py](file:///c:/Workspace/admin-edu-space/app/services/sheets_importer.py)):**
|
||||||
|
* Integración con la cartelera oficial UniCABA 2026 a través de 6 hojas CSV (`Lunes` a `Sábado`).
|
||||||
|
* Normalización inteligente de espacios áulicos físicos (`Aula 402`, `Aula 302`), espacios virtuales (`VIRTUAL`), auditorios y salas de reunión.
|
||||||
|
* Extracción y parseo de franjas horarias (`8:00 a 9:00hs`, `17:30 a 21:30hs`).
|
||||||
|
* Rutina de **upsert** transaccional e idempotente que previene la duplicación de datos.
|
||||||
|
* Generación de reservas/clases en el calendario para poblar instantáneamente las vistas de horario diario y semanal.
|
||||||
|
* **Interfaz de Gestión (`/admin/import`):**
|
||||||
|
* Vista interactiva con métricas en tiempo real (total de carreras, asignaturas, aulas, comisiones y clases).
|
||||||
|
* Botón de ejecución manual de sincronización con indicador visual de progreso (`spinner`).
|
||||||
|
* Reporte detallado de resultados y tabla con vista previa de asignaturas y comisiones sincronizadas.
|
||||||
|
* **Acceso Rápido en Navbar (`app/templates/base.html`):**
|
||||||
|
* Nueva opción **"Import from Google Sheets"** incorporada en el menú desplegable **Management**, restringida a roles con permisos administrativos.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. Correcciones en la Vista de Calendario (FullCalendar) y Códigos de Asignatura
|
||||||
|
* **Carga de Eventos y Corrección de Error 500 (`/schedule/calendar-data`):**
|
||||||
|
* Se identificó y corrigió el error `AttributeError: 'str' object has no attribute 'value'` provocado por llamadas a `.status.value` sobre campos de estado textuales.
|
||||||
|
* Se implementó el TypeDecorator `StatusType` con la clase `StatusString` en `app/models/reservation.py` garantizando compatibilidad total tanto para `.status` como para `.status.value`.
|
||||||
|
* Sanitización de fechas ISO 8601 con zona horaria (`Z`, `-03:00`) enviadas por FullCalendar para comparación adecuada con campos `TIMESTAMP WITHOUT TIME ZONE` en PostgreSQL.
|
||||||
|
* Anclaje de fecha inicial con `initialDate: '{{ today_date }}'` para posicionar el calendario en la semana activa de cursada 2026.
|
||||||
|
* **Corrección del Código de Asignatura (`subject_code`):**
|
||||||
|
* Se reemplazó la concatenación de código extendido de comisión (`Commission.get_full_code()` que arrojaba cadenas distorsionadas como `INGA0003-C1-2026-22026`) por el **código de asignatura real** del Sheet (`Subject.code`, ej. `INGA0003`, `ASIG00165`).
|
||||||
|
* Propiedades de acceso directo añadidas en `Reservation`: `subject_code`, `subject_name` y `classroom_name`.
|
||||||
|
* **Jerarquía Visual y Renderizado de Tarjetas (`calendar.html`):**
|
||||||
|
* Implementación del hook `eventContent` en FullCalendar 5 para construir tarjetas personalizadas.
|
||||||
|
* **Nombre de la Asignatura** destacado como elemento principal con tipografía grande y en negrita (`font-weight: 700; font-size: 0.88rem`).
|
||||||
|
* **Código de Asignatura** y **Aula** mostrados como datos secundarios en badges de alto contraste (código con fondo oscuro translúcido y aula con isotipo y fondo blanco translúcido).
|
||||||
|
* Modal interactivo instantáneo al hacer clic en cualquier evento con todos los detalles académicos de la clase y enlace a la ficha completa.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. Filtros por Aula y Materia en el Calendario de Reservas
|
||||||
|
* **Barra de Herramientas de Filtros Interactiva (`calendar.html`):**
|
||||||
|
* **Filtrar por Aula:** Desplegable dinámico con todas las aulas activas ordenadas por edificio y código (físicas y virtuales). Al seleccionar un aula (ej. `Aula 402`), se eliminan todas las superposiciones visuales mostrando el cronograma limpio de ese espacio.
|
||||||
|
* **Filtrar por Materia:** Desplegable ordenado alfabéticamente con formato `[Código] Nombre de la Asignatura`. Permite aislar todas las clases de una asignatura en particular.
|
||||||
|
* **Filtrar por Carrera:** Filtro adicional por plan académico/carrera.
|
||||||
|
* **Botón Limpiar Filtros:** Restablece instantáneamente todos los controles y refresca la vista.
|
||||||
|
* **Insignias de Estado:** Indicador en tiempo real de los filtros aplicados y contador de clases visibles (`X clases visibles`).
|
||||||
|
* **Soporte en Backend (`app/routes/schedule.py`):**
|
||||||
|
* `calendar_view`: Suministra las listas de `classrooms`, `subjects` y `careers` a la plantilla.
|
||||||
|
* `calendar_data`: Procesa `classroom_id`, `subject_id`, `career_id` y `search` aplicando cláusulas `filter()` con `JOIN` en SQLAlchemy.
|
||||||
|
* `refetchEvents()` de FullCalendar conectado a los eventos `change` de cada selector para recarga inmediata vía AJAX sin parpadeo de pantalla.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. Módulo de Gestión de Edificios y Corrección de Vistas de Aulas
|
||||||
|
* **Corrección de Plantillas de Aulas Faltantes:**
|
||||||
|
* Se crearon las plantillas [app/templates/classrooms/edit.html](file:///c:/Workspace/admin-edu-space/app/templates/classrooms/edit.html) y [app/templates/classrooms/view.html](file:///c:/Workspace/admin-edu-space/app/templates/classrooms/view.html), solucionando el error HTTP 500 (`TemplateNotFound: classrooms/edit.html`) y la redirección 302 que ocurría al hacer clic en cualquier aula.
|
||||||
|
* La vista de ficha técnica del aula ahora muestra detalles de capacidad, piso, estado, edificio y la tabla interactiva de próximas reservas.
|
||||||
|
* **Modelo y Base de Datos de Edificios (`Building`):**
|
||||||
|
* Se creó el modelo [app/models/building.py](file:///c:/Workspace/admin-edu-space/app/models/building.py) (`id`, `name`, `code`, `address`, `floors`, `description`, `is_active`, timestamps y relación con `Classroom`).
|
||||||
|
* Migración DDL en PostgreSQL (`CREATE TABLE buildings`, `ALTER TABLE classrooms ADD COLUMN building_id`).
|
||||||
|
* Actualización de [init_db.py](file:///c:/Workspace/admin-edu-space/init_db.py) y siembra de edificios institucionales iniciales (`Edificio Central` y `Campus Virtual`) con vinculación de las 25 aulas existentes.
|
||||||
|
* **Rutas y Gestión Completa (`app/routes/buildings.py`):**
|
||||||
|
* `/buildings`: Listado con métricas de infraestructura (total de edificios, aulas activas, capacidad total y plantas/pisos), barra de búsqueda y filtros por estado.
|
||||||
|
* `/buildings/<id>`: Vista de detalle con distribución de aulas organizadas visualmente por piso (Planta Baja, Piso 1, Piso 2, etc.), capacidad por sala y acciones directas.
|
||||||
|
* `/buildings/add` y `/buildings/<id>/edit`: Formularios con validación WTForms para alta y actualización.
|
||||||
|
* `/buildings/<id>/toggle` y `/buildings/<id>/delete`: Control de activación y eliminación protegida (impide borrar edificios que contengan aulas asignadas).
|
||||||
|
* **Navegación (`app/templates/base.html`):**
|
||||||
|
* Enlace a **Edificios** (`/buildings`) incorporado en el menú **Classrooms** y en el menú administrativo **Management**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 13. Mapeo de Campos del Google Sheet y Concepto de Turno (Mañana / Tarde)
|
||||||
|
* **Uso de los 5 Campos de la Cartelera Oficial:**
|
||||||
|
* **Codigo (`Subject.code` y `Commission.code`):** Almacena el código académico real (`INGA0003`, `ASIG00165`). Se expone como badge monoespaciado en eventos de calendario, comisiones y vistas administrativas.
|
||||||
|
* **Asignatura (`Subject.name`):** Título principal de la materia destacado en texto grande y en negrita en FullCalendar y en la cartelera diaria.
|
||||||
|
* **Aula (`Classroom.code`, `Classroom.building`, `Classroom.floor`, `Classroom.capacity`):** Normalización de espacios físicos y virtuales vinculados al nuevo modelo `Building`.
|
||||||
|
* **Carrera (`Career.name` y `Subject.career_id`):** Entidad de carrera universitaria con relaciones relacionales normalizadas.
|
||||||
|
* **Horarios (`Commission.schedule`, `Reservation.start_time`, `Reservation.end_time`):** Rango horario parseado hacia objetos `datetime` nativos para el motor de reservas y el calendario.
|
||||||
|
* **Modelado y Captura de Turnos (`TURNO MAÑANA` y `TURNO VESPERTINO`):**
|
||||||
|
* Se agregó la columna `shift` en las tablas `commissions` y `reservations` de PostgreSQL y en sus respectivos modelos de SQLAlchemy.
|
||||||
|
* El parser de [app/services/sheets_importer.py](file:///c:/Workspace/admin-edu-space/app/services/sheets_importer.py) identifica las filas delimitadoras de bloque (`TURNO MAÑANA` vs `TURNO VESPERTINO / TARDE`) y corrobora la hora de inicio (< 13:00hs = Mañana, $\ge$ 14:00hs = Tarde).
|
||||||
|
* Se sincronizaron todas las comisiones y reservas de cursada: 15 comisiones y 48 reservas en `Turno Mañana`; 191 comisiones y 364 reservas en `Turno Tarde / Vespertino`.
|
||||||
|
* En el Calendario de Reservas (`/schedule/calendar`) se añadió el selector **Filtrar por Turno** (`Todos`, `Mañana`, `Tarde / Vespertino`), permitiendo a los usuarios aislar las franjas horarias y resolver la alta concentración de clases en el horario vespertino (17:30 a 21:30hs).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 14. Accesos Directos en Panel, Ocultamiento de Virtuales, Filtro por Piso, Dirección Oficial y Traducción
|
||||||
|
* **Tarjetas Estadísticas como Accesos Directos Interactivos ([app/templates/dashboard.html](file:///c:/Workspace/admin-edu-space/app/templates/dashboard.html)):**
|
||||||
|
* **Total de Aulas (25):** Redirige a `/classrooms/list` con feedback visual de hover y elevación.
|
||||||
|
* **Total de Materias (206):** Redirige a `/schedule/commissions`.
|
||||||
|
* **Reservas de Hoy (18):** Redirige a `/schedule/today`.
|
||||||
|
* **Esta Semana (103):** Redirige a `/schedule/calendar`.
|
||||||
|
* Se añadieron microinteracciones CSS en [app/static/css/style.css](file:///c:/Workspace/admin-edu-space/app/static/css/style.css) (`.dashboard-stat-card`).
|
||||||
|
* **Ocultar Aulas Virtuales y Filtro por Piso:**
|
||||||
|
* **Calendario ([app/templates/schedule/calendar.html](file:///c:/Workspace/admin-edu-space/app/templates/schedule/calendar.html)):** Switch interactivo *Ocultar Aulas Virtuales* (indica capacidad ilimitada) y selector *Filtrar por Piso* (`Planta Baja`, `Piso 1`, `Piso 2`, `Piso 3`, `Piso 4`). El backend `/schedule/calendar-data` excluye las aulas virtuales o filtra por número de piso.
|
||||||
|
* **Cartelera del Día ([app/templates/schedule/today.html](file:///c:/Workspace/admin-edu-space/app/templates/schedule/today.html)):** Barra de filtros completa con soporte para ocultar virtuales, piso y turno.
|
||||||
|
* **Listado de Reservas ([app/templates/schedule/list.html](file:///c:/Workspace/admin-edu-space/app/templates/schedule/list.html)):** Endpoint `/schedule/list` totalmente operativo con paginación de 20 registros, preservación de query params y filtros de piso, turno, virtuales, estado y rango de fechas.
|
||||||
|
* **Dirección Oficial de la Sede Central:**
|
||||||
|
* Se configuró la dirección oficial de la Universidad de la Ciudad de Buenos Aires (UniCABA): **`Tte. Gral. Juan Domingo Perón 802, CABA`** en la base de datos, en [init_db.py](file:///c:/Workspace/admin-edu-space/init_db.py) y en el importador [app/services/sheets_importer.py](file:///c:/Workspace/admin-edu-space/app/services/sheets_importer.py).
|
||||||
|
* **Traducción Integral al Español y Catálogo Babel:**
|
||||||
|
* Se agregaron traducciones en [translations/es/LC_MESSAGES/messages.po](file:///c:/Workspace/admin-edu-space/translations/es/LC_MESSAGES/messages.po) y se recompiló el binario `.mo` con `pybabel`.
|
||||||
|
* Textos traducidos: `Buildings` $\rightarrow$ *Edificios*, `Management` $\rightarrow$ *Gestión*, `Timeline View` $\rightarrow$ *Vista Cronológica*, `Grid View` $\rightarrow$ *Vista en Tabla*, `Active Classrooms` $\rightarrow$ *Aulas Ocupadas*, `All Reservations` $\rightarrow$ *Todas las Reservas*, `AI Room Optimizer` $\rightarrow$ *Optimizador de Aulas*, etc.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 15. Actualización Integral de Roles RBAC, Capacidad Infinita (∞) y Horarios de Próximas Clases
|
||||||
|
* **Actualización de Roles, Grupos de Acceso y Matriz de Permisos ([app/models/role.py](file:///c:/Workspace/admin-edu-space/app/models/role.py), [init_db.py](file:///c:/Workspace/admin-edu-space/init_db.py)):**
|
||||||
|
* Se amplió `SYSTEM_MODULES` para cubrir los 8 módulos del sistema:
|
||||||
|
1. `classrooms`: **Aulas y Espacios** (físicas, virtuales y capacidades).
|
||||||
|
2. `buildings`: **Edificios y Sedes** (Sede Central, Campus Virtual, plantas).
|
||||||
|
3. `reservations`: **Reservas de Aulas** (aprobación, confirmación, cancelación).
|
||||||
|
4. `schedule`: **Cartelera y Cronograma** (calendario, cartelera del día, comisiones).
|
||||||
|
5. `academic`: **Gestión Académica** (carreras, asignaturas, códigos).
|
||||||
|
6. `import`: **Sincronización Sheets** (importador Google Sheets).
|
||||||
|
7. `optimizer`: **Optimizador IA** (algoritmo genético áulico).
|
||||||
|
8. `users`: **Usuarios y Accesos RBAC** (cuentas, roles y matriz).
|
||||||
|
* Se actualizaron los perfiles estándar (`Admin`, `Docente`, `Operador`, `Consulta`) en PostgreSQL y en `init_db.py`.
|
||||||
|
* Se tradujeron completamente las plantillas [app/templates/admin/roles/list.html](file:///c:/Workspace/admin-edu-space/app/templates/admin/roles/list.html) y [app/templates/admin/roles/edit.html](file:///c:/Workspace/admin-edu-space/app/templates/admin/roles/edit.html) al español.
|
||||||
|
* **Soporte de Capacidad Infinita (∞) y Aclaración ([app/forms/classroom.py](file:///c:/Workspace/admin-edu-space/app/forms/classroom.py), [app/templates/classrooms/edit.html](file:///c:/Workspace/admin-edu-space/app/templates/classrooms/edit.html)):**
|
||||||
|
* Se actualizó `ClassroomForm.capacity` con validador personalizado que admite el símbolo **`∞`**, `inf`, `0` o cualquier capacidad numérica positiva.
|
||||||
|
* Se corrigió la validación de `floor` con `InputRequired` y `NumberRange(min=0)` para aceptar Planta Baja (Piso 0).
|
||||||
|
* En la interfaz de edición y alta de aulas se incluyó el botón de acción rápida **`Ilimitada (∞)`** que rellena automáticamente el campo con el símbolo `∞`.
|
||||||
|
* Se añadió una leyenda explicativa directa: *"Para aulas virtuales o eventos sin aforo restringido, ingrese ∞ o 0 (Capacidad ilimitada)"*.
|
||||||
|
* Se tradujo el botón de guardado a *"Guardar Cambios"* (reemplazando *"Save Changes"*).
|
||||||
|
* El aula virtual institucional (`Campus Virtual - VIRTUAL`) se actualizó a capacidad `0` (`∞`), renderizando el badge `∞ Ilimitada` en listados y fichas.
|
||||||
|
* **Próximas Clases: Visualización Exclusiva del Horario ([app/templates/dashboard.html](file:///c:/Workspace/admin-edu-space/app/templates/dashboard.html), [app/templates/classrooms/view.html](file:///c:/Workspace/admin-edu-space/app/templates/classrooms/view.html)):**
|
||||||
|
* En la tabla de *Próximas Reservas* del panel y en la ficha del aula se cambió la columna a **"Horario"**, removiendo la fecha del calendario y destacando únicamente el rango horario de cursada (ej. `17:30 - 21:30 hs`).
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@@ -1,296 +0,0 @@
|
|||||||
# 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`.
|
|
||||||
|
|
||||||
- **Sprint v3.5.1: Exportación y Replicación Moodle Producción a Local con Usuarios y Emails Reales**:
|
|
||||||
- **Especificación SDD (`specs/002-moodle-export-sync/`)**: Creados `spec.md` (6 RF en EARS), `plan.md` y `tasks.md` (todas las tareas completadas).
|
|
||||||
- **Extracción Híbrida y Concurrente con Emails Reales**:
|
|
||||||
- `scripts/moodle_replicator.py` se autentica en `https://campus.udelaciudad.edu.ar/` con `logintoken` dinámico.
|
|
||||||
- Obtiene la nómina masiva estructurada vía `/user/action_redir.php` (`download_participants&dataformat=json`).
|
|
||||||
- Consulta de forma concurrente (ThreadPool con 10 workers) los perfiles de los usuarios (`user/view.php`) extrayendo sus correos personales y reales (`@gmail.com`, `@hotmail.com`, etc.), eliminando cualquier generación de emails inventados.
|
|
||||||
- Normalización fonética/ortográfica sin acentos (`normalize_name`) para vincular con 100% de precisión docentes y estudiantes entre HTML y JSON.
|
|
||||||
- **Reglas de Acceso y DNI Determinístico**:
|
|
||||||
- DNI de 8 dígitos determinístico derivado del ID de Moodle (`90{moodle_id:06d}`), asignado idénticamente como `username` y `password` para pruebas locales.
|
|
||||||
- Preservado el DNI y correo real de Carlos Tello (`34247025`, `carlostellocba@gmail.com`).
|
|
||||||
- **Carga en Moodle Local (`10.0.0.207`)**:
|
|
||||||
- Creación y actualización de usuarios mediante Moodle REST API (`core_user_create_users`, `core_user_update_users`).
|
|
||||||
- 504 matriculaciones completadas exitosamente en los 4 cursos oficiales:
|
|
||||||
* Carrera Lic. en Tecnologías Digitales (CCC): ID Prod 922 -> ID Local 19 (194 alumnos).
|
|
||||||
* ASIG00124 - Sistemas Digitales_2/2026: ID Prod 5311 -> ID Local 16 (131 alumnos y 2 profesores).
|
|
||||||
* ASIG00126 - Seguridad de la Información_2/2026: ID Prod 5313 -> ID Local 17 (138 alumnos y 2 profesores).
|
|
||||||
* ASIG00127 - Programación de Vanguardia - E1_2/2026: ID Prod 5314 -> ID Local 18 (41 alumnos y 2 profesores).
|
|
||||||
- Desactivada la política restrictiva de contraseñas (`passwordpolicy=0`) en el entorno de pruebas local para permitir contraseñas numéricas idénticas al DNI.
|
|
||||||
- Verificación exitosa de login de estudiante en `http://10.0.0.207/moodle/login/index.php`.
|
|
||||||
- **Skill de Automatización**: Creada `.agents/skills/moodle-replicator/SKILL.md` con manual operativo y comandos CLI.
|
|
||||||
|
|
||||||
- **Sprint v3.5.2: Replicación Completa de 16 Cursos, User-Agent Mozilla/5.0 y Fix de Credenciales**:
|
|
||||||
- **Catálogo Completo de la Carrera (16 Cursos)**:
|
|
||||||
- Se identificaron y replicaron la totalidad de las 15 materias de la Licenciatura en Tecnologías Digitales (1/2025, 2/2025, 1/2026 y 2/2026) más el curso de la carrera (Local 19).
|
|
||||||
- Resuelto el caso de alumnos como `90010202` (Carlos Guillermo Terzano): ahora cuenta con sus 6 materias reales cursadas (Local 4, 5, 8, 9, 10, 11) además de la carrera.
|
|
||||||
- Carlos Tello (`34247025`) matriculado en las 15 asignaturas y la carrera.
|
|
||||||
- Más de 1.100 matriculaciones procesadas y validadas con 100% de éxito.
|
|
||||||
- **Identificación y Asignación de Todos los Docentes**:
|
|
||||||
- Extraídos y asignados todos los profesores reales con rol `editingteacher` (ID 3) y correos institucionales `@udelaciudad.edu.ar`.
|
|
||||||
- **Cabecera HTTP y User-Agent**:
|
|
||||||
- Forzado estrictamente el encabezado `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)` en todas las solicitudes al campus para evitar alertas por `python-requests`.
|
|
||||||
- **Sincronización de Contraseña Local (Fix 34247025)**:
|
|
||||||
- Se corrigió la contraseña del usuario `34247025` restableciéndola a `34247025` idéntica al DNI en Moodle local. Verificado inicio de sesión exitoso.
|
|
||||||
|
|
||||||
- **Sprint v3.5.3: Importación de Roles Moodle-App, Limpieza Total de Admin y Purga de Cursos**:
|
|
||||||
- **Sincronización RBAC de Roles Moodle a PostgreSQL de la App (`classrooms_db`)**:
|
|
||||||
- Desarrollado `scripts/import_moodle_to_app.py` y bandera `--sync-app` en `moodle_replicator.py`.
|
|
||||||
- Mapeo unívoco: Moodle `editingteacher` -> App `Docente` (`role_id=2`), Moodle `student` -> App `Alumno` (`role_id=6`).
|
|
||||||
- Importados **653 usuarios únicos** (15 Docentes y 640 Alumnos) a la base de datos de producción con contraseñas PBKDF2 coincidentes con el DNI, habilitando de inmediato la asignación de comisiones, reservas e inscripciones.
|
|
||||||
- **Desmatriculación de Cuenta Admin en Moodle Local (`10.0.0.207`)**:
|
|
||||||
- Removidas todas las matriculaciones de `admin` en cursos académicos y generales (quedando con 0 enrolments).
|
|
||||||
- **Sprint v3.5.4: Conexión Moodle API, Login Delegado y Sincronización Moodle -> Edu Space**:
|
|
||||||
- **Habilitación de Web Services para Tokens de Usuario en Moodle Local (`10.0.0.207`)**:
|
|
||||||
- Asignada la capability `moodle/webservice:createtoken` al rol 7 (`user` / usuario autenticado) en `mdl_role_capabilities`.
|
|
||||||
- Habilitado `enablemobilewebservice = 1` y servicio `moodle_mobile_app` (`enabled = 1`).
|
|
||||||
- Verificada la emisión de tokens exitosa para usuarios individuales (incluyendo `34247025`) tanto contra `moodle_api` como contra `moodle_mobile_app`.
|
|
||||||
- **Conexión de Admin Edu Space con Moodle Local**:
|
|
||||||
- Configurado el token `810428346d3601c68a37a315fcba8d4391629f46` de `moodle_api` en `system_settings` de `classrooms_db`.
|
|
||||||
- Habilitada `auth_moodle_enabled = 'true'` y `moodle_server_url = 'http://10.0.0.207/moodle'`.
|
|
||||||
- Adaptado el endpoint de autenticación `/api/v1/auth/moodle` para autenticar con `moodle_api` (con fallback a `moodle_mobile_app`) y hacer matching de cuenta local por número de documento (DNI).
|
|
||||||
- **Sincronización Bidireccional Moodle -> Edu Space**:
|
|
||||||
- Agregado el endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle`.
|
|
||||||
- Incorporados los métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
|
|
||||||
- **Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening**:
|
|
||||||
- **Purga de Tareas de Sincronización Residuales**:
|
|
||||||
- Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla `moodle_sync_tasks` de `classrooms_db` en `10.0.0.217`, dejando la cola limpia en 0 registros.
|
|
||||||
- **Ampliación de Funciones Web Services en Moodle Local (`10.0.0.207`)**:
|
|
||||||
- Asignadas al servicio `moodle_api` las funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`, completando el catálogo a 15 funciones esenciales.
|
|
||||||
- **Seguridad por Restricción de Red (IP Restriction)**:
|
|
||||||
- Fijada la restricción de red `iprestriction = '10.0.0.0/24'` en `mdl_external_tokens`, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle.
|
|
||||||
- **Autenticación por API Key Institucional en Admin Edu Space**:
|
|
||||||
- Creado mecanismo para autenticar endpoints de sincronización (`/settings/moodle/sync` y `/moodle/sync-from-moodle`) mediante `X-API-Key` institucional de 64 caracteres hex.
|
|
||||||
- Generada y almacenada la clave API institucional cifrada con Fernet en `system_settings` (`classrooms_db`).
|
|
||||||
- Agregados endpoints para consulta y regeneración de clave API (`/api/v1/admin/settings/moodle/api-key`).
|
|
||||||
|
|
||||||
- **Sprint v3.5.6: Principio 10 de Tolerancia Cero a Errores de Código, Robustez en SystemSetting y Replicador**:
|
|
||||||
- **Principio 10 de la Constitución**:
|
|
||||||
- Incorporada regla mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
|
|
||||||
- Es estrictamente inadmisible declarar una tarea o sprint como terminado o completado si persisten errores en el código o en el analizador de la IDE (`@[current_problems]`).
|
|
||||||
- **Reparación de Tipos en Replicador Moodle**:
|
|
||||||
- Ajustado casteo a entero `int(course_meta['local_id'])` y `int(u.get('role_id', 5))` en `scripts/moodle_replicator.py`.
|
|
||||||
- **Robustez Híbrida en `SystemSetting`**:
|
|
||||||
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
|
|
||||||
- **Resolución de Condición de Carrera en Tests de SQLite**:
|
|
||||||
- Añadida espera activa de finalización de workers en `test_05_api_async_job_submission_and_polling` para evitar bloqueos de base de datos en `tearDown()`.
|
|
||||||
- **Validación Automatizada**:
|
|
||||||
- 52/52 tests pasando en verde al 100% (`pytest tests -v`).
|
|
||||||
|
|
||||||
- **Sprint v3.5.7: Principio 11 de la Constitución — Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
|
|
||||||
- **Arquitectura Modular en 4 Capas**:
|
|
||||||
- Desacople estricto: `main.py` (bootstrap/registro), `routers/` (endpoints agrupados por dominio con prefijos y tags para Swagger), `schemas/` (contratos con Pydantic `BaseModel`), `storage.py` (acceso a persistencia). Prohibida la lógica de negocio en el frontend o en archivos monolíticos.
|
|
||||||
- **Tipado Fuerte y Validación Pydantic**:
|
|
||||||
- Uso obligatorio de `Field` para validaciones declarativas (`min_length`, `max_length`, `gt`, `ge`, regex).
|
|
||||||
- Distinción estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados con defaults).
|
|
||||||
- Manejo y respuesta automática de error `422 Unprocessable Entity` detallando el campo exacto.
|
|
||||||
- **Semántica HTTP y Excepciones Controladas**:
|
|
||||||
- Uso de códigos de estado HTTP semánticos (`201 Created` en POST, `200 OK`, `204 No Content`).
|
|
||||||
- Prohibido retornar `null` o respuestas vacías ante fallos: levantar `HTTPException` controladas con detalle descriptivo (404, 400, 409).
|
|
||||||
- **Documentación Interactiva Automática**:
|
|
||||||
- Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo (*Try it out*).
|
|
||||||
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
|
|
||||||
- **Pestaña en Configuración Global**: Planificada en `ROADMAP.md` y UI administrativa para configurar URL del servidor local (Ollama, llama.cpp), modelo, token y timeout para el futuro asistente virtual de la app.
|
|
||||||
- **Cliente Asíncrono no Bloqueante**: Uso mandatorio de `httpx.AsyncClient` con `async def` / `await` para inferencias concurrentes sin bloquear el servidor.
|
|
||||||
- **Timeout Generoso**: Configurar timeout de 600 segundos previendo carga de modelos en VRAM o prompts extensos.
|
|
||||||
- **Formato Estándar de Roles**: Historial estructurado bajo `role: "system" | "user" | "assistant"` y `content: prompt`.
|
|
||||||
- **Actualización Documental Completa**:
|
|
||||||
- Sincronizados `docs/constitution.md` (Principio 11), `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` (Fase 7) y `MEMORY.md`.
|
|
||||||
|
|
||||||
## Próximos pasos
|
|
||||||
1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles.
|
|
||||||
2. Implementar la pestaña de Asistente IA en la Configuración Global administrativa (`ROADMAP.md` Fase 7).
|
|
||||||
3. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.
|
|
||||||
@@ -1,275 +1,249 @@
|
|||||||
# Panel de Administración Edu-Space (UniCABA)
|
# Edu-Space Admin Panel
|
||||||
|
|
||||||
Plataforma integral de gestión áulica, asignación de espacios, control de horarios, seguimiento académico y reservas para la **Universidad de la Ciudad de Buenos Aires (UniCABA)**.
|
A comprehensive web-based administration interface for the Edu-Space Classroom Reservation System built with Flask.
|
||||||
|
|
||||||
El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
|
## Features
|
||||||
|
|
||||||
**Versión Actual:** `3.5.7` (Principio 11: Estándares Modernos de APIs, Pydantic e Integración de IA)
|
### 🔐 Authentication & Security
|
||||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
- Secure login system with hashed passwords
|
||||||
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
|
- Role-based access control
|
||||||
|
- Session management with Flask-Login
|
||||||
|
- Password change functionality
|
||||||
|
|
||||||
---
|
### 🏫 Classroom Management
|
||||||
|
- Create, edit, and delete classrooms
|
||||||
|
- Campus and building organization
|
||||||
|
- Capacity and resource tracking
|
||||||
|
- Real-time availability checking
|
||||||
|
|
||||||
## 🗺️ Estado del Roadmap MVP
|
### 📅 Schedule Management
|
||||||
|
- Interactive calendar view (FullCalendar)
|
||||||
|
- Reservation creation and management
|
||||||
|
- Conflict detection and prevention
|
||||||
|
- Status tracking (Pending, Confirmed, Cancelled)
|
||||||
|
- Today's schedule overview
|
||||||
|
|
||||||
```
|
### 📊 Dashboard & Analytics
|
||||||
Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado)
|
- Real-time statistics
|
||||||
Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado)
|
- Monthly reservation charts
|
||||||
Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado)
|
- Quick actions interface
|
||||||
Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
|
- Upcoming reservations overview
|
||||||
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 9 Pasos & Cierre de Bedelía [████████████████████] 100% (Entregado v3.5.0)
|
|
||||||
Fase 6: Despliegue Producción e Infraest. [███████░░░░░░░░░░░░░] 45% (En Curso)
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
### 🎨 Modern UI/UX
|
||||||
|
- Responsive Bootstrap 5 design
|
||||||
|
- Dark theme support
|
||||||
|
- Mobile-friendly interface
|
||||||
|
- Interactive components and charts
|
||||||
|
|
||||||
## 🏛️ Sede Institucional y Ubicaciones
|
## Tech Stack
|
||||||
* **Sede Central UniCABA:** Tte. Gral. Juan Domingo Perón 802, Ciudad Autónoma de Buenos Aires (CABA) — Aulas de grado, auditorio principal y laboratorios distribuidos desde Planta Baja (Piso 0) hasta el 4.° Piso.
|
|
||||||
* **Campus Virtual:** Espacio áulico digital integrado (Microsoft Teams / Moodle) configurado con **capacidad ilimitada ($\infty$)**.
|
|
||||||
|
|
||||||
---
|
- **Backend**: Flask (Python)
|
||||||
|
- **Database**: SQLAlchemy (SQLite/PostgreSQL)
|
||||||
|
- **Frontend**: Bootstrap 5, jQuery, Chart.js
|
||||||
|
- **Authentication**: Flask-Login, Werkzeug
|
||||||
|
- **Forms**: Flask-WTF
|
||||||
|
- **Calendar**: FullCalendar.js
|
||||||
|
|
||||||
## 🏗️ Arquitectura del Proyecto (Monorepo)
|
## Installation
|
||||||
|
|
||||||
El repositorio implementa un patrón desacoplado en formato monorepo compuesto por la **Core API (Backend)**, la capa de mediación y vistas **BFF (Frontend)**, herramientas unificadas de despliegue, auditoría automatizada y flujos de CI/CD:
|
### Prerequisites
|
||||||
|
- Python 3.8+
|
||||||
|
- pip package manager
|
||||||
|
|
||||||
```text
|
### Setup
|
||||||
/
|
|
||||||
├── backend/ # Capa Core API (Python 3.10+ / Flask / SQLAlchemy)
|
|
||||||
│ ├── app/ # Lógica de negocio y arquitectura desacoplada
|
|
||||||
│ │ ├── models/ # Modelos ORM (User, Role, Classroom, Reservation, etc.)
|
|
||||||
│ │ ├── routes/api/ # Endpoints REST JSON v1 (/auth, /classrooms, /admin, etc.)
|
|
||||||
│ │ ├── schemas/ # DTOs y validación de contratos (Pydantic v2)
|
|
||||||
│ │ ├── services/ # Servicios de dominio (JWT, Email SMTP, Moodle, Queue)
|
|
||||||
│ │ └── security/ # Pipeline de filtros y validación stateless de JWT
|
|
||||||
│ ├── tests/ # Suite activa de pruebas unitarias y de integración (pytest)
|
|
||||||
│ ├── init_db.py # Inicializador idempotente de esquema, roles RBAC y semillas
|
|
||||||
│ ├── backup_db.sh # Generador automatizado de backups para PostgreSQL
|
|
||||||
│ ├── classrooms_db.sql # Snapshot integral de base de datos para despliegue
|
|
||||||
│ ├── wsgi.py # Entrada WSGI para ejecución con Gunicorn
|
|
||||||
│ └── requirements.txt # Dependencias Python auditadas (0 vulnerabilidades / CVEs)
|
|
||||||
│
|
|
||||||
├── frontend/ # Backend-For-Frontend BFF (Node.js 20 LTS / Express)
|
|
||||||
│ ├── src/ # Capa servidora de mediación web
|
|
||||||
│ │ ├── app.js # Servidor Express, seguridad Helmet, rate-limiting
|
|
||||||
│ │ ├── controllers/ # Controladores de orquestación y mediación
|
|
||||||
│ │ ├── middlewares/ # Sesión por Cookie HttpOnly, JWT injection y RBAC
|
|
||||||
│ │ ├── routes/ # Enrutamiento web (auth, schedule, classrooms, admin)
|
|
||||||
│ │ └── services/ # Cliente Axios centralizado hacia Flask API
|
|
||||||
│ ├── views/ # Plantillas y componentes dinámicos en Nunjucks (.html)
|
|
||||||
│ │ ├── admin/ # Paneles de gestión institucional y configuración
|
|
||||||
│ │ ├── classrooms/ # Catálogo de aulas y visualización de sedes
|
|
||||||
│ │ ├── schedule/ # Cronograma de comisiones, reservas y calendario
|
|
||||||
│ │ ├── my_subjects/ # Libreta de calificaciones, hitos evaluativos y cursada
|
|
||||||
│ │ └── partials/ # Componentes reutilizables, modales y navegación
|
|
||||||
│ ├── public/ # Assets estáticos (CSS responsive 720p/1080p, JS cliente)
|
|
||||||
│ └── package.json # Dependencias y manifiesto de Node.js
|
|
||||||
│
|
|
||||||
├── install.sh # Instalador nativo unificado para Linux / Proxmox LXC
|
|
||||||
├── security_audit.bat # Suite automatizada de auditoría (SAST, SCA, DAST)
|
|
||||||
├── .gitea/workflows/ # Pipelines de integración continua (CI/CD en Gitea)
|
|
||||||
├── docs/ # Especificaciones técnicas, auditorías y changelogs
|
|
||||||
├── ROADMAP_MVP.md # Plan de evolución, estadios y fases del proyecto
|
|
||||||
├── SECURITY_AUDIT_REPORT.md # Informe formal de auditoría y hardening
|
|
||||||
└── README.md # Documentación general y guía operativa
|
|
||||||
```
|
|
||||||
|
|
||||||
### 🐍 Backend Core API (Python + Flask)
|
1. **Clone or setup the project:**
|
||||||
- Funciona exclusivamente como una **REST API** que expone endpoints bajo `/api/v1/` retornando **JSON**.
|
```bash
|
||||||
- Encargado de la persistencia de datos (SQLAlchemy / PostgreSQL o SQLite), lógica de negocio, servicio de tokens JWT (Access & Refresh), matriz RBAC, y algoritmos de optimización heurística (Módulo Predictivo).
|
cd /Users/alejandro.v/PycharmProjects/admin-edu-space
|
||||||
- **Prohibido** retornar HTML o utilizar Jinja2/`render_template` en este entorno.
|
```
|
||||||
|
|
||||||
### 🟢 Frontend BFF (Node.js + Express)
|
2. **Create virtual environment:**
|
||||||
- Aplicación Backend-For-Frontend que renderiza las vistas para el cliente mediante **Nunjucks**.
|
|
||||||
- Gestiona la sesión segura del usuario almacenando el token JWT recibido de Flask en una **Cookie HttpOnly**.
|
|
||||||
- Actúa como proxy de conexión con el Backend de Python empleando **Axios** (inyectando el Bearer token interceptado).
|
|
||||||
- Blindado con **Helmet** (cabeceras de seguridad HTTP) y **express-rate-limit** para mitigar ataques de fuerza bruta.
|
|
||||||
- Interfaz adaptativa y responsive diseñada para pantallas estándar argentinas (720p, 1366x768 y 1080p) con gráficos dinámicos (**Chart.js**).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 Dashboards Personalizados por Rol
|
|
||||||
|
|
||||||
La plataforma cuenta con paneles adaptados a las necesidades operativas de cada perfil institucional:
|
|
||||||
|
|
||||||
* **Administrador (`/dashboard?role=admin`):** Cockpit institucional con métricas globales, auditoría de seguridad RBAC, tendencias mensuales y panel interactivo de **Estado y Percentiles de Asignación de Aulas Físicas** (asignadas vs disponibles en número y porcentaje).
|
|
||||||
* **Bedelía (`/dashboard?role=bedelia`):** Control operativo del campus en tiempo real, balance de aulas presenciales asignadas (96.3%) y libres (3.7%), cartelera del día y bandeja de aprobación de reservas pendientes.
|
|
||||||
* **Docente / Profesor (`/dashboard?role=docente`):** Sesiones del día con accesos directos a videollamadas y gestión de comisiones.
|
|
||||||
* **Alumno / Estudiante (`/dashboard?role=alumno`):** Brújula de cursada *"¿Dónde curso hoy?"* con ubicación por piso y aula o enlace virtual, junto al cronograma de exámenes y entregas de TPs.
|
|
||||||
|
|
||||||
> **Modo Vista Previa:** Los usuarios con perfil administrador o directivo pueden previsualizar cualquier perspectiva utilizando el selector de roles en la barra superior o pasando el parámetro `?role={admin|bedelia|docente|alumno}` en la URL.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏛️ Circuito Operativo de Bedelía (UX & Flujo Simplificado)
|
|
||||||
|
|
||||||
Para garantizar una experiencia de usuario rápida y sin fricción para el personal de Bedelía, el circuito de gestión áulica se divide en 3 etapas directas:
|
|
||||||
|
|
||||||
```
|
|
||||||
[ 1. Creación / Edición de Aula ] ──► [ 2. Asignación de Comisión al Aula ] ──► [ 3. Cartelera y Grilla ]
|
|
||||||
- Sede Central o Campus Virtual - Desde Comisiones (1 clic) - Detección de colisiones
|
|
||||||
- Piso y Aforo real - O desde Ficha de Aula - Drag & Drop semanal
|
|
||||||
- Tipo (Teórica / Laboratorio) - Autocompletado de cupo y Meet - Cartelera del día en vivo
|
|
||||||
```
|
|
||||||
|
|
||||||
### 1. Creación y Mantenimiento de Aulas (`/classrooms/list_classrooms`)
|
|
||||||
* Acceso directo a **"Nueva Aula"**: se selecciona la sede (Edificio Central o Campus Virtual), piso (`PB`, `1`, `2`, `3`, `4`) y tipo de espacio (Teórica, Laboratorio de Informática, etc.).
|
|
||||||
* Las aulas virtuales se configuran con capacidad infinita ($\infty$) y no distorsionan la capacidad de bancos físicos del edificio central.
|
|
||||||
* En el catálogo de aulas, cada tarjeta muestra el aforo, piso, equipamiento y el botón de acción rápida **"Asignar Comisión"**, que abre el formulario de reserva con el aula ya preseleccionada.
|
|
||||||
|
|
||||||
### 2. Asignación de Comisión al Aula (`/schedule/add_reservation`)
|
|
||||||
La asignación puede realizarse desde dos puntos de entrada según la necesidad operativa:
|
|
||||||
* **Desde el Catálogo de Comisiones (`/admin/commissions_list`):**
|
|
||||||
- Cada fila cuenta con el botón de acceso rápido **"Asignar Aula / Horario"** (`bi-calendar-plus`).
|
|
||||||
- Al hacer clic, redirige a `/schedule/add_reservation?commission_id={id}` precargando de forma automática:
|
|
||||||
- Nombre de la asignatura y código de comisión.
|
|
||||||
- Cupo esperado de alumnos (`expected_attendees = max_students`).
|
|
||||||
- Enlace de videollamada preexistente (Google Meet / Teams).
|
|
||||||
* **Desde el Catálogo de Aulas (`/classrooms/list_classrooms`):**
|
|
||||||
- Al pulsar **"Asignar Comisión"**, redirige a `/schedule/add_reservation?classroom_id={id}`.
|
|
||||||
- El selector en cascada (**1. Edificio ➔ 2. Piso ➔ 3. Aula**) se auto-posiciona en la sede, planta y aula elegidas.
|
|
||||||
* **Validación en Vivo:** El sistema alerta inmediatamente si la cantidad de alumnos de la comisión excede la capacidad física del aula seleccionada.
|
|
||||||
|
|
||||||
### 3. Visualización y Control de Ocupación
|
|
||||||
* **Cartelera del Día (`/schedule/today_schedule`):** Bloques horarios de 07:00 a 21:00 hs con filtros por piso, turno y switch para ocultar aulas virtuales.
|
|
||||||
* **Grilla Semanal Interactiva (`/schedule/calendar`):** Arrastre de comisiones sin aula asignada desde el panel lateral con detección de colisiones físicas, solapamientos docentes y aforo en tiempo real (HTTP 409).
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🧹 Módulo de Purga y Sincronización Académica
|
|
||||||
|
|
||||||
* **Purga Segura y Selectiva (`/admin/google_sheets_import`):**
|
|
||||||
- Permite restablecer limpiamente reservas, comisiones, asignaturas, carreras y/o aulas para comenzar nuevos ciclos lectivos o pruebas de carga.
|
|
||||||
- **Confirmación Interactiva:** Cuenta con un modal de confirmación (`#purgeConfirmModal`) que lista las entidades específicas a eliminar y previene clics accidentales.
|
|
||||||
- **Integridad Referencial Estricta:** Ejecuta la eliminación en orden topológico inverso de claves foráneas (`Reservation` ➔ `MilestoneGrade` ➔ `CommissionTeacher` ➔ `StudentEnrollment` ➔ `Commission` ➔ `Subject` ➔ `Career` ➔ `Classroom`), garantizando que la base de datos no rechace el borrado por restricciones relacionales.
|
|
||||||
- **Preservación Total de Identidades:** Los usuarios (`User`), contraseñas y roles (`Role`) están estrictamente blindados y nunca son afectados por la purga de datos académicos.
|
|
||||||
* **Importación desde Google Sheets:** Carga y sincronización dinámica de todas las materias y franjas horarias directamente desde la hoja institucional publicada.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⚡ Capacidades Avanzadas de Gestión (Fases 2, 3 y 4 del MVP)
|
|
||||||
|
|
||||||
### 1. Grilla Semanal Interactiva (Drag & Drop) y Validación de Colisiones en Tiempo Real
|
|
||||||
- **FullCalendar Interactivo:** Arrastre y edición de horarios directo en el calendario general de Bedelía (`/schedule/calendar`).
|
|
||||||
- **Sidebar de Comisiones por Asignar:** Panel lateral colapsable con las comisiones sin aula, con arrastre fluido hacia la grilla semanal o diaria.
|
|
||||||
- **Detección Automática de Choques (HTTP 409):** Validación previa ante cada movimiento (`POST /api/v1/reservations/drag-update`) verificando colisiones físicas de aula, superposición docente y límite de aforo. Si hay conflicto, el evento se revierte automáticamente (`info.revert()`) y se notifica al usuario con un Toast explicativo.
|
|
||||||
|
|
||||||
### 2. Modo Impersonación del Superadmin ("Login as")
|
|
||||||
- Permite al Administrador navegar la plataforma adoptando exactamente la perspectiva y permisos de cualquier docente o estudiante.
|
|
||||||
- Activación con un clic (`bi-incognito`) desde el catálogo de usuarios (`/admin/users_list`).
|
|
||||||
- Banner superior permanente de advertencia visual en color ámbar con identificación del usuario adoptado y botón de salida inmediata.
|
|
||||||
- Trazabilidad y auditoría obligatoria inmutable en `audit_logs` (`IMPERSONATE_START` e `IMPERSONATE_END`).
|
|
||||||
|
|
||||||
### 3. Libro de Calificaciones (*Gradebook*) & Cierre Formal de Actas
|
|
||||||
- Matriz bidimensional interactiva de calificaciones por comisión (`/schedule/gradebook/:id`) con autoguardado asíncrono debounced (500 ms).
|
|
||||||
- Cálculo en vivo de promedios ponderados y condiciones académicas (*Promocionado*, *Regular*, *Libre*).
|
|
||||||
- Cierre formal de actas con generación de código inmutable (`ACTA-YYYY-Sem-ID`), auditoría en `audit_logs` y congelamiento de modificaciones.
|
|
||||||
- Soporte para reapertura excepcional justificada por Bedelía.
|
|
||||||
- Portal del Estudiante (`/schedule/my_grades` / `/mis-materias/mis-notas`) para consulta de calificaciones y comprobantes.
|
|
||||||
|
|
||||||
### 4. Co-docencia, Matriz de Conflictos y Regla Diaria
|
|
||||||
- Soporte de cátedras con múltiples docentes por comisión (`CommissionTeacher`).
|
|
||||||
- Excepción por co-docencia: autoriza superposiciones de horario docente si la cátedra cuenta con un co-docente registrado disponible.
|
|
||||||
- Regla restrictiva de cursada diaria: un alumno no puede cursar dos asignaturas regulares el mismo día, con excepciones automáticas para talleres/cursos cortos (`is_short_course`) o autorizaciones especiales emitidas por Bedelía.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📅 Ficha de Reserva & Gestión de Comisiones
|
|
||||||
|
|
||||||
* **Ficha de Reserva Detallada (`/schedule/view_reservation?id={id}`):** Información completa del espacio físico o virtual asignado, capacidad y asistencia prevista, comisión académica vinculada, docente a cargo, botones de acción inmediata (*Modificar Reserva*, *Confirmar Reserva*, *Cancelar Reserva*) y acceso con un clic a la sala de videollamada.
|
|
||||||
* **Gestión de Comisiones y Vinculación con Asignaturas (`/admin/commissions_list`):**
|
|
||||||
- Botón y modal interactivo **Nueva Comisión** (`#modalAddCommission`) para registrar comisiones y vincularlas directamente a su **Asignatura / Materia**, indicando cuatrimestre, año, turno, cupo y docente responsable.
|
|
||||||
- Generación automática de enlace institucional de Google Meet cuando no se especifica un enlace propio.
|
|
||||||
- Tabla operativa con visualización explícita del código de comisión, nombre de materia, código de asignatura y carrera.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 Instalación y Despliegue Local
|
|
||||||
|
|
||||||
### Requisitos previos
|
|
||||||
- Node.js (v18 o superior)
|
|
||||||
- Python 3.10+
|
|
||||||
- SQLite / PostgreSQL
|
|
||||||
|
|
||||||
### 1. Iniciar el Backend (Flask)
|
|
||||||
```bash
|
```bash
|
||||||
cd backend
|
|
||||||
python -m venv venv
|
python -m venv venv
|
||||||
# Activar venv (Windows: venv\Scripts\activate, Linux/Mac: source venv/bin/activate)
|
source venv/bin/activate # On Windows: venv\Scripts\activate
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Install dependencies:**
|
||||||
|
```bash
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
flask run --port=5000
|
|
||||||
```
|
```
|
||||||
*(El backend quedará escuchando en http://localhost:5000)*
|
|
||||||
|
|
||||||
### 2. Iniciar el Frontend (Node/Express)
|
4. **Setup environment variables:**
|
||||||
```bash
|
```bash
|
||||||
cd frontend
|
cp .env.example .env
|
||||||
npm install
|
# Edit .env with your configuration
|
||||||
npm run dev
|
|
||||||
# o en su defecto:
|
|
||||||
node src/app.js
|
|
||||||
```
|
```
|
||||||
*(El frontend quedará escuchando en http://localhost:3000)*
|
|
||||||
|
5. **Initialize database:**
|
||||||
|
```bash
|
||||||
|
python app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
### Environment Variables (.env)
|
||||||
|
|
||||||
|
```env
|
||||||
|
FLASK_APP=app.py
|
||||||
|
FLASK_ENV=development
|
||||||
|
SECRET_KEY=your-secret-key-here-please-change-in-production
|
||||||
|
DATABASE_URL=sqlite:///edu_space.db
|
||||||
|
API_BASE_URL=http://localhost:8080/api
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Start the Application
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
The application will be available at: `http://localhost:5000`
|
||||||
|
|
||||||
|
### Default Login
|
||||||
|
|
||||||
|
- **Email**: admin@edu-space.com
|
||||||
|
- **Password**: admin123
|
||||||
|
|
||||||
|
### Main Features
|
||||||
|
|
||||||
|
1. **Dashboard**: Overview of system statistics and upcoming reservations
|
||||||
|
2. **Classrooms**: Manage classroom information, capacity, and resources
|
||||||
|
3. **Schedule**: View and manage reservations with calendar interface
|
||||||
|
4. **Profile**: User profile and password management
|
||||||
|
|
||||||
|
## API Integration
|
||||||
|
|
||||||
|
The admin panel integrates with the Spring Boot API at `http://localhost:8080/api`. Make sure the Java microservice is running for full functionality.
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
admin-edu-space/
|
||||||
|
├── app/
|
||||||
|
│ ├── __init__.py # Flask app factory
|
||||||
|
│ ├── models/ # Database models
|
||||||
|
│ │ ├── user.py
|
||||||
|
│ │ ├── classroom.py
|
||||||
|
│ │ ├── subject.py
|
||||||
|
│ │ └── reservation.py
|
||||||
|
│ ├── routes/ # Application routes
|
||||||
|
│ │ ├── auth.py
|
||||||
|
│ │ ├── main.py
|
||||||
|
│ │ ├── classrooms.py
|
||||||
|
│ │ └── schedule.py
|
||||||
|
│ ├── forms/ # WTForms classes
|
||||||
|
│ │ ├── auth.py
|
||||||
|
│ │ ├── classroom.py
|
||||||
|
│ │ └── reservation.py
|
||||||
|
│ ├── templates/ # Jinja2 templates
|
||||||
|
│ ├── static/ # Static files
|
||||||
|
├── config/ # Configuration files
|
||||||
|
├── requirements.txt
|
||||||
|
├── .env
|
||||||
|
├── app.py
|
||||||
|
└── README.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Database Schema
|
||||||
|
|
||||||
|
### Users Table
|
||||||
|
- User authentication and authorization
|
||||||
|
- Role management (admin, staff)
|
||||||
|
|
||||||
|
### Classrooms Table
|
||||||
|
- Classroom information
|
||||||
|
- Capacity and location details
|
||||||
|
- Resource management
|
||||||
|
|
||||||
|
### Reservations Table
|
||||||
|
- Booking management
|
||||||
|
- Time slot scheduling
|
||||||
|
- Status tracking
|
||||||
|
|
||||||
|
### Subjects + Commissions Tables
|
||||||
|
- Academic information
|
||||||
|
- Teacher assignments
|
||||||
|
- Student enrollment tracking
|
||||||
|
|
||||||
|
## Security Features
|
||||||
|
|
||||||
|
- Password hashing with bcrypt
|
||||||
|
- Session management
|
||||||
|
- CSRF protection
|
||||||
|
- Input validation and sanitization
|
||||||
|
- SQL injection prevention with SQLAlchemy ORM
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
### Running in Development Mode
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export FLASK_ENV=development
|
||||||
|
python app.py
|
||||||
|
```
|
||||||
|
|
||||||
|
### Adding New Features
|
||||||
|
|
||||||
|
1. Create models in `app/models/`
|
||||||
|
2. Add routes in `app/routes/`
|
||||||
|
3. Create forms if needed in `app/forms/`
|
||||||
|
4. Update templates in `app/templates/`
|
||||||
|
|
||||||
|
## Production Deployment
|
||||||
|
|
||||||
|
### Environment Setup
|
||||||
|
|
||||||
|
1. **Set production variables:**
|
||||||
|
```env
|
||||||
|
FLASK_ENV=production
|
||||||
|
SECRET_KEY=<strong-random-string>
|
||||||
|
DATABASE_URL=<production-database-url>
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Use production WSGI server:**
|
||||||
|
```bash
|
||||||
|
pip install gunicorn
|
||||||
|
gunicorn -w 4 -b 0.0.0.0:5000 app:app
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Configure reverse proxy** (nginx/Apache)
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
### Common Issues
|
||||||
|
|
||||||
|
1. **Database connection errors:**
|
||||||
|
- Check DATABASE_URL string
|
||||||
|
- Ensure directory permissions
|
||||||
|
|
||||||
|
2. **Login issues:**
|
||||||
|
- Verify admin user exists
|
||||||
|
- Check password hash
|
||||||
|
|
||||||
|
3. **Static files not loading:**
|
||||||
|
- Ensure blueprint route registration
|
||||||
|
- Check file permissions
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
1. Fork the repository
|
||||||
|
2. Create feature branch
|
||||||
|
3. Make changes
|
||||||
|
4. Test thoroughly
|
||||||
|
5. Submit pull request
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is part of the Edu-Space educational management system.
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
For support and questions:
|
||||||
|
- Email: admin@edu-space.com
|
||||||
|
- Documentation: Check inline comments and README files
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📦 Despliegue Automatizado en Producción (Linux / Proxmox LXC)
|
**Note**: This admin panel is designed to work alongside the Spring Boot microservice. Ensure both services are running for complete functionality.
|
||||||
|
|
||||||
Para servidores Debian 12 / Ubuntu en Proxmox LXC o VPS, el repositorio incluye el instalador unificado [install.sh](install.sh) en la raíz:
|
|
||||||
|
|
||||||
# Despliegue interactivo (pregunta si mantener BD, restaurar snapshot o crear base limpia):
|
|
||||||
sudo bash install.sh
|
|
||||||
|
|
||||||
# Despliegue desatendido manteniendo la base de datos existente:
|
|
||||||
sudo bash install.sh --keep-db
|
|
||||||
|
|
||||||
# Despliegue desatendido preservando la base de datos y los usuarios/credenciales configurados:
|
|
||||||
sudo bash install.sh --keep-db --keep-users
|
|
||||||
|
|
||||||
# Despliegue desatendido con base de datos limpia sin carreras, materias, ciclos lectivos, aulas ni edificios demo:
|
|
||||||
sudo bash install.sh --empty-academic
|
|
||||||
|
|
||||||
# Despliegue desatendido recreando la base de datos desde cero con snapshot de muestra (DROP y restore classrooms_db.sql):
|
|
||||||
sudo bash install.sh --fresh-db
|
|
||||||
```
|
|
||||||
|
|
||||||
También es posible inicializar directamente la base de datos limpia desde Python en cualquier entorno:
|
|
||||||
```bash
|
|
||||||
# Inicialización estándar con datos de muestra:
|
|
||||||
python backend/init_db.py
|
|
||||||
|
|
||||||
# Inicialización limpia (sin carreras, materias, ciclos lectivos, aulas, edificios ni reservas):
|
|
||||||
python backend/init_db.py --empty-academic
|
|
||||||
```
|
|
||||||
|
|
||||||
El script configura automáticamente:
|
|
||||||
1. Entorno Python 3.10+ y virtualenv en `backend/venv` con Gunicorn y servicio `admin-edu-space-backend.service` (puerto 5000).
|
|
||||||
2. Entorno Node.js 20 LTS en `frontend/` con servicio `admin-edu-space-frontend.service` (puerto 3000).
|
|
||||||
3. Motor PostgreSQL local con configuración de usuario y opciones seguras para preservar o restaurar la base `classrooms_db`.
|
|
||||||
4. Servicio maestro unificado `admin-edu-space.service` gestionable vía `systemctl {status|restart|stop} admin-edu-space`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🧪 Pruebas Automatizadas
|
|
||||||
|
|
||||||
Para ejecutar la suite completa de 47 pruebas unitarias y de integración (JWT, ABMs, Reglas, Optimizador, Calificaciones y Moodle):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd backend
|
|
||||||
$env:PYTHONPATH="backend"
|
|
||||||
.\venv\Scripts\python.exe -m pytest tests -v
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📚 Documentación Técnica & Changelogs
|
|
||||||
* [Roadmap MVP: Fases y Estadios del Proyecto](ROADMAP_MVP.md)
|
|
||||||
* [Changelog Oficial del Proyecto (v2.8.0)](CHANGELOG.md)
|
|
||||||
* [Changelog MVP Consolidado](CHANGELOG_MVP.md)
|
|
||||||
* [Estado de la Migración y Arquitectura Objetivo UniCABA](ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md)
|
|
||||||
* [Changelog Detallado: Clases Virtuales y Dashboards](docs/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md)
|
|
||||||
* [Auditoría y Sesión de Reingeniería](docs/CHANGELOG_SESSION.md)
|
|
||||||
* [Guía de Integración de Cronograma](docs/SCHEDULE_INTEGRATION_GUIDE.md)
|
|
||||||
@@ -1,126 +0,0 @@
|
|||||||
# 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.7 (Principio 11: Estándares Modernos de APIs, Pydantic e Integración de IA)
|
|
||||||
**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.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### Fase 7: Integración con Modelos de IA Locales (LLMs) & Asistente Virtual en la App 🤖 *(Diseñada / Por Implementar)*
|
|
||||||
- [ ] **Pestaña de Asistente IA en Configuración Global**:
|
|
||||||
- Incorporar en la vista de configuración general del Administrador una pestaña dedicada a la configuración de IA.
|
|
||||||
- Parámetros configurables: URL del servidor de inferencia (Ollama, llama.cpp, vLLM, LiteLLM), Modelo seleccionado, Clave de API / Token, Timeout de conexión (por defecto 600s para entornos locales), y Switch de activación general.
|
|
||||||
- Almacenamiento seguro de credenciales con Fernet en base de datos (`system_settings`).
|
|
||||||
- [ ] **Módulo Backend Asíncrono de Inferencia (`httpx`)**:
|
|
||||||
- Implementar servicio `AIService` utilizando `httpx.AsyncClient` con funciones asíncronas no bloqueantes (`async def` / `await`).
|
|
||||||
- Gestión estructurada del historial y contexto mediante el estándar de roles (`system`, `user`, `assistant`).
|
|
||||||
- Timeout generoso (600 segundos) para mitigar demoras en carga de modelos a VRAM o prompts extensos.
|
|
||||||
- [ ] **Asistente Conversacional para Usuarios**:
|
|
||||||
- Componente de interfaz flotante para guiar a Bedelía, Docentes y Alumnos en el uso de la plataforma.
|
|
||||||
- Capacidades de consulta sobre asignaciones áulicas, cronogramas, comisiones y manuales operativos.
|
|
||||||
|
|
||||||
@@ -0,0 +1,112 @@
|
|||||||
|
from flask import Flask, request, session
|
||||||
|
from flask_sqlalchemy import SQLAlchemy
|
||||||
|
from flask_migrate import Migrate
|
||||||
|
from flask_login import LoginManager
|
||||||
|
from flask_cors import CORS
|
||||||
|
from flask_babel import Babel, gettext as _
|
||||||
|
from config.config import Config
|
||||||
|
|
||||||
|
# Initialize extensions
|
||||||
|
db = SQLAlchemy()
|
||||||
|
migrate = Migrate()
|
||||||
|
login_manager = LoginManager()
|
||||||
|
cors = CORS()
|
||||||
|
babel = Babel()
|
||||||
|
|
||||||
|
def create_app(config_class=Config):
|
||||||
|
app = Flask(__name__)
|
||||||
|
app.config.from_object(config_class)
|
||||||
|
|
||||||
|
# Initialize extensions with app
|
||||||
|
db.init_app(app)
|
||||||
|
migrate.init_app(app, db)
|
||||||
|
login_manager.init_app(app)
|
||||||
|
cors.init_app(app)
|
||||||
|
|
||||||
|
# Login manager configuration
|
||||||
|
login_manager.login_view = 'auth.login'
|
||||||
|
login_manager.login_message = 'Por favor inicia sesión para acceder a esta página.'
|
||||||
|
login_manager.login_message_category = 'info'
|
||||||
|
|
||||||
|
# Import models to ensure they are registered
|
||||||
|
from app.models import user
|
||||||
|
# Register blueprints
|
||||||
|
from app.routes import auth_bp, classrooms_bp, buildings_bp, main_bp, schedule_bp, genetic_bp, genetic_web_bp, admin_bp
|
||||||
|
|
||||||
|
app.register_blueprint(auth_bp, url_prefix="/")
|
||||||
|
app.register_blueprint(classrooms_bp, url_prefix="/classrooms")
|
||||||
|
app.register_blueprint(buildings_bp)
|
||||||
|
app.register_blueprint(main_bp, url_prefix="/")
|
||||||
|
app.register_blueprint(schedule_bp, url_prefix="/schedule")
|
||||||
|
app.register_blueprint(genetic_bp)
|
||||||
|
app.register_blueprint(genetic_web_bp)
|
||||||
|
app.register_blueprint(admin_bp)
|
||||||
|
|
||||||
|
# Language selector function
|
||||||
|
def get_locale():
|
||||||
|
# 1. Parámetro explícito en la URL (?lang=es o ?lang=en)
|
||||||
|
lang = request.args.get('lang')
|
||||||
|
if lang and lang in app.config['LANGUAGES']:
|
||||||
|
session['language'] = lang
|
||||||
|
return lang
|
||||||
|
|
||||||
|
# 2. Si el usuario está autenticado y tiene idioma configurado en su perfil, prevalece en toda la sesión
|
||||||
|
from flask_login import current_user
|
||||||
|
if current_user.is_authenticated and getattr(current_user, 'preferred_language', None):
|
||||||
|
if current_user.preferred_language in app.config['LANGUAGES']:
|
||||||
|
return current_user.preferred_language
|
||||||
|
|
||||||
|
# 3. En la pantalla de Login (usuario no autenticado):
|
||||||
|
# El idioma predeterminado del login debe ser español o respetar el idioma del navegador.
|
||||||
|
# No debe verse afectado por cookies o sesiones residuales de otros usuarios.
|
||||||
|
is_login = (request.endpoint == 'auth.login' or request.path.rstrip('/') == '/login')
|
||||||
|
if is_login:
|
||||||
|
# Solo si el usuario cambió el idioma explícitamente en el selector del login
|
||||||
|
if session.get('login_lang_explicit') in app.config['LANGUAGES']:
|
||||||
|
return session['login_lang_explicit']
|
||||||
|
|
||||||
|
# Detectar según el navegador del usuario (soporta es-419, es-AR, es-ES, etc.)
|
||||||
|
if request.accept_languages:
|
||||||
|
for accepted_lang, _quality in request.accept_languages:
|
||||||
|
primary = accepted_lang.split('-')[0].lower()
|
||||||
|
if primary in app.config['LANGUAGES']:
|
||||||
|
return primary
|
||||||
|
|
||||||
|
# Idioma predeterminado por defecto del login: Español
|
||||||
|
return 'es'
|
||||||
|
|
||||||
|
# 4. Para otras rutas: verificar si hay idioma en sesión (ej. selector manual)
|
||||||
|
if 'language' in session and session['language'] in app.config['LANGUAGES']:
|
||||||
|
return session['language']
|
||||||
|
|
||||||
|
# 5. Detección automática del navegador por defecto (soporta subtags regionales)
|
||||||
|
if request.accept_languages:
|
||||||
|
for accepted_lang, _quality in request.accept_languages:
|
||||||
|
primary = accepted_lang.split('-')[0].lower()
|
||||||
|
if primary in app.config['LANGUAGES']:
|
||||||
|
return primary
|
||||||
|
|
||||||
|
# Fallback del sistema: Español
|
||||||
|
return app.config['BABEL_DEFAULT_LOCALE']
|
||||||
|
|
||||||
|
|
||||||
|
# Babel context processor
|
||||||
|
@app.context_processor
|
||||||
|
def inject_conf_vars():
|
||||||
|
return dict(
|
||||||
|
languages=app.config['LANGUAGES'],
|
||||||
|
current_lang=str(get_locale())
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
# Configure Babel
|
||||||
|
babel.init_app(app, locale_selector=get_locale)
|
||||||
|
|
||||||
|
# Register localized date and datetime formatters for Jinja2 templates
|
||||||
|
from flask_babel import format_date, format_datetime
|
||||||
|
app.jinja_env.globals['format_date'] = format_date
|
||||||
|
app.jinja_env.globals['format_datetime'] = format_datetime
|
||||||
|
app.jinja_env.filters['format_date'] = format_date
|
||||||
|
app.jinja_env.filters['format_datetime'] = format_datetime
|
||||||
|
|
||||||
|
return app
|
||||||
@@ -4,14 +4,11 @@ from wtforms.validators import DataRequired, Email, Length
|
|||||||
from flask_babel import lazy_gettext as _l
|
from flask_babel import lazy_gettext as _l
|
||||||
|
|
||||||
class LoginForm(FlaskForm):
|
class LoginForm(FlaskForm):
|
||||||
email = StringField(_l('Email'),
|
email = StringField(_l('Email'), validators=[
|
||||||
validators=[
|
|
||||||
DataRequired(),
|
DataRequired(),
|
||||||
Email(),
|
Email(),
|
||||||
Length(max=120)
|
Length(max=120)
|
||||||
],
|
])
|
||||||
filters=[lambda x: x.strip().lower() if x else '']
|
|
||||||
)
|
|
||||||
password = PasswordField(_l('Password'), validators=[DataRequired()])
|
password = PasswordField(_l('Password'), validators=[DataRequired()])
|
||||||
remember_me = BooleanField(_l('Remember me'))
|
remember_me = BooleanField(_l('Remember me'))
|
||||||
submit = SubmitField(_l('Sign In'))
|
submit = SubmitField(_l('Sign In'))
|
||||||
@@ -19,25 +19,27 @@ def validate_capacity(form, field):
|
|||||||
raise ValidationError(_l('Ingrese un número entero o el símbolo ∞ para capacidad ilimitada.'))
|
raise ValidationError(_l('Ingrese un número entero o el símbolo ∞ para capacidad ilimitada.'))
|
||||||
|
|
||||||
class ClassroomForm(FlaskForm):
|
class ClassroomForm(FlaskForm):
|
||||||
building_id = SelectField(_l('Edificio'), validators=[DataRequired()])
|
building = StringField(_l('Building'), validators=[
|
||||||
new_building_name = StringField(_l('Nombre del Nuevo Edificio'), validators=[Optional(), Length(max=100)])
|
DataRequired(),
|
||||||
room_number = StringField(_l('Número / Nombre del Aula'), validators=[
|
Length(min=2, max=100)
|
||||||
|
])
|
||||||
|
room_number = StringField(_l('Room Number'), validators=[
|
||||||
DataRequired(),
|
DataRequired(),
|
||||||
Length(min=1, max=50)
|
Length(min=1, max=50)
|
||||||
])
|
])
|
||||||
floor = StringField(_l('Piso'), validators=[
|
floor = IntegerField(_l('Floor'), validators=[
|
||||||
DataRequired(message=_l('El piso es obligatorio (ej: PB, 1, 2, 4°P)')),
|
InputRequired(message=_l('El piso es obligatorio (0 para Planta Baja)')),
|
||||||
Length(min=1, max=50)
|
NumberRange(min=0, max=50, message=_l('El piso debe estar entre 0 (Planta Baja) y 50'))
|
||||||
])
|
])
|
||||||
capacity = StringField(_l('Capacidad'), validators=[
|
capacity = StringField(_l('Capacity'), validators=[
|
||||||
validate_capacity
|
validate_capacity
|
||||||
])
|
])
|
||||||
description = TextAreaField(_l('Descripción'), validators=[
|
description = TextAreaField(_l('Description'), validators=[
|
||||||
Optional(),
|
Optional(),
|
||||||
Length(max=500)
|
Length(max=500)
|
||||||
])
|
])
|
||||||
is_active = BooleanField(_l('Activa'), default=True)
|
is_active = BooleanField(_l('Active'), default=True)
|
||||||
submit = SubmitField(_l('Guardar Aula'))
|
submit = SubmitField(_l('Save Classroom'))
|
||||||
|
|
||||||
class ClassroomResourceForm(FlaskForm):
|
class ClassroomResourceForm(FlaskForm):
|
||||||
resource_type = SelectField(_l('Resource Type'), choices=[
|
resource_type = SelectField(_l('Resource Type'), choices=[
|
||||||
@@ -21,16 +21,8 @@ class ReservationForm(FlaskForm):
|
|||||||
Optional(),
|
Optional(),
|
||||||
Length(max=1000)
|
Length(max=1000)
|
||||||
])
|
])
|
||||||
virtual_link = StringField(_l('Virtual Classroom Link'), validators=[
|
|
||||||
Optional(),
|
|
||||||
Length(max=500)
|
|
||||||
])
|
|
||||||
submit = SubmitField(_l('Make Reservation'))
|
submit = SubmitField(_l('Make Reservation'))
|
||||||
|
|
||||||
def __init__(self, *args, is_edit=False, **kwargs):
|
|
||||||
super().__init__(*args, **kwargs)
|
|
||||||
self.is_edit = is_edit
|
|
||||||
|
|
||||||
def validate_end_time(self, field):
|
def validate_end_time(self, field):
|
||||||
if field.data <= self.start_time.data:
|
if field.data <= self.start_time.data:
|
||||||
raise ValidationError('End time must be after start time.')
|
raise ValidationError('End time must be after start time.')
|
||||||
@@ -40,8 +32,8 @@ class ReservationForm(FlaskForm):
|
|||||||
raise ValidationError('Reservation cannot exceed 8 hours.')
|
raise ValidationError('Reservation cannot exceed 8 hours.')
|
||||||
|
|
||||||
def validate_start_time(self, field):
|
def validate_start_time(self, field):
|
||||||
# Don't allow new reservations in the past
|
# Don't allow reservations in the past
|
||||||
if not self.is_edit and field.data < datetime.now() - timedelta(minutes=10):
|
if field.data < datetime.now():
|
||||||
raise ValidationError('Start time cannot be in the past.')
|
raise ValidationError('Start time cannot be in the past.')
|
||||||
|
|
||||||
# Don't allow reservations too far in the future (max 3 months)
|
# Don't allow reservations too far in the future (max 3 months)
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
from .user import User
|
||||||
|
from .building import Building
|
||||||
|
from .classroom import Classroom, ClassroomResource
|
||||||
|
from .career import Career
|
||||||
|
from .subject import Subject, Commission
|
||||||
|
from .reservation import Reservation, ReservationStatus
|
||||||
|
from .genetic_algorithm import GeneticAlgorithm, ReservationOptimizer
|
||||||
|
from .role import Role, Permission, SYSTEM_MODULES
|
||||||
|
|
||||||
|
__all__ = [
|
||||||
|
'User',
|
||||||
|
'Building',
|
||||||
|
'Classroom',
|
||||||
|
'ClassroomResource',
|
||||||
|
'Career',
|
||||||
|
'Subject',
|
||||||
|
'Commission',
|
||||||
|
'Reservation',
|
||||||
|
'ReservationStatus',
|
||||||
|
'GeneticAlgorithm',
|
||||||
|
'ReservationOptimizer',
|
||||||
|
'Role',
|
||||||
|
'Permission',
|
||||||
|
'SYSTEM_MODULES'
|
||||||
|
]
|
||||||
@@ -17,43 +17,10 @@ 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
|
|
||||||
def is_virtual(self):
|
|
||||||
"""Identifica si la sede corresponde al Campus Virtual"""
|
|
||||||
c = (self.code or '').upper()
|
|
||||||
n = (self.name or '').upper()
|
|
||||||
return 'VIRTUAL' in c or 'VIRTUAL' in n
|
|
||||||
|
|
||||||
@property
|
|
||||||
def physical_capacity(self):
|
|
||||||
"""Capacidad física instalada real (excluye aulas virtuales con capacidad 9999 o infinitas)"""
|
|
||||||
if self.is_virtual:
|
|
||||||
return 0
|
|
||||||
return sum(c.capacity for c in self.classrooms if c.is_active and (c.capacity or 0) < 999 and not getattr(c, 'is_virtual', False))
|
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def total_capacity(self):
|
def total_capacity(self):
|
||||||
"""Capacidad para compatibilidad histórica"""
|
"""Total student capacity across active classrooms in this building"""
|
||||||
if self.is_virtual:
|
return sum(c.capacity for c in self.classrooms if c.is_active)
|
||||||
return 0
|
|
||||||
return self.physical_capacity
|
|
||||||
|
|
||||||
@property
|
|
||||||
def capacity_display(self):
|
|
||||||
"""Representación textual clara para UI/UX"""
|
|
||||||
if self.is_virtual:
|
|
||||||
return "Ilimitada (Virtual)"
|
|
||||||
return str(self.physical_capacity)
|
|
||||||
|
|
||||||
@property
|
|
||||||
def floors_display(self):
|
|
||||||
"""Representación de pisos"""
|
|
||||||
if self.is_virtual:
|
|
||||||
return "Digital"
|
|
||||||
return str(self.floors)
|
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def classrooms_count(self):
|
def classrooms_count(self):
|
||||||
@@ -67,14 +34,10 @@ class Building(db.Model):
|
|||||||
'code': self.code,
|
'code': self.code,
|
||||||
'address': self.address,
|
'address': self.address,
|
||||||
'floors': self.floors,
|
'floors': self.floors,
|
||||||
'floors_display': self.floors_display,
|
|
||||||
'description': self.description,
|
'description': self.description,
|
||||||
'is_active': self.is_active,
|
'is_active': self.is_active,
|
||||||
'is_virtual': self.is_virtual,
|
|
||||||
'classrooms_count': self.classrooms_count,
|
'classrooms_count': self.classrooms_count,
|
||||||
'physical_capacity': self.physical_capacity,
|
'total_capacity': self.total_capacity,
|
||||||
'total_capacity': self.physical_capacity if not self.is_virtual else 0,
|
|
||||||
'capacity_display': self.capacity_display,
|
|
||||||
'created_at': self.created_at.isoformat() if self.created_at else None
|
'created_at': self.created_at.isoformat() if self.created_at else None
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -13,9 +13,6 @@ 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,
|
||||||
@@ -9,71 +9,23 @@ class Classroom(db.Model):
|
|||||||
building_id = db.Column(db.Integer, db.ForeignKey('buildings.id'), nullable=True)
|
building_id = db.Column(db.Integer, db.ForeignKey('buildings.id'), nullable=True)
|
||||||
building = db.Column(db.String(100), nullable=False)
|
building = db.Column(db.String(100), nullable=False)
|
||||||
code = db.Column('room_number', db.String(50), nullable=False) # Maps to room_number column in DB
|
code = db.Column('room_number', db.String(50), nullable=False) # Maps to room_number column in DB
|
||||||
floor = db.Column(db.String(50), nullable=False, default='1')
|
floor = db.Column(db.Integer, nullable=False)
|
||||||
capacity = db.Column(db.Integer, nullable=False)
|
capacity = db.Column(db.Integer, nullable=False)
|
||||||
description = db.Column(db.Text)
|
description = db.Column(db.Text)
|
||||||
is_active = db.Column('active', db.Boolean, default=True, nullable=False) # Maps to active column in DB
|
is_active = db.Column('active', db.Boolean, default=True, nullable=False) # Maps to active column in DB
|
||||||
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)
|
|
||||||
@property
|
|
||||||
def building_rel(self):
|
|
||||||
return self.building_entity
|
|
||||||
|
|
||||||
@property
|
|
||||||
def building_name(self):
|
|
||||||
"""Nombre del edificio desacoplado"""
|
|
||||||
if self.building_rel:
|
|
||||||
return self.building_rel.name
|
|
||||||
return self.building or 'Edificio Central'
|
|
||||||
|
|
||||||
@property
|
|
||||||
def floor_display(self):
|
|
||||||
"""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 ''
|
|
||||||
if not f:
|
|
||||||
return 'Planta Baja (PB)'
|
|
||||||
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
|
|
||||||
if f.isdigit():
|
|
||||||
return f"Piso {f}"
|
|
||||||
return f
|
|
||||||
|
|
||||||
@property
|
|
||||||
def is_virtual(self):
|
|
||||||
"""Indica si el aula es virtual"""
|
|
||||||
return (self.code and 'VIRTUAL' in self.code.upper()) or (self.building and 'VIRTUAL' in self.building.upper())
|
|
||||||
|
|
||||||
@property
|
|
||||||
def location_display(self):
|
|
||||||
"""Ubicación completa y limpia: Edificio · Piso · Aula"""
|
|
||||||
if self.is_virtual:
|
|
||||||
return '🌐 Campus Virtual'
|
|
||||||
return f"{self.building_name} · {self.floor_display} · {self.code}"
|
|
||||||
|
|
||||||
# Virtual properties for compatibility
|
# Virtual properties for compatibility
|
||||||
@property
|
@property
|
||||||
def name(self):
|
def name(self):
|
||||||
"""Generate name from building and code"""
|
"""Generate name from building and code"""
|
||||||
return f"{self.building_name}-{self.code}"
|
return f"{self.building}-{self.code}"
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def campus_location(self):
|
def campus_location(self):
|
||||||
"""Placeholder for campus location"""
|
"""Placeholder for campus location - can be expanded when campus model is implemented"""
|
||||||
return self.building_rel.address if self.building_rel else None
|
return None
|
||||||
|
|
||||||
# Virtual field for compatibility - combines building and code
|
# Virtual field for compatibility - combines building and code
|
||||||
@property
|
@property
|
||||||
@@ -87,34 +39,28 @@ class Classroom(db.Model):
|
|||||||
# Override code property for consistency
|
# Override code property for consistency
|
||||||
@property
|
@property
|
||||||
def code_display(self):
|
def code_display(self):
|
||||||
return f"{self.building_name} - {self.code}"
|
return f"{self.building}-{self.code}"
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def capacity_display(self):
|
def capacity_display(self):
|
||||||
"""Retorna '∞' para aulas virtuales o capacidad ilimitada, o el número entero."""
|
"""Retorna '∞' para aulas virtuales o capacidad ilimitada, o el número entero."""
|
||||||
if self.capacity == 0 or self.is_virtual:
|
if self.capacity == 0 or (self.code and 'VIRTUAL' in self.code.upper()):
|
||||||
return '∞'
|
return '∞'
|
||||||
return str(self.capacity)
|
return str(self.capacity)
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def is_unlimited(self):
|
def is_unlimited(self):
|
||||||
return self.capacity == 0 or self.is_virtual
|
return self.capacity == 0 or (self.code and 'VIRTUAL' in self.code.upper())
|
||||||
|
|
||||||
def to_dict(self):
|
def to_dict(self):
|
||||||
"""Convert classroom to dictionary"""
|
"""Convert classroom to dictionary"""
|
||||||
return {
|
return {
|
||||||
'id': self.id,
|
'id': self.id,
|
||||||
'building_id': self.building_id,
|
'code': self.code_display,
|
||||||
'building': self.building_name,
|
'building': self.building,
|
||||||
'code': self.code,
|
|
||||||
'code_display': self.code_display,
|
|
||||||
'name': self.name,
|
'name': self.name,
|
||||||
'floor': self.floor,
|
'floor': self.floor,
|
||||||
'floor_display': self.floor_display,
|
|
||||||
'location_display': self.location_display,
|
|
||||||
'capacity': self.capacity,
|
'capacity': self.capacity,
|
||||||
'capacity_display': self.capacity_display,
|
|
||||||
'is_virtual': self.is_virtual,
|
|
||||||
'description': self.description,
|
'description': self.description,
|
||||||
'campus_location': self.campus_location,
|
'campus_location': self.campus_location,
|
||||||
'is_active': self.is_active,
|
'is_active': self.is_active,
|
||||||
@@ -125,9 +71,10 @@ class Classroom(db.Model):
|
|||||||
|
|
||||||
def get_full_location(self):
|
def get_full_location(self):
|
||||||
"""Get full classroom location"""
|
"""Get full classroom location"""
|
||||||
if self.is_virtual:
|
location = f"{self.building} - Floor {self.floor}"
|
||||||
return 'Campus Virtual (Remoto)'
|
if self.campus_location:
|
||||||
return f"{self.building_name} - {self.floor_display}"
|
location += f" ({self.campus_location})"
|
||||||
|
return location
|
||||||
|
|
||||||
@staticmethod
|
@staticmethod
|
||||||
def find_best_classroom(max_students, start_time, end_time, exclude_reservation_id=None):
|
def find_best_classroom(max_students, start_time, end_time, exclude_reservation_id=None):
|
||||||
@@ -45,37 +45,16 @@ class Individual:
|
|||||||
self.fitness = 0.0
|
self.fitness = 0.0
|
||||||
self.conflicts = []
|
self.conflicts = []
|
||||||
|
|
||||||
def calculate_fitness(self, classrooms: Dict[int, Classroom], reservation_requests: Dict[int, ReservationRequest]) -> float:
|
def calculate_fitness(self, classrooms: Dict[int, Classroom], requests: Dict[int, ReservationRequest]) -> float:
|
||||||
"""Calculate fitness score based on multiple factors with fast O(K log K) interval conflict detection"""
|
"""Calculate fitness score based on multiple factors"""
|
||||||
score = 0.0
|
score = 0.0
|
||||||
self.conflicts = []
|
self.conflicts = []
|
||||||
|
|
||||||
# Pre-group genes by classroom to calculate conflicts in O(K log K)
|
|
||||||
by_classroom = {}
|
|
||||||
for g in self.genes:
|
|
||||||
by_classroom.setdefault(g.classroom_id, []).append(g)
|
|
||||||
|
|
||||||
conflict_count_by_id = {}
|
|
||||||
for cid, room_genes in by_classroom.items():
|
|
||||||
if len(room_genes) <= 1:
|
|
||||||
continue
|
|
||||||
# Sort chronologically
|
|
||||||
room_genes.sort(key=lambda x: x.start_time)
|
|
||||||
for i in range(len(room_genes)):
|
|
||||||
g_i = room_genes[i]
|
|
||||||
for j in range(i + 1, len(room_genes)):
|
|
||||||
g_j = room_genes[j]
|
|
||||||
if g_i.end_time > g_j.start_time:
|
|
||||||
conflict_count_by_id[id(g_i)] = conflict_count_by_id.get(id(g_i), 0) + 1
|
|
||||||
conflict_count_by_id[id(g_j)] = conflict_count_by_id.get(id(g_j), 0) + 1
|
|
||||||
else:
|
|
||||||
break # Gene j and subsequent ones start later than gene i ends
|
|
||||||
|
|
||||||
for gene in self.genes:
|
for gene in self.genes:
|
||||||
classroom = classrooms.get(gene.classroom_id)
|
classroom = classrooms.get(gene.classroom_id)
|
||||||
res_req = reservation_requests.get(gene.commission_id)
|
request = requests.get(gene.commission_id)
|
||||||
|
|
||||||
if not classroom or not res_req:
|
if not classroom or not request:
|
||||||
continue
|
continue
|
||||||
|
|
||||||
# Factor 1: Capacity efficiency (40% weight)
|
# Factor 1: Capacity efficiency (40% weight)
|
||||||
@@ -83,24 +62,23 @@ class Individual:
|
|||||||
score += capacity_score * 0.4
|
score += capacity_score * 0.4
|
||||||
|
|
||||||
# Factor 2: Time preference satisfaction (30% weight)
|
# Factor 2: Time preference satisfaction (30% weight)
|
||||||
time_score = self._calculate_time_score(gene, res_req)
|
time_score = self._calculate_time_score(gene, request)
|
||||||
score += time_score * 0.3
|
score += time_score * 0.3
|
||||||
|
|
||||||
# Factor 3: Conflict penalty (20% weight)
|
# Factor 3: Conflict penalty (20% weight)
|
||||||
c_count = conflict_count_by_id.get(id(gene), 0)
|
conflict_score = self._calculate_conflict_penalty(gene, self.genes)
|
||||||
if c_count > 0:
|
score += conflict_score * 0.2
|
||||||
conflict_score = -c_count * 0.5
|
|
||||||
|
# Factor 4: Resource matching (10% weight)
|
||||||
|
resource_score = self._calculate_resource_score(classroom, request.subject_requirements)
|
||||||
|
score += resource_score * 0.1
|
||||||
|
|
||||||
|
# Store conflicts for debugging
|
||||||
|
if conflict_score < 0:
|
||||||
self.conflicts.append({
|
self.conflicts.append({
|
||||||
'gene': gene,
|
'gene': gene,
|
||||||
'conflict_type': 'time_overlap'
|
'conflict_type': 'time_overlap'
|
||||||
})
|
})
|
||||||
else:
|
|
||||||
conflict_score = 1.0
|
|
||||||
score += conflict_score * 0.2
|
|
||||||
|
|
||||||
# Factor 4: Resource matching (10% weight)
|
|
||||||
resource_score = self._calculate_resource_score(classroom, res_req.subject_requirements)
|
|
||||||
score += resource_score * 0.1
|
|
||||||
|
|
||||||
self.fitness = score
|
self.fitness = score
|
||||||
return score
|
return score
|
||||||
@@ -111,7 +89,7 @@ class Individual:
|
|||||||
return 0.0 # Overfilled classroom
|
return 0.0 # Overfilled classroom
|
||||||
|
|
||||||
# Calculate efficiency: closer capacity match = higher score
|
# Calculate efficiency: closer capacity match = higher score
|
||||||
waste_ratio = (classroom.capacity - expected_attendees) / max(1, expected_attendees)
|
waste_ratio = (classroom.capacity - expected_attendees) / expected_attendees
|
||||||
if waste_ratio <= 0.1: # Less than 10% waste
|
if waste_ratio <= 0.1: # Less than 10% waste
|
||||||
return 1.0
|
return 1.0
|
||||||
elif waste_ratio <= 0.3: # Less than 30% waste
|
elif waste_ratio <= 0.3: # Less than 30% waste
|
||||||
@@ -129,12 +107,12 @@ class Individual:
|
|||||||
if time_diff <= 0.5: # Within 30 minutes
|
if time_diff <= 0.5: # Within 30 minutes
|
||||||
return 1.0
|
return 1.0
|
||||||
elif time_diff <= request.flexibility_hours: # Within flexible window
|
elif time_diff <= request.flexibility_hours: # Within flexible window
|
||||||
return 0.8 - (time_diff / max(1, request.flexibility_hours)) * 0.3
|
return 0.8 - (time_diff / request.flexibility_hours) * 0.3
|
||||||
else:
|
else:
|
||||||
return max(0.0, 0.5 - (time_diff - request.flexibility_hours) * 0.1)
|
return max(0.0, 0.5 - (time_diff - request.flexibility_hours) * 0.1)
|
||||||
|
|
||||||
def _calculate_conflict_penalty(self, gene: Gene, all_genes: List[Gene]) -> float:
|
def _calculate_conflict_penalty(self, gene: Gene, all_genes: List[Gene]) -> float:
|
||||||
"""Check for time conflicts in the same classroom (kept for backward compatibility)"""
|
"""Check for time conflicts in the same classroom"""
|
||||||
conflicts = 0
|
conflicts = 0
|
||||||
for other in all_genes:
|
for other in all_genes:
|
||||||
if gene != other and gene.classroom_id == other.classroom_id:
|
if gene != other and gene.classroom_id == other.classroom_id:
|
||||||
@@ -149,6 +127,9 @@ class Individual:
|
|||||||
"""Check if classroom meets subject requirements"""
|
"""Check if classroom meets subject requirements"""
|
||||||
if not requirements:
|
if not requirements:
|
||||||
return 1.0
|
return 1.0
|
||||||
|
|
||||||
|
# This would need to be implemented based on actual classroom resources
|
||||||
|
# For now, return a default score
|
||||||
return 0.8
|
return 0.8
|
||||||
|
|
||||||
def _times_overlap(self, start1: datetime, end1: datetime, start2: datetime, end2: datetime) -> bool:
|
def _times_overlap(self, start1: datetime, end1: datetime, start2: datetime, end2: datetime) -> bool:
|
||||||
@@ -157,24 +138,19 @@ class Individual:
|
|||||||
|
|
||||||
|
|
||||||
class GeneticAlgorithm:
|
class GeneticAlgorithm:
|
||||||
"""Main genetic algorithm for room reservation optimization with concurrency and progress tracking"""
|
"""Main genetic algorithm for room reservation optimization"""
|
||||||
|
|
||||||
def __init__(self, population_size: int = 50, generations: int = 100,
|
def __init__(self, population_size: int = 50, generations: int = 100,
|
||||||
mutation_rate: float = 0.1, crossover_rate: float = 0.8,
|
mutation_rate: float = 0.1, crossover_rate: float = 0.8):
|
||||||
workers: int = 4):
|
|
||||||
self.population_size = population_size
|
self.population_size = population_size
|
||||||
self.generations = generations
|
self.generations = generations
|
||||||
self.mutation_rate = mutation_rate
|
self.mutation_rate = mutation_rate
|
||||||
self.crossover_rate = crossover_rate
|
self.crossover_rate = crossover_rate
|
||||||
self.workers = max(1, workers)
|
|
||||||
|
|
||||||
def optimize_reservations(self, requests: List[ReservationRequest],
|
def optimize_reservations(self, requests: List[ReservationRequest],
|
||||||
available_classrooms: List[Classroom],
|
available_classrooms: List[Classroom],
|
||||||
start_date: datetime, end_date: datetime,
|
start_date: datetime, end_date: datetime) -> Individual:
|
||||||
progress_callback=None) -> Individual:
|
"""Run genetic algorithm to find optimal reservation schedule"""
|
||||||
"""Run genetic algorithm with high concurrency to find optimal reservation schedule"""
|
|
||||||
import concurrent.futures
|
|
||||||
|
|
||||||
classrooms_dict = {c.id: c for c in available_classrooms}
|
classrooms_dict = {c.id: c for c in available_classrooms}
|
||||||
requests_dict = {r.commission_id: r for r in requests}
|
requests_dict = {r.commission_id: r for r in requests}
|
||||||
|
|
||||||
@@ -183,29 +159,18 @@ class GeneticAlgorithm:
|
|||||||
|
|
||||||
# Evolve population
|
# Evolve population
|
||||||
for generation in range(self.generations):
|
for generation in range(self.generations):
|
||||||
# Calculate fitness for all individuals concurrently when workers > 1
|
# Calculate fitness for all individuals
|
||||||
if self.workers > 1 and len(population) > 10:
|
|
||||||
with concurrent.futures.ThreadPoolExecutor(max_workers=self.workers) as executor:
|
|
||||||
futures = [executor.submit(ind.calculate_fitness, classrooms_dict, requests_dict) for ind in population]
|
|
||||||
concurrent.futures.wait(futures)
|
|
||||||
else:
|
|
||||||
for individual in population:
|
for individual in population:
|
||||||
individual.calculate_fitness(classrooms_dict, requests_dict)
|
individual.calculate_fitness(classrooms_dict, requests_dict)
|
||||||
|
|
||||||
# Sort by fitness (best first)
|
# Sort by fitness (best first)
|
||||||
population.sort(key=lambda x: x.fitness, reverse=True)
|
population.sort(key=lambda x: x.fitness, reverse=True)
|
||||||
|
|
||||||
# Report progress if callback is provided
|
|
||||||
if progress_callback:
|
|
||||||
pct = int(((generation + 1) / self.generations) * 100)
|
|
||||||
best_fit = population[0].fitness if population else 0.0
|
|
||||||
progress_callback(generation + 1, self.generations, pct, best_fit)
|
|
||||||
|
|
||||||
# Create new generation
|
# Create new generation
|
||||||
new_population = []
|
new_population = []
|
||||||
|
|
||||||
# Elitism: keep best 10%
|
# Elitism: keep best 10%
|
||||||
elite_size = max(2, int(self.population_size * 0.1))
|
elite_size = int(self.population_size * 0.1)
|
||||||
new_population.extend(population[:elite_size])
|
new_population.extend(population[:elite_size])
|
||||||
|
|
||||||
# Crossover and mutation for remaining
|
# Crossover and mutation for remaining
|
||||||
@@ -231,9 +196,7 @@ class GeneticAlgorithm:
|
|||||||
|
|
||||||
population = new_population[:self.population_size]
|
population = new_population[:self.population_size]
|
||||||
|
|
||||||
# Calculate fitness for final generation
|
# Return best individual from final generation
|
||||||
for individual in population:
|
|
||||||
individual.calculate_fitness(classrooms_dict, requests_dict)
|
|
||||||
population.sort(key=lambda x: x.fitness, reverse=True)
|
population.sort(key=lambda x: x.fitness, reverse=True)
|
||||||
return population[0]
|
return population[0]
|
||||||
|
|
||||||
@@ -321,14 +284,13 @@ class GeneticAlgorithm:
|
|||||||
class ReservationOptimizer:
|
class ReservationOptimizer:
|
||||||
"""High-level interface for the reservation optimization system"""
|
"""High-level interface for the reservation optimization system"""
|
||||||
|
|
||||||
def __init__(self, population_size: int = 50, generations: int = 100, workers: int = 4):
|
def __init__(self):
|
||||||
self.ga = GeneticAlgorithm(population_size=population_size, generations=generations, workers=workers)
|
self.ga = GeneticAlgorithm()
|
||||||
|
|
||||||
def optimize_schedule(self, commission_ids: List[int],
|
def optimize_schedule(self, commission_ids: List[int],
|
||||||
admin_user_id: int,
|
admin_user_id: int,
|
||||||
start_date: datetime = None,
|
start_date: datetime = None,
|
||||||
end_date: datetime = None,
|
end_date: datetime = None) -> Dict:
|
||||||
progress_callback = None) -> Dict:
|
|
||||||
"""Optimize reservation schedule for given commissions"""
|
"""Optimize reservation schedule for given commissions"""
|
||||||
|
|
||||||
# Default date range if not provided
|
# Default date range if not provided
|
||||||
@@ -363,7 +325,7 @@ class ReservationOptimizer:
|
|||||||
classrooms = Classroom.query.filter_by(is_active=True).all()
|
classrooms = Classroom.query.filter_by(is_active=True).all()
|
||||||
|
|
||||||
# Run genetic algorithm
|
# Run genetic algorithm
|
||||||
best_individual = self.ga.optimize_reservations(requests, classrooms, start_date, end_date, progress_callback=progress_callback)
|
best_individual = self.ga.optimize_reservations(requests, classrooms, start_date, end_date)
|
||||||
|
|
||||||
# Convert to reservation format
|
# Convert to reservation format
|
||||||
optimized_reservations = []
|
optimized_reservations = []
|
||||||
@@ -390,61 +352,28 @@ class ReservationOptimizer:
|
|||||||
}
|
}
|
||||||
|
|
||||||
def _calculate_preferred_time(self, commission: Commission) -> Dict:
|
def _calculate_preferred_time(self, commission: Commission) -> Dict:
|
||||||
"""Calculate preferred time slots for a commission based on shift and schedule"""
|
"""Calculate preferred time slots for a commission"""
|
||||||
|
# This is a simplified version - would need to be based on actual semester schedule
|
||||||
current_date = datetime.utcnow()
|
current_date = datetime.utcnow()
|
||||||
|
|
||||||
# Determine day of week from commission schedule or default to Monday
|
# Default to weekday mornings for regular classes
|
||||||
target_weekday = 0 # Monday
|
days_ahead = (0 - current_date.weekday()) % 7 # Next Monday
|
||||||
sched = (commission.schedule or '').lower()
|
if days_ahead == 0: # If today is Monday, use next week
|
||||||
if 'martes' in sched:
|
|
||||||
target_weekday = 1
|
|
||||||
elif 'miercoles' in sched or 'miércoles' in sched:
|
|
||||||
target_weekday = 2
|
|
||||||
elif 'jueves' in sched:
|
|
||||||
target_weekday = 3
|
|
||||||
elif 'viernes' in sched:
|
|
||||||
target_weekday = 4
|
|
||||||
elif 'sabado' in sched or 'sábado' in sched:
|
|
||||||
target_weekday = 5
|
|
||||||
|
|
||||||
days_ahead = (target_weekday - current_date.weekday()) % 7
|
|
||||||
if days_ahead == 0:
|
|
||||||
days_ahead = 7
|
days_ahead = 7
|
||||||
|
|
||||||
preferred_date = current_date + timedelta(days=days_ahead)
|
preferred_date = current_date + timedelta(days=days_ahead)
|
||||||
|
|
||||||
# Determine hours based on shift
|
|
||||||
shift = (commission.shift or '').strip().lower()
|
|
||||||
if 'mañana' in shift or 'manana' in shift:
|
|
||||||
start_h, start_m = 8, 0
|
|
||||||
end_h, end_m = 12, 0
|
|
||||||
elif 'tarde' in shift:
|
|
||||||
start_h, start_m = 14, 0
|
|
||||||
end_h, end_m = 18, 0
|
|
||||||
elif 'noche' in shift or 'vespertino' in shift:
|
|
||||||
start_h, start_m = 18, 30
|
|
||||||
end_h, end_m = 22, 30
|
|
||||||
else:
|
|
||||||
start_h, start_m = 9, 0
|
|
||||||
end_h, end_m = 13, 0
|
|
||||||
|
|
||||||
return {
|
return {
|
||||||
'start': preferred_date.replace(hour=start_h, minute=start_m, second=0, microsecond=0),
|
'start': preferred_date.replace(hour=9, minute=0, second=0, microsecond=0),
|
||||||
'end': preferred_date.replace(hour=end_h, minute=end_m, second=0, microsecond=0)
|
'end': preferred_date.replace(hour=11, minute=0, second=0, microsecond=0)
|
||||||
}
|
}
|
||||||
|
|
||||||
def apply_optimized_reservations(self, reservation_data: List[Dict]) -> List[Reservation]:
|
def apply_optimized_reservations(self, reservation_data: List[Dict]) -> List[Reservation]:
|
||||||
"""Apply the optimized reservations to the database with ISO string parsing and conflict avoidance"""
|
"""Apply the optimized reservations to the database"""
|
||||||
applied_reservations = []
|
applied_reservations = []
|
||||||
|
|
||||||
for item in reservation_data:
|
for data in reservation_data:
|
||||||
data = dict(item)
|
# Check for conflicts before creating
|
||||||
if isinstance(data.get('start_time'), str):
|
|
||||||
data['start_time'] = datetime.fromisoformat(data['start_time'].replace('Z', '+00:00'))
|
|
||||||
if isinstance(data.get('end_time'), str):
|
|
||||||
data['end_time'] = datetime.fromisoformat(data['end_time'].replace('Z', '+00:00'))
|
|
||||||
|
|
||||||
# Check for physical room conflicts before creating
|
|
||||||
conflicts = Reservation.find_conflicts(
|
conflicts = Reservation.find_conflicts(
|
||||||
data['classroom_id'],
|
data['classroom_id'],
|
||||||
data['start_time'],
|
data['start_time'],
|
||||||
@@ -452,17 +381,12 @@ class ReservationOptimizer:
|
|||||||
)
|
)
|
||||||
|
|
||||||
if not conflicts:
|
if not conflicts:
|
||||||
# Ensure status enum value compatibility
|
|
||||||
if 'status' in data and isinstance(data['status'], str):
|
|
||||||
try:
|
|
||||||
data['status'] = ReservationStatus(data['status']).value
|
|
||||||
except ValueError:
|
|
||||||
data['status'] = ReservationStatus.CONFIRMED.value
|
|
||||||
reservation = Reservation(**data)
|
reservation = Reservation(**data)
|
||||||
db.session.add(reservation)
|
db.session.add(reservation)
|
||||||
applied_reservations.append(reservation)
|
applied_reservations.append(reservation)
|
||||||
else:
|
else:
|
||||||
current_app.logger.warning(f"Conflict detected for reservation during genetic apply: {data}")
|
# Log conflict - could be handled differently
|
||||||
|
print(f"Conflict detected for reservation data: {data}")
|
||||||
|
|
||||||
try:
|
try:
|
||||||
db.session.commit()
|
db.session.commit()
|
||||||
@@ -47,15 +47,11 @@ class Reservation(db.Model):
|
|||||||
status = db.Column(StatusType, default='PENDING', nullable=False) # Maps to VARCHAR(20) with StatusString
|
status = db.Column(StatusType, default='PENDING', nullable=False) # Maps to VARCHAR(20) with StatusString
|
||||||
expected_attendees = db.Column(db.Integer, nullable=False)
|
expected_attendees = db.Column(db.Integer, nullable=False)
|
||||||
shift = db.Column(db.String(30), nullable=True) # Mañana, Tarde, Vespertino, Noche
|
shift = db.Column(db.String(30), nullable=True) # Mañana, Tarde, Vespertino, Noche
|
||||||
virtual_link = db.Column(db.String(500), nullable=True) # Zoom, Meet, Teams, etc.
|
|
||||||
notes = db.Column(db.Text)
|
notes = db.Column(db.Text)
|
||||||
|
|
||||||
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):
|
||||||
@@ -86,24 +82,6 @@ class Reservation(db.Model):
|
|||||||
return self.classroom.code
|
return self.classroom.code
|
||||||
return ''
|
return ''
|
||||||
|
|
||||||
@property
|
|
||||||
def effective_virtual_link(self):
|
|
||||||
"""Devuelve el enlace explícito de la reserva o hereda el de la comisión"""
|
|
||||||
if self.virtual_link and self.virtual_link.strip():
|
|
||||||
return self.virtual_link.strip()
|
|
||||||
if self.commission and self.commission.virtual_link:
|
|
||||||
return self.commission.virtual_link.strip()
|
|
||||||
return None
|
|
||||||
|
|
||||||
@property
|
|
||||||
def is_virtual(self):
|
|
||||||
"""Verifica si la reserva es virtual por aula o por contar con enlace virtual"""
|
|
||||||
if self.classroom:
|
|
||||||
return bool(self.classroom.is_virtual)
|
|
||||||
if self.effective_virtual_link:
|
|
||||||
return True
|
|
||||||
return False
|
|
||||||
|
|
||||||
# Relationships
|
# Relationships
|
||||||
classroom = db.relationship('Classroom', backref=db.backref('reservation_list', lazy=True, cascade='all, delete-orphan'))
|
classroom = db.relationship('Classroom', backref=db.backref('reservation_list', lazy=True, cascade='all, delete-orphan'))
|
||||||
commission = db.relationship('Commission', backref=db.backref('reservation_list', lazy=True, cascade='all, delete-orphan'))
|
commission = db.relationship('Commission', backref=db.backref('reservation_list', lazy=True, cascade='all, delete-orphan'))
|
||||||
@@ -122,8 +100,6 @@ class Reservation(db.Model):
|
|||||||
'status': self.status, # Already a string in DB
|
'status': self.status, # Already a string in DB
|
||||||
'expected_attendees': self.expected_attendees,
|
'expected_attendees': self.expected_attendees,
|
||||||
'notes': self.notes,
|
'notes': self.notes,
|
||||||
'virtual_link': self.effective_virtual_link,
|
|
||||||
'is_virtual': self.is_virtual,
|
|
||||||
'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,
|
||||||
'classroom': self.classroom.to_dict() if self.classroom else None,
|
'classroom': self.classroom.to_dict() if self.classroom else None,
|
||||||
@@ -22,7 +22,7 @@ SYSTEM_MODULES = [
|
|||||||
'name': 'Reservas de Aulas',
|
'name': 'Reservas de Aulas',
|
||||||
'name_en': 'Classroom Reservations',
|
'name_en': 'Classroom Reservations',
|
||||||
'icon': 'bi-calendar-check',
|
'icon': 'bi-calendar-check',
|
||||||
'description': 'Creación, modificación, aprobación, confirmación y cancelación de reservas.'
|
'description': 'Creación, aprobación, confirmación y cancelación de reservas.'
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
'id': 'schedule',
|
'id': 'schedule',
|
||||||
@@ -58,27 +58,6 @@ SYSTEM_MODULES = [
|
|||||||
'name_en': 'Users & Access RBAC',
|
'name_en': 'Users & Access RBAC',
|
||||||
'icon': 'bi-shield-lock',
|
'icon': 'bi-shield-lock',
|
||||||
'description': 'Administración de cuentas, roles y matriz granular de permisos.'
|
'description': 'Administración de cuentas, roles y matriz granular de permisos.'
|
||||||
},
|
|
||||||
{
|
|
||||||
'id': 'milestone_types',
|
|
||||||
'name': 'Tipificaciones de Hitos',
|
|
||||||
'name_en': 'Milestone Types',
|
|
||||||
'icon': 'bi-tags',
|
|
||||||
'description': 'Catálogo dinámico de tipos de evaluaciones, parciales, TPs y eventos.'
|
|
||||||
},
|
|
||||||
{
|
|
||||||
'id': 'metrics',
|
|
||||||
'name': 'Métricas de Ocupación',
|
|
||||||
'name_en': 'Occupancy Metrics',
|
|
||||||
'icon': 'bi-graph-up',
|
|
||||||
'description': 'Visualización y análisis de porcentajes de ocupación por aula (día, semana y mes).'
|
|
||||||
},
|
|
||||||
{
|
|
||||||
'id': 'enrollment',
|
|
||||||
'name': 'Inscripciones y Cursadas',
|
|
||||||
'name_en': 'Enrollments & Courses',
|
|
||||||
'icon': 'bi-diagram-3',
|
|
||||||
'description': 'Gestión de inscripciones de alumnos a comisiones y asignación de docentes.'
|
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
|
||||||
@@ -97,9 +76,6 @@ 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:
|
||||||
@@ -0,0 +1,101 @@
|
|||||||
|
from app import db
|
||||||
|
from datetime import datetime
|
||||||
|
|
||||||
|
class Subject(db.Model):
|
||||||
|
__tablename__ = 'subjects'
|
||||||
|
|
||||||
|
id = db.Column(db.Integer, primary_key=True)
|
||||||
|
code = db.Column(db.String(50), unique=True, nullable=False, index=True)
|
||||||
|
name = db.Column(db.String(200), nullable=False)
|
||||||
|
description = db.Column(db.Text)
|
||||||
|
department = db.Column(db.String(100), nullable=False, default='')
|
||||||
|
credits = db.Column(db.Integer, nullable=False, default=4)
|
||||||
|
career_id = db.Column(db.Integer, db.ForeignKey('careers.id', ondelete='SET NULL'), nullable=True)
|
||||||
|
is_active = db.Column('active', db.Boolean, default=True, nullable=False) # Maps to active column in DB
|
||||||
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
|
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
||||||
|
|
||||||
|
# Relationships
|
||||||
|
commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan')
|
||||||
|
|
||||||
|
def to_dict(self):
|
||||||
|
"""Convert subject to dictionary"""
|
||||||
|
return {
|
||||||
|
'id': self.id,
|
||||||
|
'code': self.code,
|
||||||
|
'name': self.name,
|
||||||
|
'description': self.description,
|
||||||
|
'department': self.department,
|
||||||
|
'credits': self.credits,
|
||||||
|
'career_id': self.career_id,
|
||||||
|
'career_name': self.career_obj.name if self.career_obj else None,
|
||||||
|
'is_active': self.is_active,
|
||||||
|
'created_at': self.created_at.isoformat() if self.created_at else None,
|
||||||
|
'updated_at': self.updated_at.isoformat() if self.updated_at else None
|
||||||
|
}
|
||||||
|
|
||||||
|
def __repr__(self):
|
||||||
|
return f'<Subject {self.code}>'
|
||||||
|
|
||||||
|
class Commission(db.Model):
|
||||||
|
__tablename__ = 'commissions'
|
||||||
|
|
||||||
|
id = db.Column(db.Integer, primary_key=True)
|
||||||
|
subject_id = db.Column(db.Integer, db.ForeignKey('subjects.id'), nullable=False)
|
||||||
|
code = db.Column(db.String(50), nullable=False)
|
||||||
|
semester = db.Column(db.String(20), nullable=False)
|
||||||
|
year = db.Column(db.Integer, nullable=False)
|
||||||
|
teacher_id = db.Column(db.Integer, db.ForeignKey('users.id'))
|
||||||
|
max_students = db.Column(db.Integer, nullable=False)
|
||||||
|
current_students = db.Column(db.Integer, default=0)
|
||||||
|
schedule = db.Column(db.String(255))
|
||||||
|
shift = db.Column(db.String(30), nullable=True) # Mañana, Tarde, Vespertino, Noche
|
||||||
|
active = db.Column(db.Boolean, default=True) # Changed from is_active to active
|
||||||
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
|
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
||||||
|
|
||||||
|
# Virtual property for compatibility
|
||||||
|
@property
|
||||||
|
def is_active(self):
|
||||||
|
return self.active
|
||||||
|
|
||||||
|
@is_active.setter
|
||||||
|
def is_active(self, value):
|
||||||
|
self.active = value
|
||||||
|
|
||||||
|
# Relationships
|
||||||
|
pass # Reservation already defines the relationship back to commission
|
||||||
|
teacher = db.relationship('User', backref='teaching_commissions', foreign_keys=[teacher_id])
|
||||||
|
|
||||||
|
# Virtual field for teacher_name
|
||||||
|
@property
|
||||||
|
def teacher_name(self):
|
||||||
|
return f"{self.teacher.first_name} {self.teacher.last_name}" if self.teacher else "TBD"
|
||||||
|
|
||||||
|
# Unique constraint
|
||||||
|
__table_args__ = (db.UniqueConstraint('subject_id', 'code', 'semester', 'year'),)
|
||||||
|
|
||||||
|
def to_dict(self):
|
||||||
|
"""Convert commission to dictionary"""
|
||||||
|
return {
|
||||||
|
'id': self.id,
|
||||||
|
'subject_id': self.subject_id,
|
||||||
|
'code': self.code,
|
||||||
|
'semester': self.semester,
|
||||||
|
'year': self.year,
|
||||||
|
'teacher_name': self.teacher_name,
|
||||||
|
'max_students': self.max_students,
|
||||||
|
'current_students': self.current_students,
|
||||||
|
'schedule': self.schedule,
|
||||||
|
'active': self.active,
|
||||||
|
'created_at': self.created_at.isoformat() if self.created_at else None,
|
||||||
|
'updated_at': self.updated_at.isoformat() if self.updated_at else None,
|
||||||
|
'subject': self.subject.to_dict() if self.subject else None
|
||||||
|
}
|
||||||
|
|
||||||
|
def get_full_code(self):
|
||||||
|
"""Get full commission code"""
|
||||||
|
return f"{self.subject.code if self.subject else 'N/A'}-{self.code}-{self.semester.upper()}{self.year if self.year else ''}"
|
||||||
|
|
||||||
|
def __repr__(self):
|
||||||
|
return f'<Commission {self.get_full_code()}>'
|
||||||
@@ -0,0 +1,86 @@
|
|||||||
|
from app import db, login_manager
|
||||||
|
from flask_login import UserMixin
|
||||||
|
from werkzeug.security import generate_password_hash, check_password_hash
|
||||||
|
from datetime import datetime
|
||||||
|
|
||||||
|
class User(UserMixin, db.Model):
|
||||||
|
__tablename__ = 'users'
|
||||||
|
|
||||||
|
id = db.Column(db.Integer, primary_key=True)
|
||||||
|
email = db.Column(db.String(255), unique=True, nullable=False, index=True)
|
||||||
|
password_hash = db.Column(db.String(255), nullable=False)
|
||||||
|
name = db.Column(db.String(100), nullable=False)
|
||||||
|
role = db.Column(db.String(50), nullable=False)
|
||||||
|
is_active = db.Column(db.Boolean, default=True, nullable=False)
|
||||||
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
|
last_login = db.Column(db.DateTime)
|
||||||
|
preferred_language = db.Column(db.String(10), default=None, nullable=True)
|
||||||
|
theme_preference = db.Column(db.String(10), default='auto', nullable=False)
|
||||||
|
role_id = db.Column(db.Integer, db.ForeignKey('roles.id', ondelete='SET NULL'), nullable=True)
|
||||||
|
|
||||||
|
# Virtual fields for future compatibility
|
||||||
|
@property
|
||||||
|
def first_name(self):
|
||||||
|
return self.name.split()[0] if self.name else ''
|
||||||
|
|
||||||
|
@property
|
||||||
|
def last_name(self):
|
||||||
|
parts = self.name.split()
|
||||||
|
return ' '.join(parts[1:]) if len(parts) > 1 else ''
|
||||||
|
|
||||||
|
# Relationships
|
||||||
|
reservations = db.relationship('Reservation', backref='user', lazy=True, cascade='all, delete-orphan')
|
||||||
|
|
||||||
|
def set_password(self, password):
|
||||||
|
"""Set password hash"""
|
||||||
|
self.password_hash = generate_password_hash(password, method='pbkdf2:sha256')
|
||||||
|
|
||||||
|
def check_password(self, password):
|
||||||
|
"""Check password"""
|
||||||
|
return check_password_hash(self.password_hash, password)
|
||||||
|
|
||||||
|
def is_admin(self):
|
||||||
|
"""Check if user is admin"""
|
||||||
|
if self.role_obj and self.role_obj.name.lower() in ['admin', 'administrador']:
|
||||||
|
return True
|
||||||
|
return str(self.role).upper() in ['ADMIN', 'ADMINISTRADOR']
|
||||||
|
|
||||||
|
def has_permission(self, module, min_level='read'):
|
||||||
|
"""Check if user has granular permission on a given module"""
|
||||||
|
if self.is_admin():
|
||||||
|
return True
|
||||||
|
if self.role_obj:
|
||||||
|
return self.role_obj.has_permission(module, min_level)
|
||||||
|
return False
|
||||||
|
|
||||||
|
def can_manage(self):
|
||||||
|
"""Check if user can access the Management / Admin section"""
|
||||||
|
return self.is_admin() or self.has_permission('users', 'read')
|
||||||
|
|
||||||
|
|
||||||
|
def update_last_login(self):
|
||||||
|
"""Update last login timestamp"""
|
||||||
|
self.last_login = datetime.utcnow()
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
def to_dict(self):
|
||||||
|
"""Convert user to dictionary"""
|
||||||
|
return {
|
||||||
|
'id': self.id,
|
||||||
|
'email': self.email,
|
||||||
|
'name': self.name,
|
||||||
|
'role': self.role,
|
||||||
|
'is_active': self.is_active,
|
||||||
|
'created_at': self.created_at.isoformat() if self.created_at else None,
|
||||||
|
'last_login': self.last_login.isoformat() if self.last_login else None,
|
||||||
|
'preferred_language': self.preferred_language,
|
||||||
|
'theme_preference': self.theme_preference
|
||||||
|
}
|
||||||
|
|
||||||
|
def __repr__(self):
|
||||||
|
return f'<User {self.email}>'
|
||||||
|
|
||||||
|
@login_manager.user_loader
|
||||||
|
def load_user(user_id):
|
||||||
|
"""Load user from database by ID"""
|
||||||
|
return User.query.get(int(user_id))
|
||||||
|
Before Width: | Height: | Size: 2.5 KiB After Width: | Height: | Size: 2.5 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
|
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |
|
Before Width: | Height: | Size: 7.9 KiB After Width: | Height: | Size: 7.9 KiB |
|
Before Width: | Height: | Size: 13 KiB After Width: | Height: | Size: 13 KiB |
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 2.4 KiB After Width: | Height: | Size: 2.4 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 42 KiB |
|
Before Width: | Height: | Size: 4.0 KiB After Width: | Height: | Size: 4.0 KiB |
|
Before Width: | Height: | Size: 5.7 KiB After Width: | Height: | Size: 5.7 KiB |
|
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
@@ -5,6 +5,5 @@ from .buildings import buildings_bp
|
|||||||
from .schedule import schedule_bp
|
from .schedule import schedule_bp
|
||||||
from .genetic_algorithm import genetic_bp, genetic_web_bp
|
from .genetic_algorithm import genetic_bp, genetic_web_bp
|
||||||
from .admin import admin_bp
|
from .admin import admin_bp
|
||||||
from .my_subjects import my_subjects_bp
|
|
||||||
|
|
||||||
__all__ = ['main_bp', 'auth_bp', 'classrooms_bp', 'buildings_bp', 'schedule_bp', 'genetic_bp', 'genetic_web_bp', 'admin_bp', 'my_subjects_bp']
|
__all__ = ['main_bp', 'auth_bp', 'classrooms_bp', 'buildings_bp', 'schedule_bp', 'genetic_bp', 'genetic_web_bp', 'admin_bp']
|
||||||
@@ -0,0 +1,342 @@
|
|||||||
|
from flask import Blueprint, render_template, request, redirect, url_for, flash, jsonify, abort
|
||||||
|
from flask_login import login_required, current_user
|
||||||
|
from flask_babel import gettext as _
|
||||||
|
from app import db
|
||||||
|
from app.models.user import User
|
||||||
|
from app.models.role import Role, Permission, SYSTEM_MODULES, ACCESS_LEVELS
|
||||||
|
from app.utils.decorators import admin_required, permission_required
|
||||||
|
from sqlalchemy import or_
|
||||||
|
|
||||||
|
admin_bp = Blueprint('admin', __name__, url_prefix='/admin')
|
||||||
|
|
||||||
|
# ---------------------------------------------------------
|
||||||
|
# USERS MANAGEMENT
|
||||||
|
# ---------------------------------------------------------
|
||||||
|
|
||||||
|
@admin_bp.route('/users')
|
||||||
|
@admin_required
|
||||||
|
def users_list():
|
||||||
|
"""List system users with filtering and role information"""
|
||||||
|
search = request.args.get('search', '').strip()
|
||||||
|
role_filter = request.args.get('role', '').strip()
|
||||||
|
status_filter = request.args.get('status', '').strip()
|
||||||
|
page = request.args.get('page', 1, type=int)
|
||||||
|
per_page = 15
|
||||||
|
|
||||||
|
query = User.query
|
||||||
|
|
||||||
|
if search:
|
||||||
|
query = query.filter(
|
||||||
|
or_(
|
||||||
|
User.name.ilike(f'%{search}%'),
|
||||||
|
User.email.ilike(f'%{search}%')
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
if role_filter:
|
||||||
|
if role_filter.isdigit():
|
||||||
|
query = query.filter(User.role_id == int(role_filter))
|
||||||
|
else:
|
||||||
|
query = query.filter(User.role.ilike(role_filter))
|
||||||
|
|
||||||
|
if status_filter in ['active', 'inactive']:
|
||||||
|
query = query.filter(User.is_active == (status_filter == 'active'))
|
||||||
|
|
||||||
|
pagination = query.order_by(User.id.asc()).paginate(page=page, per_page=per_page, error_out=False)
|
||||||
|
roles = Role.query.order_by(Role.name.asc()).all()
|
||||||
|
|
||||||
|
return render_template(
|
||||||
|
'admin/users/list.html',
|
||||||
|
users=pagination.items,
|
||||||
|
pagination=pagination,
|
||||||
|
roles=roles,
|
||||||
|
search=search,
|
||||||
|
role_filter=role_filter,
|
||||||
|
status_filter=status_filter
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@admin_bp.route('/users/add', methods=['GET', 'POST'])
|
||||||
|
@admin_required
|
||||||
|
def user_add():
|
||||||
|
"""Create a new user and assign a role"""
|
||||||
|
roles = Role.query.order_by(Role.name.asc()).all()
|
||||||
|
|
||||||
|
if request.method == 'POST':
|
||||||
|
name = request.form.get('name', '').strip()
|
||||||
|
email = request.form.get('email', '').strip().lower()
|
||||||
|
password = request.form.get('password', '')
|
||||||
|
role_id = request.form.get('role_id', type=int)
|
||||||
|
is_active = request.form.get('is_active') == 'on'
|
||||||
|
|
||||||
|
errors = []
|
||||||
|
if not name:
|
||||||
|
errors.append(_('El nombre es requerido.'))
|
||||||
|
if not email:
|
||||||
|
errors.append(_('El correo electrónico es requerido.'))
|
||||||
|
elif User.query.filter_by(email=email).first():
|
||||||
|
errors.append(_('Ya existe una cuenta con este correo electrónico.'))
|
||||||
|
if not password or len(password) < 6:
|
||||||
|
errors.append(_('La contraseña debe tener al menos 6 caracteres.'))
|
||||||
|
|
||||||
|
role_obj = Role.query.get(role_id) if role_id else None
|
||||||
|
if not role_obj:
|
||||||
|
errors.append(_('Debes seleccionar un rol válido.'))
|
||||||
|
|
||||||
|
if errors:
|
||||||
|
for err in errors:
|
||||||
|
flash(err, 'error')
|
||||||
|
return render_template('admin/users/form.html', user=None, roles=roles)
|
||||||
|
|
||||||
|
user = User(
|
||||||
|
name=name,
|
||||||
|
email=email,
|
||||||
|
role_id=role_obj.id,
|
||||||
|
role=role_obj.name,
|
||||||
|
is_active=is_active
|
||||||
|
)
|
||||||
|
user.set_password(password)
|
||||||
|
db.session.add(user)
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
flash(_('Usuario "%(name)s" creado exitosamente.', name=user.name), 'success')
|
||||||
|
return redirect(url_for('admin.users_list'))
|
||||||
|
|
||||||
|
return render_template('admin/users/form.html', user=None, roles=roles)
|
||||||
|
|
||||||
|
|
||||||
|
@admin_bp.route('/users/edit/<int:id>', methods=['GET', 'POST'])
|
||||||
|
@admin_required
|
||||||
|
def user_edit(id):
|
||||||
|
"""Edit user details, role and status"""
|
||||||
|
user = User.query.get_or_404(id)
|
||||||
|
roles = Role.query.order_by(Role.name.asc()).all()
|
||||||
|
|
||||||
|
if request.method == 'POST':
|
||||||
|
name = request.form.get('name', '').strip()
|
||||||
|
email = request.form.get('email', '').strip().lower()
|
||||||
|
password = request.form.get('password', '')
|
||||||
|
role_id = request.form.get('role_id', type=int)
|
||||||
|
is_active = request.form.get('is_active') == 'on'
|
||||||
|
|
||||||
|
errors = []
|
||||||
|
if not name:
|
||||||
|
errors.append(_('El nombre es requerido.'))
|
||||||
|
if not email:
|
||||||
|
errors.append(_('El correo electrónico es requerido.'))
|
||||||
|
else:
|
||||||
|
existing = User.query.filter_by(email=email).first()
|
||||||
|
if existing and existing.id != user.id:
|
||||||
|
errors.append(_('Ya existe otra cuenta con este correo electrónico.'))
|
||||||
|
|
||||||
|
role_obj = Role.query.get(role_id) if role_id else None
|
||||||
|
if not role_obj:
|
||||||
|
errors.append(_('Debes seleccionar un rol válido.'))
|
||||||
|
|
||||||
|
# Do not allow deactivating the currently logged in admin user
|
||||||
|
if user.id == current_user.id and not is_active:
|
||||||
|
errors.append(_('No puedes desactivar tu propia cuenta mientras estás en sesión.'))
|
||||||
|
|
||||||
|
if errors:
|
||||||
|
for err in errors:
|
||||||
|
flash(err, 'error')
|
||||||
|
return render_template('admin/users/form.html', user=user, roles=roles)
|
||||||
|
|
||||||
|
user.name = name
|
||||||
|
user.email = email
|
||||||
|
user.role_id = role_obj.id
|
||||||
|
user.role = role_obj.name
|
||||||
|
user.is_active = is_active
|
||||||
|
|
||||||
|
if password:
|
||||||
|
if len(password) < 6:
|
||||||
|
flash(_('La nueva contraseña debe tener al menos 6 caracteres.'), 'error')
|
||||||
|
return render_template('admin/users/form.html', user=user, roles=roles)
|
||||||
|
user.set_password(password)
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
flash(_('Usuario "%(name)s" actualizado correctamente.', name=user.name), 'success')
|
||||||
|
return redirect(url_for('admin.users_list'))
|
||||||
|
|
||||||
|
return render_template('admin/users/form.html', user=user, roles=roles)
|
||||||
|
|
||||||
|
|
||||||
|
@admin_bp.route('/users/toggle/<int:id>', methods=['POST'])
|
||||||
|
@admin_required
|
||||||
|
def user_toggle(id):
|
||||||
|
"""Toggle user active status"""
|
||||||
|
user = User.query.get_or_404(id)
|
||||||
|
if user.id == current_user.id:
|
||||||
|
flash(_('No puedes desactivar tu propia cuenta.'), 'error')
|
||||||
|
return redirect(url_for('admin.users_list'))
|
||||||
|
|
||||||
|
user.is_active = not user.is_active
|
||||||
|
db.session.commit()
|
||||||
|
status_str = _('activada') if user.is_active else _('desactivada')
|
||||||
|
flash(_('La cuenta de %(name)s ha sido %(status)s.', name=user.name, status=status_str), 'success')
|
||||||
|
return redirect(url_for('admin.users_list'))
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------
|
||||||
|
# ROLES & PERMISSIONS MANAGEMENT (FortiGate Matrix)
|
||||||
|
# ---------------------------------------------------------
|
||||||
|
|
||||||
|
@admin_bp.route('/roles')
|
||||||
|
@admin_required
|
||||||
|
def roles_list():
|
||||||
|
"""List all roles and permission summaries"""
|
||||||
|
roles = Role.query.order_by(Role.id.asc()).all()
|
||||||
|
return render_template(
|
||||||
|
'admin/roles/list.html',
|
||||||
|
roles=roles,
|
||||||
|
modules=SYSTEM_MODULES
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@admin_bp.route('/roles/add', methods=['GET', 'POST'])
|
||||||
|
@admin_required
|
||||||
|
def role_add():
|
||||||
|
"""Create a new role with the FortiGate permission matrix"""
|
||||||
|
if request.method == 'POST':
|
||||||
|
name = request.form.get('name', '').strip()
|
||||||
|
description = request.form.get('description', '').strip()
|
||||||
|
|
||||||
|
if not name:
|
||||||
|
flash(_('El nombre del rol es requerido.'), 'error')
|
||||||
|
return render_template('admin/roles/edit.html', role=None, modules=SYSTEM_MODULES, current_perms={})
|
||||||
|
|
||||||
|
if Role.query.filter_by(name=name).first():
|
||||||
|
flash(_('Ya existe un rol con ese nombre.'), 'error')
|
||||||
|
return render_template('admin/roles/edit.html', role=None, modules=SYSTEM_MODULES, current_perms={})
|
||||||
|
|
||||||
|
new_role = Role(name=name, description=description, is_system=False)
|
||||||
|
db.session.add(new_role)
|
||||||
|
db.session.flush() # to obtain new_role.id
|
||||||
|
|
||||||
|
# Save permissions from matrix
|
||||||
|
for mod in SYSTEM_MODULES:
|
||||||
|
mod_id = mod['id']
|
||||||
|
level = request.form.get(f'perm_{mod_id}', 'none')
|
||||||
|
if level not in ACCESS_LEVELS:
|
||||||
|
level = 'none'
|
||||||
|
new_role.set_permission(mod_id, level)
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
flash(_('Rol "%(name)s" creado exitosamente con sus permisos.', name=new_role.name), 'success')
|
||||||
|
return redirect(url_for('admin.roles_list'))
|
||||||
|
|
||||||
|
return render_template('admin/roles/edit.html', role=None, modules=SYSTEM_MODULES, current_perms={})
|
||||||
|
|
||||||
|
|
||||||
|
@admin_bp.route('/roles/edit/<int:id>', methods=['GET', 'POST'])
|
||||||
|
@admin_required
|
||||||
|
def role_edit(id):
|
||||||
|
"""Edit an existing role and its FortiGate permission matrix"""
|
||||||
|
role = Role.query.get_or_404(id)
|
||||||
|
|
||||||
|
if request.method == 'POST':
|
||||||
|
name = request.form.get('name', '').strip()
|
||||||
|
description = request.form.get('description', '').strip()
|
||||||
|
|
||||||
|
if not name:
|
||||||
|
flash(_('El nombre del rol es requerido.'), 'error')
|
||||||
|
return render_template('admin/roles/edit.html', role=role, modules=SYSTEM_MODULES, current_perms={p.module: p.access_level for p in role.permissions})
|
||||||
|
|
||||||
|
existing = Role.query.filter_by(name=name).first()
|
||||||
|
if existing and existing.id != role.id:
|
||||||
|
flash(_('Ya existe otro rol con ese nombre.'), 'error')
|
||||||
|
return render_template('admin/roles/edit.html', role=role, modules=SYSTEM_MODULES, current_perms={p.module: p.access_level for p in role.permissions})
|
||||||
|
|
||||||
|
# If it's a system role, keep name unchanged or protected
|
||||||
|
if not role.is_system:
|
||||||
|
role.name = name
|
||||||
|
role.description = description
|
||||||
|
|
||||||
|
# Update permissions from the FortiGate matrix
|
||||||
|
for mod in SYSTEM_MODULES:
|
||||||
|
mod_id = mod['id']
|
||||||
|
level = request.form.get(f'perm_{mod_id}', 'none')
|
||||||
|
if level not in ACCESS_LEVELS:
|
||||||
|
level = 'none'
|
||||||
|
role.set_permission(mod_id, level)
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
flash(_('Rol "%(name)s" y permisos actualizados correctamente.', name=role.name), 'success')
|
||||||
|
return redirect(url_for('admin.roles_list'))
|
||||||
|
|
||||||
|
current_perms = {p.module: p.access_level for p in role.permissions}
|
||||||
|
return render_template(
|
||||||
|
'admin/roles/edit.html',
|
||||||
|
role=role,
|
||||||
|
modules=SYSTEM_MODULES,
|
||||||
|
current_perms=current_perms
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@admin_bp.route('/roles/delete/<int:id>', methods=['POST'])
|
||||||
|
@admin_required
|
||||||
|
def role_delete(id):
|
||||||
|
"""Delete a non-system role if it has no assigned users"""
|
||||||
|
role = Role.query.get_or_404(id)
|
||||||
|
if role.is_system:
|
||||||
|
flash(_('No se pueden eliminar roles protegidos del sistema.'), 'error')
|
||||||
|
return redirect(url_for('admin.roles_list'))
|
||||||
|
|
||||||
|
user_count = len(role.users) if role.users else 0
|
||||||
|
if user_count > 0:
|
||||||
|
flash(_('No se puede eliminar el rol "%(name)s" porque tiene %(count)d usuario(s) asignado(s). Reasígnalos primero.', name=role.name, count=user_count), 'error')
|
||||||
|
return redirect(url_for('admin.roles_list'))
|
||||||
|
|
||||||
|
role_name = role.name
|
||||||
|
db.session.delete(role)
|
||||||
|
db.session.commit()
|
||||||
|
flash(_('El rol "%(name)s" ha sido eliminado.', name=role_name), 'success')
|
||||||
|
return redirect(url_for('admin.roles_list'))
|
||||||
|
|
||||||
|
|
||||||
|
# ---------------------------------------------------------
|
||||||
|
# GOOGLE SHEETS IMPORT & SYNCHRONIZATION
|
||||||
|
# ---------------------------------------------------------
|
||||||
|
|
||||||
|
@admin_bp.route('/import', methods=['GET', 'POST'])
|
||||||
|
@admin_required
|
||||||
|
def google_sheets_import():
|
||||||
|
"""Manual sync and status page for Google Sheets academic schedule data"""
|
||||||
|
from app.services.sheets_importer import GoogleSheetsImporter, SHEETS_CONFIG
|
||||||
|
from app.models.classroom import Classroom
|
||||||
|
from app.models.career import Career
|
||||||
|
from app.models.subject import Subject, Commission
|
||||||
|
from app.models.reservation import Reservation
|
||||||
|
|
||||||
|
stats = None
|
||||||
|
if request.method == 'POST':
|
||||||
|
try:
|
||||||
|
importer = GoogleSheetsImporter()
|
||||||
|
stats = importer.sync()
|
||||||
|
if stats['errors']:
|
||||||
|
flash(_('La sincronización se completó con algunas advertencias.'), 'warning')
|
||||||
|
else:
|
||||||
|
flash(_('Sincronización completada exitosamente. %(rows)d registros procesados.', rows=stats['total_rows_processed']), 'success')
|
||||||
|
except Exception as e:
|
||||||
|
flash(_('Error al sincronizar con Google Sheets: %(err)s', err=str(e)), 'error')
|
||||||
|
|
||||||
|
# Calculate current system metrics
|
||||||
|
metrics = {
|
||||||
|
'total_classrooms': Classroom.query.count(),
|
||||||
|
'total_careers': Career.query.count(),
|
||||||
|
'total_subjects': Subject.query.count(),
|
||||||
|
'total_commissions': Commission.query.count(),
|
||||||
|
'total_reservations': Reservation.query.count(),
|
||||||
|
'sheets': SHEETS_CONFIG
|
||||||
|
}
|
||||||
|
|
||||||
|
# Recent samples from DB if available
|
||||||
|
recent_subjects = Subject.query.order_by(Subject.id.desc()).limit(10).all()
|
||||||
|
|
||||||
|
return render_template(
|
||||||
|
'admin/import.html',
|
||||||
|
metrics=metrics,
|
||||||
|
stats=stats,
|
||||||
|
recent_subjects=recent_subjects
|
||||||
|
)
|
||||||
|
|
||||||
@@ -8,43 +8,24 @@ from datetime import datetime
|
|||||||
|
|
||||||
auth_bp = Blueprint('auth', __name__)
|
auth_bp = Blueprint('auth', __name__)
|
||||||
|
|
||||||
from sqlalchemy import func
|
|
||||||
|
|
||||||
@auth_bp.route('/login', methods=['GET', 'POST'])
|
@auth_bp.route('/login', methods=['GET', 'POST'])
|
||||||
def login():
|
def login():
|
||||||
"""Handle user login with case-insensitive email lookup and whitespace trimming"""
|
"""Handle user login"""
|
||||||
if current_user.is_authenticated:
|
if current_user.is_authenticated:
|
||||||
return redirect(url_for('main.dashboard'))
|
return redirect(url_for('main.dashboard'))
|
||||||
|
|
||||||
from app.models.setting import SystemSetting
|
|
||||||
demo_access_enabled = SystemSetting.get_value('demo_access_enabled', 'true') in ['true', 'True', '1', True]
|
|
||||||
|
|
||||||
form = LoginForm()
|
form = LoginForm()
|
||||||
if form.validate_on_submit():
|
if form.validate_on_submit():
|
||||||
clean_email = (form.email.data or '').strip().lower()
|
user = User.query.filter_by(email=form.email.data).first()
|
||||||
user = User.query.filter(func.lower(User.email) == clean_email).first()
|
|
||||||
|
|
||||||
if user and user.check_password(form.password.data):
|
if user and user.check_password(form.password.data):
|
||||||
if not user.is_active:
|
if not user.is_active:
|
||||||
flash(_('Tu cuenta ha sido desactivada. Por favor contacta al administrador.'), 'error')
|
flash(_('Tu cuenta ha sido desactivada. Por favor contacta al administrador.'), 'error')
|
||||||
return render_template('auth/login.html', form=form, demo_access_enabled=demo_access_enabled)
|
return render_template('auth/login.html', form=form)
|
||||||
|
|
||||||
login_user(user, remember=form.remember_me.data)
|
login_user(user, remember=form.remember_me.data)
|
||||||
user.update_last_login()
|
user.update_last_login()
|
||||||
|
|
||||||
# Registrar en bitácora de auditoría
|
|
||||||
try:
|
|
||||||
from app.services.audit_service import AuditService
|
|
||||||
AuditService.log(
|
|
||||||
action='LOGIN',
|
|
||||||
module='auth',
|
|
||||||
user_id=user.id,
|
|
||||||
user_email=user.email,
|
|
||||||
details=f"Inicio de sesión exitoso ({user.role})"
|
|
||||||
)
|
|
||||||
except Exception:
|
|
||||||
pass
|
|
||||||
|
|
||||||
# Si el usuario tiene idioma configurado en su perfil, sobrescribe el navegador en toda la sesión
|
# Si el usuario tiene idioma configurado en su perfil, sobrescribe el navegador en toda la sesión
|
||||||
if user.preferred_language and user.preferred_language in ['es', 'en']:
|
if user.preferred_language and user.preferred_language in ['es', 'en']:
|
||||||
session['language'] = user.preferred_language
|
session['language'] = user.preferred_language
|
||||||
@@ -61,18 +42,9 @@ def login():
|
|||||||
flash(_('¡Bienvenido de nuevo, %(name)s!', name=user_full_name), 'success')
|
flash(_('¡Bienvenido de nuevo, %(name)s!', name=user_full_name), 'success')
|
||||||
return redirect(next_page)
|
return redirect(next_page)
|
||||||
else:
|
else:
|
||||||
try:
|
|
||||||
from app.services.audit_service import AuditService
|
|
||||||
AuditService.log(
|
|
||||||
action='LOGIN_FAILED',
|
|
||||||
module='auth',
|
|
||||||
details=f"Intento fallido de login con email: {clean_email}"
|
|
||||||
)
|
|
||||||
except Exception:
|
|
||||||
pass
|
|
||||||
flash(_('Correo electrónico o contraseña inválidos.'), 'error')
|
flash(_('Correo electrónico o contraseña inválidos.'), 'error')
|
||||||
|
|
||||||
return render_template('auth/login.html', form=form, demo_access_enabled=demo_access_enabled)
|
return render_template('auth/login.html', form=form)
|
||||||
|
|
||||||
@auth_bp.route('/logout')
|
@auth_bp.route('/logout')
|
||||||
@login_required
|
@login_required
|
||||||
@@ -32,18 +32,15 @@ def list_buildings():
|
|||||||
|
|
||||||
buildings = query.order_by(Building.name.asc()).all()
|
buildings = query.order_by(Building.name.asc()).all()
|
||||||
|
|
||||||
# Calculate global building stats (excluye aulas virtuales con 9999)
|
# Calculate global building stats
|
||||||
total_classrooms = Classroom.query.filter_by(is_active=True).count()
|
total_classrooms = Classroom.query.filter_by(is_active=True).count()
|
||||||
physical_classrooms = [c for c in Classroom.query.filter_by(is_active=True).all() if not getattr(c, 'is_virtual', False) and (c.capacity or 0) < 999 and 'VIRTUAL' not in (c.code or '').upper()]
|
total_capacity = sum(c.capacity for c in Classroom.query.filter_by(is_active=True).all())
|
||||||
total_physical_capacity = sum(c.capacity for c in physical_classrooms)
|
|
||||||
total_capacity = total_physical_capacity
|
|
||||||
|
|
||||||
return render_template(
|
return render_template(
|
||||||
'buildings/list.html',
|
'buildings/list.html',
|
||||||
buildings=buildings,
|
buildings=buildings,
|
||||||
total_classrooms=total_classrooms,
|
total_classrooms=total_classrooms,
|
||||||
total_capacity=total_capacity,
|
total_capacity=total_capacity,
|
||||||
total_physical_capacity=total_physical_capacity,
|
|
||||||
search=search,
|
search=search,
|
||||||
status_filter=status_filter,
|
status_filter=status_filter,
|
||||||
title='Building Management'
|
title='Building Management'
|
||||||
@@ -0,0 +1,248 @@
|
|||||||
|
from flask import Blueprint, render_template, redirect, url_for, flash, request, jsonify
|
||||||
|
from flask_login import login_required, current_user
|
||||||
|
from datetime import datetime, date
|
||||||
|
from app.models.classroom import Classroom
|
||||||
|
from app.models.user import User
|
||||||
|
from app.forms.classroom import ClassroomForm
|
||||||
|
from app import db
|
||||||
|
from sqlalchemy import text
|
||||||
|
|
||||||
|
classrooms_bp = Blueprint('classrooms', __name__)
|
||||||
|
|
||||||
|
@classrooms_bp.route('/add', methods=['GET', 'POST'])
|
||||||
|
@login_required
|
||||||
|
def add_classroom():
|
||||||
|
"""Add a new classroom"""
|
||||||
|
form = ClassroomForm()
|
||||||
|
|
||||||
|
# TODO: Update when campus model is implemented
|
||||||
|
# form.campus_id.choices = [(1, 'Main Campus')]
|
||||||
|
|
||||||
|
if form.validate_on_submit():
|
||||||
|
try:
|
||||||
|
existing_classroom = Classroom.query.filter_by(
|
||||||
|
building=form.building.data,
|
||||||
|
code=form.room_number.data,
|
||||||
|
floor=form.floor.data
|
||||||
|
).first()
|
||||||
|
|
||||||
|
if existing_classroom:
|
||||||
|
flash('Classroom with this building, room number, and floor already exists.', 'error')
|
||||||
|
return render_template('classrooms/add.html', form=form, title='Add Classroom')
|
||||||
|
|
||||||
|
cap_raw = str(form.capacity.data or '').strip()
|
||||||
|
if cap_raw in ['∞', 'inf', 'INF', 'Infinity', 'infinity', '0', 'ilimitada', 'Ilimitada', 'sin limite', 'Sin límite']:
|
||||||
|
cap_val = 0
|
||||||
|
else:
|
||||||
|
cap_val = int(cap_raw)
|
||||||
|
|
||||||
|
classroom = Classroom(
|
||||||
|
# campus_id=form.campus_id.data,
|
||||||
|
building=form.building.data,
|
||||||
|
code=form.room_number.data,
|
||||||
|
floor=form.floor.data,
|
||||||
|
capacity=cap_val,
|
||||||
|
description=form.description.data,
|
||||||
|
is_active=form.is_active.data
|
||||||
|
)
|
||||||
|
|
||||||
|
db.session.add(classroom)
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
flash(f'Classroom {classroom.code_display} has been created successfully!', 'success')
|
||||||
|
return redirect(url_for('classrooms.list_classrooms'))
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
db.session.rollback()
|
||||||
|
flash(f'Error creating classroom: {str(e)}', 'error')
|
||||||
|
|
||||||
|
return render_template('classrooms/add.html', form=form, title='Add Classroom')
|
||||||
|
|
||||||
|
@classrooms_bp.route('/', endpoint='index')
|
||||||
|
@classrooms_bp.route('/list')
|
||||||
|
@login_required
|
||||||
|
def list_classrooms():
|
||||||
|
"""List all classrooms"""
|
||||||
|
try:
|
||||||
|
# Get filters
|
||||||
|
page = request.args.get('page', 1, type=int)
|
||||||
|
active_only = request.args.get('active_only', 'true').lower() == 'true'
|
||||||
|
search = request.args.get('search', '', type=str)
|
||||||
|
|
||||||
|
# Build query
|
||||||
|
query = Classroom.query
|
||||||
|
|
||||||
|
if active_only:
|
||||||
|
query = query.filter_by(is_active=True)
|
||||||
|
|
||||||
|
if search:
|
||||||
|
query = query.filter(
|
||||||
|
db.or_(
|
||||||
|
Classroom.building.ilike(f'%{search}%'),
|
||||||
|
Classroom.code.ilike(f'%{search}%'),
|
||||||
|
Classroom.description.ilike(f'%{search}%')
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
# Paginate results
|
||||||
|
classrooms = query.order_by(Classroom.building, Classroom.floor, Classroom.code).paginate(
|
||||||
|
page=page, per_page=12, error_out=False
|
||||||
|
)
|
||||||
|
|
||||||
|
return render_template('classrooms/list.html',
|
||||||
|
classrooms=classrooms,
|
||||||
|
active_only=active_only,
|
||||||
|
search=search,
|
||||||
|
title='Classrooms')
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
flash(f'Error loading classrooms: {str(e)}', 'error')
|
||||||
|
return render_template('classrooms/list.html', classrooms=None, title='Classrooms')
|
||||||
|
|
||||||
|
@classrooms_bp.route('/<int:id>')
|
||||||
|
@login_required
|
||||||
|
def view_classroom(id):
|
||||||
|
"""View classroom details"""
|
||||||
|
try:
|
||||||
|
classroom = Classroom.query.get_or_404(id)
|
||||||
|
|
||||||
|
# Get upcoming reservations for this classroom
|
||||||
|
from app.models.reservation import Reservation, ReservationStatus
|
||||||
|
|
||||||
|
upcoming_reservations = Reservation.query.filter(
|
||||||
|
Reservation.classroom_id == id,
|
||||||
|
Reservation.start_time > datetime.utcnow(),
|
||||||
|
Reservation.status == ReservationStatus.CONFIRMED.value
|
||||||
|
).order_by(Reservation.start_time).limit(10).all()
|
||||||
|
|
||||||
|
return render_template('classrooms/view.html',
|
||||||
|
classroom=classroom,
|
||||||
|
upcoming_reservations=upcoming_reservations,
|
||||||
|
title=f'Classroom {classroom.code_display}')
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
flash(f'Error loading classroom: {str(e)}', 'error')
|
||||||
|
return redirect(url_for('classrooms.list_classrooms'))
|
||||||
|
|
||||||
|
@classrooms_bp.route('/<int:id>/edit', methods=['GET', 'POST'])
|
||||||
|
@login_required
|
||||||
|
def edit_classroom(id):
|
||||||
|
"""Edit classroom"""
|
||||||
|
classroom = Classroom.query.get_or_404(id)
|
||||||
|
form = ClassroomForm(obj=classroom)
|
||||||
|
|
||||||
|
if request.method == 'GET':
|
||||||
|
if classroom.capacity == 0 or (classroom.code and 'VIRTUAL' in classroom.code.upper()):
|
||||||
|
form.capacity.data = '∞'
|
||||||
|
else:
|
||||||
|
form.capacity.data = str(classroom.capacity)
|
||||||
|
|
||||||
|
# TODO: Update when campus model is implemented
|
||||||
|
# form.campus_id.choices = [(1, 'Main Campus')]
|
||||||
|
|
||||||
|
if form.validate_on_submit():
|
||||||
|
try:
|
||||||
|
# Check for duplicates (excluding current classroom)
|
||||||
|
existing_classroom = Classroom.query.filter(
|
||||||
|
Classroom.building == form.building.data,
|
||||||
|
Classroom.code == form.room_number.data,
|
||||||
|
Classroom.floor == form.floor.data,
|
||||||
|
Classroom.id != id
|
||||||
|
).first()
|
||||||
|
|
||||||
|
if existing_classroom:
|
||||||
|
flash('Classroom with this building, room number, and floor already exists.', 'error')
|
||||||
|
return render_template('classrooms/edit.html', form=form, classroom=classroom, title='Edit Classroom')
|
||||||
|
|
||||||
|
cap_raw = str(form.capacity.data or '').strip()
|
||||||
|
if cap_raw in ['∞', 'inf', 'INF', 'Infinity', 'infinity', '0', 'ilimitada', 'Ilimitada', 'sin limite', 'Sin límite']:
|
||||||
|
cap_val = 0
|
||||||
|
else:
|
||||||
|
cap_val = int(cap_raw)
|
||||||
|
|
||||||
|
# Update classroom
|
||||||
|
classroom.building = form.building.data
|
||||||
|
classroom.code = form.room_number.data
|
||||||
|
classroom.floor = form.floor.data
|
||||||
|
classroom.capacity = cap_val
|
||||||
|
classroom.description = form.description.data
|
||||||
|
classroom.is_active = form.is_active.data
|
||||||
|
classroom.updated_at = datetime.utcnow()
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
flash(f'Classroom {classroom.code_display} has been updated successfully!', 'success')
|
||||||
|
return redirect(url_for('classrooms.view_classroom', id=classroom.id))
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
db.session.rollback()
|
||||||
|
flash(f'Error updating classroom: {str(e)}', 'error')
|
||||||
|
|
||||||
|
return render_template('classrooms/edit.html', form=form, classroom=classroom, title='Edit Classroom')
|
||||||
|
|
||||||
|
@classrooms_bp.route('/<int:id>/toggle', methods=['POST'])
|
||||||
|
@login_required
|
||||||
|
def toggle_classroom(id):
|
||||||
|
"""Toggle classroom active status"""
|
||||||
|
classroom = Classroom.query.get_or_404(id)
|
||||||
|
|
||||||
|
try:
|
||||||
|
classroom.is_active = not classroom.is_active
|
||||||
|
classroom.updated_at = datetime.utcnow()
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
status = 'activated' if classroom.is_active else 'deactivated'
|
||||||
|
flash(f'Classroom {classroom.code_display} has been {status} successfully!', 'success')
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
db.session.rollback()
|
||||||
|
flash(f'Error updating classroom status: {str(e)}', 'error')
|
||||||
|
|
||||||
|
return redirect(request.referrer or url_for('classrooms.list_classrooms'))
|
||||||
|
|
||||||
|
# API endpoints for AJAX requests
|
||||||
|
@classrooms_bp.route('/api/available')
|
||||||
|
@login_required
|
||||||
|
def get_available_classrooms():
|
||||||
|
"""Get available classrooms for a specific time slot"""
|
||||||
|
start_time = request.args.get('start_time')
|
||||||
|
end_time = request.args.get('end_time')
|
||||||
|
|
||||||
|
if not start_time or not end_time:
|
||||||
|
return jsonify({'error': 'Start time and end time are required'}), 400
|
||||||
|
|
||||||
|
try:
|
||||||
|
from datetime import datetime
|
||||||
|
from app.models.reservation import Reservation, ReservationStatus
|
||||||
|
|
||||||
|
start_dt = datetime.fromisoformat(start_time)
|
||||||
|
end_dt = datetime.fromisoformat(end_time)
|
||||||
|
|
||||||
|
# Find all classrooms
|
||||||
|
all_classrooms = Classroom.query.filter_by(is_active=True).all()
|
||||||
|
available_classrooms = []
|
||||||
|
|
||||||
|
for classroom in all_classrooms:
|
||||||
|
# Check if classroom has conflicting reservations
|
||||||
|
conflicts = Reservation.query.filter(
|
||||||
|
Reservation.classroom_id == classroom.id,
|
||||||
|
Reservation.status == ReservationStatus.CONFIRMED.value,
|
||||||
|
Reservation.start_time < end_dt,
|
||||||
|
Reservation.end_time > start_dt
|
||||||
|
).all()
|
||||||
|
|
||||||
|
if not conflicts:
|
||||||
|
available_classrooms.append({
|
||||||
|
'id': classroom.id,
|
||||||
|
'code': classroom.code,
|
||||||
|
'building': classroom.building,
|
||||||
|
'room_number': classroom.code,
|
||||||
|
'floor': classroom.floor,
|
||||||
|
'capacity': classroom.capacity,
|
||||||
|
'code_display': classroom.code_display
|
||||||
|
})
|
||||||
|
|
||||||
|
return jsonify({'classrooms': available_classrooms})
|
||||||
|
|
||||||
|
except Exception as e:
|
||||||
|
return jsonify({'error': str(e)}), 500
|
||||||
@@ -1,43 +1,15 @@
|
|||||||
from flask import Blueprint, request, jsonify, current_app, render_template, g
|
from flask import Blueprint, request, jsonify, current_app, render_template
|
||||||
from datetime import datetime, timedelta
|
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 flask_login import login_required, current_user
|
||||||
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
|
@login_required
|
||||||
def optimize_reservations():
|
def optimize_reservations():
|
||||||
"""Optimize reservations using genetic algorithm"""
|
"""Optimize reservations using genetic algorithm"""
|
||||||
try:
|
try:
|
||||||
@@ -67,26 +39,19 @@ 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, bedelia, teacher or RBAC optimizer write)
|
# Check if user has permission (admin or teacher)
|
||||||
if not check_optimizer_permission(g.jwt_user, requires_write=True):
|
if current_user.role not in ['ADMIN', 'teacher']:
|
||||||
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
|
||||||
optimizer = ReservationOptimizer()
|
optimizer = ReservationOptimizer()
|
||||||
result = optimizer.optimize_schedule(
|
result = optimizer.optimize_schedule(
|
||||||
commission_ids=commission_ids,
|
commission_ids=commission_ids,
|
||||||
admin_user_id=g.jwt_user.id,
|
admin_user_id=current_user.id,
|
||||||
start_date=start_date,
|
start_date=start_date,
|
||||||
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': {
|
||||||
@@ -104,7 +69,7 @@ def optimize_reservations():
|
|||||||
|
|
||||||
|
|
||||||
@genetic_bp.route('/apply-optimization', methods=['POST'])
|
@genetic_bp.route('/apply-optimization', methods=['POST'])
|
||||||
@jwt_required
|
@login_required
|
||||||
def apply_optimization():
|
def apply_optimization():
|
||||||
"""Apply optimized reservations to the database"""
|
"""Apply optimized reservations to the database"""
|
||||||
try:
|
try:
|
||||||
@@ -119,20 +84,13 @@ 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 check_optimizer_permission(g.jwt_user, requires_write=True):
|
if current_user.role not in ['ADMIN', 'teacher']:
|
||||||
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': {
|
||||||
@@ -148,7 +106,7 @@ def apply_optimization():
|
|||||||
|
|
||||||
|
|
||||||
@genetic_bp.route('/preview-optimization', methods=['POST'])
|
@genetic_bp.route('/preview-optimization', methods=['POST'])
|
||||||
@jwt_required
|
@login_required
|
||||||
def preview_optimization():
|
def preview_optimization():
|
||||||
"""Preview optimization without applying to database"""
|
"""Preview optimization without applying to database"""
|
||||||
try:
|
try:
|
||||||
@@ -166,14 +124,14 @@ 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 not check_optimizer_permission(g.jwt_user, requires_write=False):
|
if current_user.role not in ['ADMIN', 'teacher']:
|
||||||
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
|
||||||
optimizer = ReservationOptimizer()
|
optimizer = ReservationOptimizer()
|
||||||
result = optimizer.optimize_schedule(
|
result = optimizer.optimize_schedule(
|
||||||
commission_ids=commission_ids,
|
commission_ids=commission_ids,
|
||||||
admin_user_id=g.jwt_user.id
|
admin_user_id=current_user.id
|
||||||
)
|
)
|
||||||
|
|
||||||
# Add additional preview information
|
# Add additional preview information
|
||||||
@@ -208,12 +166,12 @@ def preview_optimization():
|
|||||||
|
|
||||||
|
|
||||||
@genetic_bp.route('/commissions', methods=['GET'])
|
@genetic_bp.route('/commissions', methods=['GET'])
|
||||||
@jwt_required
|
@login_required
|
||||||
def get_commissions():
|
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 not check_optimizer_permission(g.jwt_user, requires_write=False):
|
if current_user.role not in ['ADMIN', 'teacher']:
|
||||||
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
|
||||||
@@ -225,8 +183,6 @@ 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({
|
||||||
@@ -240,12 +196,12 @@ def get_commissions():
|
|||||||
|
|
||||||
|
|
||||||
@genetic_bp.route('/algorithm-status', methods=['GET'])
|
@genetic_bp.route('/algorithm-status', methods=['GET'])
|
||||||
@jwt_required
|
@login_required
|
||||||
def get_algorithm_status():
|
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 not check_optimizer_permission(g.jwt_user, requires_write=False):
|
if current_user.role not in ['ADMIN']:
|
||||||
return jsonify({'error': 'Insufficient permissions'}), 403
|
return jsonify({'error': 'Insufficient permissions'}), 403
|
||||||
|
|
||||||
# Get system status
|
# Get system status
|
||||||
@@ -290,10 +246,10 @@ genetic_web_bp = Blueprint('genetic_algorithm_web', __name__)
|
|||||||
|
|
||||||
|
|
||||||
@genetic_web_bp.route('/genetic-optimizer')
|
@genetic_web_bp.route('/genetic-optimizer')
|
||||||
@jwt_required
|
@login_required
|
||||||
def genetic_optimizer():
|
def genetic_optimizer():
|
||||||
"""Render the genetic algorithm optimizer interface"""
|
"""Render the genetic algorithm optimizer interface"""
|
||||||
if not check_optimizer_permission(g.jwt_user, requires_write=False):
|
if current_user.role not in ['ADMIN']:
|
||||||
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')
|
||||||
@@ -0,0 +1,137 @@
|
|||||||
|
from flask import Blueprint, render_template, jsonify, redirect, url_for, session, request, flash
|
||||||
|
from flask_login import login_required, current_user
|
||||||
|
from app import db
|
||||||
|
from app.models.reservation import Reservation
|
||||||
|
from app.models.classroom import Classroom
|
||||||
|
from app.models.subject import Subject
|
||||||
|
from app.models.subject import Commission
|
||||||
|
from datetime import datetime, timedelta
|
||||||
|
from sqlalchemy import func
|
||||||
|
from flask_babel import gettext as _
|
||||||
|
|
||||||
|
main_bp = Blueprint('main', __name__)
|
||||||
|
|
||||||
|
@main_bp.route('/')
|
||||||
|
@login_required
|
||||||
|
def dashboard():
|
||||||
|
"""Main dashboard page"""
|
||||||
|
# Get statistics
|
||||||
|
try:
|
||||||
|
total_classrooms = Classroom.query.filter_by(is_active=True).count()
|
||||||
|
except:
|
||||||
|
total_classrooms = 0
|
||||||
|
|
||||||
|
try:
|
||||||
|
total_subjects = Subject.query.filter_by(is_active=True).count()
|
||||||
|
except:
|
||||||
|
total_subjects = 0
|
||||||
|
|
||||||
|
# Get today's reservations
|
||||||
|
today = datetime.utcnow().date()
|
||||||
|
try:
|
||||||
|
today_reservations = Reservation.query.filter(
|
||||||
|
func.date(Reservation.start_time) == today
|
||||||
|
).count()
|
||||||
|
except:
|
||||||
|
today_reservations = 0
|
||||||
|
|
||||||
|
# Get this week's reservations
|
||||||
|
week_start = today - timedelta(days=today.weekday())
|
||||||
|
week_end = week_start + timedelta(days=6)
|
||||||
|
try:
|
||||||
|
week_reservations = Reservation.query.filter(
|
||||||
|
func.date(Reservation.start_time) >= week_start,
|
||||||
|
func.date(Reservation.start_time) <= week_end
|
||||||
|
).count()
|
||||||
|
except:
|
||||||
|
week_reservations = 0
|
||||||
|
|
||||||
|
# Get upcoming reservations (next 7 days)
|
||||||
|
try:
|
||||||
|
upcoming_reservations = Reservation.query.filter(
|
||||||
|
Reservation.start_time >= datetime.utcnow(),
|
||||||
|
Reservation.start_time <= datetime.utcnow() + timedelta(days=7)
|
||||||
|
).limit(10).all()
|
||||||
|
except:
|
||||||
|
upcoming_reservations = []
|
||||||
|
|
||||||
|
stats = {
|
||||||
|
'total_classrooms': total_classrooms,
|
||||||
|
'total_subjects': total_subjects,
|
||||||
|
'today_reservations': today_reservations,
|
||||||
|
'week_reservations': week_reservations
|
||||||
|
}
|
||||||
|
|
||||||
|
return render_template('dashboard.html',
|
||||||
|
stats=stats,
|
||||||
|
upcoming_reservations=upcoming_reservations)
|
||||||
|
|
||||||
|
@main_bp.route('/api/dashboard-stats')
|
||||||
|
@login_required
|
||||||
|
def dashboard_stats_api():
|
||||||
|
"""API endpoint for dashboard statistics"""
|
||||||
|
# Get today's data
|
||||||
|
today = datetime.utcnow().date()
|
||||||
|
today_reservations = Reservation.query.filter(
|
||||||
|
func.date(Reservation.start_time) == today
|
||||||
|
).count()
|
||||||
|
|
||||||
|
# Get this week's data
|
||||||
|
week_start = today - timedelta(days=today.weekday())
|
||||||
|
week_end = week_start + timedelta(days=6)
|
||||||
|
week_reservations = Reservation.query.filter(
|
||||||
|
func.date(Reservation.start_time) >= week_start,
|
||||||
|
func.date(Reservation.start_time) <= week_end
|
||||||
|
).count()
|
||||||
|
|
||||||
|
# Get monthly data for chart
|
||||||
|
current_date = datetime.utcnow()
|
||||||
|
monthly_data = []
|
||||||
|
|
||||||
|
for i in range(12):
|
||||||
|
month_date = current_date - timedelta(days=30 * i)
|
||||||
|
month_start = month_date.replace(day=1)
|
||||||
|
month_end = (month_start + timedelta(days=32)).replace(day=1) - timedelta(days=1)
|
||||||
|
|
||||||
|
monthly_reservations = Reservation.query.filter(
|
||||||
|
func.date(Reservation.start_time) >= month_start.date(),
|
||||||
|
func.date(Reservation.start_time) <= month_end.date()
|
||||||
|
).count()
|
||||||
|
|
||||||
|
monthly_data.append({
|
||||||
|
'month': month_start.strftime('%Y-%m'),
|
||||||
|
'reservations': monthly_reservations
|
||||||
|
})
|
||||||
|
|
||||||
|
return jsonify({
|
||||||
|
'today_reservations': today_reservations,
|
||||||
|
'week_reservations': week_reservations,
|
||||||
|
'monthly_data': list(reversed(monthly_data))
|
||||||
|
})
|
||||||
|
|
||||||
|
@main_bp.route('/genetic-optimizer')
|
||||||
|
@login_required
|
||||||
|
def genetic_optimizer():
|
||||||
|
"""Serve the genetic algorithm optimization interface"""
|
||||||
|
if current_user.role not in ['ADMIN']:
|
||||||
|
flash('You do not have permission to access the optimization tool.', 'danger')
|
||||||
|
return redirect(url_for('main.dashboard'))
|
||||||
|
|
||||||
|
return render_template('genetic_optimizer.html')
|
||||||
|
|
||||||
|
@main_bp.route('/set_language/<language>')
|
||||||
|
def set_language(language=None):
|
||||||
|
if language not in ['en', 'es']:
|
||||||
|
language = 'es'
|
||||||
|
|
||||||
|
session['language'] = language
|
||||||
|
|
||||||
|
# Si se selecciona el idioma desde la pantalla de login, registrar la selección explícita
|
||||||
|
if request.referrer and 'login' in request.referrer:
|
||||||
|
session['login_lang_explicit'] = language
|
||||||
|
|
||||||
|
if current_user.is_authenticated:
|
||||||
|
current_user.preferred_language = language
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
return redirect(request.referrer or url_for('main.dashboard'))␍
|
||||||
@@ -40,12 +40,8 @@ def today_schedule():
|
|||||||
~Classroom.building.ilike('%Virtual%')
|
~Classroom.building.ilike('%Virtual%')
|
||||||
)
|
)
|
||||||
|
|
||||||
if floor_filter:
|
if floor_filter and floor_filter.isdigit():
|
||||||
flr = str(floor_filter).strip()
|
query = query.filter(Classroom.floor == int(floor_filter))
|
||||||
if flr.upper() in ['0', 'PB', 'PLANTA BAJA']:
|
|
||||||
query = query.filter(or_(Classroom.floor == '0', Classroom.floor.ilike('%PB%'), Classroom.floor.ilike('%Planta Baja%')))
|
|
||||||
else:
|
|
||||||
query = query.filter(Classroom.floor == flr)
|
|
||||||
|
|
||||||
if shift_filter:
|
if shift_filter:
|
||||||
query = query.filter(Reservation.shift.ilike(f'%{shift_filter}%'))
|
query = query.filter(Reservation.shift.ilike(f'%{shift_filter}%'))
|
||||||
@@ -139,102 +135,14 @@ def view_reservation(id):
|
|||||||
flash(f'Error loading reservation details: {str(e)}', 'error')
|
flash(f'Error loading reservation details: {str(e)}', 'error')
|
||||||
return redirect(url_for('schedule.today_schedule'))
|
return redirect(url_for('schedule.today_schedule'))
|
||||||
|
|
||||||
@schedule_bp.route('/reservation/<int:id>/edit', methods=['GET', 'POST'])
|
|
||||||
@login_required
|
|
||||||
def edit_reservation(id):
|
|
||||||
"""Edit existing reservation"""
|
|
||||||
from app.models.classroom import Classroom
|
|
||||||
from app.models.subject import Commission
|
|
||||||
from app.models.building import Building
|
|
||||||
from flask_babel import gettext as _
|
|
||||||
|
|
||||||
reservation = Reservation.query.options(
|
|
||||||
joinedload(Reservation.classroom),
|
|
||||||
joinedload(Reservation.commission),
|
|
||||||
joinedload(Reservation.user)
|
|
||||||
).get_or_404(id)
|
|
||||||
|
|
||||||
if not current_user.can_edit_reservation(reservation):
|
|
||||||
flash(_('No tienes los permisos necesarios para modificar esta reserva.'), 'error')
|
|
||||||
return redirect(url_for('schedule.view_reservation', id=reservation.id))
|
|
||||||
|
|
||||||
form = ReservationForm(is_edit=True)
|
|
||||||
|
|
||||||
buildings = Building.query.filter_by(is_active=True).order_by(Building.name.asc()).all()
|
|
||||||
classrooms = Classroom.query.filter_by(is_active=True).order_by(Classroom.building_id.asc(), Classroom.floor.asc(), Classroom.code.asc()).all()
|
|
||||||
commissions = Commission.query.filter_by(active=True).all()
|
|
||||||
|
|
||||||
form.classroom_id.choices = [(c.id, f'{c.building_name} - {c.code} (Cap: {c.capacity_display})') for c in classrooms]
|
|
||||||
form.commission_id.choices = [(c.id, f'{c.get_full_code()} - {c.subject.name if c.subject else "No Subject"} (Students: {c.max_students})') for c in commissions]
|
|
||||||
|
|
||||||
if request.method == 'GET':
|
|
||||||
form.classroom_id.data = reservation.classroom_id
|
|
||||||
form.commission_id.data = reservation.commission_id
|
|
||||||
form.start_time.data = reservation.start_time
|
|
||||||
form.end_time.data = reservation.end_time
|
|
||||||
form.purpose.data = reservation.purpose
|
|
||||||
form.expected_attendees.data = reservation.expected_attendees
|
|
||||||
form.notes.data = reservation.notes or ''
|
|
||||||
form.virtual_link.data = reservation.virtual_link or ''
|
|
||||||
|
|
||||||
elif request.method == 'POST':
|
|
||||||
if form.validate_on_submit():
|
|
||||||
try:
|
|
||||||
# Verificar colisión de horario si no es virtual
|
|
||||||
target_room = Classroom.query.get(form.classroom_id.data)
|
|
||||||
if target_room and not target_room.is_virtual:
|
|
||||||
conflict = Reservation.query.filter(
|
|
||||||
Reservation.id != reservation.id,
|
|
||||||
Reservation.classroom_id == form.classroom_id.data,
|
|
||||||
Reservation.status == ReservationStatus.CONFIRMED.value,
|
|
||||||
Reservation.start_time < form.end_time.data,
|
|
||||||
Reservation.end_time > form.start_time.data
|
|
||||||
).first()
|
|
||||||
|
|
||||||
if conflict:
|
|
||||||
flash(_('El aula seleccionada ya cuenta con una reserva confirmada en esa franja horaria.'), 'danger')
|
|
||||||
return render_template('schedule/edit.html', form=form, reservation=reservation, classroom_list=classrooms, commission_list=commissions, buildings=buildings)
|
|
||||||
|
|
||||||
# Asignar cambios
|
|
||||||
reservation.classroom_id = form.classroom_id.data
|
|
||||||
reservation.commission_id = form.commission_id.data
|
|
||||||
reservation.start_time = form.start_time.data
|
|
||||||
reservation.end_time = form.end_time.data
|
|
||||||
reservation.purpose = form.purpose.data
|
|
||||||
reservation.expected_attendees = form.expected_attendees.data
|
|
||||||
reservation.notes = form.notes.data
|
|
||||||
reservation.virtual_link = form.virtual_link.data.strip() if form.virtual_link.data else None
|
|
||||||
|
|
||||||
# Turno
|
|
||||||
h = reservation.start_time.hour
|
|
||||||
if h < 13:
|
|
||||||
reservation.shift = 'Mañana'
|
|
||||||
elif h < 18:
|
|
||||||
reservation.shift = 'Tarde'
|
|
||||||
elif h < 21:
|
|
||||||
reservation.shift = 'Vespertino'
|
|
||||||
else:
|
|
||||||
reservation.shift = 'Noche'
|
|
||||||
|
|
||||||
db.session.commit()
|
|
||||||
flash(_('Reserva #%(id)d modificada exitosamente.', id=reservation.id), 'success')
|
|
||||||
return redirect(url_for('schedule.view_reservation', id=reservation.id))
|
|
||||||
except Exception as e:
|
|
||||||
db.session.rollback()
|
|
||||||
flash(f'Error al modificar reserva: {str(e)}', 'danger')
|
|
||||||
|
|
||||||
return render_template('schedule/edit.html', form=form, reservation=reservation, classroom_list=classrooms, commission_list=commissions, buildings=buildings)
|
|
||||||
|
|
||||||
@schedule_bp.route('/calendar')
|
@schedule_bp.route('/calendar')
|
||||||
@login_required
|
@login_required
|
||||||
def calendar_view():
|
def calendar_view():
|
||||||
"""Show calendar view with classroom, subject, career, shift, floor and virtual filtering"""
|
"""Show calendar view with classroom, subject, career, shift, floor and virtual filtering"""
|
||||||
from app.models.career import Career
|
from app.models.career import Career
|
||||||
from app.models.building import Building
|
|
||||||
classrooms = Classroom.query.filter_by(is_active=True).order_by(Classroom.building.asc(), Classroom.code.asc()).all()
|
classrooms = Classroom.query.filter_by(is_active=True).order_by(Classroom.building.asc(), Classroom.code.asc()).all()
|
||||||
subjects = Subject.query.filter_by(is_active=True).order_by(Subject.name.asc()).all()
|
subjects = Subject.query.filter_by(is_active=True).order_by(Subject.name.asc()).all()
|
||||||
careers = Career.query.order_by(Career.name.asc()).all()
|
careers = Career.query.order_by(Career.name.asc()).all()
|
||||||
buildings = Building.query.filter_by(is_active=True).order_by(Building.name.asc()).all()
|
|
||||||
|
|
||||||
floors = db.session.query(Classroom.floor).filter(Classroom.is_active==True, Classroom.floor.isnot(None)).distinct().order_by(Classroom.floor.asc()).all()
|
floors = db.session.query(Classroom.floor).filter(Classroom.is_active==True, Classroom.floor.isnot(None)).distinct().order_by(Classroom.floor.asc()).all()
|
||||||
available_floors = [f[0] for f in floors]
|
available_floors = [f[0] for f in floors]
|
||||||
@@ -246,246 +154,22 @@ def calendar_view():
|
|||||||
classrooms=classrooms,
|
classrooms=classrooms,
|
||||||
subjects=subjects,
|
subjects=subjects,
|
||||||
careers=careers,
|
careers=careers,
|
||||||
buildings=buildings,
|
|
||||||
available_floors=available_floors
|
available_floors=available_floors
|
||||||
)
|
)
|
||||||
|
|
||||||
def user_can_manage_commission_milestones(user, commission=None):
|
|
||||||
"""Verifica si el usuario (Docente, Admin, Bedelía) puede gestionar hitos y links virtuales"""
|
|
||||||
if user.is_admin():
|
|
||||||
return True
|
|
||||||
role_name = (user.role_obj.name if user.role_obj else user.role or '').lower()
|
|
||||||
if role_name in ['admin', 'bedelia', 'bedelía', 'operador']:
|
|
||||||
return True
|
|
||||||
if role_name in ['docente', 'profesor']:
|
|
||||||
return True
|
|
||||||
return user.has_permission('schedule', 'read_write')
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions')
|
@schedule_bp.route('/commissions')
|
||||||
@login_required
|
|
||||||
def commissions_view():
|
def commissions_view():
|
||||||
"""Vista y ABM de Comisiones con soporte de enlace virtual e hitos académicos"""
|
subjects = Subject.query.all()
|
||||||
from app.models.subject import Commission, Subject
|
|
||||||
from app.models.classroom import Classroom
|
|
||||||
from app.models.user import User
|
|
||||||
from app.models.milestone import MilestoneType
|
|
||||||
|
|
||||||
subjects = Subject.query.order_by(Subject.code.asc()).all()
|
# Calculamos el total de capacidad sumando todas las comisiones de todas las materias
|
||||||
classrooms = Classroom.query.filter_by(is_active=True).order_by(Classroom.code.asc()).all()
|
|
||||||
teachers = User.query.filter_by(is_active=True).order_by(User.name.asc()).all()
|
|
||||||
milestone_types = MilestoneType.query.filter_by(is_active=True).order_by(MilestoneType.sort_order.asc()).all()
|
|
||||||
|
|
||||||
# Totales para indicadores superiores
|
|
||||||
total_capacity = sum(c.max_students for s in subjects for c in s.commissions)
|
total_capacity = sum(c.max_students for s in subjects for c in s.commissions)
|
||||||
|
# Calculamos el total de comisiones
|
||||||
total_commissions = sum(len(s.commissions) for s in subjects)
|
total_commissions = sum(len(s.commissions) for s in subjects)
|
||||||
|
|
||||||
can_manage_milestones = user_can_manage_commission_milestones(current_user)
|
|
||||||
role_name = (current_user.role_obj.name if current_user.role_obj else current_user.role or '').lower()
|
|
||||||
can_edit_commissions = current_user.is_admin() or role_name in ['admin', 'bedelia', 'bedelía', 'operador'] or current_user.has_permission('schedule', 'read_write')
|
|
||||||
|
|
||||||
return render_template('schedule/commissions.html',
|
return render_template('schedule/commissions.html',
|
||||||
subjects=subjects,
|
subjects=subjects,
|
||||||
classrooms=classrooms,
|
|
||||||
teachers=teachers,
|
|
||||||
milestone_types=milestone_types,
|
|
||||||
total_capacity=total_capacity,
|
total_capacity=total_capacity,
|
||||||
total_commissions=total_commissions,
|
total_commissions=total_commissions)
|
||||||
can_manage_milestones=can_manage_milestones,
|
|
||||||
can_edit_commissions=can_edit_commissions)
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions/add', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def commission_add():
|
|
||||||
"""Crear una nueva comisión de cursada"""
|
|
||||||
role_name = (current_user.role_obj.name if current_user.role_obj else current_user.role or '').lower()
|
|
||||||
if not (current_user.is_admin() or role_name in ['admin', 'bedelia', 'bedelía', 'operador'] or current_user.has_permission('schedule', 'read_write')):
|
|
||||||
flash(_('No tienes permisos para crear comisiones.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
from app.models.subject import Commission
|
|
||||||
subject_id = request.form.get('subject_id', type=int)
|
|
||||||
code = request.form.get('code', '').strip()
|
|
||||||
semester = request.form.get('semester', '1C').strip()
|
|
||||||
year = request.form.get('year', datetime.now().year, type=int)
|
|
||||||
teacher_id = request.form.get('teacher_id', type=int) or None
|
|
||||||
max_students = request.form.get('max_students', 40, type=int)
|
|
||||||
schedule = request.form.get('schedule', '').strip()
|
|
||||||
shift = request.form.get('shift', 'Tarde').strip()
|
|
||||||
virtual_link = request.form.get('virtual_link', '').strip()
|
|
||||||
|
|
||||||
if not subject_id or not code:
|
|
||||||
flash(_('La asignatura y el código de comisión son obligatorios.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
# Verificar existencia duplicada
|
|
||||||
existing = Commission.query.filter_by(subject_id=subject_id, code=code, semester=semester, year=year).first()
|
|
||||||
if existing:
|
|
||||||
flash(_('Ya existe una comisión %(code)s para el ciclo %(sem)s %(yr)d.', code=code, sem=semester, yr=year), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
new_comm = Commission(
|
|
||||||
subject_id=subject_id,
|
|
||||||
code=code,
|
|
||||||
semester=semester,
|
|
||||||
year=year,
|
|
||||||
teacher_id=teacher_id,
|
|
||||||
max_students=max_students,
|
|
||||||
schedule=schedule,
|
|
||||||
shift=shift,
|
|
||||||
virtual_link=virtual_link or None,
|
|
||||||
active=True
|
|
||||||
)
|
|
||||||
db.session.add(new_comm)
|
|
||||||
db.session.commit()
|
|
||||||
|
|
||||||
flash(_('Comisión %(code)s creada exitosamente.', code=new_comm.get_full_code()), 'success')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions/<int:id>/edit', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def commission_edit(id):
|
|
||||||
"""Editar datos de una comisión"""
|
|
||||||
role_name = (current_user.role_obj.name if current_user.role_obj else current_user.role or '').lower()
|
|
||||||
if not (current_user.is_admin() or role_name in ['admin', 'bedelia', 'bedelía', 'operador'] or current_user.has_permission('schedule', 'read_write')):
|
|
||||||
flash(_('No tienes permisos para modificar comisiones.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
from app.models.subject import Commission
|
|
||||||
commission = Commission.query.get_or_404(id)
|
|
||||||
|
|
||||||
commission.code = request.form.get('code', commission.code).strip()
|
|
||||||
commission.semester = request.form.get('semester', commission.semester).strip()
|
|
||||||
commission.year = request.form.get('year', commission.year, type=int)
|
|
||||||
commission.teacher_id = request.form.get('teacher_id', type=int) or None
|
|
||||||
commission.max_students = request.form.get('max_students', commission.max_students, type=int)
|
|
||||||
commission.schedule = request.form.get('schedule', commission.schedule).strip()
|
|
||||||
commission.shift = request.form.get('shift', commission.shift).strip()
|
|
||||||
commission.virtual_link = request.form.get('virtual_link', '').strip() or None
|
|
||||||
commission.active = True if request.form.get('active') in ['1', 'true', 'on'] else False
|
|
||||||
|
|
||||||
db.session.commit()
|
|
||||||
flash(_('Comisión %(code)s actualizada con éxito.', code=commission.get_full_code()), 'success')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions/<int:id>/delete', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def commission_delete(id):
|
|
||||||
"""Eliminar una comisión"""
|
|
||||||
role_name = (current_user.role_obj.name if current_user.role_obj else current_user.role or '').lower()
|
|
||||||
if not (current_user.is_admin() or role_name in ['admin', 'bedelia', 'bedelía', 'operador'] or current_user.has_permission('schedule', 'read_write')):
|
|
||||||
flash(_('No tienes permisos para eliminar comisiones.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
from app.models.subject import Commission
|
|
||||||
commission = Commission.query.get_or_404(id)
|
|
||||||
full_code = commission.get_full_code()
|
|
||||||
|
|
||||||
db.session.delete(commission)
|
|
||||||
db.session.commit()
|
|
||||||
|
|
||||||
flash(_('Comisión %(code)s eliminada permanentemente.', code=full_code), 'success')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions/<int:id>/virtual-link', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def commission_virtual_link(id):
|
|
||||||
"""Actualizar enlace del aula virtual (Zoom, Meet, Teams, Moodle) - Profesores, Admin y Bedelía"""
|
|
||||||
from app.models.subject import Commission
|
|
||||||
commission = Commission.query.get_or_404(id)
|
|
||||||
|
|
||||||
if not user_can_manage_commission_milestones(current_user, commission):
|
|
||||||
flash(_('No tienes permisos para actualizar el aula virtual de esta comisión.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
link = request.form.get('virtual_link', '').strip()
|
|
||||||
commission.virtual_link = link or None
|
|
||||||
db.session.commit()
|
|
||||||
|
|
||||||
flash(_('Enlace del aula virtual actualizado para la comisión %(code)s.', code=commission.get_full_code()), 'success')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions/<int:id>/milestones/add', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def commission_milestone_add(id):
|
|
||||||
"""Agregar un hito académico (Parcial, TP, Recuperatorio) a una comisión - Profesores, Admin y Bedelía"""
|
|
||||||
from app.models.subject import Commission
|
|
||||||
from app.models.milestone import AcademicMilestone, MilestoneType
|
|
||||||
commission = Commission.query.get_or_404(id)
|
|
||||||
|
|
||||||
if not user_can_manage_commission_milestones(current_user, commission):
|
|
||||||
flash(_('No tienes permisos para agregar hitos a esta comisión.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
milestone_type_id = request.form.get('milestone_type_id', type=int)
|
|
||||||
title = request.form.get('title', '').strip()
|
|
||||||
date_str = request.form.get('date', '').strip()
|
|
||||||
time_str = request.form.get('time', '18:00').strip()
|
|
||||||
classroom = request.form.get('classroom', '').strip()
|
|
||||||
link = request.form.get('link', '').strip() or commission.virtual_link or ''
|
|
||||||
notes = request.form.get('notes', '').strip()
|
|
||||||
|
|
||||||
if not milestone_type_id or not date_str:
|
|
||||||
flash(_('Debes especificar el tipo de hito y la fecha.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
m_type = MilestoneType.query.get(milestone_type_id)
|
|
||||||
if not m_type:
|
|
||||||
flash(_('Tipo de hito inválido.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
try:
|
|
||||||
dt = datetime.strptime(f"{date_str} {time_str}", "%Y-%m-%d %H:%M")
|
|
||||||
except ValueError:
|
|
||||||
try:
|
|
||||||
dt = datetime.strptime(date_str, "%Y-%m-%d")
|
|
||||||
except ValueError:
|
|
||||||
flash(_('Formato de fecha inválido.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
milestone = AcademicMilestone(
|
|
||||||
title=title or m_type.name,
|
|
||||||
materia_codigo=commission.subject.code if commission.subject else 'ASIG',
|
|
||||||
subject_id=commission.subject_id,
|
|
||||||
commission_id=commission.id,
|
|
||||||
milestone_type_id=m_type.id,
|
|
||||||
date=dt,
|
|
||||||
classroom=classroom or 'Campus Virtual',
|
|
||||||
link=link or None,
|
|
||||||
notes=notes or None,
|
|
||||||
is_active=True
|
|
||||||
)
|
|
||||||
db.session.add(milestone)
|
|
||||||
db.session.commit()
|
|
||||||
|
|
||||||
flash(_('Hito "%(title)s" registrado correctamente en %(comm)s.', title=milestone.title, comm=commission.get_full_code()), 'success')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
|
|
||||||
@schedule_bp.route('/commissions/<int:commission_id>/milestones/<int:milestone_id>/delete', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def commission_milestone_delete(commission_id, milestone_id):
|
|
||||||
"""Eliminar un hito académico de una comisión"""
|
|
||||||
from app.models.subject import Commission
|
|
||||||
from app.models.milestone import AcademicMilestone
|
|
||||||
commission = Commission.query.get_or_404(commission_id)
|
|
||||||
|
|
||||||
if not user_can_manage_commission_milestones(current_user, commission):
|
|
||||||
flash(_('No tienes permisos para eliminar hitos de esta comisión.'), 'error')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
milestone = AcademicMilestone.query.filter_by(id=milestone_id, commission_id=commission_id).first_or_404()
|
|
||||||
title = milestone.title
|
|
||||||
db.session.delete(milestone)
|
|
||||||
db.session.commit()
|
|
||||||
|
|
||||||
flash(_('Hito "%(title)s" eliminado de la comisión.', title=title), 'success')
|
|
||||||
return redirect(url_for('schedule.commissions_view'))
|
|
||||||
|
|
||||||
@schedule_bp.route('/add', methods=['GET', 'POST'])
|
@schedule_bp.route('/add', methods=['GET', 'POST'])
|
||||||
@login_required
|
@login_required
|
||||||
@@ -493,23 +177,23 @@ def add_reservation():
|
|||||||
"""Add new reservation"""
|
"""Add new reservation"""
|
||||||
from app.models.classroom import Classroom
|
from app.models.classroom import Classroom
|
||||||
from app.models.subject import Commission
|
from app.models.subject import Commission
|
||||||
from app.models.building import Building
|
|
||||||
|
|
||||||
form = ReservationForm()
|
form = ReservationForm()
|
||||||
|
|
||||||
# Get active buildings and classrooms
|
# Get active classrooms for the dropdown
|
||||||
buildings = Building.query.filter_by(is_active=True).order_by(Building.name.asc()).all()
|
classrooms = Classroom.query.filter_by(is_active=True).all()
|
||||||
classrooms = Classroom.query.filter_by(is_active=True).order_by(Classroom.building_id.asc(), Classroom.floor.asc(), Classroom.code.asc()).all()
|
|
||||||
|
# Get active commissions for the dropdown
|
||||||
commissions = Commission.query.filter_by(active=True).all()
|
commissions = Commission.query.filter_by(active=True).all()
|
||||||
|
|
||||||
# Populate form choices
|
# Populate form choices
|
||||||
form.classroom_id.choices = [(c.id, f'{c.building_name} - {c.code} (Cap: {c.capacity_display})') for c in classrooms]
|
form.classroom_id.choices = [(c.id, f'{c.code_display} - {c.name} (Cap: {c.capacity})') for c in classrooms]
|
||||||
form.commission_id.choices = [(c.id, f'{c.get_full_code()} - {c.subject.name if c.subject else "No Subject"} (Students: {c.max_students})') for c in commissions]
|
form.commission_id.choices = [(c.id, f'{c.get_full_code()} - {c.subject.name if c.subject else "No Subject"} (Students: {c.max_students})') for c in commissions]
|
||||||
|
|
||||||
if request.method == 'POST':
|
if request.method == 'POST':
|
||||||
if form.validate_on_submit():
|
if form.validate_on_submit():
|
||||||
try:
|
try:
|
||||||
# Check for existing reservations at the same time
|
# Check for existing reservations at the same time
|
||||||
from app.models.reservation import ReservationStatus
|
from app.models.reservation import ReservationStatus
|
||||||
existing_reservation = Reservation.query.filter_by(
|
existing_reservation = Reservation.query.filter_by(
|
||||||
classroom_id=form.classroom_id.data,
|
classroom_id=form.classroom_id.data,
|
||||||
@@ -521,7 +205,7 @@ def add_reservation():
|
|||||||
|
|
||||||
if existing_reservation:
|
if existing_reservation:
|
||||||
flash('This classroom is already booked for the selected time slot.', 'danger')
|
flash('This classroom is already booked for the selected time slot.', 'danger')
|
||||||
return render_template('schedule/add.html', form=form, title='New Reservation', classroom_list=classrooms, commission_list=commissions, buildings=buildings)
|
return render_template('schedule/add.html', form=form, title='New Reservation', classroom_list=classrooms, commission_list=commissions)
|
||||||
|
|
||||||
# Create new reservation
|
# Create new reservation
|
||||||
reservation = Reservation(
|
reservation = Reservation(
|
||||||
@@ -532,7 +216,6 @@ def add_reservation():
|
|||||||
end_time=form.end_time.data,
|
end_time=form.end_time.data,
|
||||||
purpose=form.purpose.data,
|
purpose=form.purpose.data,
|
||||||
notes=form.notes.data,
|
notes=form.notes.data,
|
||||||
virtual_link=form.virtual_link.data.strip() if form.virtual_link.data else None,
|
|
||||||
status=ReservationStatus.PENDING.value,
|
status=ReservationStatus.PENDING.value,
|
||||||
expected_attendees=form.expected_attendees.data
|
expected_attendees=form.expected_attendees.data
|
||||||
)
|
)
|
||||||
@@ -545,53 +228,10 @@ def add_reservation():
|
|||||||
|
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
db.session.rollback()
|
db.session.rollback()
|
||||||
|
current_app.logger.error(f"Error creating reservation: {str(e)}")
|
||||||
flash(f'Error creating reservation: {str(e)}', 'danger')
|
flash(f'Error creating reservation: {str(e)}', 'danger')
|
||||||
|
|
||||||
return render_template('schedule/add.html', form=form, title='New Reservation', classroom_list=classrooms, commission_list=commissions, buildings=buildings)
|
return render_template('schedule/add.html', form=form, title='New Reservation', classroom_list=classrooms, commission_list=commissions)
|
||||||
|
|
||||||
@schedule_bp.route('/reservation/add', methods=['POST'])
|
|
||||||
@login_required
|
|
||||||
def quick_reservation_add():
|
|
||||||
"""Endpoint AJAX para crear reserva rápida desde el modal de comisiones"""
|
|
||||||
try:
|
|
||||||
commission_id = request.form.get('commission_id', type=int)
|
|
||||||
classroom_id = request.form.get('classroom_id', type=int)
|
|
||||||
purpose = request.form.get('purpose', '').strip() or 'Clase de cursada'
|
|
||||||
start_str = request.form.get('start_time', '').strip()
|
|
||||||
end_str = request.form.get('end_time', '').strip()
|
|
||||||
virtual_link = request.form.get('virtual_link', '').strip() or None
|
|
||||||
|
|
||||||
if not commission_id or not classroom_id or not start_str or not end_str:
|
|
||||||
return jsonify({'error': 'Faltan campos obligatorios'}), 400
|
|
||||||
|
|
||||||
start_time = datetime.strptime(start_str, '%Y-%m-%d %H:%M')
|
|
||||||
end_time = datetime.strptime(end_str, '%Y-%m-%d %H:%M')
|
|
||||||
|
|
||||||
from app.models.subject import Commission
|
|
||||||
from app.models.classroom import Classroom
|
|
||||||
comm = Commission.query.get_or_404(commission_id)
|
|
||||||
|
|
||||||
if not virtual_link and comm.virtual_link:
|
|
||||||
virtual_link = comm.virtual_link
|
|
||||||
|
|
||||||
new_res = Reservation(
|
|
||||||
classroom_id=classroom_id,
|
|
||||||
commission_id=commission_id,
|
|
||||||
user_id=comm.teacher_id or current_user.id,
|
|
||||||
start_time=start_time,
|
|
||||||
end_time=end_time,
|
|
||||||
purpose=purpose,
|
|
||||||
expected_attendees=comm.max_students or 30,
|
|
||||||
shift=comm.shift or 'Tarde',
|
|
||||||
virtual_link=virtual_link,
|
|
||||||
status=ReservationStatus.CONFIRMED.value if current_user.is_admin() else ReservationStatus.PENDING.value
|
|
||||||
)
|
|
||||||
db.session.add(new_res)
|
|
||||||
db.session.commit()
|
|
||||||
return jsonify({'success': True, 'id': new_res.id})
|
|
||||||
except Exception as e:
|
|
||||||
db.session.rollback()
|
|
||||||
return jsonify({'error': str(e)}), 500
|
|
||||||
|
|
||||||
@schedule_bp.route('/list')
|
@schedule_bp.route('/list')
|
||||||
@login_required
|
@login_required
|
||||||
@@ -604,7 +244,6 @@ def list_reservations():
|
|||||||
hide_virtual = request.args.get('hide_virtual', '0') in ['1', 'true', 'True']
|
hide_virtual = request.args.get('hide_virtual', '0') in ['1', 'true', 'True']
|
||||||
floor_filter = request.args.get('floor', '').strip()
|
floor_filter = request.args.get('floor', '').strip()
|
||||||
shift_filter = request.args.get('shift', '').strip()
|
shift_filter = request.args.get('shift', '').strip()
|
||||||
classroom_id = request.args.get('classroom_id', type=int)
|
|
||||||
search = request.args.get('search', '').strip()
|
search = request.args.get('search', '').strip()
|
||||||
|
|
||||||
query = Reservation.query.options(
|
query = Reservation.query.options(
|
||||||
@@ -613,9 +252,6 @@ def list_reservations():
|
|||||||
joinedload(Reservation.user)
|
joinedload(Reservation.user)
|
||||||
).join(Reservation.classroom).outerjoin(Reservation.commission).outerjoin(Commission.subject)
|
).join(Reservation.classroom).outerjoin(Reservation.commission).outerjoin(Commission.subject)
|
||||||
|
|
||||||
if classroom_id:
|
|
||||||
query = query.filter(Reservation.classroom_id == classroom_id)
|
|
||||||
|
|
||||||
if status_filter and status_filter != 'all':
|
if status_filter and status_filter != 'all':
|
||||||
query = query.filter(Reservation.status == status_filter.upper())
|
query = query.filter(Reservation.status == status_filter.upper())
|
||||||
|
|
||||||
@@ -639,12 +275,8 @@ def list_reservations():
|
|||||||
~Classroom.building.ilike('%Virtual%')
|
~Classroom.building.ilike('%Virtual%')
|
||||||
)
|
)
|
||||||
|
|
||||||
if floor_filter:
|
if floor_filter and floor_filter.isdigit():
|
||||||
flr = str(floor_filter).strip()
|
query = query.filter(Classroom.floor == int(floor_filter))
|
||||||
if flr.upper() in ['0', 'PB', 'PLANTA BAJA']:
|
|
||||||
query = query.filter(or_(Classroom.floor == '0', Classroom.floor.ilike('%PB%'), Classroom.floor.ilike('%Planta Baja%')))
|
|
||||||
else:
|
|
||||||
query = query.filter(Classroom.floor == flr)
|
|
||||||
|
|
||||||
if shift_filter:
|
if shift_filter:
|
||||||
query = query.filter(Reservation.shift.ilike(f'%{shift_filter}%'))
|
query = query.filter(Reservation.shift.ilike(f'%{shift_filter}%'))
|
||||||
@@ -654,10 +286,8 @@ def list_reservations():
|
|||||||
or_(
|
or_(
|
||||||
Subject.name.ilike(f'%{search}%'),
|
Subject.name.ilike(f'%{search}%'),
|
||||||
Subject.code.ilike(f'%{search}%'),
|
Subject.code.ilike(f'%{search}%'),
|
||||||
Commission.code.ilike(f'%{search}%'),
|
|
||||||
Classroom.code.ilike(f'%{search}%'),
|
Classroom.code.ilike(f'%{search}%'),
|
||||||
Reservation.purpose.ilike(f'%{search}%'),
|
Reservation.purpose.ilike(f'%{search}%')
|
||||||
Reservation.shift.ilike(f'%{search}%')
|
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
|
|
||||||
@@ -667,7 +297,6 @@ def list_reservations():
|
|||||||
|
|
||||||
floors = db.session.query(Classroom.floor).filter(Classroom.is_active==True, Classroom.floor.isnot(None)).distinct().order_by(Classroom.floor.asc()).all()
|
floors = db.session.query(Classroom.floor).filter(Classroom.is_active==True, Classroom.floor.isnot(None)).distinct().order_by(Classroom.floor.asc()).all()
|
||||||
available_floors = [f[0] for f in floors]
|
available_floors = [f[0] for f in floors]
|
||||||
all_classrooms = Classroom.query.filter_by(is_active=True).order_by(Classroom.building_id.asc(), Classroom.floor.asc(), Classroom.code.asc()).all()
|
|
||||||
|
|
||||||
return render_template(
|
return render_template(
|
||||||
'schedule/list.html',
|
'schedule/list.html',
|
||||||
@@ -678,8 +307,6 @@ def list_reservations():
|
|||||||
hide_virtual=hide_virtual,
|
hide_virtual=hide_virtual,
|
||||||
floor_filter=floor_filter,
|
floor_filter=floor_filter,
|
||||||
shift_filter=shift_filter,
|
shift_filter=shift_filter,
|
||||||
classroom_id=classroom_id,
|
|
||||||
all_classrooms=all_classrooms,
|
|
||||||
search=search,
|
search=search,
|
||||||
available_floors=available_floors
|
available_floors=available_floors
|
||||||
)
|
)
|
||||||
@@ -816,6 +443,7 @@ def calendar_data():
|
|||||||
search = request.args.get('search', '').strip()
|
search = request.args.get('search', '').strip()
|
||||||
|
|
||||||
if start and end:
|
if start and end:
|
||||||
|
from datetime import datetime
|
||||||
# Clean up ISO timezone strings for PostgreSQL naive timestamp comparison
|
# Clean up ISO timezone strings for PostgreSQL naive timestamp comparison
|
||||||
start_clean = start.replace('Z', '+00:00')
|
start_clean = start.replace('Z', '+00:00')
|
||||||
end_clean = end.replace('Z', '+00:00')
|
end_clean = end.replace('Z', '+00:00')
|
||||||
@@ -844,16 +472,6 @@ def calendar_data():
|
|||||||
if career_id and career_id.isdigit():
|
if career_id and career_id.isdigit():
|
||||||
query = query.filter(Subject.career_id == int(career_id))
|
query = query.filter(Subject.career_id == int(career_id))
|
||||||
|
|
||||||
building = request.args.get('building', '').strip()
|
|
||||||
if building:
|
|
||||||
from app.models.building import Building
|
|
||||||
query = query.filter(
|
|
||||||
or_(
|
|
||||||
Classroom.building.ilike(f'%{building}%'),
|
|
||||||
Classroom.building_entity.has(Building.name.ilike(f'%{building}%'))
|
|
||||||
)
|
|
||||||
)
|
|
||||||
|
|
||||||
if shift:
|
if shift:
|
||||||
query = query.filter(Reservation.shift.ilike(f'%{shift}%'))
|
query = query.filter(Reservation.shift.ilike(f'%{shift}%'))
|
||||||
|
|
||||||
@@ -863,12 +481,8 @@ def calendar_data():
|
|||||||
~Classroom.building.ilike('%Virtual%')
|
~Classroom.building.ilike('%Virtual%')
|
||||||
)
|
)
|
||||||
|
|
||||||
if floor:
|
if floor and floor.isdigit():
|
||||||
flr = str(floor).strip()
|
query = query.filter(Classroom.floor == int(floor))
|
||||||
if flr.upper() in ['0', 'PB', 'PLANTA BAJA']:
|
|
||||||
query = query.filter(or_(Classroom.floor == '0', Classroom.floor.ilike('%PB%'), Classroom.floor.ilike('%Planta Baja%')))
|
|
||||||
else:
|
|
||||||
query = query.filter(Classroom.floor == flr)
|
|
||||||
|
|
||||||
if search:
|
if search:
|
||||||
query = query.filter(
|
query = query.filter(
|
||||||
@@ -888,9 +502,8 @@ def calendar_data():
|
|||||||
subject_code = subject.code if subject else (reservation.commission.code if reservation.commission else '')
|
subject_code = subject.code if subject else (reservation.commission.code if reservation.commission else '')
|
||||||
subject_name = subject.name if subject else (reservation.purpose or 'Clase')
|
subject_name = subject.name if subject else (reservation.purpose or 'Clase')
|
||||||
classroom_name = reservation.classroom.code if reservation.classroom else 'Sin Aula'
|
classroom_name = reservation.classroom.code if reservation.classroom else 'Sin Aula'
|
||||||
classroom_floor = reservation.classroom.floor_display if reservation.classroom else None
|
classroom_floor = reservation.classroom.floor if reservation.classroom else None
|
||||||
classroom_building = reservation.classroom.building_name if reservation.classroom else ''
|
is_virtual = bool(reservation.classroom and ('VIRTUAL' in (reservation.classroom.code or '').upper() or 'VIRTUAL' in (reservation.classroom.building or '').upper()))
|
||||||
is_virtual = bool(reservation.classroom and reservation.classroom.is_virtual)
|
|
||||||
career_name = subject.career_obj.name if (subject and subject.career_obj) else (subject.department if subject else '')
|
career_name = subject.career_obj.name if (subject and subject.career_obj) else (subject.department if subject else '')
|
||||||
status_val = str(reservation.status.value if hasattr(reservation.status, 'value') else reservation.status)
|
status_val = str(reservation.status.value if hasattr(reservation.status, 'value') else reservation.status)
|
||||||
|
|
||||||
@@ -905,20 +518,16 @@ def calendar_data():
|
|||||||
'subject_code': subject_code,
|
'subject_code': subject_code,
|
||||||
'subject_name': subject_name,
|
'subject_name': subject_name,
|
||||||
'classroom': classroom_name,
|
'classroom': classroom_name,
|
||||||
'building': classroom_building,
|
'building': reservation.classroom.building if reservation.classroom else '',
|
||||||
'floor': classroom_floor,
|
'floor': classroom_floor,
|
||||||
'is_virtual': is_virtual,
|
'is_virtual': is_virtual,
|
||||||
'location_display': reservation.classroom.location_display if reservation.classroom else '',
|
|
||||||
'career': career_name,
|
'career': career_name,
|
||||||
'commission': reservation.commission.code if reservation.commission else '',
|
'commission': reservation.commission.code if reservation.commission else '',
|
||||||
'shift': reservation.shift or '',
|
'shift': reservation.shift or '',
|
||||||
'status': status_val,
|
'status': status_val,
|
||||||
'purpose': reservation.purpose or '',
|
'purpose': reservation.purpose or '',
|
||||||
'attendees': reservation.expected_attendees or 0,
|
'attendees': reservation.expected_attendees or 0,
|
||||||
'notes': reservation.notes or '',
|
'notes': reservation.notes or ''
|
||||||
'teacher': reservation.user.name if reservation.user else '',
|
|
||||||
'virtual_link': reservation.effective_virtual_link,
|
|
||||||
'cancel_url': url_for('schedule.cancel_reservation', id=reservation.id)
|
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
from .sheets_importer import GoogleSheetsImporter
|
||||||
|
|
||||||
|
__all__ = ['GoogleSheetsImporter']
|
||||||
@@ -0,0 +1,413 @@
|
|||||||
|
import urllib.request
|
||||||
|
import csv
|
||||||
|
import io
|
||||||
|
import re
|
||||||
|
from datetime import datetime, date, time, timedelta
|
||||||
|
from app import db
|
||||||
|
from app.models.classroom import Classroom
|
||||||
|
from app.models.career import Career
|
||||||
|
from app.models.subject import Subject, Commission
|
||||||
|
from app.models.reservation import Reservation, ReservationStatus
|
||||||
|
from app.models.user import User
|
||||||
|
|
||||||
|
BASE_CSV_URL = 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv'
|
||||||
|
|
||||||
|
SHEETS_CONFIG = [
|
||||||
|
{ 'name': 'Lunes', 'gid': '1915752353', 'day_idx': 0 },
|
||||||
|
{ 'name': 'Martes', 'gid': '466778263', 'day_idx': 1 },
|
||||||
|
{ 'name': 'Miércoles', 'gid': '615483345', 'day_idx': 2 },
|
||||||
|
{ 'name': 'Jueves', 'gid': '682416571', 'day_idx': 3 },
|
||||||
|
{ 'name': 'Viernes', 'gid': '1162906711', 'day_idx': 4 },
|
||||||
|
{ 'name': 'Sábado', 'gid': '752305601', 'day_idx': 5 },
|
||||||
|
]
|
||||||
|
|
||||||
|
TIME_REGEX = re.compile(r'(\d{1,2})(?::(\d{2}))?\s*(?:a|-|to)\s*(\d{1,2})(?::(\d{2}))?', re.IGNORECASE)
|
||||||
|
|
||||||
|
class GoogleSheetsImporter:
|
||||||
|
"""
|
||||||
|
Service to fetch, parse, and synchronize academic schedules,
|
||||||
|
classrooms, careers, and subjects from the official UniCABA Google Sheet.
|
||||||
|
"""
|
||||||
|
|
||||||
|
def __init__(self, base_url=None):
|
||||||
|
self.base_url = base_url or BASE_CSV_URL
|
||||||
|
|
||||||
|
def fetch_sheet_csv(self, gid):
|
||||||
|
"""Fetch CSV string for a specific sheet gid"""
|
||||||
|
url = f"{self.base_url}&gid={gid}"
|
||||||
|
req = urllib.request.Request(
|
||||||
|
url,
|
||||||
|
headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) EduSpace/2.0'}
|
||||||
|
)
|
||||||
|
with urllib.request.urlopen(req, timeout=15) as resp:
|
||||||
|
return resp.read().decode('utf-8', errors='replace')
|
||||||
|
|
||||||
|
def parse_sheet_rows(self, csv_content, sheet_name):
|
||||||
|
"""Parse raw CSV text into a structured list of class records"""
|
||||||
|
reader = csv.reader(io.StringIO(csv_content))
|
||||||
|
rows = list(reader)
|
||||||
|
|
||||||
|
header_idx = -1
|
||||||
|
col_offset = 0
|
||||||
|
|
||||||
|
for r_idx, row in enumerate(rows):
|
||||||
|
for c_idx, cell in enumerate(row):
|
||||||
|
cell_clean = cell.lower().strip()
|
||||||
|
if 'codigo' in cell_clean or 'código' in cell_clean:
|
||||||
|
header_idx = r_idx
|
||||||
|
col_offset = c_idx
|
||||||
|
break
|
||||||
|
if header_idx != -1:
|
||||||
|
break
|
||||||
|
|
||||||
|
if header_idx == -1:
|
||||||
|
return []
|
||||||
|
|
||||||
|
records = []
|
||||||
|
current_shift = 'Mañana'
|
||||||
|
for row in rows[header_idx + 1:]:
|
||||||
|
if len(row) >= col_offset + 5:
|
||||||
|
raw_cell = row[col_offset].strip().replace('\n', ' - ')
|
||||||
|
row_full_text = ' '.join(row).upper()
|
||||||
|
|
||||||
|
# Detect shift delimiters
|
||||||
|
if 'TURNO MAÑANA' in row_full_text or 'TURNO MANANA' in row_full_text:
|
||||||
|
current_shift = 'Mañana'
|
||||||
|
continue
|
||||||
|
elif 'TURNO VESPERTINO' in row_full_text or 'TURNO TARDE' in row_full_text or 'TURNO NOCHE' in row_full_text:
|
||||||
|
current_shift = 'Tarde'
|
||||||
|
continue
|
||||||
|
elif raw_cell.lower().startswith('turno'):
|
||||||
|
if 'mañ' in raw_cell.lower() or 'man' in raw_cell.lower():
|
||||||
|
current_shift = 'Mañana'
|
||||||
|
else:
|
||||||
|
current_shift = 'Tarde'
|
||||||
|
continue
|
||||||
|
|
||||||
|
codigo = raw_cell
|
||||||
|
asignatura = row[col_offset + 1].strip().replace('\n', ' ')
|
||||||
|
aula = row[col_offset + 2].strip().replace('\n', ' ')
|
||||||
|
carrera = row[col_offset + 3].strip().replace('\n', ' ')
|
||||||
|
horario = row[col_offset + 4].strip().replace('\n', ' ')
|
||||||
|
|
||||||
|
# Check valid data row
|
||||||
|
if codigo and asignatura and not 'codigo' in codigo.lower():
|
||||||
|
# Double-check shift from start hour if possible
|
||||||
|
record_shift = current_shift
|
||||||
|
time_match = re.search(r'(\d{1,2}):(\d{2})', horario)
|
||||||
|
if time_match:
|
||||||
|
h = int(time_match.group(1))
|
||||||
|
if h >= 14:
|
||||||
|
record_shift = 'Tarde'
|
||||||
|
elif h < 13:
|
||||||
|
record_shift = 'Mañana'
|
||||||
|
|
||||||
|
records.append({
|
||||||
|
'dia': sheet_name,
|
||||||
|
'codigo': codigo,
|
||||||
|
'asignatura': asignatura,
|
||||||
|
'aula': aula,
|
||||||
|
'carrera': carrera,
|
||||||
|
'horario': horario,
|
||||||
|
'turno': record_shift
|
||||||
|
})
|
||||||
|
return records
|
||||||
|
|
||||||
|
def normalize_room(self, aula_raw):
|
||||||
|
"""
|
||||||
|
Normalize room string into (building, room_number, floor, capacity)
|
||||||
|
"""
|
||||||
|
aula_upper = aula_raw.upper().strip()
|
||||||
|
if not aula_upper or any(x in aula_upper for x in ['FERIADO', 'SIN ACTIVIDAD', 'CONSULTAR EN BEDELIA']):
|
||||||
|
return None
|
||||||
|
|
||||||
|
if 'VIRTUAL' in aula_upper:
|
||||||
|
return {
|
||||||
|
'building': 'Campus Virtual',
|
||||||
|
'code': 'VIRTUAL',
|
||||||
|
'floor': 0,
|
||||||
|
'capacity': 0,
|
||||||
|
'description': 'Espacio áulico virtual UniCABA (Capacidad Ilimitada ∞)'
|
||||||
|
}
|
||||||
|
|
||||||
|
if 'AUDITORIO' in aula_upper:
|
||||||
|
return {
|
||||||
|
'building': 'Edificio Central',
|
||||||
|
'code': 'Auditorio',
|
||||||
|
'floor': 0,
|
||||||
|
'capacity': 150,
|
||||||
|
'description': 'Auditorio principal UniCABA'
|
||||||
|
}
|
||||||
|
|
||||||
|
if 'SALA DE REUNI' in aula_upper:
|
||||||
|
floor = 2 if ('2DO' in aula_upper or '2°' in aula_upper) else 4
|
||||||
|
return {
|
||||||
|
'building': 'Edificio Central',
|
||||||
|
'code': f'Sala Reunión {floor}°P',
|
||||||
|
'floor': floor,
|
||||||
|
'capacity': 15,
|
||||||
|
'description': f'Sala de reunión piso {floor}'
|
||||||
|
}
|
||||||
|
|
||||||
|
# Standard classrooms: "Aula 402", "AULA 203", "306 - 406"
|
||||||
|
num_match = re.search(r'\d+', aula_raw)
|
||||||
|
if num_match:
|
||||||
|
num = num_match.group(0)
|
||||||
|
floor = int(num[0]) if len(num) >= 3 else 1
|
||||||
|
return {
|
||||||
|
'building': 'Edificio Central',
|
||||||
|
'code': f'Aula {num}',
|
||||||
|
'floor': floor,
|
||||||
|
'capacity': 35,
|
||||||
|
'description': f'Aula física {num} - Piso {floor}'
|
||||||
|
}
|
||||||
|
|
||||||
|
# Generic fallback
|
||||||
|
return {
|
||||||
|
'building': 'Edificio Central',
|
||||||
|
'code': aula_raw,
|
||||||
|
'floor': 1,
|
||||||
|
'capacity': 30,
|
||||||
|
'description': aula_raw
|
||||||
|
}
|
||||||
|
|
||||||
|
def parse_time_range(self, horario_str):
|
||||||
|
"""Parse '8:00 a 9:00hs' into (time(8, 0), time(9, 0))"""
|
||||||
|
m = TIME_REGEX.search(horario_str)
|
||||||
|
if not m:
|
||||||
|
return None, None
|
||||||
|
try:
|
||||||
|
h1 = int(m.group(1))
|
||||||
|
m1 = int(m.group(2) or 0)
|
||||||
|
h2 = int(m.group(3))
|
||||||
|
m2 = int(m.group(4) or 0)
|
||||||
|
return time(h1, m1), time(h2, m2)
|
||||||
|
except Exception:
|
||||||
|
return None, None
|
||||||
|
|
||||||
|
def sync(self):
|
||||||
|
"""
|
||||||
|
Main synchronization process:
|
||||||
|
1. Fetches all 6 day sheets.
|
||||||
|
2. Upserts Careers, Classrooms, Subjects, Commissions.
|
||||||
|
3. Generates Reservations in the calendar for the semester.
|
||||||
|
"""
|
||||||
|
stats = {
|
||||||
|
'total_rows_processed': 0,
|
||||||
|
'careers_created': 0,
|
||||||
|
'careers_updated': 0,
|
||||||
|
'classrooms_created': 0,
|
||||||
|
'classrooms_updated': 0,
|
||||||
|
'subjects_created': 0,
|
||||||
|
'subjects_updated': 0,
|
||||||
|
'commissions_created': 0,
|
||||||
|
'reservations_created': 0,
|
||||||
|
'errors': [],
|
||||||
|
'sample_records': []
|
||||||
|
}
|
||||||
|
|
||||||
|
all_raw_records = []
|
||||||
|
for sheet_cfg in SHEETS_CONFIG:
|
||||||
|
try:
|
||||||
|
csv_data = self.fetch_sheet_csv(sheet_cfg['gid'])
|
||||||
|
rows = self.parse_sheet_rows(csv_data, sheet_cfg['name'])
|
||||||
|
all_raw_records.extend([(r, sheet_cfg['day_idx']) for r in rows])
|
||||||
|
except Exception as e:
|
||||||
|
stats['errors'].append(f"Error al descargar o procesar la hoja de {sheet_cfg['name']}: {str(e)}")
|
||||||
|
|
||||||
|
stats['total_rows_processed'] = len(all_raw_records)
|
||||||
|
if not all_raw_records:
|
||||||
|
return stats
|
||||||
|
|
||||||
|
# Default admin user for reservations
|
||||||
|
default_user = User.query.filter_by(role='ADMIN').first() or User.query.first()
|
||||||
|
default_user_id = default_user.id if default_user else 1
|
||||||
|
|
||||||
|
# Ensure institutional buildings exist with official address
|
||||||
|
from app.models.building import Building
|
||||||
|
b_central = Building.query.filter_by(name='Edificio Central').first()
|
||||||
|
if not b_central:
|
||||||
|
b_central = Building(
|
||||||
|
name='Edificio Central',
|
||||||
|
code='CENTRAL',
|
||||||
|
address='Tte. Gral. Juan Domingo Perón 802, CABA',
|
||||||
|
floors=4,
|
||||||
|
description='Sede central institucional de UniCABA. Aulas de grado, auditorio y laboratorios.'
|
||||||
|
)
|
||||||
|
db.session.add(b_central)
|
||||||
|
db.session.flush()
|
||||||
|
else:
|
||||||
|
b_central.address = 'Tte. Gral. Juan Domingo Perón 802, CABA'
|
||||||
|
|
||||||
|
b_virtual = Building.query.filter_by(name='Campus Virtual').first()
|
||||||
|
if not b_virtual:
|
||||||
|
b_virtual = Building(
|
||||||
|
name='Campus Virtual',
|
||||||
|
code='VIRTUAL',
|
||||||
|
address='Entorno Digital / Microsoft Teams - Moodle',
|
||||||
|
floors=0,
|
||||||
|
description='Entorno de aulas virtuales y clases a distancia'
|
||||||
|
)
|
||||||
|
db.session.add(b_virtual)
|
||||||
|
db.session.flush()
|
||||||
|
|
||||||
|
buildings_cache = {b.name.strip().upper(): b for b in Building.query.all()}
|
||||||
|
careers_cache = {c.name.strip().upper(): c for c in Career.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()}
|
||||||
|
|
||||||
|
# Calculate current semester dates (anchored on academic year 2026)
|
||||||
|
# Week starting Monday 2026-08-31 to Saturday 2026-09-05
|
||||||
|
base_monday = date(2026, 8, 31)
|
||||||
|
weeks_to_generate = 4 # Generate reservations for 4 consecutive weeks
|
||||||
|
|
||||||
|
for rec, day_idx in all_raw_records:
|
||||||
|
try:
|
||||||
|
codigo = rec['codigo']
|
||||||
|
asignatura = rec['asignatura']
|
||||||
|
aula_raw = rec['aula']
|
||||||
|
carrera_name = rec['carrera'].strip()
|
||||||
|
horario_raw = rec['horario']
|
||||||
|
dia = rec['dia']
|
||||||
|
turno = rec.get('turno', 'Mañana')
|
||||||
|
|
||||||
|
# 1. Upsert Career
|
||||||
|
carrera_key = carrera_name.upper()
|
||||||
|
career = careers_cache.get(carrera_key)
|
||||||
|
if not career:
|
||||||
|
career = Career(name=carrera_name)
|
||||||
|
db.session.add(career)
|
||||||
|
db.session.flush()
|
||||||
|
careers_cache[carrera_key] = career
|
||||||
|
stats['careers_created'] += 1
|
||||||
|
|
||||||
|
# 2. Upsert Classroom
|
||||||
|
room_info = self.normalize_room(aula_raw)
|
||||||
|
classroom = None
|
||||||
|
if room_info:
|
||||||
|
room_key = (room_info['building'].upper(), room_info['code'].upper())
|
||||||
|
classroom = classrooms_cache.get(room_key)
|
||||||
|
b_entity = buildings_cache.get(room_info['building'].upper())
|
||||||
|
if not classroom:
|
||||||
|
classroom = Classroom(
|
||||||
|
building=room_info['building'],
|
||||||
|
building_id=b_entity.id if b_entity else None,
|
||||||
|
floor=room_info['floor'],
|
||||||
|
capacity=room_info['capacity'],
|
||||||
|
description=room_info['description'],
|
||||||
|
is_active=True
|
||||||
|
)
|
||||||
|
classroom.code = room_info['code']
|
||||||
|
db.session.add(classroom)
|
||||||
|
db.session.flush()
|
||||||
|
classrooms_cache[room_key] = classroom
|
||||||
|
stats['classrooms_created'] += 1
|
||||||
|
else:
|
||||||
|
classroom.capacity = max(classroom.capacity, room_info['capacity'])
|
||||||
|
if not classroom.building_id and b_entity:
|
||||||
|
classroom.building_id = b_entity.id
|
||||||
|
|
||||||
|
# 3. Upsert Subject
|
||||||
|
subject_key = codigo.upper()
|
||||||
|
subject = subjects_cache.get(subject_key)
|
||||||
|
if not subject:
|
||||||
|
subject = Subject(
|
||||||
|
code=codigo,
|
||||||
|
name=asignatura,
|
||||||
|
career_id=career.id,
|
||||||
|
department=career.name,
|
||||||
|
credits=4,
|
||||||
|
is_active=True
|
||||||
|
)
|
||||||
|
db.session.add(subject)
|
||||||
|
db.session.flush()
|
||||||
|
subjects_cache[subject_key] = subject
|
||||||
|
stats['subjects_created'] += 1
|
||||||
|
else:
|
||||||
|
if subject.name != asignatura:
|
||||||
|
subject.name = asignatura
|
||||||
|
stats['subjects_updated'] += 1
|
||||||
|
subject.career_id = career.id
|
||||||
|
subject.department = career.name
|
||||||
|
|
||||||
|
# 4. Upsert Commission
|
||||||
|
# Identify commission subcode e.g. from code suffix or default 'C1'
|
||||||
|
comm_code = 'C1'
|
||||||
|
if '-E' in codigo:
|
||||||
|
comm_code = codigo.split('-')[-1]
|
||||||
|
|
||||||
|
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,
|
||||||
|
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:
|
||||||
|
commission.schedule = f"{dia} {horario_raw}"
|
||||||
|
commission.shift = turno
|
||||||
|
|
||||||
|
# 5. Generate Calendar Reservations
|
||||||
|
t_start, t_end = self.parse_time_range(horario_raw)
|
||||||
|
if classroom and t_start and t_end and day_idx is not None:
|
||||||
|
for w in range(weeks_to_generate):
|
||||||
|
class_date = base_monday + timedelta(days=day_idx, weeks=w)
|
||||||
|
dt_start = datetime.combine(class_date, t_start)
|
||||||
|
dt_end = datetime.combine(class_date, t_end)
|
||||||
|
|
||||||
|
existing_res = Reservation.query.filter_by(
|
||||||
|
classroom_id=classroom.id,
|
||||||
|
start_time=dt_start,
|
||||||
|
end_time=dt_end
|
||||||
|
).first()
|
||||||
|
|
||||||
|
if not existing_res:
|
||||||
|
res = Reservation(
|
||||||
|
classroom_id=classroom.id,
|
||||||
|
commission_id=commission.id,
|
||||||
|
user_id=default_user_id,
|
||||||
|
start_time=dt_start,
|
||||||
|
end_time=dt_end,
|
||||||
|
purpose=f"{subject.code} - {subject.name}",
|
||||||
|
status='CONFIRMED',
|
||||||
|
expected_attendees=min(classroom.capacity, 30),
|
||||||
|
shift=turno,
|
||||||
|
notes=f"Clase semanal {dia} ({turno}) - Carrera: {career.name}"
|
||||||
|
)
|
||||||
|
db.session.add(res)
|
||||||
|
stats['reservations_created'] += 1
|
||||||
|
else:
|
||||||
|
existing_res.shift = turno
|
||||||
|
existing_res.notes = f"Clase semanal {dia} ({turno}) - Carrera: {career.name}"
|
||||||
|
|
||||||
|
if len(stats['sample_records']) < 10:
|
||||||
|
stats['sample_records'].append({
|
||||||
|
'dia': dia,
|
||||||
|
'codigo': codigo,
|
||||||
|
'asignatura': asignatura,
|
||||||
|
'carrera': career.name,
|
||||||
|
'aula': classroom.code_display if classroom else aula_raw,
|
||||||
|
'horario': horario_raw
|
||||||
|
})
|
||||||
|
|
||||||
|
except Exception as row_err:
|
||||||
|
stats['errors'].append(f"Error en fila '{rec.get('codigo', '?')}': {str(row_err)}")
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
return stats
|
||||||
@@ -0,0 +1,177 @@
|
|||||||
|
/* Custom Enhancements for Edu-Space Admin */
|
||||||
|
|
||||||
|
/* Card Styles */
|
||||||
|
.card {
|
||||||
|
border-radius: 14px;
|
||||||
|
transition: transform 0.2s ease-in-out, box-shadow 0.2s ease-in-out, border-color 0.2s ease-in-out;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card:hover {
|
||||||
|
transform: translateY(-2px);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Navigation */
|
||||||
|
.navbar {
|
||||||
|
backdrop-filter: blur(12px);
|
||||||
|
-webkit-backdrop-filter: blur(12px);
|
||||||
|
}
|
||||||
|
|
||||||
|
.navbar-brand {
|
||||||
|
font-weight: 700;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Table Hover */
|
||||||
|
.table:hover tbody tr:hover {
|
||||||
|
background-color: rgba(var(--brand-primary-rgb), 0.04);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Status Badge Colors */
|
||||||
|
.bg-confirmed-custom {
|
||||||
|
background-color: #10B981;
|
||||||
|
color: #FFFFFF;
|
||||||
|
}
|
||||||
|
|
||||||
|
.bg-pending-custom {
|
||||||
|
background-color: #F59E0B;
|
||||||
|
color: #000000;
|
||||||
|
}
|
||||||
|
|
||||||
|
.bg-cancelled-custom {
|
||||||
|
background-color: #EF4444;
|
||||||
|
color: #FFFFFF;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Loading Spinner */
|
||||||
|
.loading-spinner {
|
||||||
|
display: inline-block;
|
||||||
|
width: 20px;
|
||||||
|
height: 20px;
|
||||||
|
border: 3px solid rgba(var(--brand-primary-rgb), 0.3);
|
||||||
|
border-radius: 50%;
|
||||||
|
border-top-color: var(--brand-primary);
|
||||||
|
animation: spin 1s ease-in-out infinite;
|
||||||
|
}
|
||||||
|
|
||||||
|
@keyframes spin {
|
||||||
|
to { transform: rotate(360deg); }
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Calendar Customizations */
|
||||||
|
.fc-event {
|
||||||
|
border-radius: 8px;
|
||||||
|
border: none !important;
|
||||||
|
padding: 4px 8px !important;
|
||||||
|
font-size: 12px !important;
|
||||||
|
margin: 1px 0 !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dashboard Stat Cards */
|
||||||
|
.stat-card {
|
||||||
|
background: var(--gradient-primary);
|
||||||
|
color: #FFFFFF;
|
||||||
|
border-radius: 14px;
|
||||||
|
box-shadow: 0 6px 20px rgba(var(--brand-primary-rgb), 0.2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.stat-card-primary { background: linear-gradient(135deg, #B43E8E 0%, #9E367D 100%); }
|
||||||
|
.stat-card-success { background: linear-gradient(135deg, #059669 0%, #10B981 100%); }
|
||||||
|
.stat-card-info { background: linear-gradient(135deg, #682CAD 0%, #8B5CF6 100%); }
|
||||||
|
.stat-card-warning { background: linear-gradient(135deg, #D97706 0%, #F59E0B 100%); }
|
||||||
|
|
||||||
|
/* Quick Action Buttons */
|
||||||
|
.quick-action-btn {
|
||||||
|
text-align: left;
|
||||||
|
padding: 12px 16px;
|
||||||
|
margin-bottom: 8px;
|
||||||
|
border-radius: 10px;
|
||||||
|
transition: all 0.2s ease-in-out;
|
||||||
|
}
|
||||||
|
|
||||||
|
.quick-action-btn:hover {
|
||||||
|
transform: translateX(4px);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Empty State Styles */
|
||||||
|
.empty-state {
|
||||||
|
text-align: center;
|
||||||
|
padding: 3rem 1rem;
|
||||||
|
color: var(--text-muted);
|
||||||
|
}
|
||||||
|
|
||||||
|
.empty-state i {
|
||||||
|
font-size: 4rem;
|
||||||
|
margin-bottom: 1rem;
|
||||||
|
opacity: 0.5;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Notification Toast enhancements */
|
||||||
|
.toast {
|
||||||
|
backdrop-filter: blur(10px);
|
||||||
|
border-radius: 12px;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Pagination Styles */
|
||||||
|
.pagination .page-link {
|
||||||
|
border-radius: 8px;
|
||||||
|
margin: 0 3px;
|
||||||
|
border: 1px solid var(--card-border);
|
||||||
|
background-color: var(--card-bg);
|
||||||
|
color: var(--text-primary);
|
||||||
|
}
|
||||||
|
|
||||||
|
.pagination .page-link:hover {
|
||||||
|
background-color: var(--brand-primary);
|
||||||
|
border-color: var(--brand-primary);
|
||||||
|
color: #FFFFFF;
|
||||||
|
}
|
||||||
|
|
||||||
|
.pagination .page-item.active .page-link {
|
||||||
|
background: var(--gradient-primary);
|
||||||
|
border-color: var(--brand-primary);
|
||||||
|
color: #FFFFFF;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Dashboard Stat Shortcuts */
|
||||||
|
.dashboard-stat-card {
|
||||||
|
transition: transform 0.2s ease, box-shadow 0.2s ease, border-color 0.2s ease;
|
||||||
|
cursor: pointer;
|
||||||
|
border: 1px solid rgba(0, 0, 0, 0.06) !important;
|
||||||
|
}
|
||||||
|
.dashboard-stat-card:hover {
|
||||||
|
transform: translateY(-3px);
|
||||||
|
box-shadow: 0 0.5rem 1.25rem rgba(0, 0, 0, 0.1) !important;
|
||||||
|
border-color: rgba(30, 77, 140, 0.3) !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Mobile Responsiveness */
|
||||||
|
@media (max-width: 768px) {
|
||||||
|
.card {
|
||||||
|
margin-bottom: 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn-group {
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
|
||||||
|
.btn-group .btn {
|
||||||
|
margin-bottom: 0.5rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Print Styles */
|
||||||
|
@media print {
|
||||||
|
.navbar, .btn, .pagination, .dropdown {
|
||||||
|
display: none !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
.card {
|
||||||
|
border: 1px solid #DDD !important;
|
||||||
|
box-shadow: none !important;
|
||||||
|
break-inside: avoid;
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
background-color: #FFFFFF !important;
|
||||||
|
color: #000000 !important;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -4,67 +4,56 @@
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
:root {
|
:root {
|
||||||
/* --- Brand Primary (Magenta / Frambuesa Oficial UniCABA) --- */
|
/* --- Brand Primary (Magenta / Uva) --- */
|
||||||
--brand-primary: #B43E8E;
|
--brand-primary: #B43E8E;
|
||||||
--brand-primary-rgb: 180, 62, 142;
|
--brand-primary-rgb: 180, 62, 142;
|
||||||
--brand-primary-shade: #9E2D77;
|
--brand-primary-shade: #9E367D;
|
||||||
--brand-primary-tint: #D63384;
|
--brand-primary-tint: #BC5199;
|
||||||
--brand-primary-contrast: #FFFFFF;
|
--brand-primary-contrast: #FFFFFF;
|
||||||
|
|
||||||
/* --- Accent Colors (Modo Claro) UniCABA: Rosas y Púrpuras Cálidos --- */
|
/* --- Accent Colors (Modo Claro) --- */
|
||||||
--accent-purple: #682CAD;
|
--accent-purple: #682CAD;
|
||||||
--accent-purple-rgb: 104, 44, 173;
|
--accent-purple-rgb: 104, 44, 173;
|
||||||
--secondary-magenta: #9E2D77;
|
--secondary-magenta: #7B2049;
|
||||||
--secondary-magenta-rgb: 158, 45, 119;
|
--secondary-magenta-rgb: 123, 32, 73;
|
||||||
--accent-pink-soft: #FDF2F8;
|
|
||||||
--accent-pink-border: #FBCFE8;
|
|
||||||
|
|
||||||
/* --- Global Surface & Text (Modo Claro - Rosas Suaves, Blanco Puro y Contraste Nitido) --- */
|
/* --- Global Surface & Text (Modo Claro) --- */
|
||||||
--app-bg: #FAF5F8;
|
--app-bg: #F8FAFC;
|
||||||
--card-bg: #FFFFFF;
|
--card-bg: #FFFFFF;
|
||||||
--card-border: rgba(180, 62, 142, 0.16);
|
--card-border: rgba(0, 0, 0, 0.08);
|
||||||
--card-hover-border: #B43E8E;
|
--card-hover-border: rgba(180, 62, 142, 0.3);
|
||||||
--card-shadow: 0 4px 18px rgba(180, 62, 142, 0.05), 0 1px 3px rgba(0, 0, 0, 0.02);
|
--card-shadow: 0 4px 20px rgba(0, 0, 0, 0.05);
|
||||||
--card-hover-shadow: 0 8px 24px rgba(180, 62, 142, 0.12);
|
--card-hover-shadow: 0 10px 25px rgba(180, 62, 142, 0.12);
|
||||||
|
|
||||||
--text-primary: #1E293B;
|
--text-primary: #1E293B;
|
||||||
--text-secondary: #475569;
|
--text-secondary: #64748B;
|
||||||
--text-muted: #64748B;
|
--text-muted: #94A3B8;
|
||||||
|
|
||||||
--navbar-bg: linear-gradient(135deg, #B43E8E 0%, #8E2B6E 100%);
|
--navbar-bg: linear-gradient(135deg, #B43E8E 0%, #9E367D 100%);
|
||||||
--navbar-text: #FFFFFF;
|
--navbar-text: #FFFFFF;
|
||||||
--navbar-border: transparent;
|
--navbar-border: transparent;
|
||||||
--navbar-shadow: 0 4px 18px rgba(180, 62, 142, 0.25);
|
--navbar-shadow: 0 4px 20px rgba(180, 62, 142, 0.25);
|
||||||
|
|
||||||
--input-bg: #FFFFFF;
|
--input-bg: #FFFFFF;
|
||||||
--input-border: #CBD5E1;
|
--input-border: #CBD5E1;
|
||||||
--input-text: #1E293B;
|
--input-text: #1E293B;
|
||||||
--input-focus-border: #B43E8E;
|
--input-focus-border: #B43E8E;
|
||||||
--input-focus-shadow: 0 0 0 0.2rem rgba(180, 62, 142, 0.22);
|
--input-focus-shadow: 0 0 0 0.2rem rgba(180, 62, 142, 0.25);
|
||||||
|
|
||||||
/* --- Distinctive Gradient UniCABA --- */
|
/* --- Distinctive Gradient --- */
|
||||||
--gradient-primary: linear-gradient(135deg, #B43E8E 0%, #9E2D77 100%);
|
--gradient-primary: linear-gradient(135deg, #B43E8E 0%, #9E367D 100%);
|
||||||
--gradient-primary-shadow: 0 6px 20px rgba(180, 62, 142, 0.28);
|
--gradient-primary-shadow: 0 8px 24px rgba(180, 62, 142, 0.25);
|
||||||
--gradient-hero: linear-gradient(135deg, rgba(180, 62, 142, 0.08) 0%, rgba(104, 44, 173, 0.06) 100%);
|
--gradient-hero: linear-gradient(135deg, rgba(180, 62, 142, 0.08) 0%, rgba(104, 44, 173, 0.12) 100%);
|
||||||
|
|
||||||
/* --- Badges (Modo Claro) --- */
|
/* --- Badges (Modo Claro) --- */
|
||||||
--badge-primary-bg: #B43E8E;
|
--badge-primary-bg: #B43E8E;
|
||||||
--badge-primary-text: #FFFFFF;
|
--badge-primary-text: #FFFFFF;
|
||||||
--badge-accent-bg: #682CAD;
|
--badge-accent-bg: #682CAD;
|
||||||
--badge-accent-text: #FFFFFF;
|
--badge-accent-text: #FFFFFF;
|
||||||
--badge-magenta-bg: #9E2D77;
|
--badge-magenta-bg: #7B2049;
|
||||||
--badge-magenta-text: #FFFFFF;
|
--badge-magenta-text: #FFFFFF;
|
||||||
}
|
}
|
||||||
|
|
||||||
[data-bs-theme="light"] {
|
|
||||||
--bs-body-bg: #FAF5F8;
|
|
||||||
--bs-body-color: #1E293B;
|
|
||||||
--bs-secondary-color: #475569;
|
|
||||||
--bs-tertiary-bg: #FDF2F8;
|
|
||||||
--bs-border-color: rgba(180, 62, 142, 0.18);
|
|
||||||
--bs-border-color-translucent: rgba(180, 62, 142, 0.12);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* =======================================================
|
/* =======================================================
|
||||||
MODO OSCURO ([data-bs-theme="dark"])
|
MODO OSCURO ([data-bs-theme="dark"])
|
||||||
======================================================= */
|
======================================================= */
|
||||||
@@ -153,20 +142,6 @@ body {
|
|||||||
transition: color 0.15s ease, transform 0.15s ease;
|
transition: color 0.15s ease, transform 0.15s ease;
|
||||||
border-radius: 8px;
|
border-radius: 8px;
|
||||||
padding: 0.5rem 0.85rem !important;
|
padding: 0.5rem 0.85rem !important;
|
||||||
white-space: nowrap;
|
|
||||||
}
|
|
||||||
|
|
||||||
@media (max-width: 1280px) and (min-width: 992px) {
|
|
||||||
.navbar-app {
|
|
||||||
padding: 0.5rem 0.75rem !important;
|
|
||||||
}
|
|
||||||
.navbar-app .nav-link {
|
|
||||||
padding: 0.4rem 0.5rem !important;
|
|
||||||
font-size: 0.85rem;
|
|
||||||
}
|
|
||||||
.navbar-app .navbar-brand span {
|
|
||||||
font-size: 0.95rem;
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
.navbar-app .nav-link:hover,
|
.navbar-app .nav-link:hover,
|
||||||
@@ -184,14 +159,18 @@ body {
|
|||||||
height: 32px;
|
height: 32px;
|
||||||
width: auto;
|
width: auto;
|
||||||
object-fit: contain;
|
object-fit: contain;
|
||||||
filter: none !important;
|
transition: filter 0.25s ease;
|
||||||
}
|
}
|
||||||
|
|
||||||
/* El isotipo de UniCABA se adapta a ambos modos sin alteraciones de color */
|
/* En Modo Claro el navbar es magenta (#B43E8E), aplicamos color blanco al isotipo */
|
||||||
[data-bs-theme="light"] .navbar-logo,
|
[data-bs-theme="light"] .navbar-logo,
|
||||||
:root:not([data-bs-theme="dark"]) .navbar-logo,
|
:root:not([data-bs-theme="dark"]) .navbar-logo {
|
||||||
|
filter: brightness(0) invert(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* En Modo Oscuro se mantiene el isotipo con su tono natural */
|
||||||
[data-bs-theme="dark"] .navbar-logo {
|
[data-bs-theme="dark"] .navbar-logo {
|
||||||
filter: none !important;
|
filter: none;
|
||||||
}
|
}
|
||||||
|
|
||||||
/* User Avatar Component */
|
/* User Avatar Component */
|
||||||
@@ -687,12 +666,3 @@ body {
|
|||||||
color: #E2E8F0;
|
color: #E2E8F0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Chart Container Utility — previene expansión infinita en Chart.js */
|
|
||||||
.chart-container {
|
|
||||||
position: relative;
|
|
||||||
width: 100%;
|
|
||||||
height: 260px;
|
|
||||||
max-height: 320px;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
|
Before Width: | Height: | Size: 2.5 KiB After Width: | Height: | Size: 2.5 KiB |
|
Before Width: | Height: | Size: 7.9 KiB After Width: | Height: | Size: 7.9 KiB |
|
Before Width: | Height: | Size: 13 KiB After Width: | Height: | Size: 13 KiB |
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 2.4 KiB After Width: | Height: | Size: 2.4 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 42 KiB |
|
Before Width: | Height: | Size: 4.0 KiB After Width: | Height: | Size: 4.0 KiB |
|
Before Width: | Height: | Size: 5.7 KiB After Width: | Height: | Size: 5.7 KiB |
|
Before Width: | Height: | Size: 31 KiB After Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
@@ -143,7 +143,7 @@ class GeneticAlgorithmManager {
|
|||||||
const commissionIds = this.getSelectedCommissionIds();
|
const commissionIds = this.getSelectedCommissionIds();
|
||||||
|
|
||||||
if (commissionIds.length === 0) {
|
if (commissionIds.length === 0) {
|
||||||
this.showAlert('Por favor seleccione al menos una comisión para optimizar.', 'warning');
|
this.showAlert('Please select at least one commission to optimize.', '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('¡Optimización de reservas completada con éxito!', 'success');
|
this.showAlert('Optimization completed successfully!', 'success');
|
||||||
} else {
|
} else {
|
||||||
this.showAlert('Fallo en la optimización: ' + (result.error || 'Error desconocido'), 'danger');
|
this.showAlert('Optimization failed: ' + (result.error || 'Unknown error'), 'danger');
|
||||||
}
|
}
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
this.showAlert('Error durante la optimización: ' + error.message, 'danger');
|
this.showAlert('Error during optimization: ' + 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('Por favor seleccione al menos una comisión para previsualizar.', 'warning');
|
this.showAlert('Please select at least one commission to preview.', '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('¡Previsualización generada con éxito!', 'success');
|
this.showAlert('Preview generated successfully!', 'success');
|
||||||
} else {
|
} else {
|
||||||
this.showAlert('Fallo en la previsualización: ' + (result.error || 'Error desconocido'), 'danger');
|
this.showAlert('Preview failed: ' + (result.error || 'Unknown error'), 'danger');
|
||||||
}
|
}
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
this.showAlert('Error durante la previsualización: ' + error.message, 'danger');
|
this.showAlert('Error during preview: ' + 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 hay reservas optimizadas pendientes de aplicar.', 'warning');
|
this.showAlert('No pending reservations to apply.', 'warning');
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (!confirm('¿Está seguro de que desea aplicar estas asignaciones optimizadas? Se crearán las reservas definitivas en el sistema.')) {
|
if (!confirm('Are you sure you want to apply these reservations? This will create actual reservation records.')) {
|
||||||
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(`¡Se aplicaron con éxito ${result.data.applied_count} reservas en Bedelía!`, 'success');
|
this.showAlert(`Successfully applied ${result.data.applied_count} reservations!`, 'success');
|
||||||
this.clearPendingReservations();
|
this.clearPendingReservations();
|
||||||
// Redirigir al listado de reservas
|
// Redirect to reservations page
|
||||||
window.location.href = '/schedule/list_reservations';
|
window.location.href = '/schedule';
|
||||||
} else {
|
} else {
|
||||||
this.showAlert('Fallo al aplicar reservas: ' + (result.error || 'Error desconocido'), 'danger');
|
this.showAlert('Failed to apply reservations: ' + (result.error || 'Unknown error'), 'danger');
|
||||||
}
|
}
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
this.showAlert('Error al aplicar reservas: ' + error.message, 'danger');
|
this.showAlert('Error applying reservations: ' + error.message, 'danger');
|
||||||
} finally {
|
} finally {
|
||||||
this.showLoading(false);
|
this.showLoading(false);
|
||||||
}
|
}
|
||||||
@@ -252,53 +252,47 @@ 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 border-0 shadow-sm mb-4">
|
<div class="card">
|
||||||
<div class="card-header bg-success text-white py-3">
|
<div class="card-header bg-success text-white">
|
||||||
<h5 class="mb-0 h6 fw-bold"><i class="bi bi-check-circle-fill me-2"></i>Resultados de la Optimización</h5>
|
<h5 class="mb-0">Optimization Results</h5>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body p-4">
|
<div class="card-body">
|
||||||
<div class="row g-3 mb-4 text-center">
|
<div class="row mb-3">
|
||||||
<div class="col-md-4">
|
<div class="col-md-4">
|
||||||
<div class="p-3 rounded bg-primary bg-opacity-10 border border-primary-subtle">
|
<div class="text-center">
|
||||||
<h3 class="fw-bold text-primary mb-1">${data.assigned_reservations}</h3>
|
<h4 class="text-primary">${data.assigned_reservations}</h4>
|
||||||
<p class="mb-0 text-muted small fw-semibold">Reservas Asignadas</p>
|
<p class="mb-0">Reservations Assigned</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-md-4">
|
<div class="col-md-4">
|
||||||
<div class="p-3 rounded bg-info bg-opacity-10 border border-info-subtle">
|
<div class="text-center">
|
||||||
<h3 class="fw-bold text-info mb-1">${scorePercentage}%</h3>
|
<h4 class="text-info">${scorePercentage}%</h4>
|
||||||
<p class="mb-0 text-muted small fw-semibold">Puntaje de Aptitud (Fitness)</p>
|
<p class="mb-0">Fitness Score</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-md-4">
|
<div class="col-md-4">
|
||||||
<div class="p-3 rounded bg-warning bg-opacity-10 border border-warning-subtle">
|
<div class="text-center">
|
||||||
<h3 class="fw-bold text-warning mb-1">${data.total_requests}</h3>
|
<h4 class="text-warning">${data.total_requests}</h4>
|
||||||
<p class="mb-0 text-muted small fw-semibold">Total de Solicitudes</p>
|
<p class="mb-0">Total Requests</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
${data.conflicts.length > 0 ? `
|
${data.conflicts.length > 0 ? `
|
||||||
<div class="alert alert-warning d-flex align-items-center">
|
<div class="alert alert-warning">
|
||||||
<i class="bi bi-exclamation-triangle-fill fs-5 me-2"></i>
|
<strong>Warning:</strong> ${data.conflicts.length} potential conflicts detected.
|
||||||
<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 flex-wrap">
|
<div class="d-flex gap-2">
|
||||||
<button class="btn btn-outline-primary" onclick="geneticManager.viewReservationDetails()">
|
<button class="btn btn-primary" onclick="geneticManager.viewReservationDetails()">
|
||||||
<i class="bi bi-eye me-1"></i>Ver Detalle de Reservas
|
View Details
|
||||||
</button>
|
</button>
|
||||||
<button class="btn btn-success fw-bold px-4" onclick="geneticManager.handleApplyOptimization()">
|
<button class="btn btn-success" onclick="geneticManager.handleApplyOptimization()">
|
||||||
<i class="bi bi-check-circle me-1"></i>Aplicar Reservas en Bedelía
|
Apply Reservations
|
||||||
</button>
|
</button>
|
||||||
<button class="btn btn-outline-secondary" onclick="geneticManager.clearResults()">
|
<button class="btn btn-secondary" onclick="geneticManager.clearResults()">
|
||||||
<i class="bi bi-trash me-1"></i>Limpiar
|
Clear
|
||||||
</button>
|
</button>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -312,30 +306,30 @@ class GeneticAlgorithmManager {
|
|||||||
|
|
||||||
const commissionsHtml = data.commission_details.map(commission => `
|
const commissionsHtml = data.commission_details.map(commission => `
|
||||||
<tr>
|
<tr>
|
||||||
<td class="font-monospace fw-bold text-primary">${commission.code}</td>
|
<td>${commission.code}</td>
|
||||||
<td>${commission.name}</td>
|
<td>${commission.name}</td>
|
||||||
<td><span class="badge bg-secondary">${commission.current_students || 0}/${commission.max_students}</span></td>
|
<td>${commission.current_students}/${commission.max_students}</td>
|
||||||
</tr>
|
</tr>
|
||||||
`).join('');
|
`).join('');
|
||||||
|
|
||||||
const optimization = data.optimization_result;
|
const optimization = data.optimization_result;
|
||||||
|
|
||||||
previewContainer.innerHTML = `
|
previewContainer.innerHTML = `
|
||||||
<div class="card border-0 shadow-sm mb-4">
|
<div class="card">
|
||||||
<div class="card-header bg-info text-white py-3">
|
<div class="card-header bg-info text-white">
|
||||||
<h5 class="mb-0 h6 fw-bold"><i class="bi bi-eye-fill me-2"></i>Previsualización de la Optimización</h5>
|
<h5 class="mb-0">Optimization Preview</h5>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body p-4">
|
<div class="card-body">
|
||||||
<div class="row g-4 mb-4">
|
<div class="row mb-4">
|
||||||
<div class="col-md-7">
|
<div class="col-md-6">
|
||||||
<h6 class="fw-bold text-muted text-uppercase small mb-2">Comisiones a Optimizar</h6>
|
<h6>Commissions to Optimize</h6>
|
||||||
<div class="table-responsive border rounded">
|
<div class="table-responsive">
|
||||||
<table class="table table-hover table-sm mb-0">
|
<table class="table table-sm">
|
||||||
<thead class="table-light">
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th>Código</th>
|
<th>Code</th>
|
||||||
<th>Asignatura</th>
|
<th>Name</th>
|
||||||
<th>Estudiantes</th>
|
<th>Students</th>
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
@@ -344,20 +338,20 @@ class GeneticAlgorithmManager {
|
|||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-md-5">
|
<div class="col-md-6">
|
||||||
<h6 class="fw-bold text-muted text-uppercase small mb-2">Resultados Estimados</h6>
|
<h6>Expected Results</h6>
|
||||||
<ul class="list-group shadow-sm">
|
<ul class="list-group">
|
||||||
<li class="list-group-item d-flex justify-content-between align-items-center py-2">
|
<li class="list-group-item d-flex justify-content-between">
|
||||||
<span>Reservas Creadas:</span>
|
<span>Reservations Created:</span>
|
||||||
<strong class="text-primary font-monospace fs-6">${optimization.assigned_reservations}</strong>
|
<strong>${optimization.assigned_reservations}</strong>
|
||||||
</li>
|
</li>
|
||||||
<li class="list-group-item d-flex justify-content-between align-items-center py-2">
|
<li class="list-group-item d-flex justify-content-between">
|
||||||
<span>Puntaje de Aptitud:</span>
|
<span>Fitness Score:</span>
|
||||||
<strong class="text-info font-monospace fs-6">${(optimization.fitness_score * 100).toFixed(1)}%</strong>
|
<strong>${(optimization.fitness_score * 100).toFixed(1)}%</strong>
|
||||||
</li>
|
</li>
|
||||||
<li class="list-group-item d-flex justify-content-between align-items-center py-2">
|
<li class="list-group-item d-flex justify-content-between">
|
||||||
<span>Conflictos:</span>
|
<span>Conflicts:</span>
|
||||||
<strong class="font-monospace fs-6 ${optimization.conflicts.length > 0 ? 'text-danger' : 'text-success'}">
|
<strong class="${optimization.conflicts.length > 0 ? 'text-danger' : 'text-success'}">
|
||||||
${optimization.conflicts.length}
|
${optimization.conflicts.length}
|
||||||
</strong>
|
</strong>
|
||||||
</li>
|
</li>
|
||||||
@@ -367,10 +361,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()">
|
||||||
<i class="bi bi-play-circle me-1"></i>Ejecutar Optimización Completa
|
Run Full Optimization
|
||||||
</button>
|
</button>
|
||||||
<button class="btn btn-outline-secondary" onclick="geneticManager.clearPreview()">
|
<button class="btn btn-secondary" onclick="geneticManager.clearPreview()">
|
||||||
<i class="bi bi-x-circle me-1"></i>Cerrar Previsualización
|
Close Preview
|
||||||
</button>
|
</button>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -381,7 +375,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 hay detalles de reserva disponibles.', 'info');
|
this.showAlert('No reservation details available.', 'info');
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -389,11 +383,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 || 'Cursada Académica'}</td>
|
<td>${res.purpose}</td>
|
||||||
<td><span class="badge bg-primary">Aula ID ${res.classroom_id}</span></td>
|
<td>Classroom ${res.classroom_id}</td>
|
||||||
<td class="small font-monospace">${new Date(res.start_time).toLocaleString('es-AR')}</td>
|
<td>${new Date(res.start_time).toLocaleString()}</td>
|
||||||
<td class="small font-monospace">${new Date(res.end_time).toLocaleString('es-AR')}</td>
|
<td>${new Date(res.end_time).toLocaleString()}</td>
|
||||||
<td><span class="badge bg-secondary">${res.expected_attendees || 0}</span></td>
|
<td>${res.expected_attendees}</td>
|
||||||
</tr>
|
</tr>
|
||||||
`).join('');
|
`).join('');
|
||||||
|
|
||||||
@@ -401,15 +395,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-hover table-sm">
|
<table class="table">
|
||||||
<thead class="table-light">
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th>#</th>
|
<th>#</th>
|
||||||
<th>Propósito</th>
|
<th>Purpose</th>
|
||||||
<th>Aula Asignada</th>
|
<th>Classroom</th>
|
||||||
<th>Inicio</th>
|
<th>Start Time</th>
|
||||||
<th>Fin</th>
|
<th>End Time</th>
|
||||||
<th>Asistentes</th>
|
<th>Attendees</th>
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
@@ -0,0 +1,242 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}{% trans %}Import from Google Sheets{% endtrans %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<!-- Header -->
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4">
|
||||||
|
<div>
|
||||||
|
<h1 class="h3 mb-1">
|
||||||
|
<i class="bi bi-file-earmark-spreadsheet text-success me-2"></i>{% trans %}Google Sheets Academic Sync{% endtrans %}
|
||||||
|
</h1>
|
||||||
|
<p class="text-muted small mb-0">{% trans %}Extract and synchronize classrooms, careers, subjects, and weekly schedules directly from the official Google Sheet.{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<a href="{{ url_for('main.dashboard') }}" class="btn btn-outline-secondary">
|
||||||
|
<i class="bi bi-arrow-left me-1"></i>{% trans %}Dashboard{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Metrics Cards -->
|
||||||
|
<div class="row g-3 mb-4">
|
||||||
|
<div class="col-sm-6 col-xl-2">
|
||||||
|
<div class="card border-0 shadow-sm text-center p-3 h-100">
|
||||||
|
<div class="text-primary mb-1"><i class="bi bi-mortarboard fs-3"></i></div>
|
||||||
|
<div class="h4 mb-0 fw-bold">{{ metrics.total_careers }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Careers{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-sm-6 col-xl-2">
|
||||||
|
<div class="card border-0 shadow-sm text-center p-3 h-100">
|
||||||
|
<div class="text-info mb-1"><i class="bi bi-book fs-3"></i></div>
|
||||||
|
<div class="h4 mb-0 fw-bold">{{ metrics.total_subjects }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Subjects{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-sm-6 col-xl-2">
|
||||||
|
<div class="card border-0 shadow-sm text-center p-3 h-100">
|
||||||
|
<div class="text-success mb-1"><i class="bi bi-door-open fs-3"></i></div>
|
||||||
|
<div class="h4 mb-0 fw-bold">{{ metrics.total_classrooms }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Classrooms{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-sm-6 col-xl-3">
|
||||||
|
<div class="card border-0 shadow-sm text-center p-3 h-100">
|
||||||
|
<div class="text-warning mb-1"><i class="bi bi-people fs-3"></i></div>
|
||||||
|
<div class="h4 mb-0 fw-bold">{{ metrics.total_commissions }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Commissions{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-sm-6 col-xl-3">
|
||||||
|
<div class="card border-0 shadow-sm text-center p-3 h-100">
|
||||||
|
<div class="text-danger mb-1"><i class="bi bi-calendar-check fs-3"></i></div>
|
||||||
|
<div class="h4 mb-0 fw-bold">{{ metrics.total_reservations }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Calendar Classes{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Sync Action Banner -->
|
||||||
|
<div class="card border-0 shadow-sm mb-4">
|
||||||
|
<div class="card-body p-4">
|
||||||
|
<div class="row align-items-center">
|
||||||
|
<div class="col-lg-8 mb-3 mb-lg-0">
|
||||||
|
<div class="d-flex align-items-center mb-2">
|
||||||
|
<span class="badge bg-success-subtle text-success border border-success-subtle px-3 py-1 me-2 fw-semibold">
|
||||||
|
<i class="bi bi-cloud-check me-1"></i>Google Sheets Live Integration
|
||||||
|
</span>
|
||||||
|
<span class="badge bg-light text-muted border">UniCABA 2026</span>
|
||||||
|
</div>
|
||||||
|
<h4 class="h5 mb-2 fw-bold">{% trans %}Official Schedule Board (Cartelera de Aulas){% endtrans %}</h4>
|
||||||
|
<p class="text-muted small mb-2">
|
||||||
|
{% trans %}Reads published CSV sheets for all 6 days of the week, automatically creating or updating academic careers, classrooms, subject codes, commissions, and weekly calendar entries without duplicating records.{% endtrans %}
|
||||||
|
</p>
|
||||||
|
<div class="d-flex flex-wrap gap-1">
|
||||||
|
{% for s in metrics.sheets %}
|
||||||
|
<span class="badge bg-body-tertiary text-secondary border small">
|
||||||
|
<i class="bi bi-calendar-event me-1 text-primary"></i>{{ s.name }}
|
||||||
|
</span>
|
||||||
|
{% endfor %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-lg-4 text-lg-end">
|
||||||
|
<form method="POST" id="syncForm" onsubmit="startSync()">
|
||||||
|
<button type="submit" id="syncBtn" class="btn btn-success btn-lg px-4 py-2 shadow fw-semibold">
|
||||||
|
<i class="bi bi-arrow-repeat me-2"></i>{% trans %}Sync Data Now{% endtrans %}
|
||||||
|
</button>
|
||||||
|
</form>
|
||||||
|
<div id="syncSpinner" class="d-none mt-2 text-muted small">
|
||||||
|
<div class="spinner-border spinner-border-sm text-success me-1" role="status"></div>
|
||||||
|
{% trans %}Connecting to Google Sheets and processing records...{% endtrans %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Sync Results (if just completed) -->
|
||||||
|
{% if stats %}
|
||||||
|
<div class="card border-0 shadow-sm mb-4">
|
||||||
|
<div class="card-header bg-success bg-opacity-10 text-success py-3">
|
||||||
|
<h5 class="card-title h6 mb-0 fw-bold">
|
||||||
|
<i class="bi bi-check-circle-fill me-2"></i>{% trans %}Synchronization Report{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
</div>
|
||||||
|
<div class="card-body">
|
||||||
|
<div class="row g-3 text-center mb-3">
|
||||||
|
<div class="col-md-2">
|
||||||
|
<div class="p-2 border rounded bg-body-tertiary">
|
||||||
|
<div class="fw-bold fs-5">{{ stats.total_rows_processed }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Rows Processed{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2">
|
||||||
|
<div class="p-2 border rounded bg-body-tertiary">
|
||||||
|
<div class="fw-bold fs-5 text-primary">+{{ stats.careers_created }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Careers Created{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2">
|
||||||
|
<div class="p-2 border rounded bg-body-tertiary">
|
||||||
|
<div class="fw-bold fs-5 text-success">+{{ stats.classrooms_created }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Classrooms Created{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2">
|
||||||
|
<div class="p-2 border rounded bg-body-tertiary">
|
||||||
|
<div class="fw-bold fs-5 text-info">+{{ stats.subjects_created }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Subjects Created{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2">
|
||||||
|
<div class="p-2 border rounded bg-body-tertiary">
|
||||||
|
<div class="fw-bold fs-5 text-warning">+{{ stats.commissions_created }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Commissions Created{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2">
|
||||||
|
<div class="p-2 border rounded bg-body-tertiary">
|
||||||
|
<div class="fw-bold fs-5 text-danger">+{{ stats.reservations_created }}</div>
|
||||||
|
<small class="text-muted">{% trans %}Reservations Created{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{% if stats.errors %}
|
||||||
|
<div class="alert alert-warning mb-0 small">
|
||||||
|
<h6 class="alert-heading fw-bold mb-1">{% trans %}Warnings / Errors detected:{% endtrans %}</h6>
|
||||||
|
<ul class="mb-0 ps-3">
|
||||||
|
{% for err in stats.errors %}
|
||||||
|
<li>{{ err }}</li>
|
||||||
|
{% endfor %}
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
|
||||||
|
<!-- Database Preview Table -->
|
||||||
|
<div class="card border-0 shadow-sm">
|
||||||
|
<div class="card-header bg-body-tertiary d-flex justify-content-between align-items-center py-3">
|
||||||
|
<h5 class="card-title h6 mb-0">
|
||||||
|
<i class="bi bi-table text-primary me-2"></i>{% trans %}Recently Synchronized Subjects & Comissions{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
<a href="{{ url_for('schedule.calendar_view') }}" class="btn btn-outline-primary btn-sm">
|
||||||
|
<i class="bi bi-calendar3 me-1"></i>{% trans %}View Calendar{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
<div class="table-responsive">
|
||||||
|
<table class="table table-hover align-middle mb-0">
|
||||||
|
<thead class="bg-body-tertiary">
|
||||||
|
<tr>
|
||||||
|
<th class="ps-4">{% trans %}Code{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Subject Name{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Career{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Commissions{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Status{% endtrans %}</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
{% for s in recent_subjects %}
|
||||||
|
<tr>
|
||||||
|
<td class="ps-4">
|
||||||
|
<span class="badge bg-secondary-subtle text-secondary font-monospace border">
|
||||||
|
{{ s.code }}
|
||||||
|
</span>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<div class="fw-semibold">{{ s.name }}</div>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<span class="badge badge-brand small">
|
||||||
|
{{ s.career_obj.name if s.career_obj else (s.department or _('General')) }}
|
||||||
|
</span>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<span class="small text-muted">
|
||||||
|
{{ s.commissions|length }} {% trans %}commission(s){% endtrans %}
|
||||||
|
</span>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
{% if s.is_active %}
|
||||||
|
<span class="badge bg-success-subtle text-success border border-success-subtle small">
|
||||||
|
<i class="bi bi-check-circle me-1"></i>{% trans %}Active{% endtrans %}
|
||||||
|
</span>
|
||||||
|
{% else %}
|
||||||
|
<span class="badge bg-secondary small">{% trans %}Inactive{% endtrans %}</span>
|
||||||
|
{% endif %}
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
{% else %}
|
||||||
|
<tr>
|
||||||
|
<td colspan="5" class="text-center py-5 text-muted">
|
||||||
|
<i class="bi bi-cloud-arrow-down fs-1 d-block mb-2 text-secondary"></i>
|
||||||
|
{% trans %}No subjects in database yet. Click "Sync Data Now" to import.{% endtrans %}
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
{% endfor %}
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block extra_js %}
|
||||||
|
<script>
|
||||||
|
function startSync() {
|
||||||
|
const btn = document.getElementById('syncBtn');
|
||||||
|
const spinner = document.getElementById('syncSpinner');
|
||||||
|
if (btn) {
|
||||||
|
btn.disabled = true;
|
||||||
|
btn.innerHTML = '<span class="spinner-border spinner-border-sm me-2" role="status"></span>Sincronizando...';
|
||||||
|
}
|
||||||
|
if (spinner) {
|
||||||
|
spinner.classList.remove('d-none');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
{% endblock %}
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{% extends "base.html" %}
|
{% extends "base.html" %}
|
||||||
|
|
||||||
{% block title %}{% if role %}Editar Rol: {{ role.name }}{% else %}Nuevo Rol{% endif %} - Edu-Space Admin{% endblock %}
|
{% block title %}{% if role %}{% trans %}Editar Rol{% endtrans %}: {{ role.name }}{% else %}{% trans %}Nuevo Rol{% endtrans %}{% endif %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
<div class="container-fluid pt-5 mt-4">
|
<div class="container-fluid pt-5 mt-4">
|
||||||
@@ -9,58 +9,55 @@
|
|||||||
<div>
|
<div>
|
||||||
<h1 class="h3 mb-1">
|
<h1 class="h3 mb-1">
|
||||||
<i class="bi bi-shield-lock text-primary me-2"></i>
|
<i class="bi bi-shield-lock text-primary me-2"></i>
|
||||||
{% if role %}Editar Rol y Permisos de Acceso{% else %}Crear Rol y Permisos de Acceso{% endif %}
|
{% if role %}{% trans %}Editar Rol y Permisos de Acceso{% endtrans %}{% else %}{% trans %}Crear Rol y Permisos de Acceso{% endtrans %}{% endif %}
|
||||||
</h1>
|
</h1>
|
||||||
<p class="text-muted small mb-0">Configure permisos granulares por módulo con la matriz de acceso estilo FortiGate.</p>
|
<p class="text-muted small mb-0">{% trans %}Configure permisos granulares por módulo con la matriz de acceso estilo FortiGate.{% endtrans %}</p>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
<a href="/admin/roles_list" class="btn btn-outline-secondary">
|
<a href="{{ url_for('admin.roles_list') }}" class="btn btn-outline-secondary">
|
||||||
<i class="bi bi-arrow-left me-1"></i>Volver a Roles
|
<i class="bi bi-arrow-left me-1"></i>{% trans %}Volver a Roles{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<form method="POST">
|
<form method="POST">
|
||||||
{% if role %}
|
|
||||||
<input type="hidden" name="id" value="{{ role.id }}">
|
|
||||||
{% endif %}
|
|
||||||
<div class="row">
|
<div class="row">
|
||||||
<!-- Left Column: Role Details -->
|
<!-- Left Column: Role Details -->
|
||||||
<div class="col-lg-4 mb-4">
|
<div class="col-lg-4 mb-4">
|
||||||
<div class="card border-0 shadow-sm h-100">
|
<div class="card border-0 shadow-sm h-100">
|
||||||
<div class="card-header bg-body-tertiary py-3">
|
<div class="card-header bg-body-tertiary py-3">
|
||||||
<h5 class="card-title h6 mb-0">
|
<h5 class="card-title h6 mb-0">
|
||||||
<i class="bi bi-person-badge text-primary me-2"></i>Información del Rol
|
<i class="bi bi-person-badge text-primary me-2"></i>{% trans %}Información del Rol{% endtrans %}
|
||||||
</h5>
|
</h5>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body">
|
<div class="card-body">
|
||||||
<div class="mb-3">
|
<div class="mb-3">
|
||||||
<label for="name" class="form-label fw-semibold">Nombre del Rol <span class="text-danger">*</span></label>
|
<label for="name" class="form-label fw-semibold">{% trans %}Nombre del Rol{% endtrans %} <span class="text-danger">*</span></label>
|
||||||
<input type="text" class="form-control" id="name" name="name"
|
<input type="text" class="form-control" id="name" name="name"
|
||||||
value="{{ role.name if role else '' }}" required
|
value="{{ role.name if role else '' }}" required
|
||||||
placeholder="ej. Docente, Operador, Bedelía"
|
placeholder="{% trans %}ej. Docente, Operador, Bedelía{% endtrans %}"
|
||||||
{% if role and role.is_system %}readonly title="El nombre del rol del sistema no se puede modificar"{% endif %}>
|
{% if role and role.is_system %}readonly title="{% trans %}El nombre del rol del sistema no se puede modificar{% endtrans %}"{% endif %}>
|
||||||
{% if role and role.is_system %}
|
{% if role and role.is_system %}
|
||||||
<small class="text-muted d-block mt-1">
|
<small class="text-muted d-block mt-1">
|
||||||
<i class="bi bi-info-circle me-1"></i>Rol del sistema protegido.
|
<i class="bi bi-info-circle me-1"></i>{% trans %}Rol del sistema protegido.{% endtrans %}
|
||||||
</small>
|
</small>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="mb-3">
|
<div class="mb-3">
|
||||||
<label for="description" class="form-label fw-semibold">Descripción</label>
|
<label for="description" class="form-label fw-semibold">{% trans %}Descripción{% endtrans %}</label>
|
||||||
<textarea class="form-control" id="description" name="description" rows="3"
|
<textarea class="form-control" id="description" name="description" rows="3"
|
||||||
placeholder="Describa las responsabilidades o alcance de este rol...">{{ role.description if role else '' }}</textarea>
|
placeholder="{% trans %}Describa las responsabilidades o alcance de este rol...{% endtrans %}">{{ role.description if role else '' }}</textarea>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<hr class="my-4">
|
<hr class="my-4">
|
||||||
|
|
||||||
<div class="d-grid gap-2">
|
<div class="d-grid gap-2">
|
||||||
<button type="submit" class="btn btn-primary py-2 fw-semibold">
|
<button type="submit" class="btn btn-primary py-2 fw-semibold">
|
||||||
<i class="bi bi-check-lg me-1"></i>Guardar Rol y Permisos
|
<i class="bi bi-check-lg me-1"></i>{% trans %}Guardar Rol y Permisos{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
<a href="/admin/roles_list" class="btn btn-outline-secondary">
|
<a href="{{ url_for('admin.roles_list') }}" class="btn btn-outline-secondary">
|
||||||
Cancelar
|
{% trans %}Cancelar{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -73,28 +70,28 @@
|
|||||||
<!-- Matrix Header -->
|
<!-- Matrix Header -->
|
||||||
<div class="card-header d-flex justify-content-between align-items-center">
|
<div class="card-header d-flex justify-content-between align-items-center">
|
||||||
<span class="fw-bold text-primary">
|
<span class="fw-bold text-primary">
|
||||||
<i class="bi bi-grid-3x3-gap-fill me-2"></i>Permisos de Acceso
|
<i class="bi bi-grid-3x3-gap-fill me-2"></i>{% trans %}Permisos de Acceso{% endtrans %}
|
||||||
</span>
|
</span>
|
||||||
|
|
||||||
<!-- Set All Action Dropdown (FortiGate style) -->
|
<!-- Set All Action Dropdown (FortiGate style) -->
|
||||||
<div class="dropdown">
|
<div class="dropdown">
|
||||||
<button class="btn btn-fg-set-all dropdown-toggle" type="button" id="setAllDropdown" data-bs-toggle="dropdown" aria-expanded="false">
|
<button class="btn btn-fg-set-all dropdown-toggle" type="button" id="setAllDropdown" data-bs-toggle="dropdown" aria-expanded="false">
|
||||||
<i class="bi bi-lightning-charge me-1"></i>Establecer Todos
|
<i class="bi bi-lightning-charge me-1"></i>{% trans %}Establecer Todos{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
<ul class="dropdown-menu dropdown-menu-end shadow-sm" aria-labelledby="setAllDropdown">
|
<ul class="dropdown-menu dropdown-menu-end shadow-sm" aria-labelledby="setAllDropdown">
|
||||||
<li>
|
<li>
|
||||||
<button type="button" class="dropdown-item py-2" onclick="setAllPermissions('none')">
|
<button type="button" class="dropdown-item py-2" onclick="setAllPermissions('none')">
|
||||||
<i class="bi bi-slash-circle text-danger me-2"></i>Establecer Todos en Ninguno
|
<i class="bi bi-slash-circle text-danger me-2"></i>{% trans %}Establecer Todos en Ninguno{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<button type="button" class="dropdown-item py-2" onclick="setAllPermissions('read')">
|
<button type="button" class="dropdown-item py-2" onclick="setAllPermissions('read')">
|
||||||
<i class="bi bi-eye text-info me-2"></i>Establecer Todos en Solo Lectura
|
<i class="bi bi-eye text-info me-2"></i>{% trans %}Establecer Todos en Solo Lectura{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
</li>
|
</li>
|
||||||
<li>
|
<li>
|
||||||
<button type="button" class="dropdown-item py-2" onclick="setAllPermissions('read_write')">
|
<button type="button" class="dropdown-item py-2" onclick="setAllPermissions('read_write')">
|
||||||
<i class="bi bi-pencil text-success me-2"></i>Establecer Todos en Lectura y Escritura
|
<i class="bi bi-pencil text-success me-2"></i>{% trans %}Establecer Todos en Lectura y Escritura{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
@@ -106,13 +103,13 @@
|
|||||||
<table class="fg-table">
|
<table class="fg-table">
|
||||||
<thead>
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th style="width: 48%;">Módulo del Sistema</th>
|
<th style="width: 48%;">{% trans %}Módulo del Sistema{% endtrans %}</th>
|
||||||
<th style="width: 52%;" class="text-end pe-4">Nivel de Permiso</th>
|
<th style="width: 52%;" class="text-end pe-4">{% trans %}Nivel de Permiso{% endtrans %}</th>
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{% for mod in modules %}
|
{% for mod in modules %}
|
||||||
{% set cur_level = (current_perms[mod.id] if current_perms else (role.permissions[mod.id] if (role and role.permissions) else 'none')) or 'none' %}
|
{% set cur_level = current_perms.get(mod.id, 'none') %}
|
||||||
<tr data-module-row="{{ mod.id }}">
|
<tr data-module-row="{{ mod.id }}">
|
||||||
<td>
|
<td>
|
||||||
<div class="d-flex align-items-center">
|
<div class="d-flex align-items-center">
|
||||||
@@ -136,21 +133,21 @@
|
|||||||
data-val="none"
|
data-val="none"
|
||||||
data-target="input_perm_{{ mod.id }}"
|
data-target="input_perm_{{ mod.id }}"
|
||||||
onclick="selectPerm(this, 'input_perm_{{ mod.id }}', 'none')">
|
onclick="selectPerm(this, 'input_perm_{{ mod.id }}', 'none')">
|
||||||
<i class="bi bi-slash-circle"></i> Ninguno
|
<i class="bi bi-slash-circle"></i> {% trans %}Ninguno{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
<button type="button"
|
<button type="button"
|
||||||
class="fg-seg-btn {% if cur_level == 'read' %}active{% endif %}"
|
class="fg-seg-btn {% if cur_level == 'read' %}active{% endif %}"
|
||||||
data-val="read"
|
data-val="read"
|
||||||
data-target="input_perm_{{ mod.id }}"
|
data-target="input_perm_{{ mod.id }}"
|
||||||
onclick="selectPerm(this, 'input_perm_{{ mod.id }}', 'read')">
|
onclick="selectPerm(this, 'input_perm_{{ mod.id }}', 'read')">
|
||||||
<i class="bi bi-eye"></i> Lectura
|
<i class="bi bi-eye"></i> {% trans %}Lectura{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
<button type="button"
|
<button type="button"
|
||||||
class="fg-seg-btn {% if cur_level == 'read_write' %}active{% endif %}"
|
class="fg-seg-btn {% if cur_level == 'read_write' %}active{% endif %}"
|
||||||
data-val="read_write"
|
data-val="read_write"
|
||||||
data-target="input_perm_{{ mod.id }}"
|
data-target="input_perm_{{ mod.id }}"
|
||||||
onclick="selectPerm(this, 'input_perm_{{ mod.id }}', 'read_write')">
|
onclick="selectPerm(this, 'input_perm_{{ mod.id }}', 'read_write')">
|
||||||
<i class="bi bi-pencil"></i> Lectura/Escritura
|
<i class="bi bi-pencil"></i> {% trans %}Lectura/Escritura{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
</div>
|
</div>
|
||||||
</td>
|
</td>
|
||||||
@@ -0,0 +1,124 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}{% trans %}Roles y Grupos de Acceso{% endtrans %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<!-- Header -->
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
|
||||||
|
<div>
|
||||||
|
<h1 class="h3 mb-1">
|
||||||
|
<i class="bi bi-person-badge text-primary me-2"></i>{% trans %}Roles y Grupos de Acceso{% endtrans %}
|
||||||
|
</h1>
|
||||||
|
<p class="text-muted small mb-0">{% trans %}Administración de perfiles de usuario y matriz granular de permisos por módulo del sistema.{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<a href="{{ url_for('admin.role_add') }}" class="btn btn-primary">
|
||||||
|
<i class="bi bi-plus-circle me-1"></i>{% trans %}Nuevo Rol{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Roles Grid / Table -->
|
||||||
|
<div class="card border-0 shadow-sm">
|
||||||
|
<div class="table-responsive">
|
||||||
|
<table class="table table-hover align-middle mb-0">
|
||||||
|
<thead class="bg-body-tertiary">
|
||||||
|
<tr>
|
||||||
|
<th class="ps-4">{% trans %}Nombre del Rol{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Descripción{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Integrantes{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Resumen de Permisos{% endtrans %}</th>
|
||||||
|
<th class="text-end pe-4">{% trans %}Acciones{% endtrans %}</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
{% for role in roles %}
|
||||||
|
<tr>
|
||||||
|
<td class="ps-4">
|
||||||
|
<div class="d-flex align-items-center">
|
||||||
|
<div class="badge-brand rounded-circle p-2 me-3 d-inline-flex align-items-center justify-content-center" style="width: 38px; height: 38px;">
|
||||||
|
<i class="bi bi-shield-check fs-6 text-white"></i>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<div class="fw-bold text-primary">{{ role.name }}</div>
|
||||||
|
{% if role.is_system %}
|
||||||
|
<span class="badge bg-secondary-subtle text-secondary border small">{% trans %}Protegido del Sistema{% endtrans %}</span>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<span class="text-muted small">{{ role.description or _('Sin descripción provista.') }}</span>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<span class="badge bg-primary-subtle text-primary border px-2 py-1">
|
||||||
|
<i class="bi bi-people me-1"></i>{{ role.users|length }} {% trans %}usuarios{% endtrans %}
|
||||||
|
</span>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<div class="d-flex flex-wrap gap-1">
|
||||||
|
{% for mod in modules %}
|
||||||
|
{% set p_level = role.get_permission(mod.id) %}
|
||||||
|
{% if p_level == 'read_write' %}
|
||||||
|
<span class="badge bg-success-subtle text-success border small" title="{{ mod.name }}: {% trans %}Lectura y Escritura{% endtrans %}">
|
||||||
|
<i class="bi {{ mod.icon }} me-1"></i>{{ mod.name }}: RW
|
||||||
|
</span>
|
||||||
|
{% elif p_level == 'read' %}
|
||||||
|
<span class="badge bg-info-subtle text-info border small" title="{{ mod.name }}: {% trans %}Solo Lectura{% endtrans %}">
|
||||||
|
<i class="bi {{ mod.icon }} me-1"></i>{{ mod.name }}: R
|
||||||
|
</span>
|
||||||
|
{% else %}
|
||||||
|
<span class="badge bg-light text-muted border small opacity-75" title="{{ mod.name }}: {% trans %}Sin Acceso{% endtrans %}">
|
||||||
|
<i class="bi {{ mod.icon }} me-1"></i>{{ mod.name }}: -
|
||||||
|
</span>
|
||||||
|
{% endif %}
|
||||||
|
{% endfor %}
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
<td class="text-end pe-4">
|
||||||
|
<div class="btn-group btn-group-sm">
|
||||||
|
<a href="{{ url_for('admin.role_edit', id=role.id) }}" class="btn btn-outline-primary" title="{% trans %}Configurar Permisos{% endtrans %}">
|
||||||
|
<i class="bi bi-pencil-square me-1"></i>{% trans %}Permisos{% endtrans %}
|
||||||
|
</a>
|
||||||
|
{% if not role.is_system %}
|
||||||
|
<button type="button" class="btn btn-outline-danger" data-bs-toggle="modal" data-bs-target="#deleteModal{{ role.id }}" title="{% trans %}Eliminar Rol{% endtrans %}" {% if role.users|length > 0 %}disabled{% endif %}>
|
||||||
|
<i class="bi bi-trash"></i>
|
||||||
|
</button>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{% if not role.is_system %}
|
||||||
|
<!-- Delete Confirmation Modal -->
|
||||||
|
<div class="modal fade" id="deleteModal{{ role.id }}" tabindex="-1" aria-hidden="true">
|
||||||
|
<div class="modal-dialog modal-dialog-centered">
|
||||||
|
<div class="modal-content border-0 shadow">
|
||||||
|
<div class="modal-header border-0">
|
||||||
|
<h5 class="modal-title text-danger">
|
||||||
|
<i class="bi bi-exclamation-triangle-fill me-2"></i>{% trans %}Confirmar Eliminación de Rol{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
|
||||||
|
</div>
|
||||||
|
<div class="modal-body text-start">
|
||||||
|
<p>{% trans %}¿Está seguro de que desea eliminar el rol{% endtrans %} <strong>{{ role.name }}</strong>?</p>
|
||||||
|
<p class="text-muted small mb-0">{% trans %}Esta acción no se puede deshacer.{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
<div class="modal-footer border-0">
|
||||||
|
<button type="button" class="btn btn-outline-secondary" data-bs-dismiss="modal">{% trans %}Cancelar{% endtrans %}</button>
|
||||||
|
<form action="{{ url_for('admin.role_delete', id=role.id) }}" method="POST" class="d-inline">
|
||||||
|
<button type="submit" class="btn btn-danger">{% trans %}Eliminar Rol{% endtrans %}</button>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
{% endfor %}
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
@@ -0,0 +1,107 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}{% if user %}{% trans %}Edit User{% endtrans %}: {{ user.name }}{% else %}{% trans %}New User{% endtrans %}{% endif %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<!-- Header -->
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4">
|
||||||
|
<div>
|
||||||
|
<h1 class="h3 mb-1">
|
||||||
|
<i class="bi bi-person-gear text-primary me-2"></i>
|
||||||
|
{% if user %}{% trans %}Edit User Account{% endtrans %}{% else %}{% trans %}Create User Account{% endtrans %}{% endif %}
|
||||||
|
</h1>
|
||||||
|
<p class="text-muted small mb-0">{% trans %}Configure user credentials, profile information, and role assignment.{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<a href="{{ url_for('admin.users_list') }}" class="btn btn-outline-secondary">
|
||||||
|
<i class="bi bi-arrow-left me-1"></i>{% trans %}Back to Users{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-lg-6 mx-auto">
|
||||||
|
<div class="card border-0 shadow-sm">
|
||||||
|
<div class="card-header bg-body-tertiary py-3">
|
||||||
|
<h5 class="card-title h6 mb-0">
|
||||||
|
<i class="bi bi-person-vcard text-primary me-2"></i>{% trans %}Account Details{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
</div>
|
||||||
|
<div class="card-body p-4">
|
||||||
|
<form method="POST">
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="name" class="form-label fw-semibold">{% trans %}Full Name{% endtrans %} <span class="text-danger">*</span></label>
|
||||||
|
<input type="text" class="form-control" id="name" name="name"
|
||||||
|
value="{{ user.name if user else '' }}" required
|
||||||
|
placeholder="{% trans %}e.g. María González{% endtrans %}">
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="email" class="form-label fw-semibold">{% trans %}Email Address{% endtrans %} <span class="text-danger">*</span></label>
|
||||||
|
<input type="email" class="form-control" id="email" name="email"
|
||||||
|
value="{{ user.email if user else '' }}" required
|
||||||
|
placeholder="{% trans %}e.g. mgonzalez@edu-space.com{% endtrans %}">
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="password" class="form-label fw-semibold">
|
||||||
|
{% trans %}Password{% endtrans %} {% if not user %}<span class="text-danger">*</span>{% endif %}
|
||||||
|
</label>
|
||||||
|
<input type="password" class="form-control" id="password" name="password"
|
||||||
|
{% if not user %}required{% endif %}
|
||||||
|
placeholder="{% if user %}{% trans %}Leave empty to keep current password{% endtrans %}{% else %}{% trans %}At least 6 characters{% endtrans %}{% endif %}">
|
||||||
|
{% if user %}
|
||||||
|
<small class="text-muted d-block mt-1">
|
||||||
|
{% trans %}Only fill this in if you want to reset this user's password.{% endtrans %}
|
||||||
|
</small>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="role_id" class="form-label fw-semibold">{% trans %}Role / Access Group{% endtrans %} <span class="text-danger">*</span></label>
|
||||||
|
<select class="form-select" id="role_id" name="role_id" required>
|
||||||
|
<option value="" disabled {% if not user or not user.role_id %}selected{% endif %}>{% trans %}Select a role...{% endtrans %}</option>
|
||||||
|
{% for r in roles %}
|
||||||
|
<option value="{{ r.id }}" {% if user and user.role_id == r.id %}selected{% endif %}>
|
||||||
|
{{ r.name }} - {{ r.description or '' }}
|
||||||
|
</option>
|
||||||
|
{% endfor %}
|
||||||
|
</select>
|
||||||
|
<small class="text-muted d-block mt-1">
|
||||||
|
<a href="{{ url_for('admin.roles_list') }}" target="_blank" class="text-decoration-none">
|
||||||
|
<i class="bi bi-box-arrow-up-right me-1"></i>{% trans %}View or manage roles and permissions{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</small>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-4 form-check form-switch">
|
||||||
|
<input class="form-check-input" type="checkbox" role="switch" id="is_active" name="is_active"
|
||||||
|
{% if not user or user.is_active %}checked{% endif %}
|
||||||
|
{% if user and user.id == current_user.id %}disabled{% endif %}>
|
||||||
|
<label class="form-check-label fw-semibold" for="is_active">
|
||||||
|
{% trans %}Active Account{% endtrans %}
|
||||||
|
</label>
|
||||||
|
<small class="text-muted d-block">
|
||||||
|
{% trans %}Inactive users are prevented from signing in to the platform.{% endtrans %}
|
||||||
|
</small>
|
||||||
|
{% if user and user.id == current_user.id %}
|
||||||
|
<input type="hidden" name="is_active" value="on">
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="d-flex justify-content-between align-items-center pt-2">
|
||||||
|
<a href="{{ url_for('admin.users_list') }}" class="btn btn-outline-secondary">
|
||||||
|
{% trans %}Cancel{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<button type="submit" class="btn btn-primary px-4 fw-semibold">
|
||||||
|
<i class="bi bi-check-lg me-1"></i>{% trans %}Save User{% endtrans %}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
@@ -0,0 +1,182 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}{% trans %}User Management{% endtrans %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<!-- Header -->
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4">
|
||||||
|
<div>
|
||||||
|
<h1 class="h3 mb-1">
|
||||||
|
<i class="bi bi-people text-primary me-2"></i>{% trans %}User Management{% endtrans %}
|
||||||
|
</h1>
|
||||||
|
<p class="text-muted small mb-0">{% trans %}Manage user accounts, assign roles, and control active status.{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<a href="{{ url_for('admin.user_add') }}" class="btn btn-primary">
|
||||||
|
<i class="bi bi-person-plus me-1"></i>{% trans %}New User{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Filters & Search -->
|
||||||
|
<div class="card border-0 shadow-sm mb-4">
|
||||||
|
<div class="card-body p-3">
|
||||||
|
<form method="GET" class="row g-2 align-items-center">
|
||||||
|
<div class="col-md-5">
|
||||||
|
<div class="input-group input-group-sm">
|
||||||
|
<span class="input-group-text bg-body-tertiary border-end-0">
|
||||||
|
<i class="bi bi-search text-muted"></i>
|
||||||
|
</span>
|
||||||
|
<input type="text" name="search" class="form-control border-start-0"
|
||||||
|
placeholder="{% trans %}Search by name or email...{% endtrans %}"
|
||||||
|
value="{{ search }}">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-3">
|
||||||
|
<select name="role" class="form-select form-select-sm">
|
||||||
|
<option value="">{% trans %}All Roles{% endtrans %}</option>
|
||||||
|
{% for r in roles %}
|
||||||
|
<option value="{{ r.id }}" {% if role_filter == (r.id|string) %}selected{% endif %}>{{ r.name }}</option>
|
||||||
|
{% endfor %}
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2">
|
||||||
|
<select name="status" class="form-select form-select-sm">
|
||||||
|
<option value="">{% trans %}All Statuses{% endtrans %}</option>
|
||||||
|
<option value="active" {% if status_filter == 'active' %}selected{% endif %}>{% trans %}Active{% endtrans %}</option>
|
||||||
|
<option value="inactive" {% if status_filter == 'inactive' %}selected{% endif %}>{% trans %}Inactive{% endtrans %}</option>
|
||||||
|
</select>
|
||||||
|
</div>
|
||||||
|
<div class="col-md-2 d-flex gap-2">
|
||||||
|
<button type="submit" class="btn btn-primary btn-sm w-100">
|
||||||
|
<i class="bi bi-filter me-1"></i>{% trans %}Filter{% endtrans %}
|
||||||
|
</button>
|
||||||
|
{% if search or role_filter or status_filter %}
|
||||||
|
<a href="{{ url_for('admin.users_list') }}" class="btn btn-outline-secondary btn-sm" title="{% trans %}Clear filters{% endtrans %}">
|
||||||
|
<i class="bi bi-x-lg"></i>
|
||||||
|
</a>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Users Table -->
|
||||||
|
<div class="card border-0 shadow-sm">
|
||||||
|
<div class="table-responsive">
|
||||||
|
<table class="table table-hover align-middle mb-0">
|
||||||
|
<thead class="bg-body-tertiary">
|
||||||
|
<tr>
|
||||||
|
<th class="ps-4">{% trans %}User{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Email{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Role / Group{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Status{% endtrans %}</th>
|
||||||
|
<th>{% trans %}Last Login{% endtrans %}</th>
|
||||||
|
<th class="text-end pe-4">{% trans %}Actions{% endtrans %}</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
{% for u in users %}
|
||||||
|
<tr>
|
||||||
|
<td class="ps-4">
|
||||||
|
<div class="d-flex align-items-center">
|
||||||
|
<div class="user-avatar-small me-2">
|
||||||
|
{{ (u.first_name[0] if u.first_name else 'U')|upper }}
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<div class="fw-bold">{{ u.name }}</div>
|
||||||
|
<small class="text-muted">ID: #{{ u.id }}</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<span class="font-monospace small">{{ u.email }}</span>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
{% if u.role_obj %}
|
||||||
|
<span class="badge badge-brand">
|
||||||
|
<i class="bi bi-shield-check me-1"></i>{{ u.role_obj.name }}
|
||||||
|
</span>
|
||||||
|
{% else %}
|
||||||
|
<span class="badge bg-secondary">
|
||||||
|
{{ u.role or _('No Role') }}
|
||||||
|
</span>
|
||||||
|
{% endif %}
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
{% if u.is_active %}
|
||||||
|
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
|
||||||
|
<i class="bi bi-check-circle me-1"></i>{% trans %}Active{% endtrans %}
|
||||||
|
</span>
|
||||||
|
{% else %}
|
||||||
|
<span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
|
||||||
|
<i class="bi bi-dash-circle me-1"></i>{% trans %}Inactive{% endtrans %}
|
||||||
|
</span>
|
||||||
|
{% endif %}
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<small class="text-muted">
|
||||||
|
{% if u.last_login %}
|
||||||
|
{{ format_datetime(u.last_login, format='short') }}
|
||||||
|
{% else %}
|
||||||
|
{% trans %}Never{% endtrans %}
|
||||||
|
{% endif %}
|
||||||
|
</small>
|
||||||
|
</td>
|
||||||
|
<td class="text-end pe-4">
|
||||||
|
<div class="btn-group btn-group-sm">
|
||||||
|
<a href="{{ url_for('admin.user_edit', id=u.id) }}" class="btn btn-outline-primary" title="{% trans %}Edit User{% endtrans %}">
|
||||||
|
<i class="bi bi-pencil"></i>
|
||||||
|
</a>
|
||||||
|
{% if u.id != current_user.id %}
|
||||||
|
<form action="{{ url_for('admin.user_toggle', id=u.id) }}" method="POST" class="d-inline">
|
||||||
|
<button type="submit" class="btn {% if u.is_active %}btn-outline-warning{% else %}btn-outline-success{% endif %}"
|
||||||
|
title="{% if u.is_active %}{% trans %}Deactivate User{% endtrans %}{% else %}{% trans %}Activate User{% endtrans %}{% endif %}">
|
||||||
|
<i class="bi {% if u.is_active %}bi-person-x{% else %}bi-person-check{% endif %}"></i>
|
||||||
|
</button>
|
||||||
|
</form>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
{% else %}
|
||||||
|
<tr>
|
||||||
|
<td colspan="6" class="text-center py-5 text-muted">
|
||||||
|
<i class="bi bi-people fs-1 d-block mb-2 text-secondary"></i>
|
||||||
|
{% trans %}No users found matching the criteria.{% endtrans %}
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
{% endfor %}
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Pagination -->
|
||||||
|
{% if pagination.pages > 1 %}
|
||||||
|
<div class="card-footer bg-body-tertiary d-flex justify-content-between align-items-center py-2 px-4">
|
||||||
|
<small class="text-muted">
|
||||||
|
{% trans %}Showing page{% endtrans %} {{ pagination.page }} {% trans %}of{% endtrans %} {{ pagination.pages }} ({{ pagination.total }} {% trans %}total{% endtrans %})
|
||||||
|
</small>
|
||||||
|
<ul class="pagination pagination-sm mb-0">
|
||||||
|
{% if pagination.has_prev %}
|
||||||
|
<li class="page-item"><a class="page-link" href="{{ url_for('admin.users_list', page=pagination.prev_num, search=search, role=role_filter, status=status_filter) }}">«</a></li>
|
||||||
|
{% endif %}
|
||||||
|
{% for p in pagination.iter_pages(left_edge=1, right_edge=1, left_current=2, right_current=2) %}
|
||||||
|
{% if p %}
|
||||||
|
<li class="page-item {% if p == pagination.page %}active{% endif %}">
|
||||||
|
<a class="page-link" href="{{ url_for('admin.users_list', page=p, search=search, role=role_filter, status=status_filter) }}">{{ p }}</a>
|
||||||
|
</li>
|
||||||
|
{% else %}
|
||||||
|
<li class="page-item disabled"><span class="page-link">…</span></li>
|
||||||
|
{% endif %}
|
||||||
|
{% endfor %}
|
||||||
|
{% if pagination.has_next %}
|
||||||
|
<li class="page-item"><a class="page-link" href="{{ url_for('admin.users_list', page=pagination.next_num, search=search, role=role_filter, status=status_filter) }}">»</a></li>
|
||||||
|
{% endif %}
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
@@ -15,7 +15,7 @@
|
|||||||
No tienes los permisos necesarios para acceder a este recurso. Esta sección está restringida exclusivamente a administradores.
|
No tienes los permisos necesarios para acceder a este recurso. Esta sección está restringida exclusivamente a administradores.
|
||||||
</p>
|
</p>
|
||||||
<div>
|
<div>
|
||||||
<a href="/main/dashboard" class="btn btn-primary">
|
<a href="{{ url_for('main.dashboard') }}" class="btn btn-primary">
|
||||||
<i class="bi bi-house me-1"></i>Ir al Dashboard
|
<i class="bi bi-house me-1"></i>Ir al Dashboard
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
@@ -0,0 +1,62 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}Cambiar Contraseña - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container pt-5 mt-4">
|
||||||
|
<div class="row justify-content-center">
|
||||||
|
<div class="col-lg-6 col-md-8">
|
||||||
|
<!-- Header -->
|
||||||
|
<div class="d-flex align-items-center justify-content-between mb-4">
|
||||||
|
<h1 class="h3 mb-0">
|
||||||
|
<i class="bi bi-shield-lock text-primary me-2"></i>Cambiar Contraseña
|
||||||
|
</h1>
|
||||||
|
<a href="{{ url_for('auth.profile') }}" class="btn btn-outline-secondary btn-sm">
|
||||||
|
<i class="bi bi-arrow-left me-1"></i>Volver al Perfil
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Form Card -->
|
||||||
|
<div class="card border-0 shadow-sm">
|
||||||
|
<div class="card-body p-4">
|
||||||
|
<form method="POST" action="{{ url_for('auth.change_password') }}">
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="current_password" class="form-label">Contraseña Actual</label>
|
||||||
|
<div class="input-group">
|
||||||
|
<span class="input-group-text"><i class="bi bi-lock"></i></span>
|
||||||
|
<input type="password" class="form-control" id="current_password" name="current_password" required placeholder="Ingresa tu contraseña actual">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="new_password" class="form-label">Nueva Contraseña</label>
|
||||||
|
<div class="input-group">
|
||||||
|
<span class="input-group-text"><i class="bi bi-key"></i></span>
|
||||||
|
<input type="password" class="form-control" id="new_password" name="new_password" required minlength="6" placeholder="Mínimo 6 caracteres">
|
||||||
|
</div>
|
||||||
|
<div class="form-text">Debe tener al menos 6 caracteres.</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-4">
|
||||||
|
<label for="confirm_password" class="form-label">Confirmar Nueva Contraseña</label>
|
||||||
|
<div class="input-group">
|
||||||
|
<span class="input-group-text"><i class="bi bi-check2-circle"></i></span>
|
||||||
|
<input type="password" class="form-control" id="confirm_password" name="confirm_password" required minlength="6" placeholder="Repite la nueva contraseña">
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="d-grid gap-2">
|
||||||
|
<button type="submit" class="btn btn-primary">
|
||||||
|
<i class="bi bi-save me-1"></i>Actualizar Contraseña
|
||||||
|
</button>
|
||||||
|
<a href="{{ url_for('auth.profile') }}" class="btn btn-link text-muted">
|
||||||
|
Cancelar
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
@@ -0,0 +1,115 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="{{ current_lang }}" data-bs-theme="dark">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>{% trans %}Login - Edu-Space Admin{% endtrans %}</title>
|
||||||
|
|
||||||
|
<!-- Favicon -->
|
||||||
|
<link rel="icon" type="image/png" href="{{ url_for('static', filename='img/favicon.png') }}">
|
||||||
|
|
||||||
|
<!-- Script Anti-Flicker para Modo Claro / Oscuro -->
|
||||||
|
<script>
|
||||||
|
(function() {
|
||||||
|
const storedTheme = localStorage.getItem('theme');
|
||||||
|
const theme = storedTheme || (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
|
||||||
|
document.documentElement.setAttribute('data-bs-theme', theme);
|
||||||
|
})();
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<!-- Bootstrap 5 CSS -->
|
||||||
|
<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-icons@1.10.0/font/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<!-- Design System Theme -->
|
||||||
|
<link href="{{ url_for('static', filename='css/theme.css') }}" rel="stylesheet">
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div class="auth-wrapper">
|
||||||
|
<div class="auth-card">
|
||||||
|
<!-- Header con Controles Superiores & Logo Oficial -->
|
||||||
|
<div class="auth-header">
|
||||||
|
<div class="auth-controls">
|
||||||
|
<button class="theme-toggle-btn" type="button" aria-label="Cambiar tema" title="Modo Claro/Oscuro">
|
||||||
|
<i class="bi bi-moon-stars-fill"></i>
|
||||||
|
</button>
|
||||||
|
{% include 'partials/language_switcher.html' %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<img src="{{ url_for('static', filename='img/logo_unicaba.png') }}" alt="UniCABA" class="auth-logo">
|
||||||
|
<h4 class="fw-bold mb-1">Edu-Space Admin</h4>
|
||||||
|
<p class="text-muted small mb-0">{% trans %}Classroom Management System{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="px-4 pb-4 pt-2">
|
||||||
|
<!-- Flash Messages -->
|
||||||
|
{% with messages = get_flashed_messages(with_categories=true) %}
|
||||||
|
{% if messages %}
|
||||||
|
{% for category, message in messages %}
|
||||||
|
<div class="alert alert-{{ 'danger' if category == 'error' else category }} alert-dismissible fade show rounded-3 py-2 small" role="alert">
|
||||||
|
{{ message }}
|
||||||
|
<button type="button" class="btn-close py-2" data-bs-dismiss="alert"></button>
|
||||||
|
</div>
|
||||||
|
{% endfor %}
|
||||||
|
{% endif %}
|
||||||
|
{% endwith %}
|
||||||
|
|
||||||
|
<form method="POST" novalidate>
|
||||||
|
{{ form.hidden_tag() }}
|
||||||
|
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="email" class="form-label small fw-semibold text-muted">{{ form.email.label.text }}</label>
|
||||||
|
<div class="input-group">
|
||||||
|
<span class="input-group-text bg-body-tertiary border-end-0 text-muted">
|
||||||
|
<i class="bi bi-envelope"></i>
|
||||||
|
</span>
|
||||||
|
<input type="email" class="form-control border-start-0 ps-0" id="email" name="email"
|
||||||
|
value="{{ form.email.data or '' }}" required
|
||||||
|
placeholder="{% trans %}Enter your email{% endtrans %}">
|
||||||
|
</div>
|
||||||
|
{% for error in form.email.errors %}
|
||||||
|
<div class="text-danger small mt-1">{{ error }}</div>
|
||||||
|
{% endfor %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-3">
|
||||||
|
<label for="password" class="form-label small fw-semibold text-muted">{{ form.password.label.text }}</label>
|
||||||
|
<div class="input-group">
|
||||||
|
<span class="input-group-text bg-body-tertiary border-end-0 text-muted">
|
||||||
|
<i class="bi bi-lock"></i>
|
||||||
|
</span>
|
||||||
|
<input type="password" class="form-control border-start-0 ps-0" id="password" name="password"
|
||||||
|
required placeholder="{% trans %}Enter your password{% endtrans %}">
|
||||||
|
</div>
|
||||||
|
{% for error in form.password.errors %}
|
||||||
|
<div class="text-danger small mt-1">{{ error }}</div>
|
||||||
|
{% endfor %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-4 form-check">
|
||||||
|
{{ form.remember_me(class="form-check-input") }}
|
||||||
|
<label class="form-check-label text-muted small" for="remember_me">
|
||||||
|
{{ form.remember_me.label.text }}
|
||||||
|
</label>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="d-grid">
|
||||||
|
<button type="submit" class="btn btn-primary btn-lg fw-semibold py-2">
|
||||||
|
<i class="bi bi-box-arrow-in-right me-1"></i> {{ form.submit.label.text }}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
|
||||||
|
<div class="text-center mt-4">
|
||||||
|
<small class="text-muted d-inline-flex align-items-center">
|
||||||
|
<i class="bi bi-shield-check text-primary me-1"></i>
|
||||||
|
{% trans %}Secure Login • All access is logged{% endtrans %}
|
||||||
|
</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
|
||||||
|
<script src="{{ url_for('static', filename='js/theme-toggle.js') }}"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{% extends "base.html" %}
|
{% extends "base.html" %}
|
||||||
|
|
||||||
{% block title %}User Profile - Edu-Space Admin{% endblock %}
|
{% block title %}{% trans %}User Profile{% endtrans %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
<div class="container pt-5 mt-4">
|
<div class="container pt-5 mt-4">
|
||||||
@@ -9,10 +9,10 @@
|
|||||||
<!-- Header -->
|
<!-- Header -->
|
||||||
<div class="d-flex align-items-center justify-content-between mb-4">
|
<div class="d-flex align-items-center justify-content-between mb-4">
|
||||||
<h1 class="h3 mb-0">
|
<h1 class="h3 mb-0">
|
||||||
<i class="bi bi-person-badge text-primary me-2"></i>My Profile
|
<i class="bi bi-person-badge text-primary me-2"></i>{% trans %}My Profile{% endtrans %}
|
||||||
</h1>
|
</h1>
|
||||||
<a href="/main/dashboard" class="btn btn-outline-secondary btn-sm">
|
<a href="{{ url_for('main.dashboard') }}" class="btn btn-outline-secondary btn-sm">
|
||||||
<i class="bi bi-arrow-left me-1"></i>Dashboard
|
<i class="bi bi-arrow-left me-1"></i>{% trans %}Dashboard{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
@@ -24,13 +24,13 @@
|
|||||||
<i class="bi bi-person"></i>
|
<i class="bi bi-person"></i>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
<h4 class="mb-1">{{ user.name }}</h4>
|
<h4 class="mb-1">{{ current_user.name }}</h4>
|
||||||
<div class="d-flex align-items-center gap-2">
|
<div class="d-flex align-items-center gap-2">
|
||||||
<span class="badge bg-primary">{{ user.role }}</span>
|
<span class="badge bg-primary">{{ current_user.role }}</span>
|
||||||
{% if user.is_active %}
|
{% if current_user.is_active %}
|
||||||
<span class="badge bg-success"><i class="bi bi-check-circle me-1"></i>Active</span>
|
<span class="badge bg-success"><i class="bi bi-check-circle me-1"></i>{% trans %}Active{% endtrans %}</span>
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="badge bg-danger"><i class="bi bi-x-circle me-1"></i>Inactive</span>
|
<span class="badge bg-danger"><i class="bi bi-x-circle me-1"></i>{% trans %}Inactive{% endtrans %}</span>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -41,32 +41,32 @@
|
|||||||
<!-- User Details Grid -->
|
<!-- User Details Grid -->
|
||||||
<div class="row g-3">
|
<div class="row g-3">
|
||||||
<div class="col-sm-6">
|
<div class="col-sm-6">
|
||||||
<label class="form-label text-muted small mb-1">Email</label>
|
<label class="form-label text-muted small mb-1">{% trans %}Email{% endtrans %}</label>
|
||||||
<div class="fw-semibold">{{ user.email }}</div>
|
<div class="fw-semibold">{{ current_user.email }}</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-sm-6">
|
<div class="col-sm-6">
|
||||||
<label class="form-label text-muted small mb-1">Full Name</label>
|
<label class="form-label text-muted small mb-1">{% trans %}Full Name{% endtrans %}</label>
|
||||||
<div class="fw-semibold">{{ user.name }}</div>
|
<div class="fw-semibold">{{ current_user.name }}</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-sm-6">
|
<div class="col-sm-6">
|
||||||
<label class="form-label text-muted small mb-1">Access Role</label>
|
<label class="form-label text-muted small mb-1">{% trans %}Access Role{% endtrans %}</label>
|
||||||
<div class="fw-semibold">{{ user.role }}</div>
|
<div class="fw-semibold">{{ current_user.role }}</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-sm-6">
|
<div class="col-sm-6">
|
||||||
<label class="form-label text-muted small mb-1">Last Login</label>
|
<label class="form-label text-muted small mb-1">{% trans %}Last Login{% endtrans %}</label>
|
||||||
<div class="fw-semibold">
|
<div class="fw-semibold">
|
||||||
{% if user.last_login %}
|
{% if current_user.last_login %}
|
||||||
{{ user.last_login }}
|
{{ current_user.last_login.strftime('%Y-%m-%d %H:%M:%S') }}
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="text-muted">First login</span>
|
<span class="text-muted">{% trans %}First login{% endtrans %}</span>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-sm-6">
|
<div class="col-sm-6">
|
||||||
<label class="form-label text-muted small mb-1">Registration Date</label>
|
<label class="form-label text-muted small mb-1">{% trans %}Registration Date{% endtrans %}</label>
|
||||||
<div class="fw-semibold">
|
<div class="fw-semibold">
|
||||||
{% if user.created_at %}
|
{% if current_user.created_at %}
|
||||||
{{ user.created_at }}
|
{{ current_user.created_at.strftime('%Y-%m-%d') }}
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="text-muted">-</span>
|
<span class="text-muted">-</span>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
@@ -77,76 +77,76 @@
|
|||||||
<hr class="my-4">
|
<hr class="my-4">
|
||||||
|
|
||||||
<!-- Preferences Section -->
|
<!-- Preferences Section -->
|
||||||
<form method="POST" action="/auth/profile">
|
<form method="POST" action="{{ url_for('auth.profile') }}">
|
||||||
<h5 class="fw-bold mb-3">
|
<h5 class="fw-bold mb-3">
|
||||||
<i class="bi bi-sliders text-primary me-2"></i>User Preferences
|
<i class="bi bi-sliders text-primary me-2"></i>{% trans %}User Preferences{% endtrans %}
|
||||||
</h5>
|
</h5>
|
||||||
|
|
||||||
<div class="row g-3">
|
<div class="row g-3">
|
||||||
<!-- Preferred Language -->
|
<!-- Preferred Language -->
|
||||||
<div class="col-md-6 mb-3">
|
<div class="col-md-6 mb-3">
|
||||||
<label for="preferred_language" class="form-label fw-semibold">
|
<label for="preferred_language" class="form-label fw-semibold">
|
||||||
<i class="bi bi-translate text-primary me-1"></i>Interface Language
|
<i class="bi bi-translate text-primary me-1"></i>{% trans %}Interface Language{% endtrans %}
|
||||||
</label>
|
</label>
|
||||||
<select class="form-select" id="preferred_language" name="preferred_language">
|
<select class="form-select" id="preferred_language" name="preferred_language">
|
||||||
<option value="" {% if not user.preferred_language %}selected{% endif %}>
|
<option value="" {% if not current_user.preferred_language %}selected{% endif %}>
|
||||||
Auto-detect from browser (Default)
|
{% trans %}Auto-detect from browser (Default){% endtrans %}
|
||||||
</option>
|
</option>
|
||||||
<option value="es" {% if user.preferred_language == 'es' %}selected{% endif %}>
|
<option value="es" {% if current_user.preferred_language == 'es' %}selected{% endif %}>
|
||||||
Español
|
Español
|
||||||
</option>
|
</option>
|
||||||
<option value="en" {% if user.preferred_language == 'en' %}selected{% endif %}>
|
<option value="en" {% if current_user.preferred_language == 'en' %}selected{% endif %}>
|
||||||
English
|
English
|
||||||
</option>
|
</option>
|
||||||
</select>
|
</select>
|
||||||
<small class="text-muted d-block mt-1">
|
<small class="text-muted d-block mt-1">
|
||||||
If set, this language overrides the browser configuration for all your sessions.
|
{% trans %}If set, this language overrides the browser configuration for all your sessions.{% endtrans %}
|
||||||
</small>
|
</small>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- Theme Preference -->
|
<!-- Theme Preference -->
|
||||||
<div class="col-md-6 mb-3">
|
<div class="col-md-6 mb-3">
|
||||||
<label for="theme_preference" class="form-label fw-semibold">
|
<label for="theme_preference" class="form-label fw-semibold">
|
||||||
<i class="bi bi-palette text-primary me-1"></i>Visual Theme
|
<i class="bi bi-palette text-primary me-1"></i>{% trans %}Visual Theme{% endtrans %}
|
||||||
</label>
|
</label>
|
||||||
<select class="form-select" id="theme_preference" name="theme_preference">
|
<select class="form-select" id="theme_preference" name="theme_preference">
|
||||||
<option value="auto" {% if user.theme_preference == 'auto' or not user.theme_preference %}selected{% endif %}>
|
<option value="auto" {% if current_user.theme_preference == 'auto' or not current_user.theme_preference %}selected{% endif %}>
|
||||||
Automatic (follow system)
|
{% trans %}Automatic (follow system){% endtrans %}
|
||||||
</option>
|
</option>
|
||||||
<option value="light" {% if user.theme_preference == 'light' %}selected{% endif %}>
|
<option value="light" {% if current_user.theme_preference == 'light' %}selected{% endif %}>
|
||||||
Light Mode
|
{% trans %}Light Mode{% endtrans %}
|
||||||
</option>
|
</option>
|
||||||
<option value="dark" {% if user.theme_preference == 'dark' %}selected{% endif %}>
|
<option value="dark" {% if current_user.theme_preference == 'dark' %}selected{% endif %}>
|
||||||
Dark Mode
|
{% trans %}Dark Mode{% endtrans %}
|
||||||
</option>
|
</option>
|
||||||
</select>
|
</select>
|
||||||
<small class="text-muted d-block mt-1">
|
<small class="text-muted d-block mt-1">
|
||||||
Choose your preferred visual theme.
|
{% trans %}Choose your preferred visual theme.{% endtrans %}
|
||||||
</small>
|
</small>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="text-end mt-2">
|
<div class="text-end mt-2">
|
||||||
<button type="submit" class="btn btn-primary">
|
<button type="submit" class="btn btn-primary">
|
||||||
<i class="bi bi-check-lg me-1"></i>Save Preferences
|
<i class="bi bi-check-lg me-1"></i>{% trans %}Save Preferences{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
</div>
|
</div>
|
||||||
</form>
|
</form>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-footer bg-body-tertiary px-4 py-3 d-flex justify-content-between align-items-center">
|
<div class="card-footer bg-body-tertiary px-4 py-3 d-flex justify-content-between align-items-center">
|
||||||
<span class="text-muted small">Account Security</span>
|
<span class="text-muted small">{% trans %}Account Security{% endtrans %}</span>
|
||||||
<a href="/auth/change_password" class="btn btn-primary btn-sm">
|
<a href="{{ url_for('auth.change_password') }}" class="btn btn-primary btn-sm">
|
||||||
<i class="bi bi-key me-1"></i>Change Password
|
<i class="bi bi-key me-1"></i>{% trans %}Change Password{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- User Reservations Overview (if any) -->
|
<!-- User Reservations Overview (if any) -->
|
||||||
{% if user.reservations %}
|
{% if current_user.reservations %}
|
||||||
<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">
|
<div class="card-header bg-body-tertiary">
|
||||||
<h5 class="card-title mb-0 h6">
|
<h5 class="card-title mb-0 h6">
|
||||||
<i class="bi bi-calendar-event me-2"></i>My Recent Reservations
|
<i class="bi bi-calendar-event me-2"></i>{% trans %}My Recent Reservations{% endtrans %}
|
||||||
</h5>
|
</h5>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body p-0">
|
<div class="card-body p-0">
|
||||||
@@ -154,22 +154,22 @@
|
|||||||
<table class="table table-hover align-middle mb-0">
|
<table class="table table-hover align-middle mb-0">
|
||||||
<thead class="table-light">
|
<thead class="table-light">
|
||||||
<tr>
|
<tr>
|
||||||
<th>Classroom</th>
|
<th>{% trans %}Classroom{% endtrans %}</th>
|
||||||
<th>Purpose</th>
|
<th>{% trans %}Purpose{% endtrans %}</th>
|
||||||
<th>Date & Time</th>
|
<th>{% trans %}Date & Time{% endtrans %}</th>
|
||||||
<th>Status</th>
|
<th>{% trans %}Status{% endtrans %}</th>
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{% for res in (user.reservations or []).slice(0, 5) %}
|
{% for res in current_user.reservations[:5] %}
|
||||||
<tr>
|
<tr>
|
||||||
<td>
|
<td>
|
||||||
<span class="badge bg-secondary">{{ res.classroom.code_display if res.classroom else 'N/A' }}</span>
|
<span class="badge bg-secondary">{{ res.classroom.code_display if res.classroom else 'N/A' }}</span>
|
||||||
</td>
|
</td>
|
||||||
<td>{{ res.purpose }}</td>
|
<td>{{ res.purpose }}</td>
|
||||||
<td>{{ res.start_time }}</td>
|
<td>{{ res.start_time.strftime('%Y-%m-%d %H:%M') }}</td>
|
||||||
<td>
|
<td>
|
||||||
<span class="badge bg-{{ 'success' if res.status == 'CONFIRMED' else ('warning' if res.status == 'PENDING' else 'secondary') }}">
|
<span class="badge bg-{{ 'success' if res.status == 'CONFIRMED' else 'warning' if res.status == 'PENDING' else 'secondary' }}">
|
||||||
{{ res.status }}
|
{{ res.status }}
|
||||||
</span>
|
</span>
|
||||||
</td>
|
</td>
|
||||||
@@ -0,0 +1,194 @@
|
|||||||
|
<!DOCTYPE html>
|
||||||
|
<html lang="{{ current_lang }}" data-bs-theme="dark">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||||
|
<title>{% block title %}{% trans %}Edu-Space Admin{% endtrans %}{% endblock %}</title>
|
||||||
|
|
||||||
|
<!-- Favicon -->
|
||||||
|
<link rel="icon" type="image/png" href="{{ url_for('static', filename='img/favicon.png') }}">
|
||||||
|
|
||||||
|
<!-- Script Anti-Flicker para Modo Claro / Oscuro -->
|
||||||
|
<script>
|
||||||
|
(function() {
|
||||||
|
let userTheme = "{{ current_user.theme_preference if (current_user and current_user.is_authenticated) else '' }}";
|
||||||
|
let theme = userTheme;
|
||||||
|
if (!theme || theme === 'auto') {
|
||||||
|
const storedTheme = localStorage.getItem('theme');
|
||||||
|
theme = storedTheme || (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
|
||||||
|
}
|
||||||
|
document.documentElement.setAttribute('data-bs-theme', theme);
|
||||||
|
})();
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<!-- Bootstrap 5 CSS -->
|
||||||
|
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
|
||||||
|
<!-- Bootstrap Icons -->
|
||||||
|
<link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.0/font/bootstrap-icons.css" rel="stylesheet">
|
||||||
|
<!-- Design System & Custom Theme -->
|
||||||
|
<link href="{{ url_for('static', filename='css/theme.css') }}" rel="stylesheet">
|
||||||
|
<link href="{{ url_for('static', filename='css/style.css') }}" rel="stylesheet">
|
||||||
|
|
||||||
|
{% block extra_css %}{% endblock %}
|
||||||
|
</head>
|
||||||
|
<body data-user-authenticated="{{ 'true' if (current_user and current_user.is_authenticated) else 'false' }}">
|
||||||
|
{% if current_user.is_authenticated %}
|
||||||
|
<!-- Navigation -->
|
||||||
|
<nav class="navbar navbar-expand-lg navbar-dark navbar-app fixed-top">
|
||||||
|
<div class="container-fluid">
|
||||||
|
<a class="navbar-brand d-flex align-items-center" href="{{ url_for('main.dashboard') }}">
|
||||||
|
<img src="{{ url_for('static', filename='img/logo_unicaba_mini.png') }}" alt="Logo UniCABA" class="navbar-logo me-2">
|
||||||
|
<span>Edu-Space Admin</span>
|
||||||
|
</a>
|
||||||
|
|
||||||
|
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
|
||||||
|
<span class="navbar-toggler-icon"></span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
<div class="collapse navbar-collapse" id="navbarNav">
|
||||||
|
<ul class="navbar-nav me-auto">
|
||||||
|
<li class="nav-item">
|
||||||
|
<a class="nav-link" href="{{ url_for('main.dashboard') }}">
|
||||||
|
<i class="bi bi-speedometer2"></i> {% trans %}Dashboard{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
<li class="nav-item dropdown">
|
||||||
|
<a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown">
|
||||||
|
<i class="bi bi-door-open"></i> {% trans %}Classrooms{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<ul class="dropdown-menu">
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('classrooms.list_classrooms') }}">
|
||||||
|
<i class="bi bi-list"></i> {% trans %}All Classrooms{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('classrooms.add_classroom') }}">
|
||||||
|
<i class="bi bi-plus-circle"></i> {% trans %}Add Classroom{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
{% endif %}
|
||||||
|
<li><hr class="dropdown-divider"></li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('buildings.list_buildings') }}">
|
||||||
|
<i class="bi bi-buildings"></i> {% trans %}Buildings{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li class="nav-item dropdown">
|
||||||
|
<a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown">
|
||||||
|
<i class="bi bi-calendar3"></i> {% trans %}Schedule{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<ul class="dropdown-menu">
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('schedule.calendar_view') }}">
|
||||||
|
<i class="bi bi-calendar-week"></i> {% trans %}Calendar View{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('schedule.list_reservations') }}">
|
||||||
|
<i class="bi bi-list-check"></i> {% trans %}All Reservations{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
{% if current_user.has_permission('reservations', 'read_write') %}
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('schedule.add_reservation') }}">
|
||||||
|
<i class="bi bi-plus-circle"></i> {% trans %}New Reservation{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
{% endif %}
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('schedule.today_schedule') }}">
|
||||||
|
<i class="bi bi-calendar-today"></i> {% trans %}Today's Schedule{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
{% if current_user.is_authenticated and current_user.can_manage() %}
|
||||||
|
<li class="nav-item dropdown">
|
||||||
|
<a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown">
|
||||||
|
<i class="bi bi-shield-lock"></i> {% trans %}Management{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<ul class="dropdown-menu shadow-sm">
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('admin.users_list') }}"><i class="bi bi-people me-2"></i>{% trans %}Users{% endtrans %}</a></li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('admin.roles_list') }}"><i class="bi bi-person-badge me-2"></i>{% trans %}Roles & Groups{% endtrans %}</a></li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('buildings.list_buildings') }}"><i class="bi bi-buildings me-2"></i>{% trans %}Buildings{% endtrans %}</a></li>
|
||||||
|
<li><hr class="dropdown-divider"></li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('admin.google_sheets_import') }}"><i class="bi bi-file-earmark-spreadsheet me-2 text-success"></i>{% trans %}Import from Google Sheets{% endtrans %}</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
{% endif %}
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<ul class="navbar-nav align-items-center">
|
||||||
|
<!-- Theme Mode Toggle Button -->
|
||||||
|
<li class="nav-item me-2">
|
||||||
|
<button class="theme-toggle-btn" type="button" aria-label="Cambiar tema" title="Modo Claro/Oscuro">
|
||||||
|
<i class="bi bi-moon-stars-fill"></i>
|
||||||
|
</button>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<!-- Language Switcher -->
|
||||||
|
<li class="nav-item me-2">
|
||||||
|
{% include 'partials/language_switcher.html' %}
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<!-- User Dropdown with Avatar -->
|
||||||
|
<li class="nav-item dropdown">
|
||||||
|
<a class="nav-link dropdown-toggle d-flex align-items-center py-1" href="#" role="button" data-bs-toggle="dropdown">
|
||||||
|
<span class="user-avatar-small">{{ current_user.name[:1]|upper if current_user.name else 'U' }}</span>
|
||||||
|
<span>{{ current_user.first_name }}</span>
|
||||||
|
</a>
|
||||||
|
<ul class="dropdown-menu dropdown-menu-end shadow-sm border-0">
|
||||||
|
<li>
|
||||||
|
<div class="px-3 py-2 border-bottom">
|
||||||
|
<small class="text-muted d-block">{% trans %}Signed in as{% endtrans %}</small>
|
||||||
|
<span class="fw-bold small">{{ current_user.email }}</span>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('auth.profile') }}">
|
||||||
|
<i class="bi bi-person me-2"></i> {% trans %}Profile{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
<li><a class="dropdown-item" href="{{ url_for('auth.change_password') }}">
|
||||||
|
<i class="bi bi-key me-2"></i> {% trans %}Change Password{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
<li><hr class="dropdown-divider"></li>
|
||||||
|
<li><a class="dropdown-item text-danger" href="{{ url_for('auth.logout') }}">
|
||||||
|
<i class="bi bi-box-arrow-right me-2"></i> {% trans %}Logout{% endtrans %}
|
||||||
|
</a></li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</nav>
|
||||||
|
{% endif %}
|
||||||
|
|
||||||
|
<!-- Flash Messages -->
|
||||||
|
<div class="toast-container position-fixed bottom-0 end-0 p-3" style="z-index: 1080;">
|
||||||
|
{% with messages = get_flashed_messages(with_categories=true) %}
|
||||||
|
{% if messages %}
|
||||||
|
{% for category, message in messages %}
|
||||||
|
<div class="toast align-items-center text-white bg-{{ 'danger' if category == 'error' else 'success' if category == 'success' else 'info' if category == 'info' else 'warning' }} border-0 shadow" role="alert">
|
||||||
|
<div class="d-flex">
|
||||||
|
<div class="toast-body">
|
||||||
|
{{ message }}
|
||||||
|
</div>
|
||||||
|
<button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast"></button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endfor %}
|
||||||
|
{% endif %}
|
||||||
|
{% endwith %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Main Content -->
|
||||||
|
{% block content %}{% endblock %}
|
||||||
|
|
||||||
|
<!-- Bootstrap JS -->
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
|
||||||
|
<!-- jQuery -->
|
||||||
|
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
|
||||||
|
<!-- Theme Toggle JS -->
|
||||||
|
<script src="{{ url_for('static', filename='js/theme-toggle.js') }}"></script>
|
||||||
|
<!-- Custom JS -->
|
||||||
|
<script src="{{ url_for('static', filename='js/main.js') }}"></script>
|
||||||
|
|
||||||
|
<!-- Show flash messages -->
|
||||||
|
<script>
|
||||||
|
$(document).ready(function() {
|
||||||
|
$('.toast').toast('show');
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
|
||||||
|
{% block extra_js %}{% endblock %}
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,95 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}
|
||||||
|
{% if building %}{% trans %}Editar Edificio{% endtrans %} - {{ building.name }}{% else %}{% trans %}Nuevo Edificio{% endtrans %}{% endif %} - Edu-Space Admin
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-lg-8 mx-auto">
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4">
|
||||||
|
<h1 class="h3 mb-0">
|
||||||
|
<i class="bi bi-buildings text-primary me-2"></i>
|
||||||
|
{% if building %}{% trans %}Editar Edificio{% endtrans %}{% else %}{% trans %}Nuevo Edificio{% endtrans %}{% endif %}
|
||||||
|
</h1>
|
||||||
|
<a href="{{ url_for('buildings.list_buildings') }}" class="btn btn-outline-secondary">
|
||||||
|
<i class="bi bi-arrow-left me-1"></i>{% trans %}Volver a Edificios{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<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-info-circle text-primary me-2"></i>{% trans %}Información del Edificio / Sede{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
</div>
|
||||||
|
<div class="card-body p-4">
|
||||||
|
<form method="POST" novalidate>
|
||||||
|
{{ form.hidden_tag() }}
|
||||||
|
|
||||||
|
<div class="row g-3">
|
||||||
|
<div class="col-md-8">
|
||||||
|
{{ 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") }}
|
||||||
|
{% if form.name.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.name.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4">
|
||||||
|
{{ 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") }}
|
||||||
|
{% if form.code.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.code.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
<small class="text-muted">{% trans %}Código identificador corto{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-8">
|
||||||
|
{{ 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") }}
|
||||||
|
{% if form.address.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.address.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4">
|
||||||
|
{{ form.floors.label(class="form-label fw-semibold") }}
|
||||||
|
{{ form.floors(class="form-control" + (" is-invalid" if form.floors.errors else ""), min=1, max=100) }}
|
||||||
|
{% if form.floors.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.floors.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
<small class="text-muted">{% trans %}Cantidad de plantas/pisos{% endtrans %}</small>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-12">
|
||||||
|
{{ form.description.label(class="form-label fw-semibold") }}
|
||||||
|
{{ form.description(class="form-control", rows=3, placeholder="Información relevante, accesos, comodidades o departamentos alojados...") }}
|
||||||
|
{% if form.description.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.description.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-12">
|
||||||
|
<div class="form-check form-switch pt-2">
|
||||||
|
{{ form.is_active(class="form-check-input", role="switch") }}
|
||||||
|
{{ form.is_active.label(class="form-check-label fw-semibold") }}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="d-flex justify-content-end gap-2 mt-4 pt-3 border-top">
|
||||||
|
<a href="{{ url_for('buildings.list_buildings') }}" class="btn btn-outline-secondary">{% trans %}Cancelar{% endtrans %}</a>
|
||||||
|
<button type="submit" class="btn btn-primary px-4">
|
||||||
|
<i class="bi bi-check-circle me-1"></i>
|
||||||
|
{% if building %}{% trans %}Guardar Cambios{% endtrans %}{% else %}{% trans %}Crear Edificio{% endtrans %}{% endif %}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{% extends "base.html" %}
|
{% extends "base.html" %}
|
||||||
|
|
||||||
{% block title %}Gestión de Edificios - Edu-Space Admin{% endblock %}
|
{% block title %}{% trans %}Gestión de Edificios{% endtrans %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
<div class="container-fluid pt-5 mt-4">
|
<div class="container-fluid pt-5 mt-4">
|
||||||
@@ -8,31 +8,22 @@
|
|||||||
<div class="row mb-4 align-items-center">
|
<div class="row mb-4 align-items-center">
|
||||||
<div class="col-md-7">
|
<div class="col-md-7">
|
||||||
<h1 class="h3 mb-1">
|
<h1 class="h3 mb-1">
|
||||||
<i class="bi bi-buildings text-primary me-2"></i>Gestión de Edificios
|
<i class="bi bi-buildings text-primary me-2"></i>{% trans %}Gestión de Edificios{% endtrans %}
|
||||||
</h1>
|
</h1>
|
||||||
<p class="text-muted small mb-0">Administra las sedes, edificios físicos y campus virtuales de UniCABA</p>
|
<p class="text-muted small mb-0">{% trans %}Administra las sedes, edificios físicos y campus virtuales de UniCABA{% endtrans %}</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">
|
||||||
{% if user.has_permission('classrooms', 'read_write') %}
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<a href="/buildings/add_building" class="btn btn-primary me-2">
|
<a href="{{ url_for('buildings.add_building') }}" class="btn btn-primary me-2">
|
||||||
<i class="bi bi-plus-circle me-1"></i>Nuevo Edificio
|
<i class="bi bi-plus-circle me-1"></i>{% trans %}Nuevo Edificio{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
<a href="/classrooms/list_classrooms" class="btn btn-outline-secondary">
|
<a href="{{ url_for('classrooms.list_classrooms') }}" class="btn btn-outline-secondary">
|
||||||
<i class="bi bi-door-open me-1"></i>Ver Aulas
|
<i class="bi bi-door-open me-1"></i>{% trans %}Ver Aulas{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- Alertas de estado -->
|
|
||||||
{% if success or updated or created %}
|
|
||||||
<div class="alert alert-success alert-dismissible fade show border-0 shadow-sm mb-4" role="alert">
|
|
||||||
<i class="bi bi-check-circle-fill me-2"></i>
|
|
||||||
{% if created %}El edificio ha sido creado exitosamente.{% else %}Los datos del edificio se actualizaron correctamente.{% endif %}
|
|
||||||
<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
|
|
||||||
</div>
|
|
||||||
{% endif %}
|
|
||||||
|
|
||||||
<!-- Statistics Cards -->
|
<!-- Statistics Cards -->
|
||||||
<div class="row g-3 mb-4">
|
<div class="row g-3 mb-4">
|
||||||
<div class="col-sm-6 col-xl-3">
|
<div class="col-sm-6 col-xl-3">
|
||||||
@@ -43,9 +34,8 @@
|
|||||||
<i class="bi bi-buildings fs-3"></i>
|
<i class="bi bi-buildings fs-3"></i>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
<div class="text-muted small fw-semibold">Sedes y Edificios</div>
|
<div class="text-muted small fw-semibold">{% trans %}Total Edificios{% endtrans %}</div>
|
||||||
<h3 class="fw-bold mb-0">{{ buildings|length }}</h3>
|
<h3 class="fw-bold mb-0">{{ buildings|length }}</h3>
|
||||||
<small class="text-muted" style="font-size: 0.72rem;">Físicas y Digitales</small>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -60,9 +50,8 @@
|
|||||||
<i class="bi bi-door-open fs-3"></i>
|
<i class="bi bi-door-open fs-3"></i>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
<div class="text-muted small fw-semibold">Aulas Totales</div>
|
<div class="text-muted small fw-semibold">{% trans %}Aulas Activas{% endtrans %}</div>
|
||||||
<h3 class="fw-bold mb-0 text-success">{{ total_classrooms }}</h3>
|
<h3 class="fw-bold mb-0 text-success">{{ total_classrooms }}</h3>
|
||||||
<small class="text-muted" style="font-size: 0.72rem;">Activas en el sistema</small>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -77,11 +66,8 @@
|
|||||||
<i class="bi bi-people fs-3"></i>
|
<i class="bi bi-people fs-3"></i>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
<div class="text-muted small fw-semibold">Capacidad Física Instalada</div>
|
<div class="text-muted small fw-semibold">{% trans %}Capacidad Total{% endtrans %}</div>
|
||||||
<h3 class="fw-bold mb-0 text-info">{{ total_physical_capacity or total_capacity }}</h3>
|
<h3 class="fw-bold mb-0 text-info">{{ total_capacity }}</h3>
|
||||||
<small class="text-info fw-semibold" style="font-size: 0.72rem;">
|
|
||||||
<i class="bi bi-cloud-check me-1"></i>+ Campus Virtual (Ilimitado)
|
|
||||||
</small>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -96,9 +82,8 @@
|
|||||||
<i class="bi bi-layers fs-3"></i>
|
<i class="bi bi-layers fs-3"></i>
|
||||||
</div>
|
</div>
|
||||||
<div>
|
<div>
|
||||||
<div class="text-muted small fw-semibold">Pisos Presenciales</div>
|
<div class="text-muted small fw-semibold">{% trans %}Pisos Disponibles{% endtrans %}</div>
|
||||||
<h3 class="fw-bold mb-0 text-warning">{{ total_floors or 4 }}</h3>
|
<h3 class="fw-bold mb-0 text-warning">{{ buildings|sum(attribute='floors') }}</h3>
|
||||||
<small class="text-muted" style="font-size: 0.72rem;">Plantas físicas activas</small>
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -115,20 +100,20 @@
|
|||||||
<span class="input-group-text bg-body-tertiary border-end-0">
|
<span class="input-group-text bg-body-tertiary border-end-0">
|
||||||
<i class="bi bi-search text-muted"></i>
|
<i class="bi bi-search text-muted"></i>
|
||||||
</span>
|
</span>
|
||||||
<input type="text" name="search" value="{{ search }}" class="form-control border-start-0" placeholder="Buscar por nombre, código o dirección...">
|
<input type="text" name="search" value="{{ search }}" class="form-control border-start-0" placeholder="{% trans %}Buscar por nombre, código o dirección...{% endtrans %}">
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-md-4">
|
<div class="col-md-4">
|
||||||
<select name="status" class="form-select" onchange="this.form.submit()">
|
<select name="status" class="form-select" onchange="this.form.submit()">
|
||||||
<option value="">Todos los estados</option>
|
<option value="">{% trans %}Todos los estados{% endtrans %}</option>
|
||||||
<option value="active" {% if status_filter == 'active' %}selected{% endif %}>Activos únicamente</option>
|
<option value="active" {% if status_filter == 'active' %}selected{% endif %}>{% trans %}Activos únicamente{% endtrans %}</option>
|
||||||
<option value="inactive" {% if status_filter == 'inactive' %}selected{% endif %}>Inactivos</option>
|
<option value="inactive" {% if status_filter == 'inactive' %}selected{% endif %}>{% trans %}Inactivos{% endtrans %}</option>
|
||||||
</select>
|
</select>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-md-2 d-flex gap-2">
|
<div class="col-md-2 d-flex gap-2">
|
||||||
<button type="submit" class="btn btn-primary w-100">Buscar</button>
|
<button type="submit" class="btn btn-primary w-100">{% trans %}Buscar{% endtrans %}</button>
|
||||||
{% if search or status_filter %}
|
{% if search or status_filter %}
|
||||||
<a href="/buildings/list_buildings" class="btn btn-outline-secondary" title="Limpiar filtro">
|
<a href="{{ url_for('buildings.list_buildings') }}" class="btn btn-outline-secondary" title="{% trans %}Limpiar filtro{% endtrans %}">
|
||||||
<i class="bi bi-x-lg"></i>
|
<i class="bi bi-x-lg"></i>
|
||||||
</a>
|
</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
@@ -141,14 +126,14 @@
|
|||||||
<div class="row g-3">
|
<div class="row g-3">
|
||||||
{% for b in buildings %}
|
{% for b in buildings %}
|
||||||
<div class="col-lg-6">
|
<div class="col-lg-6">
|
||||||
<div class="card border-0 shadow-sm h-100 position-relative {% if b.is_virtual %}border-start border-4 border-info{% endif %}">
|
<div class="card border-0 shadow-sm h-100 position-relative">
|
||||||
<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">
|
||||||
<div>
|
<div>
|
||||||
<span class="badge {% if b.is_virtual %}bg-info-subtle text-info border border-info-subtle{% else %}bg-secondary-subtle text-secondary border{% endif %} font-monospace mb-1">
|
<span class="badge bg-secondary-subtle text-secondary font-monospace border mb-1">
|
||||||
{% if b.is_virtual %}<i class="bi bi-cloud-fill me-1"></i>{% endif %}{{ b.code or 'EDIF' }}
|
{{ b.code or 'EDIF' }}
|
||||||
</span>
|
</span>
|
||||||
<h5 class="card-title fw-bold mb-0">
|
<h5 class="card-title fw-bold mb-0">
|
||||||
<a href="/buildings/view/{{ b.id }}" class="text-decoration-none text-primary">
|
<a href="{{ url_for('buildings.view_building', id=b.id) }}" class="text-decoration-none text-primary">
|
||||||
{{ b.name }}
|
{{ b.name }}
|
||||||
</a>
|
</a>
|
||||||
</h5>
|
</h5>
|
||||||
@@ -156,11 +141,11 @@
|
|||||||
<div>
|
<div>
|
||||||
{% if b.is_active %}
|
{% if b.is_active %}
|
||||||
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
|
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
|
||||||
<i class="bi bi-check-circle me-1"></i>Activo
|
<i class="bi bi-check-circle me-1"></i>{% trans %}Activo{% endtrans %}
|
||||||
</span>
|
</span>
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
|
<span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
|
||||||
<i class="bi bi-x-circle me-1"></i>Inactivo
|
<i class="bi bi-x-circle me-1"></i>{% trans %}Inactivo{% endtrans %}
|
||||||
</span>
|
</span>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
@@ -168,7 +153,7 @@
|
|||||||
<div class="card-body">
|
<div class="card-body">
|
||||||
{% if b.address %}
|
{% if b.address %}
|
||||||
<p class="text-muted small mb-3">
|
<p class="text-muted small mb-3">
|
||||||
<i class="bi {% if b.is_virtual %}bi-globe2 text-info{% else %}bi-geo-alt-fill text-danger{% endif %} me-1"></i>{{ b.address }}
|
<i class="bi bi-geo-alt-fill text-danger me-1"></i>{{ b.address }}
|
||||||
</p>
|
</p>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
@@ -179,46 +164,36 @@
|
|||||||
<div class="row g-2 text-center pt-2 border-top">
|
<div class="row g-2 text-center pt-2 border-top">
|
||||||
<div class="col-4">
|
<div class="col-4">
|
||||||
<div class="p-2 rounded bg-body-tertiary">
|
<div class="p-2 rounded bg-body-tertiary">
|
||||||
<small class="text-muted d-block">Pisos</small>
|
<small class="text-muted d-block">{% trans %}Pisos{% endtrans %}</small>
|
||||||
{% if b.is_virtual %}
|
|
||||||
<span class="badge bg-info-subtle text-info border border-info-subtle mt-1">Digital</span>
|
|
||||||
{% else %}
|
|
||||||
<span class="fw-bold fs-6">{{ b.floors }}</span>
|
<span class="fw-bold fs-6">{{ b.floors }}</span>
|
||||||
{% endif %}
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-4">
|
<div class="col-4">
|
||||||
<div class="p-2 rounded bg-body-tertiary">
|
<div class="p-2 rounded bg-body-tertiary">
|
||||||
<small class="text-muted d-block">Aulas</small>
|
<small class="text-muted d-block">{% trans %}Aulas{% endtrans %}</small>
|
||||||
<span class="fw-bold fs-6 text-primary">{{ b.classrooms_count }}</span>
|
<span class="fw-bold fs-6 text-primary">{{ b.classrooms_count }}</span>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-4">
|
<div class="col-4">
|
||||||
<div class="p-2 rounded bg-body-tertiary">
|
<div class="p-2 rounded bg-body-tertiary">
|
||||||
<small class="text-muted d-block">Capacidad</small>
|
<small class="text-muted d-block">{% trans %}Capacidad{% endtrans %}</small>
|
||||||
{% if b.is_virtual %}
|
<span class="fw-bold fs-6 text-success">{{ b.total_capacity }}</span>
|
||||||
<span class="badge bg-primary-subtle text-primary border border-primary-subtle mt-1" title="Capacidad de concurrencia virtual ilimitada">
|
|
||||||
<i class="bi bi-infinity me-1"></i>Ilimitada
|
|
||||||
</span>
|
|
||||||
{% else %}
|
|
||||||
<span class="fw-bold fs-6 text-success">{{ b.physical_capacity or b.total_capacity }}</span>
|
|
||||||
{% endif %}
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-footer bg-transparent border-0 py-3 d-flex justify-content-between align-items-center">
|
<div class="card-footer bg-transparent border-0 py-3 d-flex justify-content-between align-items-center">
|
||||||
<a href="/buildings/view/{{ b.id }}" class="btn btn-outline-primary btn-sm">
|
<a href="{{ url_for('buildings.view_building', id=b.id) }}" class="btn btn-outline-primary btn-sm">
|
||||||
<i class="bi bi-eye me-1"></i>Ver Aulas
|
<i class="bi bi-eye me-1"></i>{% trans %}Ver Distribución de Aulas{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
|
|
||||||
{% if user.has_permission('classrooms', 'read_write') or user.is_admin() or user.is_bedelia() %}
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<div class="btn-group">
|
<div class="btn-group">
|
||||||
<a href="/buildings/edit/{{ b.id }}" class="btn btn-outline-secondary btn-sm" title="Editar Edificio">
|
<a href="{{ url_for('buildings.edit_building', id=b.id) }}" class="btn btn-outline-secondary btn-sm" title="{% trans %}Editar Edificio{% endtrans %}">
|
||||||
<i class="bi bi-pencil me-1"></i>Editar
|
<i class="bi bi-pencil"></i>
|
||||||
</a>
|
</a>
|
||||||
<form method="POST" action="/buildings/toggle/{{ b.id }}" class="d-inline">
|
<form method="POST" action="{{ url_for('buildings.toggle_building', id=b.id) }}" class="d-inline">
|
||||||
<button type="submit" class="btn btn-outline-secondary btn-sm" title="{% if b.is_active %}Desactivar{% else %}Activar{% endif %}">
|
<button type="submit" class="btn btn-outline-secondary btn-sm" title="{% if b.is_active %}{% trans %}Desactivar{% endtrans %}{% else %}{% trans %}Activar{% endtrans %}{% endif %}">
|
||||||
<i class="bi bi-power"></i>
|
<i class="bi bi-power"></i>
|
||||||
</button>
|
</button>
|
||||||
</form>
|
</form>
|
||||||
@@ -231,12 +206,12 @@
|
|||||||
<div class="col-12">
|
<div class="col-12">
|
||||||
<div class="card border-0 shadow-sm p-5 text-center">
|
<div class="card border-0 shadow-sm p-5 text-center">
|
||||||
<i class="bi bi-buildings text-muted fs-1 mb-3"></i>
|
<i class="bi bi-buildings text-muted fs-1 mb-3"></i>
|
||||||
<h5 class="fw-bold">No se encontraron edificios</h5>
|
<h5 class="fw-bold">{% trans %}No se encontraron edificios{% endtrans %}</h5>
|
||||||
<p class="text-muted mb-3">No hay edificios que coincidan con los criterios de búsqueda.</p>
|
<p class="text-muted mb-3">{% trans %}No hay edificios que coincidan con los criterios de búsqueda.{% endtrans %}</p>
|
||||||
{% if user.has_permission('classrooms', 'read_write') %}
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<div>
|
<div>
|
||||||
<a href="/buildings/add_building" class="btn btn-primary">
|
<a href="{{ url_for('buildings.add_building') }}" class="btn btn-primary">
|
||||||
<i class="bi bi-plus-circle me-1"></i>Crear Nuevo Edificio
|
<i class="bi bi-plus-circle me-1"></i>{% trans %}Crear Nuevo Edificio{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
@@ -1,37 +1,39 @@
|
|||||||
{% extends "base.html" %}
|
{% extends "base.html" %}
|
||||||
|
|
||||||
{% block title %}{{ building.name }} - Detalle del Edificio - Edu-Space Admin{% endblock %}
|
{% block title %}{{ building.name }} - {% trans %}Detalle del Edificio{% endtrans %} - 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 Limpio sin breadcrumbs redundantes -->
|
<!-- Breadcrumb & Header -->
|
||||||
<div class="row mb-4 align-items-center pb-2 border-bottom border-light-subtle">
|
<div class="row mb-4 align-items-center">
|
||||||
<div class="col-md-7">
|
<div class="col-md-7">
|
||||||
<h1 class="h3 mb-1 d-flex align-items-center flex-wrap gap-2">
|
<nav aria-label="breadcrumb">
|
||||||
<i class="bi bi-buildings text-primary me-1"></i> {{ building.name }}
|
<ol class="breadcrumb mb-1 small">
|
||||||
|
<li class="breadcrumb-item"><a href="{{ url_for('buildings.list_buildings') }}">{% trans %}Edificios{% endtrans %}</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">
|
||||||
<i class="bi bi-check-circle me-1"></i>Activo
|
<i class="bi bi-check-circle me-1"></i>{% trans %}Activo{% endtrans %}
|
||||||
</span>
|
</span>
|
||||||
{% else %}
|
{% else %}
|
||||||
<span class="badge bg-danger-subtle text-danger border border-danger-subtle fs-6">
|
<span class="badge bg-danger-subtle text-danger border border-danger-subtle fs-6">
|
||||||
<i class="bi bi-x-circle me-1"></i>Inactivo
|
<i class="bi bi-x-circle me-1"></i>{% trans %}Inactivo{% endtrans %}
|
||||||
</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">
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<i class="bi bi-arrow-left me-1"></i>Volver a Edificios
|
<a href="{{ url_for('buildings.edit_building', id=building.id) }}" class="btn btn-outline-secondary me-2">
|
||||||
|
<i class="bi bi-pencil me-1"></i>{% trans %}Editar Edificio{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
{% if user.has_permission('classrooms', 'read_write') or user.is_admin() or user.is_bedelia() %}
|
<a href="{{ url_for('classrooms.add_classroom') }}" class="btn btn-primary">
|
||||||
<a href="/buildings/edit/{{ building.id }}" class="btn btn-outline-primary btn-sm me-2">
|
<i class="bi bi-plus-circle me-1"></i>{% trans %}Nueva Aula{% endtrans %}
|
||||||
<i class="bi bi-pencil me-1"></i>Editar Edificio
|
|
||||||
</a>
|
|
||||||
<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
|
|
||||||
</a>
|
</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
@@ -42,9 +44,9 @@
|
|||||||
<div class="col-md-4">
|
<div class="col-md-4">
|
||||||
<div class="card border-0 shadow-sm h-100">
|
<div class="card border-0 shadow-sm h-100">
|
||||||
<div class="card-body p-3">
|
<div class="card-body p-3">
|
||||||
<div class="text-muted small fw-semibold">Ubicación / Dirección</div>
|
<div class="text-muted small fw-semibold">{% trans %}Ubicación / Dirección{% endtrans %}</div>
|
||||||
<p class="h6 fw-bold mb-2">
|
<p class="h6 fw-bold mb-2">
|
||||||
<i class="bi {% if building.is_virtual %}bi-globe2 text-info{% else %}bi-geo-alt text-danger{% endif %} me-1"></i>{{ building.address or 'Sin dirección especificada' }}
|
<i class="bi bi-geo-alt text-danger me-1"></i>{{ building.address or 'Sin dirección especificada' }}
|
||||||
</p>
|
</p>
|
||||||
{% if building.description %}
|
{% if building.description %}
|
||||||
<small class="text-secondary">{{ building.description }}</small>
|
<small class="text-secondary">{{ building.description }}</small>
|
||||||
@@ -56,30 +58,20 @@
|
|||||||
<div class="row g-3">
|
<div class="row g-3">
|
||||||
<div class="col-sm-4">
|
<div class="col-sm-4">
|
||||||
<div class="card border-0 shadow-sm text-center p-3">
|
<div class="card border-0 shadow-sm text-center p-3">
|
||||||
<small class="text-muted text-uppercase fw-bold">Pisos</small>
|
<small class="text-muted text-uppercase fw-bold">{% trans %}Pisos{% endtrans %}</small>
|
||||||
{% if building.is_virtual %}
|
|
||||||
<span class="fs-5 fw-bold text-info d-block mt-2">Digital / Nube</span>
|
|
||||||
{% else %}
|
|
||||||
<span class="display-6 fw-bold text-primary">{{ building.floors }}</span>
|
<span class="display-6 fw-bold text-primary">{{ building.floors }}</span>
|
||||||
{% endif %}
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-sm-4">
|
<div class="col-sm-4">
|
||||||
<div class="card border-0 shadow-sm text-center p-3">
|
<div class="card border-0 shadow-sm text-center p-3">
|
||||||
<small class="text-muted text-uppercase fw-bold">Aulas Asociadas</small>
|
<small class="text-muted text-uppercase fw-bold">{% trans %}Aulas Asociadas{% endtrans %}</small>
|
||||||
<span class="display-6 fw-bold text-success">{{ classrooms|length }}</span>
|
<span class="display-6 fw-bold text-success">{{ classrooms|length }}</span>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-sm-4">
|
<div class="col-sm-4">
|
||||||
<div class="card border-0 shadow-sm text-center p-3">
|
<div class="card border-0 shadow-sm text-center p-3">
|
||||||
<small class="text-muted text-uppercase fw-bold">Capacidad Total</small>
|
<small class="text-muted text-uppercase fw-bold">{% trans %}Capacidad Total{% endtrans %}</small>
|
||||||
{% if building.is_virtual %}
|
<span class="display-6 fw-bold text-info">{{ building.total_capacity }}</span>
|
||||||
<span class="fs-5 fw-bold text-primary d-block mt-2" title="Capacidad de concurrencia virtual ilimitada">
|
|
||||||
<i class="bi bi-infinity me-1"></i>Ilimitada
|
|
||||||
</span>
|
|
||||||
{% else %}
|
|
||||||
<span class="display-6 fw-bold text-info">{{ building.physical_capacity or building.total_capacity }}</span>
|
|
||||||
{% endif %}
|
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@@ -90,32 +82,32 @@
|
|||||||
<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 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">
|
||||||
<h5 class="mb-0 h6 fw-bold">
|
<h5 class="mb-0 h6 fw-bold">
|
||||||
<i class="bi bi-layers text-primary me-2"></i>Distribución de Aulas por Piso
|
<i class="bi bi-layers text-primary me-2"></i>{% trans %}Distribución de Aulas por Piso{% endtrans %}
|
||||||
</h5>
|
</h5>
|
||||||
<span class="badge badge-brand">{{ classrooms|length }} aulas configuradas</span>
|
<span class="badge badge-brand">{{ classrooms|length }} {% trans %}aulas configuradas{% endtrans %}</span>
|
||||||
</div>
|
</div>
|
||||||
<div class="card-body p-4">
|
<div class="card-body p-4">
|
||||||
{% if floors_list and (classrooms|length > 0) %}
|
{% if classrooms_by_floor %}
|
||||||
{% for fl in floors_list %}
|
{% for floor_num in classrooms_by_floor|sort %}
|
||||||
<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>
|
||||||
{{ fl.floor_name }}
|
{% if floor_num == 0 %}Planta Baja{% else %}Piso {{ floor_num }}{% endif %}
|
||||||
</span>
|
</span>
|
||||||
<div class="border-bottom flex-grow-1"></div>
|
<div class="border-bottom flex-grow-1"></div>
|
||||||
<small class="text-muted ms-2">{{ fl.classrooms|length }} aula(s)</small>
|
<small class="text-muted ms-2">{{ classrooms_by_floor[floor_num]|length }} aulas</small>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="row g-3">
|
<div class="row g-3">
|
||||||
{% for c in fl.classrooms %}
|
{% for c in classrooms_by_floor[floor_num] %}
|
||||||
<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?id={{ c.id }}" class="text-decoration-none text-primary">
|
<a href="{{ url_for('classrooms.view_classroom', id=c.id) }}" class="text-decoration-none text-primary">
|
||||||
<i class="bi bi-door-open me-1"></i>{{ c.code or c.room_number or ('Aula ' + c.id) }}
|
<i class="bi bi-door-open me-1"></i>{{ c.code }}
|
||||||
</a>
|
</a>
|
||||||
</h6>
|
</h6>
|
||||||
{% if c.is_active %}
|
{% if c.is_active %}
|
||||||
@@ -126,7 +118,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 or 35 }}</strong> estudiantes
|
<i class="bi bi-people me-1"></i>Capacidad: <strong>{{ c.capacity }}</strong> estudiantes
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
{% if c.description %}
|
{% if c.description %}
|
||||||
@@ -134,15 +126,12 @@
|
|||||||
{% 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?id={{ c.id }}" class="btn btn-outline-primary btn-sm py-0 px-2">
|
<a href="{{ url_for('classrooms.view_classroom', id=c.id) }}" class="btn btn-outline-primary btn-sm py-0 px-2">
|
||||||
<small>Ver Ficha</small>
|
<small>{% trans %}Ver Ficha{% endtrans %}</small>
|
||||||
</a>
|
</a>
|
||||||
<a href="/schedule/add_reservation?classroom_id={{ c.id }}" class="btn btn-outline-success btn-sm py-0 px-2">
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<small><i class="bi bi-calendar-plus me-1"></i>Reservar</small>
|
<a href="{{ url_for('classrooms.edit_classroom', id=c.id) }}" class="btn btn-outline-secondary btn-sm py-0 px-2">
|
||||||
</a>
|
<small>{% trans %}Editar{% endtrans %}</small>
|
||||||
{% if user.has_permission('classrooms', 'read_write') %}
|
|
||||||
<a href="/classrooms/edit_classroom?id={{ c.id }}" class="btn btn-outline-secondary btn-sm py-0 px-2">
|
|
||||||
<small>Editar</small>
|
|
||||||
</a>
|
</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
@@ -156,11 +145,11 @@
|
|||||||
{% else %}
|
{% else %}
|
||||||
<div class="text-center py-5">
|
<div class="text-center py-5">
|
||||||
<i class="bi bi-door-closed text-muted fs-1 mb-2"></i>
|
<i class="bi bi-door-closed text-muted fs-1 mb-2"></i>
|
||||||
<h6 class="fw-bold">No hay aulas asignadas a este edificio</h6>
|
<h6 class="fw-bold">{% trans %}No hay aulas asignadas a este edificio{% endtrans %}</h6>
|
||||||
<p class="text-muted small mb-3">Puedes crear aulas nuevas o editar las existentes para vincularlas aquí.</p>
|
<p class="text-muted small mb-3">{% trans %}Puedes crear aulas nuevas o editar las existentes para vincularlas aquí.{% endtrans %}</p>
|
||||||
{% if user.has_permission('classrooms', 'read_write') %}
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<a href="/classrooms/add_classroom" class="btn btn-primary btn-sm">
|
<a href="{{ url_for('classrooms.add_classroom') }}" class="btn btn-primary btn-sm">
|
||||||
<i class="bi bi-plus-circle me-1"></i>Agregar Primera Aula
|
<i class="bi bi-plus-circle me-1"></i>{% trans %}Agregar Primera Aula{% endtrans %}
|
||||||
</a>
|
</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
</div>
|
</div>
|
||||||
@@ -169,16 +158,16 @@
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- Danger Zone (Delete) -->
|
<!-- Danger Zone (Delete) -->
|
||||||
{% if user.has_permission('classrooms', 'read_write') %}
|
{% if current_user.has_permission('classrooms', 'read_write') %}
|
||||||
<div class="card border-danger border-opacity-25 shadow-sm mb-4">
|
<div class="card border-danger border-opacity-25 shadow-sm mb-4">
|
||||||
<div class="card-body p-3 d-flex justify-content-between align-items-center flex-wrap gap-2">
|
<div class="card-body p-3 d-flex justify-content-between align-items-center flex-wrap gap-2">
|
||||||
<div>
|
<div>
|
||||||
<h6 class="text-danger fw-bold mb-1">Eliminar Edificio</h6>
|
<h6 class="text-danger fw-bold mb-1">{% trans %}Eliminar Edificio{% endtrans %}</h6>
|
||||||
<small class="text-muted">Solo es posible eliminar edificios que no tengan aulas asignadas.</small>
|
<small class="text-muted">{% trans %}Solo es posible eliminar edificios que no tengan aulas asignadas.{% endtrans %}</small>
|
||||||
</div>
|
</div>
|
||||||
<form method="POST" action="/buildings/delete_building" onsubmit="return confirm('¿Estás seguro de que deseas eliminar este edificio?');">
|
<form method="POST" action="{{ url_for('buildings.delete_building', id=building.id) }}" onsubmit="return confirm('¿Estás seguro de que deseas eliminar este edificio?');">
|
||||||
<button type="submit" class="btn btn-outline-danger btn-sm" {% if classrooms|length > 0 %}disabled title="Tiene aulas asociadas"{% endif %}>
|
<button type="submit" class="btn btn-outline-danger btn-sm" {% if classrooms|length > 0 %}disabled title="Tiene aulas asociadas"{% endif %}>
|
||||||
<i class="bi bi-trash me-1"></i>Eliminar Edificio
|
<i class="bi bi-trash me-1"></i>{% trans %}Eliminar Edificio{% endtrans %}
|
||||||
</button>
|
</button>
|
||||||
</form>
|
</form>
|
||||||
</div>
|
</div>
|
||||||
@@ -0,0 +1,218 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}{% trans %}Add Classroom{% endtrans %} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-12">
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4">
|
||||||
|
<h1 class="h3">
|
||||||
|
<i class="bi bi-plus-circle text-primary"></i> {% trans %}Add Classroom{% endtrans %}
|
||||||
|
</h1>
|
||||||
|
<a href="{{ url_for('classrooms.list_classrooms') }}" class="btn btn-outline-secondary">
|
||||||
|
<i class="bi bi-arrow-left"></i> {% trans %}Back to Classrooms{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-lg-8 mx-auto">
|
||||||
|
<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-door-open text-primary me-2"></i> {% trans %}Classroom Information{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
</div>
|
||||||
|
<div class="card-body">
|
||||||
|
<form method="POST" id="classroom-form" novalidate>
|
||||||
|
{{ form.hidden_tag() }}
|
||||||
|
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-md-4 mb-3">
|
||||||
|
{{ form.building.label(class="form-label") }}
|
||||||
|
{{ form.building(class="form-control", placeholder="A") }}
|
||||||
|
{% if form.building.errors %}
|
||||||
|
<div class="text-danger small mt-1">
|
||||||
|
{{ form.building.errors[0] }}
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4 mb-3">
|
||||||
|
{{ form.room_number.label(class="form-label") }}
|
||||||
|
{{ form.room_number(class="form-control", placeholder="101") }}
|
||||||
|
{% if form.room_number.errors %}
|
||||||
|
<div class="text-danger small mt-1">
|
||||||
|
{{ form.room_number.errors[0] }}
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4 mb-3">
|
||||||
|
{{ form.floor.label(class="form-label") }}
|
||||||
|
{{ form.floor(class="form-control") }}
|
||||||
|
{% if form.floor.errors %}
|
||||||
|
<div class="text-danger small mt-1">
|
||||||
|
{{ form.floor.errors[0] }}
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-md-6 mb-3">
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-1">
|
||||||
|
{{ form.capacity.label(class="form-label mb-0") }}
|
||||||
|
<button type="button" class="btn btn-sm btn-outline-primary py-0 px-2" id="btnInfinityAdd" style="font-size: 0.8rem;" title="{% trans %}Asignar capacidad ilimitada{% endtrans %}">
|
||||||
|
<i class="bi bi-infinity me-1"></i>{% trans %}Ilimitada (∞){% endtrans %}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
<div class="input-group">
|
||||||
|
{{ form.capacity(class="form-control", id="capacity", placeholder="ej. 30 o ∞") }}
|
||||||
|
<span class="input-group-text bg-body-tertiary text-muted font-monospace"><i class="bi bi-people"></i></span>
|
||||||
|
</div>
|
||||||
|
<div class="form-text small text-muted mt-1">
|
||||||
|
<i class="bi bi-info-circle text-info me-1"></i>{% trans %}Para aulas virtuales o sin límite de aforo, ingrese <strong>∞</strong> o <strong>0</strong> (Capacidad ilimitada).{% endtrans %}
|
||||||
|
</div>
|
||||||
|
{% if form.capacity.errors %}
|
||||||
|
<div class="text-danger small mt-1">
|
||||||
|
{{ form.capacity.errors[0] }}
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-6 mb-3">
|
||||||
|
<label class="form-label d-block"> </label>
|
||||||
|
<div class="form-check pt-2">
|
||||||
|
{{ form.is_active(class="form-check-input") }}
|
||||||
|
{{ form.is_active.label(class="form-check-label") }}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="mb-4">
|
||||||
|
{{ form.description.label(class="form-label") }}
|
||||||
|
{{ form.description(class="form-control", rows="3", placeholder=_("Optional: Add any additional details about this classroom...")) }}
|
||||||
|
{% if form.description.errors %}
|
||||||
|
<div class="text-danger small mt-1">
|
||||||
|
{{ form.description.errors[0] }}
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Preview Section -->
|
||||||
|
<div class="alert alert-info">
|
||||||
|
<h6 class="alert-heading">
|
||||||
|
<i class="bi bi-info-circle"></i> {% trans %}Preview{% endtrans %}
|
||||||
|
</h6>
|
||||||
|
<div id="classroom-preview">
|
||||||
|
<p class="mb-1">{% trans %}Fill in the form to see a preview of the classroom code:{% endtrans %}
|
||||||
|
<span class="fw-bold" id="preview-code">-</span>
|
||||||
|
</p>
|
||||||
|
<p class="mb-0">{% trans %}Full location:{% endtrans %}
|
||||||
|
<span class="fw-bold" id="preview-location">-</span>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="d-flex justify-content-between">
|
||||||
|
<a href="{{ url_for('classrooms.list_classrooms') }}" class="btn btn-outline-secondary">
|
||||||
|
<i class="bi bi-x-circle"></i> {% trans %}Cancel{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<button type="submit" class="btn btn-primary">
|
||||||
|
<i class="bi bi-save me-1"></i> {{ form.submit.label.text }}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Resources Section -->
|
||||||
|
<div class="row mt-4 mb-4">
|
||||||
|
<div class="col-lg-8 mx-auto">
|
||||||
|
<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-tools text-warning me-2"></i> {% trans %}Resources (Optional){% endtrans %}
|
||||||
|
</h5>
|
||||||
|
</div>
|
||||||
|
<div class="card-body">
|
||||||
|
<p class="text-muted mb-0">{% trans %}You can add classroom resources after creating the classroom.{% endtrans %}</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block extra_js %}
|
||||||
|
<script>
|
||||||
|
$(document).ready(function() {
|
||||||
|
function updatePreview() {
|
||||||
|
const building = $('#building').val();
|
||||||
|
const roomNumber = $('#room_number').val();
|
||||||
|
const floor = $('#floor').val();
|
||||||
|
const floorLabel = '{{ _("Floor") }}';
|
||||||
|
|
||||||
|
if (building && roomNumber && floor) {
|
||||||
|
$('#preview-code').text(`${building}-${roomNumber}`);
|
||||||
|
$('#preview-location').text(`${building} - ${floorLabel} ${floor}`);
|
||||||
|
} else {
|
||||||
|
$('#preview-code').text('-');
|
||||||
|
$('#preview-location').text('-');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Update preview when inputs change
|
||||||
|
$('#building, #room_number, #floor').on('input', updatePreview);
|
||||||
|
|
||||||
|
// Initialize preview
|
||||||
|
updatePreview();
|
||||||
|
|
||||||
|
// Form validation
|
||||||
|
$('#classroom-form').on('submit', function(e) {
|
||||||
|
let isValid = true;
|
||||||
|
|
||||||
|
if (!$('#building').val().trim()) {
|
||||||
|
$('#building').addClass('is-invalid');
|
||||||
|
isValid = false;
|
||||||
|
} else {
|
||||||
|
$('#building').removeClass('is-invalid');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!$('#room_number').val().trim()) {
|
||||||
|
$('#room_number').addClass('is-invalid');
|
||||||
|
isValid = false;
|
||||||
|
} else {
|
||||||
|
$('#room_number').removeClass('is-invalid');
|
||||||
|
}
|
||||||
|
|
||||||
|
var floorVal = $('#floor').val();
|
||||||
|
if (floorVal === '' || isNaN(floorVal)) {
|
||||||
|
$('#floor').addClass('is-invalid');
|
||||||
|
isValid = false;
|
||||||
|
} else {
|
||||||
|
$('#floor').removeClass('is-invalid');
|
||||||
|
}
|
||||||
|
|
||||||
|
var capVal = $('#capacity').val() ? $('#capacity').val().trim() : '';
|
||||||
|
if (!capVal || (capVal !== '∞' && capVal !== '0' && isNaN(capVal))) {
|
||||||
|
$('#capacity').addClass('is-invalid');
|
||||||
|
isValid = false;
|
||||||
|
} else {
|
||||||
|
$('#capacity').removeClass('is-invalid');
|
||||||
|
}
|
||||||
|
|
||||||
|
return isValid;
|
||||||
|
});
|
||||||
|
|
||||||
|
$('#btnInfinityAdd').on('click', function() {
|
||||||
|
$('#capacity').val('∞').focus();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
{% endblock %}
|
||||||
@@ -0,0 +1,162 @@
|
|||||||
|
{% extends "base.html" %}
|
||||||
|
|
||||||
|
{% block title %}{% trans %}Edit Classroom{% endtrans %} - {{ classroom.code_display }} - Edu-Space Admin{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
<div class="container-fluid pt-5 mt-4">
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-12">
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-4">
|
||||||
|
<div>
|
||||||
|
<h1 class="h3 mb-1">
|
||||||
|
<i class="bi bi-pencil-square text-primary me-2"></i>{% trans %}Edit Classroom{% endtrans %}
|
||||||
|
</h1>
|
||||||
|
<p class="text-muted small mb-0">{{ classroom.building }} — {{ classroom.code }}</p>
|
||||||
|
</div>
|
||||||
|
<div class="d-flex gap-2">
|
||||||
|
<a href="{{ url_for('classrooms.view_classroom', id=classroom.id) }}" class="btn btn-outline-primary">
|
||||||
|
<i class="bi bi-eye me-1"></i>{% trans %}Ver Ficha{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<a href="{{ url_for('classrooms.list_classrooms') }}" class="btn btn-outline-secondary">
|
||||||
|
<i class="bi bi-arrow-left me-1"></i>{% trans %}Back to Classrooms{% endtrans %}
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row">
|
||||||
|
<div class="col-lg-8 mx-auto">
|
||||||
|
<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">
|
||||||
|
<h5 class="mb-0 h6 fw-bold">
|
||||||
|
<i class="bi bi-door-open text-primary me-2"></i>{% trans %}Classroom Information{% endtrans %}
|
||||||
|
</h5>
|
||||||
|
<span class="badge bg-secondary-subtle text-secondary font-monospace border">ID #{{ classroom.id }}</span>
|
||||||
|
</div>
|
||||||
|
<div class="card-body p-4">
|
||||||
|
<form method="POST" id="classroom-form" novalidate>
|
||||||
|
{{ form.hidden_tag() }}
|
||||||
|
|
||||||
|
<div class="row g-3">
|
||||||
|
<div class="col-md-4">
|
||||||
|
{{ form.building.label(class="form-label fw-semibold") }}
|
||||||
|
{{ form.building(class="form-control" + (" is-invalid" if form.building.errors else ""), placeholder="Edificio Central") }}
|
||||||
|
{% if form.building.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.building.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4">
|
||||||
|
{{ form.room_number.label(class="form-label fw-semibold") }}
|
||||||
|
{{ form.room_number(class="form-control" + (" is-invalid" if form.room_number.errors else ""), placeholder="402") }}
|
||||||
|
{% if form.room_number.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.room_number.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4">
|
||||||
|
{{ form.floor.label(class="form-label fw-semibold") }}
|
||||||
|
{{ form.floor(class="form-control" + (" is-invalid" if form.floor.errors else "")) }}
|
||||||
|
{% if form.floor.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.floor.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-6">
|
||||||
|
<div class="d-flex justify-content-between align-items-center mb-1">
|
||||||
|
{{ form.capacity.label(class="form-label fw-semibold mb-0") }}
|
||||||
|
<button type="button" class="btn btn-sm btn-outline-primary py-0 px-2" id="btnInfinity" style="font-size: 0.8rem;" title="{% trans %}Asignar capacidad ilimitada{% endtrans %}">
|
||||||
|
<i class="bi bi-infinity me-1"></i>{% trans %}Ilimitada (∞){% endtrans %}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
<div class="input-group">
|
||||||
|
{{ form.capacity(class="form-control" + (" is-invalid" if form.capacity.errors else ""), id="capacityInput", placeholder="ej. 35 o ∞") }}
|
||||||
|
<span class="input-group-text bg-body-tertiary text-muted font-monospace"><i class="bi bi-people"></i></span>
|
||||||
|
</div>
|
||||||
|
<div class="form-text small text-muted mt-1">
|
||||||
|
<i class="bi bi-info-circle text-info me-1"></i>{% trans %}Para aulas virtuales o eventos sin aforo restringido, ingrese <strong>∞</strong> o <strong>0</strong> (Capacidad ilimitada).{% endtrans %}
|
||||||
|
</div>
|
||||||
|
{% if form.capacity.errors %}
|
||||||
|
<div class="invalid-feedback d-block">{{ form.capacity.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-6 d-flex align-items-center pt-md-4">
|
||||||
|
<div class="form-check form-switch pt-2">
|
||||||
|
{{ form.is_active(class="form-check-input", role="switch") }}
|
||||||
|
{{ form.is_active.label(class="form-check-label fw-semibold") }}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-12">
|
||||||
|
{{ form.description.label(class="form-label fw-semibold") }}
|
||||||
|
{{ form.description(class="form-control" + (" is-invalid" if form.description.errors else ""), rows="3", placeholder="Detalles sobre equipamiento o uso preferente del aula...") }}
|
||||||
|
{% if form.description.errors %}
|
||||||
|
<div class="invalid-feedback">{{ form.description.errors[0] }}</div>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Live Preview Card -->
|
||||||
|
<div class="alert alert-info border-0 mt-4 mb-0">
|
||||||
|
<h6 class="alert-heading fw-bold mb-2">
|
||||||
|
<i class="bi bi-info-circle me-1"></i>{% trans %}Vista Previa de Identificador{% endtrans %}
|
||||||
|
</h6>
|
||||||
|
<div id="classroom-preview">
|
||||||
|
<p class="mb-0">
|
||||||
|
{% trans %}Código de visualización{% endtrans %}:
|
||||||
|
<strong id="preview-code" class="text-primary font-monospace fs-6">{{ classroom.code_display }}</strong>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="d-flex justify-content-end gap-2 mt-4 pt-3 border-top">
|
||||||
|
<a href="{{ url_for('classrooms.view_classroom', id=classroom.id) }}" class="btn btn-outline-secondary">
|
||||||
|
{% trans %}Cancelar{% endtrans %}
|
||||||
|
</a>
|
||||||
|
<button type="submit" class="btn btn-primary px-4">
|
||||||
|
<i class="bi bi-check-circle me-1"></i>{% trans %}Guardar Cambios{% endtrans %}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block extra_js %}
|
||||||
|
<script>
|
||||||
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
|
var buildingInput = document.getElementById('building');
|
||||||
|
var roomInput = document.getElementById('room_number');
|
||||||
|
var previewCode = document.getElementById('preview-code');
|
||||||
|
var capacityInput = document.getElementById('capacityInput');
|
||||||
|
var btnInfinity = document.getElementById('btnInfinity');
|
||||||
|
|
||||||
|
function updatePreview() {
|
||||||
|
var b = buildingInput ? buildingInput.value.trim() : '';
|
||||||
|
var r = roomInput ? roomInput.value.trim() : '';
|
||||||
|
if (b && r) {
|
||||||
|
previewCode.textContent = b + '-' + r;
|
||||||
|
} else if (r) {
|
||||||
|
previewCode.textContent = r;
|
||||||
|
} else {
|
||||||
|
previewCode.textContent = '---';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (buildingInput) buildingInput.addEventListener('input', updatePreview);
|
||||||
|
if (roomInput) roomInput.addEventListener('input', updatePreview);
|
||||||
|
|
||||||
|
if (btnInfinity && capacityInput) {
|
||||||
|
btnInfinity.addEventListener('click', function() {
|
||||||
|
capacityInput.value = '∞';
|
||||||
|
capacityInput.focus();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
</script>
|
||||||
|
{% endblock %}
|
||||||