功能文档汇总

# 41-校园跑腿系统 - 功能说明

# 项目概述

校园跑腿系统是一个集跑腿服务、在线商城、配送管理于一体的综合性Web应用系统。采用前后端分离架构,基于Vue 3和Spring Boot技术栈,为校园师生提供便捷的跑腿代办服务和商品购物体验。系统支持用户发布跑腿任务、跑腿员接单配送、商家发布商品、在线下单购物等全流程服务。

# 项目概览

# ✨ 创新点

# 1. 多角色协同体系

  • 四级角色设计:普通用户、商家、跑腿员、管理员四级角色,各司其职。
  • 跑腿员管理:独立的跑腿员审核、工作状态管理、收益结算系统。
  • 双重身份:用户既可以发布跑腿任务,也可以申请成为跑腿员接单赚钱。

# 2. 跑腿服务创新模式

  • 多样化服务类型:代取快递、代买商品、文件配送、其他跑腿等多种服务。
  • 双向发布机制:普通用户和商家都可以发布跑腿任务,满足不同场景需求。
  • 智能订单匹配:跑腿员可查看待接单任务,自主选择接单,提高效率。
  • 全程状态跟踪:待接单→已接单→取货中→配送中→已完成,状态实时更新。

# 3. 商城跑腿一体化

  • 商品下单自动生成跑腿订单:用户购买商品后,商家可为订单发起跑腿配送请求。
  • O2O闭环服务:线上下单、线下配送、实时跟踪、在线评价形成完整闭环。
  • 收益分成机制:跑腿员完成订单获得服务费,余额实时结算。

# 4. 智能化数据管理

  • 订单号自动生成:跑腿订单(ER前缀)、商品订单(PO前缀)自动生成唯一订单号。
  • 距离计费:支持根据距离(公里)自动计算服务费。
  • 余额系统:用户余额支付、跑腿员收益结算、商家账户管理统一管理。
  • 评价体系:跑腿订单评价、商品订单评价双重评价系统。

# 5. 技术架构先进性

  • 前后端分离:清晰的职责划分,Vue 3前端+Spring Boot后端。
  • JWT认证:基于Token的无状态认证,安全高效。
  • 富文本编辑:支持商品详情、文章内容的富文本编辑与展示。
  • 响应式布局:Element Plus组件库,适配多端设备。

# ✨ 项目亮点

# 一、业务功能亮点

  1. 完整的跑腿服务闭环:从任务发布、跑腿员接单、配送跟踪到订单评价,流程完整。
  2. 商城+跑腿双轮驱动:商城提供商品购买,跑腿提供配送服务,互相促进。
  3. 灵活的收益模式:跑腿员通过接单获得服务费,自由工作赚取收益。
  4. 多场景适配:快递代取、商品代购、文件配送、紧急跑腿等多种校园场景。
  5. 实时状态管理:跑腿员工作状态(在线/离线/忙碌)实时更新,订单状态实时同步。

# 二、技术实现亮点

  1. 现代化前端技术栈:Vue 3.4 + Element Plus 2.8 + Vite 5.3,开发高效体验流畅。
  2. 稳定可靠的后端架构:Spring Boot 3.2 + MyBatis 3.0,构建稳健后端服务。
  3. 完善的数据库设计:17张核心表,utf8mb4字符集,支持完整业务流程。
  4. 安全性设计:JWT Token认证、密码加密存储、接口权限控制。
  5. 文件上传管理:支持图片上传、多图展示、文件哈希存储。

# 三、用户体验亮点

  1. 三端界面设计:
    • 前台:水平导航,简洁直观,适合用户浏览购物。
    • 管理后台:侧边导航,功能集中,高效管理。
    • 跑腿员端:专属界面,订单管理、收益查看一目了然。
  2. 交互优化:
    • 实时消息提示。
    • 订单状态实时更新。
    • 评价系统星级评分。
    • 地址选择便捷管理。
  3. 数据可视化:管理后台提供统计报表,数据可视化展示。
  4. 移动端适配:响应式设计,支持手机、平板等多端访问。

# 管理员

# 系统管理

管理员管理:管理全部管理员账号,支持新增、编辑、删除、启用/禁用操作。

普通用户管理:管理全部用户账号,可修改用户信息、余额、状态,支持重置密码。

商家管理:管理全部商家店铺,包括店铺信息、账号管理、资质审核、启用/禁用。

跑腿员管理:管理跑腿员注册申请,审核身份证信息,管理工作状态、接单统计、余额查看。

# 商城管理

商品分类管理:管理商品分类(前菜、主菜、海鲜、甜点、饮品、小吃等),支持新增、编辑、删除。

商品管理:管理全部商品信息,支持新增、编辑、删除、库存管理、销量统计。

