JAVA旧物回收旧衣家电数码奢侈品书籍的上门回收小程序三端开源系统

1. 项目简介

旧物回收三端开源系统是一套面向旧衣、家电、数码、奢侈品和书籍的上门回收与寄件回收系统，内置 品类估价、预约下单、上门取件、结算打款、福利积分，采用前后端分离架构，服务端、管理端、用户端全套代码开源。

服务端基于 Spring Boot 2.6.11（Java 8）与 MyBatis-Plus 构建，负责接口、数据库，以及短信、对象存储、支付、顺丰寄件等外部能力。
管理端基于 Vue 3 + Element Plus + Vite 开发，供运营人员在电脑浏览器中维护品类价格、订单、取件、结算打款、会员与系统设置。
用户端基于 uni-app（Vue 3） 开发，覆盖 H5 与微信小程序。用户可按品类估价、预约上门或顺丰寄件；回收员可在同一套用户端里查看取件任务并回填成交金额。

2. 移动端界面预览

首页	家电回收	数码估价	奢侈品	回收规则

3. 开源说明

本项目采用 Apache 2.0 许可协议，源码供学习、技术研究、商业使用、二次开发与参考使用。
开源为生态，服务才是根基； 欢迎各位开发者一同交流。

4. 快速开始

建议顺序：先服务端，再管理端，最后用户端。 管理端和用户端都要等服务端已经启动，才能登录和加载数据。

说明： 仓库里不包含 node_modules（体积大、随系统生成）。克隆或下载后，在 jiuwuhuishou-admin 目录下必须先执行一次 npm install，再启动开发命令。用户端用 HBuilderX 打开 jiuwuhuishou-user。详细步骤见下方与 docs 中的运行教程。

application.yml 里当前激活的是 dev。请确认数据源指向本机库，不要改成 prod。配置里 sqx.redis.open 为 false，本地可以先不装 Redis。

4.1 服务端

安装 JDK 8、Maven、MySQL 8。新建数据库 jwhuishou（字符集 utf8mb4），再按版本号从小到大导入 jiuwuhuishou-server/sql 里的 V*.sql。这些脚本只建回收业务表和后续变更，不会自己建库，也不包含一套从零创建管理员、角色、菜单的完整系统库。

application.yml 中 spring.profiles.active 已经是 dev。请按本机环境修改 application-dev.yml 里的数据库账号密码：库名保持 jwhuishou，把占位的「用户名」「密码」改成你自己的。

在 jiuwuhuishou-server 目录执行 Maven 启动。启动类是 com.sqx.SqxApplication。控制台出现「旧物回收项目启动成功…」后，默认 端口 9135，上下文路径 /sqx_fast。接口文档：http://127.0.0.1:9135/sqx_fast/doc.html（Knife4j）。

更完整的模块划分与接口约定见 服务端功能说明。

4.2 管理端

安装 Node.js 18+（见 jiuwuhuishou-admin/package.json 的 engines）。本机联调前，打开 jiuwuhuishou-admin/src/utils/tool.js，把 getApiBaseUrl 里现在写死的线上地址改成 http://127.0.0.1:9135/sqx_fast/。只改 .env.development 不会生效。

进入 jiuwuhuishou-admin 目录，首次运行前安装依赖并启动：

cd jiuwuhuishou-admin
npm install
npm run dev

npm install 会根据 package.json / package-lock.json 在本机生成 node_modules，只需在依赖变更或新克隆后执行。

开发站点默认端口 5176。

演示管理端账号：admin / 123456（登录页注释里的账号；空库只导入 sql 时这个管理员还不存在，以库中数据为准）。

4.3 用户端

HBuilderX（推荐）： 打开 jiuwuhuishou-user 目录，运行到浏览器或微信开发者工具。应用面向旧物回收，底部四个入口：首页、福利中心、订单、我的。

开发时请确认 jiuwuhuishou-user/common/config.js 中的接口地址指向本机或已部署的服务端。文件里现在生效的是线上地址 https://jwhs.xianmxkj.com/sqx_fast。本机联调时，把接口改成 http://127.0.0.1:9135/sqx_fast，WebSocket 改成 ws://127.0.0.1:9135/sqx_fast/。manifest.json 里 H5 开发端口写的是 8852，以 HBuilderX 控制台打印的地址为准。

微信小程序需把 manifest.json 里的 AppId 换成你自己的。短信、微信、支付、对象存储、顺丰等密钥需自行申请，并在管理端相关配置页填写。sqx.verify-code.test-mode 目前是 true，短信验证码固定为 888888。

5. 文档

6. 目录结构

仓库根目录只放三端代码、说明和协议。编译出来的 target、dist、unpackage、node_modules 是运行时生成的，不需要改。

6.1 仓库根目录

6.2 服务端 jiuwuhuishou-server

6.3 管理端 jiuwuhuishou-admin

6.4 用户端 jiuwuhuishou-user

界面组件使用 uView Plus。用户下单和回收员取件都在用户端完成。

7. 核心特性与技术栈

7.1 核心特性

· 底部四个入口：首页、福利中心、订单、我的
· 家电按型号估价，数码和奢侈品按品牌搜索，旧衣和书籍按重量预约
· 履约可选上门回收或顺丰寄件，邮寄单可看运单和物流
· 订单全流程：进行中、待确认、结算确认、价格争议、评价、打款
· 签到领金币、钱包余额、微信或支付宝提现、会员权益、邀请分佣
· 回收员查看取件任务，上门后回填成交金额
· 在线客服、帮助中心、消息通知
· 管理端品类价格、订单、取件、结算打款、福利和系统配置
· 短信验证码、微信登录、在线客服

业务细节见 服务端功能说明 与 Knife4j doc.html。

版本以仓库里的配置文件为准。没写死版本号的，按上文快速开始安装对应大版本即可。

7.2 服务端

7.3 管理端

7.4 用户端