""" 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)