Files
admin-edu-space/MEMORY.md
T

34 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).
  • 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: availableCareers y availableSubjects se declaraban únicamente dentro de un bloque condicional en admin.js, provocando ReferenceError: availableCareers is not defined en peticiones GET normales.
      • Solución: Se declararon e inicializaron a nivel de función handleGoogleSheetsImport tanto en la consulta inicial de Promise.allSettled como en el refresh posterior a la sincronización.
    • Fix Bug Aulas Virtuales en Dashboard de Bedelía:
      • Causa Raíz: El conteo virtual_classrooms en dashboard.py calculaba len(virtual_classrooms_list) sobre la tabla relacional classrooms, 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_rooms en role_data de 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).
    • Modularización de la Arquitectura de Vistas (dashboard.html como Layout Padre):
      • Se dividió el archivo monolítico dashboard.html de 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.html actúa ahora como layout/plantilla padre limpia que inyecta la subvista correspondiente mediante {% include %} de Nunjucks.
    • Actualización de Reglas en docs/constitution.md (Principio 9):
      • Se agregó el Principio 9 innegociable:
        1. Siempre actualizar y guardar el control de la nueva versión semántica al momento de compilar.
        2. Al finalizar la compilación, siempre subir y desplegar la nueva versión al servidor institucional de producción.
    • 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.
  • Sprint UX/UI: Agrupación Cronológica de Reservas y Formato Limpio de Fechas (v3.4.2):

    • Problema 1: Duplicación de Reservas por Hora en Cartelera:
      • En /schedule/today_schedule, un bucle fijo for (let hour = 7; hour <= 21; hour++) insertaba la misma reserva en cada bloque horario de 1 hora que abarcaba la materia (ej. Marketing Digital de 08:00 a 11:00 hs aparecía repetida a las 8, 9 y 10).
      • Solución: Se eliminó la clonación artificial y se introdujo la agrupación nativa por franja horaria real de cursada (grouped_slots, ej. 08:00 - 11:00 hs, 18:30 - 21:00 hs). Cada reserva aparece agrupada exactamente UNA SOLA VEZ en su bloque horario correspondiente con turno, duración, aula, cupo y enlace a Meet/Zoom.
    • Problema 2: Formato ISO Crudo en Listado de Reservas:
      • En /schedule/list_reservations (tabla y tarjetas) se mostraban strings crudos con 'T' y segundos (2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs).
      • Solución: Se enriquecieron todas las reservas con la función formatReservationDates y nuevos filtros Nunjucks (format_date_human, format_time, format_time_range), mostrando fecha limpia (Jueves 08/10/2026 / 08/10/2026) y horario amigable (08:00 - 11:00 hs).
    • Bump Semántico y Despliegue Obligatorio (Principio 9):
      • Versión incrementada a v3.4.2 en Frontend y Backend.
      • Despliegue inmediato al servidor institucional 10.0.0.217 y verificación en caliente.
  • Sprint Importador Google Sheets: Selección Granular y Grilla Interactiva (v3.4.3):

    • Selección Granular de Entidades (Tarjetas Checkbox):
      • Réplica del diseño visual de la Herramienta de Purga con botones "Marcar Todo" y "Desmarcar Todo".
      • Toggles individuales para Asignaciones de aulas (import_reservations), Aulas físicas y virtuales (import_classrooms), Comisiones (import_commissions), Asignaturas (import_subjects) y Carreras (import_careers).
    • Selector de Días de la Semana con Checkboxes Múltiples:
      • Reemplazo del selector simple por checkboxes individuales para Lunes a Sábado con accesos rápidos ("Todos", "Lun a Vie", "Limpiar").
    • Grilla de Previsualización Interactiva e Inspección Previa:
      • El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (preview_rows) de registros online.
      • Selección individual por fila y checkbox maestro superior.
      • Modificación manual inline de fechas de cursada por fila mediante Datepicker (<input type="date">) y aplicador de fecha masiva a seleccionados.
      • Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
      • Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
      • Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
    • Backend y BFF REST:
      • sheets_importer.py ampliado para retornar preview_rows y procesar selected_rows con granularidad de entidades.
      • Endpoints POST /api/v1/dashboard/sheets-inspect y POST /api/v1/dashboard/sync-sheets.
    • Bump Semántico y Despliegue Obligatorio (Principio 9):
      • Versión incrementada a v3.4.3 en Frontend y Backend.
      • Despliegue y verificación en caliente en el servidor institucional 10.0.0.217 (https://eduspace.oemspot.com.ar).
  • Sprint Dashboard Bedelía: Filtro Temporal "Mañana" en Switchers y Cartelera (v3.4.4):

    • Requerimiento: Agregar "Mañana" en el filtro actual del dashboard que decía "Día (Hoy) / Semana / Mes".
    • Implementación:
      • Backend API (backend/app/routes/api/dashboard.py): Cálculo de tomorrow_dt (00:00:00 a 23:59:59), agregando estadísticas en filter_stats['tomorrow'] para percentiles de aulas físicas y comisiones asignadas/sin asignar, y tomorrow_schedule_list para la agenda de clases.
      • Frontend BFF & Vistas (frontend/views/dashboard/dashbede.html, dashbede.html, dashadm.html, dashboard.html):
        • Switcher de percentiles: botón "Mañana" con actualización dinámica de percentiles de ocupación de aulas físicas.
        • Switcher de comisiones: botón "Mañana" y bloques #commBlock-tomorrow-unassigned y #commBlock-tomorrow-assigned.
        • Switcher de aulas físicas: botón "Mañana" y bloques #classBlock-tomorrow-unassigned (aulas libres con botón "Asignar") y #classBlock-tomorrow-assigned (aulas en uso).
        • Cartelera Operativa & Agenda de Clases: botón "Clases de Mañana" y tabla #bedeliaScheduleTomorrow mostrando asignaturas, comisiones, docentes y enlaces para mañana.
    • Bump Semántico y Despliegue Obligatorio (Principio 9):
      • Versión incrementada a v3.4.4 en Frontend y Backend.
      • Despliegue al servidor institucional 10.0.0.217 (https://eduspace.oemspot.com.ar) y verificación en caliente.
  • Sprint Optimizador de Aulas IA: Corrección de Permisos y Carga de Comisiones (v3.4.5):

    • Problema Reportado: AI Room Reservation Optimizer no mostraba comisiones y los indicadores de Available Classrooms, Active Commissions y Existing Reservations quedaban en --.
    • Causa Raíz Identificada:
      • En backend/app/routes/genetic_algorithm.py las rutas @genetic_bp.route('/commissions'), /algorithm-status, /preview-optimization, /optimize y /apply-optimization exigían de forma estricta g.jwt_user.role in ['ADMIN', 'teacher'] o g.jwt_user.role in ['ADMIN'].
      • Al ingresar como Bedelía (role == 'Bedelia'), Docentes o Administradores con rol en minúsculas, el backend devolvía 403 Forbidden, bloqueando la llamada AJAX y dejando la interfaz vacía con --.
      • En el Frontend BFF, la ruta /genetic_optimizer no requería requireAuth ni pasaba datos de sesión de usuario a la plantilla.
    • Solución Implementada:
      • Creación del helper check_optimizer_permission(user, requires_write) en backend/app/routes/genetic_algorithm.py habilitando acceso a admin, administrador, bedelia, docente/teacher y permisos RBAC en 'optimizer'.
      • GET /api/genetic/commissions ahora enriquece los objetos con subject_name, subject_code, career_name, schedule y shift.
      • frontend/views/genetic_optimizer.html: Traducido íntegramente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas de comisiones con badges, buscador en vivo multi-criterio y manejo de errores visual.
      • frontend/public/js/genetic-algorithm.js: Traducción de alertas, modales y tablas de resultados.
      • frontend/src/app.js: Protección con requireAuth e inyección de sesión a la vista.
    • Bump Semántico y Despliegue Obligatorio (Principio 9):
      • Versión incrementada a v3.4.5 en Frontend y Backend.
      • Despliegue inmediato al servidor institucional 10.0.0.217 y verificación en caliente HTTP 200.
  • Sprint v3.4.6: Corrección Integral de Reservas, Pisos Dinámicos, Fechas Humanas y Filtro de Carreras:

    • Incidencias Resueltas:
      1. /schedule/add_reservation y /schedule/edit: Corregido error de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar "Edificio Central". Inyección segura sin entities y matching resiliente de pisos físicos y virtuales.
      2. /schedule/calendar_view: Limpieza de datos hardcodeados/mockeados (Arquitectura de Software ARQ-101, COM-A, Licenciatura en Sistemas). El feed y filtros ahora consumen asignaturas, carreras y comisiones reales de la BD.
      3. sheets_importer.py: Eliminada la autogeneración no deseada de enlaces de Google Meet / Zoom (meet.google.com/edu-...) en reservas importadas cuando la celda original está vacía (ej. #9797 ASIG00215 - Marketing Digital).
      4. /classrooms/view_classroom: Formateadas fechas y horarios a español legible (ej. Viernes 04/09/2026 · 18:30 a 21:30 hs) eliminando formato ISO repetido y ampliando rango a todo el semestre 2026.
      5. /buildings/list_buildings y /buildings/view/:id: Corregida la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas físicas asociadas (floors_list y classrooms_by_floor), corregido el contador de "Pisos Presenciales" (4 pisos) y soporte completo de niveles dinámicos alfanuméricos (PB, EP, Subsuelo, etc.).
      6. /admin/commissions_list: Corregido UnboundLocalError en backend/app/routes/api/admin.py por importación interna tardía de Career, que arrojaba HTTP 500 al filtrar por career_id=180, 181, 182.
  • Sprint v3.4.8: Registro de Auditoría Institucional y Trazabilidad Operativa:

    • Incidencias y Mejoras:
      1. /api/v1/admin/audit-logs: Implementación del endpoint RESTful con paginación, filtros por módulo (auth, reservations, classrooms, buildings, optimizer, admin, etc.), acción (LOGIN, LOGIN_FAILED, CREATE, UPDATE, DELETE, CONFIRM, etc.) y búsqueda multi-campo.
      2. Modelo AuditLog: Agregado método to_dict() para serialización JSON segura e ISO.
      3. AuditService: Soporte de parámetros explícitos user_id y user_email para registrar eventos cuando el usuario no está autenticado o el intento de acceso falla.
      4. /api/v1/auth/: Instrumentada la captura de inicios de sesión (LOGIN), Google OAuth (LOGIN_GOOGLE), Moodle delegado (LOGIN_MOODLE), fallos de inicio de sesión (LOGIN_FAILED), accesos bloqueados (LOGIN_BLOCKED), cierres de sesión (LOGOUT) y cambios de contraseña institucional (PASSWORD_CHANGE).
      5. /api/v1/reservations: Auditoría de creación (CREATE), edición (UPDATE), cancelación (CANCEL), borrado permanente (DELETE) y confirmación oficial (CONFIRM).
      6. /api/v1/classrooms y /api/v1/buildings: Auditoría de altas, modificaciones, alternancia de estado activo/inactivo (TOGGLE) y bajas.
      7. Optimizador Genético IA: Auditoría de ejecuciones (OPTIMIZE_RUN) y aplicación de asignaciones masivas en base de datos (OPTIMIZE_APPLY).
      8. Frontend BFF (/admin/audit_logs): Conexión del BFF con la REST API, badges temáticos e intuitivos, filtros rápidos por categorías, visor modal para detalles extensos o JSON, y paginador dinámico nativo que preserva parámetros de consulta.
    • Bump Semántico y Despliegue Obligatorio (Principio 9):
      • Versión incrementada a v3.4.8 en Frontend y Backend.
  • Sprint v3.4.9: Solución de Límite de Payload en Importador de Sheets & Diagnóstico Transparente de Incidentes:

    • Incidencias y Mejoras:
      1. frontend/src/app.js: Elevado límite de express.json y express.urlencoded de 100 KB por defecto a 50 MB ({ limit: '50mb' }), resolviendo el error PayloadTooLargeError: request entity too large: expected 154166, length 154166, limit 102400 que provocaba HTTP 500 al enviar la matriz de filas preseleccionadas en /admin/google_sheets_import.
      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.
  • 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.
  • Sprint v3.5.1: Exportación y Replicación Moodle Producción a Local con Usuarios y Emails Reales:

    • Especificación SDD (specs/002-moodle-export-sync/): Creados spec.md (6 RF en EARS), plan.md y tasks.md (todas las tareas completadas).
    • Extracción Híbrida y Concurrente con Emails Reales:
      • scripts/moodle_replicator.py se autentica en https://campus.udelaciudad.edu.ar/ con logintoken dinámico.
      • Obtiene la nómina masiva estructurada vía /user/action_redir.php (download_participants&dataformat=json).
      • Consulta de forma concurrente (ThreadPool con 10 workers) los perfiles de los usuarios (user/view.php) extrayendo sus correos personales y reales (@gmail.com, @hotmail.com, etc.), eliminando cualquier generación de emails inventados.
      • Normalización fonética/ortográfica sin acentos (normalize_name) para vincular con 100% de precisión docentes y estudiantes entre HTML y JSON.
    • Reglas de Acceso y DNI Determinístico:
      • DNI de 8 dígitos determinístico derivado del ID de Moodle (90{moodle_id:06d}), asignado idénticamente como username y password para pruebas locales.
      • Preservado el DNI y correo real de Carlos Tello (34247025, carlostellocba@gmail.com).
    • Carga en Moodle Local (10.0.0.207):
      • Creación y actualización de usuarios mediante Moodle REST API (core_user_create_users, core_user_update_users).
      • 504 matriculaciones completadas exitosamente en los 4 cursos oficiales:
        • Carrera Lic. en Tecnologías Digitales (CCC): ID Prod 922 -> ID Local 19 (194 alumnos).
        • ASIG00124 - Sistemas Digitales_2/2026: ID Prod 5311 -> ID Local 16 (131 alumnos y 2 profesores).
        • ASIG00126 - Seguridad de la Información_2/2026: ID Prod 5313 -> ID Local 17 (138 alumnos y 2 profesores).
        • ASIG00127 - Programación de Vanguardia - E1_2/2026: ID Prod 5314 -> ID Local 18 (41 alumnos y 2 profesores).
      • Desactivada la política restrictiva de contraseñas (passwordpolicy=0) en el entorno de pruebas local para permitir contraseñas numéricas idénticas al DNI.
      • Verificación exitosa de login de estudiante en http://10.0.0.207/moodle/login/index.php.
    • Skill de Automatización: Creada .agents/skills/moodle-replicator/SKILL.md con manual operativo y comandos CLI.
  • Sprint v3.5.2: Replicación Completa de 16 Cursos, User-Agent Mozilla/5.0 y Fix de Credenciales:

    • Catálogo Completo de la Carrera (16 Cursos):
      • Se identificaron y replicaron la totalidad de las 15 materias de la Licenciatura en Tecnologías Digitales (1/2025, 2/2025, 1/2026 y 2/2026) más el curso de la carrera (Local 19).
      • Resuelto el caso de alumnos como 90010202 (Carlos Guillermo Terzano): ahora cuenta con sus 6 materias reales cursadas (Local 4, 5, 8, 9, 10, 11) además de la carrera.
      • Carlos Tello (34247025) matriculado en las 15 asignaturas y la carrera.
      • Más de 1.100 matriculaciones procesadas y validadas con 100% de éxito.
    • Identificación y Asignación de Todos los Docentes:
      • Extraídos y asignados todos los profesores reales con rol editingteacher (ID 3) y correos institucionales @udelaciudad.edu.ar.
    • Cabecera HTTP y User-Agent:
      • Forzado estrictamente el encabezado User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) en todas las solicitudes al campus para evitar alertas por python-requests.
    • Sincronización de Contraseña Local (Fix 34247025):
      • Se corrigió la contraseña del usuario 34247025 restableciéndola a 34247025 idéntica al DNI en Moodle local. Verificado inicio de sesión exitoso.
  • Sprint v3.5.3: Importación de Roles Moodle-App, Limpieza Total de Admin y Purga de Cursos:

    • Sincronización RBAC de Roles Moodle a PostgreSQL de la App (classrooms_db):
      • Desarrollado scripts/import_moodle_to_app.py y bandera --sync-app en moodle_replicator.py.
      • Mapeo unívoco: Moodle editingteacher -> App Docente (role_id=2), Moodle student -> App Alumno (role_id=6).
      • Importados 653 usuarios únicos (15 Docentes y 640 Alumnos) a la base de datos de producción con contraseñas PBKDF2 coincidentes con el DNI, habilitando de inmediato la asignación de comisiones, reservas e inscripciones.
    • Desmatriculación de Cuenta Admin en Moodle Local (10.0.0.207):
      • Removidas todas las matriculaciones de admin en cursos académicos y generales (quedando con 0 enrolments).
      • Sprint v3.5.4: Conexión Moodle API, Login Delegado y Sincronización Moodle -> Edu Space:
    • Habilitación de Web Services para Tokens de Usuario en Moodle Local (10.0.0.207):
      • Asignada la capability moodle/webservice:createtoken al rol 7 (user / usuario autenticado) en mdl_role_capabilities.
      • Habilitado enablemobilewebservice = 1 y servicio moodle_mobile_app (enabled = 1).
      • Verificada la emisión de tokens exitosa para usuarios individuales (incluyendo 34247025) tanto contra moodle_api como contra moodle_mobile_app.
    • Conexión de Admin Edu Space con Moodle Local:
      • Configurado el token 810428346d3601c68a37a315fcba8d4391629f46 de moodle_api en system_settings de classrooms_db.
      • Habilitada auth_moodle_enabled = 'true' y moodle_server_url = 'http://10.0.0.207/moodle'.
      • Adaptado el endpoint de autenticación /api/v1/auth/moodle para autenticar con moodle_api (con fallback a moodle_mobile_app) y hacer matching de cuenta local por número de documento (DNI).
    • Sincronización Bidireccional Moodle -> Edu Space:
      • Agregado el endpoint administrativo POST /api/v1/admin/moodle/sync-from-moodle.
      • Incorporados los métodos get_courses(), get_categories() y sync_from_moodle_to_app() en MoodleClient.
  • Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening:

    • Purga de Tareas de Sincronización Residuales:
      • Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla moodle_sync_tasks de classrooms_db en 10.0.0.217, dejando la cola limpia en 0 registros.
    • Ampliación de Funciones Web Services en Moodle Local (10.0.0.207):
      • Asignadas al servicio moodle_api las funciones enrol_manual_unenrol_users, core_enrol_unenrol_user_enrolment, core_role_assign_roles y core_role_unassign_roles, completando el catálogo a 15 funciones esenciales.
    • Seguridad por Restricción de Red (IP Restriction):
      • Fijada la restricción de red iprestriction = '10.0.0.0/24' en mdl_external_tokens, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle.
    • Autenticación por API Key Institucional en Admin Edu Space:
      • Creado mecanismo para autenticar endpoints de sincronización (/settings/moodle/sync y /moodle/sync-from-moodle) mediante X-API-Key institucional de 64 caracteres hex.
      • Generada y almacenada la clave API institucional cifrada con Fernet en system_settings (classrooms_db).
      • Agregados endpoints para consulta y regeneración de clave API (/api/v1/admin/settings/moodle/api-key).

Próximos pasos

  1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles.
  2. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.