Skip to main content

docs/architecture.md

Metadata​

Indexed Symbols​

No indexed functions/methods detected in this file.

Markdown Headings (if applicable)​

  • H1: Architecture Overview (line 1)
  • H2: Core principles (line 3)
  • H2: Runtime topology (line 15)
  • H2: UI operating model (GA) (line 31)
  • H2: Request flow (line 38)
  • H2: Event pipeline (line 47)
  • H2: Tenancy model (line 54)

Source Preview​

# Architecture Overview

## Core principles

- AgentField-first domain orchestration
- Workspace-per-client isolation
- Async-first workflows with machine-verifiable audit evidence
- GitOps promotion and immutable deployment manifests
- JWT-authenticated API access with role- and workspace-aware authorization
- Signed webhook callbacks with replay protection receipts
- Runtime configuration plane for platform/workspace controls via API + UI
- Durable outbox pipeline for telemetry-triggered automation
- No implicit workspace fallback in production paths

## Runtime topology

- `apps/web`: four-page IA only (`Console`, `Ops`, `Portal`, `Admin Settings`) with workspace-explicit URLs and in-page module tabs/queues/forms.
- `apps/gateway`: API gateway + orchestration edge
- AgentField control plane: reasoner and skill execution backend (self-hosted in production)
- Background workers: outbox dispatcher and job processor
- Data services: PostgreSQL, Redis, NATS, object storage, OpenSearch
- Configuration services: `platform_settings`, `workspace_settings`, encrypted `runtime_secrets`
- Edge plane: `anchor-edge-agent` deployments on managed endpoints
- Deployment control plane: app repo (`anchor-msp`) + ops repo (`anchor-msp-ops`)