Files
admin-edu-space/specs/010-arquitectura-rag-udeci/tasks.md
T

60 lines
3.7 KiB
Markdown

# Desglose de Tareas: Arquitectura RAG Embebida y Asistente UdeCi (SDD-010)
## Tareas de Implementación
- [x] **Tarea 1: Modelo Relacional KnowledgeChunk y Esquemas Pydantic v2 RAG**
- **Estimación**: 20 min
- **Acciones**:
- Crear `backend/app/models/knowledge_chunk.py` con el modelo `KnowledgeChunk` (id, title, content, role, keywords, category, created_at).
- Actualizar `backend/schemas/ai_chat.py` agregando `quick_options` en `ChatResponse` y el esquema `RAGReindexResponse`.
- **Hecho cuando**: El modelo se crea en base de datos y los esquemas validan los nuevos campos de respuesta y opciones.
- [x] **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.py` con:
- `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 por `role IN (user_role, 'general')`.
- **Hecho cuando**: La búsqueda semántica retorna los fragmentos exactos y respeta el aislamiento estricto de roles.
- [x] **Tarea 3: Actualización del Router FastAPI con Pipeline RAG y Redacción Concisa**
- **Estimación**: 25 min
- **Acciones**:
- Modificar `backend/routers/ai_chat.py` para invocar `RAGService.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.1` para ceñirse a los fragmentos RAG.
- Agregar endpoint `POST /api/chat/rag/reindex` para recarga de la base de conocimiento.
- **Hecho cuando**: El endpoint devuelve respuestas breves respaldadas en RAG con botones de opciones y temperatura 0.1.
- [x] **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.
- **Hecho cuando**: El usuario interactúa con UdeCi viendo solo información pedagógica y usando botones rápidos para consultar.
- [x] **Tarea 5: Suite de Pruebas Automatizadas en Backend (`test_rag_udeci.py`)**
- **Estimación**: 20 min
- **Acciones**:
- Crear `backend/tests/test_rag_udeci.py` validando ingesta, búsqueda con filtro de roles, respuesta corta y botones de opciones.
- Ejecutar suite completa `pytest tests -v` y validar 100% verde (94 pasados).
- **Hecho cuando**: Todas las pruebas unitarias pasan con éxito y 0 errores en `py_compile`.
- [x] **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.25` en descriptores y documentación.
- Actualizar `CHANGELOG.md` y `MEMORY.md`.
- Ejecutar `git add .`, commit y `git push origin dev`.
- Desplegar en producción LXC `10.0.0.217` y verificar en caliente.
- **Hecho cuando**: Producción corre en `v3.8.25` con UdeCi y RAG activos.