Incidentes, Auditoría & Trail

En operaciones empresariales críticas, la confianza en sistemas de inteligencia artificial depende de dos pilares: evidencia inmutable de cada acción realizada y detección algorítmica temprana de anomalías.

Orbis implementa un libro mayor de auditoría permanente (_The Trail_) y un motor de incidentes derivados en tiempo real sin falsos positivos.

---

El Rastro Inmutable (The Trail)

Cada acción ejecutada por un empleado digital se almacena de forma durable en runs.db bajo un esquema _append-only_. Ningún registro puede ser editado ni borrado a posteriori:

┌─────────────────────────────────────────────────────────────┐
│                 ESTRUCTURA DE UN RUN EN TRAIL               │
├─────────────────────────────────────────────────────────────┤
│ • IDENTIFICADOR ÚNICO          UUID v4 (ej: run-9842a)      │
│ • EMPLEADO & VERSIÓN           employeeId, planRevision     │
│ • EVENTO DISPARADOR            whatsapp.inbound / cron      │
│ • ENTRADA ORIGINAL             Mensaje recibido (sanitizado)│
│ • HERRAMIENTAS INVOCADAS       pms_check, payment_create    │
│ • RESPUESTAS DE SISTEMA        XML con trust="untrusted"    │
│ • DECISIÓN HUMANA (SI HUBO)    APR-842, autorizó: Owner     │
│ • SALIDA EMITIDA               Texto tras escaneo DLP       │
│ • METROLOGÍA DE RECURSOS       milliWU consumidos, duración │
└─────────────────────────────────────────────────────────────┘

El supervisor puede acceder al detalle completo de cualquier ejecución desde la pantalla /trabajo/[runId], visualizando con exactitud de milisegundos qué vio el empleado, qué pensó y por qué tomó cada determinación.

---

Taxonomía de Incidentes Derivados

Los incidentes en Orbis no son tickets manuales ni alarmas ruidosas basadas en heurísticas imprecisas. Son modelos de lectura computados directamente sobre el estado de la infraestructura:

Tipo de Incidente	Causa Raíz Detectada	Severidad	Acción Automática
system_down	2 sondeos HTTP fallidos consecutivos contra el PMS o servidor local confirmado.	Crítica	Alerta inmediata al dueño: el hotel no puede cotizar ni confirmar reservas.
bridge_silent	El Edge Bridge lleva >15 minutos sin emitir telemetría ni latidos de red.	Warning	Notifica posible corte de energía o pérdida de internet en la sede.
waba_billing	Meta rechazó el cobro de la cuenta de WhatsApp Business o la tarjeta expiró.	Crítica	Alerta al dueño para actualizar el medio de pago antes de que Meta suspenda la línea.
budget_exceeded	El consumo diario de Unidades de Trabajo superó el límite maxWuPerDay.	Warning	Pausa preventiva de rutinas automáticas y solicitud de ampliación de cupo.
queue_stale	Tareas encoladas en jobs.db superan el tiempo de espera esperado.	Warning	Escalamiento al equipo técnico de soporte del motor.

---

Ciclo de Vida y Notificaciones Anti-Flapping

Uno de los problemas más comunes en monitoreo de sistemas es la "fatiga de alarmas" provocada por alertas repetitivas cuando un servicio titila (_flapping_).

Orbis aplica un protocolo estricto de notificación única:

[Detección de Anomalía]
          │
          ▼
¿Ya fue notificado al dueño?
   ├── SÍ ──► No re-notifica (Silencio operativo durante el incidente)
   │
   └── NO ──► Envía alerta por WhatsApp: "🚨 Alerta: Servidor PMS local caído en Sede Centro"
             Registra en tabla durable: incident_notified
          │
          ▼
[Normalización del Sistema]
          │
          ▼
¿Estaba notificado como activo?
   └── SÍ ──► Envía confirmación: "✅ Resuelto: Servidor PMS local restablecido"
             Marca resolved_at y archiva en historial

---

Digest Semanal del Negocio

Todos los lunes a las 09:00 AM, Orbis despacha al WhatsApp del dueño un resumen ejecutivo sin tecnicismos con los números consolidados de la semana anterior:

📊 Resumen Operativo Semanal — Orbis
────────────────────────────────────
• Consultas y reservas atendidas: 418
• Reservas confirmadas de forma autónoma: 64
• Horas de atención humana ahorradas: ~52 hs
• Aprobaciones requeridas a gerencia: 5 (todas resueltas)
• Consumo del mes: 34% de tus Unidades de Trabajo (Saludable)
• Incidentes técnicos: 0 activos

Todo funcionando con normalidad. ¡Buena semana!