fix(udeci): fix frontend DTO field mapping (response/quick_options) and enable dual DTO compatibility (v3.8.38)

This commit is contained in:
2026-10-27 22:58:56 -03:00
parent bd88dfdd19
commit e45eb972dd
9 changed files with 54 additions and 31 deletions
+8
View File
@@ -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. - **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. - **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 ## [3.8.37] - 2026-10-27
### Removed & Cleaned (Simplificación Minimalista del Chatbot UdeCi) ### Removed & Cleaned (Simplificación Minimalista del Chatbot UdeCi)
- **Eliminación del Cajón de Consultas Rápidas (`#aiChatQuickChips`)**: - **Eliminación del Cajón de Consultas Rápidas (`#aiChatQuickChips`)**:
+4 -4
View File
@@ -9,10 +9,10 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - 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. - 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)**: - **Sprint Activo: Resiliencia de Respuestas y Corrección DTO de UdeCi — SDD-011 (v3.8.38)**:
- **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. - **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.
- **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`. - **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.37`. - **Versión Consolidada**: `v3.8.38`.
## Decisiones (y por qué) ## 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. - **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.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session from database import db, get_db, engine, SessionLocal, session
from config.config import Config from config.config import Config
__version__ = "3.8.37" __version__ = "3.8.38"
class DummyContext: class DummyContext:
def __enter__(self): def __enter__(self):
+8 -3
View File
@@ -258,11 +258,14 @@ async def get_agent_response(
is_safe, defense_reply = PromptSecurityService.validate_user_message(last_query) is_safe, defense_reply = PromptSecurityService.validate_user_message(last_query)
if not is_safe: if not is_safe:
safe_msg = defense_reply or "Consulta no permitida por políticas de seguridad."
return ChatResponse( return ChatResponse(
response=defense_reply or "Consulta no permitida por políticas de seguridad.", response=safe_msg,
quick_options=[], quick_options=[],
conversation_id=user_identifier, conversation_id=user_identifier,
guide_step=None guide_step=None,
reply=safe_msg,
options=[]
) )
resolved_user_id = request.user_id resolved_user_id = request.user_id
@@ -322,7 +325,9 @@ async def get_agent_response(
response=clean_reply, response=clean_reply,
quick_options=options, quick_options=options,
conversation_id=user_identifier, conversation_id=user_identifier,
guide_step=guide_step guide_step=guide_step,
reply=clean_reply,
options=options
) )
except httpx.TimeoutException: except httpx.TimeoutException:
raise HTTPException( raise HTTPException(
+2
View File
@@ -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") 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") 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") 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): class RAGReindexResponse(BaseModel):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="3.8.37", version="3.8.38",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.8.37", "version": "3.8.38",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+26 -18
View File
@@ -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) { async function sendQuery(queryText) {
if (!queryText || isProcessing) return; if (!queryText || isProcessing) return;
@@ -310,9 +329,14 @@
} }
const data = await res.json(); const data = await res.json();
const reply = data.reply || "Disculpa, no pude procesar tu solicitud en este momento."; const reply = data.response || data.reply || "Disculpa, no pude procesar tu solicitud en este momento.";
const options = Array.isArray(data.options) ? data.options : []; const options = Array.isArray(data.quick_options) ? data.quick_options : (Array.isArray(data.options) ? data.options : []);
appendMessage('assistant', reply, options, true); appendMessage('assistant', reply, options, true);
if (data.guide_step && window.WalkthroughEngine) {
closeChat();
window.WalkthroughEngine.startStep(data.guide_step);
}
} catch (err) { } catch (err) {
console.error("[UdeCi Widget] Error al consultar API:", 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); 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); }, 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 // Toggle panel
launcher.addEventListener('click', () => { launcher.addEventListener('click', () => {
const isHidden = panel.classList.contains('d-none'); const isHidden = panel.classList.contains('d-none');
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.8.37'; const APP_VERSION = '3.8.38';
const FRONTEND_VERSION = '3.8.37'; const FRONTEND_VERSION = '3.8.38';
const BACKEND_VERSION = '3.8.37'; const BACKEND_VERSION = '3.8.38';
env.addGlobal('app_version', APP_VERSION); env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);