Saltar a contenido

Cross-Project Operations

Objetivo

Definir como operar cambios y auditorias que afectan mas de un proyecto sin mezclar repositorios, VPS, documentacion ni responsabilidades.

Regla central

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

Para ecommerce La Directa, la regla ampliada vigente es:

  • La Directa Front disena y muestra.
  • OpenClaw produce, sincroniza, observa y analiza datos.

Registro cross-repo vigente

  • Checkpoint vigente OpenClaw: PDF-013AA.
  • Gate WooCommerce relacionado: PDF-013U-W Production Private Page Authenticated Render / No Form Post.
  • Repo activo del checkpoint: C:\APV\openclawai.
  • Repo WooCommerce relacionado: C:\APV\vps-woocommerce-ladirecta.
  • Rama WooCommerce relacionada: release/intake-pdf013.
  • HEAD remoto WooCommerce relacionado: a561776f0d7d2766ef2b2a2124e354d81b7e8e13.
  • Estado final recomendado WooCommerce: VERDE.
  • OpenClaw registra gobierno maestro y restricciones; WooCommerce La Directa mantiene implementacion ecommerce/plugin/theme/assets.
  • Este registro no autoriza endpoint productivo, POST productivo, nonce productivo, WooCommerce API, SGC, SMTP real, emails, SQL, sync, scheduler, cron, pipelines ni cambios runtime desde OpenClaw.

Decision de repo

Tocar solo C:\APV\openclawai cuando el cambio afecte:

  • Grafana
  • Prometheus
  • Alertmanager
  • Blackbox Exporter
  • dashboards
  • reglas de alertas
  • runbooks y governance de observabilidad central
  • planes de consumo de metricas desde OpenClaw

Tocar solo C:\APV\vps-woocommerce-ladirecta cuando el cambio afecte:

  • WordPress
  • WooCommerce
  • La Directa Ops
  • exporters o endpoints productores de metricas
  • estado operativo de backups y restore del ecommerce
  • runtime del VPS 1735349
  • documentacion del stack nativo del ecommerce

Para la division ecommerce/frontend:

  • OpenClaw mantiene contratos de datos, fuentes, sincronizacion, observabilidad, metricas y gobierno.
  • La Directa Front mantiene theme, child theme, templates WooCommerce, pantallas, componentes, previews y experiencia visual.
  • Si un dato nuevo requiere UI, OpenClaw genera handoff hacia La Directa Front.
  • Si una UI requiere dato nuevo, La Directa Front genera handoff hacia OpenClaw.

Si un pedido mezcla ambas capas:

  1. partir el trabajo en dos safe points
  2. definir repo primario y repo relacionado
  3. bloquear cambios runtime cruzados hasta tener dos prompts separados

Safe points cruzados

Todo safe point multi-proyecto debe declarar:

  • repo activo
  • repo relacionado en solo lectura si aplica
  • VPS de cada lado
  • alcance permitido
  • alcance prohibido
  • contrato de consumidor vs productor
  • evidencia reutilizada desde el otro proyecto sin reescribirla

Formato recomendado:

  • SAFE-POINT-XXX en el repo donde se ejecuta el trabajo
  • referencia explicita al safe point hermano si existe
  • secciones OpenClaw scope y La Directa scope

Registro de commits relacionados

Cuando haya cambios aprobados en ambos repos:

  • cada commit debe nombrar el proyecto propio
  • el runbook de cada repo debe anotar:
  • related_repo
  • related_safe_point
  • related_commit
  • cross_project_status

Convencion sugerida:

  • OpenClaw: docs: define ladirecta cross-project observability contract
  • La Directa: docs: define observability producer contract for openclaw

Si solo cambia un repo:

  • registrar related_commit: none
  • explicar que el otro lado queda sin modificaciones

Prevencion de VPS equivocado

Checklist obligatorio antes de cualquier accion no documental:

  • OpenClaw VPS: 977009 / 46.202.151.32
  • La Directa Woo VPS: 1735349 / 2.25.177.235
  • validar cwd
  • validar repo activo
  • validar documento rector del safe point
  • escribir en el runbook que VPS esta dentro y fuera de alcance

