13 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
.credencialesy.envestrictamente 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.) enfrontend/src/routes/dashboard.jsque 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.htmly se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en/classrooms/list_classrooms?view_mode=physicalyview_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_careersen 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), manteniendocareer_idprincipal por retrocompatibilidad. -
Normalización del Importador de Google Sheets:
sheets_importer.pydescubre 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.compara 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.pygeneraba reservas únicamente paraweeks_to_generate = 4a 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ó aweeks_to_generate = 16cubriendo 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ó
handleTodayScheduleenfrontend/src/routes/schedule.jsque tenía hardcodeado2026-09-18como 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-commissionspara identificar comisiones sin asignación de espacio, y se añadió la columna "Espacio / Aula" con filtro rápidounassigned_room=trueen/admin/commissions_list.
- Causa Raíz de Reservas Vacías:
-
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 estructurasfilter_statspara los tres períodos (today,week,month) con métricas precisas (counts, porcentajes) y diccionarios legiblesdate_labelsen 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.
- Panel de Percentiles: Switcher interactivo
- Validación en Producción: Desplegado en
https://eduspace.oemspot.com.ary 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_dateysingle_date_onlyal métodosync(...). - 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 conTEC. DIG.yVIDEOJUEGOS). - 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-inspecty actualización de/api/v1/dashboard/sync-sheets.
- Se implementó
- 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_inspectque 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_inspectretornando 239 filas y 18 carreras, y sincronización filtrada con éxito (ej. Martes + DATOS procesando exactamente sus 3 filas coincidentes).
-
Sprint v3.4.1: Corrección de Bug en Import Sheet, Aulas Virtuales en Bedelía, Modularización de Vistas y Reglas de Workflow:
- Fix Bug Google Sheets Import (
Error loading Google Sheets sync view):- Causa Raíz:
availableCareersyavailableSubjectsse declaraban únicamente dentro de un bloque condicional enadmin.js, provocandoReferenceError: availableCareers is not defineden peticiones GET normales. - Solución: Se declararon e inicializaron a nivel de función
handleGoogleSheetsImporttanto en la consulta inicial dePromise.allSettledcomo en el refresh posterior a la sincronización.
- Causa Raíz:
- Fix Bug Aulas Virtuales en Dashboard de Bedelía:
- Causa Raíz: El conteo
virtual_classroomsendashboard.pycalculabalen(virtual_classrooms_list)sobre la tabla relacionalclassrooms, que solo contiene 1 registro genérico (id: 331, code: 'VIRTUAL', building: 'Campus Virtual'). - Solución: Se actualizó la lógica para calcular las salas virtuales a partir de las comisiones activas con modalidad virtual (Google Meet/Teams/Zoom) o reservas en Campus Virtual, reportando las 101 salas virtuales activas. Se incorporó el arreglo
virtual_roomsenrole_datade Bedelía y se agregó la pestaña "Salas Virtuales (Campus Virtual)" con 127 enlaces a Google Meet en el panel de Aulas (dashbede.html).
- Causa Raíz: El conteo
- Modularización de la Arquitectura de Vistas (
dashboard.htmlcomo Layout Padre):- Se dividió el archivo monolítico
dashboard.htmlde más de 2300 líneas en 4 componentes/subvistas según el rol del usuario:dashadm.html(Administrador)dashbede.html(Bedelía)dashprof.html(Docente / Profesor)dashalum.html(Alumno / Estudiante)
dashboard.htmlactúa ahora como layout/plantilla padre limpia que inyecta la subvista correspondiente mediante{% include %}de Nunjucks.
- Se dividió el archivo monolítico
- Actualización de Reglas en
docs/constitution.md(Principio 9):- Se agregó el Principio 9 innegociable:
- Siempre actualizar y guardar el control de la nueva versión semántica al momento de compilar.
- Al finalizar la compilación, siempre subir y desplegar la nueva versión al servidor institucional de producción.
- Se agregó el Principio 9 innegociable:
- Despliegue y Verificación en Producción:
- Versionado elevado a
v3.4.1. - Desplegado exitosamente en el servidor LXC
10.0.0.217(https://eduspace.oemspot.com.ar). - Verificación HTTP 200 en
/version, login admin,/admin/google_sheets_import, dashboards modularizados de los 4 roles y cuenta institucional de Bedelía.
- Versionado elevado a
- Fix Bug Google Sheets Import (
Próximos pasos
- Monitoreo del uso del nuevo panel modularizado de Bedelía por parte de los operadores.
- Continuar con los objetivos de la Fase 6 del Roadmap institucional.