fix: aislamiento estricto de conversaciones de chat por usuario e inferencia simultanea (v3.8.26)
This commit is contained in:
@@ -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**:
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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):
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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
@@ -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",
|
||||
|
||||
@@ -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,6 +1,6 @@
|
||||
{
|
||||
"name": "frontend",
|
||||
"version": "3.8.25",
|
||||
"version": "3.8.26",
|
||||
"description": "",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
|
||||
@@ -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
@@ -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);
|
||||
|
||||
@@ -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>
|
||||
|
||||
Reference in New Issue
Block a user