# zhuliliui/college-workbench architecture

> Architecture diagram of the GitHub repository zhuliliui/college-workbench, 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/zhuliliui/college-workbench
- Repository: https://github.com/zhuliliui/college-workbench

## Overview

College Workbench is a student-facing web and Capacitor app for planning, study, learning, and personal tracking, with a lightweight Node backend for deadline reminders, calendar feeds, and content services. The main user flow is navigation into a workbench feature, updating locally managed information, and optionally syncing deadlines or backups. Android adds native calendar, speech, and home-screen widget capabilities. Several frontend modules and backend routes are represented from filenames or documented comments; their internal wiring is not shown, so those links are omitted or marked unverified.

Main entry points: [`js/app.js`](https://github.com/zhuliliui/college-workbench/blob/main/js/app.js) (App Shell), [`server.js`](https://github.com/zhuliliui/college-workbench/blob/main/server.js) (Workbench Server), [`android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java`](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java) (Widget Data Plugin), [`android/app/src/main/java/com/college/workbench/MainActivity.java`](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/MainActivity.java) (Capacitor Activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Workbench UI"]
  node_app["App Shell<br/>[app.js]"]
  node_store[("Local State<br/>[store.js]")]
  node_dashboard["Dashboard<br/>[dashboard.js]"]
  node_checkin["Focus Check-in<br/>[checkin.js]"]
  node_deadlines["Deadlines<br/>[ddl.js]"]
  node_review["Monthly Review<br/>[review.js]"]
  node_finance["Finance Tracker<br/>[finance.js]"]
  node_discipline["Discipline<br/>[discipline.js]"]
  node_travel["Travel Planner<br/>[travel.js]"]
end

subgraph group_learning["Learning Tools"]
  node_skill["Skill Learning<br/>[skill.js]"]
  node_study["Study Planner<br/>[study.js]"]
  node_english["English Learning<br/>[english.js]"]
  node_exam["Exam Prep<br/>[kaoyan-seed.js]"]
  node_dictionary["English Dictionary<br/>[en-dict.js]"]
end

subgraph group_backend["Backend Services"]
  node_calendar["Calendar Bridge<br/>[calendar-native.js]"]
  node_cloud["Cloud Backup<br/>[cloud.js]"]
  node_server["Workbench Server<br/>[server.js]"]
  node_news["News Content<br/>[realnews-seed.js]"]
end

subgraph group_android["Android Features"]
  node_android["Capacitor Activity<br/>[MainActivity.java]"]
  node_nativecalendar["Local Calendar"]
  node_tts["Text to Speech"]
  node_widgetbridge["Widget Bridge<br/>[widget-bridge.js]"]
  node_widgetdata["Widget Data Plugin"]
  node_widgetprovider["Widget Provider"]
  node_widgetviews["Widget Rows"]
end

node_student(("Student"))
node_push["Push Provider"]
node_ai["Translation API"]
node_feeds["News Feeds"]

node_student -->|"opens"| node_app
node_app -->|"reads state"| node_store
node_app -->|"uploads backup"| node_cloud
node_app -.->|"navigates"| node_dashboard
node_app -.->|"navigates"| node_checkin
node_app -.->|"navigates"| node_deadlines
node_app -.->|"navigates"| node_review
node_app -.->|"navigates"| node_skill
node_android -->|"registers"| node_nativecalendar
node_android -->|"registers"| node_tts
node_android -->|"registers"| node_widgetdata
node_widgetbridge -->|"sends widget data"| node_widgetdata
node_widgetdata -->|"triggers refresh"| node_widgetprovider
node_widgetprovider -->|"loads row views"| node_widgetviews
node_widgetviews -->|"reads preferences"| node_widgetdata
node_widgetprovider -->|"records toggle"| node_widgetdata
node_server -->|"requests translation"| node_ai
node_server -->|"fetches articles"| node_feeds
node_server -.->|"sends reminders"| node_push
node_deadlines -.->|"syncs deadlines"| node_server
node_cloud -.->|"syncs backup"| node_server

click node_app "https://github.com/zhuliliui/college-workbench/blob/main/js/app.js"
click node_store "https://github.com/zhuliliui/college-workbench/blob/main/js/store.js"
click node_dashboard "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/dashboard.js"
click node_checkin "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/checkin.js"
click node_deadlines "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/ddl.js"
click node_review "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/review.js"
click node_finance "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/finance.js"
click node_discipline "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/discipline.js"
click node_travel "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/travel.js"
click node_skill "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/skill.js"
click node_study "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/study.js"
click node_english "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/english.js"
click node_exam "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/kaoyan-seed.js"
click node_dictionary "https://github.com/zhuliliui/college-workbench/blob/main/js/pages/en-dict.js"
click node_calendar "https://github.com/zhuliliui/college-workbench/blob/main/js/calendar-native.js"
click node_cloud "https://github.com/zhuliliui/college-workbench/blob/main/js/cloud.js"
click node_server "https://github.com/zhuliliui/college-workbench/blob/main/server.js"
click node_news "https://github.com/zhuliliui/college-workbench/blob/main/js/realnews-seed.js"
click node_android "https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/MainActivity.java"
click node_nativecalendar "https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/CalendarLocalPlugin.java"
click node_tts "https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/TextToSpeechPlugin.java"
click node_widgetbridge "https://github.com/zhuliliui/college-workbench/blob/main/js/widget-bridge.js"
click node_widgetdata "https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java"
click node_widgetprovider "https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/CwWidgetProvider.java"
click node_widgetviews "https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/CwWidgetRemoteViewsService.java"

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_store,node_dashboard,node_checkin,node_deadlines,node_review,node_finance,node_discipline,node_travel toneBlue
class node_skill,node_study,node_english,node_exam,node_dictionary toneAmber
class node_calendar,node_cloud,node_server,node_news,node_ai toneMint
class node_android,node_nativecalendar,node_tts,node_widgetbridge,node_widgetdata,node_widgetprovider,node_widgetviews toneRose
class node_student,node_push,node_feeds toneIndigo
```

## Components

### Workbench UI

- [App Shell](https://github.com/zhuliliui/college-workbench/blob/main/js/app.js): `js/app.js`
- [Local State](https://github.com/zhuliliui/college-workbench/blob/main/js/store.js): `js/store.js`
- [Dashboard](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/dashboard.js): `js/pages/dashboard.js`
- [Focus Check-in](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/checkin.js): `js/pages/checkin.js`
- [Deadlines](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/ddl.js): `js/pages/ddl.js`
- [Monthly Review](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/review.js): `js/pages/review.js`
- [Finance Tracker](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/finance.js): `js/pages/finance.js`
- [Discipline](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/discipline.js): `js/pages/discipline.js`
- [Travel Planner](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/travel.js): `js/pages/travel.js`

### Learning Tools

- [Skill Learning](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/skill.js): `js/pages/skill.js`
- [Study Planner](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/study.js): `js/pages/study.js`
- [English Learning](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/english.js): `js/pages/english.js`
- [Exam Prep](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/kaoyan-seed.js): `js/pages/kaoyan-seed.js`
- [English Dictionary](https://github.com/zhuliliui/college-workbench/blob/main/js/pages/en-dict.js): `js/pages/en-dict.js`

### Backend Services

- [Calendar Bridge](https://github.com/zhuliliui/college-workbench/blob/main/js/calendar-native.js): `js/calendar-native.js`
- [Cloud Backup](https://github.com/zhuliliui/college-workbench/blob/main/js/cloud.js): `js/cloud.js`
- [Workbench Server](https://github.com/zhuliliui/college-workbench/blob/main/server.js): `server.js`
- [News Content](https://github.com/zhuliliui/college-workbench/blob/main/js/realnews-seed.js): `js/realnews-seed.js`

### Android Features

- [Capacitor Activity](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/MainActivity.java): `android/app/src/main/java/com/college/workbench/MainActivity.java`
- [Local Calendar](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/CalendarLocalPlugin.java): `android/app/src/main/java/com/college/workbench/CalendarLocalPlugin.java`
- [Text to Speech](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/TextToSpeechPlugin.java): `android/app/src/main/java/com/college/workbench/TextToSpeechPlugin.java`
- [Widget Bridge](https://github.com/zhuliliui/college-workbench/blob/main/js/widget-bridge.js): `js/widget-bridge.js`
- [Widget Data Plugin](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java): `android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java`
- [Widget Provider](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/CwWidgetProvider.java): `android/app/src/main/java/com/college/workbench/CwWidgetProvider.java`
- [Widget Rows](https://github.com/zhuliliui/college-workbench/blob/main/android/app/src/main/java/com/college/workbench/CwWidgetRemoteViewsService.java): `android/app/src/main/java/com/college/workbench/CwWidgetRemoteViewsService.java`

### Other components

- **Student**
- **Push Provider**
- **Translation API**
- **News Feeds**

## Connections

- Student → App Shell: opens (evidence: `js/app.js`)
- App Shell → Local State: reads state (evidence: `js/app.js`)
- App Shell → Cloud Backup: uploads backup (evidence: `js/app.js`)
- App Shell → Dashboard: navigates
- App Shell → Focus Check-in: navigates
- App Shell → Deadlines: navigates
- App Shell → Monthly Review: navigates
- App Shell → Skill Learning: navigates
- Capacitor Activity → Local Calendar: registers (evidence: `android/app/src/main/java/com/college/workbench/MainActivity.java`)
- Capacitor Activity → Text to Speech: registers (evidence: `android/app/src/main/java/com/college/workbench/MainActivity.java`)
- Capacitor Activity → Widget Data Plugin: registers (evidence: `android/app/src/main/java/com/college/workbench/MainActivity.java`)
- Widget Bridge → Widget Data Plugin: sends widget data (evidence: `android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java`)
- Widget Data Plugin → Widget Provider: triggers refresh (evidence: `android/app/src/main/java/com/college/workbench/WidgetDataPlugin.java`)
- Widget Provider → Widget Rows: loads row views (evidence: `android/app/src/main/java/com/college/workbench/CwWidgetProvider.java`)
- Widget Rows → Widget Data Plugin: reads preferences (evidence: `android/app/src/main/java/com/college/workbench/CwWidgetRemoteViewsService.java`)
- Widget Provider → Widget Data Plugin: records toggle (evidence: `android/app/src/main/java/com/college/workbench/CwWidgetProvider.java`)
- Workbench Server → Translation API: requests translation (evidence: `server.js`)
- Workbench Server → News Feeds: fetches articles (evidence: `server.js`)
- Workbench Server → Push Provider: sends reminders
- Deadlines → Workbench Server: syncs deadlines
- Cloud Backup → Workbench Server: syncs backup
