# neonevins/25-js-note architecture

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

- Interactive diagram: https://gitdiagram.com/neonevins/25-js-note
- Repository: https://github.com/neonevins/25-js-note

## Overview

This repository is a Chinese-language JavaScript course organized as numbered lesson folders, progressing from language basics through browser APIs, asynchronous programming, and practical projects. Its substantial runnable application is a canvas Flappy Bird game in `48-实战`: the game loop delegates scene rendering, scenes assemble visual and interactive components, and components use shared configuration and utilities. The course lessons are represented as topic areas; their internal links are not inferred from folder order. Edges reflect sampled code or SOURCE INDEX references, so unsampled scene implementations are shown only where imports are documented.

Main entry points: [`48-实战/js/component/basic/Basic.js`](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/basic/Basic.js) (Component base), [`48-实战/config.js`](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/config.js) (Canvas config), [`48-实战/js/scene/Gaming.js`](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Gaming.js) (Gameplay scene), [`48-实战/js/component/Background.js`](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Background.js) (Background)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_curriculum["Course topics"]
  node_foundations["JS foundations"]
  node_types["Types and objects"]
  node_functions["Functions and scope"]
  node_arrays["Arrays and algorithms"]
  node_oop["Objects and classes"]
  node_async["Async programming"]
end

subgraph group_browser["Browser APIs"]
  node_dom["DOM and events"]
  node_canvas["Canvas graphics"]
  node_ajax["AJAX and JSONP"]
end

subgraph group_gameflow["Game flow"]
  node_game["Game loop<br/>[Game.js]"]
  node_config["Canvas config<br/>[config.js]"]
  node_scenecontrol["Scene controller<br/>[Scene.js]"]
  node_start["Start scene<br/>[Start.js]"]
  node_ready["Ready scene<br/>[Ready.js]"]
  node_gaming["Gameplay scene<br/>[Gaming.js]"]
  node_gameover["Game over scene<br/>[GameOver.js]"]
end

subgraph group_gameparts["Game components"]
  node_background["Background<br/>[Background.js]"]
  node_bird["Bird physics<br/>[Bird.js]"]
  node_land["Land<br/>[Land.js]"]
  node_pipe["Pipes<br/>[Pipe.js]"]
  node_score["Score display<br/>[Score.js]"]
  node_logo["Game logo<br/>[Logo.js]"]
  node_button["Play button<br/>[button.js]"]
  node_title_ready["Ready title<br/>[TitleReady.js]"]
  node_title_over["Game-over title<br/>[TitleOver.js]"]
  node_basic["Component base<br/>[Basic.js]"]
  node_tools["Game utilities<br/>[tools.js]"]
end

node_learner(("Learner"))

node_learner -.->|"studies"| node_foundations
node_game -->|"reads settings"| node_config
node_game -->|"creates and renders"| node_scenecontrol
node_scenecontrol -->|"selects scene"| node_start
node_scenecontrol -->|"selects scene"| node_ready
node_scenecontrol -->|"selects scene"| node_gaming
node_scenecontrol -->|"selects scene"| node_gameover
node_start -->|"renders"| node_background
node_start -->|"renders"| node_logo
node_start -->|"renders"| node_button
node_ready -->|"uses"| node_background
node_ready -->|"uses"| node_title_ready
node_gaming -->|"renders"| node_background
node_gaming -->|"checks collision"| node_bird
node_gaming -->|"renders"| node_land
node_gaming -->|"checks collision"| node_pipe
node_gaming -->|"updates display"| node_score
node_gameover -->|"uses"| node_background
node_gameover -->|"uses"| node_title_over
node_bird -->|"reads dimensions"| node_config
node_bird -->|"uses debounce"| node_tools
node_bird -->|"extends"| node_basic
node_background -->|"reads dimensions"| node_config
node_background -->|"extends"| node_basic
node_button -->|"registers clicks"| node_config
node_button -->|"checks hit"| node_tools
node_button -->|"extends"| node_basic
node_logo -->|"registers clicks"| node_config
node_logo -->|"checks hit"| node_tools
node_logo -->|"extends"| node_basic
node_score -->|"reads dimensions"| node_config
node_score -->|"extends"| node_basic
node_land -->|"extends"| node_basic
node_land -->|"reads dimensions"| node_config
node_pipe -->|"extends"| node_basic
node_pipe -->|"reads dimensions"| node_config
node_title_ready -->|"extends"| node_basic
node_title_over -->|"extends"| node_basic

