feat: integración de Asistente IA contextual con Llama.cpp Qwen3 Coder 30B (SDD-009, v3.8.24)
This commit is contained in:
@@ -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`)**:
|
||||
|
||||
Reference in New Issue
Block a user