收货地址管理:管理全部用户的收货地址,可查看、编辑、删除地址信息。

商品订单管理:管理全部商品订单,可进行状态扭转(待配送→已完成),查看订单详情。

商品收藏管理:查看用户收藏的商品记录,可删除收藏记录。

商品浏览历史:查看用户浏览商品的历史记录,支持数据分析。

商品订单评价:查看用户对商品订单的评价内容和评分。

店铺收藏管理:查看用户收藏的店铺记录。

# 跑腿服务管理

跑腿订单管理:管理全部跑腿订单(用户发布+商家发布),查看订单详情、状态、跑腿员信息。

跑腿订单评价:查看用户对跑腿服务的评价内容和评分,监控服务质量。

# 内容管理

轮播图管理:管理首页轮播图,设置标题、图片、跳转链接、排序。

广告位管理:管理广告位内容,设置位置、标题、链接、封面图、排序。

文章管理:发布和管理系统公告、新闻资讯等文章内容。

文章评论管理:管理用户对文章的评论内容。

公告管理:发布系统公告通知。

# 商家

# 商品管理

商品发布:发布自己店铺的商品,设置商品名称、分类、价格、库存、封面图、详情图、简介。

商品编辑:修改商品信息、调整价格、更新库存、上下架管理。

商品订单:查看本店商品订单,处理订单状态(待配送→已完成)。

# 跑腿服务

发布跑腿任务:商家可发布跑腿任务(例如商品配送到用户),填写取货地址、送达地址、物品描述、服务费。

跑腿订单管理:查看本店发布的跑腿订单,跟踪配送状态。

跑腿订单评价:查看用户对配送服务的评价。

# 店铺管理

店铺信息:管理店铺基本信息(名称、头像、电话、邮箱、资质图片)。

修改密码:修改登录密码。

# 跑腿员

# 申请入驻

跑腿员申请:填写用户名、昵称、密码、联系电话、身份证号,上传头像,提交审核。

# 订单管理

待接订单:浏览所有待接单的跑腿任务,查看取货地址、送达地址、服务费、距离等信息。

接单操作:选择合适的订单点击接单,订单状态变为"已接单"。

订单处理:

  • 已接单→取货中(到达取货地点,点击"已取货")
  • 取货中→配送中(开始配送,系统自动更新状态)
  • 配送中→已完成(送达目的地,点击"完成订单")

我的订单:查看自己接单的所有订单,按状态筛选(已接单/取货中/配送中/已完成)。

# 收益管理

收益查看:查看账户余额、总接单量、已完成订单量、累计收益。

收益明细:查看每笔订单的服务费收入明细。

提现功能:将账户余额提现(需对接支付功能)。

# 工作状态

状态切换:切换工作状态(在线/离线/忙碌),在线状态才能接单。

# 评价管理

查看评价:查看用户对自己配送服务的评价和评分,了解服务质量。

# 个人中心

个人信息:修改个人信息(昵称、头像、联系电话)。

修改密码:修改登录密码。

# 普通用户

# 跑腿服务

发布跑腿任务:

  • 选择服务类型(代取快递/代买商品/文件配送/其他跑腿)
  • 填写取货地址、取货联系人、取货电话
  • 填写送达地址、收货联系人、收货电话
  • 填写物品描述、备注信息、设置服务费
  • 提交发布,生成跑腿订单

我的跑腿订单:

  • 查看自己发布的跑腿订单
  • 实时查看订单状态(待接单/已接单/取货中/配送中/已完成/已取消)
  • 查看跑腿员信息(姓名、电话、接单时间)
  • 取消订单(仅待接单状态可取消)

跑腿订单评价:订单完成后,对跑腿员服务进行评价(评分+文字评价)。

# 商城购物

商品浏览:

  • 首页浏览轮播图、广告位推荐商品
  • 按分类浏览商品(前菜、主菜、海鲜、甜点、饮品、小吃等)
  • 按店铺浏览商品
  • 搜索商品

商品详情:查看商品详细信息、价格、库存、详情图、用户评价。

购物车:

  • 添加商品到购物车
  • 修改商品数量
  • 删除购物车商品
  • 批量下单

下单购物:

  • 选择收货地址
  • 确认订单信息(商品、数量、总金额)
  • 使用余额支付
  • 提交订单

商品订单:

  • 查看订单状态(待配送/已完成)
  • 查看订单详情(商品信息、收货地址、骑手信息)
  • 确认收货

商品订单评价:订单完成后,对商品和配送进行评价(评分+文字评价)。

# 个人中心

收货地址:管理收货地址,支持新增、编辑、删除地址(下单购物必须要有收货地址)。

商品收藏:收藏喜欢的商品,方便下次快速查找。

浏览历史:查看商品浏览历史记录。

