← CatZep/Engineering Guides/System Design
Open-ended, senior-level system design problems.
Learn the reason behind each component
14 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.
14 guides
Forecast unconstrained demand and purchase enough surviving capacity before lead time runs out.
Forecast percentiles and headroom · Failure domains and redundant capacity · SLIs, SLOs, and error budgets · Cardinality · Backpressure and load sheddingUnderstand the state and protocol rules that let crash-recovering nodes preserve one committed history.
Raft terms and commit rules · Quorum · Write-ahead log and fsync · Linearizability · CAP and consistency models · Fencing tokensConnect distributed operations through propagated identities and interpret incomplete, sampled traces honestly.
Spans and trace context · Head and tail sampling · Transactional outbox · Cardinality · SLIs, SLOs, and error budgetsBuild a searchable retained log with explicit visibility, durability, query completeness, and authorization boundaries.
Inverted indexes and columnar storage · Partition pruning and predicate pushdown · Write-ahead log and fsync · Offsets and checkpoints · CardinalityExtract stable metrics from events and alert on user-relevant budget consumption without hiding missing data.
Event time and watermarks · Rollups and weighted aggregation · Cardinality · Burn-rate alerting · SLIs, SLOs, and error budgets · Offsets and checkpointsRecover from a lost or isolated region without promoting a stale or unauthorized writer.
RPO and RTO · Failure domains and redundant capacity · Quorum · Fencing tokens · Replication · CAP and consistency modelsUnify metrics, logs, and traces through shared context while budgeting storage, coverage, and query isolation.
Spans and trace context · Head and tail sampling · Cardinality · Inverted indexes and columnar storage · Rollups and weighted aggregation · Backpressure and load shedding · SLIs, SLOs, and error budgetsPreserve acknowledged critical commits under network partitions while separating ordering, durability, and availability.
CAP and consistency models · Quorum · Raft terms and commit rules · Write-ahead log and fsync · Linearizability · Failure domains and redundant capacity · Fencing tokensReduce analytical bytes scanned and publish reproducible dataset versions despite task retries and late data.
Partition pruning and predicate pushdown · Inverted indexes and columnar storage · Offsets and checkpoints · Event time and watermarks · DAG scheduling · Transactional outboxDefine reliability through user-visible outcomes, independent capacity, and bounded request-path behavior.
SLIs, SLOs, and error budgets · Burn-rate alerting · Failure domains and redundant capacity · Backpressure and load shedding · Idempotency keys · Wall and monotonic clocksScale the measured bottleneck while preserving data and failure semantics as traffic grows.
Cache-aside and invalidation · Consistent hashing · Replication · Backpressure and load shedding · Failure domains and redundant capacity · Transactional outboxAccept heterogeneous signals into bounded durable pipelines with clear per-signal delivery and privacy policies.
Offsets and checkpoints · Backpressure and load shedding · Pub/sub and durable queues · Cardinality · Transactional outbox · Spans and trace contextMake distributed logic reproducible in fast tests while recognizing what mocks and toy stores cannot prove.
Dependency injection and test doubles · Optimistic concurrency and compare-and-set · Wall and monotonic clocks · Canaries, shadow traffic, and rollout gates · SLIs, SLOs, and error budgets · Idempotency keysChange code and data in compatible stages while preserving a real rollback horizon and measuring user impact.
Expand-contract migrations · Canaries, shadow traffic, and rollout gates · Optimistic concurrency and compare-and-set · Transactional outbox · SLIs, SLOs, and error budgets · Failure domains and redundant capacityNo 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