feat: release v3.5.0 - formal MVP Bedelia closure, SDD harness, cartelera export, docs cleanup & model fixes

This commit is contained in:
2026-10-16 13:18:02 -03:00
parent 94009ec552
commit 39c80f573b
53 changed files with 767 additions and 32 deletions
+75
View File
@@ -0,0 +1,75 @@
---
name: deploy
description: Procedimiento innegociable de bump semántico de versión, git push y despliegue continuo en producción (LXC 10.0.0.217) utilizando .credenciales.
---
# Skill: Despliegue Continuo, Bump de Versión y Git Push
Esta skill define el protocolo obligatorio para consolidar, versionar, publicar y desplegar cambios en **admin-edu-space**.
---
## Principio Rector (Principio 9 de la Constitución)
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
1. **Subir la versión semántica** de forma coordinada.
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev`).
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
---
## Paso 1: Bump Semántico de Versión
Incrementar la versión siguiendo SemVer (`X.Y.Z`) en todos los descriptores del proyecto:
- `frontend/package.json` (`"version": "X.Y.Z"`)
- `frontend/src/app.js` (`APP_VERSION`, `FRONTEND_VERSION`, `BACKEND_VERSION`)
- `backend/app/__init__.py` (`__version__ = "X.Y.Z"`)
- `backend/setup.py` (`version="X.Y.Z"`)
- `backend/app/routes/api/openapi.py` (`"version": "X.Y.Z"`)
- `CHANGELOG.md` (Nueva sección `## [X.Y.Z] - YYYY-MM-DD`)
- `MEMORY.md` (Registrar hito del sprint)
---
## Paso 2: Git Commit y Push
Ejecutar la suite de pruebas (`python -m pytest tests -v` en `backend`). Si está 100% en verde:
```powershell
git add .
git commit -m "feat/fix: descripción del cambio (vX.Y.Z)"
git push origin dev
```
---
## Paso 3: Despliegue en Servidor de Producción (LXC Edu-Admin-Space)
Consultar el archivo `.credenciales` en la raíz del proyecto para obtener la IP, usuario y contraseña del host:
- **Host / IP:** `10.0.0.217` (LXC Debian Edu-Admin-Space)
- **Dominio Público:** `https://eduspace.oemspot.com.ar`
- **Usuario SSH:** `root`
- **Acceso:** Credenciales de `.credenciales`
### Comandos de Despliegue Remoto:
1. Conectar vía SSH y sincronizar repositorio en el servidor:
```bash
ssh root@10.0.0.217 "cd /opt/admin-edu-space && git fetch && git checkout dev && git pull origin dev"
```
2. Si hubo cambios en dependencias o esquema:
```bash
ssh root@10.0.0.217 "cd /opt/admin-edu-space/backend && ./venv/bin/pip install -r requirements.txt && ./venv/bin/flask db upgrade"
ssh root@10.0.0.217 "cd /opt/admin-edu-space/frontend && npm install"
```
3. Reiniciar servicios systemd del Backend y Frontend:
```bash
ssh root@10.0.0.217 "systemctl restart admin-edu-space-backend admin-edu-space-frontend"
```
4. Verificar estado del servicio:
```bash
ssh root@10.0.0.217 "systemctl status admin-edu-space-backend --no-pager"
ssh root@10.0.0.217 "systemctl status admin-edu-space-frontend --no-pager"
```
---
## Paso 4: Verificación de Disponibilidad en Vivo (Smoke Test)
Comprobar que el endpoint público responde HTTP 200 con la nueva versión:
- Backend version: `https://eduspace.oemspot.com.ar/api/v1/version` o `http://10.0.0.217:5000/api/v1/version`
- Frontend version: `https://eduspace.oemspot.com.ar/version`
- Pantalla de login accesible: HTTP 200 en `https://eduspace.oemspot.com.ar/login`
+66
View File
@@ -0,0 +1,66 @@
---
name: sdd
description: Flujo de desarrollo guiado por especificaciones (Spec-Driven Development) basado en los principios de ingeniería de software con IA y sintaxis EARS.
---
# Skill: Spec-Driven Development (SDD)
Esta skill define el arnés metodológico innegociable para implementar, refactorizar o validar funcionalidades en **admin-edu-space**.
## Principio Fundamental
**La especificación manda**: Ninguna línea de código de negocio se escribe si no está precedida por una especificación aprobada (`spec.md`), un plan técnico (`plan.md`) y una lista de tareas atómicas (`tasks.md`).
---
## Flujo de Trabajo (7 Pasos)
```
1. Constitución (docs/constitution.md)
↓
2. Especificación (specs/NNN-nombre/spec.md)
↓
3. Clarificación (Revisión QA - detección de ambigüedades)
↓
4. Planificación (specs/NNN-nombre/plan.md)
↓
5. Desglose de Tareas (specs/NNN-nombre/tasks.md)
↓
6. Implementación (Tarea por tarea, Test-First)
↓
7. Validación (RF por RF + Criterios de Finalización)
```
---
## Sintaxis EARS (Easy Approach to Requirements Syntax)
Todo Requisito Funcional (RF) debe redactarse usando exclusivamente una de las 5 estructuras EARS en español:
1. **Ubicuo (Comportamiento permanente)**:
> `EL SISTEMA <comportamiento permanente>.`
> *Ejemplo:* EL SISTEMA registrará en `AuditLog` toda modificación de asignación de aula.
2. **Basado en Eventos (Disparado por una acción)**:
> `CUANDO <evento>, EL SISTEMA <respuesta>.`
> *Ejemplo:* CUANDO el usuario confirme una reserva con conflicto físico, EL SISTEMA bloqueará la operación y retornará un error HTTP 409 con el detalle de la superposición.
3. **Basado en Estados (Activo mientras se cumpla una condición)**:
> `MIENTRAS <estado>, EL SISTEMA <respuesta>.`
> *Ejemplo:* MIENTRAS una comisión posea co-docencia activa registrada, EL SISTEMA permitirá la superposición horaria del docente auxiliar.
4. **No Deseado / Excepciones (Manejo de errores y límites)**:
> `SI <condición no deseada>, ENTONCES EL SISTEMA <respuesta>.`
> *Ejemplo:* SI la matrícula de la comisión supera el aforo máximo del aula, ENTONCES EL SISTEMA impedirá el guardado y alertará al operador de Bedelía.
5. **Opcional (Funcionalidad dependiente de configuración o rol)**:
> `DONDE <característica opcional>, EL SISTEMA <respuesta>.`
> *Ejemplo:* DONDE el usuario posea rol Bedelia o Admin, EL SISTEMA habilitará el botón de reasignación directa de aulas libres.
---
## Reglas de Ejecución para Agentes
1. **No inventar**: Si falta información o un caso de uso no está cubierto, detenerse y marcar `[NECESITA ACLARACIÓN]`.
2. **Tareas pequeñas**: Cada tarea en `tasks.md` debe tener una duración estimada de 20-30 minutos y contar con su criterio *"Hecho cuando:"*.
3. **Test-First**: En la lógica de backend, escribir primero el test en rojo antes de tocar el código de la solución.
4. **Validación RF por RF**: Al finalizar, verificar cada RF de la especificación contra los tests y la interfaz gráfica.
5. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
6. **Bump de Versión, Git Push y Despliegue en Producción (Skill `deploy`)**: Conforme al Principio 9 de la Constitución, incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `CHANGELOG.md`), ejecutar `git push origin dev` al repositorio remoto y desplegar en producción al servidor institucional LXC (`10.0.0.217`) utilizando las credenciales de `.credenciales`.
+1 -1
View File
@@ -224,7 +224,7 @@ legacy_admin-edu-space/
.schemathesis/ .schemathesis/
AlumnosLS AlumnosLS
prerrequisitos apuntes
.credentials .credentials
.credenciales .credenciales
+15
View File
@@ -0,0 +1,15 @@
---
description: Coordinador general del proyecto Admin Edu-Space. Dirige el flujo SDD orquestando al planificador, implementador y revisor sin tocar código directamente.
mode: primary
---
Eres el Agente Coordinador (Coordinator) de **admin-edu-space**.
Tu misión es guiar el avance hacia la entrega del MVP de Bedelía asegurando el cumplimiento de `docs/constitution.md` y `AGENTS.md`.
## Flujo de Trabajo
1. **Spec**: Delegar en `@planner` la redacción de `specs/NNN-nombre/spec.md`.
2. **Clarificación**: Delegar en `@reviewer` la revisión QA para eliminar ambigüedades.
3. **Plan y Tareas**: Delegar en `@planner` la confección de `plan.md` y `tasks.md`.
4. **Implementación**: Delegar en `@implementer` una tarea atómica a la vez.
5. **Validación**: Delegar en `@reviewer` la validación RF por RF.
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución.
+13
View File
@@ -0,0 +1,13 @@
---
description: Agente implementador de Admin Edu-Space. Ejecuta tareas atómicas individuales guiado por el plan y con enfoque Test-First.
mode: subagent
---
Eres el Agente Implementador (Implementer) de **admin-edu-space**.
Tu misión es ejecutar UNA tarea específica de `tasks.md` sin rediseñar el plan ni añadir alcance no solicitado.
## Reglas
- Lee la tarea asignada, `plan.md`, `docs/constitution.md` y `AGENTS.md`.
- Enfoque **Test-First**: si tocas lógica de negocio, crea o ajusta primero la prueba automatizada en `backend/tests/`.
- Ejecuta las pruebas (`python -m pytest tests -v` en backend) y asegura 100% de éxito.
- Marca la tarea con `[x]` en `tasks.md` al terminar y detén tu ejecución para supervisión.
+14
View File
@@ -0,0 +1,14 @@
---
description: Agente planificador SDD de Admin Edu-Space. Redacta especificaciones EARS, planes técnicos y tareas atómicas. No escribe código de aplicación.
mode: subagent
---
Eres el Agente Planificador (Planner) de **admin-edu-space**.
Tu objetivo es redactar especificaciones precisas, arquitecturas limpias y listas de tareas sin tocar el código fuente del backend ni del frontend.
## Reglas
- Lee siempre `docs/constitution.md`, `AGENTS.md` y `MEMORY.md`.
- Escribe las especificaciones en `specs/NNN-nombre/spec.md` con sintaxis EARS en español.
- Nunca incluyas nombres de archivos ni detalles de base de datos en `spec.md` (van en `plan.md`).
- Define criterios de aceptación verificables y delimita claramente el **Fuera de Alcance**.
- En `tasks.md`, desglosa tareas en bloques atómicos de 20 a 30 minutos con `[ ]` y criterio *"Hecho cuando:"*.
+16
View File
@@ -0,0 +1,16 @@
---
description: Agente revisor y auditor QA de Admin Edu-Space. Clarifica especificaciones y valida implementaciones RF por RF sin modificar archivos.
mode: subagent
---
Eres el Agente Revisor (Reviewer) de **admin-edu-space**.
Tu misión es actuar como QA profesional y auditor de calidad, garantizando que el software cumpla la especificación al 100%.
## Tareas
1. **En Clarificación de Spec**: Busca ambigüedades, contradicciones, lagunas en casos límite o choques con `docs/constitution.md`.
2. **En Validación de Implementación**:
- Revisa los cambios (`git diff`).
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
- Recorre cada RF de la especificación y emite un veredicto formal:
- `VEREDICTO: APROBADO`
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
+23
View File
@@ -0,0 +1,23 @@
---
description: Bump de versión, commit, git push y despliegue a producción usando .credenciales
agent: coordinator
---
Ejecuta el protocolo innegociable de despliegue continuo (Skill `deploy` y Principio 9):
1. Comprueba que la suite de pruebas esté en verde: `cd backend && pytest tests -v`.
2. Incrementa el número de versión semántica en:
- `frontend/package.json`
- `frontend/src/app.js`
- `backend/app/__init__.py`
- `backend/setup.py`
- `backend/app/routes/api/openapi.py`
- `CHANGELOG.md`
- `MEMORY.md`
3. Ejecuta `git add .`, `git commit` y `git push origin dev` al repositorio remoto.
4. Conéctate vía SSH al servidor de producción utilizando los datos del archivo `.credenciales`:
- Host LXC: `10.0.0.217`
- Usuario: `root`
5. Ejecuta en el servidor:
- `cd /opt/admin-edu-space && git pull origin dev`
- `systemctl restart admin-edu-space-backend admin-edu-space-frontend`
6. Verifica que `https://eduspace.oemspot.com.ar/version` responda HTTP 200 con la versión recién publicada.
+12
View File
@@ -0,0 +1,12 @@
---
description: SDD · Genera el plan técnico a partir de una spec aprobada
---
Lee `docs/constitution.md`, `AGENTS.md` y `specs/$1/spec.md`. NO escribas código.
Genera `specs/$1/plan.md` con:
1. Archivos que se crean o modifican y responsabilidad de cada uno.
2. Contratos de API (endpoints REST `/api/v1/`, métodos, payload JSON, códigos HTTP).
3. Componentes de UI / Vistas Nunjucks afectadas.
4. Decisiones técnicas justificadas (y la alternativa descartada).
5. Estrategia de tests automatizados (`pytest tests -v`).
6. Mapeo de qué Requisito Funcional (RF) cubre cada parte.
+12
View File
@@ -0,0 +1,12 @@
---
description: SDD · Genera o entrevista para crear una nueva spec (uso /sdd-spec 001-nombre idea)
---
NO escribas código en ningún momento. Lee `docs/constitution.md`, `AGENTS.md` y `MEMORY.md`, y utiliza la skill `sdd`.
Carpeta de la spec: `specs/$1/`
Idea inicial: $ARGUMENTS
Tu trabajo:
1. Haz preguntas de UNA en UNA para eliminar ambigüedades (casos límite, errores, qué queda fuera de alcance para el MVP). Máximo 5 preguntas.
2. Genera `specs/$1/spec.md` siguiendo la plantilla de SDD, con requisitos funcionales en notación EARS en español y "Estado: borrador".
3. Describe exclusivamente el QUÉ y el POR QUÉ: nada de nombres de archivo, modelos ni arquitectura (eso va en el plan).
+8
View File
@@ -0,0 +1,8 @@
---
description: SDD · Genera las tareas atómicas a partir de spec.md y plan.md
---
A partir de `specs/$1/spec.md` y `specs/$1/plan.md`, genera `specs/$1/tasks.md`:
1. Tareas pequeñas y atómicas (máximo 20-30 minutos cada una).
2. Ordenadas por dependencia lógica (Backend / Datos primero, luego Frontend BFF / UI, luego Tests y Validación).
3. Cada tarea debe indicar qué RFs cubre y una línea `"Hecho cuando:"` verificable.
4. Utiliza checkboxes `[ ]`.
+17 -1
View File
@@ -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.
+17
View File
@@ -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`):**
+19 -4
View File
@@ -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.
+7 -5
View File
@@ -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`)
--- ---
@@ -15,11 +16,12 @@ El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en
Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado) Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado)
Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado) Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado)
Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado) Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado)
Fase 3: Hitos Evaluativos y Calificaciones[████████████████████] 100% (Completado) Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
Fase 4: UI/UX Drag & Drop e Impersonación[████████████████████] 100% (Completado) Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado) Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
Fase 5.1: Bedelía UX, ABMs y Purga Datos [████████████████████] 100% (Completado) Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
Fase 6: Despliegue Producción e Infraest.[███████░░░░░░░░░░░░░] 35% (En Curso) Sprint MVP: Flujo 9 Pasos & Cierre de Bedelía [████████████████████] 100% (Entregado v3.5.0)
Fase 6: Despliegue Producción e Infraest. [███████░░░░░░░░░░░░░] 45% (En Curso)
``` ```
--- ---
+4 -4
View File
@@ -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)
``` ```
--- ---
+1 -1
View File
@@ -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()
+3
View File
@@ -16,6 +16,9 @@ class AcademicTerm(db.Model):
is_active = db.Column(db.Boolean, default=True, nullable=False) is_active = db.Column(db.Boolean, default=True, nullable=False)
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
+12
View File
@@ -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'}>"
+3
View File
@@ -17,6 +17,9 @@ class Building(db.Model):
# Relationships # Relationships
classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id') classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id')
def __init__(self, **kwargs):
super().__init__(**kwargs)
@property @property
def is_virtual(self): def is_virtual(self):
"""Identifica si la sede corresponde al Campus Virtual""" """Identifica si la sede corresponde al Campus Virtual"""
+3
View File
@@ -13,6 +13,9 @@ class Career(db.Model):
# Relationships # Relationships
subjects = db.relationship('Subject', backref='career_obj', lazy=True) subjects = db.relationship('Subject', backref='career_obj', lazy=True)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
+3
View File
@@ -16,6 +16,9 @@ class Classroom(db.Model):
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
# Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms) # Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms)
@property @property
def building_rel(self): def building_rel(self):
+3
View File
@@ -35,6 +35,9 @@ class StudentEnrollment(db.Model):
student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan')) student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan')) commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
+3
View File
@@ -50,6 +50,9 @@ class MilestoneGrade(db.Model):
student = db.relationship('User', foreign_keys=[student_id], backref=db.backref('received_grades', lazy='dynamic')) student = db.relationship('User', foreign_keys=[student_id], backref=db.backref('received_grades', lazy='dynamic'))
graded_by = db.relationship('User', foreign_keys=[graded_by_user_id]) graded_by = db.relationship('User', foreign_keys=[graded_by_user_id])
def __init__(self, **kwargs):
super().__init__(**kwargs)
@property @property
def is_passed(self) -> bool: def is_passed(self) -> bool:
"""Determina si la nota está aprobada (>= 4.00 y no ausente).""" """Determina si la nota está aprobada (>= 4.00 y no ausente)."""
+6
View File
@@ -21,6 +21,9 @@ class MilestoneType(db.Model):
# Relación uno-a-muchos con AcademicMilestone # Relación uno-a-muchos con AcademicMilestone
milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan') milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan')
def __init__(self, **kwargs):
super().__init__(**kwargs)
def to_dict(self): def to_dict(self):
return { return {
'id': self.id, 'id': self.id,
@@ -61,6 +64,9 @@ class AcademicMilestone(db.Model):
subject = db.relationship('Subject', backref=db.backref('milestones', lazy='dynamic')) subject = db.relationship('Subject', backref=db.backref('milestones', lazy='dynamic'))
commission = db.relationship('Commission', backref=db.backref('academic_milestones', lazy='dynamic', cascade='all, delete-orphan')) commission = db.relationship('Commission', backref=db.backref('academic_milestones', lazy='dynamic', cascade='all, delete-orphan'))
def __init__(self, **kwargs):
super().__init__(**kwargs)
@property @property
def tipo(self): def tipo(self):
return self.type_obj.name if self.type_obj else 'Otro' return self.type_obj.name if self.type_obj else 'Otro'
+3
View File
@@ -53,6 +53,9 @@ class Reservation(db.Model):
created_at = db.Column(db.DateTime, default=datetime.utcnow) created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
# Virtual property to convert status string to enum # Virtual property to convert status string to enum
@property @property
def status_enum(self): def status_enum(self):
+3
View File
@@ -97,6 +97,9 @@ class Role(db.Model):
permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan') permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan')
users = db.relationship('User', backref='role_obj', lazy='select') users = db.relationship('User', backref='role_obj', lazy='select')
def __init__(self, **kwargs):
super().__init__(**kwargs)
def get_permission(self, module): def get_permission(self, module):
"""Get access level string for a given module ('none', 'read', 'read_write')""" """Get access level string for a given module ('none', 'read', 'read_write')"""
for p in self.permissions: for p in self.permissions:
+3
View File
@@ -18,6 +18,9 @@ class SystemSetting(db.Model):
is_encrypted = db.Column(db.Boolean, default=False, nullable=True) is_encrypted = db.Column(db.Boolean, default=False, nullable=True)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
def __init__(self, **kwargs):
super().__init__(**kwargs)
@classmethod @classmethod
def get_value(cls, key, default=None): def get_value(cls, key, default=None):
"""Retorna el valor tal como está almacenado en BD.""" """Retorna el valor tal como está almacenado en BD."""
+6
View File
@@ -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):
+3
View File
@@ -26,6 +26,9 @@ class User(db.Model):
document_type = db.Column(db.String(20), default='DNI', nullable=True) document_type = db.Column(db.String(20), default='DNI', nullable=True)
document_number = db.Column(db.String(30), nullable=True, index=True) document_number = db.Column(db.String(30), nullable=True, index=True)
def __init__(self, **kwargs):
super().__init__(**kwargs)
def get_first_name(self): def get_first_name(self):
if self.first_name: if self.first_name:
return self.first_name return self.first_name
+1 -1
View File
@@ -7,7 +7,7 @@ from app.models.role import Role, Permission, SYSTEM_MODULES, ACCESS_LEVELS
from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES
from app.models.audit_log import AuditLog from app.models.audit_log import AuditLog
from app.utils.decorators import admin_required, permission_required from app.utils.decorators import admin_required, permission_required
from sqlalchemy import or_ from sqlalchemy import or_, func
import re import re
admin_bp = Blueprint('admin', __name__, url_prefix='/admin') admin_bp = Blueprint('admin', __name__, url_prefix='/admin')
+1 -1
View File
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
"info": { "info": {
"title": "Edu-Space REST API", "title": "Edu-Space REST API",
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
"version": "3.4.9" "version": "3.5.0"
}, },
"servers": [ "servers": [
{ {
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="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",
+22
View File
@@ -0,0 +1,22 @@
# Documentación Oficial — Admin Edu-Space (UniCABA)
Directorio central de especificaciones, arquitectura, manuales de usuario y seguridad.
---
## 🏛️ Documentos Rectores y Arquitectura
- **[constitution.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/constitution.md)**: Principios mandatorios e innegociables del sistema (SSD, flujo de 9 pasos, matriz de conflictos, testing, control de versiones semánticas y despliegue a producción con `.credenciales`).
- **[ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md)**: Arquitectura desacoplada (Backend Flask API RESTful + Frontend BFF Express/Nunjucks).
- **[DEPLOYMENT_AUDIT.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/DEPLOYMENT_AUDIT.md)**: Topología de contenedores LXC Proxmox (`10.0.0.217` y `10.0.0.207`), Nginx proxy inverso y configuración de producción.
## 📋 Manuales y Operatoria de Bedelía
- **[GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md)**: Manual del circuito secuencial de 9 pasos para el personal de Bedelía, guía de cátedra docente y estudiante.
- **[SCHEDULE_INTEGRATION_GUIDE.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/SCHEDULE_INTEGRATION_GUIDE.md)**: Guía técnica de la cartelera del día, calendario interactivo y gestión de asignaciones de aulas.
- **[GENETIC_ALGORITHM_README.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/GENETIC_ALGORITHM_README.md)**: Optimizador heurístico inteligente para asignación masiva de aulas y resolución de conflictos.
## 🔒 Seguridad e Informes Institucionales
- **[SECURITY_AUDIT_REPORT.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/SECURITY_AUDIT_REPORT.md)**: Reporte formal de auditoría de seguridad OWASP (SAST / SCA / DAST / Bitácora de Auditoría).
- **[REPORTE_CATEDRA_PROGRAMACION_DE_VANGUARDIA.md](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/REPORTE_CATEDRA_PROGRAMACION_DE_VANGUARDIA.md)**: Informe académico institucional sobre la materia de vanguardia tecnológica.
## 🗄️ Historial y Archivo
- **[archive/](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/docs/archive/)**: Archivos históricos de sesiones anteriores, minutas de depuración de errores y versiones pasadas de changelogs.
+4 -3
View File
@@ -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 -1
View File
@@ -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
View File
@@ -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);
+81
View File
@@ -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
+24 -1
View File
@@ -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 %}
+10
View File
@@ -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>
+62
View File
@@ -4,6 +4,13 @@
{% block content %} {% block content %}
<div class="container-fluid px-0"> <div class="container-fluid px-0">
<!-- Membrete exclusivo para impresión A4 de recepción y bedelía -->
<div class="print-header text-center mb-4">
<h2 class="fw-bold mb-1">Universidad de la Ciudad de Buenos Aires (UniCABA)</h2>
<h4 class="text-secondary mb-1">Cartelera Oficial de Asignación de Aulas y Cursadas</h4>
<p class="mb-0 fs-6">Fecha: <strong>{{ format_date(today, format='full')|capitalize }}</strong> — Plataforma Admin Edu-Space Bedelía</p>
</div>
<!-- Header --> <!-- Header -->
<div class="row mb-3 align-items-center"> <div class="row mb-3 align-items-center">
<div class="col-md-7"> <div class="col-md-7">
@@ -14,6 +21,12 @@
<p class="text-muted small mb-0">Cronograma de clases y asignación de aulas activas para el día de hoy</p> <p class="text-muted small mb-0">Cronograma de clases y asignación de aulas activas para el día de hoy</p>
</div> </div>
<div class="col-md-5 text-md-end mt-3 mt-md-0"> <div class="col-md-5 text-md-end mt-3 mt-md-0">
<a href="/schedule/export_csv?date={{ today }}{% if hide_virtual %}&hide_virtual=1{% endif %}{% if floor_filter %}&floor={{ floor_filter }}{% endif %}{% if shift_filter %}&shift={{ shift_filter }}{% endif %}" class="btn btn-outline-success me-2" title="Descargar como planilla Excel/CSV">
<i class="bi bi-file-earmark-excel me-1"></i>Excel / CSV
</a>
<button type="button" class="btn btn-outline-dark me-2" onclick="window.print()" title="Imprimir cartelera del día">
<i class="bi bi-printer me-1"></i>Imprimir
</button>
{% if user.has_permission('reservations', 'read_write') %} {% if user.has_permission('reservations', 'read_write') %}
<a href="/schedule/add_reservation" class="btn btn-success me-2"> <a href="/schedule/add_reservation" class="btn btn-success me-2">
<i class="bi bi-plus-circle me-1"></i>Nueva Reserva <i class="bi bi-plus-circle me-1"></i>Nueva Reserva
@@ -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 %}
+57
View File
@@ -0,0 +1,57 @@
# Plan Técnico 001 — Cierre del MVP de Bedelía
Basado en: `specs/001-cierre-mvp-bedelia/spec.md` y `docs/constitution.md`.
---
## 1. Análisis de Brecha (Gap Analysis)
Al contrastar la especificación `spec.md` con el estado real del repositorio:
- **Flujo de 9 Pasos**: Está implementado en un 95%. Requiere una prueba de recorrido integral (*smoke test*) para asegurar que no haya fallas de integración.
- **Matriz de Conflictos**: 100% implementada y validada en `test_phase2_rules.py`.
- **Cartelera del Día**: Agrupa franjas horarias y soporta filtros de fecha, pero **carece de exportación / impresión limpia**, lo cual fuerza a Bedelía a mantener planillas manuales para entregar a recepción.
- **Exportación / Impresión**: Falta agregar la vista de impresión optimizada (`@media print`) y la descarga directa de CSV/Excel de la agenda áulica del día/semana.
---
## 2. Modificaciones de Archivos y Responsabilidades
### A. Frontend BFF & Vistas
1. `frontend/src/routes/schedule.js`:
- Endpoint `GET /schedule/export_csv`: Genera y descarga un archivo CSV con las columnas: `Fecha`, `Horario`, `Turno`, `Aula / Espacio`, `Piso`, `Materia`, `Código`, `Comisión`, `Carrera`, `Docentes`, `Enlace Virtual`.
- Inyección de cabecera `Content-Type: text/csv; charset=utf-8` y `Content-Disposition: attachment; filename="cartelera_unicaba_YYYY-MM-DD.csv"`.
2. `frontend/views/schedule/today_schedule.html`:
- Incorporar en el encabezado los botones de acción rápida:
- `[ Imprimir Cartelera ]` (dispara `window.print()` con estilos CSS `@media print`).
- `[ Descargar Planilla CSV ]` (enlace directo a `/schedule/export_csv?date=...`).
- Agregar bloque de estilos CSS para impresión:
- Oculta sidebar, navbar, filtros y botones interactivos al imprimir.
- Imprime membrete formal: *"Universidad de la Ciudad de Buenos Aires (UniCABA) - Cartelera de Asignación de Aulas"*.
- Formato de tabla claro, legible y ajustado a hoja A4/Oficio.
3. `frontend/views/dashboard/dashbede.html`:
- Agregar botón de acceso directo *"Exportar Planilla de Hoy"* junto a la agenda operativa de Bedelía.
### B. Backend REST API
1. `backend/app/routes/api/reservations.py` o `backend/app/routes/api/dashboard.py`:
- Asegurar que el endpoint que nutre la agenda retorne la carrera, turno y docentes de forma plana para serialización inmediata.
### C. Suite de Pruebas
1. `backend/tests/test_cartelera_export.py`:
- Prueba unitaria/integración que valide la generación y completitud de datos de agenda diaria y semanal.
---
## 3. Decisiones Técnicas y Alternativas Descartadas
1. **Generación de PDF en Servidor vs. Impresión Nativa del Navegador (`window.print`)**:
- *Alternativa Descartada*: Librería pesada de generación de PDF en Node.js (Puppeteer o PDFKit), que consume más de 200MB de RAM y puede fallar en entornos LXC mínimos.
- *Decisión Adoptada*: Hoja de estilo CSS `@media print` optimizada para el navegador del usuario + exportación de datos crudos en CSV con UTF-8 con BOM (para compatibilidad total con Microsoft Excel en español).
2. **Exportador CSV en Frontend BFF vs. Backend**:
- *Decisión Adoptada*: El Frontend BFF puede construir y enviar el stream CSV directamente a partir de la respuesta del endpoint `/api/v1/dashboard/today-schedule`, reduciendo la carga del backend y aprovechando los formateadores de fecha en español ya existentes.
---
## 4. Cobertura de Requisitos Funcionales
- **RF-1, RF-2**: Verificados mediante el flujo de 9 pasos en UI.
- **RF-3, RF-4, RF-5, RF-6**: Cubiertos por `tests/test_phase2_rules.py`.
- **RF-7, RF-8**: Cubiertos por la nueva funcionalidad de exportación e impresión limpia.
- **RF-9**: Cubierto por el panel de comisiones sin aula en `dashbede.html`.
- **RF-10**: Cubierto por `sheets_importer.py` y `admin.js`.
+84
View File
@@ -0,0 +1,84 @@
# Spec 001 — Cierre y Entrega Definitiva del MVP de Bedelía
Estado: Aprobada para Ejecución
---
## 1. Contexto y Objetivo
El proyecto **Admin Edu-Space** de UniCABA tiene como meta fundacional erradicar el uso del archivo Excel manual que el personal de Bedelía utiliza diariamente para coordinar la asignación de espacios, aulas, comisiones y docentes. Aunque la plataforma cuenta con una arquitectura desacoplada sólida (v3.4.9) y más de 50 pruebas superadas, el equipo percibe que *"el MVP está lejos"* debido a la ausencia de una delimitación estricta de alcance (*Scope Creep*), la falta de herramientas para exportar/imprimir la cartelera diaria requerida en portería y pasillos, y la necesidad de certificar que el circuito operativo de 9 pasos puede ejecutarse de punta a punta sin recurrir a planillas auxiliares.
Esta especificación formaliza el perímetro exacto e inamovible para la entrega del **MVP Productivo de Bedelía**, fijando criterios de aceptación verificables bajo la metodología SDD (**Spec-Driven Development**) y sintaxis **EARS**.
---
## 2. Usuarios / Actores
- **Personal de Bedelía (Actor Primario)**: Administra la asignación física y virtual de aulas, verifica comisiones sin aula, resuelve colisiones horarias y emite los partes de ocupación diarios y semanales.
- **Cuerpo Docente (Actor Secundario)**: Consulta su aula asignada (o enlace Meet), registra notas en el libro de calificaciones y reporta incidencias de aula.
- **Estudiantes (Actor de Consulta)**: Consultan su aula en la cartelera del día y acceden al enlace virtual correspondiente.
- **Administrador del Sistema (Auditor/Soporte)**: Supervisa métricas globales, gestiona usuarios y audita operaciones sensibles en `AuditLog`.
---
## 3. Historias de Usuario
- **HU-1**: Como responsable de Bedelía, quiero gestionar el ciclo académico completo (Sedes, Aulas, Ciclos, Carreras, Materias, Comisiones, Docentes, Alumnos y Reservas) en la plataforma web para no depender de planillas de cálculo.
- **HU-2**: Como responsable de Bedelía, quiero ver en el Dashboard de forma inmediata las aulas libres y las comisiones sin aula del día y la semana para reasignar espacios en menos de tres clics.
- **HU-3**: Como personal de Bedelía, quiero imprimir o exportar a CSV/PDF la cartelera de clases del día y de la semana para entregarla a seguridad/recepción y publicarla en los pasillos de la sede.
- **HU-4**: Como docente, quiero ingresar con mi cuenta institucional y ver exactamente en qué aula física o enlace de Meet me toca dictar clase hoy sin consultar planillas en Bedelía.
- **HU-5**: Como estudiante, quiero consultar la cartelera áulica en mi móvil para saber en qué aula y piso curso hoy de forma inequívoca.
---
## 4. Requisitos Funcionales (Criterios de Aceptación en Notación EARS)
### Módulo 1: Flujo Operativo de 9 Pasos
- **RF-1 (EARS Ubicuo)**: EL SISTEMA mantendrá la integridad referencial relacional entre Sede ➔ Aula ➔ Ciclo Lectivo ➔ Carrera ➔ Materia ➔ Comisión ➔ Docentes (con co-docencia) ➔ Alumnos ➔ Reserva de Espacio en todas las operaciones.
- **RF-2 (EARS Basado en Eventos)**: CUANDO Bedelía cree una comisión desde `/admin/commissions_list`, EL SISTEMA asociará obligatoriamente la Asignatura, heredará y expondrá la Carrera en la interfaz y precargará el Ciclo Lectivo vigente.
- **RF-3 (EARS No Deseado)**: SI un alumno intenta ser matriculado en dos materias regulares en el mismo día, ENTONCES EL SISTEMA bloqueará la operación a menos que la materia sea curso corto (`is_short_course`) o Bedelía marque expresamente `allow_same_day_exception` con motivo justificado.
### Módulo 2: Matriz Infranqueable de Conflictos
- **RF-4 (EARS Basado en Eventos)**: CUANDO el operador intente guardar una reserva que solape físicamente un aula presencial en la misma fecha y bloque horario, EL SISTEMA rechazará la solicitud (HTTP 409) indicando la reserva en conflicto.
- **RF-5 (EARS Basado en Eventos)**: CUANDO se intente asignar una reserva a un docente que ya tiene otra clase presencial simultánea, EL SISTEMA bloqueará la asignación, SALVO que la comisión cuente con co-docencia activa registrada en `commission_teachers`.
- **RF-6 (EARS Basado en Estados)**: MIENTRAS la reserva corresponda al entorno `Campus Virtual (VIRTUAL)`, EL SISTEMA permitirá la concurrencia de múltiples comisiones en el mismo horario con enlaces de Google Meet independientes.
### Módulo 3: Cartelera, Aulas Libres y Exportación
- **RF-7 (EARS Basado en Eventos)**: CUANDO Bedelía o recepción consulte `/schedule/today_schedule`, EL SISTEMA agrupará las reservas por franja horaria real de cursada (`08:00 - 11:00 hs`, etc.), ordenadas cronológicamente y sin duplicaciones de fila.
- **RF-8 (EARS Ubicuo)**: EL SISTEMA dispondrá de un botón de exportación rápida a formato descargable (CSV estructurado) e impresión limpia (CSS print-friendly) en la Cartelera del Día y Semanal para emisión física inmediata.
- **RF-9 (EARS Basado en Estados)**: MIENTRAS existan comisiones sin espacio asignado para la fecha seleccionada, EL SISTEMA las listará en la pestaña *"Comisiones Sin Asignar"* del Dashboard de Bedelía con acceso directo al formulario de asignación en 1 clic.
### Módulo 4: Importación y Respaldo
- **RF-10 (EARS Opcional)**: DONDE Bedelía requiera importar masivamente la oferta cuatrimestral desde Google Sheets, EL SISTEMA proveerá previsualización interactiva con filtros por Carrera, Materia y Día antes de impactar en la base de datos.
---
## 5. Requisitos No Funcionales (RNF)
- **RNF-1 (Seguridad)**: Toda sesión de usuario debe gestionarse mediante JWT en cookie `HttpOnly` y registrarse en `AuditLog`.
- **RNF-2 (Rendimiento)**: Las consultas del Dashboard y Cartelera del Día deben responder en menos de 500 ms con una concurrencia estimada de 200 usuarios concurrentes.
- **RNF-3 (Compatibilidad)**: Interfaz adaptativa (Responsive) optimizada para terminales móviles (375px) y pantallas de recepción (1920x1080).
- **RNF-4 (Idioma)**: Todo mensaje, etiqueta, alerta y reporte debe estar redactado en español institucional rioplatense.
---
## 6. Casos Límite y Reglas Especiales
1. **Reinicio de Ciclo Lectivo**: Si la base se reinicia o está vacía, ninguna vista debe arrojar error 500; deben mostrarse componentes de estado vacío (*empty states*) con llamada a la acción clara.
2. **Asignaturas Compartidas**: Si una materia pertenece a múltiples carreras (Many-to-Many en `subject_careers`), la cartelera y el detalle de comisión deben exhibir todas las titulaciones asociadas.
3. **Pisos Alfanuméricos**: Aulas ubicadas en pisos no numéricos (PB, EP, Subsuelo, Piso 1) deben agruparse correctamente en los selectores en cascada.
---
## 7. FUERA DE ALCANCE (Out of Scope para el MVP)
Para garantizar la entrega inmediata y evitar demoras innecesarias, los siguientes aspectos quedan formalmente **excluidos** de esta entrega y se derivan a la Fase 6 / Roadmap v4.0:
- ❌ Sincronización continua de dos vías en segundo plano con Moodle WebServices mediante Daemons systemd persistentes (la importación inicial y SSO cubren la necesidad del MVP).
- ❌ Aplicación móvil nativa compilada para Android/iOS (el diseño web responsive cubre el 100% del acceso móvil).
- ❌ Módulo de pagos o aranceles de matrícula.
- ❌ Gestión de inventario de activos físicos dentro de las aulas (PCs, proyectores, cables HDMI).
---
## 8. Criterios de Finalización (Definition of Done)
El MVP se considerará **100% ENTREGADO** cuando:
1. [ ] El flujo completo de 9 pasos de Bedelía pueda ser ejecutado por un operador sin errores en consola ni en logs.
2. [ ] La cartelera del día cuente con el botón de **Impresión / Exportación** funcionando.
3. [ ] Todas las 52 pruebas automatizadas de backend (`pytest tests -v`) pasen en verde.
4. [ ] La suite de auditoría de seguridad (`security_audit.bat`) no registre vulnerabilidades críticas.
5. [ ] La versión esté desplegada y verificada en el servidor de producción institucional (`https://eduspace.oemspot.com.ar`).
6. [ ] La memoria del proyecto (`MEMORY.md`) y el `CHANGELOG.md` queden actualizados reflejando el cierre del MVP.
+37
View File
@@ -0,0 +1,37 @@
# Tareas de Implementación 001 — Cierre del MVP de Bedelía
Basado en: `specs/001-cierre-mvp-bedelia/spec.md` y `plan.md`.
---
## Lista de Tareas Atómicas
- [x] **T1 — Endpoint de Exportación CSV en Frontend BFF (`/schedule/export_csv`)**
- **Archivos:** `frontend/src/routes/schedule.js`
- **RF Cubiertos:** RF-8
- **Descripción:** Implementar el endpoint que toma el parámetro `date` (o fecha actual), consulta el cronograma real de la API backend, y retorna un archivo CSV estructurado con cabeceras en español (`Fecha`, `Horario`, `Turno`, `Aula`, `Piso`, `Materia`, `Código`, `Comisión`, `Carrera`, `Docentes`, `Modalidad/Meet`) y prefijo UTF-8 BOM (`\uFEFF`) para compatibilidad directa con Microsoft Excel.
- **Hecho cuando:** Una petición GET a `/schedule/export_csv?date=2026-10-16` responda con HTTP 200, cabecera `Content-Disposition: attachment` y el contenido CSV formateado con las reservas del día.
- [x] **T2 — Botones de Impresión y Descarga en Cartelera del Día (`today_schedule.html`)**
- **Archivos:** `frontend/views/schedule/today_schedule.html`
- **RF Cubiertos:** RF-7, RF-8
- **Descripción:** Añadir en la barra superior de acciones de la cartelera los botones `Imprimir Cartelera` (icono `bi-printer`, ejecuta `window.print()`) y `Descargar Planilla CSV` (icono `bi-file-earmark-excel`). Agregar estilos `@media print` para ocultar la barra lateral, botones y pie de página, mostrando un membrete institucional limpio para recepción.
- **Hecho cuando:** Al presionar `Imprimir`, la vista previa de impresión muestre únicamente la grilla de asignaciones sin elementos de navegación, y al presionar `Descargar Planilla`, se descargue el archivo `.csv`.
- [x] **T3 — Botón de Exportación en Dashboard de Bedelía (`dashbede.html`)**
- **Archivos:** `frontend/views/dashboard/dashbede.html`
- **RF Cubiertos:** RF-8, RF-9
- **Descripción:** Agregar un botón destacado de exportación en la sección de Cartelera & Agenda de Bedelía para descargar o imprimir el parte del día en 1 clic.
- **Hecho cuando:** El botón sea visible en el Dashboard de Bedelía y redirija a la descarga o apertura de la cartelera imprimible.
- [x] **T4 — Verificación de Calidad y Pruebas Automatizadas**
- **Archivos:** `backend/tests/`
- **RF Cubiertos:** Todos (RF-1 al RF-10)
- **Descripción:** Ejecutar la suite completa de pruebas del backend (`python -m pytest tests -v`) verificando 0 fallos.
- **Hecho cuando:** La suite ejecute 52 tests y reporte 100% passed.
- [x] **T5 — Cierre de Versión, Actualización de Memoria y Principio 9 de la Constitución**
- **Archivos:** `package.json`, `app.js`, `backend/__init__.py`, `MEMORY.md`, `CHANGELOG.md`
- **RF Cubiertos:** RNF-1, RNF-4, Principio 9
- **Descripción:** Incrementar la versión semántica a `v3.5.0` (Cierre Formal MVP Bedelía), registrar las decisiones en `MEMORY.md` y detallar los cambios en `CHANGELOG.md`.
- **Hecho cuando:** La versión `v3.5.0` esté registrada en todos los descriptores y el reporte final esté listo para despliegue.