Skip to main content

Reference architecture pack

C4-modelled architectures for the two or three shapes RAPID products actually take. A product maps onto one before build starts, so agents build within a known structure with the UK-insurance non-negotiables already in place.

The non-negotiables (every shape)​

  • Audit trail — complete, immutable, retention matched to client audit expectations.
  • PII handling — classification, encryption, access control, residency (see data-model governance).
  • Retention & erasure — per UK GDPR and client contract.
  • Observability — golden signals and SLOs from day one.
  • Tenant isolation — where multi-tenant.

The shapes​

1 · Multi-tenant insurance SaaS​

The default for client-facing products. Tenant isolation, RBAC, per-tenant data residency, audit trail on every state change. Reference C4 container diagram + named default components from the radar.

2 · API / integration service​

For services that connect systems (ACORD, broker feeds, third-party data). Contract-first, idempotent, versioned; contract testing against consumers.

3 · Data pipeline​

For ingestion, enrichment, reporting. Lineage, data-quality gates, PII classification carried through every stage.

Rules​

  • Pick a shape at Tech selection, recorded in the ADR.
  • Each shape's C4 diagrams and default component list live with the shape (v1 defines the shapes and non-negotiables; the detailed C4 models are filled as StudyBuddy and CXsmart instantiate them).

Standards referenced: C4, arc42.