System Design Overview
This section gives a spine for architecture and design reviews: questions to ask stakeholders, checklist-style patterns, and links into deeper guides elsewhere in the library (databases, networking, observability, CI/CD, security). It complements operations-focused pages rather than replacing them.
Use the condensed page first — design review checklist — when you want a single pass before a review or RFC.
Design Discussion Order
Section titled “Design Discussion Order”- Requirements and SLAs
- Capacity estimation
- Data modeling and storage
- API design (implementation depth: HTTP, payloads, layouts)
- Read scaling
- Write scaling
- Caching patterns
- Consistency and transactions
- Fault tolerance
- Observability for systems
- Security, deployment, and tradeoffs
Reference: Abbreviation glossary.
Topics in This Section
Section titled “Topics in This Section”| Topic | What It Covers |
|---|---|
| Design review checklist | One-page bullets and sequencing for fast review |
| Requirements and SLAs | Read/write mix, scale targets, SLAs, consistency and geography |
| Capacity estimation | QPS, storage, bandwidth, bottlenecks |
| Data modeling and storage | SQL vs NoSQL, normalization, indexes, sharding |
| API design | REST, gRPC, GraphQL, errors, pagination, idempotency; HTTP contracts and layouts for implementation |
| Read scaling | Cache, replicas, CDN, fan-out, materialized views |
| Write scaling | Queues, batching, async paths, pooling, sharding |
| Caching patterns | Aside, write-through, eviction, stampedes |
| Consistency and transactions | Strong vs eventual, sagas, CAP and PACELC |
| Fault tolerance | Retries, breakers, degradation, release safety |
| Observability for systems | Logs, metrics, traces, RED/USE, postmortems |
| Security, deployment, and tradeoffs | Trust boundaries, rollout patterns, documenting decisions |
| Glossary | Common abbreviations |
Related Sections
Section titled “Related Sections”| Need | Where to Go |
|---|---|
| Database operations and on-call | Databases |
| HTTP and edge behavior | Networking |
| Deep observability stack | Observability |
| Deployment and pipelines | CI/CD |
| Security and compliance | Security |
| Incidents and readiness | QA |
| Process and communication | Practices |