骨架阶段(2026-09-13)。依赖阿仁 WIP-303 后端(分销 15 端点 + 福钥任务 18 端点 + 迁移 065-069)。
原则:端点落地前零 mock、零假列表、零假成功;端点就绪后按本表逐页接真(响应兼容{code:0,data}与{ok:true,data})。
现有admin_distribution.py/miniapp_distribution.py是旧分销模型(config/risk/subscription/bills/profile/guests/commissions/share-code),不含本单新端点,勿混用。
| 页面 | 路由/菜单 | 待接端点(以 303 交付为准) | 工作台 | |
|---|---|---|---|---|
DistributionOps.tsx | /distribution 菜单「分销运营」 | GET /api/admin/distribution/distributors;`POST …/{id}/approve | freeze` | 分销员审核 |
GET /api/admin/distribution/orders | 分佣单查询(只读) | |||
GET /api/admin/distribution/withdrawals;`POST …/{id}/approve | reject`(涉钱) | 提现审核 | ||
GET/PUT /api/admin/distribution/config | 佣金比例/提现门槛/绑定有效期配置 | |||
KeyConfig.tsx | /key-config 菜单「福钥配置」 | GET/PUT /api/admin/key/config(抵扣价值/单单上限/有效期/可转让/赠送比例);GET /api/admin/key/monitor | 福钥配置+发放监控 |
| 页面 | 路由 | 待接端点(以 303 交付为准) | |
|---|---|---|---|
KeyTasks.tsx | /key-tasks(BASE_ROUTES,全业态;工作台宫格入口) | GET /api/miniapp/merchant/key-tasks、POST、PUT …/{id}、`POST …/{id}/on | off、GET …/grants、GET …/stats` |
MyDistribution.tsx | /my-distribution(BASE_ROUTES;宫格入口)·方案B第二批 | GET /merchant-console/my-distributors(我绑定的分销员);绑定发起(授权手机号,pending→匹配激活)端点待 303 |
DistributionOps:新增「我的客人争议」Tab(§8.2 四级裁决留痕);提现审核补批量打款;佣金配置补总激励成本上限;分销员改「商户绑定+授权手机号激活」模型;分销单字段改 distribution_records(commission_fen 下单快照 / accrued→settleable→settled)。MyDistribution:商户绑定分销员(手机号)、佣金单聊确认、佣金单查看;商户可见界面不出现领队/分销金额、不显示比例(§7.3)。/distribution/orders 以后端 303 实际路径(records 等)为准,接真时统一改。注册需审核(是)/ 绑定有效期 30 天 / 佣金比例 a端配置 / 提现门槛 a端配置 / 1 福钥=1 元·单单上限 50% / 福钥有效期 90 天 / 不可转让。