3.7 KiB
3.7 KiB
Desglose de Tareas: Arquitectura RAG Embebida y Asistente UdeCi (SDD-010)
Tareas de Implementación
-
Tarea 1: Modelo Relacional KnowledgeChunk y Esquemas Pydantic v2 RAG
- Estimación: 20 min
- Acciones:
- Crear
backend/app/models/knowledge_chunk.pycon el modeloKnowledgeChunk(id, title, content, role, keywords, category, created_at). - Actualizar
backend/schemas/ai_chat.pyagregandoquick_optionsenChatResponsey el esquemaRAGReindexResponse.
- Crear
- Hecho cuando: El modelo se crea en base de datos y los esquemas validan los nuevos campos de respuesta y opciones.
-
Tarea 2: Servicio RAG de Ingesta, Particionamiento y Búsqueda Semántica con Filtro de Rol
- Estimación: 30 min
- Acciones:
- Crear
backend/app/services/rag_service.pycon:reindex_default_knowledge(): Fragmentos oficiales para Bedelía (9 pasos, conflictos, optimizador, sheets, Moodle), Docentes (aulas, actas Gradebook, Meet) y Alumnos (cartelera, materias, notas).search_relevant_chunks(query, user_role, limit): Búsqueda ponderada filtrando estrictamente porrole IN (user_role, 'general').
- Crear
- Hecho cuando: La búsqueda semántica retorna los fragmentos exactos y respeta el aislamiento estricto de roles.
-
Tarea 3: Actualización del Router FastAPI con Pipeline RAG y Redacción Concisa
- Estimación: 25 min
- Acciones:
- Modificar
backend/routers/ai_chat.pypara invocarRAGService.search_relevant_chunks(...). - Adaptar el System Prompt para:
- Identificar al agente como UdeCi.
- Imponer respuestas directas y breves (máximo 2 a 3 oraciones).
- Extraer o estructurar opciones con botones para el usuario.
- Fijar temperatura en
0.1para ceñirse a los fragmentos RAG.
- Agregar endpoint
POST /api/chat/rag/reindexpara recarga de la base de conocimiento.
- Modificar
- Hecho cuando: El endpoint devuelve respuestas breves respaldadas en RAG con botones de opciones y temperatura 0.1.
-
Tarea 4: Rediseño UX/UI del Widget de Chat UdeCi con Botones de Acción Rápida
- Estimación: 30 min
- Acciones:
- Modificar
frontend/views/partials/ai_chat_widget.html:- Renombrar a UdeCi · Tutor Virtual UniCABA.
- Eliminar referencias técnicas (Llama.cpp, Qwen3, KV Cache).
- Añadir barra de chips de opciones iniciales por rol.
- Actualizar
frontend/public/js/ai-chat-widget.js:- Soporte para renderizar chips de opciones dentro de la conversación.
- Envío automático al hacer clic en un botón.
- Parsing de botones de seguimiento desde la respuesta de UdeCi.
- Modificar
- Hecho cuando: El usuario interactúa con UdeCi viendo solo información pedagógica y usando botones rápidos para consultar.
-
Tarea 5: Suite de Pruebas Automatizadas en Backend (
test_rag_udeci.py)- Estimación: 20 min
- Acciones:
- Crear
backend/tests/test_rag_udeci.pyvalidando ingesta, búsqueda con filtro de roles, respuesta corta y botones de opciones. - Ejecutar suite completa
pytest tests -vy validar 100% verde (94 pasados).
- Crear
- Hecho cuando: Todas las pruebas unitarias pasan con éxito y 0 errores en
py_compile.
-
Tarea 6: Bump Semántico a v3.8.25, Git Push y Despliegue en Producción
- Estimación: 20 min
- Acciones:
- Incrementar versión semántica a
v3.8.25en descriptores y documentación. - Actualizar
CHANGELOG.mdyMEMORY.md. - Ejecutar
git add ., commit ygit push origin dev. - Desplegar en producción LXC
10.0.0.217y verificar en caliente.
- Incrementar versión semántica a
- Hecho cuando: Producción corre en
v3.8.25con UdeCi y RAG activos.