feat: integración de Asistente IA contextual con Llama.cpp Qwen3 Coder 30B (SDD-009, v3.8.24)

This commit is contained in:
2026-10-27 07:37:00 -03:00
parent 502865e45b
commit 4125f7f7bd
20 changed files with 1692 additions and 16 deletions
+12 -8
View File
@@ -9,14 +9,18 @@ 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: Optimización de Contrastes en Modo Oscuro (Google Sheets Import) — v3.8.23**:
- **Rediseño y Alto Contraste en Modo Oscuro (`admin/google_sheets_import`)**:
- Optimizado el contraste visual de pastillas de días de la semana (`.day-pill`), botones rápidos (`.btn-quick-week`), y tarjetas de selección de entidades importables (`.import-entity-card`) para `[data-bs-theme="dark"]`.
- Ajustado el panel de ámbito temporal (`.panel-temporal-box`) con fondos integrados y bordes definidos.
- Sustituidas clases opacas por badges temáticos de alto contraste (`bg-warning-subtle text-warning-emphasis`, `bg-body-secondary text-body`).
- Mejorada la legibilidad de textos secundarios y muted (`#cbd5e1`, `#94a3b8`) y celdas de previsualización en la tabla de importación masiva.
- **QA & Seguridad**: 80 tests aprobados en `pytest` (100%), 0 vulnerabilidades en auditoría de seguridad.
- **Versión Consolidada**: `v3.8.23`.
- **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`.
## 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.