Skip to main content

Current State and Target State

This page is the status key for the architecture section. Architecture pages describe the intended complete platform, but a capability is operational only when this page marks it Implemented and cites implementation evidence.

Status date: 9 August 2026. The platform is pre-first-release; the GitOps repository describes desired environments, but no production environment currently serves users.

architecture_status · current evidence and target gates
The current pre-first-release platform has partially implemented edge, Control Plane, Data Plane, workload identity, and shared platform; Agentic Plane and Kubernetes deployment are in development. The target adds composite OpenFGA and OPA authorization, carried obligations, hardened all-plane operations, complete GitOps, and deferred federation.current · 9 aug 2026target · intended complete systemdelivery gatesEdge + Control Planecore APIs · OpenFGA · policy eventsPARTIALLY IMPLEMENTEDData PlaneNGSI-LD · OGC · files · subscriptionsPARTIALLY IMPLEMENTEDWorkload identity + gRPCfoundations adopted unevenlyIN DEVELOPMENTAgentic Planelocal flow · not in GitOpsIN DEVELOPMENTPre-first-releaseno production users servedComposite authorizationOpenFGA relationships + OPA contextPLANNEDCarried decisionsfilters · masks · quotas · auditPLANNEDAll-plane operational proofreconciliation · revocation · failure testsPLANNED / IN DEVELOPMENTProduction GitOpsroutes · secrets · SLOs · Agentic PlaneIN DEVELOPMENTFederated extensioncross-domain trust and conformanceDEFERRED
current / partialidentity & controltarget capabilityin development / planneddelivery state

Status vocabulary

StatusMeaning
ImplementedCode and its primary verification evidence exist. This does not by itself mean the capability is deployed.
Partially implementedA useful path exists, but a named correctness, coverage, resilience, or deployment gap remains.
In developmentActive implementation exists but has not reached its acceptance gate.
PlannedThe target behavior is approved or directed, but implementation has not started.
DeferredIntentionally outside the current delivery sequence.
Legacy onlyReserved status for material outside this documentation set; it is not used for the Go architecture.
SupersededReplaced by a newer decision and not valid guidance.

Platform status summary

CapabilityCurrent stateTarget stateStatus
External authenticationKeycloak OIDC/JWT validation at the gateway; required, optional, and public route modes existOperation-owned authentication declarations compiled from service OpenAPIPartially implemented
Workload identityAudience-bound Keycloak client-credential tokens, caller allowlists, subject-asserter controls, and GitOps configuration existRequired on every internal HTTP and gRPC call, with request binding and no alternate internal credential pathPartially implemented
Relationship authorizationdx-authz-go evaluates OpenFGA relationships through /v1/checkComposite Authorize decision over relationships, context, delegation, trust, and obligationsPartially implemented
Contextual authorizationClosed constraints are stored but not comprehensively evaluatedOPA evaluates contextual and attribute policy through the composite PDPPlanned
Decision obligationsIndividual services enforce local rules; no common decision artefact existsIntegrity-protected decision carries row filters, field rules, quota selection, expiry, and reason codes to enforcement pointsPlanned
Policy lifecyclePolicy records, outbox events, RabbitMQ projection, and OpenFGA consumer exist; model/projection alignment needs correctionNormalized, versioned grants with durable projection, reconciliation, tombstones, and policy revisionsPartially implemented
Internal transportShared gRPC server/client foundation and identity interceptors existAll Go service-to-service calls use gRPC; public surfaces remain HTTP/RESTIn development
Control PlaneCore services and primary APIs existComplete organization, catalogue, marketplace, policy, governance, and supporting-service workflowsPartially implemented
NGSI-LD Data PlaneLatest, entity, temporal, geo, aggregation, bulk, and CSV query paths existComplete ingestion/admin path plus carried authorization obligationsPartially implemented
OGC Data PlaneFeatures Parts 1–4, CQL2, CRS, Tiles, Coverages, Processes/jobs, and Records-lite existHardened authorization plus operational scaling; EDR, Maps, Routes, DGGS, Styles, and full STAC remain optional evolutionPartially implemented
File ExchangeMultipart upload, downloads, object storage, processing jobs, cleanup, and ownership scoping existStreaming aggregate downloads, full worker recovery, and carried obligationsPartially implemented
Agentic PlaneRegistry, runtime, MCP gateway, delegation, token exchange, kill switch, HITL, and local smoke flow existGitOps deployment, cross-replica leases, side-effect idempotency, provenance controls, sender-constrained tokens, and failure-injection proofPartially implemented
Shared Go platformBootstrap, configuration, HTTP, persistence, cache, events, health, and observability foundations are adopted across the core fleetTagged SDK, complete conformance gates, stable gRPC contracts, and measured operational SLOsPartially implemented
Central Kubernetes deploymentShared Helm chart, ApplicationSets, environment values, workload credentials, NetworkPolicy, and External Secrets patterns existEvery service routed, configuration boot-tested, metrics scraped correctly, and agents deployableIn development
Federated deploymentTrust, envelope, proxy, and certificate components exist behind configuration gatesReviewed cross-domain topology with dynamic trust, mutual TLS, federation contracts, and operational SLOsDeferred

Current and target invariants

  • Authentication and authorization are separate decisions. A valid identity is never an authorization grant.
  • Missing, invalid, expired, unknown, or unsupported authorization state denies by default.
  • A workload may assert an end-user identity only when the receiving service explicitly lists it as a subject asserter.
  • Organization and resource ownership predicates belong in datastore queries, not only in middleware.
  • A data plane enforces a decision and its obligations; it does not independently recreate policy state.
  • The model and LLM output are never authorization authorities in the Agentic Plane.

Evidence sources

Status is reconciled from the implementation roadmap, the active implementation handover, service repositories, and the decision records listed in Architecture Decisions.