feat: anti-prompt injection, live context db entities and udeci ux/ui refinement v3.8.28

This commit is contained in:
2026-10-27 08:51:12 -03:00
parent bf5b7c3ae7
commit 737ddf44a8
14 changed files with 436 additions and 120 deletions
+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.27"
__version__ = "3.8.28"
class DummyContext:
def __enter__(self):
@@ -0,0 +1,59 @@
"""
LiveContextService - Proveedor de contexto en tiempo real para UdeCi (SDD-010).
Consulta las entidades relacionales persistidas en base de datos (Sedes, Aulas, Ciclos Lectivos)
para suministrar a UdeCi conocimiento fidedigno del estado del sistema, evitando alucinaciones
o respuestas genéricas de falta de acceso a la información.
"""
from typing import Optional
from app.models.building import Building
from app.models.classroom import Classroom
from app.models.academic_term import AcademicTerm
class LiveContextService:
"""Extrae un resumen conciso de entidades reales del sistema para enriquecer el System Prompt."""
@classmethod
def get_system_snapshot(cls) -> str:
"""
Retorna un bloque de texto formateado con las sedes, ciclos lectivos y aulas activas.
"""
lines = []
try:
# 1. Sedes y Edificios
buildings = Building.query.filter_by(is_active=True).all()
if buildings:
lines.append("SEDES Y EDIFICIOS ACTIVOS EN EL SISTEMA:")
for b in buildings:
parts = [f"- {b.name}"]
if b.code:
parts.append(f"Código: {b.code}")
if b.address:
parts.append(f"Dirección: {b.address}")
cnt = getattr(b, 'classrooms_count', 0)
parts.append(f"Aulas: {cnt}")
cap = getattr(b, 'capacity_display', None)
if cap:
parts.append(f"Capacidad: {cap}")
lines.append(" (" + ", ".join(parts[1:]) + ")" if len(parts) > 1 else parts[0])
else:
lines.append("SEDES: No hay sedes registradas en este momento.")
# 2. Ciclos Lectivos
terms = AcademicTerm.query.filter_by(is_active=True).order_by(AcademicTerm.year.desc()).all()
if terms:
lines.append("\nCICLOS LECTIVOS:")
for t in terms:
curr_tag = " [VIGENTE ACTUALMENTE]" if getattr(t, 'is_current', False) else ""
lines.append(f"- {t.name} (Código: {t.code}){curr_tag}")
# 3. Métrica de Aulas
total_classrooms = Classroom.query.filter_by(is_active=True).count()
if total_classrooms > 0:
lines.append(f"\nAULAS: Hay {total_classrooms} aulas activas en total en la plataforma.")
except Exception as e:
lines.append(f"ESTADO DE ENTIDADES: Consulta viva temporalmente no disponible ({str(e)}).")
return "\n".join(lines)
+101
View File
@@ -0,0 +1,101 @@
"""
app/services/prompt_security.py - Módulo de Protección Anti-Prompt Injection (SDD-011)
Protege a UdeCi contra ataques de Jailbreak, System Prompt Leaks,
modos de desarrollador ficticios e inyección de tokens de control LLM.
"""
import re
import unicodedata
from typing import Tuple, List, Optional
# Patrones de inyección de prompt y jailbreak conocidos (en español e inglés)
INJECTION_PATTERNS = [
# 1. Anulación de instrucciones previas
r"ignor[ea]\s+(todas\s+)?(las\s+)?instrucciones(\s+anteriores)?",
r"ignore\s+(all\s+)?(previous\s+)?instructions",
r"olvida\s+(todas\s+)?(las\s+)?(reglas|directivas|instrucciones)",
r"forget\s+(all\s+)?(previous\s+)?(rules|instructions|directives)",
r"disregard\s+(all\s+)?(previous\s+)?instructions",
r"reset\s+(all\s+)?rules",
# 2. Modos no restringidos / Jailbreaks
r"developer\s+mode",
r"modo\s+desarrollador",
r"dan\s+mode",
r"jailbreak",
r"act\s+as\s+(an?\s+)?(unrestricted|evil|unfiltered|hacker)",
r"actua\s+como\s+(un\s+)?(hacker|sistema\s+sin\s+restricciones|asistente\s+sin\s+filtros)",
r"pretend\s+you\s+(are\s+not|have\s+no)\s+rules",
r"simula\s+que\s+no\s+tienes\s+reglas",
# 3. Filtración de System Prompt y Credenciales
r"(muestra|revela|imprime|dime|revelar|mostrar)\s+(tu\s+)?(system\s+prompt|prompt\s+del\s+sistema|instrucciones\s+internas|reglas\s+secretas)",
r"(reveal|print|show|display|leak)\s+(your\s+)?(system\s+prompt|initial\s+instructions|secret\s+rules)",
r"(dame|revela|muestra)\s+(la\s+contrase[ñn]a|el\s+password|las\s+credenciales|los\s+tokens|el\s+archivo\s+\.env|\.credenciales)",
r"(give\s+me|reveal|show)\s+(the\s+password|credentials|api\s+keys|\.env)"
]
# Tokens de control de delimitación para modelos Qwen / Llama / ChatML
SPECIAL_TOKENS = [
"<|im_start|>",
"<|im_end|>",
"<|endoftext|>",
"[INST]",
"[/INST]",
"<<SYS>>",
"<</SYS>>",
"<|system|>",
"<|user|>",
"<|assistant|>"
]
def normalize_for_security(text: str) -> str:
"""Normaliza texto eliminando diacríticos, espacios repetidos y caracteres de control."""
if not text:
return ""
# Quitar tildes y diacríticos
nfkd = unicodedata.normalize('NFKD', text)
cleaned = ''.join([c for c in nfkd if not unicodedata.combining(c)]).lower()
# Reducir espacios múltiples
return re.sub(r'\s+', ' ', cleaned).strip()
class PromptSecurityService:
"""Servicio de validación y sanitización contra Prompt Injections."""
@classmethod
def sanitize_input(cls, text: str) -> str:
"""
Elimina o escapa tokens especiales de control de plantilla que
podrían intentar inyectar bloques de sistema en el LLM.
"""
if not text:
return ""
sanitized = text
for token in SPECIAL_TOKENS:
sanitized = sanitized.replace(token, "")
return sanitized.strip()
@classmethod
def validate_user_message(cls, text: str) -> Tuple[bool, Optional[str]]:
"""
Examina el mensaje del usuario para detectar intentos de inyección o jailbreak.
Retorna (es_seguro: bool, mensaje_defensivo: Optional[str]).
"""
if not text:
return True, None
normalized = normalize_for_security(text)
# Chequear contra la lista de patrones de inyección
for pattern in INJECTION_PATTERNS:
if re.search(pattern, normalized, re.IGNORECASE):
return False, (
"Lo siento, como **UdeCi** estoy programado para asistirte exclusivamente en la "
"gestión académica y operativa de Admin Edu Space (UniCABA). "
"No tengo permitido modificar mis directivas de seguridad, asumir otros roles "
"ni revelar instrucciones internas del sistema."
)
return True, None
+16 -16
View File
@@ -42,15 +42,15 @@ OFFICIAL_KNOWLEDGE_BASE = [
"category": "bedelia_manual",
"content": (
"El flujo operativo oficial de Bedelía en Admin Edu Space consta de 9 pasos secuenciales:\n"
"1. Sedes/Edificios: Dar de alta el campus y sedes institucionales.\n"
"2. Aulas: Crear aulas físicas con piso y aforo, o salas virtuales (Campus Virtual / Meet).\n"
"3. Ciclos Lectivos: Definir el cuatrimestre y vigencia (ej. 2° Cuatrimestre 2026).\n"
"4. Carreras: Crear las carreras oficiales de UniCABA.\n"
"5. Asignaturas: Cargar materias asociadas a una o múltiples carreras (Many-to-Many).\n"
"6. Comisiones: Crear comisiones asignando materia, carrera, ciclo y turno.\n"
"7. Profesores: Asignar los docentes responsables de cada comisión.\n"
"8. Alumnos: Matricular estudiantes en las comisiones correspondientes.\n"
"9. Reservas de Espacio: Asignar aula presencial o enlace virtual para la cursada."
"1. Sedes/Edificios: Accede al Menú lateral ➔ Sedes / Edificios para dar de alta el campus y sedes institucionales.\n"
"2. Aulas: Accede al Menú lateral ➔ Aulas para crear aulas físicas con piso y aforo, o salas virtuales.\n"
"3. Ciclos Lectivos: Accede al Menú lateral ➔ Ciclos Lectivos para definir el cuatrimestre y vigencia.\n"
"4. Carreras: Accede al Menú lateral ➔ Carreras para gestionar la oferta académica de UniCABA.\n"
"5. Asignaturas: Accede al Menú lateral ➔ Asignaturas para cargar materias asociadas a carreras.\n"
"6. Comisiones: Accede al Menú lateral ➔ Comisiones para crear grupos con materia, ciclo y turno.\n"
"7. Profesores: Accede al Menú lateral ➔ Profesores para asignar los docentes responsables.\n"
"8. Alumnos: Accede al Menú lateral ➔ Alumnos para matricular estudiantes en comisiones.\n"
"9. Reservas de Espacio: Accede al Menú lateral ➔ Reservas para asignar aulas presenciales o enlaces virtuales."
)
},
{
@@ -72,7 +72,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"keywords": "optimizador genetico aulas algoritmo colisiones capacidad asignacion masiva",
"category": "bedelia_tools",
"content": (
"El Optimizador Genético de Aulas (disponible en /genetic_optimizer) asigna de forma automatizada aulas físicas a comisiones activas:\n"
"El Optimizador Genético de Aulas (disponible en Menú lateral ➔ Herramientas ➔ Optimizador IA) asigna de forma automatizada aulas físicas a comisiones activas:\n"
"- Resuelve superposiciones horarias y minimiza el aforo ocioso adaptando la capacidad del aula al cupo de la materia.\n"
"- Permite ejecutar la optimización, previsualizar las asignaciones propuestas con desglose de fitness, y aplicar los cambios masivamente en base de datos con un solo clic con registro en Auditoría."
)
@@ -83,7 +83,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"keywords": "importador google sheets sincronizacion masiva cartelera excel preview granular",
"category": "bedelia_tools",
"content": (
"La herramienta de sincronización (/admin/google_sheets_import) permite ingerir planillas online de UniCABA:\n"
"La herramienta de sincronización (disponible en Menú lateral ➔ Integraciones ➔ Importar Google Sheets) permite ingerir planillas online de UniCABA:\n"
"- Inspección Previa: El botón 'Inspeccionar Sheet Online' muestra una grilla interactiva sin guardar datos directamente.\n"
"- Selección Granular: Permite tildar qué entidades importar (reservas, aulas, comisiones, materias, carreras) y filtrar por día de la semana o carrera.\n"
"- Modificación Manual de Fecha: Permite corregir o forzar una fecha específica para una fila o grupo de comisiones antes de confirmar la sincronización."
@@ -97,7 +97,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"content": (
"Admin Edu Space se conecta con Moodle 4.1 vía REST Web Services mediante una cola asíncrona resiliente (MoodleSyncTask):\n"
"- Las altas y matriculaciones no bloquean al usuario; se encolan y procesan en background con reintentos exponenciales y Dead Letter Queue (DLQ).\n"
"- Los administradores pueden monitorear tareas pendientes y estadísticas en la pestaña Moodle de Configuración Global (/admin/settings)."
"- Los administradores pueden monitorear tareas pendientes y estadísticas en la pestaña Moodle de Configuración Global (Menú lateral ➔ Administración ➔ Configuración)."
)
},
@@ -111,7 +111,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"category": "docente_manual",
"content": (
"Como docente en Admin Edu Space puedes consultar tus espacios áulicos:\n"
"- En el Dashboard Docente (/dashboard) y en la Cartelera de Clases (/schedule/today_schedule) puedes ver tus materias asignadas para hoy y la semana.\n"
"- En el Panel de Inicio y en la Cartelera de Clases (menú superior: Cartelera) puedes ver tus materias asignadas para hoy y la semana.\n"
"- Se indica el aula presencial asignada con piso y sede, o el botón directo a la sala virtual de Google Meet / Teams si la modalidad es remota.\n"
"- Si requieres un cambio de aula física, debes solicitarlo al personal de Bedelía."
)
@@ -134,7 +134,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"keywords": "nomina alumnos estudiantes comisiones lista asistencia cursada",
"category": "docente_manual",
"content": (
"Los profesores pueden consultar la nómina completa de estudiantes inscriptos en sus asignaturas desde el panel de comisiones:\n"
"Los profesores pueden consultar la nómina completa de estudiantes inscriptos en sus asignaturas desde Menú lateral ➔ Comisiones:\n"
"- Se visualiza el DNI, nombre, correo institucional y estado de matrícula de cada alumno.\n"
"- No está permitido a los docentes crear carreras, borrar aulas ni alterar parámetros de configuración del sistema; estas acciones están reservadas a Bedelía."
)
@@ -150,7 +150,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"category": "alumno_manual",
"content": (
"Para saber en qué aula cursas tus materias:\n"
"- Ingresa al Dashboard de Estudiante (/dashboard) o a la Cartelera de Clases (/schedule/today_schedule).\n"
"- Ingresa al Panel de Inicio o a la Cartelera de Clases (menú superior: Cartelera).\n"
"- Verás la tarjeta de tu clase del día con el nombre de la materia, comisión, horario de inicio y finalización, y el número de aula física asignada.\n"
"- Si la clase es virtual, encontrarás un botón directo para unirte a la videollamada de Google Meet."
)
@@ -161,7 +161,7 @@ OFFICIAL_KNOWLEDGE_BASE = [
"keywords": "materias inscripcion matriculadas horario semanal cursada comisiones",
"category": "alumno_manual",
"content": (
"En la sección 'Mis Materias' (/my_subjects) puedes verificar:\n"
"En la sección 'Mis Materias' del menú lateral puedes verificar:\n"
"- La lista de asignaturas en las que te encuentras matriculado en el ciclo lectivo actual.\n"
"- El equipo docente a cargo de cada comisión y los días de cursada asignados.\n"
"- Recuerda que el sistema impide matricularse en dos materias regulares el mismo día para evitar superposiciones de estudio."