Saltar a contenido

SAFE-POINT-040 - La Directa Observability Contract

Fecha: 2026-06-17

Metadata

  • active_repo: C:\APV\openclawai
  • related_repo: C:\APV\vps-woocommerce-ladirecta
  • related_commit: none
  • woo_vps_touched: false
  • openclaw_vps_touched: false
  • dns_changed: false
  • secrets_changed: false

Objetivo

Documentar el contrato multi-proyecto para que OpenClaw observe, alerte y grafique el ecommerce La Directa sin mezclar repos, VPS ni responsabilidades.

Safe point inicial

  • Workspace activo: C:\APV\openclawai
  • Repo relacionado solo lectura: C:\APV\vps-woocommerce-ladirecta
  • git status -sb: ## main...origin/main
  • git rev-parse HEAD: c595f9952ee98051630b5b48e829a3eecbb37fc6

Alcance ejecutado

  • auditoria documental de OpenClaw sobre Grafana, Prometheus, Alertmanager, Blackbox, dashboards y alertas La Directa
  • auditoria documental solo lectura del repo La Directa para ubicar productores ya documentados
  • contrato consumidor/productor
  • metodologia multi-proyecto
  • catalogo inicial de metricas
  • plan de dashboards
  • plan de alertas
  • fases y riesgos

Restricciones respetadas

  • no se modifico C:\APV\vps-woocommerce-ladirecta
  • no se toco el VPS WooCommerce 1735349
  • no se toco el VPS OpenClaw 977009
  • no se tocaron DNS, Cloudflare, firewall, SSH, WordPress ni secretos
  • no se conecto Grafana directo a la DB productiva WooCommerce
  • no se documentaron datos personales de clientes

Hallazgos de OpenClaw

  • ya existe monitoreo Blackbox para ladirecta.com.ar y ladirecta.ar
  • ya existe dashboard Ecommerce La Directa
  • ya existe canal SMTP runtime para alertas La Directa en Alertmanager
  • los catalogos O4 aun describen principalmente cobertura actual, no el contrato completo consumidor/productor a futuro

Hallazgos de La Directa

  • el repo del ecommerce ya documenta backup, restore drill, SMTP y auditoria de arquitectura de observabilidad
  • hoy no hay evidencia versionada en OpenClaw de un endpoint/exporter seguro del lado La Directa consumido por Prometheus
  • por lo tanto CPU/RAM/disco Woo, health interno Woo, checkout sintetico y KPIs comerciales quedan fuera de Fase 1

Decision documental

  • OpenClaw queda como consumidor central de metricas, alertas y dashboards
  • La Directa queda como productor exclusivo de metricas internas del ecommerce
  • cualquier ampliacion futura de metricas internas o comerciales requiere un safe point separado del lado La Directa antes de habilitar el consumo en OpenClaw

Documentos creados o actualizados

  • docs/governance/CROSS-PROJECT-OPERATIONS.md
  • docs/tenants/ladirecta/observability/OBSERVABILITY-CONTRACT.md
  • docs/tenants/ladirecta/observability/METRICS-CATALOG.md
  • docs/tenants/ladirecta/observability/DASHBOARD-PLAN.md
  • docs/tenants/ladirecta/observability/ALERTS-PLAN.md
  • docs/runbooks/SAFE-POINT-040-ladirecta-observability-contract.md

Resultado esperado

El operador debe poder decidir rapido:

  • que repo tocar
  • que VPS no tocar
  • que metricas ya pueden observarse desde OpenClaw
  • que metricas dependen de productor seguro en La Directa
  • que dashboards y alertas se pueden planificar sin cruzar responsabilidades