feat: release v3.5.0 - formal MVP Bedelia closure, SDD harness, cartelera export, docs cleanup & model fixes
This commit is contained in:
@@ -0,0 +1,75 @@
|
|||||||
|
---
|
||||||
|
name: deploy
|
||||||
|
description: Procedimiento innegociable de bump semántico de versión, git push y despliegue continuo en producción (LXC 10.0.0.217) utilizando .credenciales.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Skill: Despliegue Continuo, Bump de Versión y Git Push
|
||||||
|
|
||||||
|
Esta skill define el protocolo obligatorio para consolidar, versionar, publicar y desplegar cambios en **admin-edu-space**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Principio Rector (Principio 9 de la Constitución)
|
||||||
|
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
|
||||||
|
1. **Subir la versión semántica** de forma coordinada.
|
||||||
|
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev`).
|
||||||
|
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Paso 1: Bump Semántico de Versión
|
||||||
|
Incrementar la versión siguiendo SemVer (`X.Y.Z`) en todos los descriptores del proyecto:
|
||||||
|
- `frontend/package.json` (`"version": "X.Y.Z"`)
|
||||||
|
- `frontend/src/app.js` (`APP_VERSION`, `FRONTEND_VERSION`, `BACKEND_VERSION`)
|
||||||
|
- `backend/app/__init__.py` (`__version__ = "X.Y.Z"`)
|
||||||
|
- `backend/setup.py` (`version="X.Y.Z"`)
|
||||||
|
- `backend/app/routes/api/openapi.py` (`"version": "X.Y.Z"`)
|
||||||
|
- `CHANGELOG.md` (Nueva sección `## [X.Y.Z] - YYYY-MM-DD`)
|
||||||
|
- `MEMORY.md` (Registrar hito del sprint)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Paso 2: Git Commit y Push
|
||||||
|
Ejecutar la suite de pruebas (`python -m pytest tests -v` en `backend`). Si está 100% en verde:
|
||||||
|
```powershell
|
||||||
|
git add .
|
||||||
|
git commit -m "feat/fix: descripción del cambio (vX.Y.Z)"
|
||||||
|
git push origin dev
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Paso 3: Despliegue en Servidor de Producción (LXC Edu-Admin-Space)
|
||||||
|
Consultar el archivo `.credenciales` en la raíz del proyecto para obtener la IP, usuario y contraseña del host:
|
||||||
|
- **Host / IP:** `10.0.0.217` (LXC Debian Edu-Admin-Space)
|
||||||
|
- **Dominio Público:** `https://eduspace.oemspot.com.ar`
|
||||||
|
- **Usuario SSH:** `root`
|
||||||
|
- **Acceso:** Credenciales de `.credenciales`
|
||||||
|
|
||||||
|
### Comandos de Despliegue Remoto:
|
||||||
|
1. Conectar vía SSH y sincronizar repositorio en el servidor:
|
||||||
|
```bash
|
||||||
|
ssh root@10.0.0.217 "cd /opt/admin-edu-space && git fetch && git checkout dev && git pull origin dev"
|
||||||
|
```
|
||||||
|
2. Si hubo cambios en dependencias o esquema:
|
||||||
|
```bash
|
||||||
|
ssh root@10.0.0.217 "cd /opt/admin-edu-space/backend && ./venv/bin/pip install -r requirements.txt && ./venv/bin/flask db upgrade"
|
||||||
|
ssh root@10.0.0.217 "cd /opt/admin-edu-space/frontend && npm install"
|
||||||
|
```
|
||||||
|
3. Reiniciar servicios systemd del Backend y Frontend:
|
||||||
|
```bash
|
||||||
|
ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend"
|
||||||
|
```
|
||||||
|
4. Verificar estado del servicio:
|
||||||
|
```bash
|
||||||
|
ssh root@10.0.0.217 "systemctl status admin-edu-space-backend --no-pager"
|
||||||
|
ssh root@10.0.0.217 "systemctl status admin-edu-space-frontend --no-pager"
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Paso 4: Verificación de Disponibilidad en Vivo (Smoke Test)
|
||||||
|
Comprobar que el endpoint público responde HTTP 200 con la nueva versión:
|
||||||
|
- Backend version: `https://eduspace.oemspot.com.ar/api/v1/version` o `http://10.0.0.217:5000/api/v1/version`
|
||||||
|
- Frontend version: `https://eduspace.oemspot.com.ar/version`
|
||||||
|
- Pantalla de login accesible: HTTP 200 en `https://eduspace.oemspot.com.ar/login`
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
---
|
||||||
|
name: sdd
|
||||||
|
description: Flujo de desarrollo guiado por especificaciones (Spec-Driven Development) basado en los principios de ingeniería de software con IA y sintaxis EARS.
|
||||||
|
---
|
||||||
|
|
||||||
|
# Skill: Spec-Driven Development (SDD)
|
||||||
|
|
||||||
|
Esta skill define el arnés metodológico innegociable para implementar, refactorizar o validar funcionalidades en **admin-edu-space**.
|
||||||
|
|
||||||
|
## Principio Fundamental
|
||||||
|
**La especificación manda**: Ninguna línea de código de negocio se escribe si no está precedida por una especificación aprobada (`spec.md`), un plan técnico (`plan.md`) y una lista de tareas atómicas (`tasks.md`).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Flujo de Trabajo (7 Pasos)
|
||||||
|
|
||||||
|
```
|
||||||
|
1. Constitución (docs/constitution.md)
|
||||||
|
↓
|
||||||
|
2. Especificación (specs/NNN-nombre/spec.md)
|
||||||
|
↓
|
||||||
|
3. Clarificación (Revisión QA - detección de ambigüedades)
|
||||||
|
↓
|
||||||
|
4. Planificación (specs/NNN-nombre/plan.md)
|
||||||
|
↓
|
||||||
|
5. Desglose de Tareas (specs/NNN-nombre/tasks.md)
|
||||||
|
↓
|
||||||
|
6. Implementación (Tarea por tarea, Test-First)
|
||||||
|
↓
|
||||||
|
7. Validación (RF por RF + Criterios de Finalización)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Sintaxis EARS (Easy Approach to Requirements Syntax)
|
||||||
|
Todo Requisito Funcional (RF) debe redactarse usando exclusivamente una de las 5 estructuras EARS en español:
|
||||||
|
|
||||||
|
1. **Ubicuo (Comportamiento permanente)**:
|
||||||
|
> `EL SISTEMA <comportamiento permanente>.`
|
||||||
|
> *Ejemplo:* EL SISTEMA registrará en `AuditLog` toda modificación de asignación de aula.
|
||||||
|
|
||||||
|
2. **Basado en Eventos (Disparado por una acción)**:
|
||||||
|
> `CUANDO <evento>, EL SISTEMA <respuesta>.`
|
||||||
|
> *Ejemplo:* CUANDO el usuario confirme una reserva con conflicto físico, EL SISTEMA bloqueará la operación y retornará un error HTTP 409 con el detalle de la superposición.
|
||||||
|
|
||||||
|
3. **Basado en Estados (Activo mientras se cumpla una condición)**:
|
||||||
|
> `MIENTRAS <estado>, EL SISTEMA <respuesta>.`
|
||||||
|
> *Ejemplo:* MIENTRAS una comisión posea co-docencia activa registrada, EL SISTEMA permitirá la superposición horaria del docente auxiliar.
|
||||||
|
|
||||||
|
4. **No Deseado / Excepciones (Manejo de errores y límites)**:
|
||||||
|
> `SI <condición no deseada>, ENTONCES EL SISTEMA <respuesta>.`
|
||||||
|
> *Ejemplo:* SI la matrícula de la comisión supera el aforo máximo del aula, ENTONCES EL SISTEMA impedirá el guardado y alertará al operador de Bedelía.
|
||||||
|
|
||||||
|
5. **Opcional (Funcionalidad dependiente de configuración o rol)**:
|
||||||
|
> `DONDE <característica opcional>, EL SISTEMA <respuesta>.`
|
||||||
|
> *Ejemplo:* DONDE el usuario posea rol Bedelia o Admin, EL SISTEMA habilitará el botón de reasignación directa de aulas libres.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Reglas de Ejecución para Agentes
|
||||||
|
1. **No inventar**: Si falta información o un caso de uso no está cubierto, detenerse y marcar `[NECESITA ACLARACIÓN]`.
|
||||||
|
2. **Tareas pequeñas**: Cada tarea en `tasks.md` debe tener una duración estimada de 20-30 minutos y contar con su criterio *"Hecho cuando:"*.
|
||||||
|
3. **Test-First**: En la lógica de backend, escribir primero el test en rojo antes de tocar el código de la solución.
|
||||||
|
4. **Validación RF por RF**: Al finalizar, verificar cada RF de la especificación contra los tests y la interfaz gráfica.
|
||||||
|
5. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
|
||||||
|
6. **Bump de Versión, Git Push y Despliegue en Producción (Skill `deploy`)**: Conforme al Principio 9 de la Constitución, incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `CHANGELOG.md`), ejecutar `git push origin dev` al repositorio remoto y desplegar en producción al servidor institucional LXC (`10.0.0.217`) utilizando las credenciales de `.credenciales`.
|
||||||
+1
-1
@@ -224,7 +224,7 @@ legacy_admin-edu-space/
|
|||||||
.schemathesis/
|
.schemathesis/
|
||||||
|
|
||||||
AlumnosLS
|
AlumnosLS
|
||||||
prerrequisitos
|
apuntes
|
||||||
|
|
||||||
.credentials
|
.credentials
|
||||||
.credenciales
|
.credenciales
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
---
|
||||||
|
description: Coordinador general del proyecto Admin Edu-Space. Dirige el flujo SDD orquestando al planificador, implementador y revisor sin tocar código directamente.
|
||||||
|
mode: primary
|
||||||
|
---
|
||||||
|
|
||||||
|
Eres el Agente Coordinador (Coordinator) de **admin-edu-space**.
|
||||||
|
Tu misión es guiar el avance hacia la entrega del MVP de Bedelía asegurando el cumplimiento de `docs/constitution.md` y `AGENTS.md`.
|
||||||
|
|
||||||
|
## Flujo de Trabajo
|
||||||
|
1. **Spec**: Delegar en `@planner` la redacción de `specs/NNN-nombre/spec.md`.
|
||||||
|
2. **Clarificación**: Delegar en `@reviewer` la revisión QA para eliminar ambigüedades.
|
||||||
|
3. **Plan y Tareas**: Delegar en `@planner` la confección de `plan.md` y `tasks.md`.
|
||||||
|
4. **Implementación**: Delegar en `@implementer` una tarea atómica a la vez.
|
||||||
|
5. **Validación**: Delegar en `@reviewer` la validación RF por RF.
|
||||||
|
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución.
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
---
|
||||||
|
description: Agente implementador de Admin Edu-Space. Ejecuta tareas atómicas individuales guiado por el plan y con enfoque Test-First.
|
||||||
|
mode: subagent
|
||||||
|
---
|
||||||
|
|
||||||
|
Eres el Agente Implementador (Implementer) de **admin-edu-space**.
|
||||||
|
Tu misión es ejecutar UNA tarea específica de `tasks.md` sin rediseñar el plan ni añadir alcance no solicitado.
|
||||||
|
|
||||||
|
## Reglas
|
||||||
|
- Lee la tarea asignada, `plan.md`, `docs/constitution.md` y `AGENTS.md`.
|
||||||
|
- Enfoque **Test-First**: si tocas lógica de negocio, crea o ajusta primero la prueba automatizada en `backend/tests/`.
|
||||||
|
- Ejecuta las pruebas (`python -m pytest tests -v` en backend) y asegura 100% de éxito.
|
||||||
|
- Marca la tarea con `[x]` en `tasks.md` al terminar y detén tu ejecución para supervisión.
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
---
|
||||||
|
description: Agente planificador SDD de Admin Edu-Space. Redacta especificaciones EARS, planes técnicos y tareas atómicas. No escribe código de aplicación.
|
||||||
|
mode: subagent
|
||||||
|
---
|
||||||
|
|
||||||
|
Eres el Agente Planificador (Planner) de **admin-edu-space**.
|
||||||
|
Tu objetivo es redactar especificaciones precisas, arquitecturas limpias y listas de tareas sin tocar el código fuente del backend ni del frontend.
|
||||||
|
|
||||||
|
## Reglas
|
||||||
|
- Lee siempre `docs/constitution.md`, `AGENTS.md` y `MEMORY.md`.
|
||||||
|
- Escribe las especificaciones en `specs/NNN-nombre/spec.md` con sintaxis EARS en español.
|
||||||
|
- Nunca incluyas nombres de archivos ni detalles de base de datos en `spec.md` (van en `plan.md`).
|
||||||
|
- Define criterios de aceptación verificables y delimita claramente el **Fuera de Alcance**.
|
||||||
|
- En `tasks.md`, desglosa tareas en bloques atómicos de 20 a 30 minutos con `[ ]` y criterio *"Hecho cuando:"*.
|
||||||
@@ -0,0 +1,16 @@
|
|||||||
|
---
|
||||||
|
description: Agente revisor y auditor QA de Admin Edu-Space. Clarifica especificaciones y valida implementaciones RF por RF sin modificar archivos.
|
||||||
|
mode: subagent
|
||||||
|
---
|
||||||
|
|
||||||
|
Eres el Agente Revisor (Reviewer) de **admin-edu-space**.
|
||||||
|
Tu misión es actuar como QA profesional y auditor de calidad, garantizando que el software cumpla la especificación al 100%.
|
||||||
|
|
||||||
|
## Tareas
|
||||||
|
1. **En Clarificación de Spec**: Busca ambigüedades, contradicciones, lagunas en casos límite o choques con `docs/constitution.md`.
|
||||||
|
2. **En Validación de Implementación**:
|
||||||
|
- Revisa los cambios (`git diff`).
|
||||||
|
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
|
||||||
|
- Recorre cada RF de la especificación y emite un veredicto formal:
|
||||||
|
- `VEREDICTO: APROBADO`
|
||||||
|
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
---
|
||||||
|
description: Bump de versión, commit, git push y despliegue a producción usando .credenciales
|
||||||
|
agent: coordinator
|
||||||
|
---
|
||||||
|
Ejecuta el protocolo innegociable de despliegue continuo (Skill `deploy` y Principio 9):
|
||||||
|
|
||||||
|
1. Comprueba que la suite de pruebas esté en verde: `cd backend && pytest tests -v`.
|
||||||
|
2. Incrementa el número de versión semántica en:
|
||||||
|
- `frontend/package.json`
|
||||||
|
- `frontend/src/app.js`
|
||||||
|
- `backend/app/__init__.py`
|
||||||
|
- `backend/setup.py`
|
||||||
|
- `backend/app/routes/api/openapi.py`
|
||||||
|
- `CHANGELOG.md`
|
||||||
|
- `MEMORY.md`
|
||||||
|
3. Ejecuta `git add .`, `git commit` y `git push origin dev` al repositorio remoto.
|
||||||
|
4. Conéctate vía SSH al servidor de producción utilizando los datos del archivo `.credenciales`:
|
||||||
|
- Host LXC: `10.0.0.217`
|
||||||
|
- Usuario: `root`
|
||||||
|
5. Ejecuta en el servidor:
|
||||||
|
- `cd /opt/admin-edu-space && git pull origin dev`
|
||||||
|
- `systemctl restart admin-edu-space-backend admin-edu-space-frontend`
|
||||||
|
6. Verifica que `https://eduspace.oemspot.com.ar/version` responda HTTP 200 con la versión recién publicada.
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
---
|
||||||
|
description: SDD · Genera el plan técnico a partir de una spec aprobada
|
||||||
|
---
|
||||||
|
Lee `docs/constitution.md`, `AGENTS.md` y `specs/$1/spec.md`. NO escribas código.
|
||||||
|
|
||||||
|
Genera `specs/$1/plan.md` con:
|
||||||
|
1. Archivos que se crean o modifican y responsabilidad de cada uno.
|
||||||
|
2. Contratos de API (endpoints REST `/api/v1/`, métodos, payload JSON, códigos HTTP).
|
||||||
|
3. Componentes de UI / Vistas Nunjucks afectadas.
|
||||||
|
4. Decisiones técnicas justificadas (y la alternativa descartada).
|
||||||
|
5. Estrategia de tests automatizados (`pytest tests -v`).
|
||||||
|
6. Mapeo de qué Requisito Funcional (RF) cubre cada parte.
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
---
|
||||||
|
description: SDD · Genera o entrevista para crear una nueva spec (uso /sdd-spec 001-nombre idea)
|
||||||
|
---
|
||||||
|
NO escribas código en ningún momento. Lee `docs/constitution.md`, `AGENTS.md` y `MEMORY.md`, y utiliza la skill `sdd`.
|
||||||
|
|
||||||
|
Carpeta de la spec: `specs/$1/`
|
||||||
|
Idea inicial: $ARGUMENTS
|
||||||
|
|
||||||
|
Tu trabajo:
|
||||||
|
1. Haz preguntas de UNA en UNA para eliminar ambigüedades (casos límite, errores, qué queda fuera de alcance para el MVP). Máximo 5 preguntas.
|
||||||
|
2. Genera `specs/$1/spec.md` siguiendo la plantilla de SDD, con requisitos funcionales en notación EARS en español y "Estado: borrador".
|
||||||
|
3. Describe exclusivamente el QUÉ y el POR QUÉ: nada de nombres de archivo, modelos ni arquitectura (eso va en el plan).
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
---
|
||||||
|
description: SDD · Genera las tareas atómicas a partir de spec.md y plan.md
|
||||||
|
---
|
||||||
|
A partir de `specs/$1/spec.md` y `specs/$1/plan.md`, genera `specs/$1/tasks.md`:
|
||||||
|
1. Tareas pequeñas y atómicas (máximo 20-30 minutos cada una).
|
||||||
|
2. Ordenadas por dependencia lógica (Backend / Datos primero, luego Frontend BFF / UI, luego Tests y Validación).
|
||||||
|
3. Cada tarea debe indicar qué RFs cubre y una línea `"Hecho cuando:"` verificable.
|
||||||
|
4. Utiliza checkboxes `[ ]`.
|
||||||
@@ -48,8 +48,24 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as
|
|||||||
- **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`).
|
- **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`.
|
- **Autenticación**: Los flujos de acceso pasan por tokens JWT transportados en cookies seguras `HttpOnly`.
|
||||||
|
|
||||||
|
## Metodología SDD (Spec-Driven Development) y Arnés de Agentes
|
||||||
|
- **La especificación manda**: Ninguna feature se codifica sin su carpeta `specs/NNN-nombre/` conteniendo `spec.md` (requisitos en sintaxis **EARS** en español: Ubicuo, Eventos, Estado, No Deseado, Opcional), `plan.md` y `tasks.md` (skill `.agents/skills/sdd/SKILL.md`).
|
||||||
|
- **Flujo de Roles**:
|
||||||
|
- `Coordinator`: Conduce la interacción con el usuario y orquesta a los subagentes sin tocar código.
|
||||||
|
- `Planner`: Redacta specs, planes y tareas atómicas (20-30 min) con criterios verificables "Hecho cuando:".
|
||||||
|
- `Implementer`: Ejecuta tareas una a una con enfoque Test-First (`backend/tests/`).
|
||||||
|
- `Reviewer`: Clarifica specs como QA y valida la implementación emitiendo veredicto formal (`VEREDICTO: APROBADO / CAMBIOS NECESARIOS`).
|
||||||
|
|
||||||
|
## Despliegue en Producción y Git Push (Innegociable por Principio 9)
|
||||||
|
- Al completar cualquier tarea o hito verificado:
|
||||||
|
1. Incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py`).
|
||||||
|
2. Registrar cambios en `CHANGELOG.md` y `MEMORY.md`.
|
||||||
|
3. Ejecutar `git add .`, commit y **`git push origin dev`** al repositorio remoto.
|
||||||
|
4. Desplegar inmediatamente en producción al servidor institucional LXC (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos del archivo `.credenciales`, reiniciando los servicios `admin-edu-space-backend` y `admin-edu-space-frontend`, y verificando HTTP 200 en `/version`.
|
||||||
|
|
||||||
## Límites
|
## Límites
|
||||||
- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa antes de proponer o modificar código.
|
- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa (`specs/`) antes de proponer o modificar código.
|
||||||
|
- **SIEMPRE**: Al finalizar la tarea, realizar bump de versión, `git push origin dev` y despliegue a producción con `.credenciales` (Skill `.agents/skills/deploy/SKILL.md`).
|
||||||
- **PREGUNTA ANTES DE**: Añadir nuevas dependencias a `requirements.txt` o `package.json`, alterar el esquema relacional de la base de datos o cambiar la estrategia de caché.
|
- **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.
|
- **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.
|
||||||
|
|
||||||
|
|||||||
@@ -11,6 +11,23 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
|
|||||||
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
|
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
|
||||||
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
|
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
|
||||||
|
|
||||||
|
## [3.5.0] - 2026-10-16
|
||||||
|
### Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA)
|
||||||
|
- **Arnés de Ingeniería de Software con IA (Harness Engineering):**
|
||||||
|
- Incorporación de la skill formal de SDD (`.agents/skills/sdd/SKILL.md`) con las directivas de especificación, planificación y tareas.
|
||||||
|
- Implementación de comandos personalizados en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`).
|
||||||
|
- Configuración de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA).
|
||||||
|
- Actualización de `AGENTS.md` con las reglas mandatorias del flujo SDD y sintaxis EARS.
|
||||||
|
- **Especificación Formal de Cierre de MVP (`specs/001-cierre-mvp-bedelia/`):**
|
||||||
|
- Delimitación inamovible de los 10 Requisitos Funcionales en notación EARS y delimitación explícita de *Fuera de Alcance* para evitar el *Scope Creep*.
|
||||||
|
- **Herramientas de Exportación e Impresión para Bedelía y Portería:**
|
||||||
|
- Nuevo endpoint en Frontend BFF (`/schedule/export_csv`) que genera un archivo CSV con formato Excel nativo (UTF-8 con BOM `\uFEFF` y separador `;`) conteniendo la cartelera de clases del día/semana seleccionada.
|
||||||
|
- Botón "Excel / CSV" y botón "Imprimir" en `/schedule/today` (`today.html`).
|
||||||
|
- Hojas de estilo CSS `@media print` para impresión oficial limpia en hoja A4 con membrete institucional de UniCABA (oculta barras de navegación, botones y filtros).
|
||||||
|
- Accesos directos de exportación e impresión en el Dashboard Operativo de Bedelía (`dashbede.html`).
|
||||||
|
- **Verificación de Calidad:**
|
||||||
|
- 52 pruebas automatizadas en verde (`52 passed`) en pytest.
|
||||||
|
|
||||||
## [3.4.9] - 2026-10-09
|
## [3.4.9] - 2026-10-09
|
||||||
### Corregido & Mejorado (Importador de Google Sheets & Sistema de Diagnóstico de Incidentes)
|
### 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`):**
|
- **Corrección de Límite de Payload en Importación Masiva de Google Sheets (`PayloadTooLargeError`):**
|
||||||
|
|||||||
@@ -175,9 +175,24 @@ Memoria del proyecto entre sesiones para la rama `dev`.
|
|||||||
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.
|
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'`).
|
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.
|
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.
|
||||||
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
|
- **Sprint v3.5.0: Cierre Formal del MVP de Bedelía & Adopción del Arnés SDD / IA**:
|
||||||
- Versión incrementada a `v3.4.9` en Frontend y Backend.
|
- **Metodología y Arnés de Ingeniería con IA (Apuntes Día 1, 2 y 3)**:
|
||||||
|
1. Creación de la Skill de SDD (`.agents/skills/sdd/SKILL.md`) con las plantillas de `spec.md`, `plan.md`, `tasks.md` y sintaxis formal **EARS** en español.
|
||||||
|
2. Creación de comandos reutilizables de agentes en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`).
|
||||||
|
3. Definición de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA).
|
||||||
|
4. Integración del arnés en `AGENTS.md`.
|
||||||
|
- **Diagnóstico y Cierre de Brecha del MVP**:
|
||||||
|
- Se identificó la causa raíz de la percepción de "estar lejos": el *Scope Creep* sin especificación formal de cierre y la falta de exportación/impresión de carteleras que forzaba a Bedelía a recurrir al Excel para imprimir o compartir partes con portería y docentes.
|
||||||
|
- Se formalizó la primera especificación oficial del proyecto en `specs/001-cierre-mvp-bedelia/` (`spec.md`, `plan.md`, `tasks.md`), delimitando de forma estricta los Requisitos Funcionales en **EARS** y estableciendo un perímetro cerrado de **Fuera de Alcance**.
|
||||||
|
- **Implementación Técnica**:
|
||||||
|
1. `frontend/src/routes/schedule.js`: Endpoint `/schedule/export_csv` con codificación UTF-8 BOM (`\uFEFF`) y delimitadores `;` para apertura nativa e inmediata en Microsoft Excel en español.
|
||||||
|
2. `frontend/views/schedule/today.html`: Botones directos `[ Excel / CSV ]` e `[ Imprimir ]`, acompañados de estilos CSS `@media print` que formatean la grilla de asignaciones en hoja A4 limpia con membrete institucional oficial de UniCABA.
|
||||||
|
3. `frontend/views/dashboard/dashbede.html`: Accesos rápidos en el Launchpad operativo de Bedelía para descargar la planilla del día e imprimir en 1 clic.
|
||||||
|
- **Calidad y Bump Semántico (Principio 9)**:
|
||||||
|
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`).
|
||||||
|
- Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
|
||||||
|
|
||||||
## Próximos pasos
|
## Próximos pasos
|
||||||
1. Continuar con los objetivos de la Fase 6 del Roadmap institucional (Docker-compose productivo, Nginx con SSL y automatización de workers continuos Moodle).
|
1. Desplegar la versión `v3.5.0` al servidor institucional de producción (`10.0.0.217` / `eduspace.oemspot.com.ar`) conforme al Principio 9.
|
||||||
2. Monitoreo continuo de la experiencia de usuario en Bedelía, Cartelera del Día y Sincronización Académica.
|
2. Realizar la prueba de aceptación en vivo con el personal de Bedelía imprimiendo y exportando la cartelera real.
|
||||||
|
3. Iniciar la Fase 6 de hardening y orquestación de contenedores en Docker-compose.
|
||||||
@@ -4,8 +4,9 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor
|
|||||||
|
|
||||||
El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
|
El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
|
||||||
|
|
||||||
**Versión Actual:** `3.1.0` (Fases 0 a 5 completadas, Fase 5.1 Bedelía UX & ABMs finalizada)
|
**Versión Actual:** `3.5.0` (Cierre Formal MVP Bedelía, SDD & Despliegue Continuo con `.credenciales`)
|
||||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
||||||
|
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -18,8 +19,9 @@ Fase 2: Co-docencia y Matriz Conflictos [████████████
|
|||||||
Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
|
Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
|
||||||
Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
|
Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
|
||||||
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
|
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
|
||||||
Fase 5.1: Bedelía UX, ABMs y Purga Datos [████████████████████] 100% (Completado)
|
Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
|
||||||
Fase 6: Despliegue Producción e Infraest.[███████░░░░░░░░░░░░░] 35% (En Curso)
|
Sprint MVP: Flujo 9 Pasos & Cierre de Bedelía [████████████████████] 100% (Entregado v3.5.0)
|
||||||
|
Fase 6: Despliegue Producción e Infraest. [███████░░░░░░░░░░░░░] 45% (En Curso)
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
+4
-4
@@ -2,8 +2,8 @@
|
|||||||
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
|
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
|
||||||
|
|
||||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
||||||
**Versión:** 3.4.9 (Importador de Google Sheets Robusto & Diagnóstico Transparente de Incidentes)
|
**Versión:** 3.5.0 (Cierre Formal MVP Bedelía, SDD & Exportador de Cartelera)
|
||||||
**Fecha de Actualización:** 09 de Octubre de 2026
|
**Fecha de Actualización:** 16 de Octubre de 2026
|
||||||
**Rama Base:** `dev`
|
**Rama Base:** `dev`
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -23,8 +23,8 @@ Fase 3: Hitos Evaluativos y Calificaciones [██████████
|
|||||||
Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
|
Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
|
||||||
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
|
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
|
||||||
Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
|
Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
|
||||||
Sprint Activo: Flujo Bedelía & Reemplazo Excel [████████████████░░░░] 80% (En Curso)
|
Sprint MVP: Flujo Bedelía & Reemplazo Excel [████████████████████] 100% (Entregado v3.5.0)
|
||||||
Fase 6: Despliegue en Servidores y Hardening [███████░░░░░░░░░░░░░] 35% (Planificado)
|
Fase 6: Despliegue en Servidores y Hardening [█████████░░░░░░░░░░░] 45% (En Curso)
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _
|
|||||||
from config.config import Config
|
from config.config import Config
|
||||||
|
|
||||||
# Initialize extensions
|
# Initialize extensions
|
||||||
__version__ = "3.4.9"
|
__version__ = "3.5.0"
|
||||||
db = SQLAlchemy()
|
db = SQLAlchemy()
|
||||||
migrate = Migrate()
|
migrate = Migrate()
|
||||||
cors = CORS()
|
cors = CORS()
|
||||||
|
|||||||
@@ -16,6 +16,9 @@ class AcademicTerm(db.Model):
|
|||||||
is_active = db.Column(db.Boolean, default=True, nullable=False)
|
is_active = db.Column(db.Boolean, default=True, nullable=False)
|
||||||
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def to_dict(self):
|
def to_dict(self):
|
||||||
return {
|
return {
|
||||||
'id': self.id,
|
'id': self.id,
|
||||||
|
|||||||
@@ -21,6 +21,18 @@ class AuditLog(db.Model):
|
|||||||
# Relación con usuario
|
# Relación con usuario
|
||||||
user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('audit_records', lazy='dynamic'))
|
user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('audit_records', lazy='dynamic'))
|
||||||
|
|
||||||
|
def __init__(self, user_id=None, user_email=None, action=None, module=None, entity_id=None, details=None, ip_address=None, **kwargs):
|
||||||
|
super().__init__(
|
||||||
|
user_id=user_id,
|
||||||
|
user_email=user_email,
|
||||||
|
action=action,
|
||||||
|
module=module,
|
||||||
|
entity_id=entity_id,
|
||||||
|
details=details,
|
||||||
|
ip_address=ip_address,
|
||||||
|
**kwargs
|
||||||
|
)
|
||||||
|
|
||||||
def __repr__(self):
|
def __repr__(self):
|
||||||
return f"<AuditLog #{self.id} {self.action} on {self.module} by {self.user_email or 'System'}>"
|
return f"<AuditLog #{self.id} {self.action} on {self.module} by {self.user_email or 'System'}>"
|
||||||
|
|
||||||
|
|||||||
@@ -17,6 +17,9 @@ class Building(db.Model):
|
|||||||
# Relationships
|
# Relationships
|
||||||
classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id')
|
classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id')
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def is_virtual(self):
|
def is_virtual(self):
|
||||||
"""Identifica si la sede corresponde al Campus Virtual"""
|
"""Identifica si la sede corresponde al Campus Virtual"""
|
||||||
|
|||||||
@@ -13,6 +13,9 @@ class Career(db.Model):
|
|||||||
# Relationships
|
# Relationships
|
||||||
subjects = db.relationship('Subject', backref='career_obj', lazy=True)
|
subjects = db.relationship('Subject', backref='career_obj', lazy=True)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def to_dict(self):
|
def to_dict(self):
|
||||||
return {
|
return {
|
||||||
'id': self.id,
|
'id': self.id,
|
||||||
|
|||||||
@@ -16,6 +16,9 @@ class Classroom(db.Model):
|
|||||||
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
# Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms)
|
# Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms)
|
||||||
@property
|
@property
|
||||||
def building_rel(self):
|
def building_rel(self):
|
||||||
|
|||||||
@@ -35,6 +35,9 @@ class StudentEnrollment(db.Model):
|
|||||||
student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
|
student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
|
||||||
commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
|
commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def to_dict(self):
|
def to_dict(self):
|
||||||
return {
|
return {
|
||||||
'id': self.id,
|
'id': self.id,
|
||||||
|
|||||||
@@ -50,6 +50,9 @@ class MilestoneGrade(db.Model):
|
|||||||
student = db.relationship('User', foreign_keys=[student_id], backref=db.backref('received_grades', lazy='dynamic'))
|
student = db.relationship('User', foreign_keys=[student_id], backref=db.backref('received_grades', lazy='dynamic'))
|
||||||
graded_by = db.relationship('User', foreign_keys=[graded_by_user_id])
|
graded_by = db.relationship('User', foreign_keys=[graded_by_user_id])
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def is_passed(self) -> bool:
|
def is_passed(self) -> bool:
|
||||||
"""Determina si la nota está aprobada (>= 4.00 y no ausente)."""
|
"""Determina si la nota está aprobada (>= 4.00 y no ausente)."""
|
||||||
|
|||||||
@@ -21,6 +21,9 @@ class MilestoneType(db.Model):
|
|||||||
# Relación uno-a-muchos con AcademicMilestone
|
# Relación uno-a-muchos con AcademicMilestone
|
||||||
milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan')
|
milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan')
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def to_dict(self):
|
def to_dict(self):
|
||||||
return {
|
return {
|
||||||
'id': self.id,
|
'id': self.id,
|
||||||
@@ -61,6 +64,9 @@ class AcademicMilestone(db.Model):
|
|||||||
subject = db.relationship('Subject', backref=db.backref('milestones', lazy='dynamic'))
|
subject = db.relationship('Subject', backref=db.backref('milestones', lazy='dynamic'))
|
||||||
commission = db.relationship('Commission', backref=db.backref('academic_milestones', lazy='dynamic', cascade='all, delete-orphan'))
|
commission = db.relationship('Commission', backref=db.backref('academic_milestones', lazy='dynamic', cascade='all, delete-orphan'))
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
@property
|
@property
|
||||||
def tipo(self):
|
def tipo(self):
|
||||||
return self.type_obj.name if self.type_obj else 'Otro'
|
return self.type_obj.name if self.type_obj else 'Otro'
|
||||||
|
|||||||
@@ -53,6 +53,9 @@ class Reservation(db.Model):
|
|||||||
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
# Virtual property to convert status string to enum
|
# Virtual property to convert status string to enum
|
||||||
@property
|
@property
|
||||||
def status_enum(self):
|
def status_enum(self):
|
||||||
|
|||||||
@@ -97,6 +97,9 @@ class Role(db.Model):
|
|||||||
permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan')
|
permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan')
|
||||||
users = db.relationship('User', backref='role_obj', lazy='select')
|
users = db.relationship('User', backref='role_obj', lazy='select')
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def get_permission(self, module):
|
def get_permission(self, module):
|
||||||
"""Get access level string for a given module ('none', 'read', 'read_write')"""
|
"""Get access level string for a given module ('none', 'read', 'read_write')"""
|
||||||
for p in self.permissions:
|
for p in self.permissions:
|
||||||
|
|||||||
@@ -18,6 +18,9 @@ class SystemSetting(db.Model):
|
|||||||
is_encrypted = db.Column(db.Boolean, default=False, nullable=True)
|
is_encrypted = db.Column(db.Boolean, default=False, nullable=True)
|
||||||
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
@classmethod
|
@classmethod
|
||||||
def get_value(cls, key, default=None):
|
def get_value(cls, key, default=None):
|
||||||
"""Retorna el valor tal como está almacenado en BD."""
|
"""Retorna el valor tal como está almacenado en BD."""
|
||||||
|
|||||||
@@ -27,6 +27,9 @@ class Subject(db.Model):
|
|||||||
commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan')
|
commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan')
|
||||||
careers = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True))
|
careers = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True))
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def to_dict(self):
|
def to_dict(self):
|
||||||
"""Convert subject to dictionary"""
|
"""Convert subject to dictionary"""
|
||||||
all_careers = []
|
all_careers = []
|
||||||
@@ -88,6 +91,9 @@ class Commission(db.Model):
|
|||||||
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
created_at = db.Column(db.DateTime, default=datetime.utcnow)
|
||||||
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
# Virtual property for compatibility
|
# Virtual property for compatibility
|
||||||
@property
|
@property
|
||||||
def is_active(self):
|
def is_active(self):
|
||||||
|
|||||||
@@ -26,6 +26,9 @@ class User(db.Model):
|
|||||||
document_type = db.Column(db.String(20), default='DNI', nullable=True)
|
document_type = db.Column(db.String(20), default='DNI', nullable=True)
|
||||||
document_number = db.Column(db.String(30), nullable=True, index=True)
|
document_number = db.Column(db.String(30), nullable=True, index=True)
|
||||||
|
|
||||||
|
def __init__(self, **kwargs):
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
|
||||||
def get_first_name(self):
|
def get_first_name(self):
|
||||||
if self.first_name:
|
if self.first_name:
|
||||||
return self.first_name
|
return self.first_name
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ from app.models.role import Role, Permission, SYSTEM_MODULES, ACCESS_LEVELS
|
|||||||
from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES
|
from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES
|
||||||
from app.models.audit_log import AuditLog
|
from app.models.audit_log import AuditLog
|
||||||
from app.utils.decorators import admin_required, permission_required
|
from app.utils.decorators import admin_required, permission_required
|
||||||
from sqlalchemy import or_
|
from sqlalchemy import or_, func
|
||||||
import re
|
import re
|
||||||
|
|
||||||
admin_bp = Blueprint('admin', __name__, url_prefix='/admin')
|
admin_bp = Blueprint('admin', __name__, url_prefix='/admin')
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
|
|||||||
"info": {
|
"info": {
|
||||||
"title": "Edu-Space REST API",
|
"title": "Edu-Space REST API",
|
||||||
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
|
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
|
||||||
"version": "3.4.9"
|
"version": "3.5.0"
|
||||||
},
|
},
|
||||||
"servers": [
|
"servers": [
|
||||||
{
|
{
|
||||||
|
|||||||
+1
-1
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
|||||||
|
|
||||||
setup(
|
setup(
|
||||||
name="edu-space-admin",
|
name="edu-space-admin",
|
||||||
version="3.4.9",
|
version="3.5.0",
|
||||||
description="Administrative interface for Edu-Space Classroom Management System",
|
description="Administrative interface for Edu-Space Classroom Management System",
|
||||||
author="Edu-Space Development Team",
|
author="Edu-Space Development Team",
|
||||||
author_email="admin@edu-space.com",
|
author_email="admin@edu-space.com",
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
# Documentación Oficial — Admin Edu-Space (UniCABA)
|
||||||
|
|
||||||
|
Directorio central de especificaciones, arquitectura, manuales de usuario y seguridad.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏛️ Documentos Rectores y Arquitectura
|
||||||
|
- **[constitution.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/constitution.md)**: Principios mandatorios e innegociables del sistema (SSD, flujo de 9 pasos, matriz de conflictos, testing, control de versiones semánticas y despliegue a producción con `.credenciales`).
|
||||||
|
- **[ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md)**: Arquitectura desacoplada (Backend Flask API RESTful + Frontend BFF Express/Nunjucks).
|
||||||
|
- **[DEPLOYMENT_AUDIT.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/DEPLOYMENT_AUDIT.md)**: Topología de contenedores LXC Proxmox (`10.0.0.217` y `10.0.0.207`), Nginx proxy inverso y configuración de producción.
|
||||||
|
|
||||||
|
## 📋 Manuales y Operatoria de Bedelía
|
||||||
|
- **[GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md)**: Manual del circuito secuencial de 9 pasos para el personal de Bedelía, guía de cátedra docente y estudiante.
|
||||||
|
- **[SCHEDULE_INTEGRATION_GUIDE.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/SCHEDULE_INTEGRATION_GUIDE.md)**: Guía técnica de la cartelera del día, calendario interactivo y gestión de asignaciones de aulas.
|
||||||
|
- **[GENETIC_ALGORITHM_README.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/GENETIC_ALGORITHM_README.md)**: Optimizador heurístico inteligente para asignación masiva de aulas y resolución de conflictos.
|
||||||
|
|
||||||
|
## 🔒 Seguridad e Informes Institucionales
|
||||||
|
- **[SECURITY_AUDIT_REPORT.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/SECURITY_AUDIT_REPORT.md)**: Reporte formal de auditoría de seguridad OWASP (SAST / SCA / DAST / Bitácora de Auditoría).
|
||||||
|
- **[REPORTE_CATEDRA_PROGRAMACION_DE_VANGUARDIA.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/REPORTE_CATEDRA_PROGRAMACION_DE_VANGUARDIA.md)**: Informe académico institucional sobre la materia de vanguardia tecnológica.
|
||||||
|
|
||||||
|
## 🗄️ Historial y Archivo
|
||||||
|
- **[archive/](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/archive/)**: Archivos históricos de sesiones anteriores, minutas de depuración de errores y versiones pasadas de changelogs.
|
||||||
@@ -41,6 +41,7 @@ La asignación de reservas de aulas debe validar en tiempo real e impedir de for
|
|||||||
- La suite de pruebas automatizadas (`pytest backend/tests`) y los controles de seguridad SAST/DAST/SCA (`security_audit.bat`) son mandatorios.
|
- La suite de pruebas automatizadas (`pytest backend/tests`) y los controles de seguridad SAST/DAST/SCA (`security_audit.bat`) son mandatorios.
|
||||||
- Queda terminantemente prohibido cerrar una tarea o fusionar cambios a la rama de integración con pruebas fallando o vulnerabilidades críticas no remediadas.
|
- Queda terminantemente prohibido cerrar una tarea o fusionar cambios a la rama de integración con pruebas fallando o vulnerabilidades críticas no remediadas.
|
||||||
|
|
||||||
### 9. Control de Versiones en Compilación y Despliegue Obligatorio a Servidor
|
### 9. Control de Versiones, Git Push y Despliegue Obligatorio a Servidor
|
||||||
- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py` y `CHANGELOG.md`).
|
- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py` y `CHANGELOG.md`).
|
||||||
- **Subida Inmediata y Obligatoria al Servidor**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `eduspace.oemspot.com.ar`), reiniciando los servicios y verificando el estado operativo en vivo antes de dar cualquier tarea por concluida.
|
- **Git Push Obligatorio**: Ejecutar siempre `git push origin dev` al repositorio remoto una vez que los tests automatizados (`pytest tests -v`) estén 100% aprobados.
|
||||||
|
- **Subida y Despliegue Inmediato al Servidor de Producción**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos y claves definidos en el archivo `.credenciales`, reiniciando los servicios del sistema (`systemctl restart admin-edu-space-backend admin-edu-space-frontend`) y verificando el estado operativo en vivo (HTTP 200 en `/version`) antes de dar cualquier tarea por concluida.
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "frontend",
|
"name": "frontend",
|
||||||
"version": "3.4.9",
|
"version": "3.5.0",
|
||||||
"description": "",
|
"description": "",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
+3
-3
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
|
|||||||
});
|
});
|
||||||
|
|
||||||
// Versiones institucionales del sistema
|
// Versiones institucionales del sistema
|
||||||
const APP_VERSION = '3.4.9';
|
const APP_VERSION = '3.5.0';
|
||||||
const FRONTEND_VERSION = '3.4.9';
|
const FRONTEND_VERSION = '3.5.0';
|
||||||
const BACKEND_VERSION = '3.4.9';
|
const BACKEND_VERSION = '3.5.0';
|
||||||
|
|
||||||
env.addGlobal('app_version', APP_VERSION);
|
env.addGlobal('app_version', APP_VERSION);
|
||||||
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
||||||
|
|||||||
@@ -432,6 +432,87 @@ const handleTodaySchedule = async (req, res) => {
|
|||||||
router.get('/today', handleTodaySchedule);
|
router.get('/today', handleTodaySchedule);
|
||||||
router.get('/today_schedule', handleTodaySchedule);
|
router.get('/today_schedule', handleTodaySchedule);
|
||||||
|
|
||||||
|
// Exportar cartelera a CSV compatible con Excel (UTF-8 con BOM)
|
||||||
|
const handleExportScheduleCsv = async (req, res) => {
|
||||||
|
try {
|
||||||
|
const dateStr = req.query.date || new Date().toISOString().split('T')[0];
|
||||||
|
const params = { start_date: dateStr, end_date: dateStr };
|
||||||
|
if (req.query.hide_virtual === '1') params.hide_virtual = '1';
|
||||||
|
if (req.query.floor) params.floor = req.query.floor;
|
||||||
|
if (req.query.shift) params.shift = req.query.shift;
|
||||||
|
|
||||||
|
const response = await req.apiClient.get('/reservations', { params });
|
||||||
|
const rawReservations = (response.data && response.data.reservations) || [];
|
||||||
|
const reservations = rawReservations.map(formatReservationDates);
|
||||||
|
|
||||||
|
reservations.sort((a, b) => (a.start_time || '').localeCompare(b.start_time || ''));
|
||||||
|
|
||||||
|
const headers = [
|
||||||
|
'Fecha',
|
||||||
|
'Horario',
|
||||||
|
'Turno',
|
||||||
|
'Aula / Espacio',
|
||||||
|
'Piso / Sede',
|
||||||
|
'Modalidad',
|
||||||
|
'Materia',
|
||||||
|
'Código Materia',
|
||||||
|
'Comisión',
|
||||||
|
'Carrera',
|
||||||
|
'Docente / Cátedra',
|
||||||
|
'Alumnos Estimados',
|
||||||
|
'Estado',
|
||||||
|
'Enlace Virtual'
|
||||||
|
];
|
||||||
|
|
||||||
|
const escapeCsv = (val) => {
|
||||||
|
if (val === null || val === undefined) return '""';
|
||||||
|
const s = String(val).replace(/"/g, '""');
|
||||||
|
return `"${s}"`;
|
||||||
|
};
|
||||||
|
|
||||||
|
const rows = reservations.map(r => {
|
||||||
|
const isVirtual = Boolean(r.virtual_link || (r.classroom_name && r.classroom_name.includes('VIRTUAL')));
|
||||||
|
const roomName = r.classroom_name || (r.classroom ? r.classroom.code : 'Aula');
|
||||||
|
const building = (r.classroom && r.classroom.building) || 'Sede Central';
|
||||||
|
const subjectName = r.subject_name || r.purpose || 'Clase Regular';
|
||||||
|
const subjectCode = r.subject_code || (r.commission && r.commission.subject_code) || '';
|
||||||
|
const commissionCode = (r.commission && r.commission.code) || r.commission_code || '';
|
||||||
|
const careerName = (r.commission && r.commission.career_names) || (r.commission && r.commission.career_name) || r.career_names || r.career_name || '';
|
||||||
|
const teacherName = r.teacher_name || (r.user ? r.user.full_name : '');
|
||||||
|
const virtualLink = r.effective_virtual_link || r.virtual_link || '';
|
||||||
|
|
||||||
|
return [
|
||||||
|
escapeCsv(r.date_display || dateStr),
|
||||||
|
escapeCsv(r.time_display || `${r.start_time} - ${r.end_time}`),
|
||||||
|
escapeCsv(r.shift || 'Mañana'),
|
||||||
|
escapeCsv(roomName),
|
||||||
|
escapeCsv(building),
|
||||||
|
escapeCsv(isVirtual ? 'Virtual' : 'Presencial'),
|
||||||
|
escapeCsv(subjectName),
|
||||||
|
escapeCsv(subjectCode),
|
||||||
|
escapeCsv(commissionCode),
|
||||||
|
escapeCsv(careerName),
|
||||||
|
escapeCsv(teacherName),
|
||||||
|
escapeCsv(r.expected_attendees || 30),
|
||||||
|
escapeCsv(r.status || 'CONFIRMED'),
|
||||||
|
escapeCsv(virtualLink)
|
||||||
|
].join(';');
|
||||||
|
});
|
||||||
|
|
||||||
|
// BOM UTF-8 (\uFEFF) para abrir directamente en Microsoft Excel sin problemas de encoding
|
||||||
|
const csvContent = '\uFEFF' + [headers.join(';'), ...rows].join('\r\n');
|
||||||
|
|
||||||
|
res.setHeader('Content-Type', 'text/csv; charset=utf-8');
|
||||||
|
res.setHeader('Content-Disposition', `attachment; filename="cartelera_unicaba_${dateStr}.csv"`);
|
||||||
|
res.status(200).send(csvContent);
|
||||||
|
} catch (error) {
|
||||||
|
console.error('Error generating schedule CSV:', error.message);
|
||||||
|
res.status(500).send('Error al exportar la cartelera');
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
router.get('/export_csv', handleExportScheduleCsv);
|
||||||
|
|
||||||
const { createFormMock } = require('../utils/formHelper');
|
const { createFormMock } = require('../utils/formHelper');
|
||||||
|
|
||||||
// 5. Vista de Crear Reserva
|
// 5. Vista de Crear Reserva
|
||||||
|
|||||||
@@ -266,7 +266,14 @@
|
|||||||
{{ log.details or '-' }}
|
{{ log.details or '-' }}
|
||||||
</div>
|
</div>
|
||||||
{% if log.details and log.details.length > 50 %}
|
{% if log.details and log.details.length > 50 %}
|
||||||
<button type="button" class="btn btn-link btn-sm p-0 text-decoration-none text-primary" onclick="showLogDetailModal('{{ log.id }}', '{{ log.action }}', '{{ log.module }}', '{{ log.user_email or 'Sistema' }}', '{{ log.created_at }}', '{{ log.ip_address }}', {{ log.details | dump | escape }})">
|
<button type="button" class="btn btn-link btn-sm p-0 text-decoration-none text-primary btn-view-log-detail"
|
||||||
|
data-log-id="{{ log.id }}"
|
||||||
|
data-log-action="{{ log.action }}"
|
||||||
|
data-log-module="{{ log.module }}"
|
||||||
|
data-log-user="{% if log.user_email %}{{ log.user_email }}{% else %}Sistema{% endif %}"
|
||||||
|
data-log-time="{{ log.created_at }}"
|
||||||
|
data-log-ip="{{ log.ip_address or '-' }}"
|
||||||
|
data-log-details="{{ log.details | escape }}">
|
||||||
<i class="bi bi-eye"></i>
|
<i class="bi bi-eye"></i>
|
||||||
</button>
|
</button>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
@@ -402,5 +409,21 @@ function copyModalDetails() {
|
|||||||
alert('Detalle copiado al portapapeles.');
|
alert('Detalle copiado al portapapeles.');
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
document.addEventListener('DOMContentLoaded', function() {
|
||||||
|
document.querySelectorAll('.btn-view-log-detail').forEach(function(btn) {
|
||||||
|
btn.addEventListener('click', function() {
|
||||||
|
showLogDetailModal(
|
||||||
|
this.dataset.logId,
|
||||||
|
this.dataset.logAction,
|
||||||
|
this.dataset.logModule,
|
||||||
|
this.dataset.logUser,
|
||||||
|
this.dataset.logTime,
|
||||||
|
this.dataset.logIp,
|
||||||
|
this.dataset.logDetails
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
</script>
|
</script>
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
|
|||||||
@@ -1347,6 +1347,16 @@
|
|||||||
</div>
|
</div>
|
||||||
</a>
|
</a>
|
||||||
</div>
|
</div>
|
||||||
|
<div class="col-md-12 col-lg-12 mt-2">
|
||||||
|
<div class="d-flex justify-content-end gap-2">
|
||||||
|
<a href="/schedule/export_csv" class="btn btn-sm btn-outline-success">
|
||||||
|
<i class="bi bi-file-earmark-excel me-1"></i>Descargar Planilla del Día (Excel / CSV)
|
||||||
|
</a>
|
||||||
|
<a href="/schedule/today_schedule" class="btn btn-sm btn-outline-primary">
|
||||||
|
<i class="bi bi-printer me-1"></i>Abrir Cartelera Imprimible
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@@ -4,6 +4,13 @@
|
|||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
<div class="container-fluid px-0">
|
<div class="container-fluid px-0">
|
||||||
|
<!-- Membrete exclusivo para impresión A4 de recepción y bedelía -->
|
||||||
|
<div class="print-header text-center mb-4">
|
||||||
|
<h2 class="fw-bold mb-1">Universidad de la Ciudad de Buenos Aires (UniCABA)</h2>
|
||||||
|
<h4 class="text-secondary mb-1">Cartelera Oficial de Asignación de Aulas y Cursadas</h4>
|
||||||
|
<p class="mb-0 fs-6">Fecha: <strong>{{ format_date(today, format='full')|capitalize }}</strong> — Plataforma Admin Edu-Space Bedelía</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
<!-- Header -->
|
<!-- Header -->
|
||||||
<div class="row mb-3 align-items-center">
|
<div class="row mb-3 align-items-center">
|
||||||
<div class="col-md-7">
|
<div class="col-md-7">
|
||||||
@@ -14,6 +21,12 @@
|
|||||||
<p class="text-muted small mb-0">Cronograma de clases y asignación de aulas activas para el día de hoy</p>
|
<p class="text-muted small mb-0">Cronograma de clases y asignación de aulas activas para el día de hoy</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="col-md-5 text-md-end mt-3 mt-md-0">
|
<div class="col-md-5 text-md-end mt-3 mt-md-0">
|
||||||
|
<a href="/schedule/export_csv?date={{ today }}{% if hide_virtual %}&hide_virtual=1{% endif %}{% if floor_filter %}&floor={{ floor_filter }}{% endif %}{% if shift_filter %}&shift={{ shift_filter }}{% endif %}" class="btn btn-outline-success me-2" title="Descargar como planilla Excel/CSV">
|
||||||
|
<i class="bi bi-file-earmark-excel me-1"></i>Excel / CSV
|
||||||
|
</a>
|
||||||
|
<button type="button" class="btn btn-outline-dark me-2" onclick="window.print()" title="Imprimir cartelera del día">
|
||||||
|
<i class="bi bi-printer me-1"></i>Imprimir
|
||||||
|
</button>
|
||||||
{% if user.has_permission('reservations', 'read_write') %}
|
{% if user.has_permission('reservations', 'read_write') %}
|
||||||
<a href="/schedule/add_reservation" class="btn btn-success me-2">
|
<a href="/schedule/add_reservation" class="btn btn-success me-2">
|
||||||
<i class="bi bi-plus-circle me-1"></i>Nueva Reserva
|
<i class="bi bi-plus-circle me-1"></i>Nueva Reserva
|
||||||
@@ -426,4 +439,53 @@ document.addEventListener('DOMContentLoaded', function() {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
|
<style>
|
||||||
|
@media print {
|
||||||
|
body {
|
||||||
|
background-color: #ffffff !important;
|
||||||
|
color: #000000 !important;
|
||||||
|
font-size: 10pt !important;
|
||||||
|
}
|
||||||
|
.sidebar, .navbar, .btn, .breadcrumb, form, .card-footer, #refresh-btn, #toggle-view-btn, .pagination, .alert, .badge.bg-opacity-10 {
|
||||||
|
display: none !important;
|
||||||
|
}
|
||||||
|
.main-content, .container-fluid, .content-wrapper, main {
|
||||||
|
margin: 0 !important;
|
||||||
|
padding: 0 !important;
|
||||||
|
width: 100% !important;
|
||||||
|
max-width: 100% !important;
|
||||||
|
}
|
||||||
|
.print-header {
|
||||||
|
display: block !important;
|
||||||
|
margin-bottom: 1.5rem !important;
|
||||||
|
border-bottom: 2px solid #000 !important;
|
||||||
|
padding-bottom: 0.5rem !important;
|
||||||
|
}
|
||||||
|
.card {
|
||||||
|
border: 1px solid #cccccc !important;
|
||||||
|
box-shadow: none !important;
|
||||||
|
break-inside: avoid;
|
||||||
|
margin-bottom: 1rem !important;
|
||||||
|
}
|
||||||
|
.table {
|
||||||
|
border-collapse: collapse !important;
|
||||||
|
width: 100% !important;
|
||||||
|
}
|
||||||
|
.table td, .table th {
|
||||||
|
border: 1px solid #dddddd !important;
|
||||||
|
padding: 6px 8px !important;
|
||||||
|
color: #000 !important;
|
||||||
|
}
|
||||||
|
a {
|
||||||
|
text-decoration: none !important;
|
||||||
|
color: #000 !important;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
@media screen {
|
||||||
|
.print-header {
|
||||||
|
display: none !important;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</style>
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
# Plan Técnico 001 — Cierre del MVP de Bedelía
|
||||||
|
|
||||||
|
Basado en: `specs/001-cierre-mvp-bedelia/spec.md` y `docs/constitution.md`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Análisis de Brecha (Gap Analysis)
|
||||||
|
Al contrastar la especificación `spec.md` con el estado real del repositorio:
|
||||||
|
- **Flujo de 9 Pasos**: Está implementado en un 95%. Requiere una prueba de recorrido integral (*smoke test*) para asegurar que no haya fallas de integración.
|
||||||
|
- **Matriz de Conflictos**: 100% implementada y validada en `test_phase2_rules.py`.
|
||||||
|
- **Cartelera del Día**: Agrupa franjas horarias y soporta filtros de fecha, pero **carece de exportación / impresión limpia**, lo cual fuerza a Bedelía a mantener planillas manuales para entregar a recepción.
|
||||||
|
- **Exportación / Impresión**: Falta agregar la vista de impresión optimizada (`@media print`) y la descarga directa de CSV/Excel de la agenda áulica del día/semana.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Modificaciones de Archivos y Responsabilidades
|
||||||
|
|
||||||
|
### A. Frontend BFF & Vistas
|
||||||
|
1. `frontend/src/routes/schedule.js`:
|
||||||
|
- Endpoint `GET /schedule/export_csv`: Genera y descarga un archivo CSV con las columnas: `Fecha`, `Horario`, `Turno`, `Aula / Espacio`, `Piso`, `Materia`, `Código`, `Comisión`, `Carrera`, `Docentes`, `Enlace Virtual`.
|
||||||
|
- Inyección de cabecera `Content-Type: text/csv; charset=utf-8` y `Content-Disposition: attachment; filename="cartelera_unicaba_YYYY-MM-DD.csv"`.
|
||||||
|
2. `frontend/views/schedule/today_schedule.html`:
|
||||||
|
- Incorporar en el encabezado los botones de acción rápida:
|
||||||
|
- `[ Imprimir Cartelera ]` (dispara `window.print()` con estilos CSS `@media print`).
|
||||||
|
- `[ Descargar Planilla CSV ]` (enlace directo a `/schedule/export_csv?date=...`).
|
||||||
|
- Agregar bloque de estilos CSS para impresión:
|
||||||
|
- Oculta sidebar, navbar, filtros y botones interactivos al imprimir.
|
||||||
|
- Imprime membrete formal: *"Universidad de la Ciudad de Buenos Aires (UniCABA) - Cartelera de Asignación de Aulas"*.
|
||||||
|
- Formato de tabla claro, legible y ajustado a hoja A4/Oficio.
|
||||||
|
3. `frontend/views/dashboard/dashbede.html`:
|
||||||
|
- Agregar botón de acceso directo *"Exportar Planilla de Hoy"* junto a la agenda operativa de Bedelía.
|
||||||
|
|
||||||
|
### B. Backend REST API
|
||||||
|
1. `backend/app/routes/api/reservations.py` o `backend/app/routes/api/dashboard.py`:
|
||||||
|
- Asegurar que el endpoint que nutre la agenda retorne la carrera, turno y docentes de forma plana para serialización inmediata.
|
||||||
|
|
||||||
|
### C. Suite de Pruebas
|
||||||
|
1. `backend/tests/test_cartelera_export.py`:
|
||||||
|
- Prueba unitaria/integración que valide la generación y completitud de datos de agenda diaria y semanal.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Decisiones Técnicas y Alternativas Descartadas
|
||||||
|
1. **Generación de PDF en Servidor vs. Impresión Nativa del Navegador (`window.print`)**:
|
||||||
|
- *Alternativa Descartada*: Librería pesada de generación de PDF en Node.js (Puppeteer o PDFKit), que consume más de 200MB de RAM y puede fallar en entornos LXC mínimos.
|
||||||
|
- *Decisión Adoptada*: Hoja de estilo CSS `@media print` optimizada para el navegador del usuario + exportación de datos crudos en CSV con UTF-8 con BOM (para compatibilidad total con Microsoft Excel en español).
|
||||||
|
2. **Exportador CSV en Frontend BFF vs. Backend**:
|
||||||
|
- *Decisión Adoptada*: El Frontend BFF puede construir y enviar el stream CSV directamente a partir de la respuesta del endpoint `/api/v1/dashboard/today-schedule`, reduciendo la carga del backend y aprovechando los formateadores de fecha en español ya existentes.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Cobertura de Requisitos Funcionales
|
||||||
|
- **RF-1, RF-2**: Verificados mediante el flujo de 9 pasos en UI.
|
||||||
|
- **RF-3, RF-4, RF-5, RF-6**: Cubiertos por `tests/test_phase2_rules.py`.
|
||||||
|
- **RF-7, RF-8**: Cubiertos por la nueva funcionalidad de exportación e impresión limpia.
|
||||||
|
- **RF-9**: Cubierto por el panel de comisiones sin aula en `dashbede.html`.
|
||||||
|
- **RF-10**: Cubierto por `sheets_importer.py` y `admin.js`.
|
||||||
@@ -0,0 +1,84 @@
|
|||||||
|
# Spec 001 — Cierre y Entrega Definitiva del MVP de Bedelía
|
||||||
|
|
||||||
|
Estado: Aprobada para Ejecución
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Contexto y Objetivo
|
||||||
|
El proyecto **Admin Edu-Space** de UniCABA tiene como meta fundacional erradicar el uso del archivo Excel manual que el personal de Bedelía utiliza diariamente para coordinar la asignación de espacios, aulas, comisiones y docentes. Aunque la plataforma cuenta con una arquitectura desacoplada sólida (v3.4.9) y más de 50 pruebas superadas, el equipo percibe que *"el MVP está lejos"* debido a la ausencia de una delimitación estricta de alcance (*Scope Creep*), la falta de herramientas para exportar/imprimir la cartelera diaria requerida en portería y pasillos, y la necesidad de certificar que el circuito operativo de 9 pasos puede ejecutarse de punta a punta sin recurrir a planillas auxiliares.
|
||||||
|
|
||||||
|
Esta especificación formaliza el perímetro exacto e inamovible para la entrega del **MVP Productivo de Bedelía**, fijando criterios de aceptación verificables bajo la metodología SDD (**Spec-Driven Development**) y sintaxis **EARS**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Usuarios / Actores
|
||||||
|
- **Personal de Bedelía (Actor Primario)**: Administra la asignación física y virtual de aulas, verifica comisiones sin aula, resuelve colisiones horarias y emite los partes de ocupación diarios y semanales.
|
||||||
|
- **Cuerpo Docente (Actor Secundario)**: Consulta su aula asignada (o enlace Meet), registra notas en el libro de calificaciones y reporta incidencias de aula.
|
||||||
|
- **Estudiantes (Actor de Consulta)**: Consultan su aula en la cartelera del día y acceden al enlace virtual correspondiente.
|
||||||
|
- **Administrador del Sistema (Auditor/Soporte)**: Supervisa métricas globales, gestiona usuarios y audita operaciones sensibles en `AuditLog`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Historias de Usuario
|
||||||
|
- **HU-1**: Como responsable de Bedelía, quiero gestionar el ciclo académico completo (Sedes, Aulas, Ciclos, Carreras, Materias, Comisiones, Docentes, Alumnos y Reservas) en la plataforma web para no depender de planillas de cálculo.
|
||||||
|
- **HU-2**: Como responsable de Bedelía, quiero ver en el Dashboard de forma inmediata las aulas libres y las comisiones sin aula del día y la semana para reasignar espacios en menos de tres clics.
|
||||||
|
- **HU-3**: Como personal de Bedelía, quiero imprimir o exportar a CSV/PDF la cartelera de clases del día y de la semana para entregarla a seguridad/recepción y publicarla en los pasillos de la sede.
|
||||||
|
- **HU-4**: Como docente, quiero ingresar con mi cuenta institucional y ver exactamente en qué aula física o enlace de Meet me toca dictar clase hoy sin consultar planillas en Bedelía.
|
||||||
|
- **HU-5**: Como estudiante, quiero consultar la cartelera áulica en mi móvil para saber en qué aula y piso curso hoy de forma inequívoca.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Requisitos Funcionales (Criterios de Aceptación en Notación EARS)
|
||||||
|
|
||||||
|
### Módulo 1: Flujo Operativo de 9 Pasos
|
||||||
|
- **RF-1 (EARS Ubicuo)**: EL SISTEMA mantendrá la integridad referencial relacional entre Sede ➔ Aula ➔ Ciclo Lectivo ➔ Carrera ➔ Materia ➔ Comisión ➔ Docentes (con co-docencia) ➔ Alumnos ➔ Reserva de Espacio en todas las operaciones.
|
||||||
|
- **RF-2 (EARS Basado en Eventos)**: CUANDO Bedelía cree una comisión desde `/admin/commissions_list`, EL SISTEMA asociará obligatoriamente la Asignatura, heredará y expondrá la Carrera en la interfaz y precargará el Ciclo Lectivo vigente.
|
||||||
|
- **RF-3 (EARS No Deseado)**: SI un alumno intenta ser matriculado en dos materias regulares en el mismo día, ENTONCES EL SISTEMA bloqueará la operación a menos que la materia sea curso corto (`is_short_course`) o Bedelía marque expresamente `allow_same_day_exception` con motivo justificado.
|
||||||
|
|
||||||
|
### Módulo 2: Matriz Infranqueable de Conflictos
|
||||||
|
- **RF-4 (EARS Basado en Eventos)**: CUANDO el operador intente guardar una reserva que solape físicamente un aula presencial en la misma fecha y bloque horario, EL SISTEMA rechazará la solicitud (HTTP 409) indicando la reserva en conflicto.
|
||||||
|
- **RF-5 (EARS Basado en Eventos)**: CUANDO se intente asignar una reserva a un docente que ya tiene otra clase presencial simultánea, EL SISTEMA bloqueará la asignación, SALVO que la comisión cuente con co-docencia activa registrada en `commission_teachers`.
|
||||||
|
- **RF-6 (EARS Basado en Estados)**: MIENTRAS la reserva corresponda al entorno `Campus Virtual (VIRTUAL)`, EL SISTEMA permitirá la concurrencia de múltiples comisiones en el mismo horario con enlaces de Google Meet independientes.
|
||||||
|
|
||||||
|
### Módulo 3: Cartelera, Aulas Libres y Exportación
|
||||||
|
- **RF-7 (EARS Basado en Eventos)**: CUANDO Bedelía o recepción consulte `/schedule/today_schedule`, EL SISTEMA agrupará las reservas por franja horaria real de cursada (`08:00 - 11:00 hs`, etc.), ordenadas cronológicamente y sin duplicaciones de fila.
|
||||||
|
- **RF-8 (EARS Ubicuo)**: EL SISTEMA dispondrá de un botón de exportación rápida a formato descargable (CSV estructurado) e impresión limpia (CSS print-friendly) en la Cartelera del Día y Semanal para emisión física inmediata.
|
||||||
|
- **RF-9 (EARS Basado en Estados)**: MIENTRAS existan comisiones sin espacio asignado para la fecha seleccionada, EL SISTEMA las listará en la pestaña *"Comisiones Sin Asignar"* del Dashboard de Bedelía con acceso directo al formulario de asignación en 1 clic.
|
||||||
|
|
||||||
|
### Módulo 4: Importación y Respaldo
|
||||||
|
- **RF-10 (EARS Opcional)**: DONDE Bedelía requiera importar masivamente la oferta cuatrimestral desde Google Sheets, EL SISTEMA proveerá previsualización interactiva con filtros por Carrera, Materia y Día antes de impactar en la base de datos.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Requisitos No Funcionales (RNF)
|
||||||
|
- **RNF-1 (Seguridad)**: Toda sesión de usuario debe gestionarse mediante JWT en cookie `HttpOnly` y registrarse en `AuditLog`.
|
||||||
|
- **RNF-2 (Rendimiento)**: Las consultas del Dashboard y Cartelera del Día deben responder en menos de 500 ms con una concurrencia estimada de 200 usuarios concurrentes.
|
||||||
|
- **RNF-3 (Compatibilidad)**: Interfaz adaptativa (Responsive) optimizada para terminales móviles (375px) y pantallas de recepción (1920x1080).
|
||||||
|
- **RNF-4 (Idioma)**: Todo mensaje, etiqueta, alerta y reporte debe estar redactado en español institucional rioplatense.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Casos Límite y Reglas Especiales
|
||||||
|
1. **Reinicio de Ciclo Lectivo**: Si la base se reinicia o está vacía, ninguna vista debe arrojar error 500; deben mostrarse componentes de estado vacío (*empty states*) con llamada a la acción clara.
|
||||||
|
2. **Asignaturas Compartidas**: Si una materia pertenece a múltiples carreras (Many-to-Many en `subject_careers`), la cartelera y el detalle de comisión deben exhibir todas las titulaciones asociadas.
|
||||||
|
3. **Pisos Alfanuméricos**: Aulas ubicadas en pisos no numéricos (PB, EP, Subsuelo, Piso 1) deben agruparse correctamente en los selectores en cascada.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. FUERA DE ALCANCE (Out of Scope para el MVP)
|
||||||
|
Para garantizar la entrega inmediata y evitar demoras innecesarias, los siguientes aspectos quedan formalmente **excluidos** de esta entrega y se derivan a la Fase 6 / Roadmap v4.0:
|
||||||
|
- ❌ Sincronización continua de dos vías en segundo plano con Moodle WebServices mediante Daemons systemd persistentes (la importación inicial y SSO cubren la necesidad del MVP).
|
||||||
|
- ❌ Aplicación móvil nativa compilada para Android/iOS (el diseño web responsive cubre el 100% del acceso móvil).
|
||||||
|
- ❌ Módulo de pagos o aranceles de matrícula.
|
||||||
|
- ❌ Gestión de inventario de activos físicos dentro de las aulas (PCs, proyectores, cables HDMI).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. Criterios de Finalización (Definition of Done)
|
||||||
|
El MVP se considerará **100% ENTREGADO** cuando:
|
||||||
|
1. [ ] El flujo completo de 9 pasos de Bedelía pueda ser ejecutado por un operador sin errores en consola ni en logs.
|
||||||
|
2. [ ] La cartelera del día cuente con el botón de **Impresión / Exportación** funcionando.
|
||||||
|
3. [ ] Todas las 52 pruebas automatizadas de backend (`pytest tests -v`) pasen en verde.
|
||||||
|
4. [ ] La suite de auditoría de seguridad (`security_audit.bat`) no registre vulnerabilidades críticas.
|
||||||
|
5. [ ] La versión esté desplegada y verificada en el servidor de producción institucional (`https://eduspace.oemspot.com.ar`).
|
||||||
|
6. [ ] La memoria del proyecto (`MEMORY.md`) y el `CHANGELOG.md` queden actualizados reflejando el cierre del MVP.
|
||||||
@@ -0,0 +1,37 @@
|
|||||||
|
# Tareas de Implementación 001 — Cierre del MVP de Bedelía
|
||||||
|
|
||||||
|
Basado en: `specs/001-cierre-mvp-bedelia/spec.md` y `plan.md`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Lista de Tareas Atómicas
|
||||||
|
|
||||||
|
- [x] **T1 — Endpoint de Exportación CSV en Frontend BFF (`/schedule/export_csv`)**
|
||||||
|
- **Archivos:** `frontend/src/routes/schedule.js`
|
||||||
|
- **RF Cubiertos:** RF-8
|
||||||
|
- **Descripción:** Implementar el endpoint que toma el parámetro `date` (o fecha actual), consulta el cronograma real de la API backend, y retorna un archivo CSV estructurado con cabeceras en español (`Fecha`, `Horario`, `Turno`, `Aula`, `Piso`, `Materia`, `Código`, `Comisión`, `Carrera`, `Docentes`, `Modalidad/Meet`) y prefijo UTF-8 BOM (`\uFEFF`) para compatibilidad directa con Microsoft Excel.
|
||||||
|
- **Hecho cuando:** Una petición GET a `/schedule/export_csv?date=2026-10-16` responda con HTTP 200, cabecera `Content-Disposition: attachment` y el contenido CSV formateado con las reservas del día.
|
||||||
|
|
||||||
|
- [x] **T2 — Botones de Impresión y Descarga en Cartelera del Día (`today_schedule.html`)**
|
||||||
|
- **Archivos:** `frontend/views/schedule/today_schedule.html`
|
||||||
|
- **RF Cubiertos:** RF-7, RF-8
|
||||||
|
- **Descripción:** Añadir en la barra superior de acciones de la cartelera los botones `Imprimir Cartelera` (icono `bi-printer`, ejecuta `window.print()`) y `Descargar Planilla CSV` (icono `bi-file-earmark-excel`). Agregar estilos `@media print` para ocultar la barra lateral, botones y pie de página, mostrando un membrete institucional limpio para recepción.
|
||||||
|
- **Hecho cuando:** Al presionar `Imprimir`, la vista previa de impresión muestre únicamente la grilla de asignaciones sin elementos de navegación, y al presionar `Descargar Planilla`, se descargue el archivo `.csv`.
|
||||||
|
|
||||||
|
- [x] **T3 — Botón de Exportación en Dashboard de Bedelía (`dashbede.html`)**
|
||||||
|
- **Archivos:** `frontend/views/dashboard/dashbede.html`
|
||||||
|
- **RF Cubiertos:** RF-8, RF-9
|
||||||
|
- **Descripción:** Agregar un botón destacado de exportación en la sección de Cartelera & Agenda de Bedelía para descargar o imprimir el parte del día en 1 clic.
|
||||||
|
- **Hecho cuando:** El botón sea visible en el Dashboard de Bedelía y redirija a la descarga o apertura de la cartelera imprimible.
|
||||||
|
|
||||||
|
- [x] **T4 — Verificación de Calidad y Pruebas Automatizadas**
|
||||||
|
- **Archivos:** `backend/tests/`
|
||||||
|
- **RF Cubiertos:** Todos (RF-1 al RF-10)
|
||||||
|
- **Descripción:** Ejecutar la suite completa de pruebas del backend (`python -m pytest tests -v`) verificando 0 fallos.
|
||||||
|
- **Hecho cuando:** La suite ejecute 52 tests y reporte 100% passed.
|
||||||
|
|
||||||
|
- [x] **T5 — Cierre de Versión, Actualización de Memoria y Principio 9 de la Constitución**
|
||||||
|
- **Archivos:** `package.json`, `app.js`, `backend/__init__.py`, `MEMORY.md`, `CHANGELOG.md`
|
||||||
|
- **RF Cubiertos:** RNF-1, RNF-4, Principio 9
|
||||||
|
- **Descripción:** Incrementar la versión semántica a `v3.5.0` (Cierre Formal MVP Bedelía), registrar las decisiones en `MEMORY.md` y detallar los cambios en `CHANGELOG.md`.
|
||||||
|
- **Hecho cuando:** La versión `v3.5.0` esté registrada en todos los descriptores y el reporte final esté listo para despliegue.
|
||||||
Reference in New Issue
Block a user