# rithvin-us/team-asterix-system-design-notes architecture

> Architecture diagram of the GitHub repository rithvin-us/team-asterix-system-design-notes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rithvin-us/team-asterix-system-design-notes
- Repository: https://github.com/rithvin-us/team-asterix-system-design-notes

## Overview

This repository is a learning notebook for system design, not a running software service. Its principal workflow takes a learner from the five-step design method and diagram conventions through an AI-guided design prompt and review. Reference concepts, worked examples, case studies, exercises, projects, workshop materials, and a clearly non-canonical source inbox support that workflow. Relationships shown here come from the README; the underlying materials were not sampled.

Main entry points: [`01-method/1-decompose.md`](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/1-decompose.md) (Decompose), [`01-method/2-interfaces.md`](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/2-interfaces.md) (Interfaces), [`01-method/3-flows.md`](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/3-flows.md) (Flows), [`01-method/4-constraints.md`](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/4-constraints.md) (Constraints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_method["Design Method"]
  node_decompose["Decompose<br/>[1-decompose.md]"]
  node_interfaces["Interfaces<br/>[2-interfaces.md]"]
  node_flows["Flows<br/>[3-flows.md]"]
  node_constraints["Constraints<br/>[4-constraints.md]"]
  node_tradeoffs["Trade-offs<br/>[5-tradeoffs.md]"]
end

subgraph group_learning["Learning Resources"]
  node_examples["Worked Examples<br/>[README.md]"]
  node_case_studies["Case Studies<br/>[README.md]"]
end

subgraph group_practice["Practice and Workshop"]
  node_exercises["Exercises<br/>[README.md]"]
  node_projects["Projects<br/>[README.md]"]
  node_workshop["Workshop Sessions<br/>[README.md]"]
  node_design_prompt["Design Prompt"]
  node_review_prompt["Review Prompt"]
end

subgraph group_reference["Reference Material"]
  node_concepts["Concepts and Glossary<br/>[README.md]"]
  node_conventions["Diagram Conventions"]
  node_source_inbox["Source Inbox<br/>[README.md]"]
  node_conventions_repo["Repository Conventions<br/>[CONVENTIONS.md]"]
end

node_learner(("Learner"))

node_learner -->|"starts with"| node_decompose
node_decompose -->|"then defines"| node_interfaces
node_interfaces -->|"then traces"| node_flows
node_flows -->|"then checks"| node_constraints
node_constraints -->|"then weighs"| node_tradeoffs
node_tradeoffs -.->|"revisits"| node_decompose
node_learner -->|"learns diagrams"| node_conventions
node_learner -->|"uses prompt"| node_design_prompt
node_design_prompt -->|"reviews design"| node_review_prompt
node_learner -->|"looks up concepts"| node_concepts
node_learner -->|"studies examples"| node_examples
node_learner -->|"studies systems"| node_case_studies
node_learner -->|"practises"| node_exercises
node_learner -->|"builds projects"| node_projects
node_learner -->|"follows sessions"| node_workshop
node_learner -->|"asks source questions"| node_source_inbox
node_learner -->|"checks organization"| node_conventions_repo

click node_decompose "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/1-decompose.md"
click node_interfaces "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/2-interfaces.md"
click node_flows "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/3-flows.md"
click node_constraints "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/4-constraints.md"
click node_tradeoffs "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/5-tradeoffs.md"
click node_concepts "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/02-concepts/README.md"
click node_conventions "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/02-concepts/block-diagramming-conventions.md"
click node_examples "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/03-examples/README.md"
click node_case_studies "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/04-case-studies/README.md"
click node_exercises "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/05-exercises/README.md"
click node_projects "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/06-projects/README.md"
click node_workshop "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/07-workshop/README.md"
click node_design_prompt "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/07-workshop/ai-prompts/design-something-new.md"
click node_review_prompt "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/07-workshop/ai-prompts/review-my-design.md"
click node_source_inbox "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/99-inbox/notebooklm-raw/README.md"
click node_conventions_repo "https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/CONVENTIONS.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_decompose,node_interfaces,node_flows,node_constraints,node_tradeoffs toneBlue
class node_examples,node_case_studies toneAmber
class node_exercises,node_projects,node_workshop,node_design_prompt,node_review_prompt toneMint
class node_concepts,node_conventions,node_source_inbox,node_conventions_repo toneRose
class node_learner toneIndigo
```

## Components

### Design Method

- [Decompose](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/1-decompose.md): `01-method/1-decompose.md`
- [Interfaces](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/2-interfaces.md): `01-method/2-interfaces.md`
- [Flows](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/3-flows.md): `01-method/3-flows.md`
- [Constraints](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/4-constraints.md): `01-method/4-constraints.md`
- [Trade-offs](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/01-method/5-tradeoffs.md): `01-method/5-tradeoffs.md`

### Learning Resources

- [Worked Examples](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/03-examples/README.md): `03-examples/README.md`
- [Case Studies](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/04-case-studies/README.md): `04-case-studies/README.md`

### Practice and Workshop

- [Exercises](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/05-exercises/README.md): `05-exercises/README.md`
- [Projects](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/06-projects/README.md): `06-projects/README.md`
- [Workshop Sessions](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/07-workshop/README.md): `07-workshop/README.md`
- [Design Prompt](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/07-workshop/ai-prompts/design-something-new.md): `07-workshop/ai-prompts/design-something-new.md`
- [Review Prompt](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/07-workshop/ai-prompts/review-my-design.md): `07-workshop/ai-prompts/review-my-design.md`

### Reference Material

- [Concepts and Glossary](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/02-concepts/README.md): `02-concepts/README.md`
- [Diagram Conventions](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/02-concepts/block-diagramming-conventions.md): `02-concepts/block-diagramming-conventions.md`
- [Source Inbox](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/99-inbox/notebooklm-raw/README.md): `99-inbox/notebooklm-raw/README.md`
- [Repository Conventions](https://github.com/rithvin-us/team-asterix-system-design-notes/blob/main/CONVENTIONS.md): `CONVENTIONS.md`

### Other components

- **Learner**

## Connections

- Learner → Decompose: starts with (evidence: `README.md`)
- Decompose → Interfaces: then defines (evidence: `README.md`)
- Interfaces → Flows: then traces (evidence: `README.md`)
- Flows → Constraints: then checks (evidence: `README.md`)
- Constraints → Trade-offs: then weighs (evidence: `README.md`)
- Trade-offs → Decompose: revisits (evidence: `README.md`)
- Learner → Diagram Conventions: learns diagrams (evidence: `README.md`)
- Learner → Design Prompt: uses prompt (evidence: `README.md`)
- Design Prompt → Review Prompt: reviews design (evidence: `README.md`)
- Learner → Concepts and Glossary: looks up concepts (evidence: `README.md`)
- Learner → Worked Examples: studies examples (evidence: `README.md`)
- Learner → Case Studies: studies systems (evidence: `README.md`)
- Learner → Exercises: practises (evidence: `README.md`)
- Learner → Projects: builds projects (evidence: `README.md`)
- Learner → Workshop Sessions: follows sessions (evidence: `README.md`)
- Learner → Source Inbox: asks source questions (evidence: `README.md`)
- Learner → Repository Conventions: checks organization (evidence: `README.md`)
