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.
- Ajuste Móvil de UdeCi: Se movió el botón lanzador hacia el interior de la pantalla (
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 (
-
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 fijofor (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.
- En
- 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
formatReservationDatesy 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).
- En
- Bump Semántico y Despliegue Obligatorio (Principio 9):
- Versión incrementada a
v3.4.2en Frontend y Backend. - Despliegue inmediato al servidor institucional
10.0.0.217y verificación en caliente.
- Versión incrementada a
- Problema 1: Duplicación de Reservas por Hora en Cartelera:
-
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.
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (
- Backend y BFF REST:
sheets_importer.pyampliado para retornarpreview_rowsy procesarselected_rowscon granularidad de entidades.- Endpoints
POST /api/v1/dashboard/sheets-inspectyPOST /api/v1/dashboard/sync-sheets.
- Bump Semántico y Despliegue Obligatorio (Principio 9):
- Versión incrementada a
v3.4.3en Frontend y Backend. - Despliegue y verificación en caliente en el servidor institucional
10.0.0.217(https://eduspace.oemspot.com.ar).
- Versión incrementada a
- Selección Granular de Entidades (Tarjetas Checkbox):
-
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 detomorrow_dt(00:00:00 a 23:59:59), agregando estadísticas enfilter_stats['tomorrow']para percentiles de aulas físicas y comisiones asignadas/sin asignar, ytomorrow_schedule_listpara 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-unassignedy#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
#bedeliaScheduleTomorrowmostrando asignaturas, comisiones, docentes y enlaces para mañana.
- Backend API (
- Bump Semántico y Despliegue Obligatorio (Principio 9):
- Versión incrementada a
v3.4.4en Frontend y Backend. - Despliegue al servidor institucional
10.0.0.217(https://eduspace.oemspot.com.ar) y verificación en caliente.
- Versión incrementada a
-
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.pylas rutas@genetic_bp.route('/commissions'),/algorithm-status,/preview-optimization,/optimizey/apply-optimizationexigían de forma estrictag.jwt_user.role in ['ADMIN', 'teacher']og.jwt_user.role in ['ADMIN']. - Al ingresar como Bedelía (
role == 'Bedelia'), Docentes o Administradores con rol en minúsculas, el backend devolvía403 Forbidden, bloqueando la llamada AJAX y dejando la interfaz vacía con--. - En el Frontend BFF, la ruta
/genetic_optimizerno requeríarequireAuthni pasaba datos de sesión de usuario a la plantilla.
- En
- Solución Implementada:
- Creación del helper
check_optimizer_permission(user, requires_write)enbackend/app/routes/genetic_algorithm.pyhabilitando acceso aadmin,administrador,bedelia,docente/teachery permisos RBAC en 'optimizer'. GET /api/genetic/commissionsahora enriquece los objetos consubject_name,subject_code,career_name,scheduleyshift.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 conrequireAuthe inyección de sesión a la vista.
- Creación del helper
- Bump Semántico y Despliegue Obligatorio (Principio 9):
- Versión incrementada a
v3.4.5en Frontend y Backend. - Despliegue inmediato al servidor institucional
10.0.0.217y verificación en caliente HTTP 200.
- Versión incrementada a
- Problema Reportado: AI Room Reservation Optimizer no mostraba comisiones y los indicadores de Available Classrooms, Active Commissions y Existing Reservations quedaban en
-
Sprint v3.4.6: Corrección Integral de Reservas, Pisos Dinámicos, Fechas Humanas y Filtro de Carreras:
- Incidencias Resueltas:
/schedule/add_reservationy/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./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.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)./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./buildings/list_buildingsy/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_listyclassrooms_by_floor), corregido el contador de "Pisos Presenciales" (4 pisos) y soporte completo de niveles dinámicos alfanuméricos (PB, EP, Subsuelo, etc.)./admin/commissions_list: CorregidoUnboundLocalErrorenbackend/app/routes/api/admin.pypor importación interna tardía deCareer, que arrojaba HTTP 500 al filtrar porcareer_id=180, 181, 182.
- Incidencias Resueltas:
-
Sprint v3.4.8: Registro de Auditoría Institucional y Trazabilidad Operativa:
- Incidencias y Mejoras:
/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.- Modelo
AuditLog: Agregado métodoto_dict()para serialización JSON segura e ISO. AuditService: Soporte de parámetros explícitosuser_idyuser_emailpara registrar eventos cuando el usuario no está autenticado o el intento de acceso falla./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)./api/v1/reservations: Auditoría de creación (CREATE), edición (UPDATE), cancelación (CANCEL), borrado permanente (DELETE) y confirmación oficial (CONFIRM)./api/v1/classroomsy/api/v1/buildings: Auditoría de altas, modificaciones, alternancia de estado activo/inactivo (TOGGLE) y bajas.- Optimizador Genético IA: Auditoría de ejecuciones (
OPTIMIZE_RUN) y aplicación de asignaciones masivas en base de datos (OPTIMIZE_APPLY). - 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.8en Frontend y Backend.
- Versión incrementada a
- Incidencias y Mejoras:
-
Sprint v3.4.9: Solución de Límite de Payload en Importador de Sheets & Diagnóstico Transparente de Incidentes:
- Incidencias y Mejoras:
frontend/src/app.js: Elevado límite deexpress.jsonyexpress.urlencodedde 100 KB por defecto a 50 MB ({ limit: '50mb' }), resolviendo el errorPayloadTooLargeError: request entity too large: expected 154166, length 154166, limit 102400que provocaba HTTP 500 al enviar la matriz de filas preseleccionadas en/admin/google_sheets_import.- 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. backend/app/routes/api/admin.py: Nuevo endpoint/api/v1/admin/log-errorpara registrar incidentes técnicos no controlados del frontend directamente enAuditLog(action='SYSTEM_ERROR',module='system').backend/app/routes/api/dashboard.py: Instrumentada auditoría completa ensync_google_sheetspara registrar tanto importaciones exitosas (SHEETS_IMPORT) como fallos (SHEETS_IMPORT_ERROR) con desglose de estadísticas y excepciones.
- Incidencias y Mejoras:
-
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):
- Creación de la Skill de SDD (
.agents/skills/sdd/SKILL.md) con las plantillas despec.md,plan.md,tasks.mdy sintaxis formal EARS en español. - Creación de comandos reutilizables de agentes en
.opencode/commands/(sdd-spec,sdd-plan,sdd-tasks). - Definición de roles de subagentes en
.opencode/agents/: Coordinator, Planner, Implementer, Reviewer (QA). - Integración del arnés en
AGENTS.md.
- Creación de la Skill de SDD (
- 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:
frontend/src/routes/schedule.js: Endpoint/schedule/export_csvcon codificación UTF-8 BOM (\uFEFF) y delimitadores;para apertura nativa e inmediata en Microsoft Excel en español.frontend/views/schedule/today.html: Botones directos[ Excel / CSV ]e[ Imprimir ], acompañados de estilos CSS@media printque formatean la grilla de asignaciones en hoja A4 limpia con membrete institucional oficial de UniCABA.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.0enpackage.json,app.js,__init__.py,setup.pyyopenapi.py.
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (
- Metodología y Arnés de Ingeniería con IA (Apuntes Día 1, 2 y 3):
-
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/): Creadosspec.md(6 RF en EARS),plan.mdytasks.md(todas las tareas completadas). - Extracción Híbrida y Concurrente con Emails Reales:
scripts/moodle_replicator.pyse autentica enhttps://campus.udelaciudad.edu.ar/conlogintokendiná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 comousernameypasswordpara pruebas locales. - Preservado el DNI y correo real de Carlos Tello (
34247025,carlostellocba@gmail.com).
- DNI de 8 dígitos determinístico derivado del ID de Moodle (
- 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.
- Creación y actualización de usuarios mediante Moodle REST API (
- Skill de Automatización: Creada
.agents/skills/moodle-replicator/SKILL.mdcon manual operativo y comandos CLI.
- Especificación SDD (
-
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.
- Extraídos y asignados todos los profesores reales con rol
- 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 porpython-requests.
- Forzado estrictamente el encabezado
- Sincronización de Contraseña Local (Fix 34247025):
- Se corrigió la contraseña del usuario
34247025restableciéndola a34247025idéntica al DNI en Moodle local. Verificado inicio de sesión exitoso.
- Se corrigió la contraseña del usuario
- Catálogo Completo de la Carrera (16 Cursos):
-
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.pyy bandera--sync-appenmoodle_replicator.py. - Mapeo unívoco: Moodle
editingteacher-> AppDocente(role_id=2), Moodlestudent-> AppAlumno(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.
- Desarrollado
- Desmatriculación de Cuenta Admin en Moodle Local (
10.0.0.207):- Removidas todas las matriculaciones de
adminen 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:
- Removidas todas las matriculaciones de
- Habilitación de Web Services para Tokens de Usuario en Moodle Local (
10.0.0.207):- Asignada la capability
moodle/webservice:createtokenal rol 7 (user/ usuario autenticado) enmdl_role_capabilities. - Habilitado
enablemobilewebservice = 1y serviciomoodle_mobile_app(enabled = 1). - Verificada la emisión de tokens exitosa para usuarios individuales (incluyendo
34247025) tanto contramoodle_apicomo contramoodle_mobile_app.
- Asignada la capability
- Conexión de Admin Edu Space con Moodle Local:
- Configurado el token
810428346d3601c68a37a315fcba8d4391629f46demoodle_apiensystem_settingsdeclassrooms_db. - Habilitada
auth_moodle_enabled = 'true'ymoodle_server_url = 'http://10.0.0.207/moodle'. - Adaptado el endpoint de autenticación
/api/v1/auth/moodlepara autenticar conmoodle_api(con fallback amoodle_mobile_app) y hacer matching de cuenta local por número de documento (DNI).
- Configurado el token
- 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()ysync_from_moodle_to_app()enMoodleClient.
- Agregado el endpoint administrativo
- Sincronización RBAC de Roles Moodle a PostgreSQL de la App (
-
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_tasksdeclassrooms_dben10.0.0.217, dejando la cola limpia en 0 registros.
- Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla
- Ampliación de Funciones Web Services en Moodle Local (
10.0.0.207):- Asignadas al servicio
moodle_apilas funcionesenrol_manual_unenrol_users,core_enrol_unenrol_user_enrolment,core_role_assign_rolesycore_role_unassign_roles, completando el catálogo a 15 funciones esenciales.
- Asignadas al servicio
- Seguridad por Restricción de Red (IP Restriction):
- Fijada la restricción de red
iprestriction = '10.0.0.0/24'enmdl_external_tokens, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle.
- Fijada la restricción de red
- Autenticación por API Key Institucional en Admin Edu Space:
- Creado mecanismo para autenticar endpoints de sincronización (
/settings/moodle/syncy/moodle/sync-from-moodle) medianteX-API-Keyinstitucional 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).
- Creado mecanismo para autenticar endpoints de sincronización (
- Purga de Tareas de Sincronización Residuales:
-
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.mdy.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]).
- Incorporada regla mandatoria en
- Reparación de Tipos en Replicador Moodle:
- Ajustado casteo a entero
int(course_meta['local_id'])yint(u.get('role_id', 5))enscripts/moodle_replicator.py.
- Ajustado casteo a entero
- Robustez Híbrida en
SystemSetting:- Implementado descriptor híbrido
_hybrid_setting_methodparaget_decrypted_valueyget_masked_value, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
- Implementado descriptor híbrido
- 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_pollingpara evitar bloqueos de base de datos entearDown().
- Añadida espera activa de finalización de workers en
- Validación Automatizada:
- 52/52 tests pasando en verde al 100% (
pytest tests -v).
- 52/52 tests pasando en verde al 100% (
- Principio 10 de la Constitución:
-
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 PydanticBaseModel),storage.py(acceso a persistencia). Prohibida la lógica de negocio en el frontend o en archivos monolíticos.
- Desacople estricto:
- Tipado Fuerte y Validación Pydantic:
- Uso obligatorio de
Fieldpara 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 Entitydetallando el campo exacto.
- Uso obligatorio de
- Semántica HTTP y Excepciones Controladas:
- Uso de códigos de estado HTTP semánticos (
201 Createden POST,200 OK,204 No Content). - Prohibido retornar
nullo respuestas vacías ante fallos: levantarHTTPExceptioncontroladas con detalle descriptivo (404, 400, 409).
- Uso de códigos de estado HTTP semánticos (
- Documentación Interactiva Automática:
- Contratos OpenAPI expuestos en
/docs(Swagger UI) con capacidades de prueba en vivo (Try it out).
- Contratos OpenAPI expuestos en
- Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual:
- Pestaña en Configuración Global: Planificada en
ROADMAP.mdy 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.AsyncClientconasync def/awaitpara 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"ycontent: prompt.
- Pestaña en Configuración Global: Planificada en
- 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) yMEMORY.md.
- Sincronizados
- Arquitectura Modular en 4 Capas:
-
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) ybackend/database.py(persistencia relacional). - Módulos migrados a FastAPI:
version,auth,classrooms,reservations,students,dashboard,optimizerygenetic. - Documentación interactiva OpenAPI v3 expuesta nativamente en
/docs(Swagger UI) y/redoc. - Puente de retrocompatibilidad y cero regresión implementado mediante
a2wsgipara asegurar interoperabilidad fluida con Gunicorn, Uvicorn y el frontend BFF Express.js.
- Backend Core migrado a FastAPI con arquitectura de 4 capas:
- 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]).
- 57 tests automatizados ejecutados y aprobados al 100% en pytest (
- 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).
- Bump semántico a
- Reemplazo Arquitectónico:
Próximos pasos
- Monitorear los endpoints ASGI en producción bajo concurrencia operativa.
- Implementar la pestaña de Asistente IA en la Configuración Global administrativa (
ROADMAP.mdFase 7). - Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.