|Chicago, IL|Nov 15 – 20, 2026·
/docs/architecture

Atlas Architecture.

A governance and orchestration layer that controls how models access enterprise data — enforcing policy, minimizing exposure, and producing audit trails.

Deploymenton-prem / private cloud / air-gapped
AuthSAML / OIDC / LDAP
Observabilityaudit logs + metrics + traces
IntegrationsStarfish, vLLM, Qdrant, OPA
DrawingATLAS-ARCH-01
SheetSYSTEM OVERVIEW
Rev2026.10
Atlas
System layers

Six layers. One request path.

Clients never touch the runtime or the data directly. Every request descends through the control plane and the data plane, and every layer is observable.

L1Clients
Web UICLIAPIAgents
L2Atlas Control Plane
AuthN/AuthZPolicy EngineRequest RouterRate LimitsAdmin Config
L3Atlas Data Plane
Retrieval OrchestratorCompliance TaggingRedaction/TransformsPrompt Builder
L4AI Runtime Layer
EmbeddingsVector DBLLM Inference
L5Data Sources
Starfish zones/collectionsFilesystemsObject StoresDBs
L6Observability
Immutable audit log streamMetricsTraces
request flow ↓·audit events emitted from every layer
Request lifecycle

Nine steps. None optional.

Every request follows a deterministic path through Atlas. If any stage fails, the request is rejected with a structured error and an audit event is emitted.

step 1 of 9· deterministic · fail-closed

Policy model

Identity, classification, operation.

Three dimensions bind every decision. Policies are evaluated on every request — no caching of authorization decisions across requests.

policy.rego
allow {  input.user.role == "analyst"  input.collection.id == "collection-a"  input.operation in ["read", "retrieve", "summarize"]  not input.document.tags["PCI-high"]} allow {  input.user.role == "legal"  input.zone.id == "zone-b"  input.operation == "agent-summarize"} deny {  input.model.id == "gpt-4"  input.zone.classification == "classified-research"}
OPA-compatible · built-in engine for standard RBAC · optional OPA sidecar for complex Rego
Dimension 01Identity binding
Identity→Role→Permission

Principals map to roles via IdP claims; roles carry collection-level permissions. No implicit access.

Dimension 02Data classification
GDPRPCICUIPIIHIPAAITARInternalPublic

Classification tags set the ceiling for what a request may touch and which transforms apply.

Dimension 03Operation controls
readretrievesummarizeexporttool-useagent-invoke

Each operation is whitelisted per role and zone. Agents and tool calls are gated the same way as people.

Trust boundaries

Everything inside. Nothing out by default.

The whole system — control plane, data plane, vector store, inference, audit, secrets — runs inside the customer environment.

Inside customer environment
  • Atlas Control Plane + Data Plane
  • Vector DB (Qdrant)
  • Model Inference (vLLM / local)
  • Data Sources (Starfish, filesystems, DBs)
  • Audit Logs + Metrics Store
  • Policy Engine + Configuration
  • Secrets Store (Vault / K8s)
External
None by default.

External model APIs (OpenAI, Anthropic, etc.) are supported but require explicit configuration per-zone. External connections are logged and subject to policy evaluation. No data leaves the environment without an auditable decision chain.

No data egress by default. External connections require explicit configuration, policy approval, and produce audit events on every call. Air-gapped deployments have no external network path.

Audit schema

One immutable record per request.

Records are append-only, tamper-evident, and exportable to external SIEM systems. The schema below covers the core fields emitted per request.

fieldtypedescription
request_iduuidUnique identifier for the request
timestamptimestamptzServer-side wall clock, UTC
user_idtextAuthenticated user principal
tenant_idtextTenant isolation boundary
policy_decision_iduuidReference to evaluated policy decision
collection_idstext[]Collections accessed during retrieval
retrieved_doc_idstext[]SHA-256 hashes of retrieved documents
model_idtextModel identifier + version string
token_countintegerTotal tokens consumed (prompt + completion)
latency_msintegerEnd-to-end request latency
output_hashtextSHA-256 of complete model response
redaction_appliedbooleanWhether any redaction transform executed
redaction_typestext[]Classification tags that triggered redaction
audit_event schema · retention configurable per tenant · default 365 daysexportable as JSON-lines or CEF
Deployment topologies

