feat(ai-chat): enable deep live context by user identity and role (v3.8.31)

This commit is contained in:
2026-10-27 14:59:50 -03:00
parent da7c96d083
commit 32fdd7dbfe
12 changed files with 514 additions and 49 deletions
+341 -34
View File
@@ -1,59 +1,366 @@
"""
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.
LiveContextService - Proveedor de contexto en tiempo real para UdeCi (SDD-010 / SDD-011).
Consulta las entidades relacionales persistidas en base de datos (Sedes, Aulas, Ciclos Lectivos,
Carreras, Asignaturas, Comisiones, Inscripciones y Reservas) para suministrar a UdeCi conocimiento
fidedigno del estado del sistema, adaptado rigurosamente al usuario autenticado y su rol institucional.
"""
from typing import Optional
import re
from typing import Optional, List
from datetime import datetime, timezone
from sqlalchemy import or_, func
from app.models.building import Building
from app.models.classroom import Classroom
from app.models.academic_term import AcademicTerm
from app.models.career import Career
from app.models.subject import Subject, Commission, CommissionTeacher
from app.models.reservation import Reservation
from app.models.enrollment import StudentEnrollment
from app.models.milestone import AcademicMilestone, MilestoneType
from app.models.user import User
class LiveContextService:
"""Extrae un resumen conciso de entidades reales del sistema para enriquecer el System Prompt."""
@classmethod
def get_system_snapshot(cls) -> str:
def resolve_user(
cls,
user_id: Optional[str] = None,
user_email: Optional[str] = None,
user_name: Optional[str] = None
) -> Optional[User]:
"""Localiza el usuario autenticado en la base de datos por ID, email o nombre."""
try:
if user_id:
clean_id = str(user_id).replace("usr_", "").strip()
if clean_id.isdigit():
u = User.query.filter_by(id=int(clean_id)).first()
if u:
return u
if user_email and user_email.strip():
clean_email = user_email.strip().lower()
u = User.query.filter(func.lower(User.email) == clean_email).first()
if u:
return u
if user_name and user_name.strip() and len(user_name.strip()) >= 3:
clean_name = user_name.strip().lower()
u = User.query.filter(
or_(
func.lower(User.name).like(f"%{clean_name}%"),
func.lower(User.first_name).like(f"%{clean_name}%")
)
).first()
if u:
return u
except Exception:
pass
return None
@classmethod
def get_system_snapshot(
cls,
role: str = "alumno",
user_id: Optional[str] = None,
user_email: Optional[str] = None,
user_name: Optional[str] = None,
query: Optional[str] = None
) -> str:
"""
Retorna un bloque de texto formateado con las sedes, ciclos lectivos y aulas activas.
Retorna un bloque de texto formateado con las entidades reales de la base de datos,
personalizado según el usuario autenticado, su rol y su consulta.
"""
lines = []
normalized_role = (role or "alumno").strip().lower()
if "admin" in normalized_role:
effective_role = "admin"
elif "bedelia" in normalized_role:
effective_role = "bedelia"
elif "docent" in normalized_role or "prof" in normalized_role:
effective_role = "docente"
else:
effective_role = "alumno"
now = datetime.now()
start_of_day = datetime(now.year, now.month, now.day, 0, 0, 0)
end_of_day = datetime(now.year, now.month, now.day, 23, 59, 59)
# ---------------------------------------------------------
# 1. CONTEXTO INSTITUCIONAL Y ESTRUCTURA ACADÉMICA GLOBAL
# ---------------------------------------------------------
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
# Ciclos Lectivos
terms = AcademicTerm.query.filter_by(is_active=True).order_by(AcademicTerm.year.desc()).all()
if terms:
lines.append("\nCICLOS LECTIVOS:")
term_strs = []
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}")
term_strs.append(f"{t.name} (Código: {t.code}){curr_tag}")
lines.append("CICLO LECTIVO: " + " | ".join(term_strs))
# 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.")
# Carreras Activas
careers = Career.query.all()
if careers:
career_strs = [f"{c.name} ({c.code})" if c.code else c.name for c in careers]
lines.append(f"CARRERAS ACTIVAS ({len(careers)}): " + ", ".join(career_strs))
# Sedes y Edificios
buildings = Building.query.filter_by(is_active=True).all()
if buildings:
b_strs = []
for b in buildings:
cnt = getattr(b, 'classrooms_count', 0)
addr = f", {b.address}" if b.address else ""
b_strs.append(f"{b.name} ({b.code or 'Sede'}{addr} - {cnt} aulas)")
lines.append("SEDES ACTIVAS: " + " | ".join(b_strs))
# Aulas Totales
total_rooms = Classroom.query.filter_by(is_active=True).count()
if total_rooms > 0:
lines.append(f"TOTAL DE AULAS DISPONIBLES: {total_rooms} aulas activas (presenciales y virtuales)")
except Exception as e:
lines.append(f"ESTADO DE ENTIDADES: Consulta viva temporalmente no disponible ({str(e)}).")
lines.append(f"ESTADO GLOBAL: Información general parcialmente cargada ({str(e)}).")
# ---------------------------------------------------------
# 2. LOCALIZACIÓN DEL USUARIO AUTENTICADO
# ---------------------------------------------------------
target_user = cls.resolve_user(user_id=user_id, user_email=user_email, user_name=user_name)
if target_user:
lines.append(
f"\nUSUARIO IDENTIFICADO EN SISTEMA: {target_user.name} ({target_user.email}) | "
f"Rol: {target_user.get_institutional_role().upper()} | DNI: {target_user.document_number or 'S/D'}"
)
elif user_name:
lines.append(f"\nUSUARIO SESIÓN: {user_name} (Rol aparente: {effective_role.upper()})")
# ---------------------------------------------------------
# 3. INFORMACIÓN ESPECÍFICA SEGÚN EL ROL DEL USUARIO
# ---------------------------------------------------------
try:
if effective_role == "alumno":
lines.append("\n--- DATOS DE CURSADA DEL ALUMNO ---")
if target_user:
# Materias en las que está inscripto
enrollments = (
StudentEnrollment.query
.filter_by(student_id=target_user.id, status='activo')
.all()
)
if enrollments:
lines.append(f"MATERIAS INSCRIPTAS ({len(enrollments)}):")
comm_ids = []
for en in enrollments:
comm = en.commission
if comm:
comm_ids.append(comm.id)
subj_name = comm.subject.name if comm.subject else 'Sin Asignatura'
subj_code = comm.subject.code if comm.subject else ''
sched = comm.schedule or 'Horario por coordinar'
shift = f"Turno {comm.shift}" if comm.shift else ""
t_name = comm.teacher_name
lines.append(f"- {subj_name} [{subj_code}] - Comisión {comm.code} ({sched} - {shift}) | Docente: {t_name}")
# Clases de hoy para el alumno
if comm_ids:
today_reservations = (
Reservation.query
.filter(
Reservation.commission_id.in_(comm_ids),
Reservation.start_time >= start_of_day,
Reservation.start_time <= end_of_day,
Reservation.status != 'CANCELLED'
)
.order_by(Reservation.start_time.asc())
.all()
)
if today_reservations:
lines.append("CLASES PROGRAMADAS PARA HOY:")
for res in today_reservations:
st = res.start_time.strftime("%H:%M")
et = res.end_time.strftime("%H:%M")
room_str = res.classroom.location_display if res.classroom else "Aula por confirmar"
lines.append(f"👉 HOY cursas: {res.subject_name} en {room_str} de {st} a {et} hs.")
else:
lines.append("CLASES DE HOY: No tienes clases presenciales ni virtuales programadas para el día de hoy.")
# Hitos y exámenes próximos
try:
subj_ids = [e.commission.subject_id for e in enrollments if e.commission and e.commission.subject_id]
if subj_ids:
milestones = (
AcademicMilestone.query
.filter(
AcademicMilestone.subject_id.in_(subj_ids),
AcademicMilestone.date >= start_of_day
)
.order_by(AcademicMilestone.date.asc())
.limit(5)
.all()
)
if milestones:
lines.append("PRÓXIMOS HITOS / EVALUACIONES:")
for m in milestones:
m_date = m.date.strftime("%d/%m/%Y %H:%M")
t_title = m.type_obj.name if m.type_obj else (m.title or "Hito")
lines.append(f"- {m.materia_codigo}: {t_title} el {m_date}")
except Exception:
pass
else:
lines.append("MATERIAS: No registras materias inscriptas activas en este cuatrimestre.")
else:
lines.append("NOTA ALUMNO: Si buscas en qué aula cursas, indica la materia o comisión para consultar el aula asignada.")
elif effective_role == "docente":
lines.append("\n--- DATOS ACADÉMICOS DEL DOCENTE ---")
if target_user:
# Comisiones a cargo
taught_commissions = (
Commission.query
.filter(
or_(
Commission.teacher_id == target_user.id,
Commission.id.in_(
CommissionTeacher.query
.with_entities(CommissionTeacher.commission_id)
.filter_by(user_id=target_user.id)
)
),
Commission.active == True
)
.all()
)
if taught_commissions:
lines.append(f"COMISIONES A TU CARGO ({len(taught_commissions)}):")
t_comm_ids = []
for tc in taught_commissions:
t_comm_ids.append(tc.id)
subj_name = tc.subject.name if tc.subject else 'Sin materia'
shift = f"Turno {tc.shift}" if tc.shift else ""
acta_status = "Acta Cerrada" if tc.grades_closed else "Acta Abierta (Carga de Notas Habilitada)"
lines.append(f"- {subj_name} (Comisión {tc.code}): {tc.schedule or 'Sin horario'} - {shift} | {tc.current_students} alumnos | Estado: {acta_status}")
# Clases de hoy del docente
if t_comm_ids:
doc_res_today = (
Reservation.query
.filter(
Reservation.commission_id.in_(t_comm_ids),
Reservation.start_time >= start_of_day,
Reservation.start_time <= end_of_day,
Reservation.status != 'CANCELLED'
)
.order_by(Reservation.start_time.asc())
.all()
)
if doc_res_today:
lines.append("TUS CLASES DE HOY:")
for r in doc_res_today:
st = r.start_time.strftime("%H:%M")
et = r.end_time.strftime("%H:%M")
room_str = r.classroom.location_display if r.classroom else "Aula a confirmar"
lines.append(f"👉 Dictas: {r.subject_name} en {room_str} ({st} a {et} hs) - Esperados: {r.expected_attendees}")
else:
lines.append("CLASES DE HOY: No tienes reservas de aulas registradas para hoy.")
else:
lines.append("COMISIONES: No registras comisiones asignadas como docente titular ni adjunto en el ciclo actual.")
elif effective_role == "bedelia":
lines.append("\n--- BALANCE OPERATIVO DE BEDELÍA (HOY) ---")
total_res_today = (
Reservation.query
.filter(
Reservation.start_time >= start_of_day,
Reservation.start_time <= end_of_day,
Reservation.status != 'CANCELLED'
)
.count()
)
pending_res = (
Reservation.query
.filter(Reservation.status == 'PENDING')
.count()
)
active_commissions_cnt = Commission.query.filter_by(active=True).count()
total_subjects_cnt = Subject.query.filter_by(is_active=True).count()
lines.append(f"- Reservas programadas para hoy: {total_res_today}")
lines.append(f"- Reservas pendientes de confirmación: {pending_res}")
lines.append(f"- Comisiones activas en el sistema: {active_commissions_cnt}")
lines.append(f"- Asignaturas activas: {total_subjects_cnt}")
elif effective_role == "admin":
lines.append("\n--- GOBIERNO Y ESTADÍSTICAS DEL SISTEMA ---")
try:
total_users = User.query.filter_by(is_active=True).count()
alumnos_cnt = User.query.filter(User.is_active == True, func.lower(User.role).like('%alumn%')).count()
docentes_cnt = User.query.filter(User.is_active == True, func.lower(User.role).like('%docent%')).count()
bedelia_cnt = User.query.filter(User.is_active == True, func.lower(User.role).like('%bedel%')).count()
admin_cnt = User.query.filter(User.is_active == True, func.lower(User.role).like('%admin%')).count()
lines.append(
f"USUARIOS ACTIVOS ({total_users}): {alumnos_cnt} Alumnos | {docentes_cnt} Docentes | "
f"{bedelia_cnt} Bedelía | {admin_cnt} Administradores"
)
lines.append(
f"TOTALES ACADÉMICOS: {Career.query.count()} Carreras | "
f"{Subject.query.filter_by(is_active=True).count()} Asignaturas | "
f"{Commission.query.filter_by(active=True).count()} Comisiones | "
f"{Classroom.query.filter_by(is_active=True).count()} Aulas"
)
except Exception:
pass
except Exception as e:
lines.append(f"DETALLE DE ROL: Error consultando datos específicos ({str(e)}).")
# ---------------------------------------------------------
# 4. BÚSQUEDA DINÁMICA POR PALABRAS CLAVE EN LA CONSULTA
# ---------------------------------------------------------
if query and len(query.strip()) >= 3:
try:
tokens = [
w for w in re.findall(r'[a-zA-Z0-9áéíóúñÁÉÍÓÚÑ]+', query.lower())
if len(w) >= 3 and w not in {
'donde', 'como', 'cuando', 'para', 'hola', 'buenas', 'cursar',
'materia', 'materias', 'clase', 'clases', 'aula', 'aulas', 'que', 'cual'
}
]
if tokens:
# Buscar asignaturas coincidentes
search_filter = or_(
*[Subject.name.ilike(f"%{tok}%") for tok in tokens],
*[Subject.code.ilike(f"%{tok}%") for tok in tokens]
)
matched_subjects = (
Subject.query
.filter(Subject.is_active == True, search_filter)
.limit(4)
.all()
)
if matched_subjects:
lines.append("\nASIGNATURAS COINCIDENTES CON LA CONSULTA:")
for s in matched_subjects:
c_names = s.career_obj.name if s.career_obj else "Carrera General"
lines.append(f"• {s.name} (Código: {s.code} | {c_names}):")
if s.commissions:
for sc in s.commissions[:2]:
t_str = f"Prof: {sc.teacher_name}" if sc.teacher else "Docente a designar"
lines.append(f" - Comisión {sc.code}: {sc.schedule or 'Horario a confirmar'} ({t_str})")
# Buscar aulas coincidentes si se menciona un código o número
classroom_tokens = [w for w in tokens if w.isdigit() or 'lab' in w or 'virtual' in w]
if classroom_tokens:
c_filter = or_(*[Classroom.code.ilike(f"%{tok}%") for tok in classroom_tokens])
matched_rooms = Classroom.query.filter(Classroom.is_active == True, c_filter).limit(3).all()
if matched_rooms:
lines.append("\nAULAS COINCIDENTES:")
for rm in matched_rooms:
cap = rm.capacity_display
lines.append(f"• Aula {rm.code_display} (Piso: {rm.floor_display}, Capacidad: {cap})")
except Exception:
pass
return "\n".join(lines)