BeeX 商品打标系统 · 运营权益与推广佣金配置方案

1为什么要做商品打标

现在 BeeX 展示的商品来自 TikTok、Shopee 等三方平台接口。商品价格、图片、佣金等事实数据不由 BeeX 维护。

但运营需要对部分商品做额外配置:

• 标记“高返”“爆品”“蜜源圈精选”。
• 设置买家看到的商品返现比例。
• 设置平台额外补贴。
• 设置哪些达人推广有佣金。
• 下单后按点击时规则结算。

2核心设计原则

3整体模型

4核心链路

flowchart TD
  A["运营粘贴商品链接"] --> B["后端解析三方商品"]
  B --> C["保存商品权益规则"]
  C --> D["配置展示标签"]
  C --> E["配置推广者佣金"]
  D --> F["商品详情/蜜源圈/高返列表展示"]
  E --> G["达人或用户分享商品"]
  F --> H["用户点击下单"]
  G --> H
  H --> I["生成 affiliate_clicks"]
  I --> J["保存买家权益快照和推广者佣金快照"]
  J --> K["跳转 TikTok/Shopee 下单"]
  K --> L["平台订单回传"]
  L --> M["按点击快照计算收益"]
  M --> N["写 commission_records / wallet pending"]
  

5表设计

5.1 product_promotion_rules

管“买家看到什么权益”。

5.2 product_promotion_rule_tags

管“前端展示什么标签”。标签只影响展示,不直接参与结算。

示例标签:

5.3 product_promotion_promoters

管“谁推广后能拿佣金”。

{
  "product": "商品 A",
  "userCashbackBps": 600,
  "promoter": {
    "promoterType": "USER",
    "promoterRefId": "usr_mars",
    "promoterCommissionBps": 200
  }
}

含义:所有买家看到商品 A 都是 6% 返现;Mars 推广产生订单后,Mars 额外拿 M * 2% 推广佣金。其他达人不拿这笔佣金,除非另有配置。

5.4 product_promotion_rule_audit_logs

管“谁改过规则”。这个表必须有,因为配置会影响钱。

操作类型:CREATE / UPDATE / ENABLE / DISABLE / BUDGET_ADJUST / TIME_ADJUST。

6商品展示逻辑

商品列表仍然来自三方平台。BeeX 在返回给前端前,用 country_code + platform + platform_product_id 匹配生效中的 product_promotion_rules,把推广配置合并到商品展示模型中。

三方平台商品接口
  + BeeX 商品推广规则
  = 前端展示商品

返回给前端时带上 promotion:

{
  "promotion": {
    "ruleId": "ppr_xxx",
    "tags": ["高返", "蜜源圈精选"],
    "userCashbackBps": 600,
    "platformSubsidyType": "FIXED",
    "platformSubsidyMinor": 500000,
    "estimatedCashbackMinor": 685700
  }
}

7收益计算口径

推荐计算口径:

8点击快照

生成转链或点击下单时,在 affiliate_clicks 保存以下字段:

• promotion_rule_id
• promotion_rule_snapshot_json
• promotion_promoter_snapshot_json
• promotion_source

买家权益快照示例:

{
  "ruleId": "ppr_xxx",
  "userCashbackBps": 600,
  "platformSubsidyType": "FIXED",
  "platformSubsidyMinor": 500000,
  "releaseDelayDays": 30,
  "tags": ["高返"]
}

推广者佣金快照示例:

{
  "promoterType": "USER",
  "promoterRefId": "usr_mars",
  "promoterCommissionBps": 200
}

9后台运营流程

1. 运营粘贴商品链接。
2. 系统解析商品,展示商品图、商品名、店铺、价格。
3. 运营配置标签。
4. 运营配置买家返现和平台补贴。
5. 运营配置推广者佣金,可选指定达人。
6. 保存草稿或启用。
7. 商品详情、蜜源圈、高返列表展示生效规则。
8. 用户点击下单时保存快照。
9. 订单回传后按快照结算。

10后台页面

模块名

商品推广配置

列表字段

详情页

• 商品信息。
• 买家权益。
• 展示标签。
• 推广者佣金配置。
• 预算消耗。
• 最近点击。
• 最近订单。
• 操作日志。

11状态设计

12第一版范围

13关键边界说明

相关文档:蜜源圈 · 需求与技术方案 · 活动规则引擎(ECA) · 首页商品列表 → 购买链路