feat: servidor mcp institucional y asistente interactivo guiado con spotlight didactico (SDD-011, v3.8.27)
This commit is contained in:
@@ -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.26"
|
||||
__version__ = "3.8.27"
|
||||
|
||||
class DummyContext:
|
||||
def __enter__(self):
|
||||
|
||||
@@ -0,0 +1,85 @@
|
||||
"""
|
||||
app/services/guide_service.py - Servicio de Guías Interactivas y Spotlight para UdeCi (SDD-011)
|
||||
Detecta intenciones de tutorial paso a paso y emite directivas estructuradas
|
||||
para que el frontend ilumine los botones y campos interactivos ("enseñar a pescar").
|
||||
"""
|
||||
import re
|
||||
import unicodedata
|
||||
from typing import Optional
|
||||
from schemas.ai_chat import GuideStepDTO
|
||||
from mcp_server import STEP_GUIDES
|
||||
|
||||
|
||||
def _normalize(text: str) -> str:
|
||||
"""Elimina acentos y pasa a minúsculas para matching semántico tolerante."""
|
||||
nfkd = unicodedata.normalize('NFKD', text)
|
||||
return ''.join([c for c in nfkd if not unicodedata.combining(c)]).lower()
|
||||
|
||||
|
||||
class GuideService:
|
||||
"""Servicio de resolución de pasos y directivas de UI para el asistente UdeCi."""
|
||||
|
||||
@classmethod
|
||||
def detect_guide_step(cls, query: str, user_role: str = "alumno") -> Optional[GuideStepDTO]:
|
||||
"""
|
||||
Analiza la consulta del usuario y retorna el primer paso interactivo
|
||||
si el usuario solicita aprender a realizar una acción en el sistema.
|
||||
"""
|
||||
if not query:
|
||||
return None
|
||||
|
||||
q = _normalize(query)
|
||||
|
||||
# Acción: Crear Aula
|
||||
if "aula" in q and ("crear" in q or "nueva" in q or "nuevo" in q or "alta" in q or "como" in q or "registrar" in q):
|
||||
guide = STEP_GUIDES["crear_aula"]
|
||||
step1 = guide["steps"][0]
|
||||
return GuideStepDTO(
|
||||
target_url=guide["target_url"],
|
||||
selector=step1["selector"],
|
||||
message=step1["message"],
|
||||
expected_action=step1["expected_action"],
|
||||
step_number=1,
|
||||
total_steps=len(guide["steps"])
|
||||
)
|
||||
|
||||
# Acción: Crear Sede
|
||||
if ("sede" in q or "edificio" in q) and ("crear" in q or "nueva" in q or "nuevo" in q or "alta" in q or "registrar" in q or "como" in q):
|
||||
guide = STEP_GUIDES["crear_sede"]
|
||||
step1 = guide["steps"][0]
|
||||
return GuideStepDTO(
|
||||
target_url=guide["target_url"],
|
||||
selector=step1["selector"],
|
||||
message=step1["message"],
|
||||
expected_action=step1["expected_action"],
|
||||
step_number=1,
|
||||
total_steps=len(guide["steps"])
|
||||
)
|
||||
|
||||
# Acción: Crear Ciclo Lectivo
|
||||
if ("ciclo" in q or "periodo" in q) and ("crear" in q or "nuevo" in q or "alta" in q or "como" in q or "registrar" in q):
|
||||
guide = STEP_GUIDES["crear_ciclo"]
|
||||
step1 = guide["steps"][0]
|
||||
return GuideStepDTO(
|
||||
target_url=guide["target_url"],
|
||||
selector=step1["selector"],
|
||||
message=step1["message"],
|
||||
expected_action=step1["expected_action"],
|
||||
step_number=1,
|
||||
total_steps=len(guide["steps"])
|
||||
)
|
||||
|
||||
# Acción: Consultar Cursada de Hoy (para Alumnos / Docentes)
|
||||
if ("donde curso" in q or "aula de cursada" in q or "clases de hoy" in q or "aula de hoy" in q or "horario de hoy" in q):
|
||||
guide = STEP_GUIDES["consultar_cursada"]
|
||||
step1 = guide["steps"][0]
|
||||
return GuideStepDTO(
|
||||
target_url=guide["target_url"],
|
||||
selector=step1["selector"],
|
||||
message=step1["message"],
|
||||
expected_action=step1["expected_action"],
|
||||
step_number=1,
|
||||
total_steps=len(guide["steps"])
|
||||
)
|
||||
|
||||
return None
|
||||
Reference in New Issue
Block a user