← CatZep/Engineering Guides/System Design
Notifications, news feed, chat, and the social graph.
Learn the reason behind each component
5 independent guides. Each includes local concept explanations, a correctness contract, a worked failure trace, and a runnable Python learning model.
Read in this order: requirements → concepts → data flow → concurrency and failure behavior → sizing → worked example. Explain what can fail before choosing a technology.
5 guides
Deliver and synchronize messages across intermittent devices without confusing message identity with committed delivery order.
Sequence numbers and replay cursors · Idempotency keys · Fanout on write and read · Presence and failure detection · Transactional outbox · Pub/sub and durable queuesBroadcast a bounded live comment stream while keeping durable acceptance distinct from the subset shown to viewers.
Fanout on write and read · Pub/sub and durable queues · Sequence numbers and replay cursors · Presence and failure detection · Backpressure and load shedding · Token bucketChoose push, pull, or hybrid feeds from measured amplification, then serve stable pages with current privacy rules.
Fanout on write and read · Cache-aside and invalidation · Sequence numbers and replay cursors · Transactional outbox · Backpressure and load shedding · Top-k candidate discoveryAccept notification intent reliably and distinguish provider acceptance, device delivery, and a user's observation.
Transactional outbox · Idempotency keys · Sagas and compensation · Backpressure and load shedding · Leases · Pub/sub and durable queuesMaintain directed edges and reverse indexes without losing unfollow ordering or using stale edges for authorization.
Transactional outbox · Optimistic concurrency and compare-and-set · Replication · Fanout on write and read · Cache-aside and invalidation · CardinalityNo guide matches. Try a broader concept such as replication or retries.
Download the Python concept models · Python 3.10+, no packages required.
Student clarity and correctness review · 19 October 2026