# kirihuang-bit/ai-course-vibe_coding-class architecture

> Architecture diagram of the GitHub repository kirihuang-bit/ai-course-vibe_coding-class, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kirihuang-bit/ai-course-vibe_coding-class
- Repository: https://github.com/kirihuang-bit/ai-course-vibe_coding-class

## Overview

This repository is a hands-on AI-driven development course built around the GYOZA WOOD ordering and inventory-control scenario. Its central product workflow is the web app: users inspect stock and orders, operate a simulated order flow, view live inventory/order data, then review a notification before sending through a guarded LINE backend. The wider course also teaches ops-agent reporting and an Astro technical write-up. Edges reflect README statements and shown imports/API calls; unsampled subsystems are included only where documented.

Main entry points: [`data-lab/report.json`](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/data-lab/report.json) (Report and Orders), [`web-lab/src/App.jsx`](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/App.jsx) (Page Router), [`web-lab/src/OrderBoard.jsx`](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/OrderBoard.jsx) (Order Board), [`web-lab/src/Dashboard.jsx`](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/Dashboard.jsx) (Push Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Store Web App"]
  node_entry["Page Router<br/>[App.jsx]"]
  node_prep["Prep Console<br/>[ShopConsole.jsx]"]
  node_shopdata["Shop Fixtures<br/>[shopData.js]"]
  node_shoplogic["Stock Rules<br/>[shopLogic.js]"]
  node_orders["Order Board<br/>[OrderBoard.jsx]"]
  node_canvas["Order Animation"]
  node_dashboard["Push Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_runtime["Order Runtime"]
  node_sim["Order Simulator<br/>[orderSim.js]"]
  node_api["Dev API Routes<br/>[vite.config.js]"]
end

subgraph group_notify["Reporting Notifications"]
  node_reportdata["Report and Orders<br/>[report.json]"]
  node_ops["Ops Agent<br/>[run_ops_check.py]"]
  node_line["LINE Sender<br/>[sendLineAlert.js]"]
  node_reportgen["Report Generator<br/>[run.py]"]
end

subgraph group_course["Course Delivery"]
  node_blog["Technical Blog<br/>[index.astro]"]
  node_courseguide["Course Guides<br/>[README.md]"]
end

node_learner(("Learner"))
node_lineapi["LINE Messaging API"]
node_actions(("Human Reviewer"))

node_learner -->|"opens app"| node_entry
node_entry -->|"routes view"| node_prep
node_entry -->|"routes view"| node_orders
node_entry -->|"routes view"| node_dashboard
node_prep -->|"reads fixtures"| node_shopdata
node_prep -->|"uses rules"| node_shoplogic
node_orders -->|"reads samples"| node_shopdata
node_orders -->|"polls and adjusts"| node_api
node_orders -->|"renders"| node_canvas
node_canvas -->|"reads samples"| node_shopdata
node_api -.->|"dispatches API"| node_sim
node_sim -->|"formats report shape"| node_reportdata
node_dashboard -->|"requests snapshots"| node_api
node_dashboard -->|"posts reviewed push"| node_line
node_dashboard -->|"reads static report"| node_reportdata
node_ops -->|"writes report"| node_reportdata
node_reportgen -.->|"produces report"| node_reportdata
node_line -->|"reads report data"| node_reportdata
node_line -->|"pushes payload"| node_lineapi
node_actions -->|"confirms real send"| node_line
node_learner -->|"follows lessons"| node_courseguide
node_learner -->|"runs inventory check"| node_ops
node_learner -->|"documents results"| node_blog

click node_entry "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/App.jsx"
click node_prep "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/ShopConsole.jsx"
click node_shopdata "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/shopData.js"
click node_shoplogic "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/shopLogic.js"
click node_orders "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/OrderBoard.jsx"
click node_canvas "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/OrderBoardCanvas.jsx"
click node_dashboard "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/Dashboard.jsx"
click node_sim "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/orderSim.js"
click node_api "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/vite.config.js"
click node_reportdata "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/data-lab/report.json"
click node_ops "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/ops-agent-lab/run_ops_check.py"
click node_line "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/line-lab/sendLineAlert.js"
click node_reportgen "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/data-lab/run.py"
click node_blog "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/blog-lab/src/pages/index.astro"
click node_courseguide "https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/U0/README.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_entry,node_prep,node_shopdata,node_shoplogic,node_orders,node_canvas,node_dashboard,node_actions toneBlue
class node_sim,node_api toneAmber
class node_reportdata,node_ops,node_line,node_reportgen,node_lineapi toneMint
class node_blog,node_courseguide toneRose
class node_learner toneIndigo
```

## Components

### Store Web App

- [Page Router](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/App.jsx): `web-lab/src/App.jsx`
- [Prep Console](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/ShopConsole.jsx): `web-lab/src/ShopConsole.jsx`
- [Shop Fixtures](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/shopData.js): `web-lab/src/shopData.js`
- [Stock Rules](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/shopLogic.js): `web-lab/src/shopLogic.js`
- [Order Board](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/OrderBoard.jsx): `web-lab/src/OrderBoard.jsx`
- [Order Animation](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/OrderBoardCanvas.jsx): `web-lab/src/OrderBoardCanvas.jsx`
- [Push Dashboard](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/src/Dashboard.jsx): `web-lab/src/Dashboard.jsx`

### Order Runtime

- [Order Simulator](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/orderSim.js): `web-lab/orderSim.js`
- [Dev API Routes](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/web-lab/vite.config.js): `web-lab/vite.config.js`

### Reporting Notifications

- [Report and Orders](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/data-lab/report.json): `data-lab/report.json`
- [Ops Agent](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/ops-agent-lab/run_ops_check.py): `ops-agent-lab/run_ops_check.py`
- [LINE Sender](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/line-lab/sendLineAlert.js): `line-lab/sendLineAlert.js`
- [Report Generator](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/data-lab/run.py): `data-lab/run.py`

### Course Delivery

- [Technical Blog](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/blog-lab/src/pages/index.astro): `blog-lab/src/pages/index.astro`
- [Course Guides](https://github.com/kirihuang-bit/ai-course-vibe_coding-class/blob/main/U0/README.md): `U0/README.md`

### Other components

- **Learner**
- **LINE Messaging API**
- **Human Reviewer**

## Connections

- Learner → Page Router: opens app (evidence: `README.md`)
- Page Router → Prep Console: routes view (evidence: `web-lab/src/App.jsx`)
- Page Router → Order Board: routes view (evidence: `web-lab/src/App.jsx`)
- Page Router → Push Dashboard: routes view (evidence: `web-lab/src/App.jsx`)
- Prep Console → Shop Fixtures: reads fixtures (evidence: `web-lab/src/ShopConsole.jsx`)
- Prep Console → Stock Rules: uses rules (evidence: `web-lab/src/ShopConsole.jsx`)
- Order Board → Shop Fixtures: reads samples (evidence: `web-lab/src/OrderBoard.jsx`)
- Order Board → Dev API Routes: polls and adjusts (evidence: `web-lab/src/OrderBoard.jsx`)
- Order Board → Order Animation: renders (evidence: `web-lab/src/OrderBoard.jsx`)
- Order Animation → Shop Fixtures: reads samples (evidence: `web-lab/src/OrderBoardCanvas.jsx`)
- Dev API Routes → Order Simulator: dispatches API (evidence: `web-lab/vite.config.js`)
- Order Simulator → Report and Orders: formats report shape (evidence: `web-lab/orderSim.js`)
- Push Dashboard → Dev API Routes: requests snapshots (evidence: `web-lab/src/Dashboard.jsx`)
- Push Dashboard → LINE Sender: posts reviewed push (evidence: `web-lab/src/Dashboard.jsx`)
- Push Dashboard → Report and Orders: reads static report (evidence: `web-lab/src/Dashboard.jsx`)
- Ops Agent → Report and Orders: writes report (evidence: `README.md`)
- Report Generator → Report and Orders: produces report
- LINE Sender → Report and Orders: reads report data (evidence: `line-lab/sendLineAlert.js`)
- LINE Sender → LINE Messaging API: pushes payload (evidence: `line-lab/sendLineAlert.js`)
- Human Reviewer → LINE Sender: confirms real send (evidence: `README.md`)
- Learner → Course Guides: follows lessons (evidence: `README.md`)
- Learner → Ops Agent: runs inventory check (evidence: `README.md`)
- Learner → Technical Blog: documents results (evidence: `README.md`)
