Files
admin-edu-space/backend/app/services/live_context_service.py
T

367 lines
19 KiB
Python

"""
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.
"""
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 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 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:
# Ciclos Lectivos
terms = AcademicTerm.query.filter_by(is_active=True).order_by(AcademicTerm.year.desc()).all()
if terms:
term_strs = []
for t in terms:
curr_tag = " [VIGENTE ACTUALMENTE]" if getattr(t, 'is_current', False) else ""
term_strs.append(f"{t.name} (Código: {t.code}){curr_tag}")
lines.append("CICLO LECTIVO: " + " | ".join(term_strs))
# 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 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)