Files
admin-edu-space/MEMORY.md
T

10 KiB

MEMORY.md - admin-edu-space

Memoria del proyecto entre sesiones para la rama dev.

Estado actual

  • Fases 0 a 5.1 del Roadmap completadas y estabilizadas:
    • Arquitectura desacoplada: Backend Flask REST API (:5000) + Frontend BFF Node.js/Express (:3000).
    • Cobertura 100% ABM: Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas.
    • Matriz integral de conflictos (físico, docente con co-docencia, aforo y restricción diaria del alumno).
    • Libro de Calificaciones (Gradebook) con actas de regularidad inmutables.
    • Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
    • Reinicialización segura del sistema con contraseña de Administrador.
  • Sprint Activo: MVP del Sistema de Bedelía — Reemplazo Definitivo del Excel:
    • Reemplazar la planilla Excel manual como herramienta operativa diaria de Bedelía.
    • La plataforma asume el rol de fuente única de verdad para la asignación y gestión de cursadas.
    • Las planillas/Google Sheets se mantienen únicamente para importación masiva de datos iniciales.

Decisiones (y por qué)

  • Flujo Secuencial de Bedelía (9 Pasos): Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
  • Asociación Explícita de Carreras: Toda Asignatura se vincula a su Carrera y toda Comisión hereda y expone la Carrera, permitiendo filtros y búsquedas específicas por titulación.
  • Importador de Google Sheets Preservado: Se conserva como ingestor inicial masivo sin fricción para no interrumpir el flujo actual del personal.
  • Guía Operativa por Rol: Documentar explícitamente el procedimiento para Bedelía, Docentes y Alumnos para facilitar la adopción inmediata.

