价格字段全链路文档(后台配置 -> 前台计算)

本目录按一个价格字段一篇文档拆分,目标是回答三件事:

  1. 商家后台如何配置;
  2. 买家前台何时、按什么参数计算;
  3. 结果如何写回订单并参与后续重算。

推荐阅读顺序

  1. total-price-flow.md
  2. current-subtotal-price-flow.md
  3. current-shipping-price-flow.md
  4. current-promotion-price-flow.md
  5. current-coupon-price-flow.md
  6. current-tax-price-flow.md
  7. current-insurance-price-flow.md
  8. current-tip-price-flow.md
  9. current-payment-price-flow.md
  10. current-offer-price-flow.md
  11. current-total-price-flow.md
  12. refund-price-flow.md

文档一览

文档字段核心关注点
current-tax-price-flow.mdcurrent_tax_price税配置(国家/省州/商品范围)如何映射到行税额
current-shipping-price-flow.mdcurrent_shipping_price物流分区方案如何按地址和购物车命中
current-insurance-price-flow.mdcurrent_insurance_price运费险固定额/比例模式与基数关系
current-tip-price-flow.mdcurrent_tip_price小费类型(固定/比例)与买家选择
current-coupon-price-flow.mdcurrent_coupon_price券门槛、范围、与活动叠加截断
current-promotion-price-flow.mdcurrent_promotion_price活动规则命中与插件折扣合并
current-payment-price-flow.mdcurrent_payment_price支付展示条件、费率公式、封顶修正
current-offer-price-flow.mdcurrent_offer_price订单级插件行汇总(可正可负)
current-subtotal-price-flow.mdcurrent_subtotal_price行价构成与商品金额求和
current-total-price-flow.mdcurrent_total_price中间总价口径(小计+运费)
total-price-flow.mdtotal_price最终应付价统一汇总口径
refund-price-flow.mdrefund_price退款累计口径与状态过滤

统一模板说明(全部文档一致)

每篇都按同一结构:

  1. 业务定义(一句话)

  2. 后台配置映射表(配置项 -> 前台变量)

  3. 全链路时序图(Mermaid)

  4. 前台计算主流程(参数 -> 公式 -> 步骤)

  5. 多场景演算(正常/边界/异常)

  6. 落库与联动

  7. 排障清单

  8. 值班排障手册(现象 -> 根因 -> 核对点 -> 修复动作)

  9. 可执行检查清单(按顺序 + 预期结果)

  10. 执行定位速查(日志关键词 / 代码入口 / 数据落点)