分销域+福钥任务系统拆解 v1(2026-09-13 00:5x · 刘总令「立刻做出来」)

六包 303-308 派发,总量 7.5 人日,流水线并行 2-3 天日历。
设计确认点(刘总在线拍板,不阻塞骨架开工):见文末「待拍板语义」。

一、分销域(佣金/绑定/结算)

业务模型(依据:刘总「平台靠福钥的流通赚钱」+佣金可配置原则)

分销员(向导/老游客/任何人)注册 → 分享带参链接/海报
→ 游客首触绑定(distributor↔visitor,有效期 N 天)
→ 游客下单支付成功 → 佣金入分销员台账(金额=订单额×佣金比例【a端配置】)
→ 佣金累计 → 提现申请 → 平台审核 → 线下打款 → 台账核销

实体与端点(阿仁 303/304)

实体表关键字段
distributors分销员user_id/状态(待审/生效/冻结)/姓名/联系方式/佣金比例覆盖
distribution_bindings绑定distributor_id/visitor_user_id/绑定时间/有效期/是否活跃
distribution_orders分佣单order_id/distributor_id/visitor/订单额/佣金比例快照/佣金额/状态(待结算/已结算/已退佣)
commission_ledger佣金台账distributor_id/累计/待结算/已提现/冻结
withdrawal_requests提现申请distributor_id/金额/状态(待审/已打款/已拒绝)/凭证

API(15 端点)

二、福钥任务系统(商户营销发放→游客完成→福钥抵扣)

业务模型(依据:D5 v1.1 福钥=商户补贴额度+1:1 服务费赠送)

商户(a端/服务费额度)→ 创建福钥任务(任务名/福钥数/完成条件/库存)
→ 游客看到任务 → 完成条件(到店打卡/评价/分享/消费满额——可配置)
→ 福钥入游客余额 → 游客下单支付时福钥抵扣(比例/上限=a端配置)
→ 商户提供服务(福钥抵扣部分=平台对商户的补贴凭证结算)

实体与端点(阿仁 303+小渔 305 数据)

实体表关键字段
key_tasks任务定义merchant_id/任务名/福钥数/完成条件类型(打卡/评价/分享/满额)/条件参数/库存/状态
key_task_claims领取task_id/user_id/领取时间/状态(进行中/已完成/已过期)
key_grants发放user_id/task_id/福钥数/来源(任务/服务费赠送)/时间
key_holdings游客福钥余额user_id/余额/累计获得/累计使用
key_usages抵扣记录order_id/user_id/福钥数/抵扣金额

API(18 端点)

三、六包派发(303-308)

包席位范围人日
303阿仁分销域后端核心(5 表+15 端点+状态机)+福钥任务后端(5 表+18 端点)——两大域合并一单(同域同批次,迁移 065-068)3
304阿仁303 收尾:提现审核流+a端运营干预+配置端点(303 完工即接)0.5
305小渔分销域+福钥任务种子(分销员 10/绑定 30/分佣单 50/台账/提现/任务 20/领取 60/发放/余额/抵扣)0.5
306一号c端分销前端:分享组件(带参小程序码)/分销员中心(注册/台账/提现)/我的佣金页1.5
307二号b端商户福钥任务管理(创建/编辑/发放记录)+a端分销运营+福钥配置+抵扣比例配置1.5
308小渔联调数据+全链实录(分销绑定→下单→佣金→提现申请;任务领取→完成→福钥→抵扣)0.5

依赖:303 先行(骨架+API)→305 种子→306/307 前端并行→308 收口。

判据:全部 L3(staging 全链实录:分销注册→绑定→下单→佣金→提现申请;任务创建→领取→完成→福钥→抵扣——两组链路各 12 步)。

四、待拍板语义(不阻塞骨架,刘总随时拍)

#语义我的默认建议(不拍板即按此执行)
1分销员注册是否需 a端审核建议:需审核(防滥用)
2绑定有效期建议:30 天
3佣金比例a端配置(全局默认+商品覆盖)——不写死
4提现门槛与手续费a端配置
5福钥抵扣比例/单单上限a端配置(建议:1 福钥=1 元,单单上限 50%)
6福钥有效期建议:发放后 90 天
7福钥可否转让建议:不可(不可兑换补贴凭证定性)

🔴 白标化整合(2026-09-13 01:3x · 刘总顶层需求「全栈可配置无缝移植」+模式 A 确认)

刘总顶层需求确认:全栈可配置无缝移植的小程序系统(后台改名+换页面结构=变成另一个小程序)——模式 A(单租户复制)已拍板。冈子产出(BFF 48 条+接入清单 P0/P1+设计规范七件套)为②结构层实施主线。gpt6 白标化评审(12645 字符)补齐:配置治理层/租户上下文层/发布版本层/主题引擎层/数据迁移层五个遗漏层+页面 DSL 最小模型+租户初始化脚本全清单+风险 Top3。整合方案与派工见 docs/plans/2026-09-13-白标化系统方案-v1.md(待出)。