顺风车网约车小程序

本项目为同城出行类系统：同一微信小程序支持乘客端 / 司机端切换；业务上分为顺风车与网约车两条线；配套 Node.js 后端、MySQL 与 Vue3 管理后台。
本地安装、数据库导入、端口与配置请见根目录 安装文档.md，本文只描述功能与目录结构。

---

技术栈概览

端	技术
小程序	微信小程序原生 + Vant Weapp
后端	Node.js + Express
管理后台	Vue3 + Vite + Element Plus + Pinia
数据库	MySQL

---

仓库目录结构

online-car-min/
├── express/                 # 后端服务（API、上传、业务逻辑）
│   ├── bin/                 # 服务入口（端口等）
│   ├── config/              # 数据库、安全配置、小程序参数等
│   ├── controllers/         # 控制器（含 mini 端与 sys 管理端）
│   ├── routes/              # 路由（upload、mini、sys、dashboard 等）
│   ├── public/              # 静态资源（如上传图片目录）
│   ├── scripts/             # 数据库初始化、脚本工具
│   ├── util/                # 工具（鉴权、微信、加解密等）
│   └── app.js               # Express 应用入口
│
├── admin-vue3/              # PC 管理后台（Vue3）
│   ├── src/
│   │   ├── api/             # 封装后端请求
│   │   ├── views/           # 页面（系统管理、驾驶业务、看板等）
│   │   ├── router/          # 路由（含动态菜单挂载）
│   │   ├── stores/          # Pinia 状态
│   │   └── components/      # 公共组件
│   └── vite.config.*        # 构建配置
│
├── min/                     # 微信小程序源码
│   ├── pages/               # 页面（首页、个人中心、顺风车、网约车等）
│   ├── components/          # 业务组件（如司机首页模块）
│   ├── utils/               # 请求封装、订单状态、时间格式化等
│   └── app.json / app.js    # 全局配置与逻辑
│
├── online_car.sql           # MySQL 库表及初始化数据（主脚本）
├── init-database.bat        # Windows 下辅助导入数据库（可选）
├── 安装文档.md              # 环境要求与运行步骤（必读）
├── 小程序参数获取方法.png    # 小程序 AppID/AppSecret 获取示意（如有）
└── README.md                # 本文件（功能与结构说明）

---

一、微信小程序 · 功能说明

1. 账号与登录

• 支持 微信登录（wx.login + 后端换取会话，下发 Token）。
• 请求层支持 Token 失效后自动刷新（减少用户反复登录）。
• 未登录访问需鉴权页面时，跳转登录流程（逻辑以各页 onShow 为准）。

2. 个人中心与资料

• 个人中心：展示昵称/手机等信息；乘客 / 司机模式切换（司机需审核通过才可切司机端）。
• 资料编辑：姓名、手机、邮箱等；保存后同步本地缓存与 globalData，便于首页等刷新展示。
• 头像：支持选图上传并写入用户 avatar，与个人资料联动。

3. 地址管理

• 地址 列表（含默认地址逻辑）。
• 地址 新增 / 编辑 / 删除，供下单时选用（起点/终点与地图选点等，以页面实现为准）。

4. 司机入驻与审核

• 提交资料：真实姓名、身份证、车牌、车辆信息、证件与车辆 图片上传等；手机号与资料校验（需先在个人资料中完善手机）。
• 审核状态页：未提交 / 待审核 / 通过 / 驳回及原因；驳回后可按引导重新提交。
• 审核通过后，方可使用 司机端接单相关能力。

5. 顺风车（乘客）

• 创建订单：起终点、计划出发、座位等（以当前下单页字段为准）；费用预估。
• 我的订单：列表进入 订单详情（乘客视角）。
• 订单详情：行程与费用展示（乘客侧费用口径：不展示平台抽成，仅展示应付/实付类信息）；联系司机（若后端返回电话）；取消订单（在允许状态下）。

6. 顺风车（司机）

• 工作台首页：顺风车 / 网约车 分模块入口（待接、进行中、已完成、认证与个人中心等）。
• 待接单 / 进行中 / 已完成列表：卡片化 UI；可进入 订单详情。
• 接单 / 完成行程 / 取消：在列表或详情中操作（进行中可取消时，订单按业务规则回到待接池等，以后端为准）。
• 司机侧费用展示：以司机到手/净收入等口径为主（与乘客支付拆分展示）。
• 顺风车司机端允许多笔进行中订单（与网约车限制不同）。

