diff --git a/CHANGELOG.md b/CHANGELOG.md index 484ee51..9b423ea 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,27 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1 - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. +## [3.4.8] - 2026-10-09 +### Agregado & Mejorado (Registro de Auditoría Institucional y Trazabilidad Operativa) +- **Auditoría Completa de Autenticación y Sesiones (`AuditService` & `/api/v1/auth/`):** + - Registro sistemático de eventos de inicio de sesión exitosos (`LOGIN`), inicios vía Google SSO (`LOGIN_GOOGLE`) y Moodle delegado (`LOGIN_MOODLE`). + - Registro de intentos fallidos (`LOGIN_FAILED`) con captura de correo, IP de origen y motivo del rechazo (credenciales inválidas, dominio no autorizado o cuenta inactiva). + - Auditoría de accesos bloqueados por deshabilitación administrativa de contraseña local (`LOGIN_BLOCKED`). + - Auditoría de cierres de sesión (`LOGOUT`) y cambios de contraseña institucional por el usuario (`PASSWORD_CHANGE`). +- **Trazabilidad de Espacios Físicos, Aulas y Reservas:** + - Auditoría de altas, modificaciones, bajas y alternancia de estado en edificios (`buildings`) y aulas (`classrooms`). + - Auditoría de creación, edición, cancelación, confirmación y borrado de reservas (`reservations`). + - Auditoría de corridas (`OPTIMIZE_RUN`) y aplicación de asignaciones masivas (`OPTIMIZE_APPLY`) del Optimizador Genético IA. +- **Endpoint RESTful de Auditoría (`GET /api/v1/admin/audit-logs`):** + - Exposición de endpoints RESTful con soporte de filtros por módulo, acción, búsqueda multi-campo y paginación configurable. + - Implementación del método `to_dict()` en el modelo `AuditLog` para serialización JSON segura. +- **Interfaz Institucional de Auditoría (`/admin/audit_logs`):** + - Conexión del Frontend BFF con el Backend REST Core. + - Badges temáticos e intuitivos para cada acción institucional y módulo. + - Filtros rápidos por categorías (Sesiones, Fallos de Login, Reservas, Aulas, Sedes, Optimizador IA). + - Modal interactivo de inspección con visor JSON/texto formateado y botón para copiar al portapapeles. + - Paginación dinámica nativa compatible con Nunjucks que conserva los parámetros de búsqueda. + ## [3.4.7] - 2026-10-08 ### Agregado & Mejorado (Panel Interactivo de Plantas y Aulas en Edificios) - **Gestión de Edificios (`/buildings/edit/:id` y `/buildings/add_building`):** diff --git a/MEMORY.md b/MEMORY.md index ebc28ac..491c00f 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -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). diff --git a/ROADMAP.md b/ROADMAP.md index ea1025b..e5ec164 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,8 +2,8 @@ ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) -**Versión:** 3.4.7 (Panel Interactivo de Plantas y Aulas en Edificios) -**Fecha de Actualización:** 08 de Octubre de 2026 +**Versión:** 3.4.8 (Registro de Auditoría Institucional y Trazabilidad Operativa) +**Fecha de Actualización:** 09 de Octubre de 2026 **Rama Base:** `dev` --- diff --git a/backend/app/__init__.py b/backend/app/__init__.py index ba497e8..67a07a4 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _ from config.config import Config # Initialize extensions -__version__ = "3.4.7" +__version__ = "3.4.8" db = SQLAlchemy() migrate = Migrate() cors = CORS() diff --git a/backend/app/models/audit_log.py b/backend/app/models/audit_log.py index dfd831c..fe22b10 100644 --- a/backend/app/models/audit_log.py +++ b/backend/app/models/audit_log.py @@ -23,3 +23,19 @@ class AuditLog(db.Model): def __repr__(self): return f"" + + def to_dict(self): + """Serializa el registro de auditoría a diccionario JSON.""" + return { + 'id': self.id, + 'user_id': self.user_id, + 'user_email': self.user_email, + 'action': self.action, + 'module': self.module, + 'entity_id': self.entity_id, + 'details': self.details, + 'ip_address': self.ip_address, + 'created_at': self.created_at.strftime('%Y-%m-%d %H:%M:%S') if self.created_at else None, + 'created_at_iso': self.created_at.isoformat() if self.created_at else None + } + diff --git a/backend/app/routes/api/admin.py b/backend/app/routes/api/admin.py index c44196c..d90d43d 100644 --- a/backend/app/routes/api/admin.py +++ b/backend/app/routes/api/admin.py @@ -12,6 +12,8 @@ from app.models.reservation import Reservation, ReservationStatus from app.models.academic_term import AcademicTerm from app.models.milestone import MilestoneType, AcademicMilestone from app.models.audit_log import AuditLog +from app.services.audit_service import AuditService +from sqlalchemy import or_ from app.constants.document_types import DOCUMENT_TYPES, validate_document, format_document from app.services.enrollment_service import EnrollmentService from app.services.gradebook_service import GradebookService @@ -2556,6 +2558,14 @@ def create_building(): db.session.add(building) db.session.commit() + AuditService.log( + action='CREATE', + module='buildings', + entity_id=building.id, + user=g.jwt_user, + details=f"Nueva sede/edificio creado: '{building.name}' (Código: {building.code or 'S/C'}, Pisos: {building.floors})" + ) + return jsonify({ 'status': 'success', 'message': f'Edificio "{name}" creado con éxito.', @@ -2607,6 +2617,14 @@ def update_building(id): db.session.commit() + AuditService.log( + action='UPDATE', + module='buildings', + entity_id=building.id, + user=g.jwt_user, + details=f"Edificio/sede #{building.id} ('{building.name}') actualizado. Pisos: {building.floors}, Código: {building.code}" + ) + return jsonify({ 'status': 'success', 'message': f'Edificio "{building.name}" actualizado con éxito.', @@ -2626,6 +2644,14 @@ def toggle_building(id): building.updated_at = datetime.utcnow() db.session.commit() + AuditService.log( + action='TOGGLE', + module='buildings', + entity_id=building.id, + user=g.jwt_user, + details=f"Edificio '{building.name}' {'activado' if building.is_active else 'desactivado'}" + ) + return jsonify({ 'status': 'success', 'message': f'Edificio "{building.name}" {"activado" if building.is_active else "desactivado"} exitosamente.', @@ -2651,12 +2677,21 @@ def delete_building(id): 'message': f'No se puede eliminar el edificio "{building.name}" porque tiene {count} aulas asociadas.' }), 409 + b_name = building.name db.session.delete(building) db.session.commit() + AuditService.log( + action='DELETE', + module='buildings', + entity_id=id, + user=g.jwt_user, + details=f"Edificio/sede #{id} ('{b_name}') eliminado permanentemente" + ) + return jsonify({ 'status': 'success', - 'message': f'Edificio "{building.name}" eliminado correctamente.' + 'message': f'Edificio "{b_name}" eliminado correctamente.' }), 200 @@ -2791,3 +2826,83 @@ def reset_entire_system(): 'message': f'Error durante la reinicialización de la base de datos: {str(e)}' }), 500 + +# --------------------------------------------------------- +# REGISTRO DE AUDITORÍA INSTITUCIONAL RESTful +# --------------------------------------------------------- + +@api_admin_bp.route('/audit-logs', methods=['GET']) +@api_admin_bp.route('/audit_logs', methods=['GET']) +@jwt_required +def get_audit_logs(): + """ + Endpoint RESTful para consultar la bitácora inmutable de auditoría institucional. + Soporta paginación, búsqueda multi-campo y filtrado por módulo y acción. + """ + page = request.args.get('page', 1, type=int) + per_page = min(request.args.get('per_page', 20, type=int), 100) + module_filter = request.args.get('module', '').strip().lower() + action_filter = request.args.get('action', '').strip().upper() + search = request.args.get('search', '').strip() + + query = AuditLog.query + + if module_filter: + query = query.filter(AuditLog.module == module_filter) + if action_filter: + query = query.filter(AuditLog.action == action_filter) + if search: + query = query.filter( + or_( + AuditLog.user_email.ilike(f'%{search}%'), + AuditLog.details.ilike(f'%{search}%'), + AuditLog.ip_address.ilike(f'%{search}%'), + AuditLog.action.ilike(f'%{search}%'), + AuditLog.module.ilike(f'%{search}%') + ) + ) + + pagination = query.order_by(AuditLog.created_at.desc()).paginate( + page=page, per_page=per_page, error_out=False + ) + + modules_tuples = db.session.query(AuditLog.module).distinct().all() + actions_tuples = db.session.query(AuditLog.action).distinct().all() + + modules = sorted(list(set([r[0].lower() for r in modules_tuples if r[0]]))) + actions = sorted(list(set([r[0].upper() for r in actions_tuples if r[0]]))) + + default_modules = ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin'] + for m in default_modules: + if m not in modules: + modules.append(m) + + default_actions = [ + 'LOGIN', 'LOGIN_FAILED', 'LOGIN_BLOCKED', 'LOGIN_GOOGLE', 'LOGIN_MOODLE', 'LOGOUT', + 'PASSWORD_CHANGE', 'IMPERSONATE_START', 'IMPERSONATE_END', + 'CREATE', 'UPDATE', 'DELETE', 'CONFIRM', 'CANCEL', 'TOGGLE', + 'OPTIMIZE_RUN', 'OPTIMIZE_APPLY', 'SYSTEM_RESET' + ] + for a in default_actions: + if a not in actions: + actions.append(a) + + return jsonify({ + 'status': 'success', + 'logs': [log.to_dict() for log in pagination.items], + 'pagination': { + 'page': pagination.page, + 'per_page': pagination.per_page, + 'total': pagination.total, + 'pages': pagination.pages or 1, + 'has_prev': pagination.has_prev, + 'has_next': pagination.has_next + }, + 'modules': sorted(modules), + 'actions': sorted(actions), + 'current_module': module_filter, + 'current_action': action_filter, + 'search': search + }), 200 + + diff --git a/backend/app/routes/api/auth.py b/backend/app/routes/api/auth.py index c48fadc..579c9d2 100644 --- a/backend/app/routes/api/auth.py +++ b/backend/app/routes/api/auth.py @@ -20,6 +20,7 @@ from app.services.user_service import UserService from app.services.jwt_service import JWTService from app.services.cache_service import cache_service from app.services.moodle_client import moodle_client +from app.services.audit_service import AuditService from app.schemas.auth_dto import LoginDTO, RefreshTokenDTO from app.utils.jwt_decorators import jwt_required @@ -69,6 +70,12 @@ def login(): user = user_service.authenticate(dto.email, dto.password) if not user: + AuditService.log( + action='LOGIN_FAILED', + module='auth', + user_email=dto.email, + details=f"Intento de inicio de sesión fallido para {dto.email}. Credenciales incorrectas o cuenta inactiva." + ) return jsonify({ 'error': 'Unauthorized', 'message': 'Credenciales de acceso incorrectas o cuenta inactiva.' @@ -76,11 +83,26 @@ def login(): is_admin = user.is_admin() or getattr(user, 'role', '').upper() == 'ADMIN' if not local_enabled and not is_admin: + AuditService.log( + action='LOGIN_BLOCKED', + module='auth', + user=user, + entity_id=user.id, + details=f"Acceso local con contraseña bloqueado para {user.email}. Método deshabilitado por administración." + ) return jsonify({ 'error': 'Forbidden', 'message': 'El acceso local con contraseña está deshabilitado por el administrador. Inicie sesión mediante Google OAuth o Moodle.' }), 403 + AuditService.log( + action='LOGIN', + module='auth', + user=user, + entity_id=user.id, + details=f"Inicio de sesión exitoso (Autenticación Local) - Rol: {user.role}" + ) + tokens = JWTService.generate_tokens(user) profile = user_service.get_profile_data(user) @@ -130,6 +152,12 @@ def google_auth(): if allowed_domains and domain.lower() not in allowed_domains: logger.warning(f"[GoogleAuth] Access denied for {email}: domain {domain} not in {allowed_domains}") + AuditService.log( + action='LOGIN_FAILED', + module='auth', + user_email=email, + details=f"Acceso Google OAuth denegado: dominio @{domain} no autorizado para {email}." + ) return jsonify({ 'error': 'Forbidden', 'message': f'Acceso denegado. El dominio @{domain} no está autorizado en esta institución.' @@ -159,8 +187,23 @@ def google_auth(): logger.info(f"[GoogleAuth] Created new local user for {email} with role Docente.") if not user.is_active: + AuditService.log( + action='LOGIN_FAILED', + module='auth', + user=user, + entity_id=user.id, + details=f"Acceso Google OAuth denegado: cuenta institucional desactivada para {email}." + ) return jsonify({'error': 'Unauthorized', 'message': 'Su cuenta se encuentra inactiva. Contacte a Bedelía.'}), 401 + AuditService.log( + action='LOGIN_GOOGLE', + module='auth', + user=user, + entity_id=user.id, + details=f"Inicio de sesión exitoso (Google OAuth SSO) - Rol: {user.role}" + ) + tokens = JWTService.generate_tokens(user) profile = user_service.get_profile_data(user) @@ -220,6 +263,12 @@ def moodle_auth(): if 'error' in res_data or 'token' not in res_data: err_msg = res_data.get('error', 'Credenciales inválidas en Moodle.') + AuditService.log( + action='LOGIN_FAILED', + module='auth', + user_email=f"{username}@unicaba.edu.ar", + details=f"Intento de autenticación Moodle fallido para '{username}': {err_msg}" + ) return jsonify({'error': 'Unauthorized', 'message': f'Moodle: {err_msg}'}), 401 moodle_user_token = res_data['token'] @@ -265,8 +314,23 @@ def moodle_auth(): logger.info(f"[MoodleAuth] Created new local user for Moodle username '{username}' with role '{role_name}'.") if not user.is_active: + AuditService.log( + action='LOGIN_FAILED', + module='auth', + user=user, + entity_id=user.id, + details=f"Inicio de sesión Moodle denegado: cuenta institucional desactivada para {username}." + ) return jsonify({'error': 'Unauthorized', 'message': 'Su cuenta en Edu-Space está desactivada.'}), 401 + AuditService.log( + action='LOGIN_MOODLE', + module='auth', + user=user, + entity_id=user.id, + details=f"Inicio de sesión exitoso (Moodle Delegado) - Usuario: {username}, Rol: {user.role}" + ) + tokens = JWTService.generate_tokens(user) profile = user_service.get_profile_data(user) @@ -336,6 +400,14 @@ def logout(): """ Session logout: revokes active access token and clears cookies. """ + if g.jwt_user: + AuditService.log( + action='LOGOUT', + module='auth', + user=g.jwt_user, + entity_id=g.jwt_user.id, + details=f"Cierre de sesión seguro de {g.jwt_user.email}" + ) JWTService.revoke_token(g.jwt_token) resp = make_response(jsonify({'message': 'Sesión finalizada y token revocado exitosamente.'}), 200) resp.delete_cookie('refresh_token', path='/api/v1/auth/refresh') @@ -375,6 +447,13 @@ def change_password(): user = g.jwt_user if not user.check_password(current_password): + AuditService.log( + action='PASSWORD_FAILED', + module='auth', + user=user, + entity_id=user.id, + details="Intento fallido de cambio de contraseña: la contraseña actual no coincide." + ) return jsonify({ 'error': 'Unauthorized', 'message': 'La contraseña actual ingresada es incorrecta.' @@ -383,6 +462,14 @@ def change_password(): user.set_password(new_password) db.session.commit() + AuditService.log( + action='PASSWORD_CHANGE', + module='auth', + user=user, + entity_id=user.id, + details="Cambio de contraseña institucional completado exitosamente." + ) + logger.info(f"[Auth] Password successfully updated for user {user.email}") return jsonify({ 'status': 'success', diff --git a/backend/app/routes/api/classrooms.py b/backend/app/routes/api/classrooms.py index 1ca186c..38e940d 100644 --- a/backend/app/routes/api/classrooms.py +++ b/backend/app/routes/api/classrooms.py @@ -4,6 +4,7 @@ from pydantic import ValidationError from app import db from app.models.classroom import Classroom from app.services.classroom_service import ClassroomService +from app.services.audit_service import AuditService from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO, ClassroomResponseDTO from app.utils.jwt_decorators import jwt_required, jwt_role_required @@ -80,6 +81,13 @@ def create_classroom(): try: classroom = classroom_service.create_classroom(dto) + AuditService.log( + action='CREATE', + module='classrooms', + entity_id=classroom.id, + user=g.jwt_user, + details=f"Nueva aula creada: {classroom.code} en {classroom.building} (Piso {classroom.floor}, Capacidad: {classroom.capacity})" + ) return jsonify({ 'message': 'Aula creada exitosamente.', 'id': classroom.id, @@ -101,6 +109,13 @@ def update_classroom(classroom_id: int): try: classroom = classroom_service.update_classroom(classroom_id, dto) + AuditService.log( + action='UPDATE', + module='classrooms', + entity_id=classroom.id, + user=g.jwt_user, + details=f"Aula #{classroom.id} ({classroom.code}) actualizada. Capacidad: {classroom.capacity}, Piso: {classroom.floor}" + ) return jsonify({ 'message': 'Aula actualizada exitosamente.', 'id': classroom.id, @@ -118,6 +133,13 @@ def delete_classroom(classroom_id: int): if not deleted: return jsonify({'error': 'NotFound', 'message': f'Aula {classroom_id} no encontrada.'}), 404 + AuditService.log( + action='DELETE', + module='classrooms', + entity_id=classroom_id, + user=g.jwt_user, + details=f"Aula #{classroom_id} eliminada/desactivada del sistema" + ) return jsonify({'message': f'Aula {classroom_id} eliminada/desactivada correctamente.'}), 200 @api_classrooms_bp.route('//toggle', methods=['POST']) @@ -127,6 +149,13 @@ def toggle_classroom(classroom_id: int): classroom = Classroom.query.get_or_404(classroom_id) classroom.is_active = not classroom.is_active db.session.commit() + AuditService.log( + action='TOGGLE', + module='classrooms', + entity_id=classroom.id, + user=g.jwt_user, + details=f"Aula {classroom.code} {'activada' if classroom.is_active else 'desactivada'}" + ) return jsonify({ 'status': 'success', 'id': classroom.id, diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 2877cc0..7dfeaa7 100644 --- a/backend/app/routes/api/openapi.py +++ b/backend/app/routes/api/openapi.py @@ -7,7 +7,7 @@ OPENAPI_SPEC = { "info": { "title": "Edu-Space REST API", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", - "version": "3.4.7" + "version": "3.4.8" }, "servers": [ { diff --git a/backend/app/routes/api/reservations.py b/backend/app/routes/api/reservations.py index 2aab5cf..9d71dff 100644 --- a/backend/app/routes/api/reservations.py +++ b/backend/app/routes/api/reservations.py @@ -5,6 +5,7 @@ from pydantic import ValidationError from app import db from app.models.reservation import Reservation from app.services.reservation_service import ReservationService +from app.services.audit_service import AuditService from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO from app.utils.jwt_decorators import jwt_required, jwt_role_required @@ -187,6 +188,13 @@ def create_reservation(): try: reservation = reservation_service.create_reservation(dto) + AuditService.log( + action='CREATE', + module='reservations', + entity_id=reservation.id, + user=g.jwt_user, + details=f"Nueva reserva creada #{reservation.id} en aula ID {reservation.classroom_id} ({reservation.start_time.strftime('%Y-%m-%d %H:%M')} a {reservation.end_time.strftime('%H:%M')}) - Motivo: {reservation.purpose}" + ) return jsonify({ 'message': 'Reserva creada exitosamente.', 'id': reservation.id, @@ -210,6 +218,13 @@ def update_reservation(reservation_id: int): try: reservation = reservation_service.update_reservation(reservation_id, dto) + AuditService.log( + action='UPDATE', + module='reservations', + entity_id=reservation.id, + user=g.jwt_user, + details=f"Reserva #{reservation.id} modificada ({reservation.start_time.strftime('%Y-%m-%d %H:%M')} a {reservation.end_time.strftime('%H:%M')}) - Estado: {reservation.status}" + ) return jsonify({ 'message': 'Reserva actualizada exitosamente.', 'id': reservation.id, @@ -231,12 +246,26 @@ def cancel_reservation(reservation_id: int): return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 db.session.delete(res) db.session.commit() + AuditService.log( + action='DELETE', + module='reservations', + entity_id=reservation_id, + user=g.jwt_user, + details=f"Reserva #{reservation_id} eliminada permanentemente" + ) return jsonify({'message': f'Reserva {reservation_id} eliminada permanentemente.'}), 200 cancelled = reservation_service.cancel_reservation(reservation_id) if not cancelled: return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 + AuditService.log( + action='CANCEL', + module='reservations', + entity_id=reservation_id, + user=g.jwt_user, + details=f"Reserva #{reservation_id} cancelada" + ) return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200 @api_reservations_bp.route('//delete', methods=['POST']) @@ -248,6 +277,13 @@ def delete_reservation_post(reservation_id: int): return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 db.session.delete(res) db.session.commit() + AuditService.log( + action='DELETE', + module='reservations', + entity_id=reservation_id, + user=g.jwt_user, + details=f"Reserva #{reservation_id} eliminada permanentemente" + ) return jsonify({'message': f'Reserva {reservation_id} eliminada permanentemente.'}), 200 @api_reservations_bp.route('//cancel', methods=['POST']) @@ -258,6 +294,13 @@ def cancel_reservation_post(reservation_id: int): if not cancelled: return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 + AuditService.log( + action='CANCEL', + module='reservations', + entity_id=reservation_id, + user=g.jwt_user, + details=f"Reserva #{reservation_id} cancelada" + ) return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200 @api_reservations_bp.route('//confirm', methods=['POST']) @@ -268,6 +311,13 @@ def confirm_reservation(reservation_id: int): if not confirmed: return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404 + AuditService.log( + action='CONFIRM', + module='reservations', + entity_id=reservation_id, + user=g.jwt_user, + details=f"Reserva #{reservation_id} confirmada oficialmente" + ) return jsonify({'message': f'Reserva {reservation_id} confirmada correctamente.'}), 200 @api_reservations_bp.route('/check-conflicts', methods=['POST']) diff --git a/backend/app/routes/genetic_algorithm.py b/backend/app/routes/genetic_algorithm.py index 0fddb9b..eeb8d42 100644 --- a/backend/app/routes/genetic_algorithm.py +++ b/backend/app/routes/genetic_algorithm.py @@ -3,6 +3,7 @@ from datetime import datetime, timedelta from app.models.genetic_algorithm import ReservationOptimizer from app.models.reservation import Reservation, ReservationStatus from app import db +from app.services.audit_service import AuditService from app.utils.jwt_decorators import jwt_required genetic_bp = Blueprint('genetic_algorithm', __name__, url_prefix='/api/genetic') @@ -78,6 +79,13 @@ def optimize_reservations(): start_date=start_date, end_date=end_date ) + + AuditService.log( + action='OPTIMIZE_RUN', + module='optimizer', + user=g.jwt_user, + details=f"Ejecución de algoritmo genético para {len(commission_ids)} comisiones. Fitness: {result.get('fitness_score', 0)}% (Asignadas: {len(result.get('assigned_reservations', []))})" + ) return jsonify({ 'success': True, @@ -117,6 +125,13 @@ def apply_optimization(): # Initialize optimizer and apply reservations optimizer = ReservationOptimizer() applied_reservations = optimizer.apply_optimized_reservations(reservations_data) + + AuditService.log( + action='OPTIMIZE_APPLY', + module='optimizer', + user=g.jwt_user, + details=f"Consolidación de optimizador genético: {len(applied_reservations)} reservas aplicadas en base de datos." + ) return jsonify({ 'success': True, diff --git a/backend/app/services/audit_service.py b/backend/app/services/audit_service.py index 1af33ef..29f6829 100644 --- a/backend/app/services/audit_service.py +++ b/backend/app/services/audit_service.py @@ -12,19 +12,18 @@ class AuditService: @staticmethod def log(action: str, module: str, entity_id: Optional[int] = None, details: Optional[Any] = None, user: Optional[User] = None, - ip_address: Optional[str] = None) -> AuditLog: + ip_address: Optional[str] = None, + user_id: Optional[int] = None, + user_email: Optional[str] = None) -> AuditLog: """ Registra un evento de auditoría de forma segura, infiriendo el usuario e IP desde el contexto actual de la petición si no se especifican. """ - user_id = None - user_email = None - # 1. Determinar usuario actuante if user: user_id = user.id user_email = user.email - elif has_request_context(): + elif not user_id and not user_email and has_request_context(): if hasattr(g, 'jwt_user') and g.jwt_user: user_id = g.jwt_user.id user_email = g.jwt_user.email diff --git a/backend/setup.py b/backend/setup.py index 652b76f..e039158 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name="edu-space-admin", - version="3.4.7", + version="3.4.8", description="Administrative interface for Edu-Space Classroom Management System", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/backend/tests/test_audit_logs.py b/backend/tests/test_audit_logs.py new file mode 100644 index 0000000..9deb6ba --- /dev/null +++ b/backend/tests/test_audit_logs.py @@ -0,0 +1,86 @@ +import unittest +from datetime import datetime +from app import create_app, db +from app.models.user import User +from app.models.audit_log import AuditLog +from app.services.audit_service import AuditService +from app.services.jwt_service import JWTService + +class TestAuditLogs(unittest.TestCase): + @classmethod + def setUpClass(cls): + cls.app = create_app() + cls.app.config['TESTING'] = True + cls.app_context = cls.app.app_context() + cls.app_context.push() + db.create_all() + + cls.client = cls.app.test_client() + + # Crear o recuperar admin + cls.admin = User.query.filter_by(email='audit_admin@unicaba.edu.ar').first() + if not cls.admin: + cls.admin = User( + name='Admin Audit', + email='audit_admin@unicaba.edu.ar', + role='ADMIN', + is_active=True + ) + cls.admin.set_password('Password123!') + db.session.add(cls.admin) + db.session.commit() + + cls.tokens = JWTService.generate_tokens(cls.admin) + cls.headers = {'Authorization': f"Bearer {cls.tokens['access_token']}"} + + @classmethod + def tearDownClass(cls): + db.session.remove() + cls.app_context.pop() + + def test_01_audit_log_to_dict_and_service(self): + log = AuditService.log( + action='LOGIN_TEST', + module='auth', + details='Test audit log entry', + user_email='test@unicaba.edu.ar' + ) + self.assertIsNotNone(log.id) + d = log.to_dict() + self.assertEqual(d['action'], 'LOGIN_TEST') + self.assertEqual(d['module'], 'auth') + self.assertEqual(d['user_email'], 'test@unicaba.edu.ar') + self.assertIn('created_at', d) + + def test_02_audit_logs_api_endpoint(self): + AuditService.log('LOGIN', 'auth', user=self.admin, details='Login local exitoso') + AuditService.log('LOGIN_FAILED', 'auth', user_email='unknown@test.com', details='Credenciales invalidas') + + res = self.client.get('/api/v1/admin/audit-logs', headers=self.headers) + self.assertEqual(res.status_code, 200) + data = res.get_json() + self.assertEqual(data['status'], 'success') + self.assertIn('logs', data) + self.assertIn('pagination', data) + self.assertIn('modules', data) + self.assertIn('actions', data) + self.assertTrue(any(l['action'] == 'LOGIN_FAILED' for l in data['logs'])) + + def test_03_login_creates_audit_log(self): + # Intento fallido + res = self.client.post('/api/v1/auth/login', json={ + 'email': 'bad_user@unicaba.edu.ar', + 'password': 'wrongpassword' + }) + self.assertEqual(res.status_code, 401) + failed_log = AuditLog.query.filter_by(action='LOGIN_FAILED', user_email='bad_user@unicaba.edu.ar').first() + self.assertIsNotNone(failed_log) + + # Intento exitoso + res_ok = self.client.post('/api/v1/auth/login', json={ + 'email': 'audit_admin@unicaba.edu.ar', + 'password': 'Password123!' + }) + self.assertEqual(res_ok.status_code, 200) + success_log = AuditLog.query.filter_by(action='LOGIN', user_email='audit_admin@unicaba.edu.ar').order_by(AuditLog.id.desc()).first() + self.assertIsNotNone(success_log) diff --git a/frontend/package.json b/frontend/package.json index 2156622..7d663b8 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.4.7", + "version": "3.4.8", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 1494df5..91899f4 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.4.7'; -const FRONTEND_VERSION = '3.4.7'; -const BACKEND_VERSION = '3.4.7'; +const APP_VERSION = '3.4.8'; +const FRONTEND_VERSION = '3.4.8'; +const BACKEND_VERSION = '3.4.8'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/src/routes/admin.js b/frontend/src/routes/admin.js index 59e74c1..0ce50e8 100644 --- a/frontend/src/routes/admin.js +++ b/frontend/src/routes/admin.js @@ -1441,16 +1441,65 @@ const handleAuditLogs = async (req, res) => { const search = req.query.search || ''; const current_module = req.query.module || ''; const current_action = req.query.action || ''; - res.render('admin/audit_logs', { - title: 'Bitácora de Auditoría - Edu-Space Admin', - logs: [], - modules: ['classrooms', 'reservations', 'users', 'auth', 'academic', 'optimizer'], - actions: ['CREATE', 'UPDATE', 'DELETE', 'LOGIN', 'LOGOUT'], - current_module, - current_action, - search, - pagination: { pages: 1, page: 1, total: 0, has_prev: false, has_next: false } - }); + const page = parseInt(req.query.page, 10) || 1; + + try { + const resp = await req.apiClient.get('/admin/audit-logs', { + params: { + page, + per_page: 25, + search, + module: current_module, + action: current_action + } + }); + + const data = resp.data || {}; + const audit_logs = data.logs || []; + const pagination = data.pagination || { pages: 1, page: 1, total: 0, has_prev: false, has_next: false }; + + // Generar lista de números de páginas para la plantilla Nunjucks + const pages_list = []; + const totalPages = pagination.pages || 1; + const maxPages = 7; + let startPage = Math.max(1, page - Math.floor(maxPages / 2)); + let endPage = Math.min(totalPages, startPage + maxPages - 1); + if (endPage - startPage + 1 < maxPages) { + startPage = Math.max(1, endPage - maxPages + 1); + } + for (let i = startPage; i <= endPage; i++) { + pages_list.push(i); + } + pagination.pages_list = pages_list; + + const modules = (data.modules && data.modules.length > 0) ? data.modules : ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin']; + const actions = (data.actions && data.actions.length > 0) ? data.actions : ['LOGIN', 'LOGIN_FAILED', 'LOGOUT', 'CREATE', 'UPDATE', 'DELETE', 'CONFIRM', 'CANCEL']; + + res.render('admin/audit_logs', { + title: 'Registro de Auditoría Institucional - Edu-Space Admin', + audit_logs, + logs: audit_logs, + modules, + actions, + current_module, + current_action, + search, + pagination + }); + } catch (err) { + console.warn('[Admin] Error fetching audit logs from backend:', err.response?.data || err.message); + res.render('admin/audit_logs', { + title: 'Registro de Auditoría Institucional - Edu-Space Admin', + audit_logs: [], + logs: [], + modules: ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin'], + actions: ['LOGIN', 'LOGIN_FAILED', 'LOGOUT', 'CREATE', 'UPDATE', 'DELETE', 'CONFIRM', 'CANCEL'], + current_module, + current_action, + search, + pagination: { pages: 1, page: 1, total: 0, has_prev: false, has_next: false, pages_list: [1] } + }); + } }; router.get(['/audit_logs', '/audit-logs', '/audit'], handleAuditLogs); diff --git a/frontend/views/admin/audit_logs.html b/frontend/views/admin/audit_logs.html index 76b9e28..3280bf2 100644 --- a/frontend/views/admin/audit_logs.html +++ b/frontend/views/admin/audit_logs.html @@ -1,39 +1,53 @@ {% extends "base.html" %} -{% block title %}Bitácora de Auditoría - Edu-Space Admin{% endblock %} +{% block title %}Registro de Auditoría Institucional - Edu-Space Admin{% endblock %} {% block content %}
- +

