RAGBAZ
Ctrl+Alt+T Ctrl+Alt+F
Context Dokumentation
Språk ensves
Alla guider /docs

Teknisk Manual

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

Tillbaka till docs

Centrala arkitekturtermer

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.

Viktiga endpoints och flöden

/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.

Säkert arbetsflöde för utökning

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.

Cache-matris och refresh-regler

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.

Observability i svarshuvuden

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.

Mermaid-diagram
sequenceDiagram participant WP as WordPress + Bridge participant CP as RAGBAZ.xyz kontrollplan participant SF as Storefront worker WP->>CP: GET /api/v1/home (challenge) WP->>CP: POST /api/v1/home (registrera signerad payload) WP->>CP: POST /api/v1/home/heartbeat SF->>CP: Läs tenant-metadata / diagnostik CP-->>SF: Kontrollplanskontext

Läs vidare