README

结账流程专题

本目录集中存放 结账形态（标准 / 单页 / 渐进式 / COD）、活动 / 优惠券 / diy_offer 的架构说明。与实现冲突时以代码为准。

各文档文首有 「## 目录」 列表，标题前带显式 <a id="..."> 锚点，便于点击跳转。

Chrome「Markdown Reader」扩展：请用扩展 自带的左侧目录（由标题自动生成），或点击文首「## 目录」里的链接；不要使用此前嵌入的 HTML 固定侧栏（已移除，会与扩展冲突）。本地 file:// 预览需在扩展详情里开启 Allow access to file URLs。

目录

• 目录结构
• 阅读顺序
• 文档一览
• 相关（其它专题）

---

目录结构

checkout-process/
├── README.md                        ← 本索引
├── checkout-flows.md                四种形态关系与主流程
├── checkout-flows-detail.md         落库时机、排障附录
├── promotion-discount-checkout.md   四套优惠体系（主文档）
├── promotions-by-checkout-type.md   各形态可用优惠对照
├── promotion/                       优惠类型参考（§15 拆分）
│   ├── README.md
│   ├── diy-offer-types-reference.md     o_diy_offer 各 type
│   ├── promotion-types-reference.md       o_promotion 七种满减
│   └── order-diy-offer-handlers.md      o_order_diy_offer Handler
├── cart/
│   ├── README.md
│   └── shopping-cart.md             购物车 Redis、getList
├── order-price-formulas.md          订单价格字段公式与税费计算
├── pricing/                         价格字段全链路（后台配置 → 前台计算 → 落库）
│   ├── README.md
│   ├── current-tax-price-flow.md
│   ├── current-shipping-price-flow.md
│   └── ...（其余价格字段）
├── checkout-shipping-and-payment.md   标准物流与支付：后台配置 → 前台获取（逐步流程）
├── standard/                        标准多步结账
├── one-page/                        单页结账（one_page）
├── single-page/                     渐进式结账（single_page）
├── cod/                             COD 带 checkout_token
├── cod-one-page/                    COD 单页着陆（无 token）
└── faq/
    ├── faq.md                       常见 FAQ
    └── cart-checkout-token-visit-id.md  token / Redis 详解

阅读顺序

1. checkout-flows.md — 四种下单方式关系、对比表、主流程（先看）
2. cart-checkout-token-visit-id.md — checkout_token / global_visit_id、Redis 购物车
3. faq.md — 常见概念与排障 FAQ（含 checkoutcart、reconcile）
4. promotions-by-checkout-type.md — 各形态可用优惠、计算顺序、订单字段
5. shopping-cart.md — 购物车 Redis、加购、getList 全链路
6. order-price-formulas.md — 订单价格字段公式、current_tax_price 计算步骤（含代码）
7. README.md — 价格字段全链路（按“后台配置 → 前台计算 → 落库”拆分）
8. checkout-shipping-and-payment.md — 标准物流与支付：后台配置、获取可用物流/支付的逐步文字流程
9. 分形态逐步链路（按需选读）：
   • standard-checkout-flow.md
   • one-page-checkout-flow.md
   • single-page-checkout-flow.md
   • cod-checkout-flow.md
   • cod-one-page-checkout.md
10. promotion-discount-checkout.md — 四套优惠体系（架构、顺序、叠加矩阵）
11. promotion — 类型查阅（读完 §10 后按需深入）：

• diy-offer-types-reference.md — o_diy_offer
• promotion-types-reference.md — o_promotion
• order-diy-offer-handlers.md — o_order_diy_offer

12. checkout-flows-detail.md — 落库对照、排障附录

文档一览

路径	说明
checkout-flows.md	四种形态逻辑关系与主流程
checkout-flows-detail.md	落库时机、排障附录
promotion-discount-checkout.md	o_diy_offer、o_promotion、o_coupon、o_order_diy_offer
promotion	优惠类型参考（§15 拆分）
diy-offer-types-reference.md	o_diy_offer 各 type
promotion-types-reference.md	o_promotion 七种满减
order-diy-offer-handlers.md	o_order_diy_offer Handler
promotions-by-checkout-type.md	五种形态可用优惠、顺序、落库
shopping-cart.md	购物车 Redis、加购、getList
order-price-formulas.md	订单价格字段公式、税费计算步骤（含代码）
README.md	价格字段全链路索引（后台配置 -> 前台计算 -> 落库）
current-tax-price-flow.md	税费全链路：税配置、税规则命中、行税额计算
current-shipping-price-flow.md	运费全链路：物流分区配置到前台方案取价
checkout-shipping-and-payment.md	标准物流与支付：后台配置、逐步流程、列表与落库
standard-checkout-flow.md	标准结账逐步流程
one-page-checkout-flow.md	单页结账逐步流程
single-page-checkout-flow.md	渐进式结账逐步流程
cod-checkout-flow.md	COD 带 token
cod-shipping-zone-plan.md	COD 物流运费方案
cod-one-page-checkout.md	COD 单页（无 token）
faq.md	常见 FAQ
cart-checkout-token-visit-id.md	token / Redis 购物车

相关（其它专题）

文档	说明
home-checkout-page-access-log.md	结账页访问日志
home-liquid-rendering-and-cod-one-page-product.md	Liquid 与 COD 单页商品页

上级索引：README.md