夜雨聆风学习资料网

ARTICLE · 1367066

JAVA旧物回收快递上门回收系统源码小程序+公众号+APP+H5

JAVA旧物回收快递上门回收系统源码小程序+公众号+APP+H5

小程序 · 公众号 · H5

RECYCLING SYSTEM / JAVA

精准分类 · 签到积分 · 地址管理 · 双通道回收

旧物回收系统

分类先定清楚,履约才有依据。

SpringBoot · MyBatisPlus · MySQL

uni-app · Vue + ElementUI  /  小程序 · 公众号 · H5

旧物回收的线上化,难点不在「下单」这一个动作,而在下单之前:品类估价的口径、用户地址与预约时段、快递还是上门,以及签到、积分与推荐带来的账户变动,都要在同一条订单里对得上。

这套系统的做法是先把用户侧和履约侧的数据固定:分类目录、签到记录、积分流水、地址簿、推荐关系与回收订单各有主数据。用户端负责选品与提交,后台负责估价规则、订单状态与结算口径。

下面按六个功能点讲清用户端与后台怎么衔接,再给七段关键代码,覆盖表结构、分类估价、签到积分、地址校验、推荐结算、多端请求与后台列表。

OVERVIEW / 功能总览

六个模块,串起从分类到履约的一条线

功能点按用户操作顺序展开:先定品类和估价,再由签到与积分形成账户,地址和推荐决定谁能下单、谁来服务,最后落到快递或上门两种履约方式。

精准分类

家电、数码、旧衣等分级维护,估价参数按品类配置。

签到管理

连续签到、奖励档位与补签规则统一记录。

积分管理

签到、下单与推荐共用一套积分流水。

地址管理

多地址簿、默认地址与上门服务范围校验。

我的推荐

邀请关系、推荐榜单与佣金明细可追溯。

支持快递回收和上门回收

两种履约通道共用一个订单状态机。

一套订单主数据

分类、签到、积分、地址、推荐与回收订单共用一套归属和状态

01精准分类

输入:输入品类名称、上级分类、估价参数项、支持的回收方式与展示排序。

状态:分类有草稿、启用、停用;估价参数按版本保存,停用分类不再进入用户端可选列表。

输出:输出用户端分类导航、估价表单与后台品类清单;已生成订单保留成交时的品类快照。

【旧物回收】实拍 01|首页分类、福利中心与我的订单;截图数据为演示数据

02签到管理

输入:输入签到日期、连续天数、奖励档位与补签规则。

状态:同一用户同一自然日只允许一条有效签到;断签后连续天数重置,补签单独留痕。

输出:输出签到日历、连续奖励进度与待发放奖励;奖励发放与积分入账走同一事务。

03积分管理

输入:输入积分来源、变动值、关联业务单号与账户余额。

状态:签到、下单完成与推荐奖励共用一张流水表;余额以流水为准,兑换按条件更新防超支。

输出:输出积分明细、可用余额与兑换记录;退款或撤销订单时按原流水冲正。

【旧物回收】实拍 02|个人主页、家电回收与品类估价;截图数据为演示数据

04地址管理

输入:输入联系人、手机号、省市区、详细地址与默认标记。

状态:地址可新增、编辑、停用;上门下单前按服务城市校验,超范围只允许快递回收。

输出:输出可选地址列表与预约时段;订单保存成交时的地址快照,后续改址不影响历史履约。

05我的推荐

输入:输入邀请人、被邀请人、绑定时间与奖励规则。

状态:推荐关系只在首次绑定生效,重复扫码与自推荐直接拒绝;奖励按订单完成状态结算。

输出:输出推荐榜单、邀请记录与佣金明细;未完成订单不进入可结算收益。

【旧物回收】实拍 03|估价结算、订单详情与推荐收益;截图数据为演示数据

06支持快递回收和上门回收

输入:输入回收方式、品类估价、预约时段,以及上门地址或快递运单号。

状态:两种通道共用订单状态:待分配、待取件、已取件、待核验、已结算、已取消;快递回收补录运单,上门回收分配回收员。

输出:输出用户端进度追踪与后台履约列表;估价与实付分离,核验后按实际成色结算。

ARCHITECTURE / 三端分工

一套订单主数据,三端各管一段

端负责什么不该做什么
用户端浏览分类、估价、签到、维护地址并提交回收订单不自行改动估价规则,不绕过服务范围校验
管理后台品类、签到规则、积分流水、地址与订单履约管理不越权查看他人订单,不直接改写账户余额
服务端估价计算、状态流转、积分与推荐结算、权限校验不信任前端提交的价格、积分和回收方式

