Write Flow and Content Fabric

This companion visual expands the smaller inline diagrams in How It Works and Architecture. It makes two things explicit:

• the real single-cluster write path from HTTP ingress to Aeron quorum commit and replica apply
• the clusters-of-clusters model where each shard stays sovereign for writes and federated for reads

Open The Full Explainer

Open the full explainerView the complete interactive page with write flow, three-plane model, and code anchors.Jump to write flowGo directly to the consensus sequence, redirect short-circuit, and durability ladder.Jump to content fabricGo directly to the three-plane model and the cross-cluster read fabric.

Write Flow Plate

This view adds the boundary details that the smaller docs graph intentionally compresses:

• foreign-shard writes redirect before local queueing
• 202 Accepted and quorum commit are different states
• queue durability, Aeron ingress, and replica apply are separate steps

Distributed Content Fabric Plate

This view makes the current clusters-of-clusters model explicit:

• each Aeron cluster owns one authoritative writable repository
• remote clusters are mounted lazily and read-only outside quorum
• discovery and SSE hints are advisory control-plane tools, not consensus

Why This Companion Exists

• The inline FlowGraph plates are optimized for quick comprehension.
• The full explainer preserves the richer sequence and topology details without overloading the narrative pages.
• The screenshots here make the visual browsable inside the docs, while the HTML artifact stays available for deeper reading and sharing.

Source Artifacts

• HTML visual: public/diagrams/oak-chain-write-flow-and-content-fabric.html
• Write preview: public/diagrams/oak-chain-write-flow-plate.png
• Fabric preview: public/diagrams/oak-chain-content-fabric-plate.png