# liu2-3zhi/campus-running-assistant-for-zsc architecture

> Architecture diagram of the GitHub repository liu2-3zhi/campus-running-assistant-for-zsc, 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/liu2-3zhi/campus-running-assistant-for-zsc
- Repository: https://github.com/liu2-3zhi/campus-running-assistant-for-zsc

## Overview

跑步助手 is a Flask-based campus-running web application with a Vue interface. The main user flow is login/session selection, then managing running tasks and viewing their status; users can also manage payment orders and administrators can configure and monitor the service. The README documents backend capabilities implemented under main.py, but backend internals and most frontend wiring were not sampled, so those relationships are shown only where documented or clearly left unconnected. Editor.md is a bundled Markdown editor dependency; its core and major dialogs are represented.

Main entry points: [`main.py`](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py) (Flask application), [`frontend/src/components/main/ControlTabs.vue`](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/main/ControlTabs.vue) (Running dashboard), [`frontend/src/App.vue`](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/App.vue) (Vue application), [`editor.md/editormd.js`](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/editor.md/editormd.js) (Editor core)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_backend["Backend runtime"]
  node_server["Flask application<br/>[main.py]"]
  node_setup["Startup configuration<br/>[main.py]"]
  node_automation["Running automation<br/>[main.py]"]
  node_sessions[("Account sessions<br/>[main.py]")]
  node_payments[("Payment orders<br/>[main.py]")]
  node_health["Health endpoint<br/>[main.py]"]
  node_productnames["Product names"]
end

subgraph group_frontend["Web application"]
  node_app["Vue application<br/>[App.vue]"]
  node_auth["Login and sessions<br/>[AuthPanel.vue]"]
  node_multiaccount["Multi-account access"]
  node_dashboard["Running dashboard<br/>[ControlTabs.vue]"]
  node_taskdata["Task data<br/>[taskData.js]"]
  node_map["Running map<br/>[MapContainer.vue]"]
  node_billing["Billing interface<br/>[usePayment.js]"]
  node_adminui["Administration<br/>[AdminPanel.vue]"]
  node_api["HTTP API client<br/>[api.js]"]
  node_socket["Live updates<br/>[socket.js]"]
end

subgraph group_editor["Markdown editor"]
  node_editorcore["Editor core<br/>[editormd.js]"]
  node_editordialogs["Editor dialogs<br/>[plugins]"]
  node_editorlang["Editor languages<br/>[en.js]"]
end

subgraph group_operations["Operations and integrations"]
  node_nginxlogs["Nginx log forwarding"]
  node_nginx["Nginx"]
  node_pwa["Service worker<br/>[sw.js]"]
end

node_user(("User"))
node_admin(("Administrator"))

node_user -.->|"opens"| node_app
node_admin -.->|"opens"| node_app
node_app -.->|"renders"| node_auth
node_auth -.->|"selects account"| node_multiaccount
node_user -.->|"manages runs"| node_dashboard
node_dashboard -->|"uses"| node_taskdata
node_dashboard -.->|"shows map"| node_map
node_user -.->|"manages payments"| node_billing
node_admin -.->|"configures service"| node_adminui
node_dashboard -.->|"requests data"| node_api
node_dashboard -.->|"receives updates"| node_socket
node_user -.->|"uses web service"| node_server
node_server -->|"initializes"| node_setup
node_server -->|"supports configuration"| node_automation
node_server -->|"persists sessions"| node_sessions
node_server -->|"handles orders"| node_payments
node_server -->|"provides health check"| node_health
node_server -->|"registers modes"| node_productnames
node_editorcore -->|"dispatches dialogs"| node_editordialogs
node_editorcore -->|"uses language"| node_editorlang
node_nginx -->|"forwards access logs"| node_nginxlogs
node_user -.->|"loads app assets"| node_pwa

