分销系统 · 落地核对与 C 端接线清单(波波 · 2026-09-25)

收件人:阿仁(后端)、小齐(C端 v2)、小冈(C端 v1+BFF)
背景:WIP-303~308 分销域。用户令「推完整分销系统」。本轮把 B端 MyDistribution 补接落地;后端 / A端 经核均已齐备;C端 v2 接线已通,仅 v1 legacy 残留幽灵端点。
波波不擅改 C端代码,故 C端只给核对结论 + 修复清单,改动由小齐/小冈执行。

一、结论

唯一仍卡的不是代码,是数据:prod 真实分销员/绑定/分佣单/提现几乎为零,三端列表都会空。先让 1~2 个真实商户在 B端绑定分销员、走一单归因,才有内容可联调验收。

二、后端落地清单(已核实,勿动)

文件前缀关键端点
backend/app/routers/miniapp_distribution.py/api/miniapp/distribution/profile /guests /commissions /share-code /commissions/{id}/settle-confirm /subscription(get/apply) /register /activate /withdrawals(get/post) /withdrawals/available /joint-payment/generate
backend/app/routers/workbench_distributors.py/api/miniapp/workbench/distributorsGET '' 列表 / POST ''{phone} 绑定 / POST '/{id}/status' 暂停恢复
backend/app/routers/promoters.py(mounted)推广员域
backend/app/routers/admin_distribution.py/api/admin/distribution/overview /distributors(list/approve/freeze/unfreeze) /records(list/void/settle) /withdrawals(list/approve/reject/paid) /settings(get/put) /guest-bindings/{id}/release /risk /protection-pay /config(get/put) /bills/generate /subscription/{id}/confirm
backend/app/main.py:43-45,151,153,154,177-178—distribution_cron 启动 + 四 router 全 include_router

五表(distributors / distribution_bindings / distribution_orders / commission_ledger / withdrawal_requests)由阿仁 DDL 落地,后端各端点引用真实表,py_compile 通过。


三、B端 / A端落地清单(本轮核实)

B端 MyDistribution(本轮补接)

改动文件:行说明
页组件b-workbench/src/pages/MyDistribution.tsx / .css新建,调 /workbench/distributors(商户前缀,对齐 mb_router)
路由b-workbench/src/App.tsx:33,171import + <Route path="/my-distribution">
九宫格b-workbench/src/pages/Workbench.tsx:72「🤝 我的分销」
门禁b-workbench/src/utils/business-pack.ts:93BASE_ROUTES 恒开(跨业态营销)
网格Workbench.css已 5 列(接 key-tasks 时改过,本轮不动)

契约核对:页读 res.data?.data?.items(Network 原样返回 {code:0,data:{items}}),后端 workbench_distributors list 返 {"code":0,"data":{"items":[...]}} ✅ 一致。暂停/恢复发 paused|active,后端白名单一致 ✅。

A端 DistributionOps(已齐备,本轮仅复核)


四、C端接线清单(小齐/小冈执行)

4.1 v2(miniprogram-v2)— 已通 ✅

4.2 v1(miniprogram,legacy)— 4 个幽灵端点 ⚠️

check_api_url_wiring 抓到 miniprogram/miniprogram/services/distribution.ts 调用后端不存在的路由:

幽灵端点文件:行后端现状
/api/miniapp/distribution/asset-countsservices/distribution.ts:315无
/api/miniapp/distribution/primary-guideservices/distribution.ts:292无
/api/miniapp/distribution/who-recorded-meservices/distribution.ts:237无
/api/miniapp/distribution/who-recorded-me/{}/removeservices/distribution.ts:245无

处置建议(二选一,由小齐/小冈定):

优先级:低。v2 是活跃目标,v1 仅存量兼容。若 v1 不停服,游客走 v1 分销相关页会 404,但不影响 v2 用户。

五、联调验收清单(上线前逐项确认)


六、部署待办