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
+21
View File
@@ -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`):**
+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).
+2 -2
View File
@@ -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`
---
+1 -1
View File
@@ -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()
+16
View File
@@ -23,3 +23,19 @@ class AuditLog(db.Model):
def __repr__(self):
return f"<AuditLog #{self.id} {self.action} on {self.module} by {self.user_email or 'System'}>"
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
}
+116 -1
View File
@@ -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
+87
View File
@@ -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',
+29
View File
@@ -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('/<int:classroom_id>/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,
+1 -1
View File
@@ -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": [
{
+50
View File
@@ -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('/<int:reservation_id>/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('/<int:reservation_id>/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('/<int:reservation_id>/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'])
+15
View File
@@ -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')
@@ -79,6 +80,13 @@ def optimize_reservations():
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,
'data': {
@@ -118,6 +126,13 @@ def apply_optimization():
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,
'data': {
+4 -5
View File
@@ -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
+1 -1
View File
@@ -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",
+86
View File
@@ -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)
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.4.7",
"version": "3.4.8",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -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);
+54 -5
View File
@@ -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 || '';
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: 'Bitácora de Auditoría - Edu-Space Admin',
logs: [],
modules: ['classrooms', 'reservations', 'users', 'auth', 'academic', 'optimizer'],
actions: ['CREATE', 'UPDATE', 'DELETE', 'LOGIN', 'LOGOUT'],
title: 'Registro de Auditoría Institucional - Edu-Space Admin',
audit_logs,
logs: audit_logs,
modules,
actions,
current_module,
current_action,
search,
pagination: { pages: 1, page: 1, total: 0, has_prev: false, has_next: false }
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);
+288 -43
View File
@@ -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 %}
<div class="container-fluid pt-5 mt-4">
<!-- Header -->
<!-- Header Institucional -->
<div class="d-flex justify-content-between align-items-center mb-4 flex-wrap gap-2">
<div>
<h1 class="h3 mb-1">
<i class="bi bi-shield-check text-primary me-2"></i>Registro de Auditoría Institucional
</h1>
<p class="text-muted small mb-0">Trazabilidad completa de operaciones, modificaciones y eventos de seguridad</p>
<p class="text-muted small mb-0">Trazabilidad inmutable de inicios de sesión, cambios en espacios, reservas y operaciones del sistema</p>
</div>
<div>
<a href="/main/dashboard" class="btn btn-outline-secondary btn-sm">
<div class="d-flex gap-2">
<a href="/admin/audit_logs" class="btn btn-outline-secondary btn-sm" title="Recargar eventos">
<i class="bi bi-arrow-clockwise me-1"></i>Actualizar
</a>
<a href="/main/dashboard" class="btn btn-outline-primary btn-sm">
<i class="bi bi-arrow-left me-1"></i>Volver al Panel
</a>
</div>
</div>
<!-- Filtros -->
<!-- Filtros y Búsqueda -->
<div class="card border-0 shadow-sm mb-4">
<div class="card-body p-3">
<form method="GET" action="/admin/audit_logs" class="row g-2 align-items-center">
<div class="col-md-4">
<div class="input-group input-group-sm">
<span class="input-group-text bg-transparent"><i class="bi bi-search"></i></span>
<input type="text" name="search" class="form-control" placeholder="Buscar por email, IP o detalles..." value="{{ search }}">
<input type="text" name="search" class="form-control" placeholder="Buscar por usuario, IP, acción o detalle..." value="{{ search }}">
</div>
</div>
<div class="col-md-3">
<select name="module" class="form-select form-select-sm">
<option value="">Todos los módulos</option>
{% for mod in modules %}
<option value="{{ mod }}" {% if current_module == mod %}selected{% endif %}>{{ mod|capitalize }}</option>
<option value="{{ mod }}" {% if current_module == mod %}selected{% endif %}>
{% if mod == 'auth' %}Autenticación y Sesiones
{% elif mod == 'reservations' %}Reservas de Aulas
{% elif mod == 'classrooms' %}Gestión de Aulas
{% elif mod == 'buildings' %}Sedes y Edificios
{% elif mod == 'optimizer' %}Optimizador Genético IA
{% elif mod == 'users' %}Usuarios y Roles
{% elif mod == 'academic' %}Ciclos y Carreras
{% elif mod == 'admin' %}Sistema y Reinicio
{% else %}{{ mod|capitalize }}
{% endif %}
</option>
{% endfor %}
</select>
</div>
@@ -41,13 +55,34 @@
<select name="action" class="form-select form-select-sm">
<option value="">Todas las acciones</option>
{% for act in actions %}
<option value="{{ act }}" {% if current_action == act %}selected{% endif %}>{{ act }}</option>
<option value="{{ act }}" {% if current_action == act %}selected{% endif %}>
{% if act == 'LOGIN' %}Inicio de Sesión (Local)
{% elif act == 'LOGIN_GOOGLE' %}Inicio de Sesión (Google)
{% elif act == 'LOGIN_MOODLE' %}Inicio de Sesión (Moodle)
{% elif act == 'LOGIN_FAILED' %}Inicio de Sesión Fallido
{% elif act == 'LOGIN_BLOCKED' %}Acceso Bloqueado
{% elif act == 'LOGOUT' %}Cierre de Sesión
{% elif act == 'PASSWORD_CHANGE' %}Cambio de Contraseña
{% elif act == 'IMPERSONATE_START' %}Inicio Impersonación
{% elif act == 'IMPERSONATE_END' %}Fin Impersonación
{% elif act == 'CREATE' %}Creación (Alta)
{% elif act == 'UPDATE' %}Modificación (Edición)
{% elif act == 'DELETE' %}Eliminación (Baja)
{% elif act == 'CANCEL' %}Cancelación
{% elif act == 'CONFIRM' %}Confirmación
{% elif act == 'TOGGLE' %}Alternar Estado
{% elif act == 'OPTIMIZE_RUN' %}Ejecución Optimizador IA
{% elif act == 'OPTIMIZE_APPLY' %}Aplicación Optimizador IA
{% elif act == 'SYSTEM_RESET' %}Reinicio del Sistema
{% else %}{{ act }}
{% endif %}
</option>
{% endfor %}
</select>
</div>
<div class="col-md-2 d-flex gap-1">
<button type="submit" class="btn btn-primary btn-sm flex-grow-1">
<i class="bi bi-filter me-1"></i>Filtrar
<i class="bi bi-funnel me-1"></i>Filtrar
</button>
{% if search or current_module or current_action %}
<a href="/admin/audit_logs" class="btn btn-outline-secondary btn-sm" title="Limpiar filtros">
@@ -56,58 +91,188 @@
{% endif %}
</div>
</form>
<!-- Acceso Rápido por Categorías -->
<div class="d-flex flex-wrap gap-1 mt-3 pt-2 border-top">
<span class="text-muted small align-self-center me-2"><i class="bi bi-lightning-charge me-1"></i>Filtros rápidos:</span>
<a href="/admin/audit_logs?module=auth" class="badge rounded-pill text-decoration-none {% if current_module == 'auth' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-key me-1"></i>Sesiones y Accesos
</a>
<a href="/admin/audit_logs?action=LOGIN_FAILED" class="badge rounded-pill text-decoration-none {% if current_action == 'LOGIN_FAILED' %}bg-danger text-white{% else %}bg-light text-danger border{% endif %}">
<i class="bi bi-shield-x me-1"></i>Fallos de Login
</a>
<a href="/admin/audit_logs?module=reservations" class="badge rounded-pill text-decoration-none {% if current_module == 'reservations' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-calendar-event me-1"></i>Reservas
</a>
<a href="/admin/audit_logs?module=classrooms" class="badge rounded-pill text-decoration-none {% if current_module == 'classrooms' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-door-open me-1"></i>Aulas
</a>
<a href="/admin/audit_logs?module=buildings" class="badge rounded-pill text-decoration-none {% if current_module == 'buildings' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-building me-1"></i>Sedes
</a>
<a href="/admin/audit_logs?module=optimizer" class="badge rounded-pill text-decoration-none {% if current_module == 'optimizer' %}bg-primary text-white{% else %}bg-light text-dark border{% endif %}">
<i class="bi bi-cpu me-1"></i>Optimizador IA
</a>
</div>
</div>
</div>
<!-- Tabla de Auditoría -->
<div class="card border-0 shadow-sm">
<div class="card-body p-0">
{% if audit_logs %}
{% if audit_logs and audit_logs.length > 0 %}
<div class="table-responsive">
<table class="table table-hover align-middle mb-0">
<thead class="table-light small text-uppercase">
<tr>
<th class="ps-3">Fecha / Hora</th>
<th>Usuario</th>
<th>Acción</th>
<th>Módulo</th>
<th>ID Entidad</th>
<th>Detalles</th>
<th class="pe-3">IP</th>
<th class="ps-3" style="width: 170px;">Fecha / Hora</th>
<th style="min-width: 180px;">Usuario</th>
<th style="width: 160px;">Acción</th>
<th style="width: 130px;">Módulo</th>
<th style="width: 90px;">ID</th>
<th>Detalles de la Operación</th>
<th class="pe-3 text-end" style="width: 130px;">IP Origen</th>
</tr>
</thead>
<tbody>
{% for log in audit_logs %}
<tr>
<td class="ps-3 text-nowrap">
<span class="small font-monospace">{{ log.created_at }}</span>
<span class="small font-monospace text-dark fw-semibold">
{{ log.created_at or log.created_at_iso or '-' }}
</span>
</td>
<td>
<div class="fw-semibold small">{{ log.user_email or 'Sistema' }}</div>
<div class="d-flex align-items-center gap-2">
<div class="avatar-sm rounded-circle d-flex align-items-center justify-content-center small {% if 'FAILED' in log.action or 'BLOCKED' in log.action %}bg-danger-subtle text-danger{% elif 'LOGIN' in log.action %}bg-success-subtle text-success{% else %}bg-primary-subtle text-primary{% endif %}" style="width: 28px; height: 28px;">
{% if 'LOGIN' in log.action %}
<i class="bi bi-person-check"></i>
{% elif 'FAILED' in log.action %}
<i class="bi bi-person-x"></i>
{% elif 'IMPERSONATE' in log.action %}
<i class="bi bi-person-badge"></i>
{% else %}
<i class="bi bi-person"></i>
{% endif %}
</div>
<div>
<div class="fw-semibold small text-truncate" style="max-width: 200px;" title="{{ log.user_email or 'Sistema' }}">
{{ log.user_email or 'Sistema' }}
</div>
{% if log.user_id %}
<span class="text-muted" style="font-size: 0.75rem;">ID Usuario: #{{ log.user_id }}</span>
{% endif %}
</div>
</div>
</td>
<td>
{% if log.action == 'CREATE' %}
<span class="badge bg-success-subtle text-success border border-success-subtle">{{ log.action }}</span>
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
<i class="bi bi-plus-circle me-1"></i>ALTA
</span>
{% elif log.action == 'UPDATE' %}
<span class="badge bg-primary-subtle text-primary border border-primary-subtle">{{ log.action }}</span>
<span class="badge bg-primary-subtle text-primary border border-primary-subtle px-2 py-1">
<i class="bi bi-pencil-square me-1"></i>EDICIÓN
</span>
{% elif log.action == 'DELETE' %}
<span class="badge bg-danger-subtle text-danger border border-danger-subtle">{{ log.action }}</span>
{% elif 'LOGIN' in log.action %}
<span class="badge bg-info-subtle text-info border border-info-subtle">{{ log.action }}</span>
<span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
<i class="bi bi-trash me-1"></i>BAJA
</span>
{% elif log.action == 'CANCEL' %}
<span class="badge bg-warning-subtle text-warning-emphasis border border-warning-subtle px-2 py-1">
<i class="bi bi-dash-circle me-1"></i>CANCELACIÓN
</span>
{% elif log.action == 'CONFIRM' %}
<span class="badge bg-info-subtle text-info-emphasis border border-info-subtle px-2 py-1">
<i class="bi bi-check-circle me-1"></i>CONFIRMADA
</span>
{% elif log.action == 'TOGGLE' %}
<span class="badge bg-secondary-subtle text-secondary border px-2 py-1">
<i class="bi bi-toggle-on me-1"></i>ESTADO
</span>
{% elif log.action == 'LOGIN' %}
<span class="badge bg-success-subtle text-success border border-success-subtle px-2 py-1">
<i class="bi bi-box-arrow-in-right me-1"></i>LOGIN LOCAL
</span>
{% elif log.action == 'LOGIN_GOOGLE' %}
<span class="badge bg-info-subtle text-primary border border-info-subtle px-2 py-1">
<i class="bi bi-google me-1"></i>LOGIN GOOGLE
</span>
{% elif log.action == 'LOGIN_MOODLE' %}
<span class="badge bg-warning-subtle text-dark border border-warning-subtle px-2 py-1">
<i class="bi bi-mortarboard me-1"></i>LOGIN MOODLE
</span>
{% elif log.action == 'LOGIN_FAILED' %}
<span class="badge bg-danger text-white px-2 py-1">
<i class="bi bi-shield-x me-1"></i>LOGIN FALLIDO
</span>
{% elif log.action == 'LOGIN_BLOCKED' %}
<span class="badge bg-danger-subtle text-danger border border-danger-subtle px-2 py-1">
<i class="bi bi-slash-circle me-1"></i>BLOQUEADO
</span>
{% elif log.action == 'LOGOUT' %}
<span class="badge bg-secondary-subtle text-secondary border px-2 py-1">
<i class="bi bi-box-arrow-right me-1"></i>LOGOUT
</span>
{% elif log.action == 'PASSWORD_CHANGE' %}
<span class="badge bg-purple-subtle text-purple border px-2 py-1" style="background-color: #f3e8ff; color: #6b21a8;">
<i class="bi bi-key me-1"></i>CAMBIO CLAVE
</span>
{% elif log.action == 'IMPERSONATE_START' %}
<span class="badge bg-warning text-dark px-2 py-1">
<i class="bi bi-person-badge me-1"></i>IMPERSONACIÓN
</span>
{% elif log.action == 'IMPERSONATE_END' %}
<span class="badge bg-light text-dark border px-2 py-1">
<i class="bi bi-person-check me-1"></i>FIN IMPERSON.
</span>
{% elif log.action == 'OPTIMIZE_RUN' %}
<span class="badge bg-info text-white px-2 py-1">
<i class="bi bi-cpu me-1"></i>CORRIDA IA
</span>
{% elif log.action == 'OPTIMIZE_APPLY' %}
<span class="badge bg-success text-white px-2 py-1">
<i class="bi bi-magic me-1"></i>APLICACIÓN IA
</span>
{% elif log.action == 'SYSTEM_RESET' %}
<span class="badge bg-danger text-white px-2 py-1">
<i class="bi bi-arrow-counterclockwise me-1"></i>REINICIO SISTEMA
</span>
{% else %}
<span class="badge bg-secondary-subtle text-secondary border">{{ log.action }}</span>
<span class="badge bg-secondary-subtle text-secondary border px-2 py-1">{{ log.action }}</span>
{% endif %}
</td>
<td>
{% if log.module == 'auth' %}
<span class="badge bg-primary-subtle text-primary border font-monospace small">auth</span>
{% elif log.module == 'reservations' %}
<span class="badge bg-info-subtle text-info border font-monospace small">reservas</span>
{% elif log.module == 'classrooms' %}
<span class="badge bg-success-subtle text-success border font-monospace small">aulas</span>
{% elif log.module == 'buildings' %}
<span class="badge bg-warning-subtle text-dark border font-monospace small">sedes</span>
{% elif log.module == 'optimizer' %}
<span class="badge bg-dark text-white font-monospace small">optimizador</span>
{% else %}
<span class="badge bg-body-secondary text-body border font-monospace small">{{ log.module }}</span>
{% endif %}
</td>
<td class="font-monospace small text-muted">
{{ log.entity_id or '-' }}
</td>
<td class="small text-muted" style="max-width: 320px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;" title="{{ log.details }}">
<td>
<div class="d-flex align-items-center justify-content-between gap-2">
<div class="small text-muted text-truncate" style="max-width: 480px;" title="{{ log.details }}">
{{ log.details or '-' }}
</div>
{% if log.details and log.details.length > 50 %}
<button type="button" class="btn btn-link btn-sm p-0 text-decoration-none text-primary" onclick="showLogDetailModal('{{ log.id }}', '{{ log.action }}', '{{ log.module }}', '{{ log.user_email or 'Sistema' }}', '{{ log.created_at }}', '{{ log.ip_address }}', {{ log.details | dump | escape }})">
<i class="bi bi-eye"></i>
</button>
{% endif %}
</div>
</td>
<td class="pe-3 font-monospace small text-muted">
<td class="pe-3 text-end font-monospace small text-muted">
{{ log.ip_address or '-' }}
</td>
</tr>
@@ -116,31 +281,29 @@
</table>
</div>
<!-- Paginación -->
<!-- Paginación Dinámica -->
{% if pagination.pages > 1 %}
<div class="p-3 border-top d-flex justify-content-between align-items-center">
<div class="p-3 border-top d-flex justify-content-between align-items-center flex-wrap gap-2">
<small class="text-muted">
Mostrando página {{ pagination.page }} de {{ pagination.pages }} ({{ pagination.total }} registros)
Mostrando página {{ pagination.page }} de {{ pagination.pages }} (Total: <strong>{{ pagination.total }}</strong> eventos registrados)
</small>
<nav>
<nav aria-label="Navegación de auditoría">
<ul class="pagination pagination-sm mb-0">
<li class="page-item {% if not pagination.has_prev %}disabled{% endif %}">
<a class="page-link" href="/admin/audit_logs">
&laquo;
<a class="page-link" href="/admin/audit_logs?page={{ pagination.page - 1 }}{% if search %}&search={{ search }}{% endif %}{% if current_module %}&module={{ current_module }}{% endif %}{% if current_action %}&action={{ current_action }}{% endif %}">
&laquo; Anterior
</a>
</li>
{% for p in pagination.iter_pages(left_edge=2, left_current=2, right_current=3, right_edge=2) %}
{% if p %}
{% for p in pagination.pages_list %}
<li class="page-item {% if p == pagination.page %}active{% endif %}">
<a class="page-link" href="/admin/audit_logs">{{ p }}</a>
<a class="page-link" href="/admin/audit_logs?page={{ p }}{% if search %}&search={{ search }}{% endif %}{% if current_module %}&module={{ current_module }}{% endif %}{% if current_action %}&action={{ current_action }}{% endif %}">
{{ p }}
</a>
</li>
{% else %}
<li class="page-item disabled"><span class="page-link">…</span></li>
{% endif %}
{% endfor %}
<li class="page-item {% if not pagination.has_next %}disabled{% endif %}">
<a class="page-link" href="/admin/audit_logs">
&raquo;
<a class="page-link" href="/admin/audit_logs?page={{ pagination.page + 1 }}{% if search %}&search={{ search }}{% endif %}{% if current_module %}&module={{ current_module }}{% endif %}{% if current_action %}&action={{ current_action }}{% endif %}">
Siguiente &raquo;
</a>
</li>
</ul>
@@ -152,10 +315,92 @@
<div class="text-center py-5">
<i class="bi bi-shield-slash text-muted fs-1 d-block mb-2"></i>
<h6 class="fw-bold">No se encontraron registros de auditoría</h6>
<p class="text-muted small">Los eventos del sistema se registrarán automáticamente a medida que ocurran cambios.</p>
<p class="text-muted small">Los eventos de inicio de sesión y modificaciones de espacios áulicos se registrarán automáticamente a medida que ocurran.</p>
{% if search or current_module or current_action %}
<a href="/admin/audit_logs" class="btn btn-outline-primary btn-sm mt-2">
<i class="bi bi-x-circle me-1"></i>Limpiar filtros de búsqueda
</a>
{% endif %}
</div>
{% endif %}
</div>
</div>
</div>
<!-- Modal de Detalle Extendido -->
<div class="modal fade" id="logDetailModal" tabindex="-1" aria-labelledby="logDetailModalLabel" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered modal-lg">
<div class="modal-content">
<div class="modal-header">
<h5 class="modal-title" id="logDetailModalLabel">
<i class="bi bi-info-circle text-primary me-2"></i>Detalle del Registro de Auditoría
</h5>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Cerrar"></button>
</div>
<div class="modal-body">
<div class="row g-2 mb-3 small">
<div class="col-sm-6">
<span class="text-muted">Fecha y Hora:</span>
<div class="fw-semibold font-monospace" id="modalLogTime">-</div>
</div>
<div class="col-sm-6">
<span class="text-muted">Usuario Actuante:</span>
<div class="fw-semibold" id="modalLogUser">-</div>
</div>
<div class="col-sm-4">
<span class="text-muted">Acción:</span>
<div class="fw-semibold" id="modalLogAction">-</div>
</div>
<div class="col-sm-4">
<span class="text-muted">Módulo:</span>
<div class="fw-semibold" id="modalLogModule">-</div>
</div>
<div class="col-sm-4">
<span class="text-muted">IP de Conexión:</span>
<div class="fw-semibold font-monospace" id="modalLogIp">-</div>
</div>
</div>
<div>
<label class="form-label small fw-semibold text-muted">Contenido del Evento / Payload:</label>
<pre class="bg-light p-3 rounded border font-monospace small mb-0" id="modalLogDetails" style="max-height: 300px; overflow-y: auto; white-space: pre-wrap; word-break: break-word;"></pre>
</div>
</div>
<div class="modal-footer">
<button type="button" class="btn btn-outline-secondary btn-sm" onclick="copyModalDetails()">
<i class="bi bi-clipboard me-1"></i>Copiar Detalle
</button>
<button type="button" class="btn btn-secondary btn-sm" data-bs-dismiss="modal">Cerrar</button>
</div>
</div>
</div>
</div>
<script>
function showLogDetailModal(id, action, module, user, time, ip, details) {
document.getElementById('modalLogTime').textContent = time || '-';
document.getElementById('modalLogUser').textContent = user || 'Sistema';
document.getElementById('modalLogAction').textContent = action || '-';
document.getElementById('modalLogModule').textContent = module || '-';
document.getElementById('modalLogIp').textContent = ip || '-';
let formatted = details || '';
try {
const parsed = JSON.parse(details);
formatted = JSON.stringify(parsed, null, 2);
} catch(e) {
// es texto plano
}
document.getElementById('modalLogDetails').textContent = formatted;
const modal = new bootstrap.Modal(document.getElementById('logDetailModal'));
modal.show();
}
function copyModalDetails() {
const text = document.getElementById('modalLogDetails').textContent;
navigator.clipboard.writeText(text).then(() => {
alert('Detalle copiado al portapapeles.');
});
}
</script>
{% endblock %}
+1 -1
View File
@@ -1127,7 +1127,7 @@
<div class="sidebar-footer-text mt-3 pt-2 border-top border-secondary-subtle text-center">
<span class="badge bg-secondary-subtle text-secondary-emphasis font-monospace px-2 py-1" style="font-size:0.68rem;" title="Versión Institucional de Edu-Space">
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.4.7' }} <span class="opacity-75">(FE: {{ frontend_version or '3.4.7' }} · BE: {{ backend_version or '3.4.7' }})</span>
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.4.8' }} <span class="opacity-75">(FE: {{ frontend_version or '3.4.8' }} · BE: {{ backend_version or '3.4.8' }})</span>
</span>
</div>
</div>