一句话分工:用户端负责选品与提交,后台负责规则维护与履约;能不能下单、按哪种方式回收,由服务端依据分类、地址范围和订单状态共同判断。

CODE / 数据库与核心代码

七段关键代码:从分类参数到回收履约

按「表结构 → 分类估价 → 签到幂等 → 积分流水 → 下单校验 → 多端请求 → 后台列表」给出可落地的示例。

以下均为示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。

01六类主数据各自留痕

分类、签到、积分、地址、推荐与订单一旦共表,结算口径就无法追溯。

SQL

CREATE TABLE recycle_category (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  parent_id BIGINT NOT NULL DEFAULT 0,  category_name VARCHAR(64) NOT NULL,  status VARCHAR(20) NOT NULL,  version INT NOT NULL DEFAULT 0,  KEY idx_parent_status (parent_id, status));CREATE TABLE category_param (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  category_id BIGINT NOT NULL,  param_version INT NOT NULL,  base_price DECIMAL(10,2) NOT NULL,  param_json VARCHAR(512) NOT NULL,  UNIQUE KEY uk_cat_ver    (category_id, param_version));CREATE TABLE user_signin (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  user_id BIGINT NOT NULL,  sign_date DATE NOT NULL,  streak_days INT NOT NULL,  reward_level INT NOT NULL,  UNIQUE KEY uk_user_date (user_id, sign_date));CREATE TABLE point_ledger (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  user_id BIGINT NOT NULL,  change_value INT NOT NULL,  source_type VARCHAR(24) NOT NULL,  biz_no VARCHAR(48) NOT NULL,  created_at DATETIME NOT NULL,  UNIQUE KEY uk_biz (source_type, biz_no));CREATE TABLE user_address (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  user_id BIGINT NOT NULL,  contact_name VARCHAR(32) NOT NULL,  contact_phone VARCHAR(20) NOT NULL,  city_code VARCHAR(16) NOT NULL,  detail VARCHAR(160) NOT NULL,  is_default TINYINT NOT NULL DEFAULT 0,  status VARCHAR(20) NOT NULL);CREATE TABLE referral_relation (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  inviter_id BIGINT NOT NULL,  invitee_id BIGINT NOT NULL,  bound_at DATETIME NOT NULL,  UNIQUE KEY uk_invitee (invitee_id));CREATE TABLE recycle_order (  id BIGINT PRIMARY KEY AUTO_INCREMENT,  order_no VARCHAR(32) NOT NULL UNIQUE,  request_no VARCHAR(48) NOT NULL UNIQUE,  user_id BIGINT NOT NULL,  category_id BIGINT NOT NULL,  param_version INT NOT NULL,  recycle_type VARCHAR(20) NOT NULL,  status VARCHAR(24) NOT NULL,  estimate_amount DECIMAL(10,2) NOT NULL,  actual_amount DECIMAL(10,2),  address_snapshot VARCHAR(200),  express_no VARCHAR(48),  KEY idx_user_status (user_id, status));

分类估价参数、签到记录、积分流水、地址簿、推荐关系与回收订单分表;关键字段建唯一索引。

02分类估价按版本取值

同一品类会随行情调价,用户看到的估价必须能对应到当时的参数版本。

JAVA

