349 lines
21 KiB
Python
349 lines
21 KiB
Python
"""
|
|
Servicio RAG Embebido (Retrieval-Augmented Generation) para UdeCi
|
|
Almacenamiento y recuperación semántica en base de datos relacional SQLite/PostgreSQL
|
|
con aislamiento estricto por rol de usuario.
|
|
"""
|
|
import re
|
|
import unicodedata
|
|
from typing import List, Dict, Any, Optional
|
|
from app import db
|
|
from app.models.knowledge_chunk import KnowledgeChunk
|
|
|
|
STOP_WORDS = {
|
|
"de", "la", "el", "los", "las", "un", "una", "unos", "unas", "en", "para", "por",
|
|
"con", "sobre", "entre", "hacia", "hasta", "desde", "que", "como", "cual", "quien",
|
|
"y", "o", "a", "al", "del", "es", "son", "mi", "mis", "tu", "tus", "su", "sus"
|
|
}
|
|
|
|
|
|
def _normalize_text(text: str) -> str:
|
|
"""Normaliza texto eliminando acentos, puntuación y convirtiendo a minúsculas."""
|
|
if not text:
|
|
return ""
|
|
text = unicodedata.normalize('NFKD', text).encode('ASCII', 'ignore').decode('utf-8')
|
|
return re.sub(r'[^a-zA-Z0-9\s]', ' ', text.lower()).strip()
|
|
|
|
|
|
def _tokenize(text: str) -> List[str]:
|
|
"""Extrae palabras clave significativas eliminando stop words."""
|
|
norm = _normalize_text(text)
|
|
tokens = [t for t in norm.split() if len(t) > 2 and t not in STOP_WORDS]
|
|
return tokens
|
|
|
|
|
|
OFFICIAL_KNOWLEDGE_BASE = [
|
|
# -------------------------------------------------------------
|
|
# MANUAL OPERATIVO PARA BEDELÍA Y ADMINISTRADORES
|
|
# -------------------------------------------------------------
|
|
{
|
|
"title": "Circuito Secuencial Canónico de 9 Pasos",
|
|
"role": "bedelia",
|
|
"keywords": "circuito pasos bedelia carga sedes aulas ciclos carreras materias comisiones profesores alumnos reservas",
|
|
"category": "bedelia_manual",
|
|
"content": (
|
|
"El flujo operativo oficial de Bedelía en Admin Edu Space consta de 9 pasos secuenciales:\n"
|
|
"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."
|
|
)
|
|
},
|
|
{
|
|
"title": "Matriz de Conflictos y Validación de Aulas",
|
|
"role": "bedelia",
|
|
"keywords": "conflictos superposicion solapamiento aula aforo docente codocencia restriccion diaria",
|
|
"category": "bedelia_rules",
|
|
"content": (
|
|
"La plataforma aplica una matriz de validación en tiempo real para impedir reservas inválidas:\n"
|
|
"- Conflicto Físico: Dos comisiones no pueden ocupar la misma aula presencial en la misma fecha y franja horaria. En aulas virtuales no aplica colisión.\n"
|
|
"- Control de Aforo: La cantidad de inscriptos no puede superar la capacidad máxima del aula física.\n"
|
|
"- Conflicto Docente: Un profesor no puede dictar dos clases simultáneas, salvo que la comisión tenga co-docencia activa registrada.\n"
|
|
"- Restricción Diaria del Alumno: Un estudiante no puede cursar dos materias regulares el mismo día, salvo cursos cortos o autorización expresa de Bedelía."
|
|
)
|
|
},
|
|
{
|
|
"title": "Optimizador Genético de Aulas con Inteligencia Artificial",
|
|
"role": "bedelia",
|
|
"keywords": "optimizador genetico aulas algoritmo colisiones capacidad asignacion masiva",
|
|
"category": "bedelia_tools",
|
|
"content": (
|
|
"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."
|
|
)
|
|
},
|
|
{
|
|
"title": "Importador Masivo de Google Sheets",
|
|
"role": "bedelia",
|
|
"keywords": "importador google sheets sincronizacion masiva cartelera excel preview granular",
|
|
"category": "bedelia_tools",
|
|
"content": (
|
|
"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."
|
|
)
|
|
},
|
|
{
|
|
"title": "Campus Virtual Moodle, Modalidades de Acceso y Contraseñas",
|
|
"role": "general",
|
|
"keywords": "moodle campus virtual udelaciudad acceso contraseña login clave entrar campus sincronizacion",
|
|
"category": "general",
|
|
"content": (
|
|
"Campus Virtual de UniCABA / Universidad de la Ciudad:\n"
|
|
"- Enlace oficial de acceso: [Campus Virtual UniCABA](https://campus.udelaciudad.edu.ar)\n"
|
|
"- Diferenciación de tipos de acceso y contraseñas:\n"
|
|
" * Admin Edu-Space NO establece, almacena ni gestiona las contraseñas de Moodle ni de Google.\n"
|
|
" * Acceso por Google Workspace (@unicaba.edu.ar): Se ingresa con el correo institucional y la clave administrada en Google de la Ciudad.\n"
|
|
" * Acceso a Moodle / Campus Virtual: Se ingresa en https://campus.udelaciudad.edu.ar con tu usuario/DNI y la contraseña propia de Moodle. Dicha contraseña es emitida y gestionada de forma independiente por el Campus Virtual (NO por Edu-Space). Si no la recuerdas o necesitas restablecerla, utiliza la opción oficial de recuperación en https://campus.udelaciudad.edu.ar/login/forgot_password.php o comunícate con la Mesa de Ayuda del Campus Virtual.\n"
|
|
" * Acceso Local de Edu-Space: Exclusivo para usuarios operativos locales (ej: Bedelía o Administradores de Edu-Space).\n"
|
|
"- Integración técnica: Admin Edu Space se conecta con Moodle 4.1 vía REST Web Services mediante una cola asíncrona resiliente (MoodleSyncTask). Las altas y matriculaciones no bloquean al usuario; se encolan y procesan en background con reintentos exponenciales y Dead Letter Queue (DLQ)."
|
|
)
|
|
},
|
|
|
|
# -------------------------------------------------------------
|
|
# MANUAL OPERATIVO PARA DOCENTES Y PROFESORES
|
|
# -------------------------------------------------------------
|
|
{
|
|
"title": "Consulta de Aulas Asignadas y Aulas Virtuales para Docentes",
|
|
"role": "docente",
|
|
"keywords": "docente aulas clases cartelera horario google meet salas virtuales",
|
|
"category": "docente_manual",
|
|
"content": (
|
|
"Como docente en Admin Edu Space puedes consultar tus espacios áulicos:\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."
|
|
)
|
|
},
|
|
{
|
|
"title": "Libro de Calificaciones (Gradebook) y Actas de Regularidad",
|
|
"role": "docente",
|
|
"keywords": "calificaciones notas parciales recuperatorio gradebook actas regularidad inmutable",
|
|
"category": "docente_manual",
|
|
"content": (
|
|
"El sistema cuenta con un Libro de Calificaciones digital para cada comisión:\n"
|
|
"- El docente puede registrar notas de primer parcial, segundo parcial, recuperatorios y calificar como ausente.\n"
|
|
"- El sistema calcula automáticamente la condición académica del alumno (Regular, Promocionado, Libre).\n"
|
|
"- Al finalizar el cuatrimestre, el docente puede realizar el Cierre de Acta de Regularidad, quedando registrada de forma inmutable con trazabilidad en auditoría."
|
|
)
|
|
},
|
|
{
|
|
"title": "Nómina de Alumnos y Comisiones Activas",
|
|
"role": "docente",
|
|
"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 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."
|
|
)
|
|
},
|
|
|
|
# -------------------------------------------------------------
|
|
# MANUAL PARA ALUMNOS Y ESTUDIANTES
|
|
# -------------------------------------------------------------
|
|
{
|
|
"title": "Consulta de Aula y Horarios de Cursada para Alumnos",
|
|
"role": "alumno",
|
|
"keywords": "alumno aula donde curso hoy horario materias clases cartelera",
|
|
"category": "alumno_manual",
|
|
"content": (
|
|
"Para saber en qué aula cursas tus materias:\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."
|
|
)
|
|
},
|
|
{
|
|
"title": "Mis Materias Matriculadas y Horarios Semanales",
|
|
"role": "alumno",
|
|
"keywords": "materias inscripcion matriculadas horario semanal cursada comisiones",
|
|
"category": "alumno_manual",
|
|
"content": (
|
|
"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."
|
|
)
|
|
},
|
|
{
|
|
"title": "Consulta de Mis Calificaciones y Regularidad para Alumnos",
|
|
"role": "alumno",
|
|
"keywords": "notas calificaciones parciales regularidad actas estado academico mis notas hitos",
|
|
"category": "alumno_manual",
|
|
"content": (
|
|
"Para consultar tus calificaciones y regularidad académica de manera personal:\n"
|
|
"- Ingresa a 'Mis Calificaciones e Hitos' en Menú lateral ➔ Mi Trayectoria ➔ Mis Calificaciones e Hitos.\n"
|
|
"- Verás la tarjeta de cada materia con tus evaluaciones y parciales, notas obtenidas, promedio y condición (Regular, Promocionado o Libre).\n"
|
|
"- La información de calificaciones es estrictamente personal y confidencial para cada alumno.\n"
|
|
"- Ante cualquier discrepancia en tus notas o dudas sobre regularidad, consulta directamente a tu profesor o al departamento de Bedelía."
|
|
)
|
|
},
|
|
|
|
# -------------------------------------------------------------
|
|
# INFORMACIÓN GENERAL INSTITUCIONAL
|
|
# -------------------------------------------------------------
|
|
{
|
|
"title": "Acceso a la Plataforma, Tipos de Autenticación y Soporte",
|
|
"role": "general",
|
|
"keywords": "login acceso cuenta google sso unicaba soporte contraseña clave credenciales moodle",
|
|
"category": "general",
|
|
"content": (
|
|
"Admin Edu Space y los sistemas de UniCABA admiten tres modalidades de acceso independientes:\n"
|
|
"1. Acceso con Google Workspace (@unicaba.edu.ar): Se ingresa con el correo institucional y la clave administrada en Google.\n"
|
|
"2. Acceso a Campus Virtual Moodle ([Campus Virtual UniCABA](https://campus.udelaciudad.edu.ar)): Se ingresa con DNI o usuario y la contraseña propia de Moodle. Importante: Admin Edu-Space NO establece ni almacena las contraseñas de Moodle. Si olvidaste tu clave de Moodle, debes usar el recuperador oficial en https://campus.udelaciudad.edu.ar/login/forgot_password.php o acudir a la Mesa de Ayuda del Campus Virtual.\n"
|
|
"3. Acceso Local: Para cuentas locales administrativas de Edu-Space (ej. Bedelía/Admin).\n"
|
|
"- Si tienes inconvenientes de acceso o requieres asistencia técnica, contacta a Soporte IT o al departamento de Bedelía de UniCABA."
|
|
)
|
|
},
|
|
{
|
|
"title": "Ubicación de la Universidad, Cómo Llegar y Transporte",
|
|
"role": "general",
|
|
"keywords": "ubicacion direccion como llegar maps transporte colectivo subte caba sede central peron",
|
|
"category": "general",
|
|
"content": (
|
|
"UniCABA - Universidad de la Ciudad de Buenos Aires:\n"
|
|
"- Sede Central: Tte. Gral. Juan Domingo Perón 802, San Nicolás, CABA (esquina Esmeralda).\n"
|
|
"- Enlaces de Google Maps para calcular ruta:\n"
|
|
" * Destino Sede Central: [Calcular ruta a UniCABA](https://www.google.com/maps/dir/?api=1&destination=UniCABA,+Tte.+Gral.+Juan+Domingo+Perón+802,+CABA)\n"
|
|
" * Desde tu ubicación actual: [Calcular ruta desde mi ubicación](https://www.google.com/maps/dir/?api=1&origin=current+location&destination=UniCABA,+Tte.+Gral.+Juan+Domingo+Perón+802,+CABA)\n"
|
|
"- Medios de transporte cercanos:\n"
|
|
" * Subte: Línea B (Estación Florida / Carlos Pellegrini), Línea D (Estación 9 de Julio / Tribunales), Línea C (Estación Diagonal Norte).\n"
|
|
" * Colectivos: Metrobus 9 de Julio (Líneas 9, 10, 17, 45, 59, 67, 70, 91, 100) y líneas por Av. Corrientes / Diagonal Norte (24, 29, 111, 146)."
|
|
)
|
|
},
|
|
{
|
|
"title": "Información Meteorológica y Clima del Campus",
|
|
"role": "general",
|
|
"keywords": "clima tiempo temperatura lluvia pronostico meteorologico caba campus sede central",
|
|
"category": "general",
|
|
"content": (
|
|
"UdeCi cuenta con integración meteorológica en tiempo real para la Sede Central (CABA):\n"
|
|
"- Puedes consultar la temperatura actual, sensación térmica, humedad, condiciones del cielo (despejado, nublado, lluvia) y velocidad del viento en la zona de la universidad.\n"
|
|
"- Los datos se obtienen de Open-Meteo y se actualizan automáticamente en el sistema para asistir a la comunidad académica en la planificación de su traslado a clases presenciales."
|
|
)
|
|
},
|
|
{
|
|
"title": "Capacidades y Alcance de UdeCi Tutor Virtual",
|
|
"role": "general",
|
|
"keywords": "acceso informacion que puedes hacer alcance funciones datos tutor virtual capacidades",
|
|
"category": "general",
|
|
"content": (
|
|
"UdeCi es el Tutor Virtual institucional de UniCABA en la plataforma Admin Edu Space.\n"
|
|
"- Información a la que tiene acceso:\n"
|
|
" * Datos académicos y de cursada: Carreras activas, asignaturas, comisiones, docentes a cargo, alumnos matriculados y distribución de inscriptos.\n"
|
|
" * Espacios y reservas: Sedes (Central y Campus Virtual), aulas físicas y virtuales, aforos, reservas pendientes y confirmadas.\n"
|
|
" * Calificaciones e hitos: Evaluaciones parciales, notas, promedio y condición académica según el rol del usuario autenticado (los alumnos solo acceden a sus propias notas).\n"
|
|
" * Métricas operativas en vivo: Cantidad de comisiones asignadas/sin asignar, comisiones con mayor cantidad de alumnos, nómina de profesores.\n"
|
|
" * Clima y transporte: Clima actual en la Sede Central y enlaces para navegación en Google Maps.\n"
|
|
"- Límites de acceso: No tiene acceso a chats privados, datos bancarios, contraseñas ni contenidos multimedia externos ajenos a la vida académica de UniCABA."
|
|
)
|
|
},
|
|
{
|
|
"title": "Normas Institucionales y Uso Responsable",
|
|
"role": "general",
|
|
"keywords": "normas conducta uso responsable porno adultos seguridad etica respeto",
|
|
"category": "general",
|
|
"content": (
|
|
"Admin Edu Space y UdeCi son herramientas estrictamente académicas e institucionales de UniCABA:\n"
|
|
"- En la universidad y sus sistemas informáticos rigen las normativas de convivencia y uso responsable de la red.\n"
|
|
"- No se aloja, promueve ni distribuye contenido para adultos, material pornográfico ni ningún tipo de elemento que vulnere el marco normativo institucional.\n"
|
|
"- El asistente responde con sobriedad y profesionalismo universitario, orientando siempre a las funciones académicas y de gestión áulica."
|
|
)
|
|
}
|
|
]
|
|
|
|
|
|
class RAGService:
|
|
"""Servicio de indexación y recuperación semántica de fragmentos RAG."""
|
|
|
|
@classmethod
|
|
def reindex_default_knowledge(cls) -> int:
|
|
"""Puebla o reinicializa la tabla knowledge_chunks con la documentación oficial."""
|
|
try:
|
|
KnowledgeChunk.query.delete()
|
|
db.session.commit()
|
|
except Exception:
|
|
db.session.rollback()
|
|
|
|
count = 0
|
|
for doc in OFFICIAL_KNOWLEDGE_BASE:
|
|
chunk = KnowledgeChunk(
|
|
title=doc["title"],
|
|
content=doc["content"],
|
|
role=doc["role"],
|
|
keywords=doc["keywords"],
|
|
category=doc.get("category", "manual")
|
|
)
|
|
db.session.add(chunk)
|
|
count += 1
|
|
|
|
db.session.commit()
|
|
return count
|
|
|
|
@classmethod
|
|
def search_relevant_chunks(cls, query: str, user_role: str, limit: int = 3) -> List[Dict[str, Any]]:
|
|
"""
|
|
Ejecuta una búsqueda semántica de fragmentos relevantes,
|
|
aplicando un filtro estricto por el rol del usuario para evitar fugas de información.
|
|
"""
|
|
# Asegurar que existan chunks en base de datos
|
|
total_chunks = KnowledgeChunk.query.count()
|
|
if total_chunks == 0:
|
|
cls.reindex_default_knowledge()
|
|
|
|
normalized_role = (user_role or "alumno").strip().lower()
|
|
if "docente" in normalized_role or "profesor" in normalized_role or "teacher" in normalized_role:
|
|
effective_role = "docente"
|
|
elif "bedelia" in normalized_role or "admin" in normalized_role:
|
|
effective_role = "bedelia"
|
|
else:
|
|
effective_role = "alumno"
|
|
|
|
# Filtrar exclusivamente por rol permitido y documentos generales
|
|
allowed_roles = [effective_role, "general"]
|
|
candidates = KnowledgeChunk.query.filter(KnowledgeChunk.role.in_(allowed_roles)).all()
|
|
|
|
query_tokens = _tokenize(query)
|
|
if not query_tokens:
|
|
# Si la consulta no tiene tokens específicos, retornar los fragmentos introductorios del rol
|
|
return [c.to_dict() for c in candidates[:limit]]
|
|
|
|
scored = []
|
|
for chunk in candidates:
|
|
score = 0.0
|
|
norm_title = _normalize_text(chunk.title)
|
|
norm_content = _normalize_text(chunk.content)
|
|
norm_keywords = _normalize_text(chunk.keywords or "")
|
|
|
|
for token in query_tokens:
|
|
# Coincidencia en título (+5 puntos)
|
|
if token in norm_title:
|
|
score += 5.0
|
|
# Coincidencia en keywords (+3 puntos)
|
|
if token in norm_keywords:
|
|
score += 3.0
|
|
# Coincidencia en contenido (+1 punto)
|
|
if token in norm_content:
|
|
score += 1.0
|
|
|
|
if score > 0:
|
|
scored.append((score, chunk))
|
|
|
|
# Ordenar de mayor a menor relevancia
|
|
scored.sort(key=lambda x: x[0], reverse=True)
|
|
|
|
if scored:
|
|
results = [item[1].to_dict() for item in scored[:limit]]
|
|
else:
|
|
# Fallback a fragmentos generales del rol
|
|
results = [c.to_dict() for c in candidates[:limit]]
|
|
|
|
return results
|