From 39c80f573b8a6789619725b6ccf5a3a72153075b Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Fri, 16 Oct 2026 13:18:02 -0300 Subject: [PATCH] feat: release v3.5.0 - formal MVP Bedelia closure, SDD harness, cartelera export, docs cleanup & model fixes --- .agents/skills/deploy/SKILL.md | 75 +++++++++++++++++ .agents/skills/sdd/SKILL.md | 66 +++++++++++++++ .gitignore | 2 +- .opencode/agents/coordinator.md | 15 ++++ .opencode/agents/implementer.md | 13 +++ .opencode/agents/planner.md | 14 ++++ .opencode/agents/reviewer.md | 16 ++++ .opencode/commands/deploy.md | 23 +++++ .opencode/commands/sdd-plan.md | 12 +++ .opencode/commands/sdd-spec.md | 12 +++ .opencode/commands/sdd-tasks.md | 8 ++ AGENTS.md | 18 +++- CHANGELOG.md | 17 ++++ MEMORY.md | 23 ++++- README.md | 22 ++--- ROADMAP.md | 8 +- backend/app/__init__.py | 2 +- backend/app/models/academic_term.py | 3 + backend/app/models/audit_log.py | 12 +++ backend/app/models/building.py | 3 + backend/app/models/career.py | 3 + backend/app/models/classroom.py | 3 + backend/app/models/enrollment.py | 3 + backend/app/models/grade.py | 3 + backend/app/models/milestone.py | 6 ++ backend/app/models/reservation.py | 3 + backend/app/models/role.py | 3 + backend/app/models/setting.py | 3 + backend/app/models/subject.py | 6 ++ backend/app/models/user.py | 3 + backend/app/routes/admin.py | 2 +- backend/app/routes/api/openapi.py | 2 +- backend/setup.py | 2 +- docs/README.md | 22 +++++ docs/{ => archive}/CHANGELOG_MVP.md | 0 docs/{ => archive}/CHANGELOG_SESSION.md | 0 ...HANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md | 0 docs/{ => archive}/ERROR_FIX_SUMMARY.md | 0 docs/{ => archive}/IMPLEMENTATION_SUMMARY.md | 0 .../{ => archive}/RELATIONSHIP_FIX_SUMMARY.md | 0 docs/{ => archive}/ROADMAP_MVP.md | 0 docs/{ => archive}/ROUTE_FIX_SUMMARY.md | 0 .../SCHEDULE_ROUTE_FIX_SUMMARY.md | 0 docs/constitution.md | 7 +- frontend/package.json | 2 +- frontend/src/app.js | 6 +- frontend/src/routes/schedule.js | 81 ++++++++++++++++++ frontend/views/admin/audit_logs.html | 25 +++++- frontend/views/dashboard/dashbede.html | 10 +++ frontend/views/schedule/today.html | 62 ++++++++++++++ specs/001-cierre-mvp-bedelia/plan.md | 57 +++++++++++++ specs/001-cierre-mvp-bedelia/spec.md | 84 +++++++++++++++++++ specs/001-cierre-mvp-bedelia/tasks.md | 37 ++++++++ 53 files changed, 767 insertions(+), 32 deletions(-) create mode 100644 .agents/skills/deploy/SKILL.md create mode 100644 .agents/skills/sdd/SKILL.md create mode 100644 .opencode/agents/coordinator.md create mode 100644 .opencode/agents/implementer.md create mode 100644 .opencode/agents/planner.md create mode 100644 .opencode/agents/reviewer.md create mode 100644 .opencode/commands/deploy.md create mode 100644 .opencode/commands/sdd-plan.md create mode 100644 .opencode/commands/sdd-spec.md create mode 100644 .opencode/commands/sdd-tasks.md create mode 100644 docs/README.md rename docs/{ => archive}/CHANGELOG_MVP.md (100%) rename docs/{ => archive}/CHANGELOG_SESSION.md (100%) rename docs/{ => archive}/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md (100%) rename docs/{ => archive}/ERROR_FIX_SUMMARY.md (100%) rename docs/{ => archive}/IMPLEMENTATION_SUMMARY.md (100%) rename docs/{ => archive}/RELATIONSHIP_FIX_SUMMARY.md (100%) rename docs/{ => archive}/ROADMAP_MVP.md (100%) rename docs/{ => archive}/ROUTE_FIX_SUMMARY.md (100%) rename docs/{ => archive}/SCHEDULE_ROUTE_FIX_SUMMARY.md (100%) create mode 100644 specs/001-cierre-mvp-bedelia/plan.md create mode 100644 specs/001-cierre-mvp-bedelia/spec.md create mode 100644 specs/001-cierre-mvp-bedelia/tasks.md diff --git a/.agents/skills/deploy/SKILL.md b/.agents/skills/deploy/SKILL.md new file mode 100644 index 0000000..2b49035 --- /dev/null +++ b/.agents/skills/deploy/SKILL.md @@ -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` diff --git a/.agents/skills/sdd/SKILL.md b/.agents/skills/sdd/SKILL.md new file mode 100644 index 0000000..68c3d44 --- /dev/null +++ b/.agents/skills/sdd/SKILL.md @@ -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 .` + > *Ejemplo:* EL SISTEMA registrará en `AuditLog` toda modificación de asignación de aula. + +2. **Basado en Eventos (Disparado por una acción)**: + > `CUANDO , EL SISTEMA .` + > *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 , EL SISTEMA .` + > *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 , ENTONCES EL SISTEMA .` + > *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 , EL SISTEMA .` + > *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`. diff --git a/.gitignore b/.gitignore index a985e33..869c7e4 100644 --- a/.gitignore +++ b/.gitignore @@ -224,7 +224,7 @@ legacy_admin-edu-space/ .schemathesis/ AlumnosLS -prerrequisitos +apuntes .credentials .credenciales \ No newline at end of file diff --git a/.opencode/agents/coordinator.md b/.opencode/agents/coordinator.md new file mode 100644 index 0000000..0ad3d6b --- /dev/null +++ b/.opencode/agents/coordinator.md @@ -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. diff --git a/.opencode/agents/implementer.md b/.opencode/agents/implementer.md new file mode 100644 index 0000000..de87af1 --- /dev/null +++ b/.opencode/agents/implementer.md @@ -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. diff --git a/.opencode/agents/planner.md b/.opencode/agents/planner.md new file mode 100644 index 0000000..4597358 --- /dev/null +++ b/.opencode/agents/planner.md @@ -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:"*. diff --git a/.opencode/agents/reviewer.md b/.opencode/agents/reviewer.md new file mode 100644 index 0000000..b246a87 --- /dev/null +++ b/.opencode/agents/reviewer.md @@ -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). diff --git a/.opencode/commands/deploy.md b/.opencode/commands/deploy.md new file mode 100644 index 0000000..0b5f4e7 --- /dev/null +++ b/.opencode/commands/deploy.md @@ -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. diff --git a/.opencode/commands/sdd-plan.md b/.opencode/commands/sdd-plan.md new file mode 100644 index 0000000..c7621bf --- /dev/null +++ b/.opencode/commands/sdd-plan.md @@ -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. diff --git a/.opencode/commands/sdd-spec.md b/.opencode/commands/sdd-spec.md new file mode 100644 index 0000000..f529f98 --- /dev/null +++ b/.opencode/commands/sdd-spec.md @@ -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). diff --git a/.opencode/commands/sdd-tasks.md b/.opencode/commands/sdd-tasks.md new file mode 100644 index 0000000..52bf927 --- /dev/null +++ b/.opencode/commands/sdd-tasks.md @@ -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 `[ ]`. diff --git a/AGENTS.md b/AGENTS.md index 2b50a3f..8992fbb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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`). - **Autenticación**: Los flujos de acceso pasan por tokens JWT transportados en cookies seguras `HttpOnly`. +## Metodología SDD (Spec-Driven Development) y Arnés de Agentes +- **La especificación manda**: Ninguna feature se codifica sin su carpeta `specs/NNN-nombre/` conteniendo `spec.md` (requisitos en sintaxis **EARS** en español: Ubicuo, Eventos, Estado, No Deseado, Opcional), `plan.md` y `tasks.md` (skill `.agents/skills/sdd/SKILL.md`). +- **Flujo de Roles**: + - `Coordinator`: Conduce la interacción con el usuario y orquesta a los subagentes sin tocar código. + - `Planner`: Redacta specs, planes y tareas atómicas (20-30 min) con criterios verificables "Hecho cuando:". + - `Implementer`: Ejecuta tareas una a una con enfoque Test-First (`backend/tests/`). + - `Reviewer`: Clarifica specs como QA y valida la implementación emitiendo veredicto formal (`VEREDICTO: APROBADO / CAMBIOS NECESARIOS`). + +## Despliegue en Producción y Git Push (Innegociable por Principio 9) +- Al completar cualquier tarea o hito verificado: + 1. Incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py`). + 2. Registrar cambios en `CHANGELOG.md` y `MEMORY.md`. + 3. Ejecutar `git add .`, commit y **`git push origin dev`** al repositorio remoto. + 4. Desplegar inmediatamente en producción al servidor institucional LXC (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos del archivo `.credenciales`, reiniciando los servicios `admin-edu-space-backend` y `admin-edu-space-frontend`, y verificando HTTP 200 en `/version`. + ## Límites -- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa 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é. - **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. diff --git a/CHANGELOG.md b/CHANGELOG.md index 5c1fedc..0362778 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,23 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1 - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. +## [3.5.0] - 2026-10-16 +### Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA) +- **Arnés de Ingeniería de Software con IA (Harness Engineering):** + - Incorporación de la skill formal de SDD (`.agents/skills/sdd/SKILL.md`) con las directivas de especificación, planificación y tareas. + - Implementación de comandos personalizados en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`). + - Configuración de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA). + - Actualización de `AGENTS.md` con las reglas mandatorias del flujo SDD y sintaxis EARS. +- **Especificación Formal de Cierre de MVP (`specs/001-cierre-mvp-bedelia/`):** + - Delimitación inamovible de los 10 Requisitos Funcionales en notación EARS y delimitación explícita de *Fuera de Alcance* para evitar el *Scope Creep*. +- **Herramientas de Exportación e Impresión para Bedelía y Portería:** + - Nuevo endpoint en Frontend BFF (`/schedule/export_csv`) que genera un archivo CSV con formato Excel nativo (UTF-8 con BOM `\uFEFF` y separador `;`) conteniendo la cartelera de clases del día/semana seleccionada. + - Botón "Excel / CSV" y botón "Imprimir" en `/schedule/today` (`today.html`). + - Hojas de estilo CSS `@media print` para impresión oficial limpia en hoja A4 con membrete institucional de UniCABA (oculta barras de navegación, botones y filtros). + - Accesos directos de exportación e impresión en el Dashboard Operativo de Bedelía (`dashbede.html`). +- **Verificación de Calidad:** + - 52 pruebas automatizadas en verde (`52 passed`) en pytest. + ## [3.4.9] - 2026-10-09 ### Corregido & Mejorado (Importador de Google Sheets & Sistema de Diagnóstico de Incidentes) - **Corrección de Límite de Payload en Importación Masiva de Google Sheets (`PayloadTooLargeError`):** diff --git a/MEMORY.md b/MEMORY.md index 795ea5d..871640b 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -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. 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. - - **Bump Semántico y Despliegue Obligatorio (Principio 9)**: - - Versión incrementada a `v3.4.9` en Frontend y Backend. +- **Sprint v3.5.0: Cierre Formal del MVP de Bedelía & Adopción del Arnés SDD / IA**: + - **Metodología y Arnés de Ingeniería con IA (Apuntes Día 1, 2 y 3)**: + 1. Creación de la Skill de SDD (`.agents/skills/sdd/SKILL.md`) con las plantillas de `spec.md`, `plan.md`, `tasks.md` y sintaxis formal **EARS** en español. + 2. Creación de comandos reutilizables de agentes en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`). + 3. Definición de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA). + 4. Integración del arnés en `AGENTS.md`. + - **Diagnóstico y Cierre de Brecha del MVP**: + - Se identificó la causa raíz de la percepción de "estar lejos": el *Scope Creep* sin especificación formal de cierre y la falta de exportación/impresión de carteleras que forzaba a Bedelía a recurrir al Excel para imprimir o compartir partes con portería y docentes. + - Se formalizó la primera especificación oficial del proyecto en `specs/001-cierre-mvp-bedelia/` (`spec.md`, `plan.md`, `tasks.md`), delimitando de forma estricta los Requisitos Funcionales en **EARS** y estableciendo un perímetro cerrado de **Fuera de Alcance**. + - **Implementación Técnica**: + 1. `frontend/src/routes/schedule.js`: Endpoint `/schedule/export_csv` con codificación UTF-8 BOM (`\uFEFF`) y delimitadores `;` para apertura nativa e inmediata en Microsoft Excel en español. + 2. `frontend/views/schedule/today.html`: Botones directos `[ Excel / CSV ]` e `[ Imprimir ]`, acompañados de estilos CSS `@media print` que formatean la grilla de asignaciones en hoja A4 limpia con membrete institucional oficial de UniCABA. + 3. `frontend/views/dashboard/dashbede.html`: Accesos rápidos en el Launchpad operativo de Bedelía para descargar la planilla del día e imprimir en 1 clic. + - **Calidad y Bump Semántico (Principio 9)**: + - 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`). + - Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`. ## Próximos pasos -1. Continuar con los objetivos de la Fase 6 del Roadmap institucional (Docker-compose productivo, Nginx con SSL y automatización de workers continuos Moodle). -2. Monitoreo continuo de la experiencia de usuario en Bedelía, Cartelera del Día y Sincronización Académica. \ No newline at end of file +1. Desplegar la versión `v3.5.0` al servidor institucional de producción (`10.0.0.217` / `eduspace.oemspot.com.ar`) conforme al Principio 9. +2. Realizar la prueba de aceptación en vivo con el personal de Bedelía imprimiendo y exportando la cartelera real. +3. Iniciar la Fase 6 de hardening y orquestación de contenedores en Docker-compose. \ No newline at end of file diff --git a/README.md b/README.md index bb5bc75..529cc93 100644 --- a/README.md +++ b/README.md @@ -4,22 +4,24 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo. -**Versión Actual:** `3.1.0` (Fases 0 a 5 completadas, Fase 5.1 Bedelía UX & ABMs finalizada) -**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) +**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) +**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`) --- ## 🗺️ Estado del Roadmap MVP ``` -Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado) -Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado) -Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado) -Fase 3: Hitos Evaluativos y Calificaciones[████████████████████] 100% (Completado) -Fase 4: UI/UX Drag & Drop e Impersonación[████████████████████] 100% (Completado) -Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado) -Fase 5.1: Bedelía UX, ABMs y Purga Datos [████████████████████] 100% (Completado) -Fase 6: Despliegue Producción e Infraest.[███████░░░░░░░░░░░░░] 35% (En Curso) +Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado) +Fase 1: Paridad Legacy y Estabilización [████████████████████] 100% (Completado) +Fase 2: Co-docencia y Matriz Conflictos [████████████████████] 100% (Completado) +Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado) +Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado) +Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado) +Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado) +Sprint MVP: Flujo 9 Pasos & Cierre de Bedelía [████████████████████] 100% (Entregado v3.5.0) +Fase 6: Despliegue Producción e Infraest. [███████░░░░░░░░░░░░░] 45% (En Curso) ``` --- diff --git a/ROADMAP.md b/ROADMAP.md index b088dc1..2cad560 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,8 +2,8 @@ ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) -**Versión:** 3.4.9 (Importador de Google Sheets Robusto & Diagnóstico Transparente de Incidentes) -**Fecha de Actualización:** 09 de Octubre de 2026 +**Versión:** 3.5.0 (Cierre Formal MVP Bedelía, SDD & Exportador de Cartelera) +**Fecha de Actualización:** 16 de Octubre de 2026 **Rama Base:** `dev` --- @@ -23,8 +23,8 @@ Fase 3: Hitos Evaluativos y Calificaciones [██████████ Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado) Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado) Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado) -Sprint Activo: Flujo Bedelía & Reemplazo Excel [████████████████░░░░] 80% (En Curso) -Fase 6: Despliegue en Servidores y Hardening [███████░░░░░░░░░░░░░] 35% (Planificado) +Sprint MVP: Flujo Bedelía & Reemplazo Excel [████████████████████] 100% (Entregado v3.5.0) +Fase 6: Despliegue en Servidores y Hardening [█████████░░░░░░░░░░░] 45% (En Curso) ``` --- diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 8b46725..5bd52ad 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _ from config.config import Config # Initialize extensions -__version__ = "3.4.9" +__version__ = "3.5.0" db = SQLAlchemy() migrate = Migrate() cors = CORS() diff --git a/backend/app/models/academic_term.py b/backend/app/models/academic_term.py index 22aa0bf..83945ef 100644 --- a/backend/app/models/academic_term.py +++ b/backend/app/models/academic_term.py @@ -15,6 +15,9 @@ class AcademicTerm(db.Model): is_current = db.Column(db.Boolean, default=False, nullable=False, index=True) is_active = db.Column(db.Boolean, default=True, nullable=False) created_at = db.Column(db.DateTime, default=datetime.utcnow) + + def __init__(self, **kwargs): + super().__init__(**kwargs) def to_dict(self): return { diff --git a/backend/app/models/audit_log.py b/backend/app/models/audit_log.py index fe22b10..37f1a6f 100644 --- a/backend/app/models/audit_log.py +++ b/backend/app/models/audit_log.py @@ -21,6 +21,18 @@ class AuditLog(db.Model): # Relación con usuario 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): return f"" diff --git a/backend/app/models/building.py b/backend/app/models/building.py index f475539..74698a0 100644 --- a/backend/app/models/building.py +++ b/backend/app/models/building.py @@ -16,6 +16,9 @@ class Building(db.Model): # Relationships classrooms = db.relationship('Classroom', backref='building_entity', lazy=True, foreign_keys='Classroom.building_id') + + def __init__(self, **kwargs): + super().__init__(**kwargs) @property def is_virtual(self): diff --git a/backend/app/models/career.py b/backend/app/models/career.py index 352de59..f0787a9 100644 --- a/backend/app/models/career.py +++ b/backend/app/models/career.py @@ -12,6 +12,9 @@ class Career(db.Model): # Relationships subjects = db.relationship('Subject', backref='career_obj', lazy=True) + + def __init__(self, **kwargs): + super().__init__(**kwargs) def to_dict(self): return { diff --git a/backend/app/models/classroom.py b/backend/app/models/classroom.py index 4614857..6de646e 100644 --- a/backend/app/models/classroom.py +++ b/backend/app/models/classroom.py @@ -16,6 +16,9 @@ class Classroom(db.Model): created_at = db.Column(db.DateTime, default=datetime.utcnow) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) + def __init__(self, **kwargs): + super().__init__(**kwargs) + # Relación con Building (mapeada vía backref 'building_entity' en Building.classrooms) @property def building_rel(self): diff --git a/backend/app/models/enrollment.py b/backend/app/models/enrollment.py index fb32548..58aa15a 100644 --- a/backend/app/models/enrollment.py +++ b/backend/app/models/enrollment.py @@ -35,6 +35,9 @@ class StudentEnrollment(db.Model): 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')) + def __init__(self, **kwargs): + super().__init__(**kwargs) + def to_dict(self): return { 'id': self.id, diff --git a/backend/app/models/grade.py b/backend/app/models/grade.py index 1480c7f..085e4ec 100644 --- a/backend/app/models/grade.py +++ b/backend/app/models/grade.py @@ -50,6 +50,9 @@ class MilestoneGrade(db.Model): 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]) + def __init__(self, **kwargs): + super().__init__(**kwargs) + @property def is_passed(self) -> bool: """Determina si la nota está aprobada (>= 4.00 y no ausente).""" diff --git a/backend/app/models/milestone.py b/backend/app/models/milestone.py index 6ceff53..0f41734 100644 --- a/backend/app/models/milestone.py +++ b/backend/app/models/milestone.py @@ -21,6 +21,9 @@ class MilestoneType(db.Model): # Relación uno-a-muchos con AcademicMilestone milestones = db.relationship('AcademicMilestone', backref='type_obj', lazy='dynamic', cascade='all, delete-orphan') + def __init__(self, **kwargs): + super().__init__(**kwargs) + def to_dict(self): return { 'id': self.id, @@ -61,6 +64,9 @@ class AcademicMilestone(db.Model): 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')) + def __init__(self, **kwargs): + super().__init__(**kwargs) + @property def tipo(self): return self.type_obj.name if self.type_obj else 'Otro' diff --git a/backend/app/models/reservation.py b/backend/app/models/reservation.py index 6137c70..f6f8029 100644 --- a/backend/app/models/reservation.py +++ b/backend/app/models/reservation.py @@ -52,6 +52,9 @@ class Reservation(db.Model): created_at = db.Column(db.DateTime, default=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 @property diff --git a/backend/app/models/role.py b/backend/app/models/role.py index 050cf03..ea82a67 100644 --- a/backend/app/models/role.py +++ b/backend/app/models/role.py @@ -96,6 +96,9 @@ class Role(db.Model): # Relationships permissions = db.relationship('Permission', backref='role', lazy='joined', cascade='all, delete-orphan') users = db.relationship('User', backref='role_obj', lazy='select') + + def __init__(self, **kwargs): + super().__init__(**kwargs) def get_permission(self, module): """Get access level string for a given module ('none', 'read', 'read_write')""" diff --git a/backend/app/models/setting.py b/backend/app/models/setting.py index 9cc823d..785703e 100644 --- a/backend/app/models/setting.py +++ b/backend/app/models/setting.py @@ -18,6 +18,9 @@ class SystemSetting(db.Model): is_encrypted = db.Column(db.Boolean, default=False, nullable=True) updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) + def __init__(self, **kwargs): + super().__init__(**kwargs) + @classmethod def get_value(cls, key, default=None): """Retorna el valor tal como está almacenado en BD.""" diff --git a/backend/app/models/subject.py b/backend/app/models/subject.py index 06257fa..b91598f 100644 --- a/backend/app/models/subject.py +++ b/backend/app/models/subject.py @@ -26,6 +26,9 @@ class Subject(db.Model): # Relationships commissions = db.relationship('Commission', backref='subject', lazy=True, cascade='all, delete-orphan') careers = db.relationship('Career', secondary=subject_careers, lazy='subquery', backref=db.backref('shared_subjects', lazy=True)) + + def __init__(self, **kwargs): + super().__init__(**kwargs) def to_dict(self): """Convert subject to dictionary""" @@ -87,6 +90,9 @@ class Commission(db.Model): created_at = db.Column(db.DateTime, default=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 @property diff --git a/backend/app/models/user.py b/backend/app/models/user.py index cd82f37..6c55b98 100644 --- a/backend/app/models/user.py +++ b/backend/app/models/user.py @@ -25,6 +25,9 @@ class User(db.Model): address = db.Column(db.String(255), nullable=True) document_type = db.Column(db.String(20), default='DNI', nullable=True) document_number = db.Column(db.String(30), nullable=True, index=True) + + def __init__(self, **kwargs): + super().__init__(**kwargs) def get_first_name(self): if self.first_name: diff --git a/backend/app/routes/admin.py b/backend/app/routes/admin.py index fe97f3c..9c6b5d3 100644 --- a/backend/app/routes/admin.py +++ b/backend/app/routes/admin.py @@ -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.audit_log import AuditLog from app.utils.decorators import admin_required, permission_required -from sqlalchemy import or_ +from sqlalchemy import or_, func import re admin_bp = Blueprint('admin', __name__, url_prefix='/admin') diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 9bbab70..650389b 100644 --- a/backend/app/routes/api/openapi.py +++ b/backend/app/routes/api/openapi.py @@ -7,7 +7,7 @@ OPENAPI_SPEC = { "info": { "title": "Edu-Space REST API", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", - "version": "3.4.9" + "version": "3.5.0" }, "servers": [ { diff --git a/backend/setup.py b/backend/setup.py index 1684ddb..41c0684 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name="edu-space-admin", - version="3.4.9", + version="3.5.0", description="Administrative interface for Edu-Space Classroom Management System", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..54bac58 --- /dev/null +++ b/docs/README.md @@ -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. diff --git a/docs/CHANGELOG_MVP.md b/docs/archive/CHANGELOG_MVP.md similarity index 100% rename from docs/CHANGELOG_MVP.md rename to docs/archive/CHANGELOG_MVP.md diff --git a/docs/CHANGELOG_SESSION.md b/docs/archive/CHANGELOG_SESSION.md similarity index 100% rename from docs/CHANGELOG_SESSION.md rename to docs/archive/CHANGELOG_SESSION.md diff --git a/docs/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md b/docs/archive/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md similarity index 100% rename from docs/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md rename to docs/archive/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md diff --git a/docs/ERROR_FIX_SUMMARY.md b/docs/archive/ERROR_FIX_SUMMARY.md similarity index 100% rename from docs/ERROR_FIX_SUMMARY.md rename to docs/archive/ERROR_FIX_SUMMARY.md diff --git a/docs/IMPLEMENTATION_SUMMARY.md b/docs/archive/IMPLEMENTATION_SUMMARY.md similarity index 100% rename from docs/IMPLEMENTATION_SUMMARY.md rename to docs/archive/IMPLEMENTATION_SUMMARY.md diff --git a/docs/RELATIONSHIP_FIX_SUMMARY.md b/docs/archive/RELATIONSHIP_FIX_SUMMARY.md similarity index 100% rename from docs/RELATIONSHIP_FIX_SUMMARY.md rename to docs/archive/RELATIONSHIP_FIX_SUMMARY.md diff --git a/docs/ROADMAP_MVP.md b/docs/archive/ROADMAP_MVP.md similarity index 100% rename from docs/ROADMAP_MVP.md rename to docs/archive/ROADMAP_MVP.md diff --git a/docs/ROUTE_FIX_SUMMARY.md b/docs/archive/ROUTE_FIX_SUMMARY.md similarity index 100% rename from docs/ROUTE_FIX_SUMMARY.md rename to docs/archive/ROUTE_FIX_SUMMARY.md diff --git a/docs/SCHEDULE_ROUTE_FIX_SUMMARY.md b/docs/archive/SCHEDULE_ROUTE_FIX_SUMMARY.md similarity index 100% rename from docs/SCHEDULE_ROUTE_FIX_SUMMARY.md rename to docs/archive/SCHEDULE_ROUTE_FIX_SUMMARY.md diff --git a/docs/constitution.md b/docs/constitution.md index 82537bf..f1448eb 100644 --- a/docs/constitution.md +++ b/docs/constitution.md @@ -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. - 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 -- **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`). -- **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. \ No newline at end of file +### 9. Control de Versiones, Git Push y Despliegue Obligatorio a Servidor +- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py` y `CHANGELOG.md`). +- **Git Push Obligatorio**: Ejecutar siempre `git push origin dev` al repositorio remoto una vez que los tests automatizados (`pytest tests -v`) estén 100% aprobados. +- **Subida y Despliegue Inmediato al Servidor de Producción**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos y claves definidos en el archivo `.credenciales`, reiniciando los servicios del sistema (`systemctl restart admin-edu-space-backend admin-edu-space-frontend`) y verificando el estado operativo en vivo (HTTP 200 en `/version`) antes de dar cualquier tarea por concluida. \ No newline at end of file diff --git a/frontend/package.json b/frontend/package.json index d25979e..70770f7 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.4.9", + "version": "3.5.0", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 995ac01..6783392 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.4.9'; -const FRONTEND_VERSION = '3.4.9'; -const BACKEND_VERSION = '3.4.9'; +const APP_VERSION = '3.5.0'; +const FRONTEND_VERSION = '3.5.0'; +const BACKEND_VERSION = '3.5.0'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/src/routes/schedule.js b/frontend/src/routes/schedule.js index 077d009..8cfc260 100644 --- a/frontend/src/routes/schedule.js +++ b/frontend/src/routes/schedule.js @@ -432,6 +432,87 @@ const handleTodaySchedule = async (req, res) => { router.get('/today', 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'); // 5. Vista de Crear Reserva diff --git a/frontend/views/admin/audit_logs.html b/frontend/views/admin/audit_logs.html index 3280bf2..e29671f 100644 --- a/frontend/views/admin/audit_logs.html +++ b/frontend/views/admin/audit_logs.html @@ -266,7 +266,14 @@ {{ log.details or '-' }} {% if log.details and log.details.length > 50 %} - {% endif %} @@ -402,5 +409,21 @@ function copyModalDetails() { 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 + ); + }); + }); +}); {% endblock %} diff --git a/frontend/views/dashboard/dashbede.html b/frontend/views/dashboard/dashbede.html index 075be38..8080136 100644 --- a/frontend/views/dashboard/dashbede.html +++ b/frontend/views/dashboard/dashbede.html @@ -1347,6 +1347,16 @@ + diff --git a/frontend/views/schedule/today.html b/frontend/views/schedule/today.html index a74d3fe..631fac4 100644 --- a/frontend/views/schedule/today.html +++ b/frontend/views/schedule/today.html @@ -4,6 +4,13 @@ {% block content %}
+ + +
@@ -14,6 +21,12 @@

Cronograma de clases y asignación de aulas activas para el día de hoy

+ + Excel / CSV + + {% if user.has_permission('reservations', 'read_write') %} Nueva Reserva @@ -426,4 +439,53 @@ document.addEventListener('DOMContentLoaded', function() { } }); + + {% endblock %} \ No newline at end of file diff --git a/specs/001-cierre-mvp-bedelia/plan.md b/specs/001-cierre-mvp-bedelia/plan.md new file mode 100644 index 0000000..46885cf --- /dev/null +++ b/specs/001-cierre-mvp-bedelia/plan.md @@ -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`. diff --git a/specs/001-cierre-mvp-bedelia/spec.md b/specs/001-cierre-mvp-bedelia/spec.md new file mode 100644 index 0000000..29c6e3a --- /dev/null +++ b/specs/001-cierre-mvp-bedelia/spec.md @@ -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. diff --git a/specs/001-cierre-mvp-bedelia/tasks.md b/specs/001-cierre-mvp-bedelia/tasks.md new file mode 100644 index 0000000..ed2f3f5 --- /dev/null +++ b/specs/001-cierre-mvp-bedelia/tasks.md @@ -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.