专注小程序 / APP 开发,用代码改变生活

获取方案
全国分站 主站首页 北京分站 石家庄分站 唐山分站 保定分站 廊坊分站 沧州分站 郑州分站 邯郸分站

分销小程序开发实战:关系链与佣金结算

小程序开发 2026-11-13 7 阅读 0 点赞 原创

分销小程序的核心不在页面,而在两件事:关系链怎么绑定、佣金怎么算清楚。页面做得再漂亮,如果上下级关系错乱、佣金对不上账,运营三天就会出问题。这篇文章从数据结构、绑定逻辑、佣金计算和结算流程四个部分,讲一套可以直接落地的实现方案。

分销小程序开发实战:关系链与佣金结算

一、先定数据结构,再写页面

分销系统最少需要四张表:用户表、分销关系表、订单表、佣金流水表。关系表不要直接在用户表里加一个 parent_id 就完事,因为后期要支持多级分销、关系变更留痕,单独建表更稳。

// 分销关系表
distribution_relation {
  _id: string,
  userId: string,        // 当前用户
  parentId: string,      // 直接上级
  path: string[],        // 从根到当前的完整链路,如 [A, B, C]
  level: number,         // 层级,1 为直接上级
  bindTime: number,
  source: string         // 绑定来源:分享卡片 / 海报 / 邀请码
}

path 字段是关键,查询某用户的所有下级时不用递归,直接用数组包含查询即可,性能好很多。层级建议控制在三级以内,超过三级的佣金结构在合规和计算复杂度上都不划算。

二、关系绑定的三个约束

绑定逻辑看起来简单,实际最容易出问题。需要明确三条规则:

  • 首次绑定优先:用户第一次通过分享链接进入并完成注册后,关系即锁定,后续再扫别人的码不覆盖。
  • 不能形成环:绑定前检查目标上级的 path 中是否包含当前用户,包含则拒绝,否则会出现自己给自己返佣。
  • 老用户不追溯:已经注册的用户通过分享链接进入,只记录访问来源,不改变已有关系。
async function bindRelation(userId, parentId) {
  if (userId === parentId) return { ok: false, msg: '不能绑定自己' };
  const parent = await db.collection('distribution_relation')
    .where({ userId: parentId }).get();
  if (!parent.data.length) return { ok: false, msg: '上级不存在' };
  const p = parent.data[0];
  if (p.path.includes(userId)) return { ok: false, msg: '关系链成环' };
  const exist = await db.collection('distribution_relation')
    .where({ userId }).get();
  if (exist.data.length) return { ok: false, msg: '已绑定' };
  await db.collection('distribution_relation').add({
    data: {
      userId, parentId,
      path: [...p.path, parentId],
      level: 1,
      bindTime: Date.now(),
      source: 'share_card'
    }
  });
  return { ok: true };
}

这段逻辑建议放在云函数里执行,客户端只传 parentId,避免被篡改。

三、佣金计算:比例配置化

佣金比例不要写死在代码里。运营随时会调整,写死意味着每次改比例都要发版。建一张配置表,按商品或全局设置一级、二级、三级比例,计算时读取。

// 佣金配置
commission_config {
  scope: 'global' | 'product',
  productId?: string,
  rates: [0.10, 0.05, 0.02]   // 一级 10%,二级 5%,三级 2%
}

订单支付成功后触发计算,按买家关系链的 path 倒序取前三级,分别乘以订单实付金额。注意几个细节:

  • 基数用实付金额,不是商品原价,退款时按比例扣回。
  • 佣金先记为「待结算」,过售后期(比如 7 天)再转为「可提现」,避免退款后追不回。
  • 每笔佣金流水记录订单号、受益用户、层级、比例、金额,方便对账。
async function settleCommission(order) {
  const buyerRel = await getRelation(order.buyerId);
  if (!buyerRel) return;
  const chain = buyerRel.path.slice(-3).reverse();
  const rates = await getRates(order.productId);
  for (let i = 0; i < chain.length; i++) {
    const amount = +(order.paidAmount * rates[i]).toFixed(2);
    if (amount <= 0) continue;
    await db.collection('commission_flow').add({
      data: {
        orderId: order._id, userId: chain[i],
        level: i + 1, rate: rates[i], amount,
        status: 'pending', createTime: Date.now()
      }
    });
  }
}

四、结算与提现

结算流程建议做成定时任务加手动触发双通道。定时任务每天扫描售后期已过的待结算流水,批量置为可提现;同时提供后台手动结算入口,处理特殊情况。

提现环节注意三点:金额校验以服务端流水汇总为准,不用客户端传的值;提现申请做幂等,防止重复提交;微信企业付款到零钱需要用户授权,授权状态要单独记录,未授权时引导用户先完成授权再申请。

佣金流水只增不改,状态变更用新记录或状态字段加变更日志,出现纠纷时能完整还原每一笔的来龙去脉。

五、几个工程上的取舍

用云开发做分销小程序,关系查询和佣金计算都放云函数,前端只负责展示和触发。数据量上来后,path 数组查询记得建索引;佣金流水按月归档,避免单集合过大影响查询。分享海报的生成放在云函数里用 canvas 绘制,比客户端生成更稳定,也方便统一加参数。

整套逻辑跑通后,分销小程序剩下的就是运营层面的事:选品、激励节奏、下级激活。技术侧把关系链和钱算清楚,运营才敢放心推。

开发一个小程序到底要花多少钱?微信小程序从零到上线的完整路径

评论 (0)

还没有评论,快来抢沙发吧~

好想法,值得被认真交付

从小程序、APP 到全栈网站,一站式把想法变成可落地的产品

微信咨询

微信扫码,直接沟通需求