Skip to content

feat(system-design): document replication, sharding, and quorums - #43

Merged
shalshcode08 merged 4 commits into
mainfrom
codex/replication-partitioning-quorum-systems
Aug 6, 2026
Merged

shalshcode08 merged 4 commits into
mainfrom
codex/replication-partitioning-quorum-systems

Conversation

@shalshcode08

Copy link
Copy Markdown
Owner

Summary

  • add a standalone, language-neutral Topic 7 guide to replication, partitioning, sharding, and quorum systems
  • cover leader-follower, multi-leader, and leaderless designs; synchronous and asynchronous acknowledgement; failover; conflict handling; read repair; anti-entropy; and hinted handoff
  • explain strict and sloppy quorums, replica placement, range and hash partitioning, consistent hashing, virtual nodes, partition maps, fan-out, hotspots, tenant placement, and online resharding
  • compare sequence allocation, UUID variants, and Snowflake-style identifiers, including ordering leakage and clock risks
  • include a complete sharded order design with replica and network failure timelines, capacity estimates, operations, security, testing, exercises, interview answers, and a revision cheat sheet
  • register the new page in the System Design navigation without changing styles, shared design, tests, or TOPICS.md

Research

Primary official sources include PostgreSQL current replication and table-partitioning documentation, Apache Cassandra architecture and repair documentation, MongoDB sharding and balancer documentation, the Amazon Dynamo paper, RFC 9562, and Google Cloud Spanner schema-design guidance.

Validation

  • npx prettier --write manifest.json src/content/systemdesign/replication-partitioning-sharding-quorum-systems.html
  • npx html-validate src/content/systemdesign/replication-partitioning-sharding-quorum-systems.html
  • npm test - 22 of 22 passing
  • npm run build - 37 pages built successfully
  • git diff --check
  • exact footer verification
  • no em dash scan
  • scope verification: only manifest.json and the Topic 7 content page

Constraints preserved

  • one topic only
  • no CSS or shared design changes
  • no test changes
  • no TOPICS.md status change before merge
  • exact July 2026 documentation footer included

Review focus

Please focus on quorum caveats, online migration safety, failure-domain assumptions, identifier clock risks, and whether the order-system decisions remain explicit about workload trade-offs.

Co-authored-by: Codex <codex@openai.com>
@shalshcode08 shalshcode08 added documentation Improvements or additions to documentation codex codex-automation labels Aug 2, 2026
@shalshcode08
shalshcode08 marked this pull request as ready for review August 2, 2026 08:48
shalshcode08 and others added 3 commits August 2, 2026 14:23
Co-authored-by: Codex <codex@openai.com>
Co-authored-by: Codex <codex@openai.com>
@shalshcode08
shalshcode08 merged commit ae6201d into main Aug 6, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

codex codex-automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant