fix(udeci): fix frontend DTO field mapping (response/quick_options) and enable dual DTO compatibility (v3.8.38)
This commit is contained in:
@@ -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`)**:
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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):
|
||||
|
||||
@@ -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(
|
||||
|
||||
@@ -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
@@ -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,6 +1,6 @@
|
||||
{
|
||||
"name": "frontend",
|
||||
"version": "3.8.37",
|
||||
"version": "3.8.38",
|
||||
"description": "",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
|
||||
@@ -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
@@ -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);
|
||||
|
||||
Reference in New Issue
Block a user