feat(audit): implement institutional audit logging for logins and system operations v3.4.8

This commit is contained in:
2026-10-09 09:53:54 -03:00
parent 47c21dd25a
commit 1edd81516a
19 changed files with 795 additions and 79 deletions
+10 -6
View File
@@ -156,14 +156,18 @@ Memoria del proyecto entre sesiones para la rama `dev`.
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.7: Panel Interactivo de Plantas y Aulas en Edificios**:
- **Sprint v3.4.8: Registro de Auditoría Institucional y Trazabilidad Operativa**:
- **Incidencias y Mejoras**:
1. Transformación del formulario de edición de edificio (`/buildings/edit/:id` y `add_building`): reemplazado el input numérico simple por un **Panel Interactivo de Plantas y Aulas de la Sede**.
2. Agrupación y visualización dinámica de pisos y aulas (`buildFloorsList`), métricas por nivel (aulas y capacidad instalada) y accesos directos de edición y reserva por aula.
3. Botón directo contextual **`+ Nueva Aula en este Piso`** (`/classrooms/add_classroom?building_id=X&floor=Y`) con precarga automática de edificio y piso en el formulario de creación de aula.
4. Configurador visual de niveles con presets rápidos (`PB`, `PB + 1`, `PB + 3`, `Virtual`), stepper dinámico y previsualización de estructura proyectada para nuevas sedes.
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.7` en Frontend y Backend.
- Versión incrementada a `v3.4.8` en Frontend y Backend.
## Próximos pasos
1. Continuar con los objetivos de la Fase 6 del Roadmap institucional (Docker-compose productivo, Nginx con SSL y automatización de workers continuos Moodle).