From a laptop to an air gap.

The same binary, the same policy bundle, the same audit schema — at every scale.

Topology 01Single-node devAtlas + embedded DB + local model
  • SQLite for metadata, embedded Qdrant
  • Local GGUF model via llama.cpp
  • Self-signed TLS for local development
  • Single binary distribution
  • No external network dependencies
Topology 02HA productionAtlas replicas + external Postgres + Qdrant cluster + model pool
  • Minimum 3 Atlas replicas behind load balancer
  • Postgres with streaming replication
  • Qdrant cluster with sharding + replicas
  • vLLM model pool with health checks
  • TLS termination at ingress, mTLS internal
  • Secrets via Vault or K8s secrets
  • Rolling upgrade with canary validation
Topology 03Air-gappedOffline artifact distribution + local model hosting + no external connections
  • OCI-compliant artifact bundle for offline install
  • Local model weights, no download at runtime
  • Internal CA for certificate management
  • Upgrade via signed artifact transfer
  • Rollback to previous version within 60s
  • No DNS, NTP, or package manager calls
Operational notes
TLS

All internal and external traffic encrypted. mTLS between Atlas components. Configurable cipher suites.

Secrets

Vault integration or K8s secrets. No secrets in environment variables or config files. Rotation without restart.

Upgrades

Rolling upgrades with automatic rollback on health check failure. Schema migrations are forward-compatible.

DrawingATLAS-TOPO-01
Sheet03 TOPOLOGIES
Rev2026.10
Atlas
Failure modes

Closed on every failure path.

There is no degradation mode that silently bypasses policy or drops audit events.

ScenarioPolicy engine unavailableFail closed

All requests denied. No bypass. Alert fires to ops channel within 30s.

ScenarioVector DB degradedReduced retrieval + circuit breaker

Circuit breaker opens after configurable error threshold. Partial results returned with degraded flag. Automatic recovery probe.

ScenarioModel overloadQueue, backpressure, rate limiting

Request queued with TTL. Per-tenant rate limits enforced. 429 returned when queue depth exceeds threshold. Priority lanes for critical tenants.

ScenarioAudit sink unavailableBuffer + alerts, fail closed

Audit events buffered to local WAL. If buffer fills, requests are rejected. No silent audit gaps.

Additional safety controls
Retry with exponential backoffIdempotency keys on all writesRequest IDs propagated end-to-endDistributed tracing via OpenTelemetryHealth check endpoints per componentGraceful shutdown with drain period
Integration points

Six contracts. Four required.

Atlas integrates through stable, documented contracts — swap a component without rewriting the system around it.

Starfishrequired
Zone/collection metadata ingest + manifest sync

Starfish provides the data organization layer. Atlas reads zone definitions, collection metadata, and classification manifests. Sync is pull-based on configurable interval.

Vector DBrequired
Upsert / search / filter contract

OpenAPI-compatible vector operations. Primary support for Qdrant. Filter expressions enforce tenancy and classification at query time. Batch upsert for ingestion pipelines.

Inferencerequired
OpenAI-compatible API / vLLM endpoints

Chat completions and embeddings endpoints. vLLM for self-hosted models. Model registry tracks available models, versions, and capability tags.

Identity Providerrequired
OIDC / SAML mapping

Standard OIDC discovery or SAML metadata import. Group-to-role mapping configurable via admin API. Supports multi-IdP for federated environments.

SIEMoptional
Audit export via syslog, webhook, or file

Structured audit events exported in CEF or JSON. Supports syslog (TCP/TLS), webhook POST, or local file rotation. Configurable export filters.

Policy Engineoptional
OPA-compatible policy evaluation

Built-in policy engine for standard RBAC. Optional OPA sidecar for complex Rego policies. Policy bundles versionable and auditable.

Security through architecture: threat model and the five controls
Your environment

See Atlas in your environment.

We deploy Atlas on your infrastructure, with your identity provider, against your data sources. No SaaS dependency. No data egress.