diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b423ea..5c1fedc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,19 @@ 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.9] - 2026-10-09 +### Corregido & Mejorado (Importador de Google Sheets & Sistema de Diagnóstico de Incidentes) +- **Corrección de Límite de Payload en Importación Masiva de Google Sheets (`PayloadTooLargeError`):** + - Ajuste de los analizadores de cuerpo en el Frontend BFF Express (`express.json({ limit: '50mb' })` y `express.urlencoded({ extended: true, limit: '50mb' })`), resolviendo el error 500 al enviar matrices de filas preseleccionadas (~154 KB que excedían el límite por defecto de 100 KB). +- **Sistema Institucional de Manejo de Incidentes y Diagnóstico Transparente:** + - Reemplazo de la pantalla genérica de error por una interfaz estructurada con código de ticket único (`INC-YYYYMMDD-XXXX`), código HTTP, síntesis contextual y recomendación de acción correctiva. + - Sección técnica colapsable de diagnóstico con Ruta, Marca de Tiempo, Usuario activo, IP del cliente y Stack Trace. + - Botón "Copiar Reporte para Soporte" con formateo estándar para agilizar la asistencia técnica por Bedelía o Soporte IT. + - Registro automático del incidente técnico en `AuditLog` (`action='SYSTEM_ERROR'`, `module='system'`) vía nuevo endpoint `/api/v1/admin/log-error`. +- **Auditoría Integral de Sincronización de Hojas de Cálculo (`/api/v1/dashboard/sync-sheets`):** + - Registro de eventos exitosos (`SHEETS_IMPORT`) con estadísticas de entidades procesadas (carreras, materias, comisiones, aulas, reservas) y filtros aplicados. + - Registro de errores de sincronización (`SHEETS_IMPORT_ERROR`) con detalle de la excepción para trazabilidad en la bitácora institucional. + ## [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/`):** diff --git a/MEMORY.md b/MEMORY.md index 491c00f..795ea5d 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -169,6 +169,15 @@ Memoria del proyecto entre sesiones para la rama `dev`. - **Bump Semántico y Despliegue Obligatorio (Principio 9)**: - Versión incrementada a `v3.4.8` en Frontend y Backend. +- **Sprint v3.4.9: Solución de Límite de Payload en Importador de Sheets & Diagnóstico Transparente de Incidentes**: + - **Incidencias y Mejoras**: + 1. `frontend/src/app.js`: Elevado límite de `express.json` y `express.urlencoded` de 100 KB por defecto a 50 MB (`{ limit: '50mb' }`), resolviendo el error `PayloadTooLargeError: request entity too large: expected 154166, length 154166, limit 102400` que provocaba HTTP 500 al enviar la matriz de filas preseleccionadas en `/admin/google_sheets_import`. + 2. Manejo de Incidentes y Diagnóstico Transparente: Reemplazo total de la pantalla genérica de error por una interfaz estructurada con código de ticket único (`INC-YYYYMMDD-XXXX`), diagnóstico descriptivo clasificado, sección técnica de diagnóstico colapsable (Ruta, Timestamp, Usuario actuante, IP, Stack trace), botón para copiar reporte a soporte IT y enlace directo a la Auditoría Institucional. + 3. `backend/app/routes/api/admin.py`: Nuevo endpoint `/api/v1/admin/log-error` para registrar incidentes técnicos no controlados del frontend directamente en `AuditLog` (`action='SYSTEM_ERROR'`, `module='system'`). + 4. `backend/app/routes/api/dashboard.py`: Instrumentada auditoría completa en `sync_google_sheets` para registrar tanto importaciones exitosas (`SHEETS_IMPORT`) como fallos (`SHEETS_IMPORT_ERROR`) con desglose de estadísticas y excepciones. + - **Bump Semántico y Despliegue Obligatorio (Principio 9)**: + - Versión incrementada a `v3.4.9` 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. Monitoreo continuo de la experiencia de usuario en Bedelía, Cartelera del Día y Sincronización Académica. \ No newline at end of file diff --git a/ROADMAP.md b/ROADMAP.md index e5ec164..b088dc1 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,7 +2,7 @@ ## 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.8 (Registro de Auditoría Institucional y Trazabilidad Operativa) +**Versión:** 3.4.9 (Importador de Google Sheets Robusto & Diagnóstico Transparente de Incidentes) **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 67a07a4..8b46725 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.8" +__version__ = "3.4.9" db = SQLAlchemy() migrate = Migrate() cors = CORS() diff --git a/backend/app/routes/api/admin.py b/backend/app/routes/api/admin.py index d90d43d..58703ba 100644 --- a/backend/app/routes/api/admin.py +++ b/backend/app/routes/api/admin.py @@ -2872,7 +2872,7 @@ def get_audit_logs(): 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'] + default_modules = ['auth', 'reservations', 'classrooms', 'buildings', 'academic', 'optimizer', 'users', 'admin', 'system', 'import'] for m in default_modules: if m not in modules: modules.append(m) @@ -2881,7 +2881,8 @@ def get_audit_logs(): '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' + 'OPTIMIZE_RUN', 'OPTIMIZE_APPLY', 'SYSTEM_RESET', 'SYSTEM_ERROR', + 'SHEETS_IMPORT', 'SHEETS_IMPORT_ERROR' ] for a in default_actions: if a not in actions: @@ -2906,3 +2907,51 @@ def get_audit_logs(): }), 200 +@api_admin_bp.route('/log-error', methods=['POST']) +def log_system_error(): + """ + Endpoint para registrar incidentes técnicos o errores no controlados + provenientes del frontend BFF o subsistemas en AuditLog. + """ + try: + data = request.get_json(silent=True) or {} + incident_id = data.get('incident_id') + error_title = data.get('error_title', 'Error de Sistema') + error_message = data.get('error_message', 'Error desconocido') + status_code = data.get('status_code', 500) + path = data.get('path', '') + user_email = data.get('user_email') or 'anonymous' + ip_address = data.get('ip_address') or request.remote_addr + stack = data.get('stack', '') + + details = { + 'incident_id': incident_id, + 'title': error_title, + 'message': error_message, + 'status_code': status_code, + 'path': path, + 'stack_preview': stack[:500] if stack else '' + } + + AuditService.log( + action='SYSTEM_ERROR', + module='system', + user_email=user_email, + ip_address=ip_address, + details=details, + status='failed' + ) + + return jsonify({ + 'status': 'success', + 'logged': True, + 'incident_id': incident_id + }), 200 + except Exception as e: + return jsonify({ + 'status': 'error', + 'message': str(e) + }), 500 + + + diff --git a/backend/app/routes/api/dashboard.py b/backend/app/routes/api/dashboard.py index ef0e8f1..1bbf27e 100644 --- a/backend/app/routes/api/dashboard.py +++ b/backend/app/routes/api/dashboard.py @@ -1,10 +1,11 @@ -from flask import Blueprint, jsonify, request +from flask import Blueprint, jsonify, request, g from app.utils.jwt_decorators import jwt_required from app.models.classroom import Classroom from app.models.subject import Subject from app.models.user import User from app.models.reservation import Reservation from app.models.audit_log import AuditLog +from app.services.audit_service import AuditService from datetime import datetime, timedelta from sqlalchemy import func from app import db @@ -630,12 +631,47 @@ def sync_google_sheets(): import_reservations=import_reservations, selected_rows=selected_rows ) + + user_info = getattr(g, 'current_user', {}) or {} + user_email = user_info.get('email') if isinstance(user_info, dict) else getattr(user_info, 'email', None) + AuditService.log( + action='SHEETS_IMPORT', + module='import', + user_email=user_email, + ip_address=request.remote_addr, + details={ + 'stats': stats, + 'filter_career': filter_career, + 'filter_subject': filter_subject, + 'filter_day': filter_day, + 'filter_days': filter_days, + 'single_date_only': single_date_only, + 'manual_date': manual_date + }, + status='success' + ) + return jsonify({ 'status': 'success', 'stats': stats, 'source_url': importer.base_url }), 200 except Exception as e: + user_info = getattr(g, 'current_user', {}) or {} + user_email = user_info.get('email') if isinstance(user_info, dict) else getattr(user_info, 'email', None) + AuditService.log( + action='SHEETS_IMPORT_ERROR', + module='import', + user_email=user_email, + ip_address=request.remote_addr, + details={ + 'error': str(e), + 'filter_career': filter_career, + 'filter_subject': filter_subject, + 'filter_day': filter_day + }, + status='failed' + ) return jsonify({ 'status': 'error', 'message': str(e) diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 7dfeaa7..9bbab70 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.8" + "version": "3.4.9" }, "servers": [ { diff --git a/backend/setup.py b/backend/setup.py index e039158..1684ddb 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.8", + version="3.4.9", description="Administrative interface for Edu-Space Classroom Management System", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/frontend/package.json b/frontend/package.json index 7d663b8..d25979e 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.4.8", + "version": "3.4.9", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 91899f4..995ac01 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -68,9 +68,9 @@ app.post('/auth/login', authLimiter); app.post('/auth/moodle', authLimiter); app.use('/api', generalLimiter); -// Configuración de middlewares -app.use(express.json()); -app.use(express.urlencoded({ extended: true })); +// Configuración de middlewares con soporte para importaciones masivas y payloads extensos +app.use(express.json({ limit: '50mb' })); +app.use(express.urlencoded({ extended: true, limit: '50mb' })); app.use(cookieParser()); // Configuración de archivos estáticos @@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.4.8'; -const FRONTEND_VERSION = '3.4.8'; -const BACKEND_VERSION = '3.4.8'; +const APP_VERSION = '3.4.9'; +const FRONTEND_VERSION = '3.4.9'; +const BACKEND_VERSION = '3.4.9'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); @@ -587,37 +587,215 @@ app.use((req, res) => { `); }); -// Middleware Global de Error 500 -app.use((err, req, res, next) => { - console.error('Error no capturado en BFF:', err); - res.status(500).send(` +// Middleware Global de Error 500 & Diagnóstico Institucional +app.use(async (err, req, res, next) => { + const incidentId = 'INC-' + new Date().toISOString().slice(0, 10).replace(/-/g, '') + '-' + Math.random().toString(36).substring(2, 7).toUpperCase(); + const timestampStr = new Date().toLocaleString('es-AR', { timeZone: 'America/Argentina/Buenos_Aires' }); + const userEmail = req.user?.email || (req.cookies?.refresh_token ? 'Usuario con sesión activa' : 'No autenticado'); + const reqPath = `${req.method} ${req.originalUrl || req.url}`; + const clientIp = req.headers['x-forwarded-for'] || req.ip || req.socket?.remoteAddress || '-'; + + console.error(`[BFF Error ${incidentId}] en ${reqPath}:`, err); + + // Clasificación y mensaje amigable + let statusCode = err.status || err.statusCode || 500; + let errorTitle = 'Eventualidad en la Aplicación'; + let errorSummary = 'Ocurrió un error inesperado al procesar la operación solicitada.'; + let errorResolution = 'Por favor intente nuevamente o comuníquese con Soporte / Bedelía indicando el código de incidente.'; + + if (err.type === 'entity.too.large' || statusCode === 413) { + statusCode = 413; + errorTitle = 'Tamaño de Datos Excedido (Payload Too Large)'; + const lengthKb = err.length ? (err.length / 1024).toFixed(1) + ' KB' : 'desconocido'; + const limitKb = err.limit ? (err.limit / 1024).toFixed(1) + ' KB' : 'desconocido'; + errorSummary = `El volumen de datos enviado (${lengthKb}) superó la capacidad de recepción configurada (${limitKb}).`; + errorResolution = 'Si está importando planillas masivas de Google Sheets, aplique filtros por día o carrera, o solicite a Soporte que amplíe el límite de transferencia.'; + } else if (err.code === 'ECONNREFUSED' || err.code === 'ETIMEDOUT') { + statusCode = 503; + errorTitle = 'Fallo de Comunicación con Backend Core'; + errorSummary = 'No fue posible conectarse con la API central de Edu-Space en el puerto 5000.'; + errorResolution = 'El servicio backend podría estar reiniciándose o en mantenimiento. Aguarde unos segundos y vuelva a intentar.'; + } else if (err.response && err.response.data) { + errorTitle = `Respuesta del Servidor Central (${err.response.status})`; + errorSummary = err.response.data.message || err.response.data.error || err.message; + errorResolution = 'Revise los parámetros ingresados o consulte el registro de auditoría si posee permisos de administrador.'; + } else if (err.message) { + errorSummary = err.message; + } + + // Registro asíncrono no bloqueante en AuditLog del backend + try { + const backendBase = process.env.BACKEND_URL || 'http://localhost:5000/api/v1'; + axios.post(`${backendBase}/admin/log-error`, { + incident_id: incidentId, + error_title: errorTitle, + error_message: err.message || errorSummary, + status_code: statusCode, + path: reqPath, + user_email: userEmail, + ip_address: clientIp, + stack: err.stack ? err.stack.slice(0, 1000) : null + }, { timeout: 3000 }).catch(() => {}); + } catch (_) {} + + // Si la petición espera JSON, responder en JSON estructurado + if (req.xhr || (req.headers.accept && req.headers.accept.includes('application/json'))) { + return res.status(statusCode).json({ + status: 'error', + incident_id: incidentId, + title: errorTitle, + message: errorSummary, + resolution: errorResolution, + path: reqPath, + timestamp: timestampStr + }); + } + + // Renderizar pantalla institucional de diagnóstico + res.status(statusCode).send(` - Error del Sistema — Edu-Space + + Error del Sistema — Edu-Space UniCABA -
-
-
- +
+ +
+
+ Edu-Space + UniCABA
-

Error en la Aplicación

-

- Ocurrió una eventualidad procesando la solicitud. Nuestro equipo técnico ha sido notificado. +

+ + ${incidentId} + +
+
+ + +
+
+ + + +
+
+ HTTP ${statusCode} +

${errorTitle}

+
+

+ ${errorSummary}

- - Volver al Panel - +

+ Acción recomendada: ${errorResolution} +

+
+ + +
+
+

+ +

+
+
+
+
+ Ruta / Solicitud: +
${reqPath}
+
+
+ Fecha y Hora: +
${timestampStr}
+
+
+ Usuario Actuante: +
${userEmail}
+
+
+ Dirección IP: +
${clientIp}
+
+
+ +
${(err.stack || err.message || 'Sin traza disponible').replace(//g, '>')}
+
+
+
+
+ + +
+
+ + + Ver Auditoría + +
+
+ + + + Panel Principal + +
+ + + `); diff --git a/frontend/views/base.html b/frontend/views/base.html index 2e9b6a8..c0ec882 100644 --- a/frontend/views/base.html +++ b/frontend/views/base.html @@ -1127,7 +1127,7 @@