Tooltips + Zoom Together¶
Three complex diagrams, each large enough that auto-detection enables pan/zoom, and each annotated with per-node hover tooltips. Drag to pan, scroll to zoom, and hover any labelled node to see its Markdown popup.
CI/CD pipeline¶
Lint & format
Runs ruff and ruff-format. A failure here blocks the push.
See the contributing guide.
Fast tests with -m "not e2e". See the testing docs.
Headless Chromium via Playwright.
Skipped if no browser is installed.
Promotes the artifact to production. Requires green smoke tests.
Reverts to the last stable release. Triggered by failed smoke tests or a monitoring anomaly.
Request lifecycle¶
The caller's token was verified. Identity is known but permissions are not yet checked.
Permission check passed. The request may now touch protected resources.
Served from the cache layer: no recomputation needed.
Cache miss: the result is computed fresh and then stored.
Service dependency graph¶
API Gateway
Single entry point. Routes every external request to a downstream service.
Read the routing rules.
Validates tokens against the session cache. Stateless otherwise.
Owns product metadata. Reads from the Product DB and the search index.
Computes final price including promotions.
Hot path: heavily cached.
Applies active campaigns and discount rules.
