order_site

Files

T

yml2213 01e31ff36b docs(抖音-码速达): 最小接入方案分析（收单→发券→固定链接兑换→核销）

新增 05-最小接入方案分析.md（389 行），针对「先跑通、后面再接抖音官方」的
最小闭环做可行性分析，并给出现成可复用资产与代码落点。

最小闭环四步：trade_TradePaid 收单 + order.orderDetail 补全 → 本地生成 DYC
券码并 coupons.syncV2 同步 → 买家在【固定兑换链接】输入订单号兑换 →
coupons.verifyV3 上报核销 + order.message 发去使用链接。

结论与关键分析：
- 最小版比标准方案少约 2/3 工作量（不做 topup.result、对账轮询、售后、
  商品映射后台），约 8~10 人日；
- 固定链接 + 订单号闸门：与旧 /claim/:token 逐条对比，给出订单状态分流表
  （未支付/已退款/已核销/可兑换…各自下一步）、3 屏交互与最小接口
  POST /redeem/lookup|confirm；
- 安全：明确「知道订单号即可兑换」是可枚举风险，给 6 层防护（按 orderNo+IP
  限流、状态门禁、两步确认、一次性核销、访问留痕告警、可选手机号后4位），
  并指出若业务不接受残余风险就必须牺牲「只输订单号」体验；
- 可复用现成资产：/collect 公开页（输入订单号→查状态→下一步）+ 按 orderNo
  限流 + mapWorkOrderPublic 最小投影 + CollectPage 骨架；
- 核销时机建议：履约动作确认成功后才 verifyV3（避免「已核销但没发货」客诉），
  发错可用 coupons.cancelVerify 冲正；
- 最小版必须顺带做退款作废（refund_RefundSuccess → 券 invalid），否则一定资损；
- 1 张新表（douyin_mashida_certificates）+ 完整代码落点清单（新增/修改/前端）
  与「明确不做」边界；命名统一 douyin_mashida（provider）/ doudian（platform），
  为后续直连抖音官方预留兼容设计（出网层只暴露 4 个业务方法）。
- 指出术语问题：平台只有 syncV2 + verifyV3，没有 syncV3。

同步更新 README 索引。

2026-10-08 14:48:21 +08:00

affiliate_dash_发货平台

docs: 清理过时文档（以代码为准）

2026-09-17 16:57:27 +08:00

91卡券

docs: 清理过时文档（以代码为准）

2026-09-17 16:57:27 +08:00

发货平台-2

优化客服权限

2026-07-10 12:00:23 +08:00

履约配置

fix(claim): 修复后台手动关闭任务后领取链接未失效的缺陷