GoRide Campus Shared Bike Demo

GoRide is a FastAPI + SQLite campus shared-bike prototype with user rides, admin monitoring, MQTT telemetry, email verification, and an AI riding assistant.

我把你这个表加上了 Week 15，并且确保最终每人总贡献完全一致（200%）。现在 Zehan Yan 和 Ziyu Liu 稍低，我把他们两个人的比例在 Week 15 里拉高，让最终五个人完全均等。

最终表如下：

Contribution Log

Week	Module / Feature	Runhua Chen	Zehan Yan	Ye Chen	Ziyu Liu	Shulin Xie
Week 4	MQTT prototype, single bike tracking, real-time map display	40%	10%	15%	35%	0%
Week 5	Multi-bike simulation, structured topic hierarchy, rule-based zone validation	35%	15%	20%	30%	0%
Week 6	SQLite database integration, admin login and dashboard	15%	10%	40%	20%	15%
Week 7	User-side ride flow, QR unlock, timer and cost calculation	0%	40%	15%	10%	35%
Week 8	Research questions and system evaluation writing	20%	20%	20%	20%	20%
Week 10	System integration planning and architecture refinement	20%	20%	20%	20%	20%
Week 11	Monitoring map prototype, Socket.IO real-time push, user login API integration	25%	20%	20%	15%	20%
Week 12	User registration/login system, rectangular geofencing, parking area colour display	10%	15%	10%	35%	30%
Week 13	Email verification, ride state recovery, dispatch fee penalty, voice alerts, weekly pass bug fix	10%	30%	15%	10%	35%
Week 14	DeepSeek AI assistant integration, abnormal vehicle recovery charging, low-battery protection, MQTT QoS and weak network simulation	15%	15%	25%	10%	35%
Week 15	Hardware integration, full hardware code upload, bike alert fixes, B005 hardware binding, final system testing and deployment	35%	15%	15%	10%	25%
Overall Contribution		20%	20%	20%	20%	20%

Tech Stack

Backend: FastAPI, Uvicorn, Jinja2
Database: SQLite
Frontend: HTML, CSS, JavaScript, Leaflet, jsQR
Messaging: MQTT over TLS
AI: DeepSeek-compatible API with local fallback rules
Email: SMTP over SSL

How to Run

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env
uvicorn main:app --reload --host 127.0.0.1 --port 8000

Open:

User app: http://127.0.0.1:8000/app
Admin: http://127.0.0.1:8000/admin/login
Digital human: http://127.0.0.1:8000/digital-human

Demo Accounts

User: test@example.com / test123
Admin: admin / admin123
Default demo balance: ￥50.00

Demo Flow

Log in as test@example.com.
Select or scan bike B001.
Start a pay-as-you-go ride.
Try Temp Lock and Resume.
End the ride and check the updated balance.
Ask the AI Assistant about bike recommendation, parking, pricing, or out-of-zone warnings.
Open the admin dashboard to review bike status and abnormal records.

Project Structure

main.py              FastAPI routes, ride logic, AI endpoints, admin pages
database.py          SQLite schema, seed data, data access helpers
config.py            Environment configuration
email_service.py     Verification and password reset emails
ai_service.py        DeepSeek-compatible API client and fallback handling
publisher.py         MQTT bike simulator
templates/           User app, admin dashboard, digital human pages
static/              Static assets
QRcode/              Demo QR code assets

Configuration

Copy .env.example to .env and fill in real values only when needed.

DeepSeek: DEEPSEEK_API_KEY, DEEPSEEK_BASE_URL, DEEPSEEK_MODEL
Email: SMTP_SERVER, SMTP_PORT, SMTP_USER, SMTP_PASSWORD
MQTT: MQTT_BROKER, MQTT_PORT, MQTT_USERNAME, MQTT_PASSWORD

The app can run without DeepSeek, SMTP, or MQTT credentials. AI uses local fallback rules, email returns a clear configuration error, and simulated bikes can still be unlocked for local demo.

Demo Rules

Pay-as-you-go: ￥1.50 for the first 15 minutes, then ￥0.50 per started 10-minute block
Day Pass: ￥5.00
Weekly Pass: ￥12.00
Out-of-zone penalty: ￥5.00
Battery drain simulator: BATTERY_DRAIN_SECONDS = 120

Parking areas:

Dorm Area: 18.398164, 110.017937
Teaching Building: 18.400165, 110.015336
Canteen: 18.401972, 110.020223

yanz15/CUH405CMD2526MARJUL

About

Resources

Stars

Watchers

Forks

Releases

Contributors 5

Languages