From a5b014efbe4fdc05d54a168e08768f03a31d3a43 Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Tue, 27 Oct 2026 08:11:07 -0300 Subject: [PATCH] fix: aislamiento estricto de conversaciones de chat por usuario e inferencia simultanea (v3.8.26) --- CHANGELOG.md | 16 +++++++ MEMORY.md | 12 +++--- backend/app/__init__.py | 2 +- backend/routers/ai_chat.py | 18 +++++++- backend/schemas/ai_chat.py | 2 + backend/setup.py | 2 +- backend/tests/test_rag_udeci.py | 46 +++++++++++++++++++++ frontend/package.json | 2 +- frontend/public/js/ai-chat-widget.js | 45 +++++++++++++++----- frontend/src/app.js | 6 +-- frontend/views/partials/ai_chat_widget.html | 10 ++++- 11 files changed, 134 insertions(+), 27 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 032f901..f903e81 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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_`. En sesiones no autenticadas se genera un ID único por pestaña (`anon__`). + - 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**: diff --git a/MEMORY.md b/MEMORY.md index 8c6e44a..d726a85 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -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_`. 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. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 4d63b67..31aa394 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -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): diff --git a/backend/routers/ai_chat.py b/backend/routers/ai_chat.py index 833a04a..9050b4a 100644 --- a/backend/routers/ai_chat.py +++ b/backend/routers/ai_chat.py @@ -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, diff --git a/backend/schemas/ai_chat.py b/backend/schemas/ai_chat.py index ba4f978..6a0ef13 100644 --- a/backend/schemas/ai_chat.py +++ b/backend/schemas/ai_chat.py @@ -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): diff --git a/backend/setup.py b/backend/setup.py index 3065bd7..8a25991 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -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", diff --git a/backend/tests/test_rag_udeci.py b/backend/tests/test_rag_udeci.py index 6facf14..8807ad0 100644 --- a/backend/tests/test_rag_udeci.py +++ b/backend/tests/test_rag_udeci.py @@ -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" diff --git a/frontend/package.json b/frontend/package.json index 725ea43..96ddb33 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.25", + "version": "3.8.26", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/public/js/ai-chat-widget.js b/frontend/public/js/ai-chat-widget.js index cb48b31..418fdf8 100644 --- a/frontend/public/js/ai-chat-widget.js +++ b/frontend/public/js/ai-chat-widget.js @@ -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); diff --git a/frontend/src/app.js b/frontend/src/app.js index a6282af..b7a5718 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -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); diff --git a/frontend/views/partials/ai_chat_widget.html b/frontend/views/partials/ai_chat_widget.html index 2c72d29..24ae014 100644 --- a/frontend/views/partials/ai_chat_widget.html +++ b/frontend/views/partials/ai_chat_widget.html @@ -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 %} -
+