# 四条并行开发路线

四份文档分别对应四个开发分支，覆盖前端 `wechat_wc`、后端 `wxmp_backend` 与词云项目
`wordcloud` 的分工、开发内容、设计 DO/DON'T 和验收标准。以本目录文档为准，开发时
不要随意扩大分支边界。

| 文档 | 分支 | 内容 |
|---|---|---|
| [R1 商品目录动态化](route-r1-product-catalog.md) | `feat/r1-catalog` | 商品/分类 API、seed、首页/商品/详情页切换 |
| [R2 地址 + 设计清单](route-r2-address-design.md) | `feat/r2-address-design` | 地址 CRUD、默认地址事务、设计 JSON 与状态映射 |
| [R3 订单 + 支付占位](route-r3-order-pay.md) | `feat/r3-order-pay` | 服务端下单、金额重算、订单状态机、支付未配置占位 |
| [R4 上传 + 词云 + 线稿](route-r4-upload-wordcloud.md) | `feat/r4-upload-wordcloud` | COS 上传、wordcloud 契约冻结、sketch、任务轮询 |

**已收口路线的交接说明**（后续线路接入前必读）：

- [R2 交接收口说明](R2/README.md)——R3/R4/R1 接入服务端化地址与设计清单前的事实、红线与待办。

## 合并顺序与依赖

- R1 是交易链路的前置，优先合入。
- R2 依赖已有登录体系，可与 R1 并行。
- R3 依赖 R1 的商品表和 R2 的地址/设计清单接口，最后合入。
- R4 独立并行，但依赖 wordcloud 最小契约冻结。

## 通用红线

- 前后端同名分支成对评审，后端 Swagger 先定契约，前端再实现。
- 每个分支合入主干前必须通过各自仓库的构建验证。
- 页面统一从 `../../utils/store` 与 `../../utils/api` 聚合入口导入。
- 不得跨路线修改其他分支的文件所有权。