TakeoutSaaS.Prototypes/Cend-MiniProgram-Prototype/docs/01-文档导航与实施顺序.md

文档导航与实施顺序

1. 文档目的

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

2. 推荐阅读顺序

第一步：先理解范围

• 小程序C端功能需求文档.md
• docs/02-信息架构与路由.md
• docs/03-全局业务规则.md

第二步：再理解链路

• docs/04-核心用户流程.md
• docs/05-页面清单总表.md

第三步：再理解版本与映射

• docs/08-全周期版本规划与范围分层.md
• docs/09-租户后台与C端功能映射总表.md
• docs/10-全周期研发实施顺序与交付清单.md

第四步：开始搭页面

• docs/06-通用组件清单.md
• docs/07-页面规格/ 下的单页文档

3. 页面实施建议顺序

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

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

4. 文档使用规则

4.1 页面规格优先

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

4.2 结构先于视觉

本套文档优先定义：

• 页面区块顺序
• 页面承载的业务对象
• 关键交互
• 页面状态

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

4.3 先还原，再优化

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

4.4 分期文档用于约束范围

如果在实施过程中出现“这一期到底做不做”的争议，优先参考：

• docs/08-全周期版本规划与范围分层.md
• docs/09-租户后台与C端功能映射总表.md
• docs/10-全周期研发实施顺序与交付清单.md

5. 交付标准

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

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