La Directa Observability Contract

Objetivo

Definir el contrato entre OpenClaw como consumidor de observabilidad y La Directa como productor de datos operativos del ecommerce.

Regla central

• OpenClaw observa, alerta y grafica.
• La Directa produce datos, metricas y eventos.

Separacion obligatoria

OpenClaw

Corresponde a C:\APV\openclawai:

• Grafana
• Prometheus
• Alertmanager
• Blackbox Exporter
• dashboards
• reglas y rutas de alertas
• catalogos de observabilidad
• runbooks de consumo y visualizacion

La Directa

Corresponde a C:\APV\vps-woocommerce-ladirecta:

• WordPress
• WooCommerce
• La Directa Ops
• exporters internos
• endpoints /metrics, /health o equivalentes
• status de backups y restore del ecommerce
• logs y salud del runtime WooCommerce
• metricas comerciales primarias

Fuentes permitidas para OpenClaw

Fase 1

• Blackbox sobre URLs publicas
• inspeccion SSL publica
• latencia HTTP publica
• evidencia documental existente de backup, restore drill y SMTP del repo La Directa

Fase 2 en adelante

• endpoints seguros publicados por La Directa Ops
• exporters privados en el VPS WooCommerce
• webhooks o snapshots curados sin PII
• agregados de negocio ya anonimizados o resumidos

Fuentes prohibidas para OpenClaw

• DB productiva WooCommerce como datasource directo de Grafana
• acceso SSH al VPS WooCommerce desde un safe point OpenClaw no aprobado
• tablas o logs con datos personales de clientes
• secretos o passwords copiados al repo OpenClaw
• scraping interno de wp-admin

Labels minimos recomendados

Toda metrica o alerta futura relacionada a La Directa debe incluir:

• tenant="ladirecta"
• service="ecommerce-ladirecta"
• source_project
• producer
• phase

Labels opcionales segun dominio:

• env
• component
• metric_type
• business_domain
• owner

Frecuencias sugeridas

Tipo	Frecuencia	Dueño
probes publicos HTTP/SSL	30s	OpenClaw
health endpoint privado	30s a 60s	La Directa produce / OpenClaw consume
metricas host Woo	30s	La Directa produce / OpenClaw consume
snapshots operativos	5m	La Directa produce / OpenClaw consume
metricas comerciales agregadas	5m a 15m	La Directa produce / OpenClaw consume
restore drill age	diario	La Directa produce / OpenClaw consume

Riesgos rectores

• confundir sintomas externos con causa raiz WooCommerce
• consultar datos de negocio sin contrato productor
• mezclar responsabilidades entre repos
• tocar el VPS 1735349 desde un prompt de observabilidad OpenClaw
• exponer PII en panels o alertas
• crear cardinalidad alta en Prometheus con IDs de pedido, cliente o SKU

Regla de privacidad

• OpenClaw solo puede consumir agregados, contadores y estados operativos
• no usar nombres, emails, telefonos, direcciones ni contenido de pedidos en metricas, logs o alertas
• las alertas deben dispararse por conteos o umbrales, no por registros individuales

Decision de fases

Fase 1 - Implementable ahora desde OpenClaw

• disponibilidad publica
• SSL
• latencia
• alertas sinteticas
• dashboards ejecutivos y operativos basados en Blackbox

Fase 2 - Requiere productor seguro en La Directa Ops

• health WordPress/WooCommerce
• checkout y carrito sinteticos
• backup freshness
• restore drill age
• SMTP status
• Redis/cache status
• logs criticos resumidos
• CPU, RAM y disco del VPS Woo

Fase 3 - Metricas comerciales WooCommerce

• pedidos hoy
• ventas hoy
• ticket promedio
• pedidos pendientes o fallidos
• productos activos
• sin stock y bajo stock

Fase 4 - Integracion avanzada

• ERP
• stock multi-fuente
• campañas
• conversion por canal
• revenue attribution

Estado actual certificado

• OpenClaw ya monitorea https://ladirecta.com.ar/ y https://ladirecta.ar/ con Blackbox
• OpenClaw ya publica dashboard Ecommerce La Directa
• OpenClaw ya tiene canal de alertas ladirecta-email operativo por SMTP runtime
• La Directa ya documenta backup, restore drill, SMTP y observabilidad base en su propio repo
• No existe aun un endpoint/exporter seguro versionado en La Directa para metricas internas WooCommerce consumidas por OpenClaw