fix: aislamiento estricto de conversaciones de chat por usuario e inferencia simultanea (v3.8.26)

This commit is contained in:
2026-10-27 08:11:07 -03:00
parent fb46de5f28
commit a5b014efbe
11 changed files with 134 additions and 27 deletions
+16
View File
@@ -11,6 +11,22 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.26] - 2026-10-27
### Fixed & Enhanced (Aislamiento Individual y Simultáneo de Conversaciones en UdeCi)
- **Aislamiento Estricto de Conversaciones por Usuario Individual**:
- **Frontend (`ai_chat_widget.html` & `ai-chat-widget.js`)**:
- Se eliminó la clave de almacenamiento global compartida (`sessionStorage.getItem('edu_space_udeci_chat_history_v2')`) que causaba que usuarios sucesivos en un mismo navegador o máquina compartieran el historial de chat.
- Se incorporaron los atributos `data-user-id` y `data-user-email` vinculados al usuario autenticado (`auth_user.id`).
- Clave de almacenamiento dinámico y aislado por usuario: `edu_space_udeci_chat_usr_<userId>`. En sesiones no autenticadas se genera un ID único por pestaña (`anon_<random>_<timestamp>`).
- Limpieza contextual al reiniciar chat (`aiChatClearBtn` solo borra el historial del usuario activo).
- **Backend Core & Inferencia Simultánea (`routers/ai_chat.py` & `schemas/ai_chat.py`)**:
- Se agregó el campo `conversation_id` a `ChatRequest` y `ChatResponse`.
- Se inyecta el identificador único `"user": user_identifier` en el payload compatible con OpenAI enviado a Llama.cpp.
- Llama.cpp asigna y gestiona los 4 slots paralelos independientes de hardware (KV Cache) sin mezclar contextos ni estados entre usuarios concurrentes.
- **Calidad y Verificación**:
- Nueva prueba unitaria y de concurrencia `test_individual_user_chat_conversations_isolation` en `backend/tests/test_rag_udeci.py`.
- 95 pruebas automatizadas pasando al 100% (`95 passed`).
## [3.8.25] - 2026-10-27
### Added & Enhanced (Arquitectura RAG Embebida y Asistente UdeCi - SDD-010)
- **Asistente Virtual UdeCi con Arquitectura RAG Embebida**:
+5 -7
View File
@@ -9,13 +9,11 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Arquitectura RAG Embebida y Asistente UdeCi — SDD-010 (v3.8.25)**:
- **Especificación y Metodología SDD**: Formalizada en `specs/010-arquitectura-rag-udeci/` (`spec.md`, `plan.md`, `tasks.md`) con requisitos en sintaxis EARS y matriz de conocimiento por rol.
- **Identidad y UX/UI UdeCi**: Rebranding a UdeCi, eliminación de jerga técnica en chat (Llama.cpp, Qwen3, KV Cache), respuestas concisas (2-3 oraciones) y botones interactivos en burbujas (`OPCIONES: [...]`) y barra de chips superior.
- **Motor RAG Embebido en SQLite**: Modelo relacional `KnowledgeChunk`, `RAGService` con tokenización, normalización de acentos, búsqueda ponderada en título/contenido/keywords y filtrado estricto por rol (`WHERE role IN (:user_role, 'general')`).
- **Endpoints y Seguridad**: Integración en `routers/ai_chat.py` con temperatura 0.1 y nuevo endpoint `POST /api/chat/rag/reindex`.
- **QA & Pruebas Automatizadas**: 94 tests aprobados al 100% en `pytest` (`94 passed`), 0 errores de tipado o compilación estática.
- **Versión Consolidada**: `v3.8.25`.
- **Sprint Activo: Arquitectura RAG Embebida y Conversaciones Individuales Aisladas — SDD-010 (v3.8.26)**:
- **Aislamiento Individual por Usuario en UdeCi**: Eliminada la clave de almacenamiento compartida en frontend. Cada usuario almacena su historial bajo `edu_space_udeci_chat_usr_<userId>`. En sesiones anónimas se asigna UUID por pestaña.
- **Inferencia Concurrente Simultánea**: `routers/ai_chat.py` inyecta `"user": user_identifier` y `conversation_id` en las peticiones a Llama.cpp, asegurando que los 4 slots de inferencia paralelos de la GPU operen de forma totalmente aislada sin colisión de KV Cache.
- **QA & Pruebas Automatizadas**: 95 tests aprobados al 100% en `pytest` (`95 passed`), 0 errores de tipado o compilación estática.
- **Versión Consolidada**: `v3.8.26`.
## 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.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session
from config.config import Config
__version__ = "3.8.25"
__version__ = "3.8.26"
class DummyContext:
def __enter__(self):
+16 -2
View File
@@ -160,10 +160,20 @@ async def get_agent_response(
for msg in request.messages:
formatted_messages.append({"role": msg.role, "content": msg.content})
# Identificador individual único de usuario / sesión para aislar los slots de KV Cache en Llama.cpp
if current_user and getattr(current_user, "id", None):
user_identifier = f"usr_{current_user.id}"
elif request.conversation_id:
user_identifier = str(request.conversation_id).strip()
else:
client_ip = req.client.host if (req and req.client) else "local"
user_identifier = f"anon_{client_ip}"
payload = {
"model": config["model"],
"messages": formatted_messages,
"temperature": 0.1 # Temperatura estricta para evitar alucinaciones
"temperature": 0.1, # Temperatura estricta para evitar alucinaciones
"user": user_identifier # Aislamiento individual por usuario en Llama.cpp
}
target_url = f"{config['base_url']}/chat/completions"
@@ -180,7 +190,11 @@ async def get_agent_response(
ai_data = response.json()
raw_reply = ai_data["choices"][0]["message"]["content"]
clean_reply, options = _extract_options_from_reply(raw_reply, effective_role)
return ChatResponse(response=clean_reply, quick_options=options)
return ChatResponse(
response=clean_reply,
quick_options=options,
conversation_id=user_identifier
)
except httpx.TimeoutException:
raise HTTPException(
status_code=status.HTTP_504_GATEWAY_TIMEOUT,
+2
View File
@@ -10,11 +10,13 @@ class ChatMessage(BaseModel):
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")
conversation_id: Optional[str] = Field(None, description="Identificador único de conversación o sesión del usuario")
class ChatResponse(BaseModel):
response: str = Field(..., description="Respuesta generada por el agente conversacional")
quick_options: Optional[List[str]] = Field(default_factory=list, description="Lista de opciones o preguntas sugeridas para botones interactivos")
conversation_id: Optional[str] = Field(None, description="Identificador único de conversación o sesión del usuario")
class RAGReindexResponse(BaseModel):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.8.25",
version="3.8.26",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
+46
View File
@@ -143,3 +143,49 @@ def test_rag_reindex_endpoint_admin_security(init_database):
data = reindex_res.json()
assert data["status"] == "success"
assert data["indexed_chunks"] >= 10
def test_individual_user_chat_conversations_isolation(init_database):
"""Valida que conversaciones simultáneas tengan identificadores y contextos individuales independientes."""
client = TestClient(app)
mock_resp_alumno = MagicMock()
mock_resp_alumno.status_code = 200
mock_resp_alumno.json.return_value = {
"choices": [{"message": {"role": "assistant", "content": "Tu clase es en el aula 204. OPCIONES: [Ver aula | Mis materias]"}}]
}
mock_resp_alumno.raise_for_status = MagicMock()
mock_resp_docente = MagicMock()
mock_resp_docente.status_code = 200
mock_resp_docente.json.return_value = {
"choices": [{"message": {"role": "assistant", "content": "El acta de regularidad se cierra en el menú Gradebook. OPCIONES: [Cerrar acta | Ver alumnos]"}}]
}
mock_resp_docente.raise_for_status = MagicMock()
with patch("httpx.AsyncClient.post", new_callable=AsyncMock) as mock_post:
# Petición Usuario 1 (Alumno)
mock_post.return_value = mock_resp_alumno
res1 = client.post("/api/chat", json={
"messages": [{"role": "user", "content": "¿Dónde curso?"}],
"user_role": "alumno",
"conversation_id": "usr_student_42"
})
assert res1.status_code == 200
d1 = res1.json()
assert d1["conversation_id"] == "usr_student_42"
assert "aula 204" in d1["response"]
assert mock_post.call_args[1]["json"]["user"] == "usr_student_42"
# Petición Usuario 2 (Docente - Independiente y Simultánea)
mock_post.return_value = mock_resp_docente
res2 = client.post("/api/chat", json={
"messages": [{"role": "user", "content": "¿Cómo cierro el acta?"}],
"user_role": "docente",
"conversation_id": "usr_teacher_99"
})
assert res2.status_code == 200
d2 = res2.json()
assert d2["conversation_id"] == "usr_teacher_99"
assert "Gradebook" in d2["response"]
assert mock_post.call_args[1]["json"]["user"] == "usr_teacher_99"
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.25",
"version": "3.8.26",
"description": "",
"main": "index.js",
"scripts": {
+35 -10
View File
@@ -7,7 +7,35 @@
'use strict';
let isProcessing = false;
const STORAGE_KEY = 'edu_space_udeci_chat_history_v2';
// Limpiar clave histórica compartida para evitar contaminación entre perfiles
try {
sessionStorage.removeItem('edu_space_udeci_chat_history_v2');
localStorage.removeItem('edu_space_udeci_chat_history_v2');
} catch (e) {}
function getContainer() {
return document.getElementById('aiChatContainer');
}
function getUserId() {
const container = getContainer();
const rawId = container ? (container.getAttribute('data-user-id') || container.getAttribute('data-user-email')) : null;
if (rawId && rawId.toString().trim()) {
return 'usr_' + rawId.toString().trim().replace(/[^a-zA-Z0-9_-]/g, '_');
}
// Identificador único de sesión por pestaña si no está logueado
let anonId = sessionStorage.getItem('edu_space_anon_chat_session');
if (!anonId) {
anonId = 'anon_' + Math.random().toString(36).substring(2, 10) + '_' + Date.now();
sessionStorage.setItem('edu_space_anon_chat_session', anonId);
}
return anonId;
}
function getStorageKey() {
return 'edu_space_udeci_chat_usr_' + getUserId();
}
const ROLE_CHIPS = {
docente: [
@@ -28,10 +56,6 @@
]
};
function getContainer() {
return document.getElementById('aiChatContainer');
}
function getUserRole() {
const container = getContainer();
const rawRole = (container ? container.getAttribute('data-user-role') : 'alumno') || 'alumno';
@@ -53,7 +77,7 @@
function loadHistory() {
try {
const raw = sessionStorage.getItem(STORAGE_KEY);
const raw = sessionStorage.getItem(getStorageKey());
return raw ? JSON.parse(raw) : [];
} catch (e) {
return [];
@@ -62,7 +86,7 @@
function saveHistory(messages) {
try {
sessionStorage.setItem(STORAGE_KEY, JSON.stringify(messages));
sessionStorage.setItem(getStorageKey(), JSON.stringify(messages));
} catch (e) {}
}
@@ -169,7 +193,8 @@
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
messages: payloadMessages,
user_role: userRole
user_role: userRole,
conversation_id: getUserId()
})
});
@@ -225,10 +250,10 @@
});
}
// Reiniciar conversación
// Reiniciar conversación del usuario actual
if (clearBtn) {
clearBtn.addEventListener('click', () => {
sessionStorage.removeItem(STORAGE_KEY);
sessionStorage.removeItem(getStorageKey());
const messagesContainer = document.getElementById('aiChatMessages');
if (messagesContainer) messagesContainer.innerHTML = '';
const initialOptions = (ROLE_CHIPS[role] || []).map(c => c.label);
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
const APP_VERSION = '3.8.25';
const FRONTEND_VERSION = '3.8.25';
const BACKEND_VERSION = '3.8.25';
const APP_VERSION = '3.8.26';
const FRONTEND_VERSION = '3.8.26';
const BACKEND_VERSION = '3.8.26';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
+8 -2
View File
@@ -1,10 +1,16 @@
{% 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 %}
{% set active_auth_user = auth_user if (auth_user and auth_user.is_authenticated) else (current_user if (current_user and current_user.is_authenticated) else user) %}
{% set current_user_id = active_auth_user.id if active_auth_user and active_auth_user.id else '' %}
{% set current_user_email = active_auth_user.email if active_auth_user and active_auth_user.email else '' %}
{% set current_role_name = (active_auth_user.role if active_auth_user and active_auth_user.role else 'alumno') | lower %}
<!-- ===================================================== -->
<!-- WIDGET FLOTANTE: UdeCi - TUTOR VIRTUAL UNICABA -->
<!-- SDD-010: Arquitectura RAG y Asistencia Contextual -->
<!-- ===================================================== -->
<div id="aiChatContainer" class="ai-chat-container" data-user-role="{{ current_role_name }}">
<div id="aiChatContainer" class="ai-chat-container"
data-user-id="{{ current_user_id }}"
data-user-email="{{ current_user_email }}"
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 UdeCi" title="UdeCi - Tutor Virtual UniCABA">
<span class="ai-launcher-icon"><i class="bi bi-chat-heart-fill"></i></span>