文档索引（排障 / 架构）
本文件为 人工维护的精选索引，便于在 Cursor 或代码库中快速定位说明文档。详细内容以各文档正文为准；与实现冲突时以代码为准。
业务与功能
| 专题 | 说明 | 入口 |
|---|---|---|
| 结账流程 | 四种下单、FAQ、分形态链路、活动/券、token/Redis | README.md |
| Home 前台 | Liquid 渲染、结账页访问日志 | README.md |
| 店铺装修（主题） | 后台装修 → Liquid 前台渲染、积木块/分组/视角 | README.md |
| 会员权益 | 会员价、升降级、会员日、积分/运费/券（需求整理中） | requirements.md |
会员权益（membership）
| 说明 | 路径 |
|---|---|
| 业务需求摘要 | requirements.md |
| 蓝湖 MCP（Cursor 本地） | lanhu-mcp-setup.md |
结账流程（checkout-process）
| 说明 | 路径 |
|---|---|
| 专题索引与阅读顺序 | README.md |
| 常见 FAQ（含 checkoutcart 作用） | faq.md |
| token / Redis 购物车 | cart-checkout-token-visit-id.md |
| 五种形态可用优惠、计算顺序 | promotions-by-checkout-type.md |
| 订单价格字段公式与税费计算（含代码） | order-price-formulas.md |
| 价格字段全链路索引（后台配置 -> 前台计算 -> 落库） | README.md |
| 税费全链路（税配置 -> 前台税费） | current-tax-price-flow.md |
| 运费全链路（物流配置 -> 前台运费） | current-shipping-price-flow.md |
| 优惠类型参考（diy_offer / 满减 / order_diy_offer） | promotion |
| diy_offer 5 种类型计算逻辑（公式 + mock 样例） | diy-offer-calculation.md |
| order_diy_offer 计算逻辑（各 from_name + mock 样例） | order-diy-offer-calculation.md |
| 购物车处理逻辑 | shopping-cart.md |
| 标准物流与支付（后台配置 → 前台获取） | checkout-shipping-and-payment.md |
| 标准 / 单页 / 渐进式 / COD 逐步链路 | standard 等子目录 |
| COD 单页（无 token） | cod-one-page-checkout.md |
| COD 物流运费方案 | cod-shipping-zone-plan.md |
Home 前台
| 说明 | 路径 |
|---|---|
| Home Liquid 渲染与 COD 单页商品相关说明 | home-liquid-rendering-and-cod-one-page-product.md |
Home 结账页访问日志：四种 checkout GET、200/404、CheckoutAccessLogService、SLS 字段 | home-checkout-page-access-log.md |
店铺装修（theme）
| 说明 | 路径 |
|---|---|
| 专题索引 | README.md |
| 装修模块完整实现：后台 API、Liquid 加载、积木块/分组/视角、缓存 | theme-decoration-and-liquid-rendering.md |
settings_schema.json 子类型与后台页面对应 | settings-schema-reference.md |
| 组装修（商品/专辑等分组差异化装修） | route-group-decoration.md |
| 装修视角（设备/国家/UTM 条件显隐） | theme-view-ab-display.md |
| database 类型皮肤（DB 资产 + OSS + 同步渲染） | database-theme-flow.md |
| database 皮肤渲染缓存（Key / 存储内容 / TTL） | database-theme-render-cache.md |
架构与其它
| 说明 | 路径 |
|---|---|
| 本机缓存架构设计（磁盘方案评审 + APCu/Redis 版本号失效） | local-cache-architecture.md |
MQ 消费路由（{node}_task.t_consume_handler → task consumer） | mq-consume-handler-webhook.mdc |
包裹签收 Webhook 部署 SQL（o_event + t_consume_handler） | orders_parcel_delivered_event.sql |
| 事件与分析 | analysis-events.md |
| 缺陷记录 | bugs |
| PHPUnit | phpunit |
| OpenAPI（预留） | openapi |
维护约定（持久规则见 .cursor/rules/persistent-memory.mdc「设计文档与 Cursor 检索约定」）：在 docs/ 新增或重写专题文档后，请在本 README.md 中增补一行索引。