click node_foundations "https://github.com/neonevins/25-js-note/tree/master/01-JS%E7%9A%84%E5%9F%BA%E6%9C%AC%E7%9F%A5%E8%AF%86"
click node_types "https://github.com/neonevins/25-js-note/tree/master/02-JS%E7%9A%84%E5%9F%BA%E6%9C%AC%E6%95%B0%E6%8D%AE%E7%B1%BB%E5%9E%8B"
click node_functions "https://github.com/neonevins/25-js-note/tree/master/05-%E5%87%BD%E6%95%B0%E7%9A%84%E7%9B%B8%E5%85%B3%E7%9F%A5%E8%AF%86"
click node_arrays "https://github.com/neonevins/25-js-note/tree/master/17-%E6%95%B0%E7%BB%84%E5%AD%97%E7%AC%A6%E4%B8%B2%E7%9A%84API"
click node_oop "https://github.com/neonevins/25-js-note/tree/master/33-%E9%9D%A2%E5%90%91%E5%AF%B9%E8%B1%A1"
click node_async "https://github.com/neonevins/25-js-note/tree/master/38-%E5%90%8C%E6%AD%A5%E5%86%99%E6%B3%95%E7%9A%84%E5%BC%82%E6%AD%A5%E7%BC%96%E7%A8%8B"
click node_dom "https://github.com/neonevins/25-js-note/tree/master/39-dom%E7%9A%84%E7%9B%B8%E5%85%B3%E6%93%8D%E4%BD%9C"
click node_canvas "https://github.com/neonevins/25-js-note/tree/master/41-canvas%E7%94%BB%E5%B8%83"
click node_ajax "https://github.com/neonevins/25-js-note/tree/master/44-ajax"
click node_game "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/Game.js"
click node_config "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/config.js"
click node_scenecontrol "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/Scene.js"
click node_start "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Start.js"
click node_ready "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Ready.js"
click node_gaming "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Gaming.js"
click node_gameover "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/GameOver.js"
click node_background "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Background.js"
click node_bird "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Bird.js"
click node_land "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Land.js"
click node_pipe "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Pipe.js"
click node_score "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Score.js"
click node_logo "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Logo.js"
click node_button "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/button.js"
click node_title_ready "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/TitleReady.js"
click node_title_over "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/TitleOver.js"
click node_basic "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/basic/Basic.js"
click node_tools "https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/tools.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_foundations,node_types,node_functions,node_arrays,node_oop,node_async toneBlue
class node_dom,node_canvas,node_ajax toneAmber
class node_game,node_config,node_scenecontrol,node_start,node_ready,node_gaming,node_gameover toneMint
class node_background,node_bird,node_land,node_pipe,node_score,node_logo,node_button,node_title_ready,node_title_over,node_basic,node_tools toneRose
class node_learner toneIndigo
```

## Components

### Course topics

- [JS foundations](https://github.com/neonevins/25-js-note/tree/master/01-JS%E7%9A%84%E5%9F%BA%E6%9C%AC%E7%9F%A5%E8%AF%86): `01-JS的基本知识`
- [Types and objects](https://github.com/neonevins/25-js-note/tree/master/02-JS%E7%9A%84%E5%9F%BA%E6%9C%AC%E6%95%B0%E6%8D%AE%E7%B1%BB%E5%9E%8B): `02-JS的基本数据类型`
- [Functions and scope](https://github.com/neonevins/25-js-note/tree/master/05-%E5%87%BD%E6%95%B0%E7%9A%84%E7%9B%B8%E5%85%B3%E7%9F%A5%E8%AF%86): `05-函数的相关知识`
- [Arrays and algorithms](https://github.com/neonevins/25-js-note/tree/master/17-%E6%95%B0%E7%BB%84%E5%AD%97%E7%AC%A6%E4%B8%B2%E7%9A%84API): `17-数组字符串的API`
- [Objects and classes](https://github.com/neonevins/25-js-note/tree/master/33-%E9%9D%A2%E5%90%91%E5%AF%B9%E8%B1%A1): `33-面向对象`
- [Async programming](https://github.com/neonevins/25-js-note/tree/master/38-%E5%90%8C%E6%AD%A5%E5%86%99%E6%B3%95%E7%9A%84%E5%BC%82%E6%AD%A5%E7%BC%96%E7%A8%8B): `38-同步写法的异步编程`

### Browser APIs

- [DOM and events](https://github.com/neonevins/25-js-note/tree/master/39-dom%E7%9A%84%E7%9B%B8%E5%85%B3%E6%93%8D%E4%BD%9C): `39-dom的相关操作`
- [Canvas graphics](https://github.com/neonevins/25-js-note/tree/master/41-canvas%E7%94%BB%E5%B8%83): `41-canvas画布`
- [AJAX and JSONP](https://github.com/neonevins/25-js-note/tree/master/44-ajax): `44-ajax`

### Game flow

- [Game loop](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/Game.js): `48-实战/js/Game.js`
- [Canvas config](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/config.js): `48-实战/config.js`
- [Scene controller](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/Scene.js): `48-实战/js/Scene.js`
- [Start scene](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Start.js): `48-实战/js/scene/Start.js`
- [Ready scene](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Ready.js): `48-实战/js/scene/Ready.js`
- [Gameplay scene](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/Gaming.js): `48-实战/js/scene/Gaming.js`
- [Game over scene](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/scene/GameOver.js): `48-实战/js/scene/GameOver.js`

### Game components

- [Background](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Background.js): `48-实战/js/component/Background.js`
- [Bird physics](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Bird.js): `48-实战/js/component/Bird.js`
- [Land](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Land.js): `48-实战/js/component/Land.js`
- [Pipes](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Pipe.js): `48-实战/js/component/Pipe.js`
- [Score display](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Score.js): `48-实战/js/component/Score.js`
- [Game logo](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/Logo.js): `48-实战/js/component/Logo.js`
- [Play button](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/button.js): `48-实战/js/component/button.js`
- [Ready title](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/TitleReady.js): `48-实战/js/component/TitleReady.js`
- [Game-over title](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/TitleOver.js): `48-实战/js/component/TitleOver.js`
- [Component base](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/component/basic/Basic.js): `48-实战/js/component/basic/Basic.js`
- [Game utilities](https://github.com/neonevins/25-js-note/blob/master/48-%E5%AE%9E%E6%88%98/js/tools.js): `48-实战/js/tools.js`

### Other components

- **Learner**

## Connections

- Learner → JS foundations: studies
- Game loop → Canvas config: reads settings (evidence: `48-实战/js/Game.js`)
- Game loop → Scene controller: creates and renders (evidence: `48-实战/js/Game.js`)
- Scene controller → Start scene: selects scene (evidence: `48-实战/js/Scene.js`)
- Scene controller → Ready scene: selects scene (evidence: `48-实战/js/Scene.js`)
- Scene controller → Gameplay scene: selects scene (evidence: `48-实战/js/Scene.js`)
- Scene controller → Game over scene: selects scene (evidence: `48-实战/js/Scene.js`)
- Start scene → Background: renders (evidence: `48-实战/js/scene/Start.js`)
- Start scene → Game logo: renders (evidence: `48-实战/js/scene/Start.js`)
- Start scene → Play button: renders (evidence: `48-实战/js/scene/Start.js`)
- Ready scene → Background: uses (evidence: `48-实战/js/scene/Ready.js`)
- Ready scene → Ready title: uses (evidence: `48-实战/js/scene/Ready.js`)
- Gameplay scene → Background: renders (evidence: `48-实战/js/scene/Gaming.js`)
- Gameplay scene → Bird physics: checks collision (evidence: `48-实战/js/scene/Gaming.js`)
- Gameplay scene → Land: renders (evidence: `48-实战/js/scene/Gaming.js`)
- Gameplay scene → Pipes: checks collision (evidence: `48-实战/js/scene/Gaming.js`)
- Gameplay scene → Score display: updates display (evidence: `48-实战/js/scene/Gaming.js`)
- Game over scene → Background: uses (evidence: `48-实战/js/scene/GameOver.js`)
- Game over scene → Game-over title: uses (evidence: `48-实战/js/scene/GameOver.js`)
- Bird physics → Canvas config: reads dimensions (evidence: `48-实战/js/component/Bird.js`)
- Bird physics → Game utilities: uses debounce (evidence: `48-实战/js/component/Bird.js`)
- Bird physics → Component base: extends (evidence: `48-实战/js/component/Bird.js`)
- Background → Canvas config: reads dimensions (evidence: `48-实战/js/component/Background.js`)
- Background → Component base: extends (evidence: `48-实战/js/component/Background.js`)
- Play button → Canvas config: registers clicks (evidence: `48-实战/js/component/button.js`)
- Play button → Game utilities: checks hit (evidence: `48-实战/js/component/button.js`)
- Play button → Component base: extends (evidence: `48-实战/js/component/button.js`)
- Game logo → Canvas config: registers clicks (evidence: `48-实战/js/component/Logo.js`)
- Game logo → Game utilities: checks hit (evidence: `48-实战/js/component/Logo.js`)
- Game logo → Component base: extends (evidence: `48-实战/js/component/Logo.js`)
- Score display → Canvas config: reads dimensions (evidence: `48-实战/js/component/Score.js`)
- Score display → Component base: extends (evidence: `48-实战/js/component/Score.js`)
- Land → Component base: extends (evidence: `48-实战/js/component/Land.js`)
- Land → Canvas config: reads dimensions (evidence: `48-实战/js/component/Land.js`)
- Pipes → Component base: extends (evidence: `48-实战/js/component/Pipe.js`)
- Pipes → Canvas config: reads dimensions (evidence: `48-实战/js/component/Pipe.js`)
- Ready title → Component base: extends (evidence: `48-实战/js/component/TitleReady.js`)
- Game-over title → Component base: extends (evidence: `48-实战/js/component/TitleOver.js`)
