# khoabm/dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/khoabm/dashboard
- Repository: https://github.com/khoabm/dashboard

## Overview

Vui học cùng cô Quỳnh is a browser-based learning-resource board plus separate personal-gradebook and gradebook/class administration experiences. The main user workflow is route selection, then public material discovery/opening or permission-checked editing; students instead verify identity before lookup, while authorized staff manage grade data. A public-text assistant is a distinct, optionally hosted capability and is documented as isolated from Gradebook and Auth. Backend details and several UI branches are represented at directory level where their source was not sampled; edges are limited to documented or indexed relationships.

Main entry points: [`src/main.js`](https://github.com/khoabm/dashboard/blob/main/src/main.js) (Board controller), [`src/app.js`](https://github.com/khoabm/dashboard/blob/main/src/app.js) (Route shell), [`src/components/gradebook-admin.js`](https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-admin.js) (Gradebook admin), [`src/components/student-lookup.js`](https://github.com/khoabm/dashboard/blob/main/src/components/student-lookup.js) (Student lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application routing"]
  node_app_shell["Route shell<br/>[app.js]"]
end

subgraph group_board["Learning board"]
  node_board_ui["Board interface<br/>[board.js]"]
  node_board_controller["Board controller<br/>[main.js]"]
  node_board_service["Board data service<br/>[board.js]"]
  node_auth_ui["Admin sign-in<br/>[auth.js]"]
  node_storage["Media storage<br/>[storage.js]"]
  node_drafts["Local drafts<br/>[drafts.js]"]
end

subgraph group_assistant["Public assistant"]
  node_assistant_ui["Assistant interface<br/>[board-assistant.js]"]
  node_assistant_client["Assistant client<br/>[board-assistant.js]"]
  node_retrieval["Public retrieval"]
  node_assistant_worker["Hosted assistant<br/>[index.js]"]
end

subgraph group_gradebook["Gradebook workflows"]
  node_lookup_ui["Student lookup<br/>[student-lookup.js]"]
  node_lookup_service["Verified lookup<br/>[student-lookup.js]"]
  node_student_view["Personal gradebook"]
  node_admin_ui["Gradebook admin<br/>[gradebook-admin.js]"]
  node_scores_ui["Score management"]
  node_insights["Learning insights"]
  node_grade_utils["Grade rules and export<br/>[gradebook-admin.js]"]
end

subgraph group_backend["Supabase services"]
  node_client["Supabase client<br/>[client.js]"]
  node_grade_transport["Grade transport"]
  node_admin_function["Admin function<br/>[index.js]"]
  node_lookup_function["Lookup function<br/>[index.js]"]
end

node_visitor(("Visitor or staff"))
node_supabase[("Supabase")]

node_visitor -->|"opens"| node_app_shell
node_app_shell -->|"loads board"| node_board_controller
node_board_controller -->|"renders"| node_board_ui
node_board_controller -->|"saves posts"| node_board_service
node_board_controller -->|"opens login"| node_auth_ui
node_auth_ui -->|"authenticates"| node_client
node_board_controller -->|"cleans media"| node_storage
node_board_controller -.->|"uses drafts"| node_drafts
node_board_controller -->|"offers assistance"| node_assistant_ui
node_assistant_ui -.->|"sends queries"| node_assistant_client
node_assistant_client -.->|"requests hosted AI"| node_assistant_worker
node_assistant_worker -->|"retrieves passages"| node_retrieval
node_retrieval -.->|"uses public corpus"| node_board_controller
node_visitor -->|"requests lookup"| node_lookup_ui
node_app_shell -->|"routes to"| node_lookup_ui
node_lookup_ui -->|"verifies identity"| node_lookup_service
node_lookup_service -.->|"queries"| node_lookup_function
node_lookup_function -.->|"reads grades"| node_supabase
node_app_shell -->|"routes to"| node_admin_ui
node_admin_ui -->|"manages scores"| node_scores_ui
node_admin_ui -.->|"shows insights"| node_insights
node_scores_ui -->|"uses grade rules"| node_grade_utils
node_admin_ui -.->|"loads grade data"| node_grade_transport
node_grade_transport -.->|"calls admin API"| node_admin_function
node_admin_function -.->|"reads and writes"| node_supabase
node_client -->|"connects"| node_supabase

click node_app_shell "https://github.com/khoabm/dashboard/blob/main/src/app.js"
click node_board_ui "https://github.com/khoabm/dashboard/blob/main/src/components/board.js"
click node_board_controller "https://github.com/khoabm/dashboard/blob/main/src/main.js"
click node_board_service "https://github.com/khoabm/dashboard/blob/main/src/services/board.js"
click node_auth_ui "https://github.com/khoabm/dashboard/blob/main/src/components/auth.js"
click node_storage "https://github.com/khoabm/dashboard/blob/main/src/services/storage.js"
click node_drafts "https://github.com/khoabm/dashboard/blob/main/src/services/drafts.js"
click node_assistant_ui "https://github.com/khoabm/dashboard/blob/main/src/components/board-assistant.js"
click node_assistant_client "https://github.com/khoabm/dashboard/blob/main/src/services/board-assistant.js"
click node_retrieval "https://github.com/khoabm/dashboard/blob/main/src/utils/public-retrieval.js"
click node_assistant_worker "https://github.com/khoabm/dashboard/blob/main/workers/board-assistant/index.js"
click node_lookup_ui "https://github.com/khoabm/dashboard/blob/main/src/components/student-lookup.js"
click node_lookup_service "https://github.com/khoabm/dashboard/blob/main/src/services/student-lookup.js"
click node_student_view "https://github.com/khoabm/dashboard/blob/main/src/components/student-gradeboard.js"
click node_admin_ui "https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-admin.js"
click node_scores_ui "https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-scores.js"
click node_insights "https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-learning-insights.js"
click node_grade_utils "https://github.com/khoabm/dashboard/blob/main/src/utils/gradebook-admin.js"
click node_client "https://github.com/khoabm/dashboard/blob/main/src/services/client.js"
click node_grade_transport "https://github.com/khoabm/dashboard/blob/main/src/services/gradebook-transport.js"
click node_admin_function "https://github.com/khoabm/dashboard/blob/main/supabase/functions/grades-admin/index.js"
click node_lookup_function "https://github.com/khoabm/dashboard/blob/main/supabase/functions/student-lookup/index.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_shell toneBlue
class node_board_ui,node_board_controller,node_board_service,node_auth_ui,node_storage,node_drafts,node_supabase toneAmber
class node_assistant_ui,node_assistant_client,node_retrieval,node_assistant_worker toneMint
class node_lookup_ui,node_lookup_service,node_student_view,node_admin_ui,node_scores_ui,node_insights,node_grade_utils toneRose
class node_client,node_grade_transport,node_admin_function,node_lookup_function,node_visitor toneIndigo
```

## Components

### Application routing

- [Route shell](https://github.com/khoabm/dashboard/blob/main/src/app.js): `src/app.js`

### Learning board

- [Board interface](https://github.com/khoabm/dashboard/blob/main/src/components/board.js): `src/components/board.js`
- [Board controller](https://github.com/khoabm/dashboard/blob/main/src/main.js): `src/main.js`
- [Board data service](https://github.com/khoabm/dashboard/blob/main/src/services/board.js): `src/services/board.js`
- [Admin sign-in](https://github.com/khoabm/dashboard/blob/main/src/components/auth.js): `src/components/auth.js`
- [Media storage](https://github.com/khoabm/dashboard/blob/main/src/services/storage.js): `src/services/storage.js`
- [Local drafts](https://github.com/khoabm/dashboard/blob/main/src/services/drafts.js): `src/services/drafts.js`

### Public assistant

- [Assistant interface](https://github.com/khoabm/dashboard/blob/main/src/components/board-assistant.js): `src/components/board-assistant.js`
- [Assistant client](https://github.com/khoabm/dashboard/blob/main/src/services/board-assistant.js): `src/services/board-assistant.js`
- [Public retrieval](https://github.com/khoabm/dashboard/blob/main/src/utils/public-retrieval.js): `src/utils/public-retrieval.js`
- [Hosted assistant](https://github.com/khoabm/dashboard/blob/main/workers/board-assistant/index.js): `workers/board-assistant/index.js`

### Gradebook workflows

- [Student lookup](https://github.com/khoabm/dashboard/blob/main/src/components/student-lookup.js): `src/components/student-lookup.js`
- [Verified lookup](https://github.com/khoabm/dashboard/blob/main/src/services/student-lookup.js): `src/services/student-lookup.js`
- [Personal gradebook](https://github.com/khoabm/dashboard/blob/main/src/components/student-gradeboard.js): `src/components/student-gradeboard.js`
- [Gradebook admin](https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-admin.js): `src/components/gradebook-admin.js`
- [Score management](https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-scores.js): `src/components/gradebook-scores.js`
- [Learning insights](https://github.com/khoabm/dashboard/blob/main/src/components/gradebook-learning-insights.js): `src/components/gradebook-learning-insights.js`
- [Grade rules and export](https://github.com/khoabm/dashboard/blob/main/src/utils/gradebook-admin.js): `src/utils/gradebook-admin.js`

### Supabase services

- [Supabase client](https://github.com/khoabm/dashboard/blob/main/src/services/client.js): `src/services/client.js`
- [Grade transport](https://github.com/khoabm/dashboard/blob/main/src/services/gradebook-transport.js): `src/services/gradebook-transport.js`
- [Admin function](https://github.com/khoabm/dashboard/blob/main/supabase/functions/grades-admin/index.js): `supabase/functions/grades-admin/index.js`
- [Lookup function](https://github.com/khoabm/dashboard/blob/main/supabase/functions/student-lookup/index.js): `supabase/functions/student-lookup/index.js`

### Other components

- **Visitor or staff**
- **Supabase**

## Connections

- Visitor or staff → Route shell: opens (evidence: `README.md`)
- Route shell → Board controller: loads board (evidence: `src/app.js`)
- Board controller → Board interface: renders (evidence: `src/main.js`)
- Board controller → Board data service: saves posts (evidence: `src/main.js`)
- Board controller → Admin sign-in: opens login (evidence: `src/main.js`)
- Admin sign-in → Supabase client: authenticates (evidence: `src/components/auth.js`)
- Board controller → Media storage: cleans media (evidence: `src/main.js`)
- Board controller → Local drafts: uses drafts
- Board controller → Assistant interface: offers assistance (evidence: `README.md`)
- Assistant interface → Assistant client: sends queries
- Assistant client → Hosted assistant: requests hosted AI
- Hosted assistant → Public retrieval: retrieves passages (evidence: `workers/board-assistant/index.js`)
- Public retrieval → Board controller: uses public corpus
- Visitor or staff → Student lookup: requests lookup (evidence: `README.md`)
- Route shell → Student lookup: routes to (evidence: `src/app.js`)
- Student lookup → Verified lookup: verifies identity (evidence: `src/app.js`)
- Verified lookup → Lookup function: queries
- Lookup function → Supabase: reads grades
- Route shell → Gradebook admin: routes to (evidence: `src/app.js`)
- Gradebook admin → Score management: manages scores (evidence: `src/components/gradebook-admin.js`)
- Gradebook admin → Learning insights: shows insights
- Score management → Grade rules and export: uses grade rules (evidence: `src/components/gradebook-scores.js`)
- Gradebook admin → Grade transport: loads grade data
- Grade transport → Admin function: calls admin API
- Admin function → Supabase: reads and writes
- Supabase client → Supabase: connects (evidence: `src/services/client.js`)
