4.1 KiB
4.1 KiB
Desglose de Tareas: Servidor MCP y Asistente Interactivo Guiado (SDD-011)
Tareas de Implementación
-
Tarea 1: Servidor MCP Institucional y Endpoints JSON-RPC / REST
- Estimación: 30 min
- Acciones:
- Crear
backend/mcp_server.pyimplementando las herramientas MCP (get_application_routes,get_canonical_9_steps,get_step_guide,get_ui_selectors). - Crear
backend/routers/mcp.pycon endpoint/api/v1/mcppara ejecutar herramientas y listar recursos. - Registrar el router en
backend/main.py.
- Crear
- Hecho cuando: Peticiones JSON-RPC / REST a
/api/v1/mcpdevuelven la lista de herramientas y la guía de pasos correcta con HTTP 200.
-
Tarea 2: Servicio de Guías Interactivas y Esquemas Pydantic v2
- Estimación: 25 min
- Acciones:
- Actualizar
backend/schemas/ai_chat.pycon el modeloGuideStepDTOy el campo opcionalguide_stepenChatResponse. - Crear
backend/app/services/guide_service.pycon los flujos canónicos:- Creación de Sede (
/buildings) - Creación de Aula (
/classrooms/list_classrooms) - Creación de Ciclo Lectivo (
/admin/academic_periods) - Creación de Comisión y Reserva
- Creación de Sede (
- Actualizar
backend/routers/ai_chat.pypara vincular intenciones guiadas alguide_step.
- Actualizar
- Hecho cuando: Una pregunta como "¿Cómo creo un aula?" retorna
guide_stepestructurado con selector, mensaje y URL de destino.
-
Tarea 3: Motor de Spotlight y Estilos Responsive (Walkthrough Engine)
- Estimación: 35 min
- Acciones:
- Crear
frontend/public/css/walkthrough.css:- Estilos para halo luminoso con animación de pulso (
.walkthrough-spotlight). - Tooltip flotante de alto contraste para Modo Claro (
[data-bs-theme="light"]) y Modo Oscuro ([data-bs-theme="dark"]). - Barra guía inferior responsive para móviles (< 768px).
- Estilos para halo luminoso con animación de pulso (
- Crear
frontend/public/js/walkthrough-engine.js:- Métodos:
startStep(guideStep),highlightElement(selector, message),clearSpotlight(). - Detección de clics para micro-feedback ("¡Muy bien!") y avance.
- Botón "Ir a la pantalla" si el usuario no está en la página adecuada.
- Métodos:
- Vincular
walkthrough.cssywalkthrough-engine.jsenfrontend/views/base.html.
- Crear
- Hecho cuando: Al invocar
WalkthroughEngine.startStep(...), el elemento se ilumina en pantalla en modo claro/oscuro tanto en desktop como en móvil.
-
Tarea 4: Integración del Motor Guiado con el Widget de Chat UdeCi
- Estimación: 25 min
- Acciones:
- Modificar
frontend/public/js/ai-chat-widget.jspara recibirdata.guide_step. - Cuando
guide_stepesté presente, minimizar el panel del chat a modo flotante compacto y activarWalkthroughEngine.startStep(data.guide_step). - Si el usuario está en otra URL, ofrecer redirección con guardado de paso en
sessionStoragepara continuar inmediatamente tras la carga.
- Modificar
- Hecho cuando: UdeCi responde la explicación y automáticamente resalta el botón correspondiente en la aplicación.
-
Tarea 5: Pruebas Automatizadas del Servidor MCP y Guías
- Estimación: 20 min
- Acciones:
- Crear
backend/tests/test_mcp_and_walkthrough.py:- Pruebas de las herramientas MCP (
get_application_routes,get_step_guide). - Pruebas del endpoint
/api/v1/mcp. - Pruebas de integración de
guide_stepen/api/chat.
- Pruebas de las herramientas MCP (
- Ejecutar suite completa
pytest tests -vy validar 100% verde (100 de 100 pasados).
- Crear
- Hecho cuando: Todas las pruebas automatizadas pasan exitosamente y 0 errores de compilación (
py_compile).
-
Tarea 6: Bump Semántico a v3.8.27, Git Push y Despliegue en Producción
- Estimación: 20 min
- Acciones:
- Bump semántico a
v3.8.27en descriptores de versiones. - Actualizar
CHANGELOG.mdyMEMORY.md. git add ., commit ygit push origin dev.- Desplegar en producción LXC
10.0.0.217y verificar en caliente con smoke test.
- Bump semántico a
- Hecho cuando: Producción corre en
v3.8.27con el servidor MCP y el spotlight de UdeCi operativo.