Files
admin-edu-space/ROADMAP.md
T

8.5 KiB

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.4 (Dashboard Bedelía: Filtro Temporal "Mañana" en Switchers y Cartelera Operativa)
Fecha de Actualización: 07 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)

  • Backend Flask como API REST pura bajo /api/v1/ retornando exclusivamente JSON.
  • Frontend BFF en Node.js + Express con renderizado de plantillas Nunjucks.
  • Autenticación desacoplada con tokens JWT en Cookie HttpOnly segura.
  • Pipeline de seguridad SecurityFilterChain con blindaje OWASP y rate limiting.
  • Cliente Axios centralizado con interceptor Bearer token automático.

Fase 1: Paridad Legacy, Virtualidad y Dashboards Especializados ✅ (Completada)

  • Importador de Google Sheets corregido: eliminación de colisiones en aulas virtuales múltiples (Campus Virtual · VIRTUAL).
  • Dashboards específicos e interactivos para Bedelía, Docente, Alumno y Administrador.
  • Cartelera del Día (today_schedule) con bloques horarios (07:00 a 22:00 hs) y filtros dinámicos.
  • 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)

  • Tabla relacional commission_teachers para soportar múltiples docentes por comisión (titulares, adjuntos, ayudantes).
  • Matriz de conflictos con validación física estricta, chequeo de aforo de seguridad y superposición docente.
  • Excepción de superposición justificada por co-docencia activa.
  • 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)

  • Programación y calendario de parciales, recuperatorios, entregas y exámenes finales.
  • Matriz de carga rápida de notas con autoguardado asíncrono y promedios en tiempo real.
  • Cierre formal e inmutable de actas con número oficial (ACTA-YYYY-Sem-ID) y registro de auditoría.
  • Consulta de calificaciones y estado de regularidad para alumnos.

Fase 4: UI/UX Avanzada para Bedelía & Modo Impersonación ✅ (Completada)

  • Grilla semanal interactiva (Drag & Drop) con FullCalendar y barra lateral de comisiones sin aula.
  • Detección visual de colisiones en tiempo real con reversión automática y mensajes de alerta.
  • Modo de impersonación administrativa (login as) con cabecera X-Impersonate-User y banner visual ámbar.
  • 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)

  • Panel de configuración global administrativa con contraseñas cifradas vía Fernet.
  • Capa de caché híbrida (CacheService en Redis/memoria) y cola asíncrona tolerante a fallos (MoodleSyncTask con DLQ).
  • Autenticación híbrida: Google OAuth 2.0 (@unicaba.edu.ar), Moodle SSO y Login Local con fallback.
  • Motor de notificaciones transaccionales por email (EmailService) para docentes.

Fase 5.1: Cobertura ABM 100% y Mantenimiento Seguro ✅ (Completada)

  • ABMs completos y protegidos para Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas.
  • 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.
  • 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. Paso 1 — Sede / Edificio: Alta y mantenimiento del espacio físico (/buildings/list_buildings).
    2. Paso 2 — Aula (Física / Virtual): Definición de espacios, capacidades de aforo y recursos (/classrooms/list_classrooms).
    3. Paso 3 — Ciclo Lectivo: Definición del período académico y activación del cuatrimestre vigente (/admin/academic_terms_list).
    4. Paso 4 — Carrera / Titulación: Alta del programa académico o plan de estudios (/admin/careers_list).
    5. Paso 5 — Asignatura / Materia: Alta en el plan de estudios vinculada obligatoriamente a la Carrera (/admin/subjects_list).
    6. 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. Paso 7 — Asociar Profesores: Asignación previa del equipo de cátedra (titulares y adjuntos) con roles específicos (/admin/commission_detail).
    8. Paso 8 — Asociar Alumnos: Matriculación de estudiantes en la comisión con validación de restricciones horarias (/admin/commission_detail).
    9. 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:
    • Modelo Many-to-Many (subject_careers) en base de datos.
    • Asignación múltiple y visualización de badges por titulación en asignaturas y comisiones.
    • Filtro por carrera unificado para materias compartidas.
  • Canal de Importación de Planillas (Google Sheets):
    • Descubrimiento dinámico de pestañas para los 6 días semanales (Lunes a Sábado con GIDs oficiales).
    • Desglose y normalización de carreras compuestas separadas por guion (-).
    • Soporte de múltiples códigos de materia (/).
    • Informe detallado por día de cursada (by_day) en UI.
  • Documentación Operativa:
    • Manual del Personal de Bedelía con el flujo secuencial de 9 pasos.
    • Manual del Docente (agenda, Google Meet y actas de notas).
    • Manual del Estudiante (consulta de aulas y exámenes).
  • Validación en Entorno Real:
    • 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.