🚀 福U跑腿 - 校园跑腿服务平台

⚠️⚠️⚠️注意：fork、转载或二次开发请注明原作者⚠️⚠️⚠️

❤️❤️❤️如用于毕业设计、答辩等用途，下方联系作者❤️❤️❤️

📢 项目声明

• 本项目仅用于学习交流目的，不在任何平台出售，如有发现请积极举报
• 本项目是一个全栈项目，包含完整的前后端实现
• 如果本项目对您有所帮助，欢迎给个 ⭐ Star 支持

📚 技术栈

后端技术栈

技术	说明	版本	官网
Spring Boot	容器+MVC框架	2.7.6	https://spring.io/projects/spring-boot
Sa-Token	权限认证框架	1.37.0	https://sa-token.dev33.cn
MyBatis-Plus	ORM框架	3.5.4	https://mybatis.org
Redis	分布式缓存	最新	https://redis.io
MySQL	关系型数据库	8.0	https://www.mysql.com
Redisson	分布式锁	3.20.1	https://redisson.org
Netty	网络应用框架	4.1.36	https://netty.io

前端技术栈

技术	说明	版本	官网
Vue	前端框架	3.x	https://vuejs.org
Ant Design Pro	后台UI框架	4.x	https://pro.ant.design
Uni-app	跨平台框架	3.x	https://uniapp.dcloud.io

🎯 项目简介

福U跑腿是一款专注于校园场景的综合性跑腿服务平台，采用前后端分离架构，基于 Spring Boot + Vue + Uni-app 开发。本项目致力于解决校园内快递代取、餐食代购等日常跑腿需求，为校园师生提供便捷、安全、高效的跑腿服务。

项目结构

福U跑腿项目/
├── deployment/                # 服务器部署
│
├── docImgs/                   # 系统图例展示
│
├── fuu-fun/                   # 后端服务
│   ├── fuu-admin/   		   # 服务入口模块
│   ├── fuu-common/   		   # 通用工具模块
│   ├── fuu-framework/   	   # 框架模块
│   ├── fuu-order/   		   # 跑腿订单模块
│   ├── fuu-oss/   		       # OSS管理模块
│   ├── fuu-payment/   		   # 支付模块
│   ├── fuu-system/   		   # 系统管理模块
│   └── pom.xml                # 父pom文件
│
├── fuu-fun-admin/             # 管理端前端 (Antd-Pro)
│   ├── config/                # 配置文件
│   ├── public/                # 静态资源
│   ├── src/                   # 源代码
│   └── ...                    # 其他配置文件
│
├── fuu-fun-uni/               # 小程序端 (uniapp)
│   ├── common/           	   # 公共模块
│   ├── pages/                 # 页面目录
│   ├── static/                # 静态文件
│   └── ...                    # 其他配置文件
│
└── init.sql                   # 数据库初始化脚本

核心功能

🔴用户服务

• 多角色系统：管理员、校区代理、跑腿员、普通用户
• 地址管理：支持快捷选址、地图选点
• 申请跑腿：审核通过可在线接单
• 在线下/接单：绑定手机号就可以进行下单
• 订单申诉：对异议订单申诉通过可全额退款
• 实时沟通：订单内可与跑腿员、管理员在线沟通
• 敏感词检测：对编辑内容进行敏感词检测
• 微信订阅消息：订单状态、消息通知、退款状态变更时在微信内通知用户

🟠订单系统

• 订单自动化机制：长时间未付款、未接单自动取消，长时间未确认自动完成订单
• 订单全生命周期管理

🟡支付系统

• 集成微信支付
• 余额提现功能
• 资金流动记录

🟢运营管理

• 多校区统一管理
• 系统管理：系统监控、轮播图管理、全局配置
• 区域管理（用于快捷地址）
• 用户、权限管理
• 工单处理：跑腿申请管理、订单申诉管理
• 邮箱通知：有新工单时会邮箱通知
• 标签管理（快捷选择服务类型）
• OSS对象存储管理
• 资金管理：余额管理、提现申请、资金流动、账户明细

技术亮点

🔴模块化架构设计

• 基于 Spring Boot 的多模块开发，采用父子 POM 结构
• 模块间低耦合高内聚，便于维护和扩展
• 统一的依赖管理和版本控制
• 模块化的业务划分，包括订单、支付、系统管理等核心模块

🟠高并发

• 基于 Redisson 实现分布式锁，保证订单接单等关键操作的并发安全
• Redis 队列实现异步任务处理机制：
  • 支付和退款回调的异步处理
  • 订单超时自动取消机制
  • 订单自动完成处理
• 基于 Redisson 对 Redis队列进行封装，降低编码维护成本，提高可用性

🟡安全性与权限控制

• 基于 Sa-Token 实现 RBAC 权限控制系统
• 基于 AOP、自定义注解和 Redis 实现接口限流
• 全局异常处理，统一异常响应

🟢实时通信

• 基于 Netty 实现 WebSocket 服务，支持超高并发
• 用户聊天消息异步持久化处理

🟣数据验证与安全处理

• 自定义注解与 Validator 实现字段校验
• 整合 SensitiveWord 实现敏感词过滤
• 数据字段防止XSS攻击

🎯 项目展示（仅展示部分，其他在docImgs里查看）

小程序端界面

管理后台界面

🚀 快速开始

准备工作

• 申请高德地图 API Key
• 申请微信小程序（个体户/公司）
• 小程序认证（个体户30￥）
• 开通微信支付
• 购买OSS对象存储（建议阿里云OSS）

后端部署

环境要求

• JDK 1.8+
• Spring Boot 2.7.6
• MySQL 8.X
• Redis

配置步骤

1. 克隆项目到本地
2. 创建数据库 fuudb
3. 执行 init.sql 初始化数据库
4. 配置 application.yml：
   • 高德地图 API Key
   • 微信小程序配置
   • 微信支付配置
   • OSS 存储配置
5. 导入支付密钥文件至 recourse/cert/ 目录
6. 构建并运行项目

前端部署

小程序端

• 环境要求：

  • Node.js 16.13.1
  • npm 8.1.2

• 开发工具：

  • HBuilder X
  • 微信开发者工具

• 部署步骤：

  1. 使用 HBuilder X 打开 fuu-run-uni
  2. 配置微信小程序 AppID
  3. 安装依赖：npm install
  4. 运行到微信开发者工具

管理后台

• 环境要求：

  • Node.js 16.13.1
  • npm 8.1.2

• 开发工具：VSCode

• 部署步骤：

  1. 打开 fuu-run-admin
  2. 安装依赖：npm install
  3. 启动开发服务器：npm run start:dev

🚀 服务器部署

​ 前往deployment查看

• 快速部署服务器（github）
• 快速部署服务器（gitee）

🌝 小程序体验

🙏 特别鸣谢

• Ant Design Pro - 开箱即用的中台前端/设计解决方案

• RuoYi-Vue - 基于SpringBoot的权限管理系统

• SensitiveWord - 基于 DFA 算法的敏感词过滤工具

• Sa-Token - 轻量级 Java 权限认证框架

🛠️ 技术支持

如有任何问题，请联系客服微信：Tao_Bliess

---

感谢您的使用！如果觉得项目不错，请给个 ⭐ Star 支持！