Skip to content

Redis POC — learn it in 9 steps

A Redis-backed Express service plus a React test UI, packaged as one local project that demos two-region deployment concepts. Read the path top to bottom — each page builds on the last and every concept has a diagram.

System overview

The learning path

# You'll learn Diagram
1 · The big picture what's stateless, what's stateful, why it matters system map
2 · Run it locally compose stack, ports, smoke-test curls container topology
3 · Follow a request browser → proxy → Express → Redis, error codes sequence
4 · Redis data & TTL key lifecycle, expiry traps, string-only values state diagram
5 · Health vs readiness liveness/readiness probes and the flag's limits probe flow
6 · Explore the API OpenAPI + Swagger UI hands-on —
7 · Frontend tour nginx proxy, 5s polling, one-image-per-region UI topology
8 · Two regions what "failover" does and doesn't give you cluster map
9 · Gotchas & limits every sharp edge in one table —

Quick commands

docker compose up --build                          # everything: UI :3000, API :8080, Redis :6379
uv run --no-project mkdocs serve -a 127.0.0.1:8000 # this site + Swagger UI

Reference

API guide · Swagger UI · Configuration · K8s deployment · Frontend architecture · Testing checklist · Frontend deployment · Maintaining docs

All articles live in docs/articles/. Diagram sources (.drawio, editable in draw.io Desktop) and their exported SVGs live together in docs/diagrams/; the OpenAPI spec and Swagger UI page are in docs/api/.