7. 网约车（乘客）

• 叫车下单：起终点、费用预估；我的订单与 订单详情（乘客视角）。
• 订单详情：司机评分、电话、联系司机；取消（允许状态下）；费用明细按乘客口径展示。

8. 网约车（司机）

• 待接单 / 进行中 / 已完成列表与 订单详情（司机视角）。
• 接单：受 「同时仅允许一笔进行中网约车订单」 等业务规则约束（后端强校验）。
• 完成行程：二次确认后完成订单。
• 取消进行中订单：按规则回到待接大厅等（以后端为准）。
• 列表与详情中展示 司机到手 等费用信息。

9. 评价（小程序侧规则）

• 乘客对司机提交评价：多维度星级 + 文字；支持对已评价订单 查看历史评价（只读）。
• 司机侧提供 「收到的评价」（乘客对司机的评分与留言；列表按顺风车/网约车分类展示）。
• 管理端仍可保留更全的评价数据能力；小程序端以产品当前实现为准。

---

二、PC 管理后台 · 功能说明

（菜单可能由数据库动态下发，下列为代码中已提供的主要业务能力。）

1. 登录与权限

• 管理员 账号密码登录，Token 存储与请求拦截。
• 用户 / 角色 / 菜单 等系统管理能力（以 views/system 与后端菜单数据为准）。

2. 数据看板

• Dashboard：运营数据统计展示（订单、用户等维度，以后端接口与页面为准）。

3. 用户与系统

• 用户管理：列表、查询、状态维护等。
• 角色 / 菜单：权限与菜单配置。

4. 司机审核

• 司机申请 列表 / 详情（资料与证件图片）。
• 通过 / 驳回（驳回原因）；与小程序司机入驻流程联动。

5. 订单管理

• 网约车订单、顺风车订单 分业务查看列表。
• 支持按状态等筛选；订单详情（含费用 JSON 明细解析展示、关联 评价列表 等）。
• 支持管理端 取消订单（在业务允许状态下）。

6. 评价管理

• 低分筛查：按业务类型（网约车/顺风车）、分数阈值（四维均分 ≤ 阈值）拉取评价列表。
• 标记：对单条评价填写 标记原因 等运维字段；列表中展示标记状态与处理时间。
• 评价时间等字段在界面中做 格式化展示。

7. 系统配置

• 系统参数 / 配置项 维护（计费、业务开关等，以 ConfigManage 与数据库表为准）。

8. 个人中心（后台用户）

• 当前登录管理员 资料 / 密码 等（以 userCenterMange 等页面为准）。

---

三、后端服务 · 功能模块（接口层面）

以下按路由前缀归纳，便于与 express/routes 对照：

模块	说明
/api/upload	图片上传（如证件、头像、车辆图等），按 bucket 分子目录存储
/api/mini/user	小程序用户：微信登录、资料查询与更新等
/api/mini/address	小程序收货/上车地址 CRUD
/api/mini/driver	司机入驻提交、审核状态查询
/api/mini/carpool	顺风车：订单、费用预估、司机/乘客列表、详情、状态流转、评价等
/api/mini/ride	网约车：同上（含司机并发接单限制等逻辑）
/api/sys/user 等	管理端用户、角色、菜单等
/api/dashboard	管理端统计数据
/api/sys/driver	管理端司机审核
/api/sys/order	管理端订单（网约车/顺风车）
/api/sys/config	系统配置
/api/sys/review	管理端评价筛查与标记

具体 URL 与参数以 express/routes 与各 controllers 为准。

---

四、数据库

• 主脚本：online_car.sql（库表结构及初始化数据）。
• 若使用脚本增量迁移，以 express/scripts 下脚本说明为准。

---

五、相关文档

文件	内容
安装文档.md	环境要求、数据库导入、后端/管理端/小程序配置与启动步骤
帖子文案.md	对外发布用简短文案（若有）

---

声明

本项目用于学习、计算机设计或二次开发参考；上线前请自行完成域名、HTTPS、小程序合法域名、隐私合规与支付/资质等合规项。功能以当前仓库代码为准，若与旧版 README 或宣传文案不一致，以代码与 安装文档.md 为准。