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
+26
View File
@@ -11,6 +11,32 @@ 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.24] - 2026-10-27
### Added & Integrated (Asistente IA Contextual - SDD-009)
- **Integración de Asistente IA con Llama.cpp Local (Qwen3 Coder 30B)**:
- **Especificación SDD-009**: Formalizada la especificación completa en `specs/009-asistente-ia-chatbot/` (`spec.md`, `plan.md`, `tasks.md`) con requisitos EARS y matriz de restricciones de rol.
- **Contratos Fuertes Pydantic v2 (`backend/schemas/ai_chat.py`)**:
- DTOs declarativos `ChatMessage`, `ChatRequest`, `ChatResponse` y `AISettingsSchema` con validación de expresiones regulares, longitudes y rangos de temperatura/timeout.
- **Router FastAPI Asíncrono (`backend/routers/ai_chat.py`)**:
- Implementados endpoints `/api/chat/`, `/api/v1/chat/`, `/test-connection` y `/config` montados en `main.py`.
- Cliente HTTP no bloqueante con `httpx.AsyncClient` y timeout generoso configurable (default 60s, soporte hasta 600s).
- Inyección dinámica de System Prompt adaptado al rol del usuario autenticado:
* **Docente**: Orientación sobre reserva de aulas, actas en Gradebook, cronograma y enlaces a Google Meet.
* **Alumno**: Guía de cursada, aulas del día, materias matriculadas y notas, con prohibición total de acceso a procedimientos de gestión.
* **Bedelía / Admin**: Soporte Nivel 1 en el circuito de 9 pasos, resolución de matriz de conflictos, optimizador genético, importador de Google Sheets y Moodle 4.1.
- Manejo controlado de fallas de red y timeouts retornando HTTP 503/504 descriptivos sin bloquear el servidor.
- **Configuración Global Administrativa (`/admin/settings`)**:
- Agregada pestaña dedicada "Asistente IA & LLM Local" (`#tab-ai`) en `global_config.html`.
- Formulario con switches de habilitación, URL base del servidor (`http://10.0.0.214:8080/v1`), API key cifrada con Fernet, modelo (`qwen3-coder:30b`), temperatura, timeout y límites de contexto/salida.
- Botón interactivo "Probar Conexión con Llama.cpp" con feedback en vivo de latencia y modelos disponibles.
- **Widget de Chatbot Flotante Interactivo en Frontend**:
- Componente parcial `frontend/views/partials/ai_chat_widget.html` inyectado en `base.html` para todos los usuarios autenticados.
- Lógica cliente `frontend/public/js/ai-chat-widget.js` con persistencia en `sessionStorage`, detección de rol, formateo de Markdown, indicador animado de escritura y scroll automático.
- Proxy transparente `/api/chat` en Node.js BFF (`frontend/src/app.js`).
- **Calidad y Verificación Automatizada**:
- Creada suite `backend/tests/test_ai_chat.py` (9 tests unitarios/integración pasando al 100%).
- Suite completa de 89 tests en verde (`89 passed`). 0 errores en compilación de tipos (`py_compile`).
## [3.8.23] - 2026-10-27
### Improved & Fixed (UI / UX)
- **Importador de Google Sheets: Optimización de Contrastes en Modo Oscuro (`admin/google_sheets_import`)**: