# vuongdiensharing-performance/ielts-marketing architecture

> Architecture diagram of the GitHub repository vuongdiensharing-performance/ielts-marketing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vuongdiensharing-performance/ielts-marketing
- Repository: https://github.com/vuongdiensharing-performance/ielts-marketing

## Overview

Marketing English Lab is a React learning workspace for Vietnamese marketing professionals, with a separate Family Life practice track. The main learner journey moves from roadmap or skill selection into contextual lessons and practice, then review and progress tracking. Vocabulary and structure labs provide complementary practice. The graph follows documented capabilities and visible imports; several data and UI modules are indexed but not fully excerpted, so their internal connections are omitted where evidence is limited.

Main entry points: [`src/App.tsx`](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/App.tsx) (App shell), [`src/components/VocabularyView.tsx`](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/VocabularyView.tsx) (Vocabulary library), [`src/components/StructurePage.tsx`](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/StructurePage.tsx) (Structure practice), [`src/data/structureReviewData.ts`](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/structureReviewData.ts) (Structure review content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Workspace"]
  node_app["App shell<br/>[App.tsx]"]
  node_navigation["Sidebar navigation<br/>[Sidebar.tsx]"]
  node_dashboard["Dashboard<br/>[DashboardView.tsx]"]
end

subgraph group_learning["Lessons &amp; Skills"]
  node_roadmap["Learning roadmap<br/>[RoadmapView.tsx]"]
  node_skills["Skill labs<br/>[SkillsView.tsx]"]
  node_lesson["Lesson workspace"]
  node_module["Module detail"]
  node_mapchange["Map change lab"]
  node_recorder["Speaking recorder"]
end

subgraph group_language["Language Practice"]
  node_vocabulary["Vocabulary library<br/>[VocabularyView.tsx]"]
  node_vocabdrawer["Vocabulary detail"]
  node_structure["Structure practice<br/>[StructurePage.tsx]"]
  node_wordfamily["Word family lab<br/>[WordFamilyLab.tsx]"]
  node_formula["Sentence formula lab"]
  node_conversation["Conversation builder"]
  node_speech["Speech controls<br/>[useSpeech.ts]"]
end

subgraph group_progress["Progress &amp; Review"]
  node_review["Review<br/>[ReviewView.tsx]"]
  node_structure_review["Structure review panel"]
  node_analytics["Learning analytics<br/>[AnalyticsView.tsx]"]
  node_srs["Spaced repetition<br/>[srs.ts]"]
  node_badges["Badge awards<br/>[badges.ts]"]
end

subgraph group_content["Learning Content"]
  node_seed["Lesson seed content<br/>[seedData.ts]"]
  node_family_vocab["Family vocabulary<br/>[familyLifePack1.ts]"]
  node_marketing_vocab["Marketing vocabulary"]
  node_marketing_vocab_d["Marketing vocabulary pack<br/>[marketingPack1D.ts]"]
  node_family_seed_vocab["Family seed vocabulary<br/>[seedFamilyVocab.ts]"]
  node_map_data["Map change content<br/>[mapChangeData.ts]"]
  node_formula_data["Sentence formula content"]
  node_structure_data["Structure content<br/>[structureData.ts]"]
  node_wordfamily_data["Word family content<br/>[wordFamilyData.ts]"]
  node_conversation_data["Conversation content"]
  node_review_data["Structure review content"]
end

node_learner(("Learner"))
node_browser_storage[("Browser local storage")]

node_learner -->|"uses"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_roadmap
node_app -->|"routes to"| node_skills
node_app -->|"routes to"| node_vocabulary
node_app -->|"routes to"| node_structure
node_app -->|"routes to"| node_review
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_module
node_app -->|"routes to"| node_lesson
node_app -->|"persists progress"| node_browser_storage
node_app -->|"checks awards"| node_badges
node_skills -->|"opens lab"| node_mapchange
node_lesson -->|"uses lesson content"| node_seed
node_lesson -->|"renders"| node_recorder
node_lesson -.->|"saves progress"| node_browser_storage
node_vocabulary -->|"loads entries"| node_marketing_vocab
node_vocabulary -->|"loads entries"| node_family_vocab
node_vocabulary -->|"loads entries"| node_marketing_vocab_d
node_vocabulary -->|"opens details"| node_vocabdrawer
node_vocabulary -->|"uses speech"| node_speech
node_structure -->|"renders"| node_wordfamily
node_structure -->|"renders"| node_formula
node_structure -->|"renders"| node_conversation
node_structure -->|"uses content"| node_structure_data
node_wordfamily -->|"uses content"| node_wordfamily_data
node_formula -->|"uses content"| node_formula_data
node_structure -->|"uses speech"| node_speech
node_review -->|"calculates review"| node_srs
node_review -->|"renders panel"| node_structure_review
node_structure_review -->|"generates cards"| node_review_data
node_review_data -->|"reads structures"| node_structure_data
node_review_data -->|"reads families"| node_wordfamily_data
node_review_data -->|"reads formulas"| node_formula_data
node_review_data -->|"reads scenarios"| node_conversation_data
node_dashboard -.->|"reads progress"| node_browser_storage
node_analytics -->|"reads lesson data"| node_seed
node_seed -->|"includes vocabulary"| node_family_seed_vocab
node_mapchange -->|"uses content"| node_map_data
node_recorder -.->|"stores audio"| node_browser_storage

click node_app "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/App.tsx"
click node_navigation "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/Sidebar.tsx"
click node_dashboard "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/DashboardView.tsx"
click node_roadmap "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/RoadmapView.tsx"
click node_skills "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/SkillsView.tsx"
click node_lesson "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/LessonWorkspaceView.tsx"
click node_module "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/ModuleDetailView.tsx"
click node_mapchange "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/MapChangeLabView.tsx"
click node_vocabulary "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/VocabularyView.tsx"
click node_vocabdrawer "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/VocabularyDetailDrawer.tsx"
click node_structure "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/StructurePage.tsx"
click node_wordfamily "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/WordFamilyLab.tsx"
click node_formula "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/SentenceFormulaLab.tsx"
click node_conversation "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/ConversationBuilderLab.tsx"
click node_speech "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/hooks/useSpeech.ts"
click node_recorder "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/SpeakingRecorder.tsx"
click node_review "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/ReviewView.tsx"
click node_structure_review "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/StructureReviewPanel.tsx"
click node_analytics "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/AnalyticsView.tsx"
click node_srs "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/utils/srs.ts"
click node_badges "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/utils/badges.ts"
click node_seed "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/seedData.ts"
click node_family_vocab "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/familyLifePack1.ts"
click node_marketing_vocab "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/vocabularyPack1C.ts"
click node_marketing_vocab_d "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/marketingPack1D.ts"
click node_family_seed_vocab "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/seedFamilyVocab.ts"
click node_map_data "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/mapChangeData.ts"
click node_formula_data "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/sentenceFormulaData.ts"
click node_structure_data "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/structureData.ts"
click node_wordfamily_data "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/wordFamilyData.ts"
click node_conversation_data "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/conversationBuilderData.ts"
click node_review_data "https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/structureReviewData.ts"

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_app,node_navigation,node_dashboard toneBlue
class node_roadmap,node_skills,node_lesson,node_module,node_mapchange,node_recorder,node_browser_storage toneAmber
class node_vocabulary,node_vocabdrawer,node_structure,node_wordfamily,node_formula,node_conversation,node_speech toneMint
class node_review,node_structure_review,node_analytics,node_srs,node_badges toneRose
class node_seed,node_family_vocab,node_marketing_vocab,node_marketing_vocab_d,node_family_seed_vocab,node_map_data,node_formula_data,node_structure_data,node_wordfamily_data,node_conversation_data,node_review_data,node_learner toneIndigo
```

## Components

### Workspace

- [App shell](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/App.tsx): `src/App.tsx`
- [Sidebar navigation](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Dashboard](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/DashboardView.tsx): `src/components/DashboardView.tsx`

### Lessons & Skills

- [Learning roadmap](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/RoadmapView.tsx): `src/components/RoadmapView.tsx`
- [Skill labs](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/SkillsView.tsx): `src/components/SkillsView.tsx`
- [Lesson workspace](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/LessonWorkspaceView.tsx): `src/components/LessonWorkspaceView.tsx`
- [Module detail](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/ModuleDetailView.tsx): `src/components/ModuleDetailView.tsx`
- [Map change lab](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/MapChangeLabView.tsx): `src/components/MapChangeLabView.tsx`
- [Speaking recorder](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/SpeakingRecorder.tsx): `src/components/SpeakingRecorder.tsx`

### Language Practice

- [Vocabulary library](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/VocabularyView.tsx): `src/components/VocabularyView.tsx`
- [Vocabulary detail](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/VocabularyDetailDrawer.tsx): `src/components/VocabularyDetailDrawer.tsx`
- [Structure practice](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/StructurePage.tsx): `src/components/StructurePage.tsx`
- [Word family lab](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/WordFamilyLab.tsx): `src/components/WordFamilyLab.tsx`
- [Sentence formula lab](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/SentenceFormulaLab.tsx): `src/components/SentenceFormulaLab.tsx`
- [Conversation builder](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/ConversationBuilderLab.tsx): `src/components/ConversationBuilderLab.tsx`
- [Speech controls](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/hooks/useSpeech.ts): `src/hooks/useSpeech.ts`

### Progress & Review

- [Review](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/ReviewView.tsx): `src/components/ReviewView.tsx`
- [Structure review panel](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/StructureReviewPanel.tsx): `src/components/StructureReviewPanel.tsx`
- [Learning analytics](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/components/AnalyticsView.tsx): `src/components/AnalyticsView.tsx`
- [Spaced repetition](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/utils/srs.ts): `src/utils/srs.ts`
- [Badge awards](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/utils/badges.ts): `src/utils/badges.ts`

### Learning Content

- [Lesson seed content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/seedData.ts): `src/data/seedData.ts`
- [Family vocabulary](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/familyLifePack1.ts): `src/data/familyLifePack1.ts`
- [Marketing vocabulary](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/vocabularyPack1C.ts): `src/data/vocabularyPack1C.ts`
- [Marketing vocabulary pack](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/marketingPack1D.ts): `src/data/marketingPack1D.ts`
- [Family seed vocabulary](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/seedFamilyVocab.ts): `src/data/seedFamilyVocab.ts`
- [Map change content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/mapChangeData.ts): `src/data/mapChangeData.ts`
- [Sentence formula content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/sentenceFormulaData.ts): `src/data/sentenceFormulaData.ts`
- [Structure content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/structureData.ts): `src/data/structureData.ts`
- [Word family content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/wordFamilyData.ts): `src/data/wordFamilyData.ts`
- [Conversation content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/conversationBuilderData.ts): `src/data/conversationBuilderData.ts`
- [Structure review content](https://github.com/vuongdiensharing-performance/ielts-marketing/blob/main/src/data/structureReviewData.ts): `src/data/structureReviewData.ts`

### Other components

- **Learner**
- **Browser local storage**

## Connections

- Learner → App shell: uses (evidence: `README.md`)
- App shell → Sidebar navigation: renders (evidence: `src/App.tsx`)
- App shell → Dashboard: routes to (evidence: `src/App.tsx`)
- App shell → Learning roadmap: routes to (evidence: `src/App.tsx`)
- App shell → Skill labs: routes to (evidence: `src/App.tsx`)
- App shell → Vocabulary library: routes to (evidence: `src/App.tsx`)
- App shell → Structure practice: routes to (evidence: `src/App.tsx`)
- App shell → Review: routes to (evidence: `src/App.tsx`)
- App shell → Learning analytics: routes to (evidence: `src/App.tsx`)
- App shell → Module detail: routes to (evidence: `src/App.tsx`)
- App shell → Lesson workspace: routes to (evidence: `src/App.tsx`)
- App shell → Browser local storage: persists progress (evidence: `src/App.tsx`)
- App shell → Badge awards: checks awards (evidence: `src/App.tsx`)
- Skill labs → Map change lab: opens lab (evidence: `src/components/SkillsView.tsx`)
- Lesson workspace → Lesson seed content: uses lesson content (evidence: `src/components/LessonWorkspaceView.tsx`)
- Lesson workspace → Speaking recorder: renders (evidence: `src/components/LessonWorkspaceView.tsx`)
- Lesson workspace → Browser local storage: saves progress
- Vocabulary library → Marketing vocabulary: loads entries (evidence: `src/components/VocabularyView.tsx`)
- Vocabulary library → Family vocabulary: loads entries (evidence: `src/components/VocabularyView.tsx`)
- Vocabulary library → Marketing vocabulary pack: loads entries (evidence: `src/components/VocabularyView.tsx`)
- Vocabulary library → Vocabulary detail: opens details (evidence: `src/components/VocabularyView.tsx`)
- Vocabulary library → Speech controls: uses speech (evidence: `src/components/VocabularyView.tsx`)
- Structure practice → Word family lab: renders (evidence: `src/components/StructurePage.tsx`)
- Structure practice → Sentence formula lab: renders (evidence: `src/components/StructurePage.tsx`)
- Structure practice → Conversation builder: renders (evidence: `src/components/StructurePage.tsx`)
- Structure practice → Structure content: uses content (evidence: `src/components/StructurePage.tsx`)
- Word family lab → Word family content: uses content (evidence: `src/components/WordFamilyLab.tsx`)
- Sentence formula lab → Sentence formula content: uses content (evidence: `src/components/SentenceFormulaLab.tsx`)
- Structure practice → Speech controls: uses speech (evidence: `src/components/StructurePage.tsx`)
- Review → Spaced repetition: calculates review (evidence: `src/components/ReviewView.tsx`)
- Review → Structure review panel: renders panel (evidence: `src/components/ReviewView.tsx`)
- Structure review panel → Structure review content: generates cards (evidence: `src/components/StructureReviewPanel.tsx`)
- Structure review content → Structure content: reads structures (evidence: `src/data/structureReviewData.ts`)
- Structure review content → Word family content: reads families (evidence: `src/data/structureReviewData.ts`)
- Structure review content → Sentence formula content: reads formulas (evidence: `src/data/structureReviewData.ts`)
- Structure review content → Conversation content: reads scenarios (evidence: `src/data/structureReviewData.ts`)
- Dashboard → Browser local storage: reads progress
- Learning analytics → Lesson seed content: reads lesson data (evidence: `src/components/AnalyticsView.tsx`)
- Lesson seed content → Family seed vocabulary: includes vocabulary (evidence: `src/data/seedData.ts`)
- Map change lab → Map change content: uses content (evidence: `src/components/MapChangeLabView.tsx`)
- Speaking recorder → Browser local storage: stores audio
