# ysoseri1224/cet-6-training-camp architecture

> Architecture diagram of the GitHub repository ysoseri1224/cet-6-training-camp, 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/ysoseri1224/cet-6-training-camp
- Repository: https://github.com/ysoseri1224/cet-6-training-camp

## Overview

CET-6 训练营 is a browser-based English exam-preparation platform. Learners enter through the routed React interface and use separate modules for word-by-word translation, grammar analysis, writing practice, vocabulary lookup, spaced sentence review, and lessons. AI-backed exercises send prompts to configured language-model APIs; other capabilities use local vocabulary and sentence data, browser-side review scheduling, and lesson articles. The graph includes the documented workflow and major capabilities; some page internals were not sampled, so those links rely on README statements rather than inspected implementation.

Main entry points: [`src/App.jsx`](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/App.jsx) (App routes), [`src/pages/WordLookup.jsx`](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WordLookup.jsx) (Word lookup), [`src/utils/aiClient.js`](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/aiClient.js) (AI client), [`src/modules/grammar-highlighter/GrammarHighlighterApp.jsx`](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/GrammarHighlighterApp.jsx) (Grammar highlighter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app["App routes<br/>[App.jsx]"]
  node_layout["Page layout<br/>[Layout.jsx]"]
end

subgraph group_practice["Practice tools"]
  node_translation["Word translation"]
  node_writing["Writing studio<br/>[WritingStudio.jsx]"]
  node_transform["Sentence transform"]
  node_lookup["Word lookup<br/>[WordLookup.jsx]"]
end

subgraph group_grammar["Grammar analysis"]
  node_grammar_page["Grammar page"]
  node_grammar_app["Grammar highlighter"]
  node_grammar_engine["Grammar engine<br/>[grammarEngine.js]"]
  node_grammar_ai["AI grammar analysis<br/>[deepseekAnalyze.js]"]
  node_grammar_store["Grammar state<br/>[grammarStore.js]"]
  node_control["Analysis controls<br/>[ControlPanel.jsx]"]
end

subgraph group_learning["Review and lessons"]
  node_daily["Daily sentences<br/>[DailySentences.jsx]"]
  node_sentence_data["Sentence collection<br/>[cet6Sentences.json]"]
  node_review["Review scheduler<br/>[ebbinghaus.js]"]
  node_word_data[("CET-6 vocabulary<br/>[cet6Words.js]")]
  node_lessons["Lesson index<br/>[XuanXuan.jsx]"]
  node_lesson_detail["Lesson reader<br/>[EpisodeDetail.jsx]"]
  node_episode_loader["Episode loader<br/>[episodeLoader.js]"]
  node_episodes["Lesson articles"]
end

subgraph group_shared["Shared services"]
  node_stores["Module state<br/>[moduleStores.js]"]
  node_ai_client["AI client<br/>[aiClient.js]"]
end

node_learner(("Learner"))
node_deepseek{{"DeepSeek API"}}
node_openai{{"OpenAI API"}}
node_dictionary{{"Dictionary API"}}

node_learner -->|"opens"| node_app
node_app -->|"wraps pages"| node_layout
node_app -->|"routes to"| node_translation
node_app -->|"routes to"| node_grammar_page
node_app -->|"routes to"| node_writing
node_app -->|"routes to"| node_lookup
node_app -->|"routes to"| node_daily
node_app -->|"routes to"| node_lessons
node_app -->|"routes to"| node_lesson_detail
node_writing -->|"renders"| node_transform
node_translation -->|"requests analysis"| node_ai_client
node_writing -->|"requests writing help"| node_ai_client
node_transform -->|"requests transformation"| node_ai_client
node_lookup -->|"requests translation"| node_ai_client
node_lookup -->|"checks vocabulary"| node_word_data
node_lookup -->|"looks up definitions"| node_dictionary
node_grammar_page -->|"renders"| node_grammar_app
node_grammar_app -->|"analyzes locally"| node_grammar_engine
node_grammar_app -->|"requests analysis"| node_grammar_ai
node_grammar_app -->|"updates state"| node_grammar_store
node_grammar_app -->|"renders controls"| node_control
node_control -->|"reads settings"| node_grammar_store
node_daily -->|"reads sentences"| node_sentence_data
node_daily -->|"schedules review"| node_review
node_daily -->|"offers word lookup"| node_lookup
node_lessons -->|"loads articles"| node_episode_loader
node_lesson_detail -->|"loads article"| node_episode_loader
node_episode_loader -->|"reads articles"| node_episodes
node_translation -->|"uses state"| node_stores
node_writing -->|"uses state"| node_stores
node_lookup -->|"uses state"| node_stores
node_ai_client -->|"calls API"| node_deepseek
node_ai_client -.->|"fallback call"| node_openai

click node_app "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/App.jsx"
click node_layout "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/components/Layout.jsx"
click node_translation "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WordTranslation.jsx"
click node_writing "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WritingStudio.jsx"
click node_transform "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/sentence-transform/SentenceTransform.jsx"
click node_lookup "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WordLookup.jsx"
click node_grammar_page "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/GrammarHighlighter.jsx"
click node_grammar_app "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/GrammarHighlighterApp.jsx"
click node_grammar_engine "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/engine/grammarEngine.js"
click node_grammar_ai "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/engine/deepseekAnalyze.js"
click node_grammar_store "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/store/grammarStore.js"
click node_control "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/components/ControlPanel.jsx"
click node_daily "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/DailySentences.jsx"
click node_sentence_data "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/data/cet6Sentences.json"
click node_review "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/ebbinghaus.js"
click node_word_data "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/data/cet6Words.js"
click node_lessons "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/XuanXuan.jsx"
click node_lesson_detail "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/EpisodeDetail.jsx"
click node_episode_loader "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/episodeLoader.js"
click node_episodes "https://github.com/ysoseri1224/cet-6-training-camp/tree/main/src/data/episodes"
click node_stores "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/store/moduleStores.js"
click node_ai_client "https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/aiClient.js"

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_layout toneBlue
class node_translation,node_writing,node_transform,node_lookup toneAmber
class node_grammar_page,node_grammar_app,node_grammar_engine,node_grammar_ai,node_grammar_store,node_control,node_deepseek,node_openai,node_dictionary toneMint
class node_daily,node_sentence_data,node_review,node_word_data,node_lessons,node_lesson_detail,node_episode_loader,node_episodes toneRose
class node_stores,node_ai_client,node_learner toneIndigo
```

## Components

### App shell

- [App routes](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/App.jsx): `src/App.jsx`
- [Page layout](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/components/Layout.jsx): `src/components/Layout.jsx`

### Practice tools

- [Word translation](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WordTranslation.jsx): `src/pages/WordTranslation.jsx`
- [Writing studio](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WritingStudio.jsx): `src/pages/WritingStudio.jsx`
- [Sentence transform](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/sentence-transform/SentenceTransform.jsx): `src/modules/sentence-transform/SentenceTransform.jsx`
- [Word lookup](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/WordLookup.jsx): `src/pages/WordLookup.jsx`

### Grammar analysis

- [Grammar page](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/GrammarHighlighter.jsx): `src/pages/GrammarHighlighter.jsx`
- [Grammar highlighter](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/GrammarHighlighterApp.jsx): `src/modules/grammar-highlighter/GrammarHighlighterApp.jsx`
- [Grammar engine](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/engine/grammarEngine.js): `src/modules/grammar-highlighter/engine/grammarEngine.js`
- [AI grammar analysis](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/engine/deepseekAnalyze.js): `src/modules/grammar-highlighter/engine/deepseekAnalyze.js`
- [Grammar state](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/store/grammarStore.js): `src/modules/grammar-highlighter/store/grammarStore.js`
- [Analysis controls](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/modules/grammar-highlighter/components/ControlPanel.jsx): `src/modules/grammar-highlighter/components/ControlPanel.jsx`

### Review and lessons

- [Daily sentences](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/DailySentences.jsx): `src/pages/DailySentences.jsx`
- [Sentence collection](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/data/cet6Sentences.json): `src/data/cet6Sentences.json`
- [Review scheduler](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/ebbinghaus.js): `src/utils/ebbinghaus.js`
- [CET-6 vocabulary](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/data/cet6Words.js): `src/data/cet6Words.js`
- [Lesson index](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/XuanXuan.jsx): `src/pages/XuanXuan.jsx`
- [Lesson reader](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/pages/EpisodeDetail.jsx): `src/pages/EpisodeDetail.jsx`
- [Episode loader](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/episodeLoader.js): `src/utils/episodeLoader.js`
- [Lesson articles](https://github.com/ysoseri1224/cet-6-training-camp/tree/main/src/data/episodes): `src/data/episodes`

### Shared services

- [Module state](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/store/moduleStores.js): `src/store/moduleStores.js`
- [AI client](https://github.com/ysoseri1224/cet-6-training-camp/blob/main/src/utils/aiClient.js): `src/utils/aiClient.js`

### Other components

- **Learner**
- **DeepSeek API**
- **OpenAI API**
- **Dictionary API**

## Connections

- Learner → App routes: opens (evidence: `README.md`)
- App routes → Page layout: wraps pages (evidence: `src/App.jsx`)
- App routes → Word translation: routes to (evidence: `src/App.jsx`)
- App routes → Grammar page: routes to (evidence: `src/App.jsx`)
- App routes → Writing studio: routes to (evidence: `src/App.jsx`)
- App routes → Word lookup: routes to (evidence: `src/App.jsx`)
- App routes → Daily sentences: routes to (evidence: `src/App.jsx`)
- App routes → Lesson index: routes to (evidence: `src/App.jsx`)
- App routes → Lesson reader: routes to (evidence: `src/App.jsx`)
- Writing studio → Sentence transform: renders (evidence: `src/pages/WritingStudio.jsx`)
- Word translation → AI client: requests analysis (evidence: `src/pages/WordTranslation.jsx`)
- Writing studio → AI client: requests writing help (evidence: `src/pages/WritingStudio.jsx`)
- Sentence transform → AI client: requests transformation (evidence: `src/modules/sentence-transform/SentenceTransform.jsx`)
- Word lookup → AI client: requests translation (evidence: `src/pages/WordLookup.jsx`)
- Word lookup → CET-6 vocabulary: checks vocabulary (evidence: `src/pages/WordLookup.jsx`)
- Word lookup → Dictionary API: looks up definitions (evidence: `src/pages/WordLookup.jsx`)
- Grammar page → Grammar highlighter: renders (evidence: `src/pages/GrammarHighlighter.jsx`)
- Grammar highlighter → Grammar engine: analyzes locally (evidence: `src/modules/grammar-highlighter/GrammarHighlighterApp.jsx`)
- Grammar highlighter → AI grammar analysis: requests analysis (evidence: `src/modules/grammar-highlighter/GrammarHighlighterApp.jsx`)
- Grammar highlighter → Grammar state: updates state (evidence: `src/modules/grammar-highlighter/GrammarHighlighterApp.jsx`)
- Grammar highlighter → Analysis controls: renders controls (evidence: `src/modules/grammar-highlighter/GrammarHighlighterApp.jsx`)
- Analysis controls → Grammar state: reads settings (evidence: `src/modules/grammar-highlighter/components/ControlPanel.jsx`)
- Daily sentences → Sentence collection: reads sentences (evidence: `src/pages/DailySentences.jsx`)
- Daily sentences → Review scheduler: schedules review (evidence: `src/pages/DailySentences.jsx`)
- Daily sentences → Word lookup: offers word lookup (evidence: `src/pages/DailySentences.jsx`)
- Lesson index → Episode loader: loads articles (evidence: `src/pages/XuanXuan.jsx`)
- Lesson reader → Episode loader: loads article (evidence: `src/pages/EpisodeDetail.jsx`)
- Episode loader → Lesson articles: reads articles (evidence: `src/utils/episodeLoader.js`)
- Word translation → Module state: uses state (evidence: `src/pages/WordTranslation.jsx`)
- Writing studio → Module state: uses state (evidence: `src/pages/WritingStudio.jsx`)
- Word lookup → Module state: uses state (evidence: `src/pages/WordLookup.jsx`)
- AI client → DeepSeek API: calls API (evidence: `src/utils/aiClient.js`)
- AI client → OpenAI API: fallback call (evidence: `src/utils/aiClient.js`)
