Glosario técnico

Complementa el glosario de negocio en Notion (página GLOSARIO del Centro de Mando).

Arquitectura y Organización

Término	Definición
ADR	Architecture Decision Record: documento corto que fija una decisión de diseño.
C4 Model	Marco de diagramas de arquitectura en 4 niveles (Contexto, Contenedor, Componente, Código).
Monorepo	Un solo repositorio Git con varias aplicaciones (`apps/*`).
Vertical	Línea de negocio (main, travel, gastro) bajo `apps/*`. `ai-orchestrator` y `tools` son servicios transversales, no verticales.
PDR	Prompt Decision Record: registro de cambios a prompts del sistema de IA.
Turborepo	Orquestador de tareas en monorepos npm (`turbo run build`, etc.).

Término	Definición
PMS	Property Management System: software de gestión hotelera (contexto travel).
Property	Identidad de un hotel en el sistema. Contiene rooms, room_types, reservaciones. Multi-tenant.
`property_id`	Identificador único del hotel (ej: `baum-01`). Clave de multi-tenancy en toda la API.
RoomType	Categoría de habitación (ej: "Cabaña del Sendero"). Define capacidad, precio base, amenidades.
Room	Unidad física de alojamiento. Pertenece a un RoomType y una Property.
BlockedDate	Fecha bloqueada para un RoomType en una Property. Excluye ese tipo de la disponibilidad.
PropertyConfig	Configuración operativa del hotel: horarios check-in/out, mascotas, piscina, cancelación.
HotelKnowledge	FAQ del hotel indexable. Contiene question, answer, category por property.
Guest	Huésped registrado. Se identifica por teléfono (único). Se crea automáticamente al reservar.
ConversationSession	Estado persistido de una conversación de chat (bot ↔ huésped) en PostgreSQL.
`check_in` / `check_out`	Fechas de entrada y salida. Formato ISO `YYYY-MM-DD`. Rango semiabierto `[check_in, check_out)`.
Combination	Conjunto de 2+ RoomTypes que cubren un grupo grande cuando ninguno cubre solo.

Término	Definición
LangGraph	Framework de agentes como grafo de estados. Cada nodo procesa y transforma el estado.
`TimeLiberState`	TypedDict con 13 campos que fluye entre nodos del grafo (messages, session_id, guest_name, etc.).
Guard	Validación en Python que previene comportamiento no deseado del LLM (ej: loops, nombres falsos).
`tool_call`	Invocación estructurada de una herramienta por el LLM (ej: `consultar_disponibilidad`).
ReAct	Patrón Reasoning + Acting: el LLM primero usa una herramienta, luego sintetiza la respuesta.
MemorySaver	Checkpointer en RAM para LangGraph (dev). En producción se migra a RedisSaver.
`structured_output`	Respuesta del LLM forzada a un schema Pydantic (ej: clasificación de intención).
Hallucination	Respuesta inventada por el LLM sin base en datos reales. Los guards la previenen.
Eval	Test end-to-end que simula una conversación completa y evalúa el resultado con un Juez.
Seed (tests)	Semilla para random: `Random(42)` garantiza que los mismos 200 perfiles se generan siempre.

Término	Definición
Collection (Qdrant)	Conjunto de vectores / puntos en Qdrant; equivale a una "knowledge base" indexada.
RAG	Retrieval Augmented Generation: recuperar contexto (vectores) y generar respuesta con LLM.
Dual RAG	Estrategia en Travel: busca primero en FAQs (score ≥ 0.45), fallback a Chunks (score ≥ 0.38).
Evolution API	Servicio que gestiona instancias de WhatsApp; conecta con n8n.
n8n	Plataforma de automatización de flujos; dispara webhooks y conecta APIs.
OpenAPI	Especificación de API; FastAPI la genera en `/openapi.json`.
Traefik	Proxy reverso que enruta tráfico HTTPS a contenedores por labels.
`tenant`	Sinónimo de property en contexto multi-tenant. Cada hotel es un tenant aislado.
`session_id`	ID único de hilo de conversación. Permite al MemorySaver restaurar el estado entre mensajes.