Architecture
Overview

Architecture Overview

AICR Platform v3 is built on a capability-based architecture with an orthogonal governance spine.

Core Principles

  1. Separation of Concerns - Clear boundaries between platform layers
  2. Governance as Spine - Cross-cutting governance orthogonal to all surfaces
  3. Pack-based Delivery - Modular capabilities via the pack system
  4. Multi-tenant by Design - Tenant isolation at every layer

Platform Layers

┌─────────────────────────────────────────────────────────────┐
│                     SUMMIT (Products)                        │
│  Domain mastery, premium capabilities, white-label           │
├─────────────────────────────────────────────────────────────┤
│                      EDGE (Delivery)                         │
│  Pack-gated routes, tenant customization, feature flags      │
├─────────────────────────────────────────────────────────────┤
│                     STUDIO (Authoring)                       │
│  Pack development, manifest editing, testing                 │
├─────────────────────────────────────────────────────────────┤
│                   GOVERNANCE SPINE                           │
│  Policy engine, proposals, approvals, audit trail            │
├─────────────────────────────────────────────────────────────┤
│                    CORE SERVICES                             │
│  Auth, metering, events, AI router, RAG                      │
└─────────────────────────────────────────────────────────────┘

Key Subsystems

Governance Spine

The governance spine intercepts all significant actions and applies policy-based controls:

  • AI Interceptor - 7-step gating for AI model invocations
  • Proposal System - Formal approval workflows
  • Policy Engine - Deterministic policy evaluation
  • Spine Events - Immutable audit trail

Pack Registry

Capability delivery through a hierarchical pack system:

  • Stage axis: Foundry → Core → Growth → Scale
  • Scope axis: Presence / Domain / Enterprise / Presentation / Intelligence

Tenant Context

All operations are scoped to tenant via:

  • RealmKey - Immutable tenant identifier
  • TenantContext - AsyncLocalStorage-based context
  • Prisma middleware - Automatic tenant filtering

Related Documents