店铺收藏:收藏喜欢的店铺,关注店铺动态。

个人信息:修改个人信息(用户名、昵称、头像、电话、邮箱)。

修改密码:修改登录密码。

余额管理:查看账户余额、充值余额(当前需联系管理员充值)。

# 社区内容

文章浏览:浏览系统公告、新闻资讯等文章内容。

文章评论:对文章发表评论,与其他用户互动。

申请成为跑腿员:填写申请信息,提交审核,成为跑腿员赚取收益。

# 功能权限对照表

功能模块 管理员 商家 跑腿员 普通用户
首页 ✓ - ✓ ✓
管理员管理 ✓ - - -
用户管理 ✓ - - -
商家管理 ✓ - - -
跑腿员管理 ✓ - - -
商品分类管理 ✓ - - -
商品管理(全部) ✓ - - -
商品管理(本店) - ✓ - -
商品浏览购买 - - - ✓
购物车 - - - ✓
收货地址管理(全部) ✓ - - -
收货地址管理(个人) - - - ✓
商品订单管理(全部) ✓ - - -
商品订单管理(本店) - ✓ - -
商品订单管理(个人) - - - ✓
商品收藏 ✓(查看全部) - - ✓(仅自己的)
浏览历史 ✓(查看全部) - - ✓(仅自己的)
店铺收藏 ✓(查看全部) - - ✓(仅自己的)
发布跑腿任务 - ✓ - ✓
跑腿订单管理(全部) ✓ - - -
跑腿订单管理(本店发布) - ✓ - -
跑腿订单管理(个人发布) - - - ✓
跑腿员接单 - - ✓ -
跑腿员订单管理 - - ✓ -
跑腿员收益 - - ✓ -
跑腿订单评价(查看全部) ✓ - - -
跑腿订单评价(发布) - - - ✓
跑腿订单评价(查看自己的) - - ✓ -
轮播图管理 ✓ - - -
广告位管理 ✓ - - -
文章管理 ✓ - - -
文章浏览 - - - ✓
文章评论管理 ✓ - - -
公告管理 ✓ - - -

# 订单状态说明

# 跑腿订单状态

  • 待接单:用户/商家发布任务,等待跑腿员接单
  • 已接单:跑腿员已接单,准备前往取货地点
  • 取货中:跑腿员已到达取货地点,正在取货
  • 配送中:已取货,正在配送至目的地
  • 已完成:配送完成,订单结束
  • 已取消:用户取消订单(仅待接单状态可取消)

# 商品订单状态

  • 待配送:订单已创建并支付,等待配送
  • 已完成:配送完成,交易结束

# 默认账号

# 管理员

用户名: admin
密码: 123456
1
2

# 测试用户

用户名: user1
密码: 123456
余额: 9317元
1
2
3

# 测试商家

用户名: shop1
密码: 123456
店铺: 幸福西饼
1
2
3

# 测试跑腿员

用户名: runner001
密码: 123456
昵称: 小张跑腿
状态: 已审核/在线
余额: 608.76元
总接单量: 31单
已完成: 28单
评分: 4.85
1
2
3
4
5
6
7
8

# 核心业务流程

# 用户注册流程

1. 填写注册信息(用户名、密码、昵称、邮箱)
2. 系统创建用户账号(初始余额0元、状态启用)
3. 跳转到登录页
1
2
3

# 用户发布跑腿任务流程

1. 进入"发布跑腿任务"页面
2. 选择服务类型(代取快递/代买商品/文件配送/其他跑腿)
3. 填写取货信息(地址、联系人、电话)
4. 填写送达信息(地址、联系人、电话)
5. 填写物品描述、备注、服务费
6. 提交发布,生成订单号(ER+时间戳),状态:待接单
7. 跑腿员浏览订单→接单→取货→配送→完成
8. 用户收到物品,订单完成
9. 用户评价跑腿员服务
1
2
3
4
5
6
7
8
9

# 商家发布跑腿任务流程

1. 商家接到商品订单
2. 进入"发布跑腿任务"页面
3. 填写取货信息(店铺地址、商家联系方式)
4. 填写送达信息(用户收货地址、联系方式)
5. 填写商品描述、服务费
6. 提交发布,跑腿员接单配送
7. 配送完成,商家可查看评价
1
2
3
4
5
6
7

# 跑腿员接单配送流程

1. 跑腿员切换状态为"在线"
2. 浏览待接订单列表,查看任务详情(取货地址、送达地址、服务费、距离)
3. 选择合适订单,点击"接单"(状态:已接单)
4. 前往取货地点,点击"已取货"(状态:取货中)
5. 开始配送至目的地(状态:配送中)
6. 到达目的地,点击"完成订单"(状态:已完成)
7. 服务费自动结算到跑腿员账户余额
8. 跑腿员接单量+1,完成订单量+1
1
2
3
4
5
6
7
8

