Interoperability seams
CA-R3 record. Updated: 2026-10-05. Concrete seams that could later support integration — descriptions only; no adapters are designed here.
| Technology | Interface | Auth | Data exchanged | Provenance implications | Maturity | Risks | CA-REQs |
|---|---|---|---|---|---|---|---|
| OpenDLP | CSV respondent/target import; selection report CSV (dev history) | operator accounts (flask-login/pyotp) | respondent rows, target categories, panel output | inputs/outputs are files — caller must bind them to spec + run record | documented CSVs; report CSV in dev docs | file interchange loses signatures; manual steps | 005–008, 011, 013 |
| OpenDLP | HTTP API | — | — | — | not evidenced (open question) | — | — |
| sortition-algorithms | Python API | in-process | feature matrix in; panel + quota report out | deterministic re-run = the provenance mechanism; caller packages seed+inputs+output | mature library | wrapper must construct the ceremony bundle | 010–014, 017 |
| Decidim | GraphQL API | OAuth/API tokens | components, proposals, results, meetings, accountability items | writes carry actor; provenance of external objects must be carried by caller | mature, documented | schema churn across versions; AGPL boundary if embedding | 035–039, 042, 050, 061–065 |
| Decidim | component import/export | admin | CSV/JSON per component | archives are self-describing-ish | mature | manual | 042, 063 |
| CONSUL | GraphQL API | admin/user tokens | verified users, polls, budgets, votes | census-verified identity is its provenance strength | documented | heavy identity model to carry | 038, 096, 071(offline) |
| CONSUL | offline ballot boxes / signature sheets | physical ops | paper tallies transcribed | strongest offline seam in corpus — paper→record path is designed | production-proven | transcription integrity is process not code | 071 |
| Loomio | REST-ish API + webhooks | API keys | groups, members, threads, polls, votes | poll results link to thread+time; good enough for member-session records | documented for client use | self-host API surface thinner than SaaS | 044, 045, 050–052 |
| Loomio | email reply-by-mail | SMTP | posts/votes via email | partial offline seam for members | production | header tampering is a real consideration | 071 |
| Polis | REST API + embed + export | API keys / anon | statements, agree/disagree/pass votes, clusters, reports | exports carry conversation id; bias label must travel with import | mature API; edge-branch discipline | no tagged releases → pin by SHA | 095, 096 |
| Dembrane Echo | report/export outputs | SaaS accounts | audio, transcripts, syntheses, reports | AI-synthesis provenance must be labelled at capture, not downstream | exports evidenced; API unverified | BSL licence; voice data sensitivity | 044, 084 |
| Stanford ODP | none documented | partnership | — | — | — | availability contingent | — |
| Manual/offline fallback | paper registers, witnessed draws, signed minutes | institutional | everything | Decidim die-roll+witnesses model (SRC-0083) is the corpus exemplar | proven | labour-heavy; error-prone | all |
Seam classes
- File interchanges (CSV) — ubiquitous, low-maturity but universal; provenance must be added by the calling process (hash inputs, pin to run record).
- HTTP APIs — Decidim/CONSUL/Polis GraphQL/REST are real integration surfaces; OpenDLP lacks one.
- Embeds — Polis widget is the cleanest “channel inside another surface” pattern.
- Offline seams — CONSUL ballot boxes + Loomio email + paper ceremonies: the only evidenced non-digital paths, all mass-input or member-comms side, none selection-side.
- Witness ceremony as a seam — SRC-0083’s public die-roll + witness attestation is a process seam no platform automates; it is the strongest argument for a Cicada-owned audit layer.