Technical flows (discovery)
This section holds Mermaid sources as .mmd files for the discovery phase. The site renders them on the linked pages below. You can still open the raw .mmd files in the repository, use Mermaid CLI, or paste into mermaid.live.
Levels (working definition)
| Level | Intent | Typical diagram types |
|---|---|---|
| 0 | System in its environment — actors and external systems | Context (e.g. C4 Context) |
| 1 | Major building blocks and responsibilities | Containers, high-level processes |
| 2 | Interactions and time order | Sequences, detailed processes, state |
Naming: use kebab-case.mmd and short prefixes such as l0-, l1-, l2- if you want sort order in file listings.
Diagram index
- Level 0 — system context
- Level 1 — platform containers
- Level 2 — onboarding sequence
- Level 2 — feed setup
- Level 2 — login and register
Cross-links to product docs
Next step (AWS)
When you are ready, add something like docs/architecture/ or docs/technical-flows/aws/ for EKS, Secrets Manager, Aurora PostgreSQL, and event-driven components, and reference those flows from level 1–2 diagrams.