click node_server "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py"
click node_setup "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py"
click node_automation "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py"
click node_sessions "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py"
click node_payments "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py"
click node_health "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py"
click node_productnames "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/product_name_generator.py"
click node_app "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/App.vue"
click node_auth "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/login/AuthPanel.vue"
click node_multiaccount "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/views/MultiAccountView.vue"
click node_dashboard "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/main/ControlTabs.vue"
click node_taskdata "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/main/taskData.js"
click node_map "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/map/MapContainer.vue"
click node_billing "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/composables/usePayment.js"
click node_adminui "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/admin/AdminPanel.vue"
click node_api "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/services/api.js"
click node_socket "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/services/socket.js"
click node_editorcore "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/editor.md/editormd.js"
click node_editordialogs "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/tree/main/editor.md/plugins"
click node_editorlang "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/editor.md/languages/en.js"
click node_nginxlogs "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/nginx/nginx_log_forwarder.py"
click node_pwa "https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/PWA/sw.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_server,node_setup,node_automation,node_sessions,node_payments,node_health,node_productnames,node_user toneBlue
class node_app,node_auth,node_multiaccount,node_dashboard,node_taskdata,node_map,node_billing,node_adminui,node_api,node_socket toneAmber
class node_editorcore,node_editordialogs,node_editorlang toneMint
class node_nginxlogs,node_nginx,node_pwa toneRose
class node_admin toneIndigo
```

## Components

### Backend runtime

- [Flask application](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py): `main.py`
- [Startup configuration](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py): `main.py`
- [Running automation](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py): `main.py`
- [Account sessions](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py): `main.py`
- [Payment orders](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py): `main.py`
- [Health endpoint](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/main.py): `main.py`
- [Product names](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/product_name_generator.py): `product_name_generator.py`

### Web application

- [Vue application](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Login and sessions](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/login/AuthPanel.vue): `frontend/src/components/login/AuthPanel.vue`
- [Multi-account access](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/views/MultiAccountView.vue): `frontend/src/views/MultiAccountView.vue`
- [Running dashboard](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/main/ControlTabs.vue): `frontend/src/components/main/ControlTabs.vue`
- [Task data](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/main/taskData.js): `frontend/src/components/main/taskData.js`
- [Running map](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/map/MapContainer.vue): `frontend/src/components/map/MapContainer.vue`
- [Billing interface](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/composables/usePayment.js): `frontend/src/composables/usePayment.js`
- [Administration](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/components/admin/AdminPanel.vue): `frontend/src/components/admin/AdminPanel.vue`
- [HTTP API client](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Live updates](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/frontend/src/services/socket.js): `frontend/src/services/socket.js`

### Markdown editor

- [Editor core](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/editor.md/editormd.js): `editor.md/editormd.js`
- [Editor dialogs](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/tree/main/editor.md/plugins): `editor.md/plugins`
- [Editor languages](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/editor.md/languages/en.js): `editor.md/languages/en.js`

### Operations and integrations

- [Nginx log forwarding](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/nginx/nginx_log_forwarder.py): `nginx/nginx_log_forwarder.py`
- **Nginx**
- [Service worker](https://github.com/liu2-3zhi/campus-running-assistant-for-zsc/blob/main/PWA/sw.js): `PWA/sw.js`

### Other components

- **User**
- **Administrator**

## Connections

- User → Vue application: opens
- Administrator → Vue application: opens
- Vue application → Login and sessions: renders
- Login and sessions → Multi-account access: selects account
- User → Running dashboard: manages runs
- Running dashboard → Task data: uses (evidence: `frontend/src/components/main/ControlTabs.vue`)
- Running dashboard → Running map: shows map
- User → Billing interface: manages payments
- Administrator → Administration: configures service
- Running dashboard → HTTP API client: requests data
- Running dashboard → Live updates: receives updates
- User → Flask application: uses web service
- Flask application → Startup configuration: initializes
- Flask application → Running automation: supports configuration
- Flask application → Account sessions: persists sessions
- Flask application → Payment orders: handles orders
- Flask application → Health endpoint: provides health check
- Flask application → Product names: registers modes
- Editor core → Editor dialogs: dispatches dialogs (evidence: `editor.md/editormd.js`)
- Editor core → Editor languages: uses language (evidence: `editor.md/languages/en.js`)
- Nginx → Nginx log forwarding: forwards access logs
- User → Service worker: loads app assets
