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.
|
- **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.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
|
## [3.8.25] - 2026-10-27
|
||||||
### Added & Enhanced (Arquitectura RAG Embebida y Asistente UdeCi - SDD-010)
|
### Added & Enhanced (Arquitectura RAG Embebida y Asistente UdeCi - SDD-010)
|
||||||
- **Asistente Virtual UdeCi con Arquitectura RAG Embebida**:
|
- **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.
|
- 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: Arquitectura RAG Embebida y Asistente UdeCi — SDD-010 (v3.8.25)**:
|
- **Sprint Activo: Arquitectura RAG Embebida y Conversaciones Individuales Aisladas — SDD-010 (v3.8.26)**:
|
||||||
- **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.
|
- **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.
|
||||||
- **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.
|
- **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.
|
||||||
- **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')`).
|
- **QA & Pruebas Automatizadas**: 95 tests aprobados al 100% en `pytest` (`95 passed`), 0 errores de tipado o compilación estática.
|
||||||
- **Endpoints y Seguridad**: Integración en `routers/ai_chat.py` con temperatura 0.1 y nuevo endpoint `POST /api/chat/rag/reindex`.
|
- **Versión Consolidada**: `v3.8.26`.
|
||||||
- **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`.
|
|
||||||
|
|
||||||
## 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.25"
|
__version__ = "3.8.26"
|
||||||
|
|
||||||
class DummyContext:
|
class DummyContext:
|
||||||
def __enter__(self):
|
def __enter__(self):
|
||||||
|
|||||||
@@ -160,10 +160,20 @@ async def get_agent_response(
|
|||||||
for msg in request.messages:
|
for msg in request.messages:
|
||||||
formatted_messages.append({"role": msg.role, "content": msg.content})
|
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 = {
|
payload = {
|
||||||
"model": config["model"],
|
"model": config["model"],
|
||||||
"messages": formatted_messages,
|
"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"
|
target_url = f"{config['base_url']}/chat/completions"
|
||||||
@@ -180,7 +190,11 @@ async def get_agent_response(
|
|||||||
ai_data = response.json()
|
ai_data = response.json()
|
||||||
raw_reply = ai_data["choices"][0]["message"]["content"]
|
raw_reply = ai_data["choices"][0]["message"]["content"]
|
||||||
clean_reply, options = _extract_options_from_reply(raw_reply, effective_role)
|
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:
|
except httpx.TimeoutException:
|
||||||
raise HTTPException(
|
raise HTTPException(
|
||||||
status_code=status.HTTP_504_GATEWAY_TIMEOUT,
|
status_code=status.HTTP_504_GATEWAY_TIMEOUT,
|
||||||
|
|||||||
@@ -10,11 +10,13 @@ class ChatMessage(BaseModel):
|
|||||||
class ChatRequest(BaseModel):
|
class ChatRequest(BaseModel):
|
||||||
messages: List[ChatMessage] = Field(..., min_length=1, description="Historial de mensajes de la conversación")
|
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")
|
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):
|
class ChatResponse(BaseModel):
|
||||||
response: str = Field(..., description="Respuesta generada por el agente conversacional")
|
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")
|
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):
|
class RAGReindexResponse(BaseModel):
|
||||||
|
|||||||
+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.25",
|
version="3.8.26",
|
||||||
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",
|
||||||
|
|||||||
@@ -143,3 +143,49 @@ def test_rag_reindex_endpoint_admin_security(init_database):
|
|||||||
data = reindex_res.json()
|
data = reindex_res.json()
|
||||||
assert data["status"] == "success"
|
assert data["status"] == "success"
|
||||||
assert data["indexed_chunks"] >= 10
|
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",
|
"name": "frontend",
|
||||||
"version": "3.8.25",
|
"version": "3.8.26",
|
||||||
"description": "",
|
"description": "",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
@@ -7,7 +7,35 @@
|
|||||||
'use strict';
|
'use strict';
|
||||||
|
|
||||||
let isProcessing = false;
|
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 = {
|
const ROLE_CHIPS = {
|
||||||
docente: [
|
docente: [
|
||||||
@@ -28,10 +56,6 @@
|
|||||||
]
|
]
|
||||||
};
|
};
|
||||||
|
|
||||||
function getContainer() {
|
|
||||||
return document.getElementById('aiChatContainer');
|
|
||||||
}
|
|
||||||
|
|
||||||
function getUserRole() {
|
function getUserRole() {
|
||||||
const container = getContainer();
|
const container = getContainer();
|
||||||
const rawRole = (container ? container.getAttribute('data-user-role') : 'alumno') || 'alumno';
|
const rawRole = (container ? container.getAttribute('data-user-role') : 'alumno') || 'alumno';
|
||||||
@@ -53,7 +77,7 @@
|
|||||||
|
|
||||||
function loadHistory() {
|
function loadHistory() {
|
||||||
try {
|
try {
|
||||||
const raw = sessionStorage.getItem(STORAGE_KEY);
|
const raw = sessionStorage.getItem(getStorageKey());
|
||||||
return raw ? JSON.parse(raw) : [];
|
return raw ? JSON.parse(raw) : [];
|
||||||
} catch (e) {
|
} catch (e) {
|
||||||
return [];
|
return [];
|
||||||
@@ -62,7 +86,7 @@
|
|||||||
|
|
||||||
function saveHistory(messages) {
|
function saveHistory(messages) {
|
||||||
try {
|
try {
|
||||||
sessionStorage.setItem(STORAGE_KEY, JSON.stringify(messages));
|
sessionStorage.setItem(getStorageKey(), JSON.stringify(messages));
|
||||||
} catch (e) {}
|
} catch (e) {}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -169,7 +193,8 @@
|
|||||||
headers: { 'Content-Type': 'application/json' },
|
headers: { 'Content-Type': 'application/json' },
|
||||||
body: JSON.stringify({
|
body: JSON.stringify({
|
||||||
messages: payloadMessages,
|
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) {
|
if (clearBtn) {
|
||||||
clearBtn.addEventListener('click', () => {
|
clearBtn.addEventListener('click', () => {
|
||||||
sessionStorage.removeItem(STORAGE_KEY);
|
sessionStorage.removeItem(getStorageKey());
|
||||||
const messagesContainer = document.getElementById('aiChatMessages');
|
const messagesContainer = document.getElementById('aiChatMessages');
|
||||||
if (messagesContainer) messagesContainer.innerHTML = '';
|
if (messagesContainer) messagesContainer.innerHTML = '';
|
||||||
const initialOptions = (ROLE_CHIPS[role] || []).map(c => c.label);
|
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
|
// Versiones institucionales del sistema
|
||||||
const APP_VERSION = '3.8.25';
|
const APP_VERSION = '3.8.26';
|
||||||
const FRONTEND_VERSION = '3.8.25';
|
const FRONTEND_VERSION = '3.8.26';
|
||||||
const BACKEND_VERSION = '3.8.25';
|
const BACKEND_VERSION = '3.8.26';
|
||||||
|
|
||||||
env.addGlobal('app_version', APP_VERSION);
|
env.addGlobal('app_version', APP_VERSION);
|
||||||
env.addGlobal('frontend_version', FRONTEND_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 -->
|
<!-- WIDGET FLOTANTE: UdeCi - TUTOR VIRTUAL UNICABA -->
|
||||||
<!-- SDD-010: Arquitectura RAG y Asistencia Contextual -->
|
<!-- 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 -->
|
<!-- 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">
|
<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>
|
<span class="ai-launcher-icon"><i class="bi bi-chat-heart-fill"></i></span>
|
||||||
|
|||||||
Reference in New Issue
Block a user