Research / architecture

Current research

CA-A1 — external integration contracts

Type: architecture Updated: 2026-10-05 Scale: cross-jurisdictional Path: ../architecture/EXTERNAL-INTEGRATIONS.md

architectureintegrationseams

Sources: SRC-0144SRC-0145SRC-0146SRC-0147SRC-0148SRC-0149SRC-0150SRC-0152

External integration contracts

CA-A1 architecture record. Updated: 2026-10-05. Conceptual seams only — no adapters are designed or coded here. Each seam is a CA-CONTRACT-* defined against capabilities, not vendors.

Contract IDs

ContractSeamCandidate implementationsStatus
CA-CONTRACT-SEL-001Selection engine executionsortition-algorithms (adapt), OpenDLP (integrate), Panelot (service, unresolved)defined (SELECTION-ENGINE-ADAPTER.md)
CA-CONTRACT-PART-001Mass public participationDecidim, CONSULdefined below
CA-CONTRACT-DELIB-001Async member deliberationLoomiodefined below
CA-CONTRACT-INPUT-001Mass open-ended inputPolisdefined below
CA-CONTRACT-CAPTURE-001Transcription/synthesis of sessionsDembrane Echo (licence-conditional)defined below
CA-CONTRACT-ID-001Identity / verificationexternal IdP / census servicessketch only
CA-CONTRACT-OFF-001Offline/manual fallbackinstitutional processdefined below

CA-CONTRACT-PART-001 — participation platform seam

CA-CONTRACT-DELIB-001 — async deliberation seam

CA-CONTRACT-INPUT-001 — mass input seam

CA-CONTRACT-CAPTURE-001 — capture/synthesis seam

CA-CONTRACT-ID-001 — identity seam (sketch)

CA-CONTRACT-OFF-001 — offline/manual seam

Common seam rules

  1. All seams produce canonical events; external systems are channels and tools, not the record.
  2. Every seam citation carries digest + fetch timestamp.
  3. Seam failure degrades to the offline/manual path — the institution must remain operable.
  4. Seams are removable — an institution using zero external systems exercises only OFF-001.

Sources