# ROADMAP OFICIAL — Sistema Integral UniCABA (Admin Edu-Space) ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) **Versión:** 3.4.9 (Importador de Google Sheets Robusto & Diagnóstico Transparente de Incidentes) **Fecha de Actualización:** 09 de Octubre de 2026 **Rama Base:** `dev` --- ## 🗺️ Visión del Proyecto y Objetivo del Sprint Consolidar la plataforma **Admin Edu-Space** como el sistema integral de gestión áulica y académica para **UniCABA**, **reemplazando definitivamente el archivo Excel que el personal de Bedelía utiliza para su gestión diaria**. A partir de este hito, la plataforma se convierte en la fuente única de verdad para la asignación de espacios, horarios y docentes, relegando las planillas externas a un simple mecanismo de importación masiva de datos iniciales. --- ## 📊 Estado Global de Progreso ``` Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado) Fase 1: Paridad Legacy, Virtualidad y Dashboards[████████████████████] 100% (Completado) Fase 2: Co-docencia y Matriz de Conflictos [████████████████████] 100% (Completado) Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado) Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado) Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado) Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado) Sprint Activo: Flujo Bedelía & Reemplazo Excel [████████████████░░░░] 80% (En Curso) Fase 6: Despliegue en Servidores y Hardening [███████░░░░░░░░░░░░░] 35% (Planificado) ``` --- ## 🚀 Detalle de Fases y Entregables ### Fase 0: Desacople y Arquitectura Base ✅ *(Completada)* - [x] Backend Flask como API REST pura bajo `/api/v1/` retornando exclusivamente JSON. - [x] Frontend BFF en Node.js + Express con renderizado de plantillas Nunjucks. - [x] Autenticación desacoplada con tokens JWT en Cookie `HttpOnly` segura. - [x] Pipeline de seguridad `SecurityFilterChain` con blindaje OWASP y rate limiting. - [x] Cliente Axios centralizado con interceptor Bearer token automático. ### Fase 1: Paridad Legacy, Virtualidad y Dashboards Especializados ✅ *(Completada)* - [x] Importador de Google Sheets corregido: eliminación de colisiones en aulas virtuales múltiples (`Campus Virtual · VIRTUAL`). - [x] Dashboards específicos e interactivos para **Bedelía**, **Docente**, **Alumno** y **Administrador**. - [x] Cartelera del Día (`today_schedule`) con bloques horarios (07:00 a 22:00 hs) y filtros dinámicos. - [x] Generación y persistencia de enlaces de Google Meet institucional por comisión y reserva. ### Fase 2: Co-docencia, Matriz de Conflictos y Regla Diaria ✅ *(Completada)* - [x] Tabla relacional `commission_teachers` para soportar múltiples docentes por comisión (titulares, adjuntos, ayudantes). - [x] Matriz de conflictos con validación física estricta, chequeo de aforo de seguridad y superposición docente. - [x] Excepción de superposición justificada por co-docencia activa. - [x] Regla restrictiva de cursada diaria para estudiantes con bypass por curso corto (`is_short_course`) o excepción expresa de Bedelía. ### Fase 3: Hitos Evaluativos y Libro de Calificaciones (*Gradebook*) ✅ *(Completada)* - [x] Programación y calendario de parciales, recuperatorios, entregas y exámenes finales. - [x] Matriz de carga rápida de notas con autoguardado asíncrono y promedios en tiempo real. - [x] Cierre formal e inmutable de actas con número oficial (`ACTA-YYYY-Sem-ID`) y registro de auditoría. - [x] Consulta de calificaciones y estado de regularidad para alumnos. ### Fase 4: UI/UX Avanzada para Bedelía & Modo Impersonación ✅ *(Completada)* - [x] Grilla semanal interactiva (Drag & Drop) con FullCalendar y barra lateral de comisiones sin aula. - [x] Detección visual de colisiones en tiempo real con reversión automática y mensajes de alerta. - [x] Modo de impersonación administrativa (*login as*) con cabecera `X-Impersonate-User` y banner visual ámbar. - [x] Integración de Optimizador Genético heurístico acoplado a turnos académicos reales. ### Fase 5: Integración Auth, Email y Moodle 4.1 ✅ *(Completada)* - [x] Panel de configuración global administrativa con contraseñas cifradas vía Fernet. - [x] Capa de caché híbrida (`CacheService` en Redis/memoria) y cola asíncrona tolerante a fallos (`MoodleSyncTask` con DLQ). - [x] Autenticación híbrida: Google OAuth 2.0 (`@unicaba.edu.ar`), Moodle SSO y Login Local con fallback. - [x] Motor de notificaciones transaccionales por email (`EmailService`) para docentes. ### Fase 5.1: Cobertura ABM 100% y Mantenimiento Seguro ✅ *(Completada)* - [x] ABMs completos y protegidos para **Sedes/Edificios**, **Aulas (físicas/virtuales)**, **Ciclos Lectivos**, **Carreras**, **Materias**, **Comisiones** y **Reservas**. - [x] Módulo de Reinicio Total del Sistema (`POST /api/v1/admin/system/reset`) con validación obligatoria de contraseña de Administrador y preservación de cuentas y roles RBAC. - [x] Soporte de inicialización limpia (`--empty-academic` / `--no-demo`) para arranque desde cero. --- ### Sprint Activo: Flujo Completo de Bedelía & Reemplazo Definitivo de Excel 🏛️ ⚡ *(En Curso)* * **Objetivo:** Permitirle a Bedelía gestionar íntegramente el ciclo de asignaciones académicas sin depender de planillas de cálculo, estandarizando el flujo de trabajo en 9 pasos secuenciales: 1. [x] **Paso 1 — Sede / Edificio:** Alta y mantenimiento del espacio físico (`/buildings/list_buildings`). 2. [x] **Paso 2 — Aula (Física / Virtual):** Definición de espacios, capacidades de aforo y recursos (`/classrooms/list_classrooms`). 3. [x] **Paso 3 — Ciclo Lectivo:** Definición del período académico y activación del cuatrimestre vigente (`/admin/academic_terms_list`). 4. [x] **Paso 4 — Carrera / Titulación:** Alta del programa académico o plan de estudios (`/admin/careers_list`). 5. [x] **Paso 5 — Asignatura / Materia:** Alta en el plan de estudios vinculada obligatoriamente a la Carrera (`/admin/subjects_list`). 6. [x] **Paso 6 — Comisión:** Creación de comisiones vinculadas a la materia, carrera y ciclo lectivo con filtrado y visualización contextual (`/admin/commissions_list`). 7. [x] **Paso 7 — Asociar Profesores:** Asignación previa del equipo de cátedra (titulares y adjuntos) con roles específicos (`/admin/commission_detail`). 8. [x] **Paso 8 — Asociar Alumnos:** Matriculación de estudiantes en la comisión con validación de restricciones horarias (`/admin/commission_detail`). 9. [x] **Paso 9 — Reserva de Espacios:** Asignación ágil del aula (física o virtual) a la comisión, con validación de conflictos en 1 clic (`/schedule/add_reservation` o Drag & Drop en `/schedule/calendar_view`). * **Asignaturas Compartidas entre Múltiples Carreras:** - [x] Modelo Many-to-Many (`subject_careers`) en base de datos. - [x] Asignación múltiple y visualización de badges por titulación en asignaturas y comisiones. - [x] Filtro por carrera unificado para materias compartidas. * **Canal de Importación de Planillas (Google Sheets):** - [x] Descubrimiento dinámico de pestañas para los 6 días semanales (Lunes a Sábado con GIDs oficiales). - [x] Desglose y normalización de carreras compuestas separadas por guion (`-`). - [x] Soporte de múltiples códigos de materia (`/`). - [x] Informe detallado por día de cursada (`by_day`) en UI. * **Documentación Operativa:** - [x] Manual del Personal de Bedelía con el flujo secuencial de 9 pasos. - [x] Manual del Docente (agenda, Google Meet y actas de notas). - [x] Manual del Estudiante (consulta de aulas y exámenes). * **Validación en Entorno Real:** - [x] Verificación en contenedor LXC productivo (`10.0.0.217` / `eduspace.oemspot.com.ar`). --- ### Fase 6: Despliegue en Servidores y Hardening 🏢 *(Planificada)* - [ ] Automatización de workers persistentes en systemd para la cola asíncrona de Moodle. - [ ] Configuración optimizada de `docker-compose.yml` de producción. - [ ] Pruebas de estrés de concurrencia y validación final de performance sub-segundo.