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

60 lines
2.6 KiB
Python

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