Teknisk referens för säker utökning av kontrollplan och storefront med samarbete mellan människor och AI-agenter.
Målgrupp: Utvecklare och AI-agent operators
Bridge-plugin: WordPress-utökning som hanterar onboarding, heartbeats och capability-rapportering.
Kontrollplan: RAGBAZ.xyz-worker som lagrar snapshots/historik och serverar docs-, peer- och tenant-sidor.
Storefront: publik worker som konsumerar WordPress GraphQL med hardening och fallback-beteende.
/api/v1/home GET ger challenge. /api/v1/home POST registrerar sajt. /api/v1/home/heartbeat POST uppdaterar runtime-state.
Tenant-claim och slug-claim binder sajten till stabil publik identitet.
Landa ändringar i små slices, håll docs och coop-logg uppdaterade, undvik breda ogranskade refaktorer.
Vid nya UI-funktioner: definiera fallback-lägen och non-200-observability först.
GraphQL edge-cache: 60s + 120s stale (default via GRAPHQL_EDGE_CACHE_TTL_SECONDS och GRAPHQL_EDGE_CACHE_STALE_SECONDS).
Meny-cache: snapshot 5m, URI-existens 5m, sitemap 10m (MENU_SNAPSHOT_TTL_MS, MENU_URI_CHECK_TTL_MS, MENU_SITEMAP_TTL_MS).
Probe-cache: STOREFRONT_GRAPHQL_PROBE_TTL_MS har default 900000ms (15m). /shop ISR har default revalidate 300s.
Använd /api/admin/purge-cache och flush av WordPress object-cache efter uppdateringar av rutter/meny/schema.
Server-Timing inkluderar app_ms, wp_ms och menu_ms för dynamiska svar.
Använd dessa värden med web vitals och non-200-loggar för att skilja upstream-latens från app-path-latens.