Regla operativa:

  • si el prompt nombra Grafana, Prometheus, Alertmanager o Blackbox, asumir OpenClaw salvo evidencia contraria
  • si el prompt nombra WordPress, WooCommerce, checkout, wp-admin, La Directa Ops, backup runner o restore del ecommerce, asumir La Directa salvo evidencia contraria

Alerta por mezcla de responsabilidades

Detener o dividir el trabajo cuando aparezcan señales como:

  • pedir dashboards y a la vez cambiar WordPress
  • pedir alertas y a la vez tocar wp-config.php
  • pedir metricas comerciales y a la vez consultar la DB productiva desde Grafana
  • pedir observabilidad OpenClaw y a la vez tocar el VPS 1735349

Respuesta operativa requerida:

  • marcar PROMPT MIX WARNING
  • reescribir el alcance en dos bloques:
  • OpenClaw consumer scope
  • La Directa producer scope
  • continuar solo con el bloque autorizado en el repo actual

Reglas de evidencia

  • no duplicar secretos, passwords ni tokens entre repos
  • no copiar datos personales de clientes a OpenClaw
  • no documentar consultas directas de Grafana a la DB productiva WooCommerce
  • reutilizar evidencia documental del repo relacionado mediante referencia, no mediante copia de runtime o secretos

Decision vigente para La Directa

  • OpenClaw puede monitorear disponibilidad publica, SSL, latencia y alertas sinteticas hoy
  • La Directa debe exponer cualquier metrica interna futura mediante endpoint o exporter seguro propio
  • cualquier ampliacion de metricas de negocio requiere safe point separado en el repo de La Directa antes de ser consumida por OpenClaw
  • Para intake ecommerce, PDF-013Z deja registrado que OpenClaw sigue como gobierno maestro y que WooCommerce La Directa mantiene la implementacion ecommerce/plugin/theme/assets en C:\APV\vps-woocommerce-ladirecta.
  • PDF-013U-V Production Private Page Access Validation / No Form Post deja registrada la validacion de acceso privado productivo hecha por WooCommerce: la pagina privada no queda expuesta publicamente, con endpoint bloqueado, sin capturar nonce productivo, sin render autenticado con nonce, sin ejecutar formulario y sin ejecutar POST productivo. Estado final recomendado VERDE.
  • Pagina privada productiva validada: Page ID 32, titulo La Directa Private Intake, slug private-intake-candidate, status private y shortcode [ladirecta_private_intake_form].
  • Feature flag productiva efectiva false, endpoint produccion no ejecutado, POST productivo no ejecutado, nonce produccion no capturado, render autenticado con nonce no ejecutado, HEAD y GET publicos no autenticados a /private-intake-candidate/ devuelven 404, plugin production active private-intake-form,active,0.2.0-candidate y home/tienda 200 OK.
  • Perimetro: pagina privada, sin formulario visible publicamente, sin link publico, menu, navegacion ni sitemap expuesto, sin datos reales y endpoint bloqueado.
  • No hubo WooCommerce API, SGC, SMTP real ni emails; no se imprimieron ni versionaron secretos.
  • GO solo para registrar la validacion de acceso privado productivo ya hecha por WooCommerce y registro documental; NO-GO para crear/modificar pagina desde OpenClaw, endpoint produccion, nonce produccion, render autenticado con nonce, POST productivo y prod runtime/write desde OpenClaw.
  • El proximo paso recomendado es PDF-013U-W PRODUCTION PRIVATE PAGE AUTHENTICATED RENDER / NO FORM POST, solo con gate posterior explicito.
  • El diseno ecommerce pertenece al repo WooCommerce, pero debe avanzar por gate/rama separada.

Documentos rectores para ecommerce:

  • docs/tenants/ladirecta/ecommerce/PROJECT-BOUNDARIES.md
  • docs/tenants/ladirecta/ecommerce/FRONTEND-DATA-CONTRACT.md
  • docs/tenants/ladirecta/ecommerce/CROSS-PROJECT-HANDOFF-PROTOCOL.md
  • docs/tenants/ladirecta/ecommerce/DATA-OWNERSHIP-MATRIX.md