feat: servidor mcp institucional y asistente interactivo guiado con spotlight didactico (SDD-011, v3.8.27)

This commit is contained in:
2026-10-27 08:23:04 -03:00
parent a5b014efbe
commit bf5b7c3ae7
20 changed files with 1339 additions and 12 deletions
+24
View File
@@ -11,6 +11,30 @@ 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.27] - 2026-10-27
### Added & Enhanced (Servidor MCP Institucional y Asistente Interactivo Guiado con Spotlight - SDD-011)
- **Servidor MCP Institucional (Model Context Protocol)**:
- Implementado `EduSpaceMCPServer` en `backend/mcp_server.py` compatible con estándares JSON-RPC 2.0 y REST.
- Herramientas MCP expuestas:
* `get_application_routes`: Lista las rutas canónicas y vistas del sistema según el rol.
* `get_canonical_9_steps`: Devuelve la secuencia estandarizada de 9 pasos de Bedelía con descripciones y prerrequisitos.
* `get_step_guide`: Guías interactivas paso a paso (`crear_sede`, `crear_aula`, `crear_ciclo`, `consultar_cursada`).
- Router FastAPI `backend/routers/mcp.py` montado en `/api/v1/mcp` y `/api/mcp`.
- **Filosofía Didáctica: "Enseñar a Pescar, No Dar el Pescado"**:
- `GuideService` (`backend/app/services/guide_service.py`): Inyección estructurada de `GuideStepDTO` (`target_url`, `selector`, `message`, `expected_action`, `step_number`, `total_steps`).
- UdeCi guía, explica e ilumina el botón o campo de la UI, pero es el usuario quien ejecuta el clic de confirmación, guardado o selección.
- **Motor de Spotlight y Walkthrough Responsive (Desktop & Mobile)**:
- `frontend/public/css/walkthrough.css`:
* Halo luminoso animado (`.walkthrough-highlight`) con resplandor magenta oficial `#B43E8E` en Modo Claro (`[data-bs-theme="light"]`) y neón fucsia `#d946ef` en Modo Oscuro (`[data-bs-theme="dark"]`).
* Tooltip flotante cristalino con backdrop blur y pasos enumerados.
* Barra guía inferior táctil (*Bottom Guide Banner*) para pantallas móviles (< 768px) con botones de altura ergonómica (mínimo 44px).
- `frontend/public/js/walkthrough-engine.js`:
* Detección de página actual y banner de redirección con persistencia de paso pendiente en `sessionStorage`.
* Detección de clics para micro-feedback ("¡Muy bien!") y avance de paso.
- **Calidad y Verificación Automatizada**:
- Creada suite `backend/tests/test_mcp_and_walkthrough.py` (5 pruebas unitarias e integración pasando al 100%).
- Suite completa de backend: **100 pruebas aprobadas** (`100 passed`), 0 errores de tipado o compilación.
## [3.8.26] - 2026-10-27
### Fixed & Enhanced (Aislamiento Individual y Simultáneo de Conversaciones en UdeCi)
- **Aislamiento Estricto de Conversaciones por Usuario Individual**: