# 文档导航与实施顺序

## 1. 文档目的

本套文档的目标是把一份较大的总需求，拆成可执行的页面与组件规格。  
要求是：另一个 AI 在不反复追问的情况下，可以根据这里的 Markdown 文件直接搭页面骨架、组织路由、规划交互和状态。

## 2. 推荐阅读顺序

### 第一步：先理解范围
- `小程序C端功能需求文档.md`
- `docs/02-信息架构与路由.md`
- `docs/03-全局业务规则.md`

### 第一步补充：如果当前目标是重新按租户后台真实能力校正文档
- 先看 `docs/12-租户管理员功能重构梳理/00-总览.md`
- 再按批次看 `docs/12-租户管理员功能重构梳理/`
- 当前已完成批次包括：
  - `docs/12-租户管理员功能重构梳理/01-门店前置链路.md`
  - `docs/12-租户管理员功能重构梳理/02-菜单浏览与加购链路.md`
  - `docs/12-租户管理员功能重构梳理/03-结算与支付链路.md`
  - `docs/12-租户管理员功能重构梳理/04-履约订单与售后链路.md`
  - `docs/12-租户管理员功能重构梳理/05-我的资产消息复购链路.md`
  - `docs/12-租户管理员功能重构梳理/06-活动导购与增长链路.md`
  - `docs/12-租户管理员功能重构梳理/07-精细化运营与不前置能力.md`
- 对已完成批次，以该目录下文档结论优先

### 第二步：再理解链路
- `docs/04-核心用户流程.md`
- `docs/05-页面清单总表.md`

### 第三步：再理解版本、映射与当前执行顺序
- `docs/08-全周期版本规划与范围分层.md`
- `docs/09-租户后台与C端功能映射总表.md`
- `docs/10-全周期研发实施顺序与交付清单.md`
- `docs/11-V1.0页面开发执行清单与验收标准.md`

> 如果你发现 `docs/09` 的描述和 `docs/12-租户管理员功能重构梳理/` 已完成批次冲突，以 `docs/12` 为准。

### 第四步：开始搭页面
- `docs/06-通用组件清单.md`
- `docs/07-页面规格/` 下的单页文档

## 3. 页面实施建议顺序

建议另一位 AI 按下面顺序实现：

1. 先搭全局骨架
   - TabBar
   - 页面导航框架
   - 顶部导航
   - 通用按钮、卡片、列表、状态标签
2. 再搭交易主链路
   - 首页
   - 点餐页
   - 商品详情抽屉
   - 购物车抽屉
   - 结算确认页
   - 支付成功页
3. 再搭履约与售后
   - 订单页
   - 订单详情页
   - 退款申请页
   - 退款详情页
   - 评价页
4. 再搭资产与增长
   - 我的页
   - 领券中心页
   - 会员中心页
   - 积分商城页
   - 储值充值页
   - 次卡页
5. 最后搭辅助页
   - 门店选择页
   - 地址管理页
   - 消息中心页
   - 帮助中心页
   - 堂食扫码确认页
   - 秒杀活动页
   - 限时折扣活动页

如果当前目标是对齐正式 `Taro` 仓库的 `V1.0` 落地顺序，则以：
- `docs/11-V1.0页面开发执行清单与验收标准.md`

作为更细的页面执行顺序依据。

## 4. 文档使用规则

### 4.1 页面规格优先
如果某个页面的单页规格文档与总文档描述不同，以单页规格为准。

但如果该页面所属范围已经在 `docs/12-租户管理员功能重构梳理/` 中完成重构批次，则以 `docs/12` 的结论优先。

### 4.2 结构先于视觉
本套文档优先定义：
- 页面区块顺序
- 页面承载的业务对象
- 关键交互
- 页面状态

视觉风格可以后续统一，但结构不能偏离。

### 4.3 先还原，再优化
另一位 AI 的任务优先是“把页面按规格还原出来”，而不是先做风格创新。  
如果规格没有要求，不要擅自增加新的业务功能。

### 4.4 分期文档用于约束范围
如果在实施过程中出现“这一期到底做不做”的争议，优先参考：
- `docs/08-全周期版本规划与范围分层.md`
- `docs/09-租户后台与C端功能映射总表.md`
- `docs/10-全周期研发实施顺序与交付清单.md`
- `docs/11-V1.0页面开发执行清单与验收标准.md`

如果争议来自“旧原型设计”和“后台真实能力”不一致，再优先参考：
- `docs/12-租户管理员功能重构梳理/`

## 5. 交付标准

如果页面是按本套文档完成的，应满足以下要求：

- 页面层级、路由、入口与出口清晰
- 页面从上到下的区块顺序与文档一致
- 每个区块具备文档要求的字段与交互
- 页面具备默认态、空态、异常态、禁用态等必要状态
- 业务对象和后台配置关系清晰可追溯