BeeX product domain

商品类型与活动商品登记方案

统一商品列表、详情、搜索、蜜源圈和 BeeX 活动商品管理入口的分类口径。类型描述商品业务属性，不描述它出现在哪个页面。

v1.12026-07-15产品 / 前端 / 后端 / 运营

先说清楚三个概念

01 / CONCEPT

productType商品此刻在 BeeX 的返佣与运营属性，是 C 端统一使用的分类结果。

source数据来自哪个平台接口、缓存或任务，只用于排查，不等于商品类型。

蜜源圈运营精选内容流。商品进入蜜源圈后仍保留原类型，不产生“蜜源圈商品类型”。

关键结论：BeeX 活动商品来自独立登记入口，并且录入前必须已经是高返佣商品。蜜源圈内容和 BeeX 活动商品是两套独立管理能力。

六种商品类型

02 / TAXONOMY

普通返佣商品NORMAL_AFFILIATE

平台正常联盟商品，有有效的 BeeX 用户返现。

可返佣

高返佣商品HIGH_COMMISSION

平台给 MCN、达人或 BeeX 机构的专属活动商品。

可返佣

BeeX 活动商品BEEX_ACTIVITY

运营独立录入并启用的高返佣商品，命中时优先于普通高返佣。

可返佣

短视频无返佣SHORT_VIDEO_NO_COMMISSION

来自短视频场景，但当前无法形成 BeeX 有效返佣。

无返佣

直播无返佣LIVE_NO_COMMISSION

来自直播场景，但当前无法形成 BeeX 有效返佣。

无返佣

普通无返佣商品NORMAL_NO_COMMISSION

普通商品，但平台当前没有有效佣金或不满足返佣条件。

无返佣

服务端判定顺序

03 / PRIORITY

每个商品响应只返回一个类型。来源场景限制优先，随后才判断 BeeX 活动登记与平台佣金。

flowchart TD A["平台商品快照"] --> B{"短视频不可返佣?"} B -- 是 --> V["SHORT_VIDEO_NO_COMMISSION"] B -- 否 --> C{"直播不可返佣?"} C -- 是 --> L["LIVE_NO_COMMISSION"] C -- 否 --> D{"BeeX 活动已启用且未到结束时间?"} D -- 是 --> E["BEEX_ACTIVITY"] D -- 否 --> F{"平台高返佣?"} F -- 是 --> G["HIGH_COMMISSION"] F -- 否 --> H{"用户返现金额有效?"} H -- 是 --> I["NORMAL_AFFILIATE"] H -- 否 --> J["NORMAL_NO_COMMISSION"]

BeeX 活动商品管理入口

04 / OPERATION

活动商品使用独立登记表 beex_activity_products，唯一键是国家、平台与平台商品 ID。短链只用于解析，不能作为长期主键。

运营录入
粘贴或批量上传 TikTok、Shopee、Lazada 商品链接。

服务端解析
获取平台、商品 ID、名称、图片、价格与当前返佣属性。

设置有效期
必须填写活动结束时间；启用时必须晚于当前国家业务时间。

高佣准入
只有当前类型为 HIGH_COMMISSION 或已登记的 BEEX_ACTIVITY 才能保存。

全链路生效
有效期内，列表、搜索、推荐、链接解析、详情和蜜源圈快照统一返回 BEEX_ACTIVITY。

到期回退
到期或停用后，按平台当时真实状态回退为高返佣、普通返佣或无返佣。

管理接口

GET  /api/v1/admin/beex-activity-products?countryCode=ID&limit=100
POST /api/v1/admin/beex-activity-products
POST /api/v1/admin/beex-activity-products/{id}/enabled

X-Operator: 当前后台操作人

{
  "countryCode": "ID",
  "sourceProductUrl": "https://vt.tokopedia.com/t/example/",
  "activityEndAt": "2026-07-31T23:59:00",
  "enabled": true
}

时间口径：印尼按 WIB（UTC+7），马来西亚按 MYT（UTC+8）。到达 activityEndAt 后实时停止命中 BEEX_ACTIVITY，不依赖定时任务；历史订单快照不改写。

C 端接口字段

05 / API

以下接口统一返回 productType：商品列表、单链接解析、商品推荐、蜜源圈列表、详情与分享承接页。

{
  "platform": "TIKTOK",
  "platformProductId": "1730000000000000000",
  "name": "Example product",
  "productType": "BEEX_ACTIVITY",
  "activityEndAt": "2026-07-31T23:59:00",
  "priceMinor": 7680000,
  "cashbackMinor": 829400,
  "currency": "IDR"
}

接口	用途
`POST /api/v1/products/high-commission`	首页、搜索与商品池列表
`POST /api/v1/products/resolve`	粘贴链接与商品详情
`POST /api/v1/products/recommendations`	同店铺、同品类推荐
`GET /api/v1/honey-feed/posts`	蜜源圈内容与商品快照

前端不能根据 source、栏目名称、佣金比例或是否来自蜜源圈自行计算类型。未来遇到未知枚举时按普通样式展示，以服务端 cashbackMinor 决定返现展示。

蜜源圈边界

06 / HONEY FEED

蜜源圈中的商品	返回类型
普通联盟商品	`NORMAL_AFFILIATE`
平台高返佣商品	`HIGH_COMMISSION`
已登记并启用的 BeeX 活动商品	`BEEX_ACTIVITY`

蜜源圈保存快照时记录并透传类型，但不能创建、修改或启停 BeeX 活动登记。

验收清单

07 / ACCEPTANCE

场景	期望
平台 Campaign 高佣商品	`HIGH_COMMISSION`
该高佣商品录入 BeeX 活动并启用	`BEEX_ACTIVITY`
BeeX 活动到达结束时间，平台高佣仍有效	`HIGH_COMMISSION`
重新启用已到期活动	拒绝，先设置未来结束时间
活动登记停用，但平台高佣仍有效	`HIGH_COMMISSION`
高佣商品只发布到蜜源圈	仍为 `HIGH_COMMISSION`
活动商品来自不可归因短视频	`SHORT_VIDEO_NO_COMMISSION`
活动商品来自不可归因直播	`LIVE_NO_COMMISSION`