feat: arquitectura RAG embebida y asistente UdeCi con botones interactivos (SDD-010, v3.8.25)
This commit is contained in:
@@ -9,18 +9,13 @@ Memoria del proyecto entre sesiones para la rama `dev`.
|
||||
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
|
||||
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
|
||||
- Reinicialización segura del sistema con contraseña de Administrador.
|
||||
- **Sprint Activo: Integración de Asistente IA (Chatbot Contextual) — SDD-009 (v3.8.24)**:
|
||||
- **Especificación y Metodología SDD**: Formalizada en `specs/009-asistente-ia-chatbot/` (`spec.md`, `plan.md`, `tasks.md`) con requisitos en sintaxis EARS y matriz de restricciones de rol.
|
||||
- **Backend Core FastAPI & Llama.cpp Local (`10.0.0.214:8080/v1`)**:
|
||||
- `backend/schemas/ai_chat.py`: Contratos Pydantic v2 declarativos (`ChatMessage`, `ChatRequest`, `ChatResponse`, `AISettingsSchema`).
|
||||
- `backend/routers/ai_chat.py`: Router FastAPI con inyección dinámica de System Prompt por rol (Docente, Alumno, Bedelía/Admin), llamada asíncrona no bloqueante con `httpx.AsyncClient` y timeouts generosos (60s-600s), endpoints `/api/chat` y `/api/v1/chat`.
|
||||
- `backend/routers/admin.py`: Pestaña y endpoints de configuración (`/settings/ai`, `/settings/ai/test`) y enmascaramiento seguro de secretos en `SystemSetting`.
|
||||
- **Frontend BFF & Widget Flotante**:
|
||||
- Pestaña "Asistente IA & LLM Local" (`#tab-ai`) en `/admin/settings` con prueba de latencia en vivo contra Llama.cpp.
|
||||
- Widget flotante interactivo (`partials/ai_chat_widget.html` y `public/js/ai-chat-widget.js`) inyectado en `base.html` con persistencia en `sessionStorage`, detección de roles y renderizado de Markdown.
|
||||
- Proxy transparente `/api/chat` y `/api/v1/chat` en `frontend/src/app.js`.
|
||||
- **QA & Pruebas Automatizadas**: 89 tests aprobados al 100% en `pytest` (`89 passed`), 0 errores de tipado o compilación estática.
|
||||
- **Versión Consolidada**: `v3.8.24`.
|
||||
- **Sprint Activo: Arquitectura RAG Embebida y Asistente UdeCi — SDD-010 (v3.8.25)**:
|
||||
- **Especificación y Metodología SDD**: Formalizada en `specs/010-arquitectura-rag-udeci/` (`spec.md`, `plan.md`, `tasks.md`) con requisitos en sintaxis EARS y matriz de conocimiento por rol.
|
||||
- **Identidad y UX/UI UdeCi**: Rebranding a UdeCi, eliminación de jerga técnica en chat (Llama.cpp, Qwen3, KV Cache), respuestas concisas (2-3 oraciones) y botones interactivos en burbujas (`OPCIONES: [...]`) y barra de chips superior.
|
||||
- **Motor RAG Embebido en SQLite**: Modelo relacional `KnowledgeChunk`, `RAGService` con tokenización, normalización de acentos, búsqueda ponderada en título/contenido/keywords y filtrado estricto por rol (`WHERE role IN (:user_role, 'general')`).
|
||||
- **Endpoints y Seguridad**: Integración en `routers/ai_chat.py` con temperatura 0.1 y nuevo endpoint `POST /api/chat/rag/reindex`.
|
||||
- **QA & Pruebas Automatizadas**: 94 tests aprobados al 100% en `pytest` (`94 passed`), 0 errores de tipado o compilación estática.
|
||||
- **Versión Consolidada**: `v3.8.25`.
|
||||
|
||||
## Decisiones (y por qué)
|
||||
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
|
||||
|
||||
Reference in New Issue
Block a user