Roles y Flota de Empleados

Orbis no vende software monolítico ni licencias por asiento. Provee e incorpora una Flota de Empleados Digitales (_Orbis_) asignados a puestos específicos dentro de la estructura de la empresa.

Cada empleado digital cuenta con un identificador unívoco de linaje, un conjunto acotado de habilidades (_skills_), rutinas programadas y políticas de supervisión humana alineadas a los objetivos de su puesto.

---

Catálogo de Roles Canónicos

Para sectores como la hospitalidad y los servicios corporativos, Orbis provee roles preconfigurados y homologados (_Domain Packages_):

┌─────────────────────────────────────────────────────────────┐
│                 ROLES CANÓNICOS EN LA FLOTA                 │
├─────────────────────────────────────────────────────────────┤
│ 🏨 ATENCIÓN & RESERVAS   WhatsApp 24/7, cotizaciones y PMS  │
│ 📈 REVENUE & TARIFAS     Monitoreo de demanda y pricing     │
│ 📑 OPERACIONES & AUDITORÍA Conciliación contable y stock    │
└─────────────────────────────────────────────────────────────┘

1. Atención & Reservas (`atencion`)

• Misión: Garantizar respuesta instantánea y cierre comercial de consultas entrantes durante las 24 horas del día.
• Habilidades Autorizadas:

- Consulta de disponibilidad de fechas y tipos de habitación en el PMS.

- Cálculo de cotizaciones dinámicas respetando políticas de estadía mínima.

- Retención transitoria de cupos y emisión de enlaces de pago seguros.

- Asignación de número de confirmación y envío de guías de bienvenida.

• Límites de Seguridad: Solicitudes de descuento mayores al 15% o cancelaciones fuera de término pausan la ejecución y derivan al supervisor.

2. Revenue & Tarifas (`revenue`)

• Misión: Optimizar el ingreso medio por habitación/servicio (_RevPAR_) según el calendario de demanda y el ritmo de reservas (_pickup_).
• Habilidades Autorizadas:

- Análisis de ritmo de ocupación a 30, 60 y 90 días vista.

- Comparación de tarifas públicas de la competencia en canales directos y OTAs.

- Modelado de recomendaciones de aumento o descuento de tarifas por temporada.

• Gobernanza: El empleado de revenue propone cambios tarifarios; la actualización real en el channel manager exige siempre la aprobación de un directivo.

3. Operaciones & Auditoría Nocturna (`operaciones`)

• Misión: Conciliar la operación diaria, detectar inconsistencias contables y automatizar tareas repetitivas de cierre.
• Habilidades Autorizadas:

- Cruce de transacciones bancarias contra cobros asentados en el sistema de reservas.

- Detección de disparidades de inventario entre la venta directa y las OTAs.

- Emisión de reportes de fin de jornada para la gerencia general vía WhatsApp o correo.

---

Invocación por Cron vs Triggers de Eventos

Los empleados digitales operan bajo dos modelos de activación gobernados por jobs.db:

1. RUTINAS PROGRAMADAS (CRON)
   Ej: Todos los días a las 06:00 AM ──► Auditoría de reservas del día
   (Usa modo 'no_agent' si no requiere razonamiento de LLM para ahorrar UT)

2. TRIGGERS DE EVENTOS REACTIVOS
   Ej: Evento 'whatsapp.inbound' ──► Encolamiento durable con clave de deduplicación
       El empleado despierta inmediatamente con el mensaje como contexto.

• Deduplicación Durable: Si Meta o un proveedor de webhook reenvía un mensaje por problemas de red transitorios, la clave de dedupe previene que el empleado ejecute la tarea dos veces.
• Modo deliver_only / no_agent: Para tareas puramente determinísticas (como enviar un recordatorio de check-in programado), el sistema ejecuta el script sin invocar modelos de lenguaje, consumiendo una fracción mínima de Unidades de Trabajo.

---

Circuit Breakers y Protección de Rutinas

Para evitar bucles infinitos causados por fallos en sistemas externos (por ejemplo, si el servidor del PMS devuelve un error 500 recurrente):

• Firma Normalizada de Errores (errorSignature): El sistema computa una huella digital del error colapsando números y datos variables.
• Detección de Caída Repetida: Si una rutina genera la misma firma de error en intentos consecutivos, la tarea se demueve automáticamente a estado failed antes de quemar el tope de reintentos o malgastar el presupuesto del cliente.
• Notificación de Incidente: El panel alerta al operador con el diagnóstico exacto para subsanar la causa raíz.

---

Pausa y Reanudación en Tiempo Real

El supervisor puede pausar o reactivar cualquier empleado de la flota en un clic desde el panel de control o mediante el comando de WhatsApp pausar [empleado].

Al pausar un empleado, sus rutinas activas quedan en espera segura sin perder el contexto de las conversaciones que estuviesen en curso.