Patterns of Distributed Systems — Workshop Repository

A multi-day workshop exploring distributed systems patterns with hands-on implementations.

Quick Start

# Build all projects
./gradlew build

# Build specific section
./gradlew :day1:section03-wal:build

# Run tests
./gradlew test

For detailed build instructions, see:

• QUICK_START.md - Common commands and usage
• BUILD_STRUCTURE.md - Detailed project structure

Workshop Structure

Day 1

• section01-littles-law - Little's Law demonstrations
• section02-failures - Failure mathematics
• section03-wal - Write-Ahead Log implementation (Java)
• section04-quorums - Quorum-based consensus

Day 2

• (Coming soon)

See per-section READMEs for detailed instructions.

Note on LLM usage.

Boilerplate (Gradle/Maven config, CI workflows, PlantUML, selected test scaffolding) was drafted with an LLM. Core algorithms and invariants are handwritten and covered by tests. I use AI for scaffolding only, and verify the output to refactor it by hand when needed. LLMs are great at translating and summarising the code. I encourage the users of this repo to use LLMs that way and get the most out of this code.