Files
admin-edu-space/MEMORY.md
T

39 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: Ergonomía Móvil de UdeCi y Beneficios — SDD-012 (v3.8.41):
    • Ajuste Móvil de UdeCi: Se movió el botón lanzador hacia el interior de la pantalla (bottom: calc(32px + env(safe-area-inset-bottom, 0px)), right: calc(26px + env(safe-area-inset-right, 0px))), garantizando que no sea recortado por la curvatura del cristal ni por las barras de gestos de los smartphones.
    • Versión Consolidada: v3.8.41.

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).
  • Sprint v3.5.6: Principio 10 de Tolerancia Cero a Errores de Código, Robustez en SystemSetting y Replicador:

    • Principio 10 de la Constitución:
      • Incorporada regla mandatoria en docs/constitution.md, AGENTS.md, .agents/skills/sdd/SKILL.md, .agents/skills/deploy/SKILL.md y .opencode/agents/ (coordinator.md, implementer.md, reviewer.md).
      • Es estrictamente inadmisible declarar una tarea o sprint como terminado o completado si persisten errores en el código o en el analizador de la IDE (@[current_problems]).
    • Reparación de Tipos en Replicador Moodle:
      • Ajustado casteo a entero int(course_meta['local_id']) y int(u.get('role_id', 5)) en scripts/moodle_replicator.py.
    • Robustez Híbrida en SystemSetting:
      • Implementado descriptor híbrido _hybrid_setting_method para get_decrypted_value y get_masked_value, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
    • Resolución de Condición de Carrera en Tests de SQLite:
      • Añadida espera activa de finalización de workers en test_05_api_async_job_submission_and_polling para evitar bloqueos de base de datos en tearDown().
    • Validación Automatizada:
      • 52/52 tests pasando en verde al 100% (pytest tests -v).
  • Sprint v3.5.7: Principio 11 de la Constitución — Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs):

    • Arquitectura Modular en 4 Capas:
      • Desacople estricto: main.py (bootstrap/registro), routers/ (endpoints agrupados por dominio con prefijos y tags para Swagger), schemas/ (contratos con Pydantic BaseModel), storage.py (acceso a persistencia). Prohibida la lógica de negocio en el frontend o en archivos monolíticos.
    • Tipado Fuerte y Validación Pydantic:
      • Uso obligatorio de Field para validaciones declarativas (min_length, max_length, gt, ge, regex).
      • Distinción estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados con defaults).
      • Manejo y respuesta automática de error 422 Unprocessable Entity detallando el campo exacto.
    • Semántica HTTP y Excepciones Controladas:
      • Uso de códigos de estado HTTP semánticos (201 Created en POST, 200 OK, 204 No Content).
      • Prohibido retornar null o respuestas vacías ante fallos: levantar HTTPException controladas con detalle descriptivo (404, 400, 409).
    • Documentación Interactiva Automática:
      • Contratos OpenAPI expuestos en /docs (Swagger UI) con capacidades de prueba en vivo (Try it out).
    • Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual:
      • Pestaña en Configuración Global: Planificada en ROADMAP.md y UI administrativa para configurar URL del servidor local (Ollama, llama.cpp), modelo, token y timeout para el futuro asistente virtual de la app.
      • Cliente Asíncrono no Bloqueante: Uso mandatorio de httpx.AsyncClient con async def / await para inferencias concurrentes sin bloquear el servidor.
      • Timeout Generoso: Configurar timeout de 600 segundos previendo carga de modelos en VRAM o prompts extensos.
      • Formato Estándar de Roles: Historial estructurado bajo role: "system" | "user" | "assistant" y content: prompt.
    • Actualización Documental Completa:
      • Sincronizados docs/constitution.md (Principio 11), AGENTS.md, .agents/skills/sdd/SKILL.md, .opencode/agents/ (coordinator.md, planner.md, implementer.md, reviewer.md), ROADMAP.md (Fase 7) y MEMORY.md.
  • Sprint v3.6.0: Migración Completa de Flask API a FastAPI ASGI (Principio 11):

    • Reemplazo Arquitectónico:
      • Backend Core migrado a FastAPI con arquitectura de 4 capas: backend/main.py (FastAPI bootstrap), backend/routers/ (APIRouters modulares por dominio), backend/schemas/ (Pydantic v2 BaseModels con validación declarativa) y backend/database.py (persistencia relacional).
      • Módulos migrados a FastAPI: version, auth, classrooms, reservations, students, dashboard, optimizer y genetic.
      • Documentación interactiva OpenAPI v3 expuesta nativamente en /docs (Swagger UI) y /redoc.
      • Puente de retrocompatibilidad y cero regresión implementado mediante a2wsgi para asegurar interoperabilidad fluida con Gunicorn, Uvicorn y el frontend BFF Express.js.
    • Calidad y Verificación:
      • 57 tests automatizados ejecutados y aprobados al 100% en pytest (57 passed).
      • Cero errores en linter, tipos y compilación estática (@[current_problems]).
    • Despliegue Continuo:
      • Bump semántico a v3.6.0.
      • Actualización remota y reinicio de servicios en el servidor LXC 10.0.0.217 (https://eduspace.oemspot.com.ar).

Próximos pasos

  1. Monitorear los endpoints ASGI en producción bajo concurrencia operativa.
  2. Implementar la pestaña de Asistente IA en la Configuración Global administrativa (ROADMAP.md Fase 7).
  3. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.