Aprendizajes y errores a evitar

  • Colisiones Virtuales: En aulas virtuales no debe aplicarse colisión física horaria; múltiples comisiones pueden cursar simultáneamente con enlaces independientes.

  • Manejo de Estados Vacíos (Empty States): Proteger siempre las vistas de plantillas en Nunjucks contra colecciones vacías para evitar errores 500 cuando se reinicializa la base.

  • Seguridad de Secretos: Mantener .credenciales y .env estrictamente fuera del índice de Git.

  • Depuración de Mocks en Dashboard: Se eliminaron los arrays estáticos de fallback (upcoming_reservations, today_schedule_list, etc.) en frontend/src/routes/dashboard.js que mostraban asignaturas ficticias ("Matemática Discreta", "Sistemas Operativos", "Ingeniería de Software") en ausencia de datos reales.

  • Resolución de Error 500 en Aulas Presenciales y Virtuales: Se reparó el balance de etiquetas de Nunjucks en frontend/views/classrooms/list.html y se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en /classrooms/list_classrooms?view_mode=physical y view_mode=virtual.

  • Estandarización de Versiones (v3.4.0): Expuesto en Backend (/api/v1/version), Frontend BFF (/version), badges en el pie de página de la barra lateral (sidebar-footer) y en la pantalla de inicio de sesión (login.html).

  • Materias Compartidas en Múltiples Carreras (Many-to-Many): Se creó la tabla subject_careers en la base de datos relacional para asociar una materia a múltiples carreras simultáneamente (ej: IOT en DATOS, TEC. DIG y VIDEOJUEGOS, o Teoría y Práctica en PROF PROF y CIENCIAS), manteniendo career_id principal por retrocompatibilidad.

  • Normalización del Importador de Google Sheets: sheets_importer.py descubre dinámicamente las 6 pestañas semanales (Lunes a Sábado), desglosa y mapea de forma canónica las carreras separadas por guion (-), soporta códigos combinados (/) y desglosa métricas por día de cursada (by_day).

  • Reactivación de Bedelía en Producción: Activada la cuenta bedelia@edu-space.com para trabajo operativo institucional continuo.

  • Corrección de Vistas de Bedelía (Reservas de Hoy, Semana, Aulas Libres y Comisiones Sin Aula):

    • Causa Raíz de Reservas Vacías: sheets_importer.py generaba reservas únicamente para weeks_to_generate = 4 a partir del 31 de agosto de 2026 (finalizando el 26 de septiembre). En la fecha actual de octubre de 2026 (2026-10-07), la base de datos tenía 0 reservas para el día y la semana. Se amplió a weeks_to_generate = 16 cubriendo todo el 2° cuatrimestre regular (hasta el 19 de diciembre de 2026), generando 2464 reservas totales, 34 clases para hoy y 154 clases para la semana actual.
    • Fecha Dinámica en Cartelera: Se corrigió handleTodaySchedule en frontend/src/routes/schedule.js que tenía hardcodeado 2026-09-18 como fecha por defecto, reemplazándolo por la fecha actual ISO (new Date().toISOString().split('T')[0]) y añadiendo navegación interactiva entre días (prev_date, next_date, y botón "Hoy").
    • Panel Operativo de Cartelera & Agenda en Dashboard: Se incorporó en el Dashboard de Bedelía la sección "Cartelera Operativa & Agenda de Clases" con tabs dinámicos para alternar entre "Clases de Hoy" y "Esta Semana", visualizando horario, aula física o sala virtual (con enlace directo a Meet), materia, comisión, turno y docente.
    • Aulas Disponibles por Período: Se agregó el selector interactivo "Hoy" (con 18 aulas libres detectadas para el día), "Esta Semana" y "Este Mes" en el panel #bedelia-available-classrooms, permitiendo asignar aulas libres con un clic.
    • Comisiones Sin Aula Física ni Virtual: Se agregó el tab "Sin Aula Física ni Virtual (General)" en #bedelia-unassigned-commissions para identificar comisiones sin asignación de espacio, y se añadió la columna "Espacio / Aula" con filtro rápido unassigned_room=true en /admin/commissions_list.
  • Filtrado Temporal de Aulas y Comisiones (Día, Semana y Mes):

    • Requerimiento: Poder filtrar tanto Aulas Asignadas vs Aulas Sin Asignar (Libres) como Comisiones Asignadas vs Comisiones Sin Asignar por Día, Semana y Mes, con la opción de Día por defecto y aclarando la fecha explícita para fácil identificación de todos los usuarios.
    • Backend (dashboard.py): Se calculan estructuras filter_stats para los tres períodos (today, week, month) con métricas precisas (counts, porcentajes) y diccionarios legibles date_labels en español ("Hoy · Miércoles 07/10/2026", "Semana del 05/10 al 11/10/2026", "Mes de Octubre 2026").
    • Frontend BFF & UI (dashboard.js, dashboard.html):
      • Panel de Percentiles: Switcher interactivo [ Día (Hoy) ] (activo por defecto), [ Semana ] y [ Mes ] con badge explícito de fecha y barras reactivas.
      • Panel de Comisiones: Switcher [ Día (Hoy) ], [ Semana ], [ Mes ] con badge de fecha explícita, más pestañas para conmutar entre "Comisiones Asignadas (Con Aula)" y "Comisiones Sin Asignar (Pendientes)" con acciones directas para asignar espacio.
      • Panel de Aulas: Switcher [ Día (Hoy) ], [ Semana ], [ Mes ] con badge de fecha explícita, más pestañas para conmutar entre "Aulas Sin Asignar (Libres)" y "Aulas Asignadas (En Uso)" con acceso directo a cartelera o asignación inmediata.
    • Validación en Producción: Desplegado en https://eduspace.oemspot.com.ar y verificado con éxito (HTTP 200 en login de Bedelía y renderizado exacto de datos reales).
  • Evolución del Importador de Google Sheets (Filtros por Carrera, Materia, Día y Fecha Manual):

    • Requerimiento: Permitir filtrar qué Carrera, qué Materia y qué Día importar desde el Google Sheet online de UniCABA, como así también agregar la fecha manualmente para corregir o evitar errores si el Sheet no tiene la fecha o se requiere asignar una clase puntual en el calendario.
    • Backend (sheets_importer.py & dashboard.py):
      • Se implementó inspect_sheet_content() que descarga e inspecciona las 6 hojas del Sheet online en ~7s, descubriendo de forma dinámica todas las Carreras únicas (18 carreras detectadas) y Materias únicas (206 materias detectadas).
      • Se agregaron los parámetros filter_career, filter_subject, filter_day, manual_date y single_date_only al método sync(...).
      • Normalización robusta de días con normalize_day_name(...) insensible a acentos y mayúsculas.
      • Soporte de coincidencia parcial y sensible a carreras compuestas (ej: DATOS (CCC) coincide con asignaturas compartidas con TEC. DIG. y VIDEOJUEGOS).
      • Soporte de asignación de fecha puntual manual (single_date_only=True), creando 1 única reserva para esa fecha exacta en vez de las 16 semanas regulares, o tomando la fecha manual como base del cuatrimestre.
      • Nuevo endpoint REST GET/POST /api/v1/dashboard/sheets-inspect y actualización de /api/v1/dashboard/sync-sheets.
    • Frontend BFF & UI (admin.js & import.html):
      • Panel interactivo "Sincronización Académica con Filtros Avanzados y Control de Fecha".
      • Selectores dinámicos de Día (Todos, Lunes, Martes, etc.), inputs con autocompletado <datalist> para Carreras y Materias.
      • Selector interactivo de Fecha Manual (type="date") con switch toggle para "Importar ÚNICAMENTE para esta fecha puntual".
      • Botón "Inspeccionar Sheet Online" con llamada AJAX a /admin/sheets_inspect que carga en vivo las carreras y materias descubiertas.
      • Tarjeta de informe detallado post-sincronización con badges temáticos de "Filtros Activos", número de "Filas Coincidentes" vs totales, y modo de generación.
    • Validación en Producción:
      • Pruebas automatizadas de backend: 49 tests aprobados en pytest (100% passed).
      • Desplegado en producción institucional (https://eduspace.oemspot.com.ar).
      • Verificación online con bedelia@edu-space.com: HTTP 200 en /admin/google_sheets_import, endpoint /admin/sheets_inspect retornando 239 filas y 18 carreras, y sincronización filtrada con éxito (ej. Martes + DATOS procesando exactamente sus 3 filas coincidentes).

Próximos pasos

  1. Coordinar pruebas de usuario final con el equipo de Bedelía para validación de la experiencia operativa diaria y el nuevo importador filtrado.
  2. Mantener monitoreo del servicio y verificar la carga de notas o asistencias en el ciclo lectivo en curso.