# 购买商品流程

1. 浏览商品列表→查看商品详情
2. 点击"加入购物车"或"立即购买"
3. 选择收货地址(如无地址需先添加)
4. 确认订单信息(商品、数量、总金额)
5. 使用余额支付
6. 扣减余额、扣减库存、增加销量
7. 生成商品订单(订单号:PO+时间戳,状态:待配送)
8. 商家可发起跑腿配送
9. 配送完成(状态:已完成)
10. 用户评价商品和服务
1
2
3
4
5
6
7
8
9
10

# 申请成为跑腿员流程

1. 进入"申请成为跑腿员"页面
2. 填写用户名、昵称、密码
3. 填写联系电话、身份证号
4. 上传头像
5. 提交申请(状态:待审核)
6. 管理员审核(审核通过/拒绝)
7. 审核通过后,账号状态变为"已审核"
8. 跑腿员可登录系统,切换工作状态开始接单
1
2
3
4
5
6
7
8

# 技术说明

# 系统架构

  • 前端:Vue 3.4.29 + Element Plus 2.8.4 + Vite 5.3.1
  • 后端:Spring Boot 3.2.10 + MyBatis 3.0.4
  • 数据库:MySQL 5.7+
  • 认证:JWT Token

# 访问地址

  • 后端API:http://localhost:1000
  • 前端页面:http://localhost:5173(开发环境)

# 数据库

  • 数据库名:campus_errand_system
  • 字符集:utf8mb4
  • 总表数:17张表

# 核心表说明

  • admin:管理员表
  • user:普通用户表
  • shop:商家店铺表
  • errand_runner:跑腿员表
  • errand_order:跑腿订单表
  • errand_order_evaluate:跑腿订单评价表
  • product:商品信息表
  • product_type:商品分类表
  • product_order:商品订单表
  • product_order_evaluate:商品订单评价表
  • shopping_cart:购物车表
  • shipping_address:收货地址表
  • product_collect:商品收藏表
  • product_browsing_history:商品浏览历史表
  • shop_collect:店铺收藏表
  • slideshow:轮播图表
  • advertising:广告位表

# 系统特色

# 跑腿服务特色

  • 灵活的服务类型:代取快递、代买商品、文件配送、其他跑腿,满足多种场景需求
  • 双向发布机制:用户和商家都可以发布跑腿任务
  • 智能订单匹配:跑腿员自主选择订单,提高接单效率
  • 实时状态跟踪:待接单→已接单→取货中→配送中→已完成,全程可视化
  • 收益实时结算:完成订单立即结算服务费到账户余额
  • 工作状态管理:在线/离线/忙碌状态切换,灵活工作

# 商城系统特色

  • 丰富的商品分类:前菜、主菜、海鲜、素食、汤类、甜点、饮品、小吃、米饭类、地方特色
  • 购物车功能:支持批量下单,提升购物体验
  • 收货地址管理:多地址管理,快速选择
  • 商品收藏:收藏喜欢的商品和店铺
  • 浏览历史:记录浏览轨迹,方便回溯
  • 评价系统:星级评分+文字评价,提升服务质量

# 数据统计特色

  • 跑腿员数据统计:总接单量、已完成订单量、账户余额、平均评分
  • 商品销量统计:销量排行、库存预警
  • 订单数据分析:订单量统计、收益分析
  • 用户行为分析:浏览历史、收藏数据

# 内容运营特色

  • 轮播图管理:首页轮播展示,支持跳转链接
  • 广告位管理:多位置广告投放,精准营销
  • 文章系统:发布公告、新闻资讯,与用户互动
  • 评论功能:文章评论,增强用户粘性

# 项目优势

# 1. 解决校园痛点

  • 快递代取:解决上课时间无法取快递的问题
  • 商品代购:帮助行动不便的同学购买商品
  • 文件配送:紧急文件快速送达
  • 校园兼职:为学生提供灵活的兼职赚钱机会

# 2. 商业模式创新

  • 平台不抽成:跑腿员获得全额服务费,激励接单
  • 双向需求:用户发布任务,跑腿员接单,商家发布配送,三方共赢
  • 余额系统:方便快捷的支付结算

# 3. 技术实现完善

  • 前后端分离:开发效率高,维护方便
  • 响应式设计:适配手机、平板、电脑
  • 安全认证:JWT Token,保障账户安全
  • 数据库设计规范:17张表,关系清晰,数据完整

# 4. 用户体验优秀

  • 操作简单:界面清晰,流程顺畅
  • 实时反馈:状态实时更新,消息及时提示
  • 多端适配:手机端、PC端都能流畅使用
  • 评价透明:用户评价公开,促进服务质量提升
Java导航网   |