How liu2-3zhi/campus-running-assistant-for-zsc works
跑步助手 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 Flask application · ControlTabs.vue Running dashboard · App.vue Vue application · editormd.js Editor core
Components 25
Backend runtime
- Flask application
main.py - Startup configuration
main.py - Running automation
main.py - Account sessions
main.py - Payment orders
main.py - Health endpoint
main.py - Product names
product_name_generator.py
Web application
- Vue application
frontend/src/App.vue - Login and sessions
frontend/src/components/login/AuthPanel.vue - Multi-account access
frontend/src/views/MultiAccountView.vue - Running dashboard
frontend/src/components/main/ControlTabs.vue - Task data
frontend/src/components/main/taskData.js - Running map
frontend/src/components/map/MapContainer.vue - Billing interface
frontend/src/composables/usePayment.js - Administration
frontend/src/components/admin/AdminPanel.vue - HTTP API client
frontend/src/services/api.js - Live updates
frontend/src/services/socket.js
Markdown editor
- Editor core
editor.md/editormd.js - Editor dialogs
editor.md/plugins - Editor languages
editor.md/languages/en.js
Operations and integrations
- Nginx log forwarding
nginx/nginx_log_forwarder.py - Nginx
- Service worker
PWA/sw.js
Other components
- User
- Administrator
Connections 22
- 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
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
editor.md/editormd.js - Editor core → Editor languages: uses language
editor.md/languages/en.js - Nginx → Nginx log forwarding: forwards access logs
- User → Service worker: loads app assets