Registro de Auditoría Institucional

-

Trazabilidad completa de operaciones, modificaciones y eventos de seguridad

+

Trazabilidad inmutable de inicios de sesión, cambios en espacios, reservas y operaciones del sistema

- - +
- +
@@ -41,13 +55,34 @@
{% if search or current_module or current_action %} @@ -56,58 +91,188 @@ {% endif %}
+ + +
- {% if audit_logs %} + {% if audit_logs and audit_logs.length > 0 %}
- - - - - - - + + + + + + + {% for log in audit_logs %} - - @@ -116,31 +281,29 @@
Fecha / HoraUsuarioAcciónMóduloID EntidadDetallesIPFecha / HoraUsuarioAcciónMóduloIDDetalles de la OperaciónIP Origen
- {{ log.created_at }} + + {{ log.created_at or log.created_at_iso or '-' }} + -
{{ log.user_email or 'Sistema' }}
+
+
+ {% if 'LOGIN' in log.action %} + + {% elif 'FAILED' in log.action %} + + {% elif 'IMPERSONATE' in log.action %} + + {% else %} + + {% endif %} +
+
+
+ {{ log.user_email or 'Sistema' }} +
+ {% if log.user_id %} + ID Usuario: #{{ log.user_id }} + {% endif %} +
+
{% if log.action == 'CREATE' %} - {{ log.action }} + + ALTA + {% elif log.action == 'UPDATE' %} - {{ log.action }} + + EDICIÓN + {% elif log.action == 'DELETE' %} - {{ log.action }} - {% elif 'LOGIN' in log.action %} - {{ log.action }} + + BAJA + + {% elif log.action == 'CANCEL' %} + + CANCELACIÓN + + {% elif log.action == 'CONFIRM' %} + + CONFIRMADA + + {% elif log.action == 'TOGGLE' %} + + ESTADO + + {% elif log.action == 'LOGIN' %} + + LOGIN LOCAL + + {% elif log.action == 'LOGIN_GOOGLE' %} + + LOGIN GOOGLE + + {% elif log.action == 'LOGIN_MOODLE' %} + + LOGIN MOODLE + + {% elif log.action == 'LOGIN_FAILED' %} + + LOGIN FALLIDO + + {% elif log.action == 'LOGIN_BLOCKED' %} + + BLOQUEADO + + {% elif log.action == 'LOGOUT' %} + + LOGOUT + + {% elif log.action == 'PASSWORD_CHANGE' %} + + CAMBIO CLAVE + + {% elif log.action == 'IMPERSONATE_START' %} + + IMPERSONACIÓN + + {% elif log.action == 'IMPERSONATE_END' %} + + FIN IMPERSON. + + {% elif log.action == 'OPTIMIZE_RUN' %} + + CORRIDA IA + + {% elif log.action == 'OPTIMIZE_APPLY' %} + + APLICACIÓN IA + + {% elif log.action == 'SYSTEM_RESET' %} + + REINICIO SISTEMA + {% else %} - {{ log.action }} + {{ log.action }} {% endif %} - {{ log.module }} + {% if log.module == 'auth' %} + auth + {% elif log.module == 'reservations' %} + reservas + {% elif log.module == 'classrooms' %} + aulas + {% elif log.module == 'buildings' %} + sedes + {% elif log.module == 'optimizer' %} + optimizador + {% else %} + {{ log.module }} + {% endif %} {{ log.entity_id or '-' }} - {{ log.details or '-' }} + +
+
+ {{ log.details or '-' }} +
+ {% if log.details and log.details.length > 50 %} + + {% endif %} +
+ {{ log.ip_address or '-' }}
- + {% if pagination.pages > 1 %} -
+
- Mostrando página {{ pagination.page }} de {{ pagination.pages }} ({{ pagination.total }} registros) + Mostrando página {{ pagination.page }} de {{ pagination.pages }} (Total: {{ pagination.total }} eventos registrados) -
+ + + + + {% endblock %} diff --git a/frontend/views/base.html b/frontend/views/base.html index c242195..2e9b6a8 100644 --- a/frontend/views/base.html +++ b/frontend/views/base.html @@ -1127,7 +1127,7 @@