Referencia técnica para extender control plane y storefront de forma segura con colaboración humano+IA.
Audiencia: Desarrolladores y operadores de agentes IA
Bridge plugin: extensión WordPress que hace onboarding, heartbeats y reporte de capacidades.
Control plane: worker RAGBAZ.xyz que guarda snapshots/historial y sirve docs, páginas peer y tenant.
Storefront: worker público que consume GraphQL WordPress con hardening y comportamiento fallback.
/api/v1/home GET emite challenge. /api/v1/home POST registra sitio. /api/v1/home/heartbeat POST actualiza estado runtime.
Endpoints tenant claim y slug claim vinculan el sitio a una identidad pública estable.
Entregar cambios en cortes pequeños, mantener docs y coop log al día, evitar refactors amplios sin revisar.
Al crear UI nueva, definir primero estados fallback y observabilidad de non-200.
Cache edge GraphQL: 60s + 120s stale (valores por defecto en GRAPHQL_EDGE_CACHE_TTL_SECONDS y GRAPHQL_EDGE_CACHE_STALE_SECONDS).
Caches de menú: snapshot 5m, existencia de URI 5m, sitemap 10m (MENU_SNAPSHOT_TTL_MS, MENU_URI_CHECK_TTL_MS, MENU_SITEMAP_TTL_MS).
Cache de probe: STOREFRONT_GRAPHQL_PROBE_TTL_MS por defecto 900000ms (15m). ISR de /shop con revalidate 300s.
Usar /api/admin/purge-cache y flush de object cache en WordPress tras cambios de rutas/menú/schema.
Server-Timing ahora incluye app_ms, wp_ms y menu_ms en respuestas dinámicas.
Úsalo junto con web vitals y logs de non-200 para separar latencia upstream de latencia del camino de aplicación.