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.
|
- **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.
|
- **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
|
## [3.8.23] - 2026-10-27
|
||||||
### Improved & Fixed (UI / UX)
|
### Improved & Fixed (UI / UX)
|
||||||
- **Importador de Google Sheets: Optimización de Contrastes en Modo Oscuro (`admin/google_sheets_import`)**:
|
- **Importador de Google Sheets: Optimización de Contrastes en Modo Oscuro (`admin/google_sheets_import`)**:
|
||||||
|
|||||||
@@ -9,14 +9,18 @@ Memoria del proyecto entre sesiones para la rama `dev`.
|
|||||||
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
|
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
|
||||||
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
|
- 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.
|
- 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**:
|
- **Sprint Activo: Integración de Asistente IA (Chatbot Contextual) — SDD-009 (v3.8.24)**:
|
||||||
- **Rediseño y Alto Contraste en Modo Oscuro (`admin/google_sheets_import`)**:
|
- **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.
|
||||||
- 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"]`.
|
- **Backend Core FastAPI & Llama.cpp Local (`10.0.0.214:8080/v1`)**:
|
||||||
- Ajustado el panel de ámbito temporal (`.panel-temporal-box`) con fondos integrados y bordes definidos.
|
- `backend/schemas/ai_chat.py`: Contratos Pydantic v2 declarativos (`ChatMessage`, `ChatRequest`, `ChatResponse`, `AISettingsSchema`).
|
||||||
- Sustituidas clases opacas por badges temáticos de alto contraste (`bg-warning-subtle text-warning-emphasis`, `bg-body-secondary text-body`).
|
- `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`.
|
||||||
- Mejorada la legibilidad de textos secundarios y muted (`#cbd5e1`, `#94a3b8`) y celdas de previsualización en la tabla de importación masiva.
|
- `backend/routers/admin.py`: Pestaña y endpoints de configuración (`/settings/ai`, `/settings/ai/test`) y enmascaramiento seguro de secretos en `SystemSetting`.
|
||||||
- **QA & Seguridad**: 80 tests aprobados en `pytest` (100%), 0 vulnerabilidades en auditoría de seguridad.
|
- **Frontend BFF & Widget Flotante**:
|
||||||
- **Versión Consolidada**: `v3.8.23`.
|
- 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é)
|
## 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.
|
- **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.
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ from typing import Any
|
|||||||
from database import db, get_db, engine, SessionLocal, session
|
from database import db, get_db, engine, SessionLocal, session
|
||||||
from config.config import Config
|
from config.config import Config
|
||||||
|
|
||||||
__version__ = "3.8.23"
|
__version__ = "3.8.24"
|
||||||
|
|
||||||
class DummyContext:
|
class DummyContext:
|
||||||
def __enter__(self):
|
def __enter__(self):
|
||||||
|
|||||||
@@ -19,6 +19,7 @@ from routers.admin import admin_router
|
|||||||
from routers.students import students_router
|
from routers.students import students_router
|
||||||
from routers.dashboard import dashboard_router
|
from routers.dashboard import dashboard_router
|
||||||
from routers.optimizer import optimizer_router, genetic_router
|
from routers.optimizer import optimizer_router, genetic_router
|
||||||
|
from routers.ai_chat import router as ai_chat_router
|
||||||
|
|
||||||
# Initialize FastAPI Application
|
# Initialize FastAPI Application
|
||||||
app = FastAPI(
|
app = FastAPI(
|
||||||
@@ -51,6 +52,8 @@ app.include_router(students_router)
|
|||||||
app.include_router(dashboard_router)
|
app.include_router(dashboard_router)
|
||||||
app.include_router(optimizer_router)
|
app.include_router(optimizer_router)
|
||||||
app.include_router(genetic_router)
|
app.include_router(genetic_router)
|
||||||
|
app.include_router(ai_chat_router, prefix="/api/chat")
|
||||||
|
app.include_router(ai_chat_router, prefix="/api/v1/chat")
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
if __name__ == "__main__":
|
||||||
|
|||||||
+123
-1
@@ -852,6 +852,18 @@ def get_all_settings(current_user: User = Depends(require_roles(["ADMIN"]))):
|
|||||||
'show_role_banner': SystemSetting.get_value('dashboard_role_banner_enabled', 'true') in ['true', 'True', '1', True]
|
'show_role_banner': SystemSetting.get_value('dashboard_role_banner_enabled', 'true') in ['true', 'True', '1', True]
|
||||||
}
|
}
|
||||||
|
|
||||||
|
ai_config = {
|
||||||
|
'enabled': SystemSetting.get_value('ai_chat_enabled', 'true') in ['true', 'True', '1', True],
|
||||||
|
'base_url': SystemSetting.get_value('ai_chat_base_url', 'http://10.0.0.214:8080/v1'),
|
||||||
|
'api_key': SystemSetting.get_masked_value('ai_chat_api_key', '••••••••••••') if SystemSetting.get_value('ai_chat_api_key') else 'llama',
|
||||||
|
'model': SystemSetting.get_value('ai_chat_model', 'qwen3-coder:30b'),
|
||||||
|
'model_name': SystemSetting.get_value('ai_chat_model_name', 'Qwen3 Coder 30B-A3B (Llama.cpp)'),
|
||||||
|
'temperature': float(SystemSetting.get_value('ai_chat_temperature', 0.3) or 0.3),
|
||||||
|
'timeout': int(SystemSetting.get_value('ai_chat_timeout', 60) or 60),
|
||||||
|
'context_limit': int(SystemSetting.get_value('ai_chat_context_limit', 65536) or 65536),
|
||||||
|
'output_limit': int(SystemSetting.get_value('ai_chat_output_limit', 65536) or 65536)
|
||||||
|
}
|
||||||
|
|
||||||
return {
|
return {
|
||||||
'status': 'success',
|
'status': 'success',
|
||||||
'settings': {
|
'settings': {
|
||||||
@@ -859,7 +871,9 @@ def get_all_settings(current_user: User = Depends(require_roles(["ADMIN"]))):
|
|||||||
'auth_providers': auth_providers,
|
'auth_providers': auth_providers,
|
||||||
'google_oauth': google_oauth,
|
'google_oauth': google_oauth,
|
||||||
'moodle': moodle_config,
|
'moodle': moodle_config,
|
||||||
'ui': ui_config
|
'ui': ui_config,
|
||||||
|
'ai': ai_config,
|
||||||
|
'ai_assistant': ai_config
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1052,6 +1066,114 @@ async def update_ui_settings(
|
|||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@admin_router.post("/settings/ai")
|
||||||
|
@admin_router.post("/admin/settings/ai")
|
||||||
|
async def update_ai_settings(
|
||||||
|
request: Request,
|
||||||
|
current_user: User = Depends(require_roles(["ADMIN"]))
|
||||||
|
):
|
||||||
|
"""Actualiza la configuración del proveedor de IA local (Llama.cpp / Qwen3)."""
|
||||||
|
data = await get_request_payload(request)
|
||||||
|
|
||||||
|
enabled_input = data.get('enabled')
|
||||||
|
enabled = 'true' if enabled_input in [True, 'true', '1', 'on', 1] else 'false'
|
||||||
|
base_url = str(data.get('base_url', 'http://10.0.0.214:8080/v1')).strip().rstrip('/')
|
||||||
|
api_key = str(data.get('api_key', '')).strip()
|
||||||
|
model = str(data.get('model', 'qwen3-coder:30b')).strip()
|
||||||
|
model_name = str(data.get('model_name', 'Qwen3 Coder 30B-A3B (Llama.cpp)')).strip()
|
||||||
|
temperature = str(data.get('temperature', '0.3')).strip()
|
||||||
|
timeout = str(data.get('timeout', '60')).strip()
|
||||||
|
context_limit = str(data.get('context_limit', '65536')).strip()
|
||||||
|
output_limit = str(data.get('output_limit', '65536')).strip()
|
||||||
|
|
||||||
|
SystemSetting.set_value('ai_chat_enabled', enabled, 'Habilitación de Asistente IA', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_base_url', base_url, 'URL base del servidor Llama.cpp', category='ai')
|
||||||
|
if api_key and api_key != '••••••••••••':
|
||||||
|
SystemSetting.set_encrypted_value('ai_chat_api_key', api_key, 'Clave API del servidor de IA', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_model', model, 'ID del modelo Llama.cpp', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_model_name', model_name, 'Nombre descriptivo del modelo', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_temperature', temperature, 'Temperatura de generación', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_timeout', timeout, 'Timeout de inferencia en segundos', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_context_limit', context_limit, 'Límite de tokens de contexto', category='ai')
|
||||||
|
SystemSetting.set_value('ai_chat_output_limit', output_limit, 'Límite de tokens de respuesta', category='ai')
|
||||||
|
|
||||||
|
AuditService.log(
|
||||||
|
action='UPDATE_AI_SETTINGS',
|
||||||
|
module='settings',
|
||||||
|
user=current_user,
|
||||||
|
details=f"Configuración de Asistente IA actualizada (Modelo: {model}, URL: {base_url})"
|
||||||
|
)
|
||||||
|
|
||||||
|
return {
|
||||||
|
'status': 'success',
|
||||||
|
'message': 'Configuración de Asistente IA guardada exitosamente.',
|
||||||
|
'settings': {
|
||||||
|
'enabled': enabled == 'true',
|
||||||
|
'base_url': base_url,
|
||||||
|
'model': model,
|
||||||
|
'model_name': model_name,
|
||||||
|
'temperature': float(temperature) if temperature else 0.3,
|
||||||
|
'timeout': int(timeout) if timeout else 60
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@admin_router.post("/settings/ai/test")
|
||||||
|
@admin_router.post("/admin/settings/ai/test")
|
||||||
|
async def test_ai_settings_connection(
|
||||||
|
request: Request,
|
||||||
|
current_user: User = Depends(require_roles(["ADMIN"]))
|
||||||
|
):
|
||||||
|
"""Prueba en tiempo real la conectividad con el servidor de IA local."""
|
||||||
|
import time
|
||||||
|
import httpx
|
||||||
|
|
||||||
|
data = await get_request_payload(request)
|
||||||
|
base_url = str(data.get('base_url') or SystemSetting.get_value('ai_chat_base_url', 'http://10.0.0.214:8080/v1')).strip().rstrip('/')
|
||||||
|
api_key = data.get('api_key')
|
||||||
|
if not api_key or api_key == '••••••••••••':
|
||||||
|
api_key = SystemSetting.get_decrypted_value('ai_chat_api_key', 'llama') or 'llama'
|
||||||
|
|
||||||
|
target_url = f"{base_url}/models"
|
||||||
|
headers = {"Authorization": f"Bearer {api_key}"}
|
||||||
|
|
||||||
|
start_time = time.time()
|
||||||
|
async with httpx.AsyncClient(timeout=10.0) as client:
|
||||||
|
try:
|
||||||
|
resp = await client.get(target_url, headers=headers)
|
||||||
|
latency_ms = round((time.time() - start_time) * 1000, 2)
|
||||||
|
if resp.status_code == 200:
|
||||||
|
data_json = resp.json()
|
||||||
|
models = [m.get("id") for m in data_json.get("data", []) if isinstance(m, dict) and "id" in m]
|
||||||
|
return {
|
||||||
|
'status': 'success',
|
||||||
|
'message': f"Conexión exitosa con Llama.cpp ({base_url}). Latencia: {latency_ms} ms.",
|
||||||
|
'latency_ms': latency_ms,
|
||||||
|
'models': models
|
||||||
|
}
|
||||||
|
else:
|
||||||
|
return {
|
||||||
|
'status': 'warning',
|
||||||
|
'message': f"Respuesta inesperada del servidor ({resp.status_code}): {resp.text[:200]}",
|
||||||
|
'latency_ms': latency_ms,
|
||||||
|
'models': []
|
||||||
|
}
|
||||||
|
except httpx.TimeoutException:
|
||||||
|
return {
|
||||||
|
'status': 'error',
|
||||||
|
'message': f"Tiempo de espera agotado al conectar a {base_url} (Timeout: 10s).",
|
||||||
|
'latency_ms': None,
|
||||||
|
'models': []
|
||||||
|
}
|
||||||
|
except httpx.RequestError as e:
|
||||||
|
return {
|
||||||
|
'status': 'error',
|
||||||
|
'message': f"No se pudo conectar a {base_url}: {str(e)}",
|
||||||
|
'latency_ms': None,
|
||||||
|
'models': []
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
@admin_router.get("/settings/demo-mode")
|
@admin_router.get("/settings/demo-mode")
|
||||||
@admin_router.get("/admin/settings/demo-mode")
|
@admin_router.get("/admin/settings/demo-mode")
|
||||||
def get_demo_mode_status(current_user: User = Depends(require_roles(["ADMIN"]))):
|
def get_demo_mode_status(current_user: User = Depends(require_roles(["ADMIN"]))):
|
||||||
|
|||||||
@@ -0,0 +1,241 @@
|
|||||||
|
"""
|
||||||
|
Módulo de Integración de Asistente IA (Chatbot de Ayuda Contextual)
|
||||||
|
SDD-009: Compatible con OpenAI API y Servidor Local Llama.cpp (Qwen3 Coder 30B)
|
||||||
|
"""
|
||||||
|
import time
|
||||||
|
from typing import Optional
|
||||||
|
import httpx
|
||||||
|
from fastapi import APIRouter, HTTPException, Depends, Request, status
|
||||||
|
|
||||||
|
from dependencies import get_optional_current_user, require_roles
|
||||||
|
from app.models.setting import SystemSetting
|
||||||
|
from app.models.user import User
|
||||||
|
from schemas.ai_chat import (
|
||||||
|
ChatRequest,
|
||||||
|
ChatResponse,
|
||||||
|
AITestConnectionResponse,
|
||||||
|
AISettingsSchema
|
||||||
|
)
|
||||||
|
|
||||||
|
router = APIRouter(tags=["AI Chatbot"])
|
||||||
|
|
||||||
|
|
||||||
|
def generate_system_prompt_for_role(role: Optional[str]) -> str:
|
||||||
|
"""
|
||||||
|
Genera el System Prompt dinámico según el rol del usuario autenticado,
|
||||||
|
proporcionándole al LLM las reglas de negocio, manual de uso y restricciones de acceso.
|
||||||
|
"""
|
||||||
|
normalized_role = (role or "alumno").strip().lower()
|
||||||
|
|
||||||
|
if normalized_role in ["docente", "profesor", "teacher"]:
|
||||||
|
return (
|
||||||
|
"Eres el Asistente y Tutor Inteligente de Admin Edu Space (UniCABA) para DOCENTES y PROFESORES.\n"
|
||||||
|
"Tu objetivo es asistir al cuerpo docente guiándolo exclusivamente en las tareas pertinentes a su rol:\n"
|
||||||
|
"1. Asignaciones de Aula y Espacios: Explicar cómo consultar las aulas físicas asignadas y enlaces a aulas virtuales (Google Meet/Teams) en la cartelera diaria y semanal.\n"
|
||||||
|
"2. Libro de Calificaciones (Gradebook): Orientar sobre cómo cargar y editar calificaciones de parciales, recuperatorios, notas finales y cerrar actas de regularidad inmutables con trazabilidad.\n"
|
||||||
|
"3. Nómina de Comisiones y Alumnos: Guiar en la visualización de listas de alumnos inscriptos en sus comisiones activas.\n"
|
||||||
|
"4. Cronogramas y Horarios: Indicar cómo consultar días y horarios de cursada según el ciclo lectivo vigente.\n"
|
||||||
|
"REGLAS ESTRICTAS DE SEGURIDAD Y PERMISOS:\n"
|
||||||
|
"- Si el usuario te consulta sobre cómo crear carreras, modificar asignaciones físicas ajenas, reconfigurar servidores o ingresar a funciones de Bedelía, aclara respetuosamente que esas operaciones están reservadas a Bedelía o Administración de Sistemas.\n"
|
||||||
|
"- Responde siempre en español institucional, con tono cordial, empático y estructurado en pasos claros."
|
||||||
|
)
|
||||||
|
|
||||||
|
elif normalized_role in ["bedelia", "admin", "administrador"]:
|
||||||
|
return (
|
||||||
|
"Eres el Asistente y Tutor Técnico de Nivel 1 de Admin Edu Space (UniCABA) para personal de BEDELÍA y ADMINISTRADORES.\n"
|
||||||
|
"Tu objetivo es brindar soporte técnico operativo y guiar en el flujo integral de gestión académica y áulica:\n"
|
||||||
|
"1. Circuito Secuencial Canónico de 9 Pasos: 1) Sedes/Edificios -> 2) Aulas (físicas/virtuales) -> 3) Ciclos Lectivos -> 4) Carreras -> 5) Asignaturas (con carreras asociadas) -> 6) Comisiones -> 7) Profesores -> 8) Alumnos -> 9) Reservas de Espacio.\n"
|
||||||
|
"2. Matriz de Conflictos: Explicar la validación física en aulas presenciales, control estricto de aforo, superposición horaria docente (con excepción de co-docencia activa) y restricción diaria de cursada para alumnos.\n"
|
||||||
|
"3. Herramienta de Optimización con IA: Instruir sobre el uso del Optimizador Genético de Aulas para resolver colisiones y maximizar aforo.\n"
|
||||||
|
"4. Importación Masiva (Google Sheets): Explicar el proceso de inspección previa, selección granular de entidades, filtrado por carrera/día y carga con fechas manuales.\n"
|
||||||
|
"5. Sincronización Moodle 4.1: Orientar en la gestión de la cola asíncrona (MoodleSyncTask), manejo de reintentos, Dead Letter Queue (DLQ) y sincronización RBAC.\n"
|
||||||
|
"6. Auditoría Institucional: Indicar cómo auditar eventos en AuditLog por módulo, acción y fecha.\n"
|
||||||
|
"REGLAS:\n"
|
||||||
|
"- Responde con precisión técnica, terminología oficial de UniCABA y soluciones directas y accionables."
|
||||||
|
)
|
||||||
|
|
||||||
|
else:
|
||||||
|
# Rol Alumno / Estudiante (por defecto)
|
||||||
|
return (
|
||||||
|
"Eres el Asistente y Tutor Inteligente de Admin Edu Space (UniCABA) para ESTUDIANTES y ALUMNOS.\n"
|
||||||
|
"Tu misión es guiar al estudiante sobre cómo cursar y utilizar el sistema:\n"
|
||||||
|
"1. Cartelera de Clases de Hoy: Enseñar cómo consultar en qué aula física o enlace virtual de Meet le corresponde cursar sus materias hoy y en qué turno.\n"
|
||||||
|
"2. Mis Asignaturas e Inscripciones: Explicar cómo verificar las materias matriculadas, comisiones, docentes a cargo y horarios de cursada.\n"
|
||||||
|
"3. Consulta de Calificaciones: Guiar en la visualización de estados académicos, notas parciales, recuperatorios y regularidad en el sistema.\n"
|
||||||
|
"4. Restricción de Cursada Diaria: Explicar que el sistema restringe cursar dos materias el mismo día salvo cursos cortos o excepciones autorizadas por Bedelía.\n"
|
||||||
|
"REGLAS ESTRICTAS DE SEGURIDAD:\n"
|
||||||
|
"- Tienes TERMINANTEMENTE PROHIBIDO enseñar o detallar cómo reservar aulas, cómo alterar notas, cómo sincronizar Moodle o cómo administrar el sistema.\n"
|
||||||
|
"- Ante cualquier solicitud de índole administrativa o de reclamo de cupos, indica al alumno que debe dirigirse a la Secretaría de Bedelía de UniCABA.\n"
|
||||||
|
"- Responde en español de forma pedagógica, clara y amigable."
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _get_ai_config() -> dict:
|
||||||
|
"""Recupera la configuración activa del motor de IA desde SystemSetting."""
|
||||||
|
enabled_val = SystemSetting.get_value("ai_chat_enabled", "true")
|
||||||
|
enabled = enabled_val in ["true", "True", "1", True]
|
||||||
|
|
||||||
|
base_url = SystemSetting.get_value("ai_chat_base_url", "http://10.0.0.214:8080/v1") or "http://10.0.0.214:8080/v1"
|
||||||
|
|
||||||
|
# Obtener clave API descifrada
|
||||||
|
api_key = SystemSetting.get_decrypted_value("ai_chat_api_key", "llama") or "llama"
|
||||||
|
model = SystemSetting.get_value("ai_chat_model", "qwen3-coder:30b") or "qwen3-coder:30b"
|
||||||
|
model_name = SystemSetting.get_value("ai_chat_model_name", "Qwen3 Coder 30B-A3B (Llama.cpp)") or "Qwen3 Coder 30B-A3B (Llama.cpp)"
|
||||||
|
|
||||||
|
try:
|
||||||
|
temperature = float(SystemSetting.get_value("ai_chat_temperature", 0.3))
|
||||||
|
except (ValueError, TypeError):
|
||||||
|
temperature = 0.3
|
||||||
|
|
||||||
|
try:
|
||||||
|
timeout = float(SystemSetting.get_value("ai_chat_timeout", 60.0))
|
||||||
|
except (ValueError, TypeError):
|
||||||
|
timeout = 60.0
|
||||||
|
|
||||||
|
return {
|
||||||
|
"enabled": enabled,
|
||||||
|
"base_url": base_url.strip().rstrip("/"),
|
||||||
|
"api_key": api_key.strip(),
|
||||||
|
"model": model.strip(),
|
||||||
|
"model_name": model_name.strip(),
|
||||||
|
"temperature": temperature,
|
||||||
|
"timeout": timeout
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@router.post("/", response_model=ChatResponse)
|
||||||
|
@router.post("", response_model=ChatResponse)
|
||||||
|
async def get_agent_response(
|
||||||
|
request: ChatRequest,
|
||||||
|
req: Request,
|
||||||
|
current_user: Optional[User] = Depends(get_optional_current_user)
|
||||||
|
):
|
||||||
|
"""
|
||||||
|
Procesa la conversación del usuario con el agente contextual:
|
||||||
|
1. Resuelve el rol del usuario (prioriza sesión JWT o campo user_role).
|
||||||
|
2. Inyecta el System Prompt correspondiente al rol.
|
||||||
|
3. Envía la solicitud asíncrona no bloqueante hacia el servidor local Llama.cpp.
|
||||||
|
"""
|
||||||
|
config = _get_ai_config()
|
||||||
|
|
||||||
|
if not config["enabled"]:
|
||||||
|
raise HTTPException(
|
||||||
|
status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
|
||||||
|
detail="El servicio de Asistente IA está temporalmente deshabilitado por el administrador."
|
||||||
|
)
|
||||||
|
|
||||||
|
# 1. Determinar rol efectivo
|
||||||
|
effective_role = request.user_role or "alumno"
|
||||||
|
if current_user:
|
||||||
|
if getattr(current_user, "is_admin", False) or (getattr(current_user, "role", "") or "").upper() == "ADMIN":
|
||||||
|
effective_role = "bedelia"
|
||||||
|
elif hasattr(current_user, "role") and current_user.role:
|
||||||
|
role_str = str(current_user.role).lower()
|
||||||
|
if "docente" in role_str or "profesor" in role_str or "teacher" in role_str:
|
||||||
|
effective_role = "docente"
|
||||||
|
elif "bedelia" in role_str or "admin" in role_str:
|
||||||
|
effective_role = "bedelia"
|
||||||
|
else:
|
||||||
|
effective_role = "alumno"
|
||||||
|
|
||||||
|
# 2. Inyección de Contexto
|
||||||
|
system_prompt = generate_system_prompt_for_role(effective_role)
|
||||||
|
|
||||||
|
formatted_messages = [{"role": "system", "content": system_prompt}]
|
||||||
|
for msg in request.messages:
|
||||||
|
formatted_messages.append({"role": msg.role, "content": msg.content})
|
||||||
|
|
||||||
|
payload = {
|
||||||
|
"model": config["model"],
|
||||||
|
"messages": formatted_messages,
|
||||||
|
"temperature": config["temperature"]
|
||||||
|
}
|
||||||
|
|
||||||
|
target_url = f"{config['base_url']}/chat/completions"
|
||||||
|
headers = {
|
||||||
|
"Authorization": f"Bearer {config['api_key']}",
|
||||||
|
"Content-Type": "application/json"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 3. Petición asíncrona no bloqueante al servidor local
|
||||||
|
async with httpx.AsyncClient(timeout=config["timeout"]) as client:
|
||||||
|
try:
|
||||||
|
response = await client.post(target_url, headers=headers, json=payload)
|
||||||
|
response.raise_for_status()
|
||||||
|
ai_data = response.json()
|
||||||
|
reply_text = ai_data["choices"][0]["message"]["content"]
|
||||||
|
return ChatResponse(response=reply_text)
|
||||||
|
except httpx.TimeoutException:
|
||||||
|
raise HTTPException(
|
||||||
|
status_code=status.HTTP_504_GATEWAY_TIMEOUT,
|
||||||
|
detail=f"El servidor de IA local superó el tiempo límite de espera ({config['timeout']}s)."
|
||||||
|
)
|
||||||
|
except httpx.HTTPStatusError as e:
|
||||||
|
detail_msg = f"Error del motor de IA local ({e.response.status_code}): {e.response.text[:200]}"
|
||||||
|
raise HTTPException(status_code=status.HTTP_503_SERVICE_UNAVAILABLE, detail=detail_msg)
|
||||||
|
except httpx.RequestError as e:
|
||||||
|
raise HTTPException(
|
||||||
|
status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
|
||||||
|
detail="Error conectando al motor de IA local. Verifique que Llama.cpp esté activo en 10.0.0.214."
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@router.post("/test-connection", response_model=AITestConnectionResponse)
|
||||||
|
async def test_ai_connection(
|
||||||
|
current_user: User = Depends(require_roles(["ADMIN"]))
|
||||||
|
):
|
||||||
|
"""
|
||||||
|
Verifica la conectividad directa con el servidor local Llama.cpp
|
||||||
|
consultando el endpoint de modelos /v1/models y calculando la latencia.
|
||||||
|
"""
|
||||||
|
config = _get_ai_config()
|
||||||
|
target_url = f"{config['base_url']}/models"
|
||||||
|
headers = {"Authorization": f"Bearer {config['api_key']}"}
|
||||||
|
|
||||||
|
start_time = time.time()
|
||||||
|
async with httpx.AsyncClient(timeout=10.0) as client:
|
||||||
|
try:
|
||||||
|
resp = await client.get(target_url, headers=headers)
|
||||||
|
latency_ms = round((time.time() - start_time) * 1000, 2)
|
||||||
|
if resp.status_code == 200:
|
||||||
|
data = resp.json()
|
||||||
|
model_ids = [m.get("id") for m in data.get("data", []) if isinstance(m, dict) and "id" in m]
|
||||||
|
return AITestConnectionResponse(
|
||||||
|
status="success",
|
||||||
|
message=f"Conexión exitosa con Llama.cpp ({config['base_url']}). Latencia: {latency_ms} ms.",
|
||||||
|
latency_ms=latency_ms,
|
||||||
|
models=model_ids
|
||||||
|
)
|
||||||
|
else:
|
||||||
|
return AITestConnectionResponse(
|
||||||
|
status="warning",
|
||||||
|
message=f"Respuesta inesperada del servidor ({resp.status_code}): {resp.text[:200]}",
|
||||||
|
latency_ms=latency_ms,
|
||||||
|
models=[]
|
||||||
|
)
|
||||||
|
except httpx.TimeoutException:
|
||||||
|
return AITestConnectionResponse(
|
||||||
|
status="error",
|
||||||
|
message=f"Tiempo de espera agotado al conectar a {config['base_url']} (Timeout: 10s).",
|
||||||
|
latency_ms=None,
|
||||||
|
models=[]
|
||||||
|
)
|
||||||
|
except httpx.RequestError as e:
|
||||||
|
return AITestConnectionResponse(
|
||||||
|
status="error",
|
||||||
|
message=f"No se pudo conectar a {config['base_url']}: {str(e)}",
|
||||||
|
latency_ms=None,
|
||||||
|
models=[]
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@router.get("/config")
|
||||||
|
def get_ai_public_config(current_user: Optional[User] = Depends(get_optional_current_user)):
|
||||||
|
"""Retorna metadatos públicos de estado del asistente para el widget del frontend."""
|
||||||
|
config = _get_ai_config()
|
||||||
|
return {
|
||||||
|
"status": "success",
|
||||||
|
"enabled": config["enabled"],
|
||||||
|
"model": config["model"],
|
||||||
|
"model_name": config["model_name"]
|
||||||
|
}
|
||||||
@@ -1 +1,3 @@
|
|||||||
# Schemas package initialization
|
# Schemas package initialization
|
||||||
|
from schemas.auth import *
|
||||||
|
from schemas.ai_chat import *
|
||||||
|
|||||||
@@ -0,0 +1,35 @@
|
|||||||
|
from typing import Optional, List
|
||||||
|
from pydantic import BaseModel, Field
|
||||||
|
|
||||||
|
|
||||||
|
class ChatMessage(BaseModel):
|
||||||
|
role: str = Field(..., pattern="^(user|assistant|system)$", description="Rol del emisor: user, assistant o system")
|
||||||
|
content: str = Field(..., min_length=1, description="Contenido textual del mensaje")
|
||||||
|
|
||||||
|
|
||||||
|
class ChatRequest(BaseModel):
|
||||||
|
messages: List[ChatMessage] = Field(..., min_length=1, description="Historial de mensajes de la conversación")
|
||||||
|
user_role: Optional[str] = Field("alumno", description="Rol del usuario: alumno, docente, bedelia, admin")
|
||||||
|
|
||||||
|
|
||||||
|
class ChatResponse(BaseModel):
|
||||||
|
response: str = Field(..., description="Respuesta generada por el agente conversacional")
|
||||||
|
|
||||||
|
|
||||||
|
class AISettingsSchema(BaseModel):
|
||||||
|
enabled: bool = Field(True, description="Habilitación del servicio de Asistente IA")
|
||||||
|
base_url: str = Field("http://10.0.0.214:8080/v1", description="URL base de la API compatible OpenAI / Llama.cpp")
|
||||||
|
api_key: str = Field("llama", description="Clave API para autenticación con el servidor local")
|
||||||
|
model: str = Field("qwen3-coder:30b", description="Identificador del modelo en Llama.cpp")
|
||||||
|
model_name: Optional[str] = Field("Qwen3 Coder 30B-A3B (Llama.cpp)", description="Nombre amigable del modelo")
|
||||||
|
temperature: float = Field(0.3, ge=0.0, le=2.0, description="Temperatura para control de variabilidad (0.0 a 2.0)")
|
||||||
|
timeout: int = Field(60, ge=5, le=600, description="Tiempo límite de espera en segundos")
|
||||||
|
context_limit: int = Field(65536, ge=512, description="Ventana de contexto máxima en tokens")
|
||||||
|
output_limit: int = Field(65536, ge=128, description="Límite máximo de salida de tokens")
|
||||||
|
|
||||||
|
|
||||||
|
class AITestConnectionResponse(BaseModel):
|
||||||
|
status: str
|
||||||
|
message: str
|
||||||
|
latency_ms: Optional[float] = None
|
||||||
|
models: Optional[List[str]] = None
|
||||||
+1
-1
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
|||||||
|
|
||||||
setup(
|
setup(
|
||||||
name="edu-space-admin",
|
name="edu-space-admin",
|
||||||
version="3.8.23",
|
version="3.8.24",
|
||||||
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
|
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
|
||||||
author="Edu-Space Development Team",
|
author="Edu-Space Development Team",
|
||||||
author_email="admin@edu-space.com",
|
author_email="admin@edu-space.com",
|
||||||
|
|||||||
@@ -0,0 +1,257 @@
|
|||||||
|
"""
|
||||||
|
Suite de pruebas automatizadas para el módulo de Asistente IA (SDD-009).
|
||||||
|
Valida contratos Pydantic v2, inyección de System Prompts por rol,
|
||||||
|
llamadas asíncronas con httpx (mockeadas) y gestión de configuración administrativa.
|
||||||
|
"""
|
||||||
|
from unittest.mock import AsyncMock, patch, MagicMock
|
||||||
|
import pytest
|
||||||
|
from pydantic import ValidationError
|
||||||
|
from fastapi.testclient import TestClient
|
||||||
|
import httpx
|
||||||
|
from werkzeug.security import generate_password_hash
|
||||||
|
|
||||||
|
from main import app
|
||||||
|
from schemas.ai_chat import ChatMessage, ChatRequest, ChatResponse, AISettingsSchema
|
||||||
|
from routers.ai_chat import generate_system_prompt_for_role
|
||||||
|
from app.models.setting import SystemSetting
|
||||||
|
from app.models.user import User
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_pydantic_schemas_validation():
|
||||||
|
"""Valida restricciones de datos y tipos en Pydantic v2."""
|
||||||
|
# 1. ChatMessage válido
|
||||||
|
msg = ChatMessage(role="user", content="¿Dónde curso hoy?")
|
||||||
|
assert msg.role == "user"
|
||||||
|
assert msg.content == "¿Dónde curso hoy?"
|
||||||
|
|
||||||
|
# 2. Rechazo por rol inválido
|
||||||
|
with pytest.raises(ValidationError):
|
||||||
|
ChatMessage(role="hacker", content="Mensaje")
|
||||||
|
|
||||||
|
# 3. Rechazo por contenido vacío
|
||||||
|
with pytest.raises(ValidationError):
|
||||||
|
ChatMessage(role="user", content="")
|
||||||
|
|
||||||
|
# 4. ChatRequest válido
|
||||||
|
req = ChatRequest(messages=[msg], user_role="docente")
|
||||||
|
assert len(req.messages) == 1
|
||||||
|
assert req.user_role == "docente"
|
||||||
|
|
||||||
|
# 5. ChatRequest rechaza lista vacía de mensajes
|
||||||
|
with pytest.raises(ValidationError):
|
||||||
|
ChatRequest(messages=[], user_role="alumno")
|
||||||
|
|
||||||
|
# 6. AISettingsSchema con validaciones de rango
|
||||||
|
ai_settings = AISettingsSchema(temperature=0.7, timeout=120)
|
||||||
|
assert ai_settings.temperature == 0.7
|
||||||
|
assert ai_settings.timeout == 120
|
||||||
|
|
||||||
|
with pytest.raises(ValidationError):
|
||||||
|
AISettingsSchema(temperature=3.5) # Mayor a 2.0
|
||||||
|
|
||||||
|
|
||||||
|
def test_system_prompt_generation_by_role():
|
||||||
|
"""Verifica que el System Prompt inyectado se adapte rigurosamente al rol."""
|
||||||
|
# Docente
|
||||||
|
prompt_docente = generate_system_prompt_for_role("docente")
|
||||||
|
assert "DOCENTES y PROFESORES" in prompt_docente
|
||||||
|
assert "Gradebook" in prompt_docente
|
||||||
|
assert "Google Meet" in prompt_docente
|
||||||
|
assert "Bedelía" in prompt_docente # Restricción de permisos
|
||||||
|
|
||||||
|
# Alumno
|
||||||
|
prompt_alumno = generate_system_prompt_for_role("alumno")
|
||||||
|
assert "ESTUDIANTES y ALUMNOS" in prompt_alumno
|
||||||
|
assert "Cartelera de Clases de Hoy" in prompt_alumno
|
||||||
|
assert "TERMINANTEMENTE PROHIBIDO" in prompt_alumno
|
||||||
|
|
||||||
|
# Bedelía / Admin
|
||||||
|
prompt_bedelia = generate_system_prompt_for_role("bedelia")
|
||||||
|
assert "BEDELÍA y ADMINISTRADORES" in prompt_bedelia
|
||||||
|
assert "Circuito Secuencial Canónico de 9 Pasos" in prompt_bedelia
|
||||||
|
assert "Matriz de Conflictos" in prompt_bedelia
|
||||||
|
assert "Moodle 4.1" in prompt_bedelia
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_public_config_endpoint():
|
||||||
|
"""Verifica el endpoint público /api/chat/config utilizado por el widget."""
|
||||||
|
client = TestClient(app)
|
||||||
|
response = client.get("/api/chat/config")
|
||||||
|
assert response.status_code == 200
|
||||||
|
data = response.json()
|
||||||
|
assert data["status"] == "success"
|
||||||
|
assert "enabled" in data
|
||||||
|
assert "model" in data
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_endpoint_success_mock(init_database):
|
||||||
|
"""Simula una respuesta exitosa 200 de Llama.cpp."""
|
||||||
|
client = TestClient(app)
|
||||||
|
|
||||||
|
mock_response = MagicMock()
|
||||||
|
mock_response.status_code = 200
|
||||||
|
mock_response.json.return_value = {
|
||||||
|
"choices": [
|
||||||
|
{
|
||||||
|
"message": {
|
||||||
|
"role": "assistant",
|
||||||
|
"content": "Para consultar el aula de cursada hoy, accede a la Cartelera de Clases en tu panel principal."
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
mock_response.raise_for_status = MagicMock()
|
||||||
|
|
||||||
|
with patch("httpx.AsyncClient.post", new_callable=AsyncMock) as mock_post:
|
||||||
|
mock_post.return_value = mock_response
|
||||||
|
|
||||||
|
# Prueba en /api/chat
|
||||||
|
res = client.post("/api/chat", json={
|
||||||
|
"messages": [{"role": "user", "content": "¿En qué aula curso hoy?"}],
|
||||||
|
"user_role": "alumno"
|
||||||
|
})
|
||||||
|
assert res.status_code == 200
|
||||||
|
data = res.json()
|
||||||
|
assert "response" in data
|
||||||
|
assert "Cartelera" in data["response"]
|
||||||
|
|
||||||
|
# Prueba en /api/v1/chat
|
||||||
|
res_v1 = client.post("/api/v1/chat", json={
|
||||||
|
"messages": [{"role": "user", "content": "¿Cómo reservo un aula?"}],
|
||||||
|
"user_role": "docente"
|
||||||
|
})
|
||||||
|
assert res_v1.status_code == 200
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_endpoint_validation_error():
|
||||||
|
"""Valida que una petición malformada responda 422 Unprocessable Entity."""
|
||||||
|
client = TestClient(app)
|
||||||
|
|
||||||
|
# Mensajes vacíos
|
||||||
|
res = client.post("/api/chat", json={
|
||||||
|
"messages": [],
|
||||||
|
"user_role": "alumno"
|
||||||
|
})
|
||||||
|
assert res.status_code == 422
|
||||||
|
|
||||||
|
# Mensaje sin contenido
|
||||||
|
res2 = client.post("/api/chat", json={
|
||||||
|
"messages": [{"role": "user", "content": ""}]
|
||||||
|
})
|
||||||
|
assert res2.status_code == 422
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_endpoint_connection_failure():
|
||||||
|
"""Simula error de conexión con el servidor Llama.cpp y verifica HTTP 503."""
|
||||||
|
client = TestClient(app)
|
||||||
|
|
||||||
|
with patch("httpx.AsyncClient.post", new_callable=AsyncMock) as mock_post:
|
||||||
|
mock_post.side_effect = httpx.ConnectError("Connection refused")
|
||||||
|
|
||||||
|
res = client.post("/api/chat", json={
|
||||||
|
"messages": [{"role": "user", "content": "Hola tutor"}]
|
||||||
|
})
|
||||||
|
assert res.status_code == 503
|
||||||
|
data = res.json()
|
||||||
|
assert "detail" in data
|
||||||
|
assert "10.0.0.214" in data["detail"] or "motor de IA" in data["detail"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_endpoint_timeout_failure():
|
||||||
|
"""Simula tiempo de espera agotado y verifica HTTP 504."""
|
||||||
|
client = TestClient(app)
|
||||||
|
|
||||||
|
with patch("httpx.AsyncClient.post", new_callable=AsyncMock) as mock_post:
|
||||||
|
mock_post.side_effect = httpx.TimeoutException("Read timed out")
|
||||||
|
|
||||||
|
res = client.post("/api/chat", json={
|
||||||
|
"messages": [{"role": "user", "content": "Pregunta compleja"}]
|
||||||
|
})
|
||||||
|
assert res.status_code == 504
|
||||||
|
data = res.json()
|
||||||
|
assert "tiempo límite" in data["detail"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_ai_chat_disabled_flow(init_database):
|
||||||
|
"""Verifica que si ai_chat_enabled es false, se retorne 503 inmediatamente."""
|
||||||
|
client = TestClient(app)
|
||||||
|
|
||||||
|
SystemSetting.set_value("ai_chat_enabled", "false", category="ai")
|
||||||
|
try:
|
||||||
|
res = client.post("/api/chat", json={
|
||||||
|
"messages": [{"role": "user", "content": "Test"}]
|
||||||
|
})
|
||||||
|
assert res.status_code == 503
|
||||||
|
assert "deshabilitado" in res.json()["detail"].lower()
|
||||||
|
finally:
|
||||||
|
SystemSetting.set_value("ai_chat_enabled", "true", category="ai")
|
||||||
|
|
||||||
|
|
||||||
|
def test_admin_settings_ai_crud_and_test_connection(init_database):
|
||||||
|
"""Verifica los endpoints administrativos de guardado y prueba de conexión de IA."""
|
||||||
|
client = TestClient(app)
|
||||||
|
|
||||||
|
# 1. Crear usuario Admin
|
||||||
|
u = User(
|
||||||
|
email="admin.ai@unicaba.edu.ar",
|
||||||
|
name="Admin AI Settings",
|
||||||
|
password_hash=generate_password_hash("AiAdminSecret!"),
|
||||||
|
role="ADMIN",
|
||||||
|
is_active=True
|
||||||
|
)
|
||||||
|
init_database.session.add(u)
|
||||||
|
init_database.session.commit()
|
||||||
|
|
||||||
|
# Login
|
||||||
|
login_res = client.post("/api/v1/auth/login", json={
|
||||||
|
"email": "admin.ai@unicaba.edu.ar",
|
||||||
|
"password": "AiAdminSecret!"
|
||||||
|
})
|
||||||
|
token = login_res.json()["access_token"]
|
||||||
|
headers = {"Authorization": f"Bearer {token}"}
|
||||||
|
|
||||||
|
# 2. Consultar GET /admin/settings/all
|
||||||
|
all_res = client.get("/api/v1/settings/all", headers=headers)
|
||||||
|
assert all_res.status_code == 200
|
||||||
|
all_data = all_res.json()
|
||||||
|
assert "ai" in all_data["settings"]
|
||||||
|
assert all_data["settings"]["ai"]["model"] == "qwen3-coder:30b"
|
||||||
|
|
||||||
|
# 3. Actualizar POST /admin/settings/ai
|
||||||
|
update_res = client.post("/api/v1/settings/ai", headers=headers, json={
|
||||||
|
"enabled": True,
|
||||||
|
"base_url": "http://10.0.0.214:8080/v1",
|
||||||
|
"api_key": "new_secret_key",
|
||||||
|
"model": "qwen3-coder:30b",
|
||||||
|
"model_name": "Qwen3 Coder 30B (Test)",
|
||||||
|
"temperature": 0.25,
|
||||||
|
"timeout": 45,
|
||||||
|
"context_limit": 32768,
|
||||||
|
"output_limit": 16384
|
||||||
|
})
|
||||||
|
assert update_res.status_code == 200
|
||||||
|
assert update_res.json()["status"] == "success"
|
||||||
|
|
||||||
|
# Verificar persistencia en base de datos
|
||||||
|
assert SystemSetting.get_value("ai_chat_model_name") == "Qwen3 Coder 30B (Test)"
|
||||||
|
assert SystemSetting.get_decrypted_value("ai_chat_api_key") == "new_secret_key"
|
||||||
|
|
||||||
|
# 4. Probar conexión POST /admin/settings/ai/test con mock
|
||||||
|
mock_models_resp = MagicMock()
|
||||||
|
mock_models_resp.status_code = 200
|
||||||
|
mock_models_resp.json.return_value = {
|
||||||
|
"data": [{"id": "qwen3-coder:30b"}, {"id": "llama-3-8b"}]
|
||||||
|
}
|
||||||
|
|
||||||
|
with patch("httpx.AsyncClient.get", new_callable=AsyncMock) as mock_get:
|
||||||
|
mock_get.return_value = mock_models_resp
|
||||||
|
|
||||||
|
test_res = client.post("/api/v1/settings/ai/test", headers=headers, json={
|
||||||
|
"base_url": "http://10.0.0.214:8080/v1",
|
||||||
|
"api_key": "new_secret_key"
|
||||||
|
})
|
||||||
|
assert test_res.status_code == 200
|
||||||
|
test_data = test_res.json()
|
||||||
|
assert test_data["status"] == "success"
|
||||||
|
assert "qwen3-coder:30b" in test_data["models"]
|
||||||
|
assert test_data["latency_ms"] is not None
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "frontend",
|
"name": "frontend",
|
||||||
"version": "3.8.23",
|
"version": "3.8.24",
|
||||||
"description": "",
|
"description": "",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
@@ -0,0 +1,210 @@
|
|||||||
|
/**
|
||||||
|
* ai-chat-widget.js - Lógica interactiva del Asistente IA (SDD-009)
|
||||||
|
* Maneja el estado conversacional, llamadas AJAX al backend FastAPI,
|
||||||
|
* persistencia de sesión y renderizado accesible de mensajes.
|
||||||
|
*/
|
||||||
|
(function() {
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
let isProcessing = false;
|
||||||
|
const STORAGE_KEY = 'edu_space_ai_chat_messages_v1';
|
||||||
|
|
||||||
|
function getContainer() {
|
||||||
|
return document.getElementById('aiChatContainer');
|
||||||
|
}
|
||||||
|
|
||||||
|
function getUserRole() {
|
||||||
|
const container = getContainer();
|
||||||
|
return (container ? container.getAttribute('data-user-role') : 'alumno') || 'alumno';
|
||||||
|
}
|
||||||
|
|
||||||
|
function getWelcomeMessage(role) {
|
||||||
|
const r = (role || 'alumno').toLowerCase();
|
||||||
|
if (r.includes('docente') || r.includes('profesor') || r.includes('teacher')) {
|
||||||
|
return "¡Hola! 👋 Soy tu <strong>Tutor de Edu-Space</strong> para Docentes. Puedo orientarte sobre cómo consultar tus aulas asignadas, cargar calificaciones en el <strong>Gradebook</strong>, cerrar actas de regularidad y gestionar enlaces de Google Meet. ¿En qué puedo asistirte?";
|
||||||
|
} else if (r.includes('bedelia') || r.includes('admin')) {
|
||||||
|
return "¡Hola! 👋 Soy el <strong>Asistente Técnico de Bedelía</strong>. Puedo ayudarte con el <strong>flujo secuencial de 9 pasos</strong>, matriz de conflictos áulicos, el Optimizador Genético, importación masiva de Google Sheets y la cola de Moodle 4.1. ¿Qué tarea deseas revisar?";
|
||||||
|
} else {
|
||||||
|
return "¡Hola! 👋 Soy tu <strong>Tutor de Cursada</strong>. Puedo ayudarte a consultar en qué aula o sala virtual cursas hoy, ver tus horarios semanales, verificar materias inscriptas y notas académicas. ¿Cuál es tu consulta?";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function loadHistory() {
|
||||||
|
try {
|
||||||
|
const raw = sessionStorage.getItem(STORAGE_KEY);
|
||||||
|
return raw ? JSON.parse(raw) : [];
|
||||||
|
} catch (e) {
|
||||||
|
return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function saveHistory(messages) {
|
||||||
|
try {
|
||||||
|
sessionStorage.setItem(STORAGE_KEY, JSON.stringify(messages));
|
||||||
|
} catch (e) {}
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderMarkdown(text) {
|
||||||
|
if (!text) return '';
|
||||||
|
let escaped = text
|
||||||
|
.replace(/&/g, '&')
|
||||||
|
.replace(/</g, '<')
|
||||||
|
.replace(/>/g, '>');
|
||||||
|
|
||||||
|
// Negrita **texto**
|
||||||
|
escaped = escaped.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
|
||||||
|
// Cursiva *texto*
|
||||||
|
escaped = escaped.replace(/\*(.*?)\*/g, '<em>$1</em>');
|
||||||
|
// Código inline `codigo`
|
||||||
|
escaped = escaped.replace(/`([^`]+)`/g, '<code>$1</code>');
|
||||||
|
// Saltos de línea
|
||||||
|
escaped = escaped.replace(/\n/g, '<br>');
|
||||||
|
|
||||||
|
return escaped;
|
||||||
|
}
|
||||||
|
|
||||||
|
function appendMessage(role, content, save = true) {
|
||||||
|
const messagesContainer = document.getElementById('aiChatMessages');
|
||||||
|
if (!messagesContainer) return;
|
||||||
|
|
||||||
|
const isUser = role === 'user';
|
||||||
|
const msgDiv = document.createElement('div');
|
||||||
|
msgDiv.className = `ai-msg ${isUser ? 'ai-msg-user' : 'ai-msg-assistant'}`;
|
||||||
|
msgDiv.innerHTML = isUser ? renderMarkdown(content) : renderMarkdown(content);
|
||||||
|
|
||||||
|
messagesContainer.appendChild(msgDiv);
|
||||||
|
messagesContainer.scrollTop = messagesContainer.scrollHeight;
|
||||||
|
|
||||||
|
if (save) {
|
||||||
|
const history = loadHistory();
|
||||||
|
history.push({ role, content });
|
||||||
|
saveHistory(history);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function initChat() {
|
||||||
|
const launcher = document.getElementById('aiChatLauncher');
|
||||||
|
const panel = document.getElementById('aiChatPanel');
|
||||||
|
const closeBtn = document.getElementById('aiChatCloseBtn');
|
||||||
|
const clearBtn = document.getElementById('aiChatClearBtn');
|
||||||
|
const textarea = document.getElementById('aiChatInput');
|
||||||
|
const form = document.getElementById('aiChatForm');
|
||||||
|
|
||||||
|
if (!launcher || !panel) return;
|
||||||
|
|
||||||
|
// Toggle panel
|
||||||
|
launcher.addEventListener('click', () => {
|
||||||
|
const isHidden = panel.classList.contains('d-none');
|
||||||
|
if (isHidden) {
|
||||||
|
panel.classList.remove('d-none');
|
||||||
|
launcher.style.transform = 'scale(0.9)';
|
||||||
|
setTimeout(() => {
|
||||||
|
if (textarea) textarea.focus();
|
||||||
|
}, 100);
|
||||||
|
} else {
|
||||||
|
panel.classList.add('d-none');
|
||||||
|
launcher.style.transform = '';
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
if (closeBtn) {
|
||||||
|
closeBtn.addEventListener('click', () => {
|
||||||
|
panel.classList.add('d-none');
|
||||||
|
launcher.style.transform = '';
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// Limpiar conversación
|
||||||
|
if (clearBtn) {
|
||||||
|
clearBtn.addEventListener('click', () => {
|
||||||
|
if (confirm('¿Deseas reiniciar la conversación con el tutor?')) {
|
||||||
|
sessionStorage.removeItem(STORAGE_KEY);
|
||||||
|
const messagesContainer = document.getElementById('aiChatMessages');
|
||||||
|
if (messagesContainer) messagesContainer.innerHTML = '';
|
||||||
|
const role = getUserRole();
|
||||||
|
appendMessage('assistant', getWelcomeMessage(role), false);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// Cargar historial previo o mensaje de bienvenida
|
||||||
|
const history = loadHistory();
|
||||||
|
const role = getUserRole();
|
||||||
|
if (history.length > 0) {
|
||||||
|
history.forEach(msg => appendMessage(msg.role, msg.content, false));
|
||||||
|
} else {
|
||||||
|
appendMessage('assistant', getWelcomeMessage(role), false);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Auto-resize de textarea y atajo Enter
|
||||||
|
if (textarea) {
|
||||||
|
textarea.addEventListener('keydown', (e) => {
|
||||||
|
if (e.key === 'Enter' && !e.shiftKey) {
|
||||||
|
e.preventDefault();
|
||||||
|
if (form) form.dispatchEvent(new Event('submit', { cancelable: true }));
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
window.handleAiChatSubmit = async function(e) {
|
||||||
|
if (e) e.preventDefault();
|
||||||
|
if (isProcessing) return;
|
||||||
|
|
||||||
|
const textarea = document.getElementById('aiChatInput');
|
||||||
|
const typing = document.getElementById('aiChatTyping');
|
||||||
|
const sendBtn = document.getElementById('aiChatSendBtn');
|
||||||
|
if (!textarea) return;
|
||||||
|
|
||||||
|
const query = textarea.value.trim();
|
||||||
|
if (!query) return;
|
||||||
|
|
||||||
|
// Limpiar campo de texto y mostrar mensaje del usuario
|
||||||
|
textarea.value = '';
|
||||||
|
appendMessage('user', query, true);
|
||||||
|
|
||||||
|
// Bloquear UI e indicar escritura
|
||||||
|
isProcessing = true;
|
||||||
|
if (typing) typing.classList.remove('d-none');
|
||||||
|
if (sendBtn) sendBtn.disabled = true;
|
||||||
|
|
||||||
|
const userRole = getUserRole();
|
||||||
|
const rawHistory = loadHistory();
|
||||||
|
const payloadMessages = rawHistory.map(m => ({
|
||||||
|
role: m.role,
|
||||||
|
content: m.content
|
||||||
|
}));
|
||||||
|
|
||||||
|
try {
|
||||||
|
const res = await fetch('/api/chat', {
|
||||||
|
method: 'POST',
|
||||||
|
headers: { 'Content-Type': 'application/json' },
|
||||||
|
body: JSON.stringify({
|
||||||
|
messages: payloadMessages,
|
||||||
|
user_role: userRole
|
||||||
|
})
|
||||||
|
});
|
||||||
|
|
||||||
|
const data = await res.json();
|
||||||
|
if (res.ok && data.response) {
|
||||||
|
appendMessage('assistant', data.response, true);
|
||||||
|
} else {
|
||||||
|
const errorMsg = data.detail || data.message || 'El motor de IA local no está respondiendo en este momento.';
|
||||||
|
appendMessage('assistant', `⚠️ <em>${errorMsg}</em>`, false);
|
||||||
|
}
|
||||||
|
} catch (err) {
|
||||||
|
appendMessage('assistant', `⚠️ <em>No se pudo comunicar con el servidor local de IA: ${err.message}</em>`, false);
|
||||||
|
} finally {
|
||||||
|
isProcessing = false;
|
||||||
|
if (typing) typing.classList.add('d-none');
|
||||||
|
if (sendBtn) sendBtn.disabled = false;
|
||||||
|
textarea.focus();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
if (document.readyState === 'loading') {
|
||||||
|
document.addEventListener('DOMContentLoaded', initChat);
|
||||||
|
} else {
|
||||||
|
initChat();
|
||||||
|
}
|
||||||
|
})();
|
||||||
+30
-3
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
|
|||||||
});
|
});
|
||||||
|
|
||||||
// Versiones institucionales del sistema
|
// Versiones institucionales del sistema
|
||||||
const APP_VERSION = '3.8.23';
|
const APP_VERSION = '3.8.24';
|
||||||
const FRONTEND_VERSION = '3.8.23';
|
const FRONTEND_VERSION = '3.8.24';
|
||||||
const BACKEND_VERSION = '3.8.23';
|
const BACKEND_VERSION = '3.8.24';
|
||||||
|
|
||||||
env.addGlobal('app_version', APP_VERSION);
|
env.addGlobal('app_version', APP_VERSION);
|
||||||
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
||||||
@@ -365,6 +365,33 @@ app.use('/api/genetic', async (req, res) => {
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// Proxy transparente hacia la API del Asistente IA (/api/chat)
|
||||||
|
app.use('/api/chat', async (req, res) => {
|
||||||
|
try {
|
||||||
|
const token = req.cookies.auth_token;
|
||||||
|
const backendBase = (process.env.FLASK_API_URL || 'http://localhost:5000/api/v1').replace(/\/api\/v1\/?$/, '');
|
||||||
|
const targetUrl = `${backendBase}/api/chat${req.url}`;
|
||||||
|
const headers = { ...req.headers };
|
||||||
|
delete headers.host;
|
||||||
|
delete headers['content-length'];
|
||||||
|
if (token && !headers.authorization) {
|
||||||
|
headers.authorization = `Bearer ${token}`;
|
||||||
|
}
|
||||||
|
const resp = await axios({
|
||||||
|
method: req.method,
|
||||||
|
url: targetUrl,
|
||||||
|
data: req.body,
|
||||||
|
params: req.query,
|
||||||
|
headers,
|
||||||
|
validateStatus: () => true
|
||||||
|
});
|
||||||
|
return res.status(resp.status).json(resp.data);
|
||||||
|
} catch (err) {
|
||||||
|
console.error('API chat proxy error:', err.message);
|
||||||
|
return res.status(500).json({ error: 'ProxyError', message: 'Error de comunicación con el Asistente IA: ' + err.message });
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
|
||||||
app.use('/', indexRoutes);
|
app.use('/', indexRoutes);
|
||||||
app.use('/auth', authRoutes);
|
app.use('/auth', authRoutes);
|
||||||
|
|||||||
@@ -1869,6 +1869,8 @@ router.post('/settings/moodle/test', forwardSettingsAction);
|
|||||||
router.post('/settings/moodle/sync', forwardSettingsAction);
|
router.post('/settings/moodle/sync', forwardSettingsAction);
|
||||||
router.get('/settings/moodle/stats', forwardSettingsAction);
|
router.get('/settings/moodle/stats', forwardSettingsAction);
|
||||||
router.post('/settings/ui', forwardSettingsAction);
|
router.post('/settings/ui', forwardSettingsAction);
|
||||||
|
router.post('/settings/ai', forwardSettingsAction);
|
||||||
|
router.post('/settings/ai/test', forwardSettingsAction);
|
||||||
router.post('/settings/reset_system', forwardSettingsAction);
|
router.post('/settings/reset_system', forwardSettingsAction);
|
||||||
router.post('/system/reset', forwardSettingsAction);
|
router.post('/system/reset', forwardSettingsAction);
|
||||||
|
|
||||||
|
|||||||
@@ -88,6 +88,11 @@
|
|||||||
<i class="bi bi-window-desktop me-2 text-primary"></i>Interfaz & Dashboard
|
<i class="bi bi-window-desktop me-2 text-primary"></i>Interfaz & Dashboard
|
||||||
</button>
|
</button>
|
||||||
</li>
|
</li>
|
||||||
|
<li class="nav-item" role="presentation">
|
||||||
|
<button class="nav-link" id="tab-ai-btn" data-bs-toggle="tab" data-bs-target="#tab-ai" type="button" role="tab">
|
||||||
|
<i class="bi bi-cpu me-2 text-success"></i>Asistente IA & LLM Local
|
||||||
|
</button>
|
||||||
|
</li>
|
||||||
<li class="nav-item" role="presentation">
|
<li class="nav-item" role="presentation">
|
||||||
<button class="nav-link text-danger" id="tab-maintenance-btn" data-bs-toggle="tab" data-bs-target="#tab-maintenance" type="button" role="tab">
|
<button class="nav-link text-danger" id="tab-maintenance-btn" data-bs-toggle="tab" data-bs-target="#tab-maintenance" type="button" role="tab">
|
||||||
<i class="bi bi-radioactive me-2 text-danger"></i>Mantenimiento & Reinicio
|
<i class="bi bi-radioactive me-2 text-danger"></i>Mantenimiento & Reinicio
|
||||||
@@ -555,7 +560,165 @@
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- ========================================== -->
|
<!-- ========================================== -->
|
||||||
<!-- PESTAÑA 5: MANTENIMIENTO & REINICIO -->
|
<!-- PESTAÑA 5: ASISTENTE IA & LLM LOCAL (SDD-009) -->
|
||||||
|
<!-- ========================================== -->
|
||||||
|
<div class="tab-pane fade" id="tab-ai" role="tabpanel">
|
||||||
|
<div class="row g-4">
|
||||||
|
<div class="col-lg-8">
|
||||||
|
<form id="aiConfigForm" onsubmit="saveAiConfig(event)">
|
||||||
|
<!-- Estado General del Asistente -->
|
||||||
|
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
|
||||||
|
<h6 class="fw-bold mb-3 d-flex align-items-center">
|
||||||
|
<i class="bi bi-robot text-success me-2"></i>Estado del Tutor Inteligente
|
||||||
|
</h6>
|
||||||
|
|
||||||
|
<div class="form-check form-switch p-0 d-flex align-items-center justify-content-between mb-3 border rounded p-3 bg-body">
|
||||||
|
<div class="pe-3">
|
||||||
|
<label class="form-check-label fw-bold mb-1 d-block text-body" for="ai_enabled_switch">
|
||||||
|
Habilitar Asistente IA Conversacional en la Plataforma
|
||||||
|
</label>
|
||||||
|
<div class="text-muted small">
|
||||||
|
Despliega el widget de chat contextual flotante en la interfaz para todos los perfiles de usuario autenticados (Docentes, Alumnos y Bedelía).
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<input class="form-check-input ms-2 fs-4" type="checkbox" role="switch" id="ai_enabled_switch"
|
||||||
|
{% if not settings or not settings.ai or settings.ai.enabled %}checked{% endif %}>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Parámetros de Conexión Llama.cpp / OpenAI Compatible -->
|
||||||
|
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
|
||||||
|
<h6 class="fw-bold mb-3 d-flex align-items-center">
|
||||||
|
<i class="bi bi-hdd-network text-primary me-2"></i>Conexión al Servidor de Inferencia Local
|
||||||
|
</h6>
|
||||||
|
|
||||||
|
<div class="row g-3">
|
||||||
|
<div class="col-md-8">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_base_url">URL Base de la API (Endpoint v1)</label>
|
||||||
|
<div class="input-group input-group-sm">
|
||||||
|
<span class="input-group-text"><i class="bi bi-link-45deg"></i></span>
|
||||||
|
<input type="url" class="form-control" id="ai_base_url" name="base_url"
|
||||||
|
placeholder="http://10.0.0.214:8080/v1"
|
||||||
|
value="{{ settings.ai.base_url if settings and settings.ai else 'http://10.0.0.214:8080/v1' }}" required>
|
||||||
|
</div>
|
||||||
|
<div class="form-text small">Endpoint compatible con OpenAI expuesto por Llama.cpp en la red local institucional.</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-4">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_api_key">Clave API (API Key)</label>
|
||||||
|
<div class="input-group input-group-sm">
|
||||||
|
<span class="input-group-text"><i class="bi bi-key"></i></span>
|
||||||
|
<input type="password" class="form-control" id="ai_api_key" name="api_key"
|
||||||
|
placeholder="••••••••••••"
|
||||||
|
value="{{ settings.ai.api_key if settings and settings.ai else 'llama' }}">
|
||||||
|
</div>
|
||||||
|
<div class="form-text small">Token Bearer para autorización con el motor de IA.</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Configuración del Modelo y Límites de Contexto -->
|
||||||
|
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
|
||||||
|
<h6 class="fw-bold mb-3 d-flex align-items-center">
|
||||||
|
<i class="bi bi-cpu-fill text-info me-2"></i>Modelo de Lenguaje & Parámetros de Generación
|
||||||
|
</h6>
|
||||||
|
|
||||||
|
<div class="row g-3 mb-3">
|
||||||
|
<div class="col-md-6">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_model">ID del Modelo (Llama.cpp / Ollama)</label>
|
||||||
|
<input type="text" class="form-control form-control-sm" id="ai_model" name="model"
|
||||||
|
placeholder="qwen3-coder:30b"
|
||||||
|
value="{{ settings.ai.model if settings and settings.ai else 'qwen3-coder:30b' }}" required>
|
||||||
|
<div class="form-text small">Identificador exacto configurado en el servidor de inferencia.</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-6">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_model_name">Nombre Descriptivo</label>
|
||||||
|
<input type="text" class="form-control form-control-sm" id="ai_model_name" name="model_name"
|
||||||
|
placeholder="Qwen3 Coder 30B-A3B (Llama.cpp)"
|
||||||
|
value="{{ settings.ai.model_name if settings and settings.ai else 'Qwen3 Coder 30B-A3B (Llama.cpp)' }}">
|
||||||
|
<div class="form-text small">Etiqueta mostrada en el encabezado del widget de chat.</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="row g-3">
|
||||||
|
<div class="col-md-3">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_temperature">Temperatura</label>
|
||||||
|
<input type="number" step="0.05" min="0.0" max="2.0" class="form-control form-control-sm" id="ai_temperature" name="temperature"
|
||||||
|
value="{{ settings.ai.temperature if settings and settings.ai else '0.3' }}" required>
|
||||||
|
<div class="form-text small">0.3 recomendado para respuestas técnicas exactas.</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-3">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_timeout">Timeout (Segundos)</label>
|
||||||
|
<input type="number" min="5" max="600" class="form-control form-control-sm" id="ai_timeout" name="timeout"
|
||||||
|
value="{{ settings.ai.timeout if settings and settings.ai else '60' }}" required>
|
||||||
|
<div class="form-text small">Tiempo límite para inferencias asíncronas no bloqueantes.</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-3">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_context_limit">Tokens Contexto</label>
|
||||||
|
<input type="number" class="form-control form-control-sm" id="ai_context_limit" name="context_limit"
|
||||||
|
value="{{ settings.ai.context_limit if settings and settings.ai else '65536' }}">
|
||||||
|
<div class="form-text small">Ventana máxima de contexto del modelo (KV Cache).</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="col-md-3">
|
||||||
|
<label class="form-label small fw-semibold" for="ai_output_limit">Tokens Salida</label>
|
||||||
|
<input type="number" class="form-control form-control-sm" id="ai_output_limit" name="output_limit"
|
||||||
|
value="{{ settings.ai.output_limit if settings and settings.ai else '65536' }}">
|
||||||
|
<div class="form-text small">Límite de tokens de la respuesta generada.</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Contenedor de Resultado de Prueba -->
|
||||||
|
<div id="aiTestResult" class="mb-3"></div>
|
||||||
|
|
||||||
|
<!-- Acciones del Formulario -->
|
||||||
|
<div class="d-flex justify-content-between flex-wrap gap-2">
|
||||||
|
<button type="button" class="btn btn-outline-info btn-sm px-3" id="btnTestAi" onclick="testAiConnection()">
|
||||||
|
<i class="bi bi-activity me-1"></i>Probar Conexión con Llama.cpp
|
||||||
|
</button>
|
||||||
|
<button type="submit" class="btn btn-success btn-sm px-4" id="btnSaveAi">
|
||||||
|
<i class="bi bi-check2-circle me-1"></i>Guardar Configuración de IA
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Panel Lateral: Arquitectura y Roles del Agente -->
|
||||||
|
<div class="col-lg-4">
|
||||||
|
<div class="card border-0 bg-success-subtle text-success-emphasis p-3 rounded-3 mb-3 shadow-sm">
|
||||||
|
<h6 class="fw-bold mb-2"><i class="bi bi-shield-check me-2"></i>Arquitectura de Seguridad & Roles</h6>
|
||||||
|
<p class="small mb-2">
|
||||||
|
El backend inyecta automáticamente un <strong>System Prompt contextual</strong> según el rol del usuario autenticado:
|
||||||
|
</p>
|
||||||
|
<ul class="small mb-2 ps-3">
|
||||||
|
<li><strong>Docente:</strong> Guía de reserva de aulas, actas en Gradebook y enlaces de Google Meet.</li>
|
||||||
|
<li><strong>Alumno:</strong> Guía de cursada, aulas del día y horarios. <em>Prohibición total de funciones de gestión.</em></li>
|
||||||
|
<li><strong>Bedelía / Admin:</strong> Soporte Nivel 1 en el flujo de 9 pasos, resolución de colisiones y Moodle 4.1.</li>
|
||||||
|
</ul>
|
||||||
|
<div class="text-success small fw-semibold">
|
||||||
|
<i class="bi bi-lightning-charge me-1"></i>Inferencia 100% asíncrona no bloqueante con <code>httpx</code>.
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="card border-0 bg-body-tertiary p-3 rounded-3">
|
||||||
|
<h6 class="fw-bold mb-2"><i class="bi bi-server me-1"></i>Topología del Servidor Local</h6>
|
||||||
|
<div class="small text-muted mb-2">
|
||||||
|
<strong>Host:</strong> <code>10.0.0.214:8080</code><br>
|
||||||
|
<strong>Motor:</strong> Llama.cpp Server (OpenAI Compatible)<br>
|
||||||
|
<strong>Modelo Oficial:</strong> Qwen3 Coder 30B-A3B<br>
|
||||||
|
<strong>Hardware:</strong> Servidor Dedicado GPU UniCABA
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- ========================================== -->
|
||||||
|
<!-- PESTAÑA 6: MANTENIMIENTO & REINICIO -->
|
||||||
<!-- ========================================== -->
|
<!-- ========================================== -->
|
||||||
<div class="tab-pane fade" id="tab-maintenance" role="tabpanel">
|
<div class="tab-pane fade" id="tab-maintenance" role="tabpanel">
|
||||||
<div class="row g-4">
|
<div class="row g-4">
|
||||||
@@ -1251,6 +1414,92 @@ async function saveUiConfig(e) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// -------------------------------------------------------------
|
||||||
|
// Guardar Configuración del Asistente IA (Llama.cpp)
|
||||||
|
// -------------------------------------------------------------
|
||||||
|
async function saveAiConfig(e) {
|
||||||
|
e.preventDefault();
|
||||||
|
const btn = document.getElementById('btnSaveAi');
|
||||||
|
btn.disabled = true;
|
||||||
|
btn.innerHTML = '<span class="spinner-border spinner-border-sm me-1"></span>Guardando...';
|
||||||
|
|
||||||
|
const payload = {
|
||||||
|
enabled: document.getElementById('ai_enabled_switch').checked,
|
||||||
|
base_url: document.getElementById('ai_base_url').value.trim(),
|
||||||
|
api_key: document.getElementById('ai_api_key').value.trim(),
|
||||||
|
model: document.getElementById('ai_model').value.trim(),
|
||||||
|
model_name: document.getElementById('ai_model_name').value.trim(),
|
||||||
|
temperature: parseFloat(document.getElementById('ai_temperature').value) || 0.3,
|
||||||
|
timeout: parseInt(document.getElementById('ai_timeout').value, 10) || 60,
|
||||||
|
context_limit: parseInt(document.getElementById('ai_context_limit').value, 10) || 65536,
|
||||||
|
output_limit: parseInt(document.getElementById('ai_output_limit').value, 10) || 65536
|
||||||
|
};
|
||||||
|
|
||||||
|
try {
|
||||||
|
const res = await fetch('/admin/settings/ai', {
|
||||||
|
method: 'POST',
|
||||||
|
headers: { 'Content-Type': 'application/json' },
|
||||||
|
body: JSON.stringify(payload)
|
||||||
|
});
|
||||||
|
const data = await res.json();
|
||||||
|
if (res.ok && data.status === 'success') {
|
||||||
|
showAlert(data.message || 'Configuración de Asistente IA guardada correctamente.', 'success');
|
||||||
|
} else {
|
||||||
|
showAlert(data.message || 'Error al guardar la configuración de IA.', 'danger');
|
||||||
|
}
|
||||||
|
} catch (err) {
|
||||||
|
showAlert('Error de comunicación con el servidor: ' + err.message, 'danger');
|
||||||
|
} finally {
|
||||||
|
btn.disabled = false;
|
||||||
|
btn.innerHTML = '<i class="bi bi-check2-circle me-1"></i>Guardar Configuración de IA';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// -------------------------------------------------------------
|
||||||
|
// Probar Conexión con Servidor Llama.cpp Local
|
||||||
|
// -------------------------------------------------------------
|
||||||
|
async function testAiConnection() {
|
||||||
|
const btn = document.getElementById('btnTestAi');
|
||||||
|
const resultBox = document.getElementById('aiTestResult');
|
||||||
|
btn.disabled = true;
|
||||||
|
btn.innerHTML = '<span class="spinner-border spinner-border-sm me-1"></span>Conectando...';
|
||||||
|
resultBox.innerHTML = '<div class="alert alert-info py-2 px-3 small mb-0"><span class="spinner-border spinner-border-sm me-2"></span>Verificando disponibilidad de Llama.cpp y consultando endpoint de modelos...</div>';
|
||||||
|
|
||||||
|
const payload = {
|
||||||
|
base_url: document.getElementById('ai_base_url').value.trim(),
|
||||||
|
api_key: document.getElementById('ai_api_key').value.trim()
|
||||||
|
};
|
||||||
|
|
||||||
|
try {
|
||||||
|
const res = await fetch('/admin/settings/ai/test', {
|
||||||
|
method: 'POST',
|
||||||
|
headers: { 'Content-Type': 'application/json' },
|
||||||
|
body: JSON.stringify(payload)
|
||||||
|
});
|
||||||
|
const data = await res.json();
|
||||||
|
|
||||||
|
if (res.ok && data.status === 'success') {
|
||||||
|
const modelsList = (data.models && data.models.length > 0) ? ` Modelos detectados: <code>${data.models.join(', ')}</code>` : '';
|
||||||
|
resultBox.innerHTML = `
|
||||||
|
<div class="alert alert-success py-2 px-3 small mb-0 d-flex align-items-center justify-content-between">
|
||||||
|
<div>
|
||||||
|
<i class="bi bi-check-circle-fill me-2"></i><strong>${data.message}</strong>${modelsList}
|
||||||
|
</div>
|
||||||
|
<span class="badge bg-success-subtle text-success-emphasis border border-success-subtle font-monospace">${data.latency_ms || 0} ms</span>
|
||||||
|
</div>`;
|
||||||
|
} else if (data.status === 'warning') {
|
||||||
|
resultBox.innerHTML = `<div class="alert alert-warning py-2 px-3 small mb-0"><i class="bi bi-exclamation-triangle-fill me-2"></i><strong>Aviso:</strong> ${data.message}</div>`;
|
||||||
|
} else {
|
||||||
|
resultBox.innerHTML = `<div class="alert alert-danger py-2 px-3 small mb-0"><i class="bi bi-x-circle-fill me-2"></i><strong>Fallo de conexión:</strong> ${data.message || 'No se pudo contactar al servidor Llama.cpp.'}</div>`;
|
||||||
|
}
|
||||||
|
} catch (err) {
|
||||||
|
resultBox.innerHTML = `<div class="alert alert-danger py-2 px-3 small mb-0"><i class="bi bi-x-circle-fill me-2"></i><strong>Error de red:</strong> ${err.message}</div>`;
|
||||||
|
} finally {
|
||||||
|
btn.disabled = false;
|
||||||
|
btn.innerHTML = '<i class="bi bi-activity me-1"></i>Probar Conexión con Llama.cpp';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
// -------------------------------------------------------------
|
// -------------------------------------------------------------
|
||||||
// Reinicialización Total del Sistema (Requiere Contraseña Admin)
|
// Reinicialización Total del Sistema (Requiere Contraseña Admin)
|
||||||
// -------------------------------------------------------------
|
// -------------------------------------------------------------
|
||||||
|
|||||||
@@ -1780,5 +1780,8 @@
|
|||||||
});
|
});
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
|
{% if auth_user and auth_user.is_authenticated %}
|
||||||
|
{% include "partials/ai_chat_widget.html" %}
|
||||||
|
{% endif %}
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
@@ -0,0 +1,265 @@
|
|||||||
|
{% set current_role_name = (current_user.role if current_user and current_user.role else (user.role if user and user.role else 'alumno')) | lower %}
|
||||||
|
<!-- ===================================================== -->
|
||||||
|
<!-- WIDGET FLOTANTE: ASISTENTE IA Y CHATBOT CONTEXTUAL -->
|
||||||
|
<!-- SDD-009: UniCABA Edu-Space AI Assistant (Llama.cpp) -->
|
||||||
|
<!-- ===================================================== -->
|
||||||
|
|
||||||
|
<div id="aiChatContainer" class="ai-chat-container" data-user-role="{{ current_role_name }}">
|
||||||
|
<!-- Botón Lanzador Flotante -->
|
||||||
|
<button id="aiChatLauncher" class="ai-chat-launcher btn shadow-lg" type="button" aria-label="Abrir Asistente IA" title="Asistente IA - Tutor Contextual UniCABA">
|
||||||
|
<span class="ai-launcher-icon"><i class="bi bi-robot"></i></span>
|
||||||
|
<span class="ai-launcher-badge pulse-dot"></span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
<!-- Panel de Conversación (Expandible) -->
|
||||||
|
<div id="aiChatPanel" class="ai-chat-panel card shadow-lg border-0 d-none" role="dialog" aria-modal="true" aria-labelledby="aiChatTitle">
|
||||||
|
<!-- Cabecera del Chat -->
|
||||||
|
<div class="card-header ai-chat-header d-flex align-items-center justify-content-between p-3 border-bottom">
|
||||||
|
<div class="d-flex align-items-center gap-2 overflow-hidden">
|
||||||
|
<div class="ai-avatar-circle">
|
||||||
|
<i class="bi bi-cpu-fill text-white"></i>
|
||||||
|
</div>
|
||||||
|
<div class="lh-sm text-truncate">
|
||||||
|
<h6 class="mb-0 fw-bold text-truncate text-white" id="aiChatTitle">
|
||||||
|
Tutor Edu-Space
|
||||||
|
<span class="badge bg-success-subtle text-success-emphasis border border-success-subtle ms-1 font-monospace" style="font-size: 0.65rem;">Llama.cpp</span>
|
||||||
|
</h6>
|
||||||
|
<small class="text-white-50" style="font-size: 0.72rem;">
|
||||||
|
<span class="status-indicator-dot me-1"></span>Qwen3 Coder 30B •
|
||||||
|
<span class="text-uppercase fw-semibold text-warning-emphasis" id="aiRoleBadge">{{ current_role_name }}</span>
|
||||||
|
</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="d-flex align-items-center gap-1">
|
||||||
|
<button type="button" class="btn btn-sm btn-outline-light border-0 py-1 px-2" id="aiChatClearBtn" title="Limpiar conversación">
|
||||||
|
<i class="bi bi-trash3"></i>
|
||||||
|
</button>
|
||||||
|
<button type="button" class="btn btn-sm btn-outline-light border-0 py-1 px-2" id="aiChatCloseBtn" title="Minimizar chat">
|
||||||
|
<i class="bi bi-x-lg"></i>
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Cuerpo de Mensajes -->
|
||||||
|
<div class="card-body ai-chat-messages p-3" id="aiChatMessages" tabindex="0">
|
||||||
|
<!-- Mensaje de Bienvenida Inicial generado dinámicamente por JS según el rol -->
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Indicador de Escritura -->
|
||||||
|
<div id="aiChatTyping" class="ai-typing-indicator px-3 py-1 d-none">
|
||||||
|
<small class="text-muted d-flex align-items-center gap-2">
|
||||||
|
<span class="typing-dot"></span>
|
||||||
|
<span class="typing-dot"></span>
|
||||||
|
<span class="typing-dot"></span>
|
||||||
|
<span>El tutor está formulando la respuesta...</span>
|
||||||
|
</small>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<!-- Área de Entrada / Envío -->
|
||||||
|
<div class="card-footer ai-chat-footer p-2 bg-body-tertiary border-top">
|
||||||
|
<form id="aiChatForm" class="d-flex align-items-center gap-2 m-0" onsubmit="handleAiChatSubmit(event)">
|
||||||
|
<textarea id="aiChatInput" class="form-control form-control-sm ai-chat-textarea"
|
||||||
|
rows="1"
|
||||||
|
placeholder="Pregúntale al tutor sobre el sistema..."
|
||||||
|
aria-label="Mensaje para el Asistente"></textarea>
|
||||||
|
<button type="submit" class="btn btn-primary btn-sm rounded-circle ai-send-btn" id="aiChatSendBtn" title="Enviar mensaje">
|
||||||
|
<i class="bi bi-send-fill"></i>
|
||||||
|
</button>
|
||||||
|
</form>
|
||||||
|
<div class="text-center mt-1">
|
||||||
|
<small class="text-muted font-monospace" style="font-size: 0.65rem;">
|
||||||
|
Inferencia local segura UniCABA • Presiona Enter para enviar
|
||||||
|
</small>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<style>
|
||||||
|
/* Estilos del Contenedor Flotante */
|
||||||
|
.ai-chat-container {
|
||||||
|
position: fixed;
|
||||||
|
bottom: 24px;
|
||||||
|
right: 24px;
|
||||||
|
z-index: 1060;
|
||||||
|
font-family: inherit;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Botón Lanzador */
|
||||||
|
.ai-chat-launcher {
|
||||||
|
width: 58px;
|
||||||
|
height: 58px;
|
||||||
|
border-radius: 50% !important;
|
||||||
|
background: linear-gradient(135deg, #B43E8E 0%, #0d6efd 100%) !important;
|
||||||
|
color: #ffffff !important;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
border: 2px solid rgba(255, 255, 255, 0.4) !important;
|
||||||
|
position: relative;
|
||||||
|
cursor: pointer;
|
||||||
|
transition: transform 0.25s cubic-bezier(0.34, 1.56, 0.64, 1), box-shadow 0.25s ease;
|
||||||
|
}
|
||||||
|
.ai-chat-launcher:hover {
|
||||||
|
transform: scale(1.08);
|
||||||
|
box-shadow: 0 10px 25px rgba(180, 62, 142, 0.45) !important;
|
||||||
|
}
|
||||||
|
.ai-launcher-icon {
|
||||||
|
font-size: 1.65rem;
|
||||||
|
line-height: 1;
|
||||||
|
}
|
||||||
|
.pulse-dot {
|
||||||
|
position: absolute;
|
||||||
|
top: 4px;
|
||||||
|
right: 4px;
|
||||||
|
width: 12px;
|
||||||
|
height: 12px;
|
||||||
|
background-color: #22c55e;
|
||||||
|
border-radius: 50%;
|
||||||
|
border: 2px solid #ffffff;
|
||||||
|
box-shadow: 0 0 8px #22c55e;
|
||||||
|
animation: aiPulse 2s infinite;
|
||||||
|
}
|
||||||
|
@keyframes aiPulse {
|
||||||
|
0% { transform: scale(0.95); box-shadow: 0 0 0 0 rgba(34, 197, 94, 0.7); }
|
||||||
|
70% { transform: scale(1.1); box-shadow: 0 0 0 8px rgba(34, 197, 94, 0); }
|
||||||
|
100% { transform: scale(0.95); box-shadow: 0 0 0 0 rgba(34, 197, 94, 0); }
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Panel de Chat */
|
||||||
|
.ai-chat-panel {
|
||||||
|
width: 380px;
|
||||||
|
max-width: calc(100vw - 32px);
|
||||||
|
height: 540px;
|
||||||
|
max-height: calc(100vh - 100px);
|
||||||
|
border-radius: 16px !important;
|
||||||
|
overflow: hidden;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
animation: aiSlideUp 0.3s cubic-bezier(0.16, 1, 0.3, 1) forwards;
|
||||||
|
box-shadow: 0 20px 45px rgba(0, 0, 0, 0.28) !important;
|
||||||
|
}
|
||||||
|
@keyframes aiSlideUp {
|
||||||
|
from { opacity: 0; transform: translateY(20px) scale(0.96); }
|
||||||
|
to { opacity: 1; transform: translateY(0) scale(1); }
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Cabecera del Chat */
|
||||||
|
.ai-chat-header {
|
||||||
|
background: linear-gradient(135deg, #992875 0%, #0d6efd 100%) !important;
|
||||||
|
}
|
||||||
|
.ai-avatar-circle {
|
||||||
|
width: 36px;
|
||||||
|
height: 36px;
|
||||||
|
border-radius: 50%;
|
||||||
|
background: rgba(255, 255, 255, 0.22);
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
font-size: 1.15rem;
|
||||||
|
}
|
||||||
|
.status-indicator-dot {
|
||||||
|
display: inline-block;
|
||||||
|
width: 7px;
|
||||||
|
height: 7px;
|
||||||
|
background-color: #22c55e;
|
||||||
|
border-radius: 50%;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Área de Mensajes */
|
||||||
|
.ai-chat-messages {
|
||||||
|
flex: 1 1 auto;
|
||||||
|
overflow-y: auto;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 12px;
|
||||||
|
scroll-behavior: smooth;
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Burbujas de Mensaje */
|
||||||
|
.ai-msg {
|
||||||
|
max-width: 85%;
|
||||||
|
padding: 10px 14px;
|
||||||
|
border-radius: 14px;
|
||||||
|
font-size: 0.88rem;
|
||||||
|
line-height: 1.45;
|
||||||
|
word-break: break-word;
|
||||||
|
}
|
||||||
|
.ai-msg-user {
|
||||||
|
align-self: flex-end;
|
||||||
|
background-color: #0d6efd;
|
||||||
|
color: #ffffff;
|
||||||
|
border-bottom-right-radius: 4px;
|
||||||
|
}
|
||||||
|
.ai-msg-assistant {
|
||||||
|
align-self: flex-start;
|
||||||
|
border-bottom-left-radius: 4px;
|
||||||
|
}
|
||||||
|
[data-bs-theme="dark"] .ai-msg-assistant {
|
||||||
|
background-color: #1e293b;
|
||||||
|
color: #f1f5f9;
|
||||||
|
border: 1px solid #334155;
|
||||||
|
}
|
||||||
|
[data-bs-theme="light"] .ai-msg-assistant {
|
||||||
|
background-color: #f8fafc;
|
||||||
|
color: #0f172a;
|
||||||
|
border: 1px solid #e2e8f0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.ai-msg code {
|
||||||
|
font-size: 0.82rem;
|
||||||
|
padding: 2px 5px;
|
||||||
|
border-radius: 4px;
|
||||||
|
background: rgba(0, 0, 0, 0.1);
|
||||||
|
}
|
||||||
|
[data-bs-theme="dark"] .ai-msg code {
|
||||||
|
background: rgba(255, 255, 255, 0.1);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Indicador de Escritura */
|
||||||
|
.ai-typing-indicator .typing-dot {
|
||||||
|
width: 6px;
|
||||||
|
height: 6px;
|
||||||
|
background-color: #94a3b8;
|
||||||
|
border-radius: 50%;
|
||||||
|
animation: typingBounce 1.4s infinite ease-in-out;
|
||||||
|
}
|
||||||
|
.ai-typing-indicator .typing-dot:nth-child(1) { animation-delay: 0s; }
|
||||||
|
.ai-typing-indicator .typing-dot:nth-child(2) { animation-delay: 0.2s; }
|
||||||
|
.ai-typing-indicator .typing-dot:nth-child(3) { animation-delay: 0.4s; }
|
||||||
|
@keyframes typingBounce {
|
||||||
|
0%, 80%, 100% { transform: scale(0.6); opacity: 0.4; }
|
||||||
|
40% { transform: scale(1.1); opacity: 1; }
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Formulario del Chat */
|
||||||
|
.ai-chat-textarea {
|
||||||
|
resize: none;
|
||||||
|
border-radius: 20px;
|
||||||
|
padding-left: 14px;
|
||||||
|
padding-right: 14px;
|
||||||
|
max-height: 80px;
|
||||||
|
}
|
||||||
|
.ai-send-btn {
|
||||||
|
width: 36px;
|
||||||
|
height: 36px;
|
||||||
|
flex-shrink: 0;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 576px) {
|
||||||
|
.ai-chat-container {
|
||||||
|
bottom: 16px;
|
||||||
|
right: 16px;
|
||||||
|
}
|
||||||
|
.ai-chat-panel {
|
||||||
|
width: calc(100vw - 32px);
|
||||||
|
height: calc(100vh - 120px);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
<!-- Script Lógico del Widget -->
|
||||||
|
<script src="/js/ai-chat-widget.js"></script>
|
||||||
@@ -0,0 +1,90 @@
|
|||||||
|
# Plan Técnico: Asistente IA y Chatbot de Ayuda Contextual (SDD-009)
|
||||||
|
|
||||||
|
## 1. Arquitectura Técnica de la Solución (4 Capas)
|
||||||
|
|
||||||
|
### 1.1 Capa de Esquemas y Contratos (Schemas / DTOs con Pydantic v2)
|
||||||
|
- **Archivo**: `backend/schemas/ai_chat.py`
|
||||||
|
- `ChatMessage(BaseModel)`:
|
||||||
|
- `role: str = Field(pattern="^(user|assistant|system)$")`
|
||||||
|
- `content: str = Field(min_length=1)`
|
||||||
|
- `ChatRequest(BaseModel)`:
|
||||||
|
- `messages: list[ChatMessage]`
|
||||||
|
- `user_role: str = Field(default="alumno", description="Rol del usuario: alumno, docente, bedelia, admin")`
|
||||||
|
- `ChatResponse(BaseModel)`:
|
||||||
|
- `response: str`
|
||||||
|
- `AISettingsSchema(BaseModel)`:
|
||||||
|
- `enabled: bool = True`
|
||||||
|
- `base_url: str = Field(default="http://10.0.0.214:8080/v1")`
|
||||||
|
- `api_key: str = Field(default="llama")`
|
||||||
|
- `model: str = Field(default="qwen3-coder:30b")`
|
||||||
|
- `temperature: float = Field(default=0.3, ge=0.0, le=2.0)`
|
||||||
|
- `timeout: int = Field(default=60, ge=5, le=600)`
|
||||||
|
- `context_limit: int = Field(default=65536)`
|
||||||
|
- `output_limit: int = Field(default=65536)`
|
||||||
|
|
||||||
|
### 1.2 Capa de Persistencia y Configuración (Storage & SystemSettings)
|
||||||
|
- Persistencia en tabla relacional `system_settings` usando `SystemSetting`:
|
||||||
|
- `ai_chat_enabled`: 'true' | 'false' (default: 'true')
|
||||||
|
- `ai_chat_base_url`: URL del endpoint compatible OpenAI (default: `http://10.0.0.214:8080/v1`)
|
||||||
|
- `ai_chat_api_key`: Clave API cifrada con Fernet (`SystemSetting.set_encrypted_value`)
|
||||||
|
- `ai_chat_model`: ID del modelo a cargar (default: `qwen3-coder:30b`)
|
||||||
|
- `ai_chat_temperature`: Float string (default: '0.3')
|
||||||
|
- `ai_chat_timeout`: Entero en segundos (default: '60')
|
||||||
|
- `ai_chat_context_limit`: Entero (default: '65536')
|
||||||
|
- `ai_chat_output_limit`: Entero (default: '65536')
|
||||||
|
|
||||||
|
### 1.3 Capa de Lógica de Negocio y Routers FastAPI (`backend/routers/`)
|
||||||
|
- **`backend/routers/ai_chat.py`**:
|
||||||
|
- `APIRouter(prefix="/api/chat", tags=["AI Chatbot"])` con inclusión adicional en `main.py` bajo `/api/chat` y `/api/v1/chat`.
|
||||||
|
- Función de inyección de prompt por rol:
|
||||||
|
`generate_system_prompt_for_role(role: str) -> str`:
|
||||||
|
- **Docente**: Manual de Reserva de Aulas, Registro de Asistencia, Carga de Actas de Regularidad en Gradebook, Horarios y Aulas Virtuales (Google Meet).
|
||||||
|
- **Alumno**: Manual de Cursada, Consulta de Cartelera del Día, Identificación de Aulas/Salas, Inscripciones, Consulta de Calificaciones. Regla estricta: No brindar instrucciones sobre administración o alteración de datos de Bedelía.
|
||||||
|
- **Bedelía / Admin**: Manual Operativo de 9 Pasos, Resolución de Conflictos, Optimizador Genético, Importación de Google Sheets con previsualización, Sincronización Moodle 4.1 y Auditoría.
|
||||||
|
- Endpoint `POST /` (`/api/chat/` y `/api/v1/chat/`):
|
||||||
|
- Extrae rol del usuario (priorizando usuario autenticado en JWT si está presente, o `request.user_role`).
|
||||||
|
- Genera System Prompt y compone el historial en formato estándar OpenAI compatible:
|
||||||
|
`{"model": model, "messages": [{"role": "system", "content": system_prompt}, ...], "temperature": temperature}`.
|
||||||
|
- Ejecuta llamada asíncrona no bloqueante con `httpx.AsyncClient(timeout=timeout)`.
|
||||||
|
- Captura `httpx.RequestError` o respuestas no 2xx y levanta `HTTPException(status_code=503, detail="Error conectando al motor de IA local.")`.
|
||||||
|
- Retorna `ChatResponse(response=ai_data["choices"][0]["message"]["content"])`.
|
||||||
|
- Endpoint `POST /test-connection`:
|
||||||
|
- Verifica conectividad directa con `{base_url}/models` usando el cliente `httpx.AsyncClient`.
|
||||||
|
- **`backend/routers/admin.py`**:
|
||||||
|
- Actualizar `get_all_settings` para retornar el bloque `ai_assistant` con valores activos y clave API enmascarada.
|
||||||
|
- Endpoints `@admin_router.post("/settings/ai")` y `@admin_router.post("/settings/ai/test")`.
|
||||||
|
|
||||||
|
### 1.4 Capa de Frontend BFF y Vistas (Express, Nunjucks & Vanilla JS)
|
||||||
|
- **Vista de Configuración Global (`frontend/views/admin/settings/global_config.html`)**:
|
||||||
|
- Pestaña `#tab-ai` ("Asistente IA & LLM Local") con icono `bi bi-cpu`.
|
||||||
|
- Formulario estructurado para configuración de servidor Llama.cpp, modelo, apiKey, parámetros de generación y límites de contexto.
|
||||||
|
- Botón interactivo "Probar Conexión con Llama.cpp" con feedback dinámico (spinner, alerta de éxito o error con código HTTP y latencia).
|
||||||
|
- **Widget de Chatbot Flotante (`frontend/views/partials/ai_chat_widget.html` e inyección en `base.html`)**:
|
||||||
|
- Botón flotante animado en la esquina inferior derecha con icono de asistente.
|
||||||
|
- Panel colapsable de conversación con cabecera estilizada, avatar institucional, indicador de estado de conexión ("Llama.cpp · Qwen3 Coder 30B") y botón de cierre/minimizar.
|
||||||
|
- Historial de mensajes con burbujas diferenciadas para usuario y tutor IA, formateo de listas y código, y animación de escritura.
|
||||||
|
- Input con soporte de multilínea y envío con Enter / clic en botón de enviar.
|
||||||
|
- Script frontend (`frontend/public/js/ai-chat-widget.js`) que maneja la comunicación AJAX con el backend, almacena el historial temporal en `sessionStorage` y detecta el rol actual del usuario desde la sesión.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Plan de Pruebas Automatizadas
|
||||||
|
1. **Pruebas de Backend (`backend/tests/test_ai_chat.py`)**:
|
||||||
|
- Validación de contratos con Pydantic: prueba de `ChatRequest` válido, rechazo con 422 ante payload malformado o contenido vacío.
|
||||||
|
- Generación de System Prompt: verificación de directivas específicas para `alumno`, `docente` y `bedelia`.
|
||||||
|
- Simulación de respuesta exitosa de Llama.cpp (Mock de `httpx.AsyncClient`) verificando código 200 y formato `ChatResponse`.
|
||||||
|
- Manejo de fallas de red / servidor caído: verificación de respuesta HTTP 503 controlada con detalle descriptivo.
|
||||||
|
- Endpoints de configuración administrativa en `backend/routers/admin.py` para guardar y consultar configuración de IA.
|
||||||
|
2. **Pruebas de Frontend y UI**:
|
||||||
|
- Verificación de renderizado de la pestaña de IA en `/admin/settings`.
|
||||||
|
- Inclusión del widget de chat en `base.html` sin interferir con otros elementos de la UI ni romper el layout en modo oscuro o móvil.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Plan de Despliegue en Producción (Principio 9 de la Constitución)
|
||||||
|
1. Verificación de 0 errores estáticos con Pyright (`@[current_problems]`).
|
||||||
|
2. Ejecución completa de la suite de pruebas unitarias (`pytest tests -v`).
|
||||||
|
3. Bump de versión semántica en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
|
||||||
|
4. Registro de cambios en `CHANGELOG.md` y `MEMORY.md`.
|
||||||
|
5. Ejecución de `git push origin dev` al repositorio remoto.
|
||||||
|
6. Despliegue en el contenedor de producción LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación de disponibilidad.
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
# Especificación: Asistente IA y Chatbot de Ayuda Contextual (SDD-009)
|
||||||
|
|
||||||
|
## 1. Contexto y Objetivos del Módulo
|
||||||
|
La plataforma **Admin Edu Space** coordina el ecosistema académico de UniCABA para múltiples perfiles: personal de Bedelía, docentes y estudiantes. Debido a la amplitud de funciones (gestión de espacios áulicos, sincronización con Moodle 4.1, actas de regularidad, asignación de comisiones y consultas de cursada), los usuarios requieren orientación inmediata y contextualizada sobre cómo operar el sistema según su propio nivel de privilegios y responsabilidades.
|
||||||
|
|
||||||
|
Este módulo implementa un **asistente conversacional (chatbot de ayuda contextual)** impulsado por un modelo de lenguaje local (**Llama.cpp** ejecutando `Qwen3 Coder 30B-A3B`) hosteado en la infraestructura institucional (`http://10.0.0.214:8080/v1`).
|
||||||
|
|
||||||
|
El agente conversacional actúa como un tutor interactivo cuyas respuestas y contexto están estrictamente acotados al rol del usuario autenticado (`alumno`, `docente`, `bedelia` / `admin`), previniendo la divulgación de capacidades no autorizadas y ofreciendo instrucciones paso a paso directamente aplicables a su flujo de trabajo.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Requisitos Funcionales en Sintaxis EARS
|
||||||
|
|
||||||
|
### 2.1 Configuración Global del Proveedor de IA (`/admin/settings`)
|
||||||
|
|
||||||
|
- **RF-01 (Ubicuo - Pestaña de Configuración IA en el Panel de Administración)**:
|
||||||
|
`EL SISTEMA presentará una pestaña dedicada 'Asistente IA & LLM Local' en la vista de Configuración Global (/admin/settings) accesible exclusivamente para administradores.`
|
||||||
|
|
||||||
|
- **RF-02 (Basado en Eventos - Persistencia de Parámetros del Motor de IA)**:
|
||||||
|
`CUANDO el administrador actualice la URL base (default: http://10.0.0.214:8080/v1), la clave API, el identificador del modelo (default: qwen3-coder:30b), la temperatura, el timeout o el estado de activación, EL SISTEMA validará los datos mediante Pydantic v2 y los persistirá de forma segura en la tabla system_settings.`
|
||||||
|
|
||||||
|
- **RF-03 (Basado en Eventos - Prueba de Conectividad con el Servidor Local)**:
|
||||||
|
`CUANDO el administrador presione el botón 'Probar Conexión con Llama.cpp', EL SISTEMA ejecutará una verificación asíncrona contra el endpoint /v1/models o un healthcheck del servidor local, retornando el estado de latencia y disponibilidad en la interfaz.`
|
||||||
|
|
||||||
|
- **RF-04 (No Deseado - Degradación Controlada ante Servidor de IA Inaccesible)**:
|
||||||
|
`SI el servidor de Llama.cpp no responde dentro del tiempo límite o se encuentra fuera de línea, ENTONCES EL SISTEMA capturará la excepción de red y retornará un error HTTP 503 con un mensaje descriptivo en español, sin bloquear el servidor FastAPI ni degradar la experiencia general de la plataforma.`
|
||||||
|
|
||||||
|
### 2.2 Backend Core y API REST (`backend/routers/ai_chat.py`)
|
||||||
|
|
||||||
|
- **RF-05 (Ubicuo - Validación de Contratos con Pydantic v2)**:
|
||||||
|
`EL SISTEMA validará las solicitudes al endpoint de chat mediante esquemas Pydantic v2 (ChatRequest, ChatMessage, ChatResponse), exigiendo formato válido de mensajes, longitud mínima de contenido y roles reconocidos, respondiendo con HTTP 422 Unprocessable Entity en caso de discordancia de esquema.`
|
||||||
|
|
||||||
|
- **RF-06 (Basado en Eventos - Inferencia Asíncrona no Bloqueante con httpx)**:
|
||||||
|
`CUANDO un usuario autenticado envíe una consulta al asistente (/api/chat o /api/v1/chat), EL SISTEMA procesará la llamada utilizando httpx.AsyncClient con await no bloqueante y timeout configurable (default: 60s con soporte de hasta 600s), preservando la concurrencia de FastAPI.`
|
||||||
|
|
||||||
|
- **RF-07 (Basado en Estados - Inyección Dinámica de System Prompt según Rol)**:
|
||||||
|
`MIENTRAS el usuario posea un rol específico ('alumno', 'docente', 'bedelia' o 'admin'), EL SISTEMA antepondrá de forma invisible en el payload enviado al LLM el manual de instrucciones y las restricciones de seguridad correspondientes a dicho perfil.`
|
||||||
|
|
||||||
|
- **RF-08 (No Deseado - Restricción de Alcance y Prevención de Fuga de Permisos)**:
|
||||||
|
`SI un usuario con rol 'alumno' indaga sobre funciones administrativas, edición de aulas, modificación de notas o sincronización de Moodle, ENTONCES EL SISTEMA instruirá al LLM a declinar amablemente la respuesta indicando que dicha operación está reservada al personal de Bedelía o Secretaría Académica.`
|
||||||
|
|
||||||
|
### 2.3 Interfaz de Usuario y Widget del Chatbot (Frontend BFF & UI)
|
||||||
|
|
||||||
|
- **RF-09 (Opcional - Widget Flotante del Asistente en la Interfaz)**:
|
||||||
|
`DONDE el usuario se encuentre autenticado y la integración de IA esté habilitada, EL SISTEMA desplegará un botón flotante y un panel de chat interactivo en el extremo inferior de la pantalla, con micro-animaciones, soporte de modo oscuro/claro y visor de respuestas con formato legible.`
|
||||||
|
|
||||||
|
- **RF-10 (Basado en Eventos - Transmisión de Consulta e Indicador de Carga)**:
|
||||||
|
`CUANDO el usuario envíe una pregunta mediante el widget de chat, EL SISTEMA mostrará un indicador animado de procesamiento ('El tutor está escribiendo...'), mantendrá el foco del scroll y presentará la respuesta generada por el modelo al finalizar la inferencia.`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Matriz de Prompts de Sistema por Rol (Contextual Guidance)
|
||||||
|
|
||||||
|
| Rol del Usuario | Enfoque del Tutor IA | Reglas y Restricciones Específicas |
|
||||||
|
| :--- | :--- | :--- |
|
||||||
|
| **Docente** (`docente`, `profesor`, `teacher`) | Asistente de Gestión de Cátedra | Enseña a: consultar asignaciones de aula, registrar asistencia, cargar actas de regularidad en el Gradebook, verificar horarios semanales y enlaces de aulas virtuales (Google Meet). Prohibido: habilitar o explicar cómo crear carreras o reconfigurar servidores. |
|
||||||
|
| **Alumno** (`alumno`, `estudiante`, `student`) | Asistente de Cursada y Orientación | Enseña a: consultar materias matriculadas, consultar cartelera de clases del día, verificar horarios, identificar aulas asignadas y consultar estado académico. Estrictamente prohibido: detallar procedimientos de Bedelía, administración de espacios o edición de calificaciones. |
|
||||||
|
| **Bedelía / Admin** (`bedelia`, `admin`, `administrador`) | Soporte Técnico Nivel 1 y Operación Áulica | Enseña a: flujo secuencial de 9 pasos (Sedes -> Aulas -> Ciclos -> Carreras -> Materias -> Comisiones -> Profesores -> Alumnos -> Reservas), resolución de matriz de conflictos físicos/docentes, importación de Google Sheets con previsualización, sincronización con Moodle 4.1 y monitoreo de auditoría. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Criterios de Aceptación y Validación
|
||||||
|
1. **Configuración Global**: La pestaña "Asistente IA & LLM Local" en `/admin/settings` debe cargar la configuración actual, permitir su edición y probar conectividad con respuesta en vivo.
|
||||||
|
2. **Contrato de API**:
|
||||||
|
- `POST /api/chat/` o `POST /api/v1/chat/` debe validar con Pydantic `ChatRequest` y responder con `ChatResponse`.
|
||||||
|
- Cargas no válidas deben retornar `422 Unprocessable Entity`.
|
||||||
|
- Si el servidor local de Llama.cpp no responde, debe retornar `503 Service Unavailable` con mensaje amigable.
|
||||||
|
3. **Seguridad y Aislamiento por Rol**: Las consultas de un alumno deben recibir respuestas adaptadas al estudiante y rechazar peticiones de gestión áulica.
|
||||||
|
4. **Widget de UI**: El widget flotante debe integrarse armónicamente en el layout general de la aplicación (`base.html`), respetando temas claro y oscuro (`data-bs-theme`), permitiendo abrir, minimizar y enviar mensajes fluidamente.
|
||||||
|
5. **Calidad y Robustez**: 100% de la suite de pruebas unitarias/integración aprobadas en pytest y cero errores de diagnóstico en Pyright (`@[current_problems]`).
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
# Desglose de Tareas: Asistente IA y Chatbot de Ayuda Contextual (SDD-009)
|
||||||
|
|
||||||
|
## Tareas de Implementación
|
||||||
|
|
||||||
|
- [x] **Tarea 1: Esquemas Pydantic v2 y Modelos de Contrato para Chatbot y Configuración**
|
||||||
|
- **Estimación**: 20 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Crear `backend/schemas/ai_chat.py` con `ChatMessage`, `ChatRequest`, `ChatResponse`, `AISettingsSchema` y validaciones estrictas (`Field`, `pattern`, `min_length`).
|
||||||
|
- Validar que los payloads inválidos fallen con 422 Unprocessable Entity.
|
||||||
|
- **Hecho cuando**: Los modelos validan correctamente los tipos, roles y longitudes, y rechazan payloads sin mensajes o con roles inválidos.
|
||||||
|
|
||||||
|
- [x] **Tarea 2: Lógica de Negocio de System Prompts por Rol y Router FastAPI (`backend/routers/ai_chat.py`)**
|
||||||
|
- **Estimación**: 30 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Crear `backend/routers/ai_chat.py` con `APIRouter(prefix="/api/chat", tags=["AI Chatbot"])` y alias `/api/v1/chat`.
|
||||||
|
- Implementar `generate_system_prompt_for_role(role: str) -> str` con los manuales operativos para:
|
||||||
|
- `Docente`: Reserva de aulas, actas de regularidad, asistencia, links a Meet.
|
||||||
|
- `Alumno`: Consulta de horarios, cartelera, notas en Gradebook, prohibición explícita de gestión administrativa.
|
||||||
|
- `Bedelía / Admin`: Circuito secuencial de 9 pasos, resolución de conflictos, importación de sheets, Moodle 4.1.
|
||||||
|
- Implementar endpoint `POST /` con `httpx.AsyncClient(timeout=...)` hacia la URL base de Llama.cpp (`http://10.0.0.214:8080/v1/chat/completions`).
|
||||||
|
- Manejar excepciones de red y timeout mapeando a HTTP 503 controlado.
|
||||||
|
- Implementar endpoint `POST /test-connection` para probar el servidor local.
|
||||||
|
- Registrar el router en `backend/main.py`.
|
||||||
|
- **Hecho cuando**: Los endpoints `/api/chat` y `/api/v1/chat` están documentados en Swagger `/docs` y procesan consultas asíncronas con System Prompt inyectado.
|
||||||
|
|
||||||
|
- [x] **Tarea 3: Persistencia y Gestión de Configuración de IA en `backend/routers/admin.py`**
|
||||||
|
- **Estimación**: 25 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Extender `get_all_settings` en `backend/routers/admin.py` para devolver el objeto `ai_assistant` con parámetros de Llama.cpp, modelo (`qwen3-coder:30b`) y API key enmascarada.
|
||||||
|
- Crear endpoints `@admin_router.post("/settings/ai")` y `@admin_router.post("/settings/ai/test")` que guarden en `SystemSetting` con auditoría en `AuditLog`.
|
||||||
|
- **Hecho cuando**: La configuración de IA se guarda y se recupera correctamente a través de la API administrativa.
|
||||||
|
|
||||||
|
- [x] **Tarea 4: Pestaña de Configuración Global en Frontend (`global_config.html`)**
|
||||||
|
- **Estimación**: 25 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Agregar pestaña `#tab-ai` ("Asistente IA & LLM Local") en `frontend/views/admin/settings/global_config.html`.
|
||||||
|
- Maquetar formulario con los parámetros definidos en SDD-009: Base URL, API Key, Model ID, Model Name, Context Limit, Output Limit, Timeout, Temperatura y switch de habilitación.
|
||||||
|
- Implementar manejadores JavaScript en la vista para guardar configuración y ejecutar el botón "Probar Conexión con Llama.cpp" con feedback interactivo.
|
||||||
|
- **Hecho cuando**: El administrador puede editar los parámetros del LLM y probar la conexión desde `/admin/settings`.
|
||||||
|
|
||||||
|
- [x] **Tarea 5: Widget Flotante del Chatbot en la UI (`ai_chat_widget.html` & `ai-chat-widget.js`)**
|
||||||
|
- **Estimación**: 30 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Crear `frontend/views/partials/ai_chat_widget.html` e incluirlo en `frontend/views/base.html` para usuarios autenticados.
|
||||||
|
- Diseñar interfaz flotante premium con Bootstrap 5 y Vanilla CSS (botón lanzador con animación sutil, ventana de chat responsiva, badge de rol de usuario, avatar institucional, indicador de tipeo y lista de mensajes).
|
||||||
|
- Desarrollar `frontend/public/js/ai-chat-widget.js` para enviar mensajes por AJAX a `/api/v1/chat/`, manejar scroll, formatear respuestas y persistir temporalmente la sesión en `sessionStorage`.
|
||||||
|
- **Hecho cuando**: El usuario puede interactuar con el chatbot desde cualquier pantalla del sistema, recibiendo respuestas contextualizadas a su rol.
|
||||||
|
|
||||||
|
- [x] **Tarea 6: Suite de Pruebas Automatizadas en Backend (`test_ai_chat.py`)**
|
||||||
|
- **Estimación**: 25 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Crear `backend/tests/test_ai_chat.py` con tests para:
|
||||||
|
- Validación de esquemas Pydantic `ChatRequest`, `ChatMessage`, `ChatResponse`.
|
||||||
|
- Inyección correcta de system prompt según rol (alumno, docente, bedelia).
|
||||||
|
- Mocking de `httpx.AsyncClient` para simular respuesta 200 de Llama.cpp.
|
||||||
|
- Mocking de falla de conexión para verificar HTTP 503 descriptivo.
|
||||||
|
- Endpoints de guardado y consulta de configuración de IA.
|
||||||
|
- Ejecutar `pytest tests -v` y validar 100% verde (89 tests pasando).
|
||||||
|
- Verificar con `py_compile` (Principio 10) que haya 0 errores o advertencias.
|
||||||
|
- **Hecho cuando**: Todas las pruebas unitarias e integradas pasan con éxito y no hay problemas en el analizador de código.
|
||||||
|
|
||||||
|
- [x] **Tarea 7: Bump Semántico a v3.8.24, Git Push y Despliegue en Producción**
|
||||||
|
- **Estimación**: 20 min
|
||||||
|
- **Acciones**:
|
||||||
|
- Incrementar versión semántica a `v3.8.24` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
|
||||||
|
- Actualizar `CHANGELOG.md` y `MEMORY.md`.
|
||||||
|
- Ejecutar `git add .`, commit y `git push origin dev`.
|
||||||
|
- Desplegar en el contenedor de producción LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificar HTTP 200 en `/version` y `/admin/settings`.
|
||||||
|
- **Hecho cuando**: La versión `v3.8.24` está activa en producción y verificada en caliente.
|
||||||
|
|
||||||
Reference in New Issue
Block a user