ARTICLE · 1367066
JAVA旧物回收快递上门回收系统源码小程序+公众号+APP+H5
|
旧物回收的线上化,难点不在「下单」这一个动作,而在下单之前:品类估价的口径、用户地址与预约时段、快递还是上门,以及签到、积分与推荐带来的账户变动,都要在同一条订单里对得上。
这套系统的做法是先把用户侧和履约侧的数据固定:分类目录、签到记录、积分流水、地址簿、推荐关系与回收订单各有主数据。用户端负责选品与提交,后台负责估价规则、订单状态与结算口径。
下面按六个功能点讲清用户端与后台怎么衔接,再给七段关键代码,覆盖表结构、分类估价、签到积分、地址校验、推荐结算、多端请求与后台列表。
OVERVIEW / 功能总览
六个模块,串起从分类到履约的一条线
功能点按用户操作顺序展开:先定品类和估价,再由签到与积分形成账户,地址和推荐决定谁能下单、谁来服务,最后落到快递或上门两种履约方式。
|
01精准分类
输入:输入品类名称、上级分类、估价参数项、支持的回收方式与展示排序。
状态:分类有草稿、启用、停用;估价参数按版本保存,停用分类不再进入用户端可选列表。
输出:输出用户端分类导航、估价表单与后台品类清单;已生成订单保留成交时的品类快照。

【旧物回收】实拍 01|首页分类、福利中心与我的订单;截图数据为演示数据
02签到管理
输入:输入签到日期、连续天数、奖励档位与补签规则。
状态:同一用户同一自然日只允许一条有效签到;断签后连续天数重置,补签单独留痕。
输出:输出签到日历、连续奖励进度与待发放奖励;奖励发放与积分入账走同一事务。
03积分管理
输入:输入积分来源、变动值、关联业务单号与账户余额。
状态:签到、下单完成与推荐奖励共用一张流水表;余额以流水为准,兑换按条件更新防超支。
输出:输出积分明细、可用余额与兑换记录;退款或撤销订单时按原流水冲正。

【旧物回收】实拍 02|个人主页、家电回收与品类估价;截图数据为演示数据
04地址管理
输入:输入联系人、手机号、省市区、详细地址与默认标记。
状态:地址可新增、编辑、停用;上门下单前按服务城市校验,超范围只允许快递回收。
输出:输出可选地址列表与预约时段;订单保存成交时的地址快照,后续改址不影响历史履约。
05我的推荐
输入:输入邀请人、被邀请人、绑定时间与奖励规则。
状态:推荐关系只在首次绑定生效,重复扫码与自推荐直接拒绝;奖励按订单完成状态结算。
输出:输出推荐榜单、邀请记录与佣金明细;未完成订单不进入可结算收益。

【旧物回收】实拍 03|估价结算、订单详情与推荐收益;截图数据为演示数据
06支持快递回收和上门回收
输入:输入回收方式、品类估价、预约时段,以及上门地址或快递运单号。
状态:两种通道共用订单状态:待分配、待取件、已取件、待核验、已结算、已取消;快递回收补录运单,上门回收分配回收员。
输出:输出用户端进度追踪与后台履约列表;估价与实付分离,核验后按实际成色结算。
ARCHITECTURE / 三端分工
一套订单主数据,三端各管一段
|
一句话分工:用户端负责选品与提交,后台负责规则维护与履约;能不能下单、按哪种方式回收,由服务端依据分类、地址范围和订单状态共同判断。
CODE / 数据库与核心代码
七段关键代码:从分类参数到回收履约
按「表结构 → 分类估价 → 签到幂等 → 积分流水 → 下单校验 → 多端请求 → 后台列表」给出可落地的示例。
以下均为示例实现,生产环境需补充参数校验、权限、日志、监控、限流、支付验签等。
01六类主数据各自留痕
分类、签到、积分、地址、推荐与订单一旦共表,结算口径就无法追溯。
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分类估价按版本取值
同一品类会随行情调价,用户看到的估价必须能对应到当时的参数版本。
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签到幂等与连续天数
网络重试和跨端同时签到,最容易写出同一天两条奖励。
@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积分流水与推荐结算
签到、下单和推荐都发积分,余额必须以流水为准并防并发超支。
@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回收下单与地址范围校验
上门回收依赖服务城市,快递回收依赖运单,两者不能混成一条分支。
@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 的登录态、错误处理和请求号应保持一致。
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后台订单与积分列表
分类、订单和积分流水要能筛、能管,还要受管理员数据范围限制。
<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 / 写在最后
回收业务看起来只是「下单 + 取件」,真正容易出错的是分类估价、账户变动和履约状态没有对齐。
先把六类数据各自的归属、状态与校验规则放进系统,两种回收方式才能共用一条稳定的订单链路。
需要看完整的品类参数模型或演示下单流程,可以在评论区留言说明你的回收品类。
文中截图均为演示数据,界面与文案随版本可能调整;具体功能以实际交付版本为准。
小程序 · 公众号 · H5














































































