4.4 KiB
4.4 KiB
文档导航与实施顺序
1. 文档目的
本套文档的目标是把一份较大的总需求，拆成可执行的页面与组件规格。
要求是：另一个 AI 在不反复追问的情况下，可以根据这里的 Markdown 文件直接搭页面骨架、组织路由、规划交互和状态。
2. 推荐阅读顺序
第一步：先理解范围
小程序C端功能需求文档.mddocs/02-信息架构与路由.mddocs/03-全局业务规则.md
第一步补充：如果当前目标是重新按租户后台真实能力校正文档
- 先看
docs/12-租户管理员功能重构梳理/00-总览.md - 再按批次看
docs/12-租户管理员功能重构梳理/ - 当前已完成批次包括：
docs/12-租户管理员功能重构梳理/01-门店前置链路.mddocs/12-租户管理员功能重构梳理/02-菜单浏览与加购链路.mddocs/12-租户管理员功能重构梳理/03-结算与支付链路.mddocs/12-租户管理员功能重构梳理/04-履约订单与售后链路.mddocs/12-租户管理员功能重构梳理/05-我的资产消息复购链路.mddocs/12-租户管理员功能重构梳理/06-活动导购与增长链路.mddocs/12-租户管理员功能重构梳理/07-精细化运营与不前置能力.md
- 对已完成批次，以该目录下文档结论优先
第二步：再理解链路
docs/04-核心用户流程.mddocs/05-页面清单总表.md
第三步：再理解版本、映射与当前执行顺序
docs/08-全周期版本规划与范围分层.mddocs/09-租户后台与C端功能映射总表.mddocs/10-全周期研发实施顺序与交付清单.mddocs/11-V1.0页面开发执行清单与验收标准.md
如果你发现
docs/09的描述和docs/12-租户管理员功能重构梳理/已完成批次冲突，以docs/12为准。
第四步：开始搭页面
docs/06-通用组件清单.mddocs/07-页面规格/下的单页文档
3. 页面实施建议顺序
建议另一位 AI 按下面顺序实现：
- 先搭全局骨架
- TabBar
- 页面导航框架
- 顶部导航
- 通用按钮、卡片、列表、状态标签
- 再搭交易主链路
- 首页
- 点餐页
- 商品详情抽屉
- 购物车抽屉
- 结算确认页
- 支付成功页
- 再搭履约与售后
- 订单页
- 订单详情页
- 退款申请页
- 退款详情页
- 评价页
- 再搭资产与增长
- 我的页
- 领券中心页
- 会员中心页
- 积分商城页
- 储值充值页
- 次卡页
- 最后搭辅助页
- 门店选择页
- 地址管理页
- 消息中心页
- 帮助中心页
- 堂食扫码确认页
- 秒杀活动页
- 限时折扣活动页
如果当前目标是对齐正式 Taro 仓库的 V1.0 落地顺序，则以：
docs/11-V1.0页面开发执行清单与验收标准.md
作为更细的页面执行顺序依据。
4. 文档使用规则
4.1 页面规格优先
如果某个页面的单页规格文档与总文档描述不同，以单页规格为准。
但如果该页面所属范围已经在 docs/12-租户管理员功能重构梳理/ 中完成重构批次，则以 docs/12 的结论优先。
4.2 结构先于视觉
本套文档优先定义：
- 页面区块顺序
- 页面承载的业务对象
- 关键交互
- 页面状态
视觉风格可以后续统一，但结构不能偏离。
4.3 先还原，再优化
另一位 AI 的任务优先是“把页面按规格还原出来”，而不是先做风格创新。
如果规格没有要求，不要擅自增加新的业务功能。
4.4 分期文档用于约束范围
如果在实施过程中出现“这一期到底做不做”的争议，优先参考：
docs/08-全周期版本规划与范围分层.mddocs/09-租户后台与C端功能映射总表.mddocs/10-全周期研发实施顺序与交付清单.mddocs/11-V1.0页面开发执行清单与验收标准.md
如果争议来自“旧原型设计”和“后台真实能力”不一致，再优先参考：
docs/12-租户管理员功能重构梳理/
5. 交付标准
如果页面是按本套文档完成的，应满足以下要求：
- 页面层级、路由、入口与出口清晰
- 页面从上到下的区块顺序与文档一致
- 每个区块具备文档要求的字段与交互
- 页面具备默认态、空态、异常态、禁用态等必要状态
- 业务对象和后台配置关系清晰可追溯