From e45eb972ddeb336853e542e0feffea47296bb729 Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Tue, 27 Oct 2026 22:58:56 -0300 Subject: [PATCH] fix(udeci): fix frontend DTO field mapping (response/quick_options) and enable dual DTO compatibility (v3.8.38) --- CHANGELOG.md | 8 +++++ MEMORY.md | 8 ++--- backend/app/__init__.py | 2 +- backend/routers/ai_chat.py | 11 +++++-- backend/schemas/ai_chat.py | 2 ++ backend/setup.py | 2 +- frontend/package.json | 2 +- frontend/public/js/ai-chat-widget.js | 44 ++++++++++++++++------------ frontend/src/app.js | 6 ++-- 9 files changed, 54 insertions(+), 31 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index b905ddf..08b6b0b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,14 @@ 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.8.38] - 2026-10-27 +### Fixed & Improved (Resiliencia de Respuesta de UdeCi y Compatibilidad Dual DTO) +- **Corrección de Mapeo de Respuestas en Frontend (`response` vs `reply`)**: + - Se corrigió el desacople entre el esquema del backend (`ChatResponse.response`, `ChatResponse.quick_options`) y el cliente JavaScript (`ai-chat-widget.js`), el cual provocaba que consultas válidas y fluidas (como *"tu dime ?"*) cayeran en el mensaje de error por defecto (*"Disculpa, no pude procesar tu solicitud en este momento."*) a pesar de que el backend respondía con éxito (HTTP 200). + - Se implementó compatibilidad dual tanto en frontend (`data.response || data.reply`) como en el backend (`reply` y `options` como alias directos en `ChatResponse`). +- **Integración Nativa de Spotlight / Walkthrough**: + - Se conectó `data.guide_step` con `WalkthroughEngine.startStep()` para cerrar o minimizar el modal de UdeCi y resaltar interactivamente el botón o menú correspondiente. + ## [3.8.37] - 2026-10-27 ### Removed & Cleaned (Simplificación Minimalista del Chatbot UdeCi) - **Eliminación del Cajón de Consultas Rápidas (`#aiChatQuickChips`)**: diff --git a/MEMORY.md b/MEMORY.md index 5777704..afe1281 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,10 +9,10 @@ Memoria del proyecto entre sesiones para la rama `dev`. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - Reinicialización segura del sistema con contraseña de Administrador. -- **Sprint Activo: Simplificación Minimalista de UdeCi Estilo Mercado Libre — SDD-011 (v3.8.37)**: - - **Eliminación del Cajón de Chips**: Se removió el bloque `#aiChatQuickChips` y el botón de sliders en el header, despejando la vista para una conversación limpia. - - **Experiencia Bottom Sheet Nativa**: Ocupación del 92% de la pantalla (`92dvh`), con drag handle superior para cerrar deslizando hacia abajo, botón de retroceso `<`, header con ícono sparkle, y dock de entrada anclado al teclado virtual con `visualViewport`. - - **Versión Consolidada**: `v3.8.37`. +- **Sprint Activo: Resiliencia de Respuestas y Corrección DTO de UdeCi — SDD-011 (v3.8.38)**: + - **Corrección de Mapeo de Atributos DTO**: Se corrigió el desacople de nombres de campo entre el frontend (`ai-chat-widget.js`) y el backend (`ChatResponse`), asegurando que las respuestas factualmente válidas del motor de IA (`response`, `quick_options`) se muestren fluidamente y no caigan en el texto de fallo por defecto. + - **Dual DTO & Spotlight Integration**: Soporte en backend de alias `reply` y `options`, e integración de `guide_step` con `WalkthroughEngine.startStep()`. + - **Versión Consolidada**: `v3.8.38`. ## Decisiones (y por qué) - **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 4b3583f..273c203 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -7,7 +7,7 @@ from typing import Any from database import db, get_db, engine, SessionLocal, session from config.config import Config -__version__ = "3.8.37" +__version__ = "3.8.38" class DummyContext: def __enter__(self): diff --git a/backend/routers/ai_chat.py b/backend/routers/ai_chat.py index 8be362e..7daa4b8 100644 --- a/backend/routers/ai_chat.py +++ b/backend/routers/ai_chat.py @@ -258,11 +258,14 @@ async def get_agent_response( is_safe, defense_reply = PromptSecurityService.validate_user_message(last_query) if not is_safe: + safe_msg = defense_reply or "Consulta no permitida por políticas de seguridad." return ChatResponse( - response=defense_reply or "Consulta no permitida por políticas de seguridad.", + response=safe_msg, quick_options=[], conversation_id=user_identifier, - guide_step=None + guide_step=None, + reply=safe_msg, + options=[] ) resolved_user_id = request.user_id @@ -322,7 +325,9 @@ async def get_agent_response( response=clean_reply, quick_options=options, conversation_id=user_identifier, - guide_step=guide_step + guide_step=guide_step, + reply=clean_reply, + options=options ) except httpx.TimeoutException: raise HTTPException( diff --git a/backend/schemas/ai_chat.py b/backend/schemas/ai_chat.py index aba90e7..8d298f8 100644 --- a/backend/schemas/ai_chat.py +++ b/backend/schemas/ai_chat.py @@ -31,6 +31,8 @@ class ChatResponse(BaseModel): quick_options: Optional[List[str]] = Field(default_factory=list, description="Lista de opciones o preguntas sugeridas para botones interactivos") conversation_id: Optional[str] = Field(None, description="Identificador único de conversación o sesión del usuario") guide_step: Optional[GuideStepDTO] = Field(None, description="Directiva de Spotlight interactivo para guiar al usuario e iluminar elementos") + reply: Optional[str] = Field(None, description="Alias de response para compatibilidad con el frontend") + options: Optional[List[str]] = Field(default_factory=list, description="Alias de quick_options para compatibilidad con el frontend") class RAGReindexResponse(BaseModel): diff --git a/backend/setup.py b/backend/setup.py index d0b20f8..b4c73fe 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.8.37", + version="3.8.38", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/frontend/package.json b/frontend/package.json index 2177507..ffd4cd7 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.37", + "version": "3.8.38", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/public/js/ai-chat-widget.js b/frontend/public/js/ai-chat-widget.js index 85ee315..5d7e703 100644 --- a/frontend/public/js/ai-chat-widget.js +++ b/frontend/public/js/ai-chat-widget.js @@ -265,6 +265,25 @@ } } + function closeChat() { + const panel = document.getElementById('aiChatPanel'); + const backdrop = document.getElementById('aiChatBackdrop'); + const launcher = document.getElementById('aiChatLauncher'); + if (panel) { + panel.classList.add('d-none'); + panel.style.transform = ''; + panel.style.height = ''; + panel.style.bottom = ''; + } + if (backdrop) backdrop.classList.add('d-none'); + if (launcher) launcher.classList.remove('chat-open'); + document.body.classList.remove('ai-chat-mobile-open'); + + if ('speechSynthesis' in window && window.speechSynthesis.speaking) { + window.speechSynthesis.cancel(); + } + } + async function sendQuery(queryText) { if (!queryText || isProcessing) return; @@ -310,9 +329,14 @@ } const data = await res.json(); - const reply = data.reply || "Disculpa, no pude procesar tu solicitud en este momento."; - const options = Array.isArray(data.options) ? data.options : []; + const reply = data.response || data.reply || "Disculpa, no pude procesar tu solicitud en este momento."; + const options = Array.isArray(data.quick_options) ? data.quick_options : (Array.isArray(data.options) ? data.options : []); appendMessage('assistant', reply, options, true); + + if (data.guide_step && window.WalkthroughEngine) { + closeChat(); + window.WalkthroughEngine.startStep(data.guide_step); + } } catch (err) { console.error("[UdeCi Widget] Error al consultar API:", err); appendMessage('assistant', "Hubo una interrupción en la conexión con el tutor inteligente. Por favor, verifica tu conexión o intenta nuevamente en unos instantes.", [], true); @@ -356,22 +380,6 @@ }, 100); } - function closeChat() { - panel.classList.add('d-none'); - if (backdrop) backdrop.classList.add('d-none'); - launcher.classList.remove('chat-open'); - document.body.classList.remove('ai-chat-mobile-open'); - - if ('speechSynthesis' in window && window.speechSynthesis.speaking) { - window.speechSynthesis.cancel(); - } - - // Restaurar transform o estilos modificados por gestos - panel.style.transform = ''; - panel.style.height = ''; - panel.style.bottom = ''; - } - // Toggle panel launcher.addEventListener('click', () => { const isHidden = panel.classList.contains('d-none'); diff --git a/frontend/src/app.js b/frontend/src/app.js index a717439..813dab2 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.8.37'; -const FRONTEND_VERSION = '3.8.37'; -const BACKEND_VERSION = '3.8.37'; +const APP_VERSION = '3.8.38'; +const FRONTEND_VERSION = '3.8.38'; +const BACKEND_VERSION = '3.8.38'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);