public QuoteDTO quote(CategoryQuoteCmd cmd) {    RecycleCategory cat = categoryMapper        .selectById(cmd.getCategoryId());    Assert.notNull(cat, "分类不存在");    Assert.isTrue(        "ENABLED".equals(cat.getStatus()),        "分类已停用");    CategoryParam param = paramMapper        .selectCurrent(cmd.getCategoryId());    Assert.notNull(param, "估价参数未配置");    BigDecimal amount = ruleService.calc(        param.getBasePrice(),        param.getParamJson(),        cmd.getAnswers());    // 前端金额只作校验,不参与写入    Assert.isTrue(amount.compareTo(        cmd.getClientAmount()) == 0,        "估价已变化,请刷新");    return QuoteDTO.of(        cmd.getCategoryId(),        param.getParamVersion(),        amount);}

服务端按分类与参数版本计算估价,前端提交的金额只作校验不采信。

03签到幂等与连续天数

网络重试和跨端同时签到,最容易写出同一天两条奖励。

JAVA

@Transactional(rollbackFor = Exception.class)public SigninVO signIn(Long userId) {    LocalDate today = LocalDate.now();    UserSignin exist = signinMapper        .selectByUserDate(userId, today);    Assert.isNull(exist, "今日已签到");    // uk_user_date 兜底跨端并发重复签到    UserSignin last = signinMapper        .selectLast(userId);    int streak = last != null        && last.getSignDate()            .plusDays(1).equals(today)        ? last.getStreakDays() + 1 : 1;    int level = rewardRule.levelOf(streak);    UserSignin row = UserSignin.of(        userId, today, streak, level);    signinMapper.insert(row);    pointService.earn(        userId, rewardRule.pointsOf(level),        "SIGNIN", row.getId().toString());    return SigninVO.of(streak, level);}

唯一键锁住用户与日期,连续天数与奖励档位在同事务内更新。

04积分流水与推荐结算

签到、下单和推荐都发积分,余额必须以流水为准并防并发超支。

JAVA

@Transactional(rollbackFor = Exception.class)public void earn(Long userId, int value,        String source, String bizNo) {    // uk_biz 保证同一业务单号只入账一次    ledgerMapper.insert(PointLedger.of(        userId, value, source, bizNo));    int n = pointMapper.addBalance(        userId, value);    Assert.isTrue(n == 1, "积分入账失败");}@Transactional(rollbackFor = Exception.class)public void redeem(Long userId, int cost,        String bizNo) {    ledgerMapper.insert(PointLedger.of(        userId, -cost, "REDEEM", bizNo));    // UPDATE ... WHERE balance >= cost    int n = pointMapper.deduct(        userId, cost);    Assert.isTrue(n == 1, "余额不足");}@Transactional(rollbackFor = Exception.class)public void settleReferral(Long orderId) {    RecycleOrder order = orderMapper        .selectById(orderId);    Assert.isTrue(        "SETTLED".equals(order.getStatus()),        "订单未完成结算");    ReferralRelation rel = relationMapper        .selectByInvitee(order.getUserId());    if (rel == null) return;    earn(rel.getInviterId(),        rule.referralPoints(),        "REFERRAL",        "RO-" + order.getId());}

先写流水再用条件更新扣减余额;推荐奖励按订单完成状态发放并带业务单号幂等。

05回收下单与地址范围校验

上门回收依赖服务城市,快递回收依赖运单,两者不能混成一条分支。

JAVA

@Transactional(rollbackFor = Exception.class)public String create(RecycleOrderCmd cmd) {    // request_no 唯一键保证重复提交返回同一单    RecycleOrder old = orderMapper        .selectByRequestNo(cmd.getRequestNo());    if (old != null) return old.getOrderNo();    QuoteDTO quote = quoteService        .quote(cmd.getQuoteCmd());    boolean pickup = "PICKUP"        .equals(cmd.getRecycleType());    String snapshot = null;    if (pickup) {        UserAddress addr = addressMapper            .selectUsable(cmd.getUserId(),                cmd.getAddressId());        Assert.notNull(addr, "地址不可用");        Assert.isTrue(cityService            .inServiceRange(addr.getCityCode()),            "超范围请改用快递回收");        snapshot = addr.snapshot();    } else {        Assert.hasText(cmd.getExpressNo(),            "请填写运单号");    }    RecycleOrder order = RecycleOrder.of(        cmd, quote, snapshot);    orderMapper.insert(order);    return order.getOrderNo();}

request_no 幂等,校验地址快照与回收方式后写入订单初始状态。

06多端请求统一封装

小程序、公众号和 H5 的登录态、错误处理和请求号应保持一致。

JAVASCRIPT

const newRequestNo = () => {  const time = Date.now().toString(36)  const rand = Math.random()    .toString(36).slice(2, 10)  return `${time}-${rand}`}export function request(options) {  const token = uni.getStorageSync('token')  return new Promise((resolve, reject) => {    uni.request({      url: options.url,      method: options.method || 'GET',      data: options.data || {},      header: {        Authorization: token          ? `Bearer ${token}` : '',        'X-Request-No': options.requestNo          || newRequestNo()      },      success: (res) => {        if (res.statusCode === 401) {          uni.removeStorageSync('token')          uni.reLaunch({            url: '/pages/login/index'          })          reject(new Error('请先登录'))          return        }        if (res.data.code !== 0) {          reject(new Error(res.data.message))          return        }        resolve(res.data.data)      },      fail: reject    })  })}

统一携带令牌与请求号,401 清登录态,业务页面只关心结果对象。

07后台订单与积分列表

分类、订单和积分流水要能筛、能管,还要受管理员数据范围限制。

VUE

<template>  <div>    <el-form :inline="true" :model="query">      <el-input v-model="query.orderNo"        placeholder="订单号" clearable />      <el-select v-model="query.recycleType"        placeholder="回收方式" clearable>        <el-option label="上门回收"          value="PICKUP" />        <el-option label="快递回收"          value="EXPRESS" />      </el-select>      <el-select v-model="query.status"        placeholder="状态" clearable>        <el-option label="待分配"          value="WAIT_ASSIGN" />        <el-option label="待核验"          value="CHECKING" />        <el-option label="已结算"          value="SETTLED" />      </el-select>      <el-button type="primary"        @click="load">查询</el-button>    </el-form>    <el-table :data="rows" v-loading="loading">      <el-table-column prop="orderNo"        label="订单号" />      <el-table-column prop="categoryName"        label="品类" />      <el-table-column prop="typeName"        label="回收方式" />      <el-table-column prop="estimateAmount"        label="预估价" />      <el-table-column prop="pointValue"        label="发放积分" />      <el-table-column prop="statusName"        label="状态" />      <el-table-column label="操作">        <template #default="scope">          <el-button type="text"            v-if="scope.row.canSettle"            @click="settle(scope.row)">            核验结算          </el-button>        </template>      </el-table-column>    </el-table>    <el-pagination :total="total"      layout="total, prev, pager, next"      :page-size="query.size"      :current-page="query.page"      @current-change="load" />  </div></template><script setup>import { reactive, ref, onMounted } from 'vue'import {  getOrders, settleOrder} from '@/api/order'const query = reactive({ page: 1, size: 20 })const rows = ref([])const total = ref(0)const loading = ref(false)async function load(page = 1) {  query.page = page  loading.value = true  try {    const data = await getOrders(query)    rows.value = data.records    total.value = data.total  } finally { loading.value = false }}async function settle(row) {  await settleOrder(row.orderNo)  await load(query.page)}onMounted(() => load())</script>

查询范围在服务端组装;结算与取消按钮只在合法状态出现。

COMPLIANCE / 合规与上线

旧物回收上线,这几条边界要写清

估价与实付要分开。用户端展示的是按品类参数计算的预估价,实际成交以取件核验后的成色为准,调整需留版本和操作记录。

用户地址按最小范围保存。联系人、手机号与详细地址只在履约范围使用,订单完成后按配置脱敏,日志不保存完整地址。

积分与推荐奖励由服务端结算。不能只凭前端上报的签到天数或推荐关系;奖励发放要关联订单完成状态并做幂等控制。

示例不代替外部服务联调。支付、物流面单、消息通知、短信和实名认证需要配置正式服务并完成联调后才能对外使用。

上线前建议逐项打勾

☐ 分类停用后不再进入用户端可选列表☐ 估价参数按版本保存,历史订单留存品类快照☐ 同一用户同一天只允许一条有效签到☐ 签到、下单与推荐共用一张积分流水☐ 地址簿支持默认地址与停用,订单存地址快照☐ 超服务范围只允许快递回收☐ 推荐关系首次绑定生效,自推荐直接拒绝☐ 快递与上门回收共用订单状态机

FIT / 适合谁

适合谁用

适合做家电、数码、旧衣回收的团队,需要把分类估价、上门取件与快递寄件放在同一套订单流程里,并用签到、积分与推荐维持复购。

不太适合只想要一个静态回收报价页、没有实际履约和结算的团队不太适合;系统效果依赖品类参数、服务范围与回收员数据持续维护。

二次开发服务端采用 SpringBoot 与 MyBatisPlus,后台使用 Vue 和 ElementUI,用户端通过 uni-app 发布到小程序、公众号、H5,也便于继续扩展 APP 端。

FAQ / 常见问题

常被问到的五个问题

Q:快递回收和上门回收是两套订单吗?A:不是。两种通道共用一张订单表和同一套状态机,差异只在取件方式、地址或运单信息。

Q:用户看到的价格就是最终结算价吗?A:不是。下单时是按分类参数计算的预估价,取件核验成色后再按实际结果结算,估价与实付分别留痕。

Q:签到和推荐奖励会重复发放吗?A:不会。签到按用户与日期建唯一约束,推荐关系首次绑定生效,奖励发放都带业务单号做幂等。

Q:地址不在服务城市还能下单吗?A:上门回收会被拦截,但可以改用快递寄件;服务端按服务范围校验,不依赖前端判断。

Q:源码包含哪些部分?A:包含 SpringBoot + MyBatisPlus + MySQL 服务端、Vue + ElementUI 后台,以及支持小程序、公众号、H5 的 uni-app 用户端。

LAST / 写在最后

回收业务看起来只是「下单 + 取件」,真正容易出错的是分类估价、账户变动和履约状态没有对齐。

先把六类数据各自的归属、状态与校验规则放进系统,两种回收方式才能共用一条稳定的订单链路。

需要看完整的品类参数模型或演示下单流程,可以在评论区留言说明你的回收品类。

文中截图均为演示数据,界面与文案随版本可能调整;具体功能以实际交付版本为准。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料