Skip to main content

A handbook for software systems

Understand the systems behind software.

Complex systems. Clear thinking.

Learn how engineering systems work, where they fail, and how to make sound design decisions.

Client retry with key. Deduplication lock. Cached response.KEY VALIDATION · STATE LOCK · EXACTLY-ONCECLIENT REQPOST /chargeKey: ik_982RETRY (TIMEOUT)POST /chargeKey: ik_982DEDUP STOREik_982: LOCKEDTTL: 86400s · cachedEXECUTIONOrder #402Mutated OnceDuplicate Detected → Return Cached 200 OKSkips second mutation · prevents double billing1 mutation + N retries = exactly 1 state change
FIG. 01 — EXACTLY-ONCE MUTATION SEMANTICS
Less boilerplate. More understanding.
01 Learn the idea02 Follow the visual03 Know the limits
Personalized learning:Sign in with Firebase to earn points, level up, and sync progress across devices.

Find your starting point

Explore the handbook

★ Featured ConceptFeatured concept

Prevent silent data corruption when long GC pauses or network partitions expire leases before storage writes complete.

CONCEPT ARCHITECTURE FLOW
AcquireToken 34
GC PauseLease Lost
StorageReject Stale

Learn by doing

Choose a practical track