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.
|
- **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`)**:
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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):
|
||||||
|
|||||||
@@ -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(
|
||||||
|
|||||||
@@ -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
@@ -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,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": {
|
||||||
|
|||||||
@@ -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
@@ -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);
|
||||||
|
|||||||
Reference in New Issue
Block a user