六包 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 端点)
- 游客侧:绑定(带参进入自动绑)/我的分销员/我的佣金(游客可见部分)
- 分销员侧:注册申请/我的台账/我的分佣单列表/提现申请/提现记录
- a端:分销员列表/审核/冻结/分佣单查询/提现审核(通过+打款登记/拒绝)/佣金比例全局配置
二、福钥任务系统(商户营销发放→游客完成→福钥抵扣)
业务模型(依据: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 端点)
- 游客侧:任务列表(在售)/领取/我的任务/我的福钥余额/福钥流水/支付时抵扣查询
- 商户侧:任务创建/编辑/上架下架/发放记录/库存统计
- a端:任务审核/全量查询/抵扣比例配置/福钥发放总量监控
三、六包派发(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(待出)。