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.
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/.