feat: arquitectura RAG embebida y asistente UdeCi con botones interactivos (SDD-010, v3.8.25)

This commit is contained in:
2026-10-27 07:58:26 -03:00
parent 4125f7f7bd
commit fb46de5f28
18 changed files with 1088 additions and 275 deletions
+25
View File
@@ -11,6 +11,31 @@ 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.25] - 2026-10-27
### Added & Enhanced (Arquitectura RAG Embebida y Asistente UdeCi - SDD-010)
- **Asistente Virtual UdeCi con Arquitectura RAG Embebida**:
- **Especificación SDD-010**: Formalizados artefactos en `specs/010-arquitectura-rag-udeci/` (`spec.md`, `plan.md`, `tasks.md`) con sintaxis EARS y matriz de conocimiento por rol.
- **Identidad Humanizada y Concisa**:
- Rebranding oficial a **UdeCi** (Tutor Virtual Institucional de Admin Edu Space - UniCABA).
- Eliminadas todas las menciones a tecnologías de backend (Llama.cpp, Qwen3, KV Cache) en la interfaz gráfica del usuario final.
- Respuestas breves y precisas (máximo 2 a 3 oraciones o pasos directos) sin rodeos innecesarios.
- **Módulo de Recuperación y Aumentación Semántica (RAG Embebido)**:
- Nuevo modelo relacional `KnowledgeChunk` (`backend/app/models/knowledge_chunk.py`) con título, contenido, rol, palabras clave y categorías.
- `RAGService` (`backend/app/services/rag_service.py`): Ingesta y normalización de fragmentos oficiales para Bedelía (9 pasos, conflictos, optimizador, sheets, Moodle), Docentes (aulas, Gradebook, Meet) y Alumnos (cartelera, materias, notas).
- Búsqueda semántica ponderada por coincidencias de título, contenido y palabras clave con **aislamiento estricto por rol** (`WHERE role IN (:user_role, 'general')`).
- Parámetro de temperatura en `0.1` para forzar apego estricto al contexto recuperado y evitar alucinaciones.
- Nuevo endpoint administrativo `POST /api/chat/rag/reindex` para recarga de la base de conocimiento oficial.
- **Rediseño UX/UI del Chat con Botones y Chips Interactivos**:
- `frontend/views/partials/ai_chat_widget.html`: Cabecera simplificada con avatar amigable, estado "En línea" y barra superior de chips de acción rápida adaptados al perfil del usuario.
- `frontend/public/js/ai-chat-widget.js`:
* Detección y renderizado automático de botones interactivos dentro de las burbujas de respuesta (`OPCIONES: [Opción 1 | Opción 2]`).
* Envío instantáneo al hacer clic en cualquier botón de opción sin necesidad de tipeo manual.
* Mensaje de bienvenida contextual según rol (`docente`, `alumno`, `bedelia`/`admin`).
- **Calidad y Verificación Automatizada**:
- Creada suite `backend/tests/test_rag_udeci.py` con 5 pruebas exhaustivas de RAG, filtrado estricto de roles y opciones interactivas.
- Suite completa de 94 pruebas pasando con éxito (`94 passed`).
- 0 errores de tipado o compilación estática.
## [3.8.24] - 2026-10-27
### Added & Integrated (Asistente IA Contextual - SDD-009)
- **Integración de Asistente IA con Llama.cpp Local (Qwen3 Coder 30B)**: