The Architecture Canontruth · evidence · projection
Diagram

Capdb Replication

diagram-capdb-replication · canon/diagrams/capdb-replication.mmd

%% CapDB — truth replicated without ever forking. Physical WAL streaming,
%% read-only replicas, generation fencing (no split-brain).
flowchart LR
    C["Clients"]
    P[("Primary<br/>authoritative truth")]
    RA[("Replica A<br/>read-only")]
    RB[("Replica B<br/>read-only")]
    F["Generation fencing:<br/>reject segments whose<br/>generation < local<br/>(a deposed primary cannot resume)"]

    C -->|"writes"| P
    P -->|"WAL frames — physical, byte-for-byte"| RA
    P -->|"WAL frames — physical, byte-for-byte"| RB
    RA -->|"reads"| C
    RB -->|"reads"| C
    RA -. enforces .-> F
    RB -. enforces .-> F

Incoming References

Case Study 1
Projection 3