docs: split prototype specs and add execution guides

This commit is contained in:
2026-03-06 11:24:40 +08:00
parent ba1c5009d2
commit 70b651ad39
33 changed files with 2702 additions and 0 deletions

View File

@@ -0,0 +1,88 @@
# 文档导航与实施顺序
## 1. 文档目的
本套文档的目标是把一份较大的总需求,拆成可执行的页面与组件规格。
要求是:另一个 AI 在不反复追问的情况下,可以根据这里的 Markdown 文件直接搭页面骨架、组织路由、规划交互和状态。
## 2. 推荐阅读顺序
### 第一步:先理解范围
- `小程序C端功能需求文档.md`
- `docs/02-信息架构与路由.md`
- `docs/03-全局业务规则.md`
### 第二步:再理解链路
- `docs/04-核心用户流程.md`
- `docs/05-页面清单总表.md`
### 第三步:开始搭页面
- `docs/06-通用组件清单.md`
- `docs/07-页面规格/` 下的单页文档
## 3. 页面实施建议顺序
建议另一位 AI 按下面顺序实现:
1. 先搭全局骨架
- TabBar
- 页面导航框架
- 顶部导航
- 通用按钮、卡片、列表、状态标签
2. 再搭交易主链路
- 首页
- 点餐页
- 商品详情抽屉
- 购物车抽屉
- 结算确认页
- 支付成功页
3. 再搭履约与售后
- 订单页
- 订单详情页
- 退款申请页
- 退款详情页
- 评价页
4. 再搭资产与增长
- 我的页
- 领券中心页
- 会员中心页
- 积分商城页
- 储值充值页
- 次卡页
5. 最后搭辅助页
- 门店选择页
- 地址管理页
- 消息中心页
- 帮助中心页
- 堂食扫码确认页
- 秒杀活动页
- 限时折扣活动页
## 4. 文档使用规则
### 4.1 页面规格优先
如果某个页面的单页规格文档与总文档描述不同,以单页规格为准。
### 4.2 结构先于视觉
本套文档优先定义:
- 页面区块顺序
- 页面承载的业务对象
- 关键交互
- 页面状态
视觉风格可以后续统一,但结构不能偏离。
### 4.3 先还原,再优化
另一位 AI 的任务优先是“把页面按规格还原出来”,而不是先做风格创新。
如果规格没有要求,不要擅自增加新的业务功能。
## 5. 交付标准
如果页面是按本套文档完成的,应满足以下要求:
- 页面层级、路由、入口与出口清晰
- 页面从上到下的区块顺序与文档一致
- 每个区块具备文档要求的字段与交互
- 页面具备默认态、空态、异常态、禁用态等必要状态
- 业务对象和后台配置关系清晰可追溯