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.
- **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`)**:
+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.
- 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.
+1 -1
View File
@@ -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):
+8 -3
View File
@@ -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(
+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")
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):
+1 -1
View File
@@ -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",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.37",
"version": "3.8.38",
"description": "",
"main": "index.js",
"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) {
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');
+3 -3
View File
@@ -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);