feat: add c-end prototype and reorganize tenant admin prototype

This commit is contained in:
2026-03-09 10:14:31 +08:00
parent 80d9789c70
commit cdb5f47c65
122 changed files with 5580 additions and 0 deletions

View File

@@ -0,0 +1,294 @@
# GEMINI 工作说明
## 1. 你的角色
你现在不是在做正式开发版本,而是在做 `TakeoutSaaS` 的 **C 端小程序原型**。
你的核心任务不是重新定义需求,也不是发散设计,而是 **严格根据仓库内的 Markdown 文档,把页面原型 1:1 搭出来**。
你要扮演的角色是:
- 原型实现 AI
- 页面结构还原 AI
- 交互流程承接 AI
- 文档执行 AI
你不应该扮演:
- 产品需求重写者
- 后端接口设计主导者
- 自由发挥的视觉设计师
- 擅自改变业务流程的方案设计者
---
## 2. 本次工作的目标
本次目标是完成一个 **可演示、可走流程、可按页面逐步查看的 C 端小程序原型**。
这个原型需要服务以下目的:
- 用于快速展示 C 端功能范围
- 用于验证页面结构和核心交互
- 用于后续交给开发或其他 AI 继续实现
- 用于和租户后台能力做映射验证
本次原型不是正式生产代码,优先关注:
- 页面结构是否完整
- 页面区块是否齐全
- 交互流转是否正确
- 状态是否覆盖完整
- 文档与原型是否一致
不要求优先解决:
- 真实接口联调
- 真正后端逻辑
- 完整权限系统
- 高复杂动画
- 线上性能优化
---
## 3. 你必须遵守的文档优先级
如果仓库内多个文档描述不一致,按下面优先级执行:
1. `docs/07-页面规格/` 下的单页规格文档
2. `docs/03-全局业务规则.md`
3. `docs/02-信息架构与路由.md`
4. `docs/04-核心用户流程.md`
5. `docs/05-页面清单总表.md`
6. `小程序C端功能需求文档.md`
如果你发现描述不完整:
- 允许做 **最小必要推断**
- 不允许擅自新增新的业务能力
- 所有推断必须以“不破坏现有文档结构”为前提
---
## 4. 你开始工作前必须先读的文件
开始任何实现前,必须先完整阅读以下文件:
1. `README.md`
2. `docs/01-文档导航与实施顺序.md`
3. `docs/02-信息架构与路由.md`
4. `docs/03-全局业务规则.md`
5. `docs/04-核心用户流程.md`
6. `docs/05-页面清单总表.md`
7. `docs/06-通用组件清单.md`
8. 本次要实现页面对应的 `docs/07-页面规格/*.md`
如果你没有读完这些文档,不允许直接开始实现页面。
---
## 5. 原型实现原则
### 5.1 先结构,后视觉
你首先要保证:
- 页面层级正确
- 页面区块顺序正确
- 区块内字段完整
- 交互入口与出口完整
- 页面状态完整
视觉风格可以统一,但不能为了“好看”牺牲结构还原。
### 5.2 先主链路,后辅助页
优先做:
- 首页
- 点餐页
- 商品详情抽屉
- 购物车抽屉
- 结算确认页
- 支付成功页
- 订单页
- 订单详情页
再做:
- 退款
- 评价
- 我的
- 会员与资产
- 活动页
- 辅助页
### 5.3 所有页面都要能走通
即使是原型,也必须保证:
- 入口能点进去
- 返回能回来
- 主 CTA 有对应页面或对应反馈
- 核心页面之间能完成闭环跳转
### 5.4 统一组件复用
如果多个页面出现重复结构,优先抽组件,不要每页重新拼。
必须优先复用:
- 顶部导航
- TabBar
- 门店切换条
- 场景切换条
- 商品卡
- 订单卡
- 金额明细卡
- 底部固定操作栏
- 状态标签
- 列表空态
### 5.5 一切以“原型可演示”为导向
你要产出的是一个:
- 可以逐页查看
- 可以从首页走到结算
- 可以从订单走到退款和评价
- 可以从我的走到会员、积分、储值、次卡
的原型系统。
---
## 6. 页面实现要求
每实现一个页面,都必须覆盖以下内容:
### 6.1 页面骨架
- 顶部区域
- 主内容区
- 底部区域 / 底部 CTA
- 安全区处理
### 6.2 页面区块
必须按照对应页面规格文档中的区块顺序实现。
不要随意增删区块。
### 6.3 页面数据
由于当前是原型,可以使用静态 mock 数据。
但 mock 数据必须满足:
- 能真实表现页面结构
- 能体现业务差异
- 能体现状态变化
- 文案贴近餐饮点单场景
### 6.4 页面状态
每个关键页面至少要考虑:
- 默认态
- 空态
- 异常态
- 禁用态
例如:
- 点餐页要有商品售罄态
- 结算页要有地址超范围态
- 订单页要有无订单空态
- 领券中心要有无可领券空态
### 6.5 页面交互
你必须保证以下类型的交互具备原型行为:
- 点击跳转
- 抽屉打开 / 关闭
- Tab 切换
- 场景切换
- 数量加减
- 状态筛选
- 返回上页
---
## 7. 禁止事项
你不允许做以下事情:
### 7.1 不允许擅自改变信息架构
例如:
- 把 `堂食扫码确认页` 改成 Tab 页面
- 把 `购物车抽屉` 改成完整页面,且没有理由
- 把 `会员中心` 合并进 `我的` 而取消独立页面
### 7.2 不允许擅自删减关键业务页面
以下页面是必须存在的:
- 首页
- 点餐页
- 订单页
- 我的页
- 商品详情抽屉
- 购物车抽屉
- 结算确认页
- 支付成功页
- 订单详情页
- 退款申请页
- 评价页
- 会员中心页
- 积分商城页
- 储值充值页
- 次卡页
- 堂食扫码确认页
### 7.3 不允许引入不必要的业务创新
例如:
- 社交分享裂变体系
- 拼团、砍价、盲盒、社区内容
- 与文档无关的推荐算法逻辑
- 与文档无关的新支付方式
### 7.4 不允许只做静态截图式页面
原型必须能点击流转,不是只拼静态画面。
---
## 8. 推荐工作方式
### 第一步:先做壳层
先搭:
- 全局路由
- TabBar
- 顶部导航
- 通用容器
- 安全区处理
### 第二步:先做核心组件
先做:
- 商品卡
- 订单卡
- 金额明细卡
- 状态标签
- 购物车底栏
- 抽屉容器
### 第三步:按 `plan.md` 的顺序做页面
严格按 `plan.md` 的阶段执行。
一个阶段完成后再进入下一个阶段。
### 第四步:每完成一个页面就自检
自检内容:
- 路由是否正确
- 区块是否完整
- 交互是否能走通
- 状态是否覆盖
- 文档是否对齐
---
## 9. 完成标准
只有满足以下条件,才算页面完成:
- 页面区块完整
- 页面交互可用
- 页面状态可切换或可表达
- 页面和文档一致
- 页面能接入主流程
只有满足以下条件,才算整套原型完成:
- 首页 → 点餐 → 结算 → 支付成功 → 订单详情 能闭环
- 订单 → 退款 / 评价 能闭环
- 我的 → 会员 / 积分 / 储值 / 次卡 / 消息 / 帮助 能闭环
- 堂食扫码 → 堂食点餐 → 结算 → 订单详情 能闭环
---
## 10. 本次你最终应该交付什么
你最终应该交付的是:
- 一套可点击的小程序原型
- 页面结构与文档高度一致
- 页面命名、路由、交互路径可被开发继续接手
- 另一位开发或 AI 能在此基础上继续做真实代码实现
你当前的目标不是把代码做复杂,而是把原型做准确。

View File

@@ -0,0 +1,61 @@
# TakeoutSaaS C 端小程序原型文档仓库
本仓库用于承载 `TakeoutSaaS` 小程序 C 端的产品需求拆分文档。
目标不是只描述“有什么功能”,而是让另一个 AI 或工程师可以直接照着 Markdown 文档,把页面结构 `1:1` 搭出来。
## 使用顺序
建议按下面顺序阅读并实施:
1. `docs/01-文档导航与实施顺序.md`
2. `docs/02-信息架构与路由.md`
3. `docs/03-全局业务规则.md`
4. `docs/04-核心用户流程.md`
5. `docs/05-页面清单总表.md`
6. `docs/08-全周期版本规划与范围分层.md`
7. `docs/09-租户后台与C端功能映射总表.md`
8. `docs/10-全周期研发实施顺序与交付清单.md`
9. `docs/06-通用组件清单.md`
10. `docs/07-页面规格/` 下的单页文档
11. `小程序C端功能需求文档.md` 作为总需求母文档补充参考
## 文档优先级
当文档之间出现描述差异时,按以下优先级处理:
1. `docs/07-页面规格/` 单页规格
2. `docs/03-全局业务规则.md`
3. `docs/02-信息架构与路由.md`
4. `小程序C端功能需求文档.md`
## 当前仓库内容
- `小程序C端功能需求文档.md`:原始总需求文档
- `docs/`:拆分后的实施文档
- `docs/08-10`:全周期版本规划、后台映射、研发实施顺序文档
## 实施目标
另一个 AI 接手时,应至少能根据本仓库完成:
- 小程序整体信息架构
- Tab 页和二级页面结构
- 弹层 / 抽屉 / 购物车等交互组件
- 外卖、自提、堂食三场景页面切换
- 会员、优惠、积分、储值、次卡等资产页面
- 订单、退款、评价等履约和售后页面
## 当前约定
- 底部 Tab 固定为:`首页``点餐``订单``我的`
- 堂食采用 `扫码直达 + 二级页面确认`,不作为独立 Tab
- 本仓库当前只包含文档,不包含前端代码
## 原型演示
- 可点击原型入口:`index.html`
- 打开方式:直接用浏览器打开 `index.html`
- 页面覆盖:首页、点餐、订单、我的、结算、支付成功、订单详情、退款、评价、会员资产、活动页、辅助页
- 演示结构:左侧为阶段计划与页面导航,右侧为移动端原型画布

View File

@@ -0,0 +1,19 @@
*** Begin Patch
*** Update File: README.md
@@
-## 当前仓库内容
-
-- `小程序C端功能需求文档.md`:原始总需求文档
-- `docs/`:拆分后的实施文档
+## 当前仓库内容
+
+- `小程序C端功能需求文档.md`:原始总需求文档
+- `docs/`:拆分后的实施文档
+- `index.html`:按 `plan.md` 落地的可点击 C 端原型演示页
+
+## 原型预览
+
+- 直接在浏览器打开 `index.html`
+- 左侧为阶段计划与页面导航,右侧为移动端原型画布
+- 已覆盖首页、点餐、订单、我的、结算、支付成功、订单详情、退款、评价、会员资产、活动页与辅助页
*** End Patch

View File

@@ -0,0 +1,99 @@
# 文档导航与实施顺序
## 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. 交付标准
如果页面是按本套文档完成的,应满足以下要求:
- 页面层级、路由、入口与出口清晰
- 页面从上到下的区块顺序与文档一致
- 每个区块具备文档要求的字段与交互
- 页面具备默认态、空态、异常态、禁用态等必要状态
- 业务对象和后台配置关系清晰可追溯

View File

@@ -0,0 +1,86 @@
# 信息架构与路由
## 1. 顶层信息架构
小程序采用 `4 个 Tab + 若干二级页面 + 若干弹层 / 抽屉组件` 的结构。
### 1.1 Tab 页面
| 编码 | 页面名称 | 路由建议 | 页面层级 | 说明 |
| --- | --- | --- | --- | --- |
| `T01` | 首页 | `pages/tab/home/index` | Tab | 选店、活动导流、推荐 |
| `T02` | 点餐 | `pages/tab/menu/index` | Tab | 商品浏览、加购、结算入口 |
| `T03` | 订单 | `pages/tab/orders/index` | Tab | 订单列表、履约、售后 |
| `T04` | 我的 | `pages/tab/me/index` | Tab | 资产、消息、服务、复购 |
### 1.2 二级页面
| 编码 | 页面名称 | 路由建议 | 页面层级 | 入口来源 |
| --- | --- | --- | --- | --- |
| `P01` | 门店选择页 | `pages/store/select/index` | 二级页 | 首页、点餐页 |
| `P02` | 地址管理页 | `pages/address/list/index` | 二级页 | 我的、结算页 |
| `P03` | 结算确认页 | `pages/checkout/index` | 二级页 | 点餐页 |
| `P04` | 支付成功页 | `pages/payment/success/index` | 二级页 | 结算确认页 |
| `P05` | 订单详情页 | `pages/order/detail/index` | 二级页 | 订单页、支付成功页 |
| `P06` | 退款申请页 | `pages/order/refund/apply/index` | 二级页 | 订单详情页 |
| `P07` | 退款详情页 | `pages/order/refund/detail/index` | 二级页 | 订单页、订单详情页 |
| `P08` | 评价页 | `pages/review/create/index` | 二级页 | 订单详情页 |
| `P09` | 领券中心页 | `pages/coupon/center/index` | 二级页 | 首页、我的 |
| `P10` | 秒杀活动页 | `pages/activity/seckill/index` | 二级页 | 首页、点餐页 |
| `P11` | 限时折扣活动页 | `pages/activity/flash-sale/index` | 二级页 | 首页、点餐页 |
| `P12` | 会员中心页 | `pages/member/center/index` | 二级页 | 我的 |
| `P13` | 积分商城页 | `pages/points/mall/index` | 二级页 | 我的 |
| `P14` | 储值充值页 | `pages/prepaid/index` | 二级页 | 我的 |
| `P15` | 次卡页 | `pages/pass-card/index` | 二级页 | 我的 |
| `P16` | 消息中心页 | `pages/message/center/index` | 二级页 | 我的 |
| `P17` | 帮助中心页 | `pages/help/center/index` | 二级页 | 我的 |
| `P18` | 堂食扫码确认页 | `pages/dine-in/confirm/index` | 二级页 | 扫码入口、首页 |
### 1.3 弹层 / 抽屉 / 组件级页面
| 编码 | 名称 | 建议形态 | 所属页面 | 说明 |
| --- | --- | --- | --- | --- |
| `C01` | 商品详情抽屉 | 底部抽屉 / 右滑抽屉 | 点餐页 | 规格、加料、数量选择 |
| `C02` | 购物车抽屉 | 底部抽屉 | 点餐页 | 已选商品清单 |
| `C03` | 登录授权弹层 | 中央弹窗 / 底部弹层 | 全局 | 订单与资产前拦截 |
| `C04` | 优惠选择弹层 | 底部抽屉 | 结算页 | 券、积分、余额选择 |
| `C05` | 支付方式弹层 | 底部抽屉 | 结算页 | 微信支付 / 余额支付 |
| `C06` | 地址选择抽屉 | 底部抽屉 | 结算页 | 快捷切换地址 |
## 2. 页面层级关系
### 2.1 主链路关系
`首页 / 点餐 / 我的``门店选择`
`点餐``商品详情抽屉``购物车抽屉``结算确认页``支付成功页``订单详情页`
`订单页``订单详情页``退款申请页 / 评价页`
`我的``会员中心 / 积分商城 / 储值充值 / 次卡 / 消息中心 / 帮助中心`
### 2.2 堂食链路关系
`扫码``堂食扫码确认页``点餐页(堂食场景)``商品详情抽屉``购物车抽屉``结算确认页``订单详情页`
## 3. Tab 与二级页切换规则
- Tab 页面之间通过底部导航切换
- 二级页面统一采用顶部导航栏返回
- `商品详情抽屉``购物车抽屉` 不单独占用路由栈
- `结算确认页``订单详情页``会员中心页` 等重要业务页使用完整页面承载
## 4. 页面显示规则
### 4.1 Tab 页面
- 保持底部 TabBar 可见
- 顶部导航不显示返回按钮
- 页面滚动位置可按产品需要保留
### 4.2 二级页面
- 显示顶部导航和返回按钮
- 进入后覆盖当前 Tab 内容
- 返回时回到来源页面
### 4.3 抽屉与弹层
- 不应中断当前页面上下文
- 应支持手势关闭 / 点击遮罩关闭(支付与关键确认除外)
- 关闭后保留当前页面已选状态

View File

@@ -0,0 +1,164 @@
# 全局业务规则
## 1. 用户身份与登录
### 1.1 可匿名浏览的范围
- 首页
- 门店选择页
- 点餐页基础浏览
- 商品详情查看
### 1.2 必须登录 / 绑定手机号的动作
- 提交订单
- 使用优惠券、积分、储值、次卡
- 查看“我的”资产
- 查看消息中心
- 提交退款申请
- 提交评价
### 1.3 登录拦截方式
- 优先使用 `C03 登录授权弹层`
- 拦截后登录成功,应返回原业务场景继续执行
## 2. 门店与场景规则
### 2.1 场景枚举
| 值 | 名称 | 说明 |
| --- | --- | --- |
| `delivery` | 外卖配送 | 需要地址、配送范围和配送费 |
| `pickup` | 到店自提 | 需要取餐时间、取餐人信息 |
| `dine_in` | 堂食扫码 | 需要门店和桌号 |
### 2.2 门店选择规则
- 顾客必须在“某一家门店”下点单
- 同一时间购物车只属于一个门店 + 一个场景
- 切换门店时,应提示当前购物车可能清空
### 2.3 堂食规则
- 堂食优先由扫码进入
- 扫码后自动识别门店与桌号
- 堂食场景默认不展示配送地址与配送费模块
## 3. 商品与价格规则
### 3.1 商品展示规则
- 商品按分类展示
- 支持热销、招牌、新品、推荐等标签
- 商品在以下情况下显示不可售:
- 售罄
- 下架
- 超出供应时段
- 当前场景不可售
### 3.2 SKU 与规格规则
- 规格做法与加料均在商品详情抽屉中完成
- 当商品启用多规格时,价格与库存以 SKU 为准
- 如果规格变化导致库存不足,应立即提示
### 3.3 费用结构
结算时至少展示以下金额项:
- 商品金额
- 打包费
- 餐具费
- 配送费
- 优惠减免
- 实付金额
## 4. 优惠与资产规则
### 4.1 资产类型
| 类型 | 说明 |
| --- | --- |
| 优惠券 | 满减券、折扣券、免配送费券 |
| 积分 | 获取、抵扣、兑换 |
| 储值余额 | 充值后可支付订单 |
| 次卡 | 对特定商品或分类核销 |
| 会员等级 | 折扣、积分倍率、生日权益、会员日权益 |
### 4.2 资产使用原则
- 顾客端只负责展示可用资产和命中结果
- 具体叠加、互斥、优先级由后台规则决定
- 若资产不可用,必须给出原因说明
### 4.3 典型不可用原因
- 未达到金额门槛
- 不适用当前门店
- 不适用当前场景
- 不适用当前商品
- 已过期
- 已使用
## 5. 订单状态规则
### 5.1 订单状态定义
| 状态值 | 中文名称 | 说明 |
| --- | --- | --- |
| `pending_pay` | 待支付 | 已提交订单,未完成支付 |
| `paid_wait_accept` | 已支付待接单 | 等待商家处理 |
| `preparing` | 制作中 | 商家已接单,正在备餐 |
| `delivering` | 配送中 | 外卖场景履约中 |
| `wait_pickup` | 待自提 | 自提场景等待到店取餐 |
| `dine_in_serving` | 堂食进行中 | 堂食场景订单进行中 |
| `finished` | 已完成 | 订单已履约完成 |
| `refunding` | 退款中 | 售后处理中 |
| `refunded` | 已退款 | 退款已完成 |
| `closed` | 已关闭 | 超时取消或主动取消 |
### 5.2 订单动作与状态对应
- `待支付`:可继续支付、取消订单
- `已支付待接单 / 制作中`:可查看详情、催单、部分场景可申请退款
- `配送中 / 待自提 / 堂食进行中`:可查看履约信息
- `已完成`:可评价、再来一单
- `退款中 / 已退款`:可查看退款详情
## 6. 消息通知规则
### 6.1 消息分类
| 类型 | 内容范围 |
| --- | --- |
| 订单消息 | 支付成功、接单、出餐、配送、退款处理 |
| 营销消息 | 发券提醒、活动开始、会员日提醒 |
| 系统通知 | 门店公告、规则更新、服务通知 |
### 6.2 消息行为
- 未读消息需要角标或红点提示
- 进入消息详情或打开消息中心后,消息可置为已读
- 消息应能跳转到对应业务页面
## 7. 页面通用状态
所有列表页和详情页都要考虑以下状态:
- 加载态
- 空态
- 错误态
- 禁用态
- 网络重试态
### 7.1 典型空态
- 无门店可选
- 当前分类无商品
- 无可用优惠券
- 无历史订单
- 无消息
### 7.2 典型错误态
- 网络异常
- 定位失败
- 支付失败
- 加载订单失败
- 退款提交失败
## 8. 通用交互约束
- 金额统一用 `¥` 展示
- 主要 CTA 按钮固定在页面底部或区块底部
- 结算相关页面必须把金额明细解释清楚
- 场景切换、门店切换、地址切换属于高风险动作,需要在必要时提示购物车清空
- 同一页面的主要操作按钮文案要稳定,不同页面不要频繁变形

View File

@@ -0,0 +1,113 @@
# 核心用户流程
## 1. F01 外卖下单流程
### 流程目标
让用户从“选门店”顺利进入“外卖点餐”,完成地址校验、优惠结算和支付。
### 流程步骤
1. 用户进入首页
2. 系统尝试定位并推荐最近门店
3. 用户确认或切换门店
4. 用户选择 `外卖` 场景
5. 用户进入点餐页浏览商品
6. 用户打开商品详情抽屉选择规格、加料、数量
7. 用户加入购物车
8. 用户打开购物车并点击去结算
9. 进入结算确认页
10. 选择或新增配送地址
11. 系统校验配送范围、起送价、配送费
12. 用户选择优惠券 / 积分 / 储值等资产
13. 用户确认金额并支付
14. 进入支付成功页
15. 跳转订单详情查看履约进度
### 核心判断点
- 地址是否在配送范围内
- 是否达到起送门槛
- 优惠是否可用
- 当前门店是否营业
## 2. F02 自提下单流程
### 流程目标
让用户选择门店和自提时间,完成到店取餐订单。
### 流程步骤
1. 用户进入首页或点餐页
2. 选择 `自提` 场景
3. 浏览商品并加入购物车
4. 进入结算确认页
5. 选择自提时间段
6. 填写取餐人信息
7. 使用优惠资产
8. 完成支付
9. 支付成功页展示取餐时间与取餐入口
10. 订单详情页展示取餐码和门店信息
### 核心判断点
- 当前门店是否支持自提
- 所选时间段是否可预约
- 是否满足活动与优惠使用条件
## 3. F03 堂食扫码点餐流程
### 流程目标
让顾客通过扫码快速绑定桌号,进入堂食点餐和加菜流程。
### 流程步骤
1. 用户扫码进入小程序
2. 进入堂食扫码确认页
3. 系统展示门店、桌号、当前桌台信息
4. 用户确认进入堂食点餐
5. 点餐页切换为 `堂食` 场景
6. 用户选择商品、规格、加料并加入购物车
7. 进入结算确认页
8. 页面默认带出堂食门店与桌号
9. 用户确认订单并支付
10. 订单详情展示桌号和堂食状态
11. 用户可再次进入点餐页继续加菜
### 核心判断点
- 桌号是否有效
- 当前桌是否可继续点单
- 当前场景是否需要合单或追加订单展示
## 4. F04 售后与评价流程
### 流程目标
让用户在订单完成后可以评价,在履约异常时可以申请退款。
### 流程步骤 A退款
1. 用户进入订单详情页
2. 点击申请退款
3. 进入退款申请页
4. 填写退款原因与说明
5. 提交退款申请
6. 跳转退款详情页查看处理状态
### 流程步骤 B评价
1. 用户进入订单详情页
2. 点击去评价
3. 进入评价页
4. 选择星级、输入评价、上传图片、选择匿名
5. 提交评价
6. 评价成功后返回订单详情或订单列表
## 5. F05 会员与资产流程
### 流程目标
让用户在“我的”中查看和使用所有可用资产,并引导复购。
### 流程步骤
1. 用户进入我的页
2. 查看会员等级、优惠券、积分、储值、次卡摘要
3. 按需进入二级页面
- 领券中心
- 会员中心
- 积分商城
- 储值充值
- 次卡页
4. 用户领取、充值、兑换或购买资产
5. 返回点餐页或结算页使用资产

View File

@@ -0,0 +1,72 @@
# 页面清单总表
## 1. 页面总表
| 编码 | 页面名称 | 层级 | 优先级 | 场景 | 规格文件 |
| --- | --- | --- | --- | --- | --- |
| `T01` | 首页 | Tab | P0 | 全场景 | `docs/07-页面规格/01-Tab-首页.md` |
| `T02` | 点餐页 | Tab | P0 | 外卖 / 自提 / 堂食 | `docs/07-页面规格/02-Tab-点餐页.md` |
| `T03` | 订单页 | Tab | P0 | 全场景 | `docs/07-页面规格/03-Tab-订单页.md` |
| `T04` | 我的页 | Tab | P0 | 全场景 | `docs/07-页面规格/04-Tab-我的页.md` |
| `P01` | 门店选择页 | 二级页 | P1 | 全场景 | `docs/07-页面规格/05-门店选择页.md` |
| `P02` | 地址管理页 | 二级页 | P1 | 外卖 | `docs/07-页面规格/06-地址管理页.md` |
| `C01` | 商品详情抽屉 | 抽屉 | P0 | 点餐 | `docs/07-页面规格/07-商品详情抽屉.md` |
| `C02` | 购物车抽屉 | 抽屉 | P0 | 点餐 | `docs/07-页面规格/08-购物车抽屉.md` |
| `P03` | 结算确认页 | 二级页 | P0 | 外卖 / 自提 / 堂食 | `docs/07-页面规格/09-结算确认页.md` |
| `P04` | 支付成功页 | 二级页 | P0 | 全场景 | `docs/07-页面规格/10-支付成功页.md` |
| `P05` | 订单详情页 | 二级页 | P0 | 全场景 | `docs/07-页面规格/11-订单详情页.md` |
| `P06` | 退款申请页 | 二级页 | P1 | 订单售后 | `docs/07-页面规格/12-退款申请页.md` |
| `P07` | 退款详情页 | 二级页 | P1 | 订单售后 | `docs/07-页面规格/13-退款详情页.md` |
| `P08` | 评价页 | 二级页 | P1 | 已完成订单 | `docs/07-页面规格/14-评价页.md` |
| `P09` | 领券中心页 | 二级页 | P1 | 会员营销 | `docs/07-页面规格/15-领券中心页.md` |
| `P10` | 秒杀活动页 | 二级页 | P1 | 营销活动 | `docs/07-页面规格/16-秒杀活动页.md` |
| `P11` | 限时折扣活动页 | 二级页 | P1 | 营销活动 | `docs/07-页面规格/17-限时折扣活动页.md` |
| `P12` | 会员中心页 | 二级页 | P1 | 会员 | `docs/07-页面规格/18-会员中心页.md` |
| `P13` | 积分商城页 | 二级页 | P1 | 积分 | `docs/07-页面规格/19-积分商城页.md` |
| `P14` | 储值充值页 | 二级页 | P1 | 储值 | `docs/07-页面规格/20-储值充值页.md` |
| `P15` | 次卡页 | 二级页 | P1 | 次卡 | `docs/07-页面规格/21-次卡页.md` |
| `P16` | 消息中心页 | 二级页 | P1 | 全场景 | `docs/07-页面规格/22-消息中心页.md` |
| `P17` | 帮助中心页 | 二级页 | P2 | 全场景 | `docs/07-页面规格/23-帮助中心页.md` |
| `P18` | 堂食扫码确认页 | 二级页 | P0 | 堂食 | `docs/07-页面规格/24-堂食扫码确认页.md` |
## 2. 组件级清单
| 编码 | 名称 | 优先级 | 规格文件 |
| --- | --- | --- | --- |
| `C01` | 商品详情抽屉 | P0 | `docs/07-页面规格/07-商品详情抽屉.md` |
| `C02` | 购物车抽屉 | P0 | `docs/07-页面规格/08-购物车抽屉.md` |
## 3. 推荐实现顺序
### 第一阶段:交易闭环
- `T01` 首页
- `T02` 点餐页
- `C01` 商品详情抽屉
- `C02` 购物车抽屉
- `P03` 结算确认页
- `P04` 支付成功页
- `T03` 订单页
- `P05` 订单详情页
### 第二阶段:履约与售后
- `P06` 退款申请页
- `P07` 退款详情页
- `P08` 评价页
### 第三阶段:资产与增长
- `T04` 我的页
- `P09` 领券中心页
- `P10` 秒杀活动页
- `P11` 限时折扣活动页
- `P12` 会员中心页
- `P13` 积分商城页
- `P14` 储值充值页
- `P15` 次卡页
### 第四阶段:辅助页
- `P01` 门店选择页
- `P02` 地址管理页
- `P16` 消息中心页
- `P17` 帮助中心页
- `P18` 堂食扫码确认页

View File

@@ -0,0 +1,69 @@
# 通用组件清单
## 1. 说明
以下组件建议在实现时先抽象出来,避免每个页面重复拼装。
页面规格文档会引用这些通用组件。
## 2. 全局组件
| 编码 | 组件名称 | 用途 | 必备状态 |
| --- | --- | --- | --- |
| `G01` | 顶部导航栏 | 二级页面返回、标题展示 | 默认态 |
| `G02` | 底部 TabBar | Tab 页面切换 | 选中 / 未选中 |
| `G03` | 页面空态卡片 | 列表为空时提示 | 图标 / 文案 / CTA |
| `G04` | 页面错误卡片 | 网络错误、加载失败时提示 | 错误文案 / 重试 |
| `G05` | 状态标签 Tag | 订单状态、活动状态、会员状态 | 多色标签 |
## 3. 门店与场景组件
| 编码 | 组件名称 | 用途 | 使用页面 |
| --- | --- | --- | --- |
| `G10` | 门店切换条 | 显示当前门店,点击切换 | 首页、点餐页 |
| `G11` | 场景切换条 | 外卖 / 自提 / 堂食切换 | 首页、点餐页 |
| `G12` | 门店信息卡 | 地址、营业、距离、电话 | 首页、结算页、堂食确认页 |
| `G13` | 服务规则条 | 起送价、配送费、自提规则等 | 首页、点餐页、结算页 |
## 4. 商品与购物车组件
| 编码 | 组件名称 | 用途 | 使用页面 |
| --- | --- | --- | --- |
| `G20` | 分类侧边栏 / 顶部分类条 | 分类浏览商品 | 点餐页 |
| `G21` | 商品卡片 | 展示图片、价格、标签、加购按钮 | 点餐页、活动页 |
| `G22` | 数量步进器 | 商品数量增减 | 点餐页、商品详情、购物车 |
| `G23` | 规格选项组 | 规格做法单选/多选 | 商品详情抽屉 |
| `G24` | 加料选项组 | 附加项选择 | 商品详情抽屉 |
| `G25` | 底部购物车栏 | 已选数量、金额、去结算按钮 | 点餐页 |
| `G26` | 购物车商品行 | 展示已选商品和规格组合 | 购物车抽屉 |
## 5. 结算与订单组件
| 编码 | 组件名称 | 用途 | 使用页面 |
| --- | --- | --- | --- |
| `G30` | 地址卡片 | 展示收货地址或取餐信息 | 结算页 |
| `G31` | 费用明细卡 | 展示金额构成 | 结算页、订单详情页 |
| `G32` | 优惠资产单元格 | 展示优惠券 / 积分 / 余额入口 | 结算页 |
| `G33` | 订单摘要卡 | 展示门店、商品、金额、状态 | 订单页 |
| `G34` | 订单时间轴 | 展示履约节点 | 订单详情页、退款详情页 |
| `G35` | 固定底部操作栏 | 继续支付、催单、退款、评价等 CTA | 结算页、订单详情页 |
## 6. 资产与服务组件
| 编码 | 组件名称 | 用途 | 使用页面 |
| --- | --- | --- | --- |
| `G40` | 用户头部卡 | 头像、昵称、会员等级 | 我的页、会员中心 |
| `G41` | 资产总览卡 | 券、积分、余额、次卡摘要 | 我的页 |
| `G42` | 资产列表项 | 进入券、积分、储值、次卡详情 | 我的页 |
| `G43` | 活动券卡片 | 满减券、折扣券、免配送费券 | 领券中心 |
| `G44` | 充值方案卡 | 展示充值金额、赠送金额、到账金额 | 储值充值页 |
| `G45` | 次卡卡片 | 展示次卡名称、剩余次数、有效期 | 次卡页 |
| `G46` | 消息列表项 | 展示消息标题、摘要、时间、未读状态 | 消息中心 |
## 7. 通用实现要求
- 所有卡片组件需要支持禁用态或不可点击态
- 列表项需要支持右侧箭头、辅助文案、角标等变化
- 底部固定操作栏需要考虑安全区
- 金额展示组件统一格式化
- 状态标签颜色语义在整个应用中保持一致

View File

@@ -0,0 +1,101 @@
# T01 首页
- 页面编码:`T01`
- 页面层级:`Tab`
- 适用场景:`外卖 / 自提 / 堂食导流`
- 页面目标:完成选店、选场景、看活动、快速进入点餐
- 主要依赖组件:`G02``G10``G11``G12``G13``G21`
## 1. 页面结构(从上到下)
1. 顶部信息区
2. 门店切换条
3. 场景切换条
4. Banner 活动区
5. 快捷入口区
6. 推荐商品区
7. 门店服务信息区
## 2. 区块说明
### 2.1 顶部信息区
- 左侧显示当前位置 / 当前门店简称
- 右侧显示消息入口
- 点击门店或位置进入 `P01 门店选择页`
- 点击消息入口进入 `P16 消息中心页`
### 2.2 门店切换条
- 使用 `G10`
- 显示当前门店名称、营业状态、距离
- 支持点击切换门店
### 2.3 场景切换条
- 使用 `G11`
- 固定提供 `外卖``自提``堂食` 三项
- 切换后刷新下方活动和推荐内容
### 2.4 Banner 活动区
- 展示门店主推活动轮播
- Banner 点击可跳转:
- `P09 领券中心页`
- `P10 秒杀活动页`
- `P11 限时折扣活动页`
- `P12 会员中心页`
### 2.5 快捷入口区
- 建议 2 行网格或 1 行宫格
- 包含以下入口:
- 新客有礼
- 领券中心
- 满减活动
- 秒杀专区
- 限时折扣
- 储值充值
- 次卡专区
- 会员中心
### 2.6 推荐商品区
- 按顺序展示:
- 热销推荐
- 套餐推荐
- 复购推荐
- 猜你喜欢
- 每个区块使用横滑或纵向卡片列表
- 商品卡点击进入 `C01 商品详情抽屉`
### 2.7 门店服务信息区
- 使用 `G12` + `G13`
- 展示:
- 营业时间
- 配送范围 / 起送价 / 配送费
- 自提规则
- 堂食规则
- 联系门店
- 到店导航
## 3. 页面主动作
- 切换门店
- 切换场景
- 进入点餐页
- 进入活动页
- 打开商品详情
## 4. 页面状态
### 默认态
- 有门店、有活动、有推荐商品
### 空态
- 无可用门店时展示空态,并提供重新定位
- 无活动时隐藏活动区,保留推荐区
### 异常态
- 定位失败时提示手动选店
- 门店休息时展示“休息中”,但可保留浏览
## 5. 实现备注
- 首页优先是“导流页”,不是深度浏览页
- 推荐商品只展示摘要,不在首页直接承载复杂选配

View File

@@ -0,0 +1,94 @@
# T02 点餐页
- 页面编码:`T02`
- 页面层级:`Tab`
- 适用场景:`外卖 / 自提 / 堂食`
- 页面目标:完成商品浏览、选配、加购和进入结算
- 主要依赖组件:`G10``G11``G20``G21``G22``G25`
## 1. 页面结构(从上到下)
1. 顶部门店条
2. 场景切换条
3. 搜索与活动提示条
4. 菜单主区域
5. 底部购物车栏
## 2. 区块说明
### 2.1 顶部门店条
- 显示当前门店名称、营业状态
- 点击进入 `P01 门店选择页`
- 门店切换需要提示购物车风险
### 2.2 场景切换条
- 显示 `外卖 / 自提 / 堂食`
- 切换时刷新:
- 商品可售状态
- 服务规则说明
- 价格与优惠提示
### 2.3 搜索与活动提示条
- 搜索框:按商品名搜索
- 活动条:显示当前命中的满减、秒杀、折扣等活动摘要
### 2.4 菜单主区域
- 左侧或顶部为分类导航 `G20`
- 右侧或主体为商品列表
- 每个商品卡 `G21` 展示:
- 图片
- 名称
- 描述摘要
- 标签
- 价格 / 划线价
- 加购按钮
- 点击商品卡进入 `C01 商品详情抽屉`
- 直接点击步进器可快速加购默认 SKU
### 2.5 底部购物车栏
- 使用 `G25`
- 展示:
- 已选商品件数
- 当前总金额
- 差多少起送 / 差多少免配送费
- 去结算按钮
- 点击购物车区域打开 `C02 购物车抽屉`
## 3. 场景差异规则
### 外卖场景
- 突出显示配送费、起送价、预计送达
### 自提场景
- 突出显示自提优惠、自提时段说明
### 堂食场景
- 突出显示桌号、当前门店、可加菜提示
## 4. 页面主动作
- 切换门店
- 切换场景
- 搜索商品
- 打开商品详情抽屉
- 打开购物车抽屉
- 进入结算确认页
## 5. 页面状态
### 默认态
- 有分类、有商品、有活动提示
### 空态
- 某分类无商品时,右侧显示空态
- 搜索无结果时,提供清空搜索入口
### 异常态
- 当前门店休息:商品可浏览但不能结算
- 商品售罄:显示禁用状态,不能加购
## 6. 实现备注
- 点餐页是整套小程序最核心页面,需要优先保证信息密度和操作效率
- 商品详情、购物车应通过抽屉承载,尽量不跳转新页面

View File

@@ -0,0 +1,64 @@
# T03 订单页
- 页面编码:`T03`
- 页面层级:`Tab`
- 适用场景:`全场景`
- 页面目标:让用户快速找到订单,并查看履约、售后和复购入口
- 主要依赖组件:`G05``G33`
## 1. 页面结构(从上到下)
1. 顶部状态筛选区
2. 场景筛选区(可选)
3. 订单列表区
## 2. 区块说明
### 2.1 顶部状态筛选区
- 建议分段控件或横向标签
- 至少包含:
- 全部
- 待支付
- 进行中
- 已完成
- 退款售后
### 2.2 场景筛选区
- 可按 `外卖 / 自提 / 堂食` 进行二次筛选
- 也可与状态整合为一个过滤区
### 2.3 订单列表区
- 每张订单卡使用 `G33`
- 订单卡必须展示:
- 门店名称
- 订单状态
- 场景标签
- 商品摘要
- 订单金额
- 下单时间
- 主要操作按钮
- 订单卡点击进入 `P05 订单详情页`
## 3. 订单卡动作规则
- `待支付`:继续支付、取消订单
- `进行中`:查看详情、催单、查看取餐码
- `已完成`:评价、再来一单
- `退款售后`:查看退款详情
## 4. 页面状态
### 默认态
- 有订单列表
### 空态
- 某筛选条件下无订单时,展示空态和“去点餐” CTA
### 异常态
- 加载失败时展示重试
## 5. 实现备注
- 订单页重点是列表可扫读性
- 一屏内要能快速看懂状态、门店、金额和下一步动作

View File

@@ -0,0 +1,78 @@
# T04 我的页
- 页面编码:`T04`
- 页面层级:`Tab`
- 适用场景:`全场景`
- 页面目标:集中展示用户身份、资产、服务和复购入口
- 主要依赖组件:`G40``G41``G42`
## 1. 页面结构(从上到下)
1. 用户头部卡
2. 资产总览区
3. 订单快捷入口区
4. 会员与增长入口区
5. 服务入口区
6. 复购推荐区
## 2. 区块说明
### 2.1 用户头部卡
- 使用 `G40`
- 展示:
- 头像
- 昵称
- 会员等级
- 成长值进度摘要
### 2.2 资产总览区
- 使用 `G41`
- 展示:
- 优惠券数量
- 积分余额
- 储值余额
- 次卡数量 / 剩余次数摘要
### 2.3 订单快捷入口区
- 展示:
- 待支付
- 进行中
- 已完成
- 售后 / 退款
- 点击后跳转 `T03 订单页` 对应筛选状态
### 2.4 会员与增长入口区
- 使用 `G42`
- 入口包含:
- 会员中心
- 领券中心
- 积分商城
- 储值充值
- 次卡页
### 2.5 服务入口区
- 包含:
- 地址管理
- 消息中心
- 帮助中心
- 联系客服
- 协议与隐私
### 2.6 复购推荐区
- 展示最近订单和常点商品
- 提供“再来一单”入口
## 3. 页面状态
### 登录态
- 展示完整资产与服务
### 未登录态
- 展示基础入口
- 资产卡片改为“登录后查看”
## 4. 实现备注
- “我的”页要兼顾资产页和服务页
- 顶部头部卡与资产总览区需要在视觉上形成核心焦点

View File

@@ -0,0 +1,52 @@
# P01 门店选择页
- 页面编码:`P01`
- 页面层级:`二级页`
- 页面目标:让用户选择合适门店,并明确当前场景是否可服务
- 主要依赖组件:`G01``G12`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 搜索区
3. 场景筛选区
4. 当前定位结果区
5. 门店列表区
## 2. 区块说明
### 2.1 搜索区
- 支持按门店名称、商圈关键词搜索
### 2.2 场景筛选区
-`外卖 / 自提 / 堂食` 过滤门店
### 2.3 当前定位结果区
- 显示当前定位城市 / 坐标结果
- 提供重新定位动作
### 2.4 门店列表区
- 每个门店卡展示:
- 门店名称
- 距离
- 营业状态
- 地址
- 场景支持标签
- 起送价 / 配送费 / 自提 / 堂食提示
- 点击门店即切换当前门店并返回来源页
## 3. 页面状态
### 默认态
- 有门店列表
### 空态
- 搜索无结果或当前区域无门店
### 异常态
- 定位失败时只展示手动选店模式
## 4. 实现备注
- 门店列表要把“能否下单”说清楚,不仅展示名字

View File

@@ -0,0 +1,47 @@
# P02 地址管理页
- 页面编码:`P02`
- 页面层级:`二级页`
- 页面目标:管理顾客常用收货地址,并服务外卖结算
- 主要依赖组件:`G01`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 地址列表区
3. 新增地址按钮
## 2. 区块说明
### 2.1 地址列表区
- 每个地址项展示:
- 收货人姓名
- 手机号
- 详细地址
- 默认地址标签
- 适用范围提示(可选)
- 支持动作:
- 设为默认
- 编辑
- 删除
- 选择用于本次结算
### 2.2 新增地址按钮
- 固定在页面底部或列表底部
- 点击后进入编辑态(可独立页或表单弹层)
## 3. 页面状态
### 默认态
- 展示已有地址
### 空态
- 无地址时展示空态和新增 CTA
### 异常态
- 地址保存失败 / 删除失败时需要提示
## 4. 实现备注
- 如果另一位 AI 需要拆成“地址列表页 + 地址编辑页”,可以追加子页面,但当前文档以一个管理页为主

View File

@@ -0,0 +1,58 @@
# C01 商品详情抽屉
- 页面编码:`C01`
- 页面层级:`组件级抽屉`
- 页面目标:完成商品选配,并把用户送入购物车
- 主要依赖组件:`G22``G23``G24`
## 1. 抽屉结构(从上到下)
1. 商品图片区
2. 商品基础信息区
3. 规格做法区
4. 加料区
5. 数量与金额区
6. 底部主操作区
## 2. 区块说明
### 2.1 商品图片区
- 展示主图,允许左右切换附图(可选)
### 2.2 商品基础信息区
- 展示:
- 商品名称
- 标签
- 描述
- 售价
- 划线价
- 月售 / 热销信息(可选)
### 2.3 规格做法区
- 使用 `G23`
- 支持单选 / 多组单选
- 选择后实时刷新价格和库存
### 2.4 加料区
- 使用 `G24`
- 支持多选和附加价格
### 2.5 数量与金额区
- 使用 `G22`
- 实时展示当前组合总价
### 2.6 底部主操作区
- 主按钮:加入购物车
- 次按钮:立即购买(可选)
## 3. 状态规则
- 规格未选全时,主按钮不可用
- 商品售罄时,显示不可售状态
- 库存不足时,数量步进器受限
## 4. 实现备注
- 抽屉应保留当前点餐页上下文
- 关闭抽屉不应导致列表位置丢失

View File

@@ -0,0 +1,51 @@
# C02 购物车抽屉
- 页面编码:`C02`
- 页面层级:`组件级抽屉`
- 页面目标:集中展示当前已选商品,并提供进入结算的最后一步确认
- 主要依赖组件:`G22``G26`
## 1. 抽屉结构(从上到下)
1. 购物车头部
2. 商品列表区
3. 优惠与凑单提示区
4. 底部结算区
## 2. 区块说明
### 2.1 购物车头部
- 显示当前门店名
- 显示“已选商品”标题
- 提供清空购物车按钮
### 2.2 商品列表区
- 每个商品行使用 `G26`
- 展示:
- 商品名
- 规格摘要
- 加料摘要
- 单价
- 数量步进器
### 2.3 优惠与凑单提示区
- 展示:
- 满减差额
- 起送差额
- 免配送费差额
- 已命中活动摘要
### 2.4 底部结算区
- 展示总金额
- 主按钮:去结算
## 3. 状态规则
- 空购物车时展示空态
- 商品失效时需标记并禁止结算,或提示清理失效商品
## 4. 实现备注
- 购物车抽屉必须支持快速修改数量
- 去结算按钮应只保留一个主路径,不做复杂分支

View File

@@ -0,0 +1,72 @@
# P03 结算确认页
- 页面编码:`P03`
- 页面层级:`二级页`
- 适用场景:`外卖 / 自提 / 堂食`
- 页面目标:让用户确认履约信息、优惠和金额,并完成支付
- 主要依赖组件:`G01``G30``G31``G32``G35`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 场景信息卡
3. 商品清单区
4. 优惠资产区
5. 备注与附加信息区
6. 费用明细区
7. 底部支付栏
## 2. 区块说明
### 2.1 场景信息卡
- 外卖:展示收货地址、预计送达
- 自提:展示门店、自提时间、取餐人信息
- 堂食:展示门店、桌号、堂食说明
### 2.2 商品清单区
- 展示商品、规格、加料、数量、小计
### 2.3 优惠资产区
- 使用 `G32`
- 入口包含:
- 优惠券选择
- 积分抵扣
- 储值余额支付
- 次卡核销(适用时)
### 2.4 备注与附加信息区
- 订单备注
- 餐具选择
- 其他补充字段(按场景可选)
### 2.5 费用明细区
- 使用 `G31`
- 必须清楚展示所有金额构成
### 2.6 底部支付栏
- 使用 `G35`
- 左侧显示实付金额
- 右侧主按钮:提交订单并支付
## 3. 场景差异
### 外卖
- 必须完成地址校验、起送价校验
### 自提
- 必须完成自提时间选择和取餐人信息校验
### 堂食
- 必须展示桌号,不展示配送相关字段
## 4. 页面状态
- 优惠不可用时展示原因
- 地址超范围时禁止提交
- 门店休息时禁止支付
## 5. 实现备注
- 结算页核心是“信息确认 + 金额确认”
- 所有会影响实付金额的项目都必须可见

View File

@@ -0,0 +1,42 @@
# P04 支付成功页
- 页面编码:`P04`
- 页面层级:`二级页`
- 页面目标:明确告诉用户支付已完成,并引导后续查看订单或继续点单
- 主要依赖组件:`G01`
## 1. 页面结构(从上到下)
1. 成功状态区
2. 订单摘要区
3. 场景关键信息区
4. 后续动作区
## 2. 区块说明
### 2.1 成功状态区
- 成功图标
- 标题:支付成功
- 副文案:订单已提交,等待商家处理
### 2.2 订单摘要区
- 展示订单号、门店名称、支付金额
### 2.3 场景关键信息区
- 外卖:预计送达时间
- 自提:取餐时间和取餐说明
- 堂食:桌号与用餐状态
### 2.4 后续动作区
- 查看订单详情
- 继续点餐 / 再逛逛
## 3. 页面状态
- 支付成功为唯一主状态
- 若返回支付结果异常,应回退到结算页或订单详情页校验状态
## 4. 实现备注
- 成功页停留时间不宜过长,应明确给出下一步 CTA

View File

@@ -0,0 +1,71 @@
# P05 订单详情页
- 页面编码:`P05`
- 页面层级:`二级页`
- 页面目标:完整承接订单履约、售后和复购动作
- 主要依赖组件:`G01``G31``G34``G35`
## 1. 页面结构(从上到下)
1. 顶部状态头图区
2. 场景信息区
3. 履约时间轴区
4. 商品清单区
5. 费用明细区
6. 订单基础信息区
7. 底部操作栏
## 2. 区块说明
### 2.1 顶部状态头图区
- 展示当前状态文案与辅助说明
- 示例:
- 待支付
- 商家已接单
- 制作中
- 配送中
- 待自提
- 已完成
- 退款中
### 2.2 场景信息区
- 外卖:收货地址、骑手状态、预计送达
- 自提:取餐码、取餐时间、门店信息
- 堂食:桌号、门店、是否可继续加菜
### 2.3 履约时间轴区
- 使用 `G34`
- 展示订单关键节点时间
### 2.4 商品清单区
- 展示商品、规格、加料、数量
### 2.5 费用明细区
- 使用 `G31`
- 展示所有金额构成
### 2.6 订单基础信息区
- 展示订单号、下单时间、支付方式、支付时间等
### 2.7 底部操作栏
- 使用 `G35`
- 动作随状态变化:
- 继续支付
- 取消订单
- 催单
- 申请退款
- 去评价
- 再来一单
## 3. 页面状态
- 待支付态
- 履约进行态
- 已完成态
- 退款中态
- 已退款态
## 4. 实现备注
- 订单详情页是强状态页面,顶部状态区必须足够明确

View File

@@ -0,0 +1,46 @@
# P06 退款申请页
- 页面编码:`P06`
- 页面层级:`二级页`
- 页面目标:让用户提交退款原因与说明,进入售后流程
- 主要依赖组件:`G01`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 可退款订单摘要区
3. 退款原因区
4. 补充说明区
5. 提交按钮区
## 2. 区块说明
### 2.1 可退款订单摘要区
- 展示门店、订单号、商品摘要、当前可退金额
### 2.2 退款原因区
- 提供预设原因列表
- 例如:
- 商品与描述不符
- 配送超时
- 少送漏送
- 不想要了
- 其他原因
### 2.3 补充说明区
- 文本输入框
- 可选上传凭证图片(如另一位 AI 需要扩展)
### 2.4 提交按钮区
- 主按钮:提交退款申请
## 3. 页面状态
- 原因未选时按钮不可提交
- 提交中显示 loading
- 提交成功后跳转 `P07 退款详情页`
## 4. 实现备注
- 页面目标是低阻力提交,不宜放过多冗余字段

View File

@@ -0,0 +1,47 @@
# P07 退款详情页
- 页面编码:`P07`
- 页面层级:`二级页`
- 页面目标:展示退款申请的当前处理状态、时间轴和处理结果
- 主要依赖组件:`G01``G34`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 退款状态头图区
3. 退款金额与原因区
4. 退款时间轴区
5. 订单关联信息区
## 2. 区块说明
### 2.1 退款状态头图区
- 展示当前退款状态:
- 已提交
- 处理中
- 已退款
- 已拒绝
- 同时展示简要说明文案
### 2.2 退款金额与原因区
- 展示退款金额
- 展示退款原因与用户补充说明
### 2.3 退款时间轴区
- 使用 `G34`
- 展示:申请时间、商家处理时间、退款完成时间等
### 2.4 订单关联信息区
- 展示订单号、门店、商品摘要
- 提供返回订单详情的入口
## 3. 页面状态
- 处理中
- 已退款
- 已拒绝
## 4. 实现备注
- 拒绝状态必须明确展示驳回原因

View File

@@ -0,0 +1,56 @@
# P08 评价页
- 页面编码:`P08`
- 页面层级:`二级页`
- 页面目标:完成订单评价,并引导商家回复与评价奖励闭环
- 主要依赖组件:`G01`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 订单摘要区
3. 星级评分区
4. 快捷评价标签区
5. 文本评价区
6. 图片上传区
7. 匿名开关区
8. 提交按钮区
## 2. 区块说明
### 2.1 订单摘要区
- 展示门店名称和商品摘要
### 2.2 星级评分区
- 选择 1-5 星
- 星级变化可联动文案提示
### 2.3 快捷评价标签区
- 根据评分展示标签
- 例如:
- 味道不错
- 包装精致
- 配送很快
- 分量足
### 2.4 文本评价区
- 支持自由输入评价内容
### 2.5 图片上传区
- 支持晒单图片上传
### 2.6 匿名开关区
- 允许用户匿名评价
### 2.7 提交按钮区
- 主按钮:提交评价
## 3. 页面状态
- 未评分时按钮不可提交
- 提交成功后提示是否返回订单详情或继续浏览
## 4. 实现备注
- 评价成功后可弹出“获得积分”提示,但不应阻塞主流程

View File

@@ -0,0 +1,42 @@
# P09 领券中心页
- 页面编码:`P09`
- 页面层级:`二级页`
- 页面目标:集中展示可领取优惠券,并引导回到点餐使用
- 主要依赖组件:`G01``G43`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 券分类筛选区
3. 优惠券列表区
4. 底部引导区
## 2. 区块说明
### 2.1 券分类筛选区
- 可按全部、满减券、折扣券、免配送费券筛选
### 2.2 优惠券列表区
- 使用 `G43`
- 每张券卡必须展示:
- 券名称
- 金额 / 折扣
- 使用门槛
- 有效期
- 适用门店 / 场景
- 领取状态
### 2.3 底部引导区
- 提供“去点餐”入口
## 3. 页面状态
- 默认态:有可领取券
- 空态:无券可领
- 已领取态:按钮改为已领取或去使用
## 4. 实现备注
- 领取动作应尽量轻量,领取成功后不强制跳转

View File

@@ -0,0 +1,41 @@
# P10 秒杀活动页
- 页面编码:`P10`
- 页面层级:`二级页`
- 页面目标:承接强时效抢购活动,提升转化
- 主要依赖组件:`G01``G21`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 秒杀头图区
3. 场次切换区
4. 秒杀商品列表区
## 2. 区块说明
### 2.1 秒杀头图区
- 展示活动标题、主视觉、倒计时
### 2.2 场次切换区
- 展示当前场次、即将开始场次、已结束场次
### 2.3 秒杀商品列表区
- 商品卡展示:
- 商品图片
- 秒杀价
- 原价
- 剩余库存 / 已售比例
- 每单限购
- 立即抢购
## 3. 页面状态
- 未开始态
- 进行中态
- 已结束态
## 4. 实现备注
- 秒杀页要突出时间紧迫感和库存稀缺感

View File

@@ -0,0 +1,43 @@
# P11 限时折扣活动页
- 页面编码:`P11`
- 页面层级:`二级页`
- 页面目标:承接限时折扣活动,集中展示折扣商品
- 主要依赖组件:`G01``G21`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 活动头图区
3. 活动时间筛选区
4. 折扣商品列表区
## 2. 区块说明
### 2.1 活动头图区
- 展示活动标题、当前折扣主题、时间说明
### 2.2 活动时间筛选区
- 当前进行中
- 即将开始
- 已结束
### 2.3 折扣商品列表区
- 商品卡展示:
- 图片
- 商品名称
- 折扣价
- 原价
- 折扣力度
- 立即购买
## 3. 页面状态
- 进行中:可购买
- 未开始:展示开始时间
- 已结束:置灰展示
## 4. 实现备注
- 与秒杀页相比,限时折扣页要弱化“抢”,强化“省”

View File

@@ -0,0 +1,47 @@
# P12 会员中心页
- 页面编码:`P12`
- 页面层级:`二级页`
- 页面目标:展示会员等级、成长值、权益和升级路径
- 主要依赖组件:`G01``G40`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 会员头部卡
3. 成长值进度区
4. 权益总览区
5. 等级说明区
6. 会员日 / 生日权益区
## 2. 区块说明
### 2.1 会员头部卡
- 展示头像、昵称、当前会员等级、等级标识
### 2.2 成长值进度区
- 展示当前成长值
- 展示距离下一等级差值
### 2.3 权益总览区
- 展示当前可享权益:
- 会员折扣
- 积分倍率
- 生日权益
- 会员日权益
### 2.4 等级说明区
- 展示各等级及对应权益
### 2.5 会员日 / 生日权益区
- 单独说明会员日和生日特权
## 3. 页面状态
- 已登录会员态
- 未登录提示态
## 4. 实现备注
- 会员中心要重点突出“当前能享受什么”和“如何升级”

View File

@@ -0,0 +1,44 @@
# P13 积分商城页
- 页面编码:`P13`
- 页面层级:`二级页`
- 页面目标:展示积分余额、可兑换商品和兑换记录
- 主要依赖组件:`G01`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 积分余额头部区
3. Tab 切换区
4. 兑换商品列表区 / 兑换记录区
## 2. 区块说明
### 2.1 积分余额头部区
- 展示当前积分余额
- 展示积分获取说明入口(可选)
### 2.2 Tab 切换区
- 兑换商品
- 兑换记录
### 2.3 兑换商品列表区
- 商品卡展示:
- 商品图片
- 商品名称
- 所需积分
- 库存 / 数量说明
- 立即兑换
### 2.4 兑换记录区
- 展示兑换时间、兑换内容、状态
## 3. 页面状态
- 默认态:有商品可兑
- 空态:暂无可兑换商品
## 4. 实现备注
- 积分商城强调“积分能干什么”,不要只展示数值

View File

@@ -0,0 +1,44 @@
# P14 储值充值页
- 页面编码:`P14`
- 页面层级:`二级页`
- 页面目标:展示储值余额、充值方案和充值记录
- 主要依赖组件:`G01``G44`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 储值余额区
3. 充值方案区
4. 充值记录区
5. 底部支付区
## 2. 区块说明
### 2.1 储值余额区
- 展示当前可用余额
- 可补充说明实充与赠送余额(如有)
### 2.2 充值方案区
- 使用 `G44`
- 每张方案卡展示:
- 充值金额
- 赠送金额
- 到账金额
### 2.3 充值记录区
- 展示最近充值记录
- 包含:时间、支付方式、到账金额
### 2.4 底部支付区
- 主按钮:立即充值
## 3. 页面状态
- 默认态:有方案可选
- 空态:暂无充值方案
## 4. 实现备注
- 充值金额、赠送金额、到账金额三者必须同时可见

View File

@@ -0,0 +1,38 @@
# P15 次卡页
- 页面编码:`P15`
- 页面层级:`二级页`
- 页面目标:展示可购买次卡、已购次卡和核销记录
- 主要依赖组件:`G01``G45`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. Tab 切换区
3. 次卡列表区
## 2. 区块说明
### 2.1 Tab 切换区
- 可购买次卡
- 我的次卡
- 使用记录(可选)
### 2.2 次卡列表区
- 使用 `G45`
- 次卡卡片展示:
- 次卡名称
- 适用范围
- 有效期
- 剩余次数 / 总次数
- 购买或查看详情按钮
## 3. 页面状态
- 默认态:有可购或已购次卡
- 空态:暂无次卡
## 4. 实现备注
- 次卡页需要把“适用什么商品”和“还剩几次”表达清楚

View File

@@ -0,0 +1,39 @@
# P16 消息中心页
- 页面编码:`P16`
- 页面层级:`二级页`
- 页面目标:集中查看订单消息、营销消息和系统通知
- 主要依赖组件:`G01``G46`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 消息分类切换区
3. 消息列表区
## 2. 区块说明
### 2.1 消息分类切换区
- 全部
- 订单消息
- 营销消息
- 系统通知
### 2.2 消息列表区
- 使用 `G46`
- 每条消息展示:
- 标题
- 摘要
- 时间
- 未读状态
- 点击消息跳转到对应业务页面
## 3. 页面状态
- 默认态:有消息
- 空态:暂无消息
## 4. 实现备注
- 消息要支持按读写状态区分,但不需要复杂会话系统

View File

@@ -0,0 +1,44 @@
# P17 帮助中心页
- 页面编码:`P17`
- 页面层级:`二级页`
- 页面目标:承接常见问题、规则说明和客服联系
- 主要依赖组件:`G01`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 常见问题区
3. 专题帮助区
4. 联系客服区
## 2. 区块说明
### 2.1 常见问题区
- 以折叠列表形式展示
- 建议覆盖:
- 如何下单
- 如何使用优惠券
- 如何申请退款
- 如何查看取餐码
### 2.2 专题帮助区
- 支付帮助
- 配送帮助
- 自提帮助
- 堂食帮助
- 会员与资产帮助
### 2.3 联系客服区
- 在线客服入口
- 电话客服入口
## 3. 页面状态
- 默认态即可
- 若帮助内容为空,则展示联系客服入口
## 4. 实现备注
- 帮助中心主要作为兜底服务页,不需要复杂交互

View File

@@ -0,0 +1,47 @@
# P18 堂食扫码确认页
- 页面编码:`P18`
- 页面层级:`二级页`
- 页面目标:在扫码后确认门店与桌号,并把用户送入堂食点餐页
- 主要依赖组件:`G01``G12`
## 1. 页面结构(从上到下)
1. 顶部导航栏
2. 扫码结果确认卡
3. 堂食规则说明区
4. 当前桌台状态区(可选)
5. 主操作区
## 2. 区块说明
### 2.1 扫码结果确认卡
- 展示:
- 门店名称
- 桌号 / 桌台编号
- 是否可点餐
### 2.2 堂食规则说明区
- 展示:
- 是否先付款
- 是否支持加菜
- 是否支持合单
- 结账方式说明
### 2.3 当前桌台状态区
- 如已有订单,可提示当前桌存在进行中订单
### 2.4 主操作区
- 主按钮:进入堂食点餐
- 次按钮:重新扫码 / 切换桌号(如需要)
## 3. 页面状态
- 正常可入桌
- 桌号失效
- 当前桌不可用
## 4. 实现备注
- 该页要尽量减少用户输入,优先自动确认门店和桌号

View File

@@ -0,0 +1,264 @@
# 全周期版本规划与范围分层
- 文档版本:`V1.0`
- 适用项目:`TakeoutSaaS` 小程序 C 端
- 文档目标:基于现有租户后台能力与 C 端页面规格,定义小程序从原型期到成熟期的完整版本路径
---
## 1. 文档目的
本文件不再只回答“一期先做什么”,而是回答以下 3 个问题:
1. 小程序 C 端全周期应该按什么节奏推进
2. 每个版本解决什么用户问题、承接什么后台能力
3. 哪些能力属于当前页内实现,哪些能力属于未来扩展
本文件与 `docs/05-页面清单总表.md``docs/09-租户后台与C端功能映射总表.md``docs/10-全周期研发实施顺序与交付清单.md` 配合使用。
---
## 2. 全周期总览
| 阶段 | 版本建议 | 阶段定位 | 核心目标 | 对应价值 |
| --- | --- | --- | --- | --- |
| G0 | 原型规划期 | 文档与原型收口 | 把页面、路由、组件、流程、业务规则定清楚 | 降低后续返工 |
| G1 | `V1.0` 核心交易版 | 先跑通交易主闭环 | 顾客能完成选店、点餐、结算、支付、查订单 | 建立基础下单能力 |
| G2 | `V1.1` 履约服务版 | 补全场景与售后 | 顾客能退款、评价、自提、堂食扫码点餐 | 提升服务完整度 |
| G3 | `V2.0` 会员资产版 | 建立复购资产池 | 顾客能使用会员、优惠券、积分、储值、次卡 | 提升留存与复购 |
| G4 | `V2.1` 营销增长版 | 做活动承接与增长 | 顾客能参与新客礼、满减、秒杀、限时折扣等活动 | 提升转化与拉新 |
| G5 | `V3.0` 精细运营版 | 进入精细化经营 | 做消息触达、个性化推荐、服务中心、深度数据联动 | 提升 LTV 与运营效率 |
---
## 3. 各阶段详细范围
## 3.1 G0 原型规划期
### 阶段目标
- 完成 C 端页面地图、交互流、页面规格、业务规则与组件清单
- 对齐租户后台已有能力与 C 端承接关系
- 为后续 UI 设计、开发实现、接口对接提供统一母文档
### 当前应交付内容
- `docs/01-文档导航与实施顺序.md`
- `docs/02-信息架构与路由.md`
- `docs/03-全局业务规则.md`
- `docs/04-核心用户流程.md`
- `docs/05-页面清单总表.md`
- `docs/06-通用组件清单.md`
- `docs/07-页面规格/`
- `docs/08-10` 规划类文档
### 阶段完成标准
- 产品、设计、开发对页面范围与先后顺序没有歧义
- 每个页面都有明确入口、出口和状态要求
- 页面与后台能力关系可追溯
---
## 3.2 G1 `V1.0` 核心交易版
### 阶段定位
先做“顾客下单主闭环”,目标不是一次做全,而是先把最核心的交易能力跑通。
### 目标用户问题
- 顾客能否快速找到门店并进入正确点餐场景
- 顾客能否快速选品、加购、结算、支付
- 顾客付款后能否看到自己的订单和状态
### 版本范围
#### 核心页面
- `T01 首页`
- `T02 点餐页`
- `T03 订单页`
- `T04 我的页(基础版)`
- `C01 商品详情抽屉`
- `C02 购物车抽屉`
- `P03 结算确认页`
- `P04 支付成功页`
- `P05 订单详情页`
- `P18 堂食扫码确认页`
#### 必要支撑页
- `P01 门店选择页(轻量版)`
- `P02 地址管理页(基础版)`
#### 核心能力
- 门店选择与场景切换
- 商品分类浏览与商品详情选择
- 规格、加料、数量联动
- 购物车与金额汇总
- 结算页金额明细展示
- 微信支付占位与支付成功回流
- 订单列表、订单详情、基础状态表达
### 本阶段不追求
- 完整会员资产闭环
- 全部营销会场与复杂优惠组合
- 售后评价全部细节
- 精细化消息与推荐系统
### 成功标准
- 顾客可以从首页进入交易链路并形成订单
- 外卖、自提、堂食 3 种场景至少完成基础差异表达
- 下单后可在订单页和订单详情页找到订单
---
## 3.3 G2 `V1.1` 履约服务版
### 阶段定位
`V1.0` 基础上,把履约透明度与售后能力补齐,让小程序具备完整服务体验。
### 版本范围
- `P06 退款申请页`
- `P07 退款详情页`
- `P08 评价页`
- 回补 `T03 订单页`
- 回补 `P05 订单详情页`
### 核心能力
- 待支付继续支付 / 取消订单
- 订单履约时间轴
- 外卖配送、自提取餐码、堂食桌号展示
- 退款申请、退款状态查询
- 订单评价、匿名评价、晒图评价
- 再来一单入口
### 成功标准
- 顾客知道订单当前走到哪一步
- 顾客能看见退款入口、处理进度和结果
- 已完成订单能评价,评价后能回流到订单或复购场景
---
## 3.4 G3 `V2.0` 会员资产版
### 阶段定位
从“做完订单”升级到“让顾客愿意回来”,建立用户资产和长期关系。
### 版本范围
- `T04 我的页(完整版)`
- `P09 领券中心页`
- `P12 会员中心页`
- `P13 积分商城页`
- `P14 储值充值页`
- `P15 次卡页`
### 核心能力
- 展示会员等级、成长值、权益、会员日信息
- 展示并领取优惠券
- 展示积分余额、积分获取与兑换能力
- 展示储值方案、充值记录、余额支付入口
- 展示次卡购买、核销、剩余次数
- 让资产在结算页有实际承接入口
### 成功标准
- “我的”页不再只是资料页,而是复购与留存中心
- 顾客能理解自己拥有哪些资产、如何使用这些资产
- 会员资产与结算页面存在清晰闭环
---
## 3.5 G4 `V2.1` 营销增长版
### 阶段定位
从“顾客可复购”升级到“商家可持续做增长”,让后台营销能力在前台有承接页和转化路径。
### 版本范围
- `P10 秒杀活动页`
- `P11 限时折扣活动页`
- 回补首页活动区与点餐页活动承接
- 回补领券中心与结算优惠展示
- 接入新客有礼、满减活动、活动日历类运营能力
### 核心能力
- 新客礼包导流
- 满减自动命中与说明
- 秒杀会场与倒计时表达
- 限时折扣专区与商品承接
- 首页 Banner、活动宫格、专题入口
- 老客复购推荐、最近下单商品推荐
### 成功标准
- 商家配置的营销活动能在 C 端被顾客感知并参与
- 活动不只是“展示”,而是能引导进店、加购、结算和支付
---
## 3.6 G5 `V3.0` 精细运营版
### 阶段定位
从“有交易、有增长”升级到“有精细化经营能力”,让 C 端不仅承接交易,也承接服务和用户经营。
### 建议范围
- `P16 消息中心页`
- `P17 帮助中心页`
- 回补首页个性化推荐与用户画像相关模块
- 回补“我的”页服务区、消息区、客服区
- 规划未来扩展:发票、客服、投诉、电子会员码、常购清单、个性化券包
### 核心能力
- 订单消息、营销消息、系统通知的聚合触达
- FAQ、客服、售后帮助、自助指引
- 基于顾客历史订单和会员标签的商品推荐
- 基于活动日历与用户标签的个性化营销承接
- 为未来 CRM、财务票据、顾客洞察留前台入口
### 成功标准
- 小程序从“下单工具”升级为“用户经营载体”
- 顾客在 C 端能获取服务、消息、活动、资产、订单等全维度体验
---
## 4. 全周期能力分层
| 能力域 | 说明 | 主要版本 |
| --- | --- | --- |
| 交易域 | 选店、点餐、购物车、结算、支付、订单 | `V1.0` |
| 履约域 | 配送、自提、堂食、时间轴、退款、评价 | `V1.1` |
| 资产域 | 会员、优惠券、积分、储值、次卡 | `V2.0` |
| 增长域 | 新客礼、满减、秒杀、限时折扣、复购推荐 | `V2.1` |
| 服务域 | 消息、帮助、客服、服务入口 | `V3.0` |
| 经营域 | 个性化推荐、顾客标签、票据与更多增值能力 | `V3.0+` |
---
## 5. 各版本之间的依赖关系
1. `V1.0` 是所有后续版本的底座,没有交易闭环,后续资产和营销没有承接意义
2. `V1.1` 解决“下单后怎么办”,否则订单体验不完整
3. `V2.0` 解决“顾客为什么愿意回来”,是复购的基础
4. `V2.1` 解决“商家如何主动做增长”,是运营放大的关键
5. `V3.0` 解决“如何长期经营顾客关系”,是品牌化和精细运营的关键
---
## 6. 推荐落地原则
### 6.1 不要按页面数量推进,要按闭环推进
- 优先级不取决于页面多不多,而取决于是否能形成业务闭环
### 6.2 不要把所有后台能力一次前置到 C 端
- 后台配置能力很多,但前台承接必须按用户价值和转化优先级上线
### 6.3 每个版本都要有明确“上线后可验证的结果”
- `V1.0` 看下单成功率与订单可见性
- `V1.1` 看退款与评价路径是否清晰
- `V2.0` 看资产使用率与复购率
- `V2.1` 看活动参与率与转化率
- `V3.0` 看消息触达率、留存和用户活跃度
---
## 7. 与现有文档的关系
- `docs/02-信息架构与路由.md` 负责定义“页面怎么挂”
- `docs/03-全局业务规则.md` 负责定义“业务怎么跑”
- `docs/04-核心用户流程.md` 负责定义“顾客怎么走”
- `docs/05-页面清单总表.md` 负责定义“有哪些页面”
- `docs/08` 负责定义“整个项目分几期做”
- `docs/09` 负责定义“后台能力如何映射到 C 端”
- `docs/10` 负责定义“研发实施时先做什么、交付什么”

View File

@@ -0,0 +1,246 @@
# 租户后台与 C 端功能映射总表
- 文档版本:`V1.0`
- 适用项目:`TakeoutSaaS` 租户后台 / 小程序 C 端
- 文档目标:把租户后台现有模块,按“直接承接 / 间接支撑 / 未来扩展”映射到 C 端小程序
---
## 1. 文档目的
租户后台回答的是“商家如何配置与运营”C 端回答的是“顾客如何感知与使用这些配置”。
因此,本文件的作用是:
1. 明确后台每个模块对 C 端的影响范围
2. 明确哪些能力应该直接前置给顾客
3. 明确哪些能力只作为 C 端背后的数据或配置支撑
4. 为接口对接、页面设计、版本规划提供统一映射依据
---
## 2. 映射原则
### 2.1 直接承接
后台能力在 C 端有明确页面、入口或状态表达,例如:门店营业时间、商品规格、订单状态、优惠券。
### 2.2 间接支撑
后台能力不会单独出现在 C 端页面上,但会影响推荐、展示、状态或运营策略,例如:顾客画像、财务结算报表。
### 2.3 未来扩展
当前文档未单独建设对应页面,但未来可规划 C 端能力,例如:电子发票、客服工单、精细化标签券包。
---
## 3. 总映射矩阵
| 后台域 | 后台能力 | C 端承接页面 / 组件 | 承接方式 | 主要版本 | 说明 |
| --- | --- | --- | --- | --- | --- |
| 商户域 | 商户中心、品牌设置 | 首页、我的、帮助中心 | 间接支撑 | `V1.0` / `V3.0` | 影响品牌名、Logo、门店说明、客服电话、品牌文案 |
| 门店域 | 门店列表 | 首页、门店选择页、点餐页头部 | 直接承接 | `V1.0` | 顾客必须先选门店再点餐 |
| 门店域 | 营业时间 | 首页、门店卡、点餐页、订单页 | 直接承接 | `V1.0` | 影响营业中、休息中、即将打烊等状态 |
| 门店域 | 配送设置 | 首页、结算页、地址选择 | 直接承接 | `V1.0` | 影响配送范围、起送门槛、配送方式 |
| 门店域 | 自提设置 | 首页、结算页、订单详情 | 直接承接 | `V1.0` / `V1.1` | 影响自提时间、取餐说明、取餐规则 |
| 门店域 | 费用设置 | 商品详情、结算页 | 直接承接 | `V1.0` | 影响打包费、餐具费、配送费、起送价 |
| 门店域 | 堂食管理 | 堂食扫码确认页、点餐页、订单详情 | 直接承接 | `V1.0` / `V1.1` | 影响桌号、堂食规则、是否可加菜 |
| 门店域 | 员工排班 | 订单时效、帮助中心说明 | 间接支撑 | `V1.1` / `V3.0` | 不单独前置,但影响顾客对服务时效感知 |
| 商品域 | 商品列表 | 点餐页、首页推荐区 | 直接承接 | `V1.0` | 形成点餐主列表 |
| 商品域 | 分类管理 | 点餐页左侧分类 / 顶部分类 | 直接承接 | `V1.0` | 决定菜单组织方式 |
| 商品域 | 规格做法 | 商品详情抽屉 | 直接承接 | `V1.0` | 决定 SKU 价格与库存表现 |
| 商品域 | 加料管理 | 商品详情抽屉 | 直接承接 | `V1.0` | 决定加料项、价格变化 |
| 商品域 | 商品标签 | 首页推荐卡、商品卡片、详情抽屉 | 直接承接 | `V1.0` / `V2.1` | 热销、新品、招牌等标签直接影响转化 |
| 商品域 | 时段供应 | 点餐页、商品详情抽屉 | 直接承接 | `V1.0` | 决定商品是否可售 |
| 商品域 | 批量工具 | 无独立 C 端页面 | 间接支撑 | - | 只影响商家运营效率,不前置给顾客 |
| 订单域 | 订单大厅 | 订单页、订单详情页 | 直接承接 | `V1.0` / `V1.1` | C 端看到的是顾客维度订单状态表达 |
| 订单域 | 全部订单 | 订单页、订单搜索、订单详情 | 直接承接 | `V1.0` | 承接顾客找单、查单、继续支付 |
| 营销域 | 优惠券 | 领券中心、结算页优惠选择、我的页资产摘要 | 直接承接 | `V2.0` | 领券与用券是资产与增长的共同入口 |
| 营销域 | 满减活动 | 首页活动入口、结算页自动命中 | 直接承接 | `V2.1` | 顾客未必单独配置,但必须感知结果 |
| 营销域 | 新客有礼 | 首页新客入口、结算页自动带入 | 直接承接 | `V2.1` | 新用户拉新核心抓手 |
| 营销域 | 秒杀 | 秒杀活动页、首页会场、点餐页商品卡 | 直接承接 | `V2.1` | 强时效型营销场景 |
| 营销域 | 限时折扣 | 限时折扣页、首页专区、点餐页标签 | 直接承接 | `V2.1` | 影响商品展示和结算价格 |
| 营销域 | 集点 / 打卡 | 次卡页、活动页、我的页资产区 | 直接承接 / 未来扩展 | `V2.1` / `V3.0` | 当前可先做活动表达,后续做完整任务体系 |
| 营销域 | 营销日历 | 首页 Banner、活动日程、消息提醒 | 间接支撑 | `V2.1` / `V3.0` | 主要影响前台活动编排与触达节奏 |
| 会员域 | 会员管理 | 我的页、会员中心页、结算页会员权益提示 | 直接承接 | `V2.0` | 顾客感知的是等级、折扣、权益 |
| 会员域 | 积分商城 | 积分商城页、结算积分抵扣、我的页摘要 | 直接承接 | `V2.0` | 形成积分获取与消耗闭环 |
| 会员域 | 储值卡 | 储值充值页、结算余额支付、我的页摘要 | 直接承接 | `V2.0` | 支撑充值和余额消费 |
| 会员域 | 消息触达 | 消息中心、我的页红点、活动提醒 | 直接承接 / 间接支撑 | `V3.0` | 支撑订单消息、营销消息、系统通知 |
| 顾客域 | 顾客列表 | 无独立顾客页 | 间接支撑 | `V3.0` | 主要服务后台运营和标签管理 |
| 顾客域 | 顾客画像 | 首页推荐、复购推荐、券包推荐 | 间接支撑 | `V3.0` | 不直接给顾客看“画像”,但会影响推荐结果 |
| 顾客域 | 顾客分析 | 首页个性化、我的页推荐服务 | 间接支撑 | `V3.0` | 作为精细化运营的推荐输入 |
| 财务域 | 财务概览 | 无直接前台页 | 间接支撑 | - | 服务后台经营分析,不直接前置 |
| 财务域 | 交易流水 | 订单金额、余额记录、储值记录 | 间接支撑 | `V2.0` / `V3.0` | 顾客可见的是“订单金额 / 储值记录”子集 |
| 财务域 | 发票管理 | 订单详情未来入口 | 未来扩展 | `V3.0+` | 当前文档未建设,可作为后续增值服务 |
| 财务域 | 成本 / 结算 / 报表 | 无直接前台页 | 间接支撑 | - | 只服务商家与平台管理 |
| 仪表盘域 | 经营概览 | 无直接前台页 | 间接支撑 | - | 不对顾客展示,但可反哺推荐和活动策略 |
---
## 4. 分域详细映射
## 4.1 商户与门店域
### 后台来源
- 商户中心
- 门店列表
- 营业时间
- 配送设置
- 自提设置
- 费用设置
- 堂食管理
### C 端主要承接点
- `T01 首页`
- `T02 点餐页`
- `P01 门店选择页`
- `P02 地址管理页`
- `P03 结算确认页`
- `P05 订单详情页`
- `P18 堂食扫码确认页`
### 说明
- 这是 C 端最基础的配置域
- 没有门店域能力,商品、订单、营销都无法成立
- 该域直接决定三场景差异:`delivery``pickup``dine_in`
---
## 4.2 商品域
### 后台来源
- 商品列表
- 分类管理
- 规格做法
- 加料管理
- 商品标签
- 时段供应
### C 端主要承接点
- `T02 点餐页`
- `C01 商品详情抽屉`
- `C02 购物车抽屉`
- 首页推荐区 / 活动区
### 说明
- 商品域决定“顾客能买什么、怎么买、什么时候能买”
- 规格、加料、标签、时段供应必须在 C 端有明确视觉反馈
---
## 4.3 订单与履约域
### 后台来源
- 订单大厅
- 全部订单
- 订单状态流转
### C 端主要承接点
- `T03 订单页`
- `P05 订单详情页`
- `P06 退款申请页`
- `P07 退款详情页`
- `P08 评价页`
### 说明
- 后台关心接单、出餐、配送C 端关心“我现在要做什么、还要等多久、能不能退款”
- 因此,同一个订单状态,在 C 端需要翻译成顾客可理解的文案与动作按钮
---
## 4.4 营销域
### 后台来源
- 优惠券
- 满减活动
- 新客有礼
- 秒杀
- 限时折扣
- 集点 / 打卡
- 营销日历
### C 端主要承接点
- `T01 首页`
- `T02 点餐页`
- `P09 领券中心页`
- `P10 秒杀活动页`
- `P11 限时折扣活动页`
- `P03 结算确认页`
- `T04 我的页`
### 说明
- 营销域不是“独立存在”的,它必须嵌入首页、点餐、结算、我的这几个核心页面
- 真正的设计重点不是活动页本身,而是活动如何导流到商品和支付
---
## 4.5 会员资产域
### 后台来源
- 会员管理
- 积分商城
- 储值卡
- 消息触达
### C 端主要承接点
- `T04 我的页`
- `P12 会员中心页`
- `P13 积分商城页`
- `P14 储值充值页`
- `P15 次卡页`
- `P16 消息中心页`
- `P03 结算确认页`
### 说明
- 会员资产域是“我的”页成为留存中心的关键
- 所有资产页都不能只做展示,必须回流到点餐页或结算页形成使用闭环
---
## 4.6 顾客、财务、分析域
### 后台来源
- 顾客列表
- 顾客画像
- 顾客分析
- 财务概览
- 交易流水
- 报表、结算、成本、发票
### C 端承接方式
- 当前以间接支撑为主
- 未来可扩展的顾客可见能力包括:
- 个性化推荐
- 常购商品
- 专属券包
- 消费记录摘要
- 电子发票入口
### 说明
- 这部分不建议在早期版本大量前置
- 它更适合作为 `V3.0` 之后的精细化经营能力输入源
---
## 5. 当前文档范围内的直接映射优先级
### 第一优先级:必须先映射到 C 端
- 门店域
- 商品域
- 订单域
### 第二优先级:交易闭环稳定后映射
- 会员资产域
- 核心营销域
### 第三优先级:后续精细化再映射
- 顾客分析域
- 财务增值域
- 更复杂的消息触达与个性化能力
---
## 6. 设计与研发使用建议
1. 做页面设计时,不要只看后台名称,要看顾客是否真的需要感知这个能力
2. 做接口对接时,不要把后台对象原封不动搬到前台,要翻译成顾客任务语言
3. 做版本规划时,优先上线能影响下单、履约、复购的映射项
4. 如果某个后台能力当前没有对应的顾客价值,就先作为支撑能力,不强行做前台页面

View File

@@ -0,0 +1,311 @@
# 全周期研发实施顺序与交付清单
- 文档版本:`V1.0`
- 适用项目:`TakeoutSaaS` 小程序 C 端
- 文档目标:给设计、前端、接口、测试一个统一的落地顺序,避免“页面很多但不知道先做什么”
---
## 1. 文档目的
本文件回答 4 个问题:
1. 全周期应该按什么实施顺序推进
2. 每一阶段需要产出什么交付物
3. 每一阶段达到什么标准才算可以进入下一阶段
4. 如果是 AI 或个人开发,也能按什么顺序稳步落地
---
## 2. 推荐实施总节奏
| 阶段 | 名称 | 主要目标 | 核心交付 |
| --- | --- | --- | --- |
| S0 | 范围收口 | 定边界、定版本、定文档母版 | 08/09/10 规划文档、页面优先级 |
| S1 | 信息架构与设计基线 | 定路由、定组件、定设计规则 | 低保真、组件清单、状态矩阵 |
| S2 | 交易主链路开发 | 跑通首页到支付成功 | 首页、点餐、抽屉、结算、订单 |
| S3 | 履约与售后开发 | 补齐订单服务链路 | 退款、评价、状态时间轴 |
| S4 | 我的与资产开发 | 形成复购资产闭环 | 会员、积分、储值、次卡、领券 |
| S5 | 增长与活动开发 | 把营销能力前置到顾客端 | 秒杀、折扣、新客礼、活动入口 |
| S6 | 服务与消息开发 | 补齐服务能力和长期经营能力 | 消息、帮助、推荐、服务区 |
| S7 | 联调验收与上线准备 | 全局走查和交付 | 联调清单、验收清单、演示脚本 |
---
## 3. 各阶段实施顺序
## 3.1 S0 范围收口
### 目标
- 把“要做什么”和“先做什么”收口
### 必做事项
1. 确认版本分期:`V1.0` / `V1.1` / `V2.0` / `V2.1` / `V3.0`
2. 确认页面优先级P0 / P1 / P2
3. 确认三场景:外卖 / 自提 / 堂食
4. 确认后台到前台映射关系
### 必交付物
- `docs/08-全周期版本规划与范围分层.md`
- `docs/09-租户后台与C端功能映射总表.md`
- `docs/10-全周期研发实施顺序与交付清单.md`
- 页面优先级结论
### 完成标准
- 团队已明确“本期不做什么”
- 没有人再按自己理解任意扩散页面
---
## 3.2 S1 信息架构与设计基线
### 目标
- 让后续页面开发不再重复讨论结构问题
### 必做事项
1. 确认 4 个 Tab 与全部二级页路由
2. 确认页面模板Tab 页、二级页、抽屉、弹层
3. 确认全局设计 Token颜色、字号、间距、圆角、按钮层级
4. 确认页面状态矩阵:默认态、空态、加载态、错误态、禁用态
5. 确认三场景差异矩阵:外卖 / 自提 / 堂食
### 必交付物
- 页面低保真骨架
- 全局设计基线
- 页面状态矩阵
- 场景差异矩阵
- 通用组件清单的可实现版本
### 完成标准
- 任意页面都能用统一模板快速搭出骨架
- 新页面设计不会脱离现有模式
---
## 3.3 S2 交易主链路开发
### 目标
- 先跑通“选店 → 点餐 → 结算 → 支付 → 查单”
### 开发顺序
1. `T01 首页`
2. `P01 门店选择页`
3. `T02 点餐页`
4. `C01 商品详情抽屉`
5. `C02 购物车抽屉`
6. `P02 地址管理页`
7. `P03 结算确认页`
8. `P04 支付成功页`
9. `T03 订单页`
10. `P05 订单详情页`
11. `T04 我的页(基础版)`
12. `P18 堂食扫码确认页`
### 必交付物
- 路由可跳转的交易闭环
- 商品与购物车 mock 数据
- 结算金额计算占位逻辑
- 订单状态 mock 数据
- 三场景基础差异展示
### 验收重点
- 能否从首页顺利进入点餐和结算
- 能否看清价格、优惠和实付金额
- 能否支付成功后找到订单
---
## 3.4 S3 履约与售后开发
### 目标
- 补齐订单后半段体验
### 开发顺序
1. 回补 `T03 订单页` 状态筛选
2. 回补 `P05 订单详情页` 履约时间轴与操作区
3. `P06 退款申请页`
4. `P07 退款详情页`
5. `P08 评价页`
### 必交付物
- 状态时间轴
- 退款链路
- 评价链路
- 再来一单入口
### 验收重点
- 用户能否快速理解订单当前状态
- 用户能否找到退款入口和评价入口
---
## 3.5 S4 我的与资产开发
### 目标
- 把“我的”页做成留存与复购中心
### 开发顺序
1. 回补 `T04 我的页`
2. `P12 会员中心页`
3. `P09 领券中心页`
4. `P13 积分商城页`
5. `P14 储值充值页`
6. `P15 次卡页`
### 必交付物
- 我的页用户头部与资产摘要
- 会员权益表达
- 券、积分、储值、次卡结构页
- 与结算页联动入口
### 验收重点
- 资产页是不是只“展示”没有“回流”
- 结算页能否承接资产的使用语境
---
## 3.6 S5 增长与活动开发
### 目标
- 把后台营销能力转化为前台可感知、可转化的页面能力
### 开发顺序
1. 回补首页活动区
2. `P10 秒杀活动页`
3. `P11 限时折扣活动页`
4. 回补点餐页活动标签与活动商品专区
5. 回补结算页优惠命中说明
6. 回补我的页活动与券入口
### 必交付物
- 活动承接页
- 活动入口与活动状态表达
- 新客礼 / 满减 / 秒杀 / 折扣的页面承接逻辑
### 验收重点
- 活动是否能真正导流进商品和结算,而不只是展示横幅
---
## 3.7 S6 服务与消息开发
### 目标
- 把小程序补齐为可长期经营的用户服务端
### 开发顺序
1. `P16 消息中心页`
2. `P17 帮助中心页`
3. 回补首页推荐区与我的服务区
4. 预留未来发票、客服、投诉与个性化券包入口
### 必交付物
- 消息分类页
- FAQ / 客服 / 帮助中心
- 红点、未读、服务入口表达
### 验收重点
- 顾客是否能在订单之外获得通知与帮助
---
## 3.8 S7 联调验收与上线准备
### 目标
- 把前面阶段串成一套真正可演示、可交付、可联调的版本
### 必做事项
1. 检查所有页面路由跳转
2. 检查所有主 CTA 是否闭环
3. 检查三场景差异是否完整
4. 检查所有金额、优惠、状态文案是否一致
5. 检查登录拦截与回跳逻辑
6. 检查空态、错误态、禁用态
7. 整理演示脚本、验收清单、联调顺序
### 必交付物
- 联调清单
- 验收清单
- 演示路径脚本
- 版本发布说明
### 完成标准
- 业务、设计、开发、测试都能按同一套路径演示
- 新接手的 AI 或工程师可以快速理解全局结构
---
## 4. 推荐交付物清单
| 阶段 | 必交付物 |
| --- | --- |
| S0 | 分期文档、映射文档、实施文档 |
| S1 | 低保真、状态矩阵、场景矩阵、组件清单 |
| S2 | 交易主链路页面、mock 数据、跳转脚本 |
| S3 | 售后页面、状态时间轴、订单操作脚本 |
| S4 | 我的页与资产页、资产回流脚本 |
| S5 | 活动页、活动入口、活动承接脚本 |
| S6 | 消息与帮助页、红点逻辑、服务入口 |
| S7 | 联调文档、验收清单、演示说明 |
---
## 5. 如果是个人或 AI 独立推进,建议这样执行
### 模式 A先原型后代码
1. 先补齐文档与低保真
2. 再实现点击原型
3. 再把点击原型转成真实小程序代码
### 模式 B边原型边代码
1. 每完成一个页面规格,就同步搭建页面骨架
2. 每完成一个阶段,就统一走查路由和状态
3. 不要跨阶段跳做复杂资产或复杂营销
### 模式 C只做 MVP
1. 只做 `S0 + S1 + S2 + S3`
2. 上线后再根据业务反馈扩展 `S4-S7`
---
## 6. 阶段切换门槛
### 从 S1 进入 S2 前
- 页面结构、路由、组件模板已稳定
### 从 S2 进入 S3 前
- 主交易闭环可完整演示
### 从 S3 进入 S4 前
- 订单与售后体验清晰,没有主流程断点
### 从 S4 进入 S5 前
- 资产页能回流到结算页
### 从 S5 进入 S6 前
- 活动页不是孤岛,已能导流到交易闭环
### 从 S6 进入 S7 前
- 页面、消息、服务、活动、资产已基本成套
---
## 7. 实施时最容易踩的坑
1. 一开始就想把所有资产和活动一起做完
2. 先画很多视觉稿,却没有先收口状态和流程
3. 把后台字段原样搬到前台,没有翻译成顾客语言
4. 只做页面,不做版本边界
5. 只做静态图,不做关键跳转与交互闭环
---
## 8. 最终建议
这套项目最稳的推进方式不是“按页面一个个做”,而是:
1. 先按版本收口
2. 再按闭环推进
3. 然后按阶段交付
4. 最后统一联调与上线准备
只有这样,租户后台到 C 端小程序的关系才会清晰,整个项目也不会越做越散。

Binary file not shown.

After

Width:  |  Height:  |  Size: 271 KiB

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,459 @@
# TakeoutSaaS C 端小程序原型执行总计划
- 文档版本:`V1.0`
- 适用仓库:`TakeoutSaas.C-end.MiniProgram.Prototype`
- 执行对象:`Gemini 或其他页面实现 AI`
- 执行目标:基于当前 Markdown 文档体系,逐步完成一套可演示、可流转、可继续交接开发的小程序 C 端原型
---
## 1. 总目标
本计划用于指导原型实现 AI按固定顺序逐步完成 C 端小程序原型。
最终结果必须满足:
1. 页面结构完整
2. 页面之间可跳转
3. 三种场景可切换
4. 订单链路完整
5. 会员资产链路完整
6. 页面与文档一致
本次原型范围包括:
- 首页
- 点餐
- 订单
- 我的
- 门店、地址、结算、支付成功、订单详情、退款、评价
- 领券中心、秒杀、限时折扣、会员中心、积分商城、储值、次卡
- 消息中心、帮助中心、堂食扫码确认
本次原型不包括:
- 后端接口联调
- 后台运营端页面
- 财务、报表、库存后台
- 实际支付能力
- 实际地图配送算法
---
## 2. 执行总原则
### 2.1 严格按文档实现
必须以以下文件为依据:
- `README.md`
- `docs/01-文档导航与实施顺序.md`
- `docs/02-信息架构与路由.md`
- `docs/03-全局业务规则.md`
- `docs/04-核心用户流程.md`
- `docs/05-页面清单总表.md`
- `docs/06-通用组件清单.md`
- `docs/07-页面规格/*.md`
### 2.2 优先做闭环,不优先做边缘页
先保证主交易链路可跑,再做资产页和辅助页。
### 2.3 一个阶段只解决一个问题
不要同时做太多方向:
- 阶段 1 做壳层
- 阶段 2 做交易闭环
- 阶段 3 做履约售后
- 阶段 4 做我的与资产
- 阶段 5 做辅助页与活动页
- 阶段 6 做全局联调与检查
### 2.4 页面先可用,再精修
只要页面结构、交互、状态、流转正确,就算阶段合格。
视觉细修可以放在最后统一处理。
---
## 3. 阶段计划
## 阶段 1搭建原型基础骨架
### 目标
搭建整套原型的基础结构,让后续页面可以稳定挂接。
### 必做事项
1. 建立全局目录结构
2. 建立路由结构
3. 建立底部 TabBar
4. 建立顶部导航栏
5. 建立页面容器和安全区规则
6. 建立统一色彩、字体、间距和按钮规范
7. 建立通用组件基础版本
### 本阶段必须产出
- 全局应用壳层
- 4 个 Tab 入口占位
- 二级页面跳转能力
- 抽屉 / 弹层容器
- 通用状态标签与卡片组件
### 本阶段完成标准
- 可以从 TabBar 切换到 4 个主页面占位
- 可以从任意页面进入一个二级页再返回
- 可以打开和关闭抽屉组件
---
## 阶段 2完成交易主链路原型
### 目标
跑通首页 → 点餐 → 商品详情 → 购物车 → 结算 → 支付成功 → 订单详情的完整闭环。
### 页面实施顺序
1. `T01 首页`
2. `T02 点餐页`
3. `C01 商品详情抽屉`
4. `C02 购物车抽屉`
5. `P03 结算确认页`
6. `P04 支付成功页`
7. `T03 订单页`
8. `P05 订单详情页`
### 每个页面必须完成的内容
- 页面区块
- 页面 CTA
- 页面状态
- 页面跳转
- mock 数据
### 场景要求
#### 外卖
- 门店选择
- 地址校验占位
- 配送费 / 起送价说明
- 预计送达展示
#### 自提
- 自提时间选择
- 取餐人信息
- 取餐码展示入口
#### 堂食
- 桌号显示
- 堂食场景切换
- 后续加菜入口预留
### 本阶段完成标准
- 首页可以进入点餐
- 点餐可以加购商品
- 商品可通过抽屉选规格和加料
- 购物车可修改数量并去结算
- 结算页可以展示金额明细和优惠入口
- 支付成功后能进入订单详情
- 订单详情能反映不同场景信息
---
## 阶段 3完成履约、退款、评价链路
### 目标
补全支付后的用户行为,让订单链路具备售后和评价能力。
### 页面实施顺序
1. `P06 退款申请页`
2. `P07 退款详情页`
3. `P08 评价页`
4. 回补 `T03 订单页`
5. 回补 `P05 订单详情页`
### 必做事项
- 为订单详情页补齐操作态
- 根据不同状态展示不同按钮
- 打通退款申请 → 退款详情
- 打通订单详情 → 评价页
- 支持订单完成后再来一单
### 状态要求
- 待支付
- 已支付待接单
- 制作中
- 配送中
- 待自提
- 堂食进行中
- 已完成
- 退款中
- 已退款
- 已关闭
### 本阶段完成标准
- 用户可从订单详情发起退款
- 用户可看到退款结果
- 用户可提交评价
- 用户可看到订单的状态变化表达
---
## 阶段 4完成“我的”与用户资产链路
### 目标
让用户能在“我的”中查看资产、进入会员相关页面,并回流到点餐和结算。
### 页面实施顺序
1. `T04 我的页`
2. `P12 会员中心页`
3. `P13 积分商城页`
4. `P14 储值充值页`
5. `P15 次卡页`
6. `P09 领券中心页`
### 必做事项
- 我的页搭建用户头部卡、资产总览和服务区
- 会员中心展示等级、权益、成长值
- 积分商城展示积分余额和可兑换内容
- 储值充值页展示方案和充值记录
- 次卡页展示购买、已购和使用状态
- 领券中心展示券列表、领取状态和去使用入口
### 本阶段完成标准
- 我的页能跳转到全部资产页
- 资产页结构完整
- 资产页数据能回流到结算页的使用语境
- 优惠券、积分、储值、次卡在结算页有承接入口
---
## 阶段 5完成活动页与辅助页
### 目标
补全活动承接页、服务页和场景辅助页,完善整套原型可展示性。
### 页面实施顺序
1. `P10 秒杀活动页`
2. `P11 限时折扣活动页`
3. `P01 门店选择页`
4. `P02 地址管理页`
5. `P16 消息中心页`
6. `P17 帮助中心页`
7. `P18 堂食扫码确认页`
### 必做事项
- 活动页展示活动头图、列表、状态变化
- 门店选择页支持定位、筛选和切店
- 地址管理页支持默认地址、新增编辑逻辑原型
- 消息中心支持分类切换
- 帮助中心支持 FAQ 和客服入口
- 堂食扫码确认页支持桌号确认与入桌
### 本阶段完成标准
- 首页活动入口全部有承接页
- 门店与地址能力完整
- 堂食扫码流程可演示
- 消息与帮助体系可展示
---
## 阶段 6统一联调与整体检查
### 目标
把前面分阶段完成的页面整理成一套完整、统一、可交付的原型。
### 必做事项
1. 检查所有页面路由是否连通
2. 检查所有主要 CTA 是否都有跳转结果
3. 检查所有页面标题、命名、入口是否统一
4. 检查所有状态标签颜色和文案是否一致
5. 检查三场景差异是否表达完整
6. 检查结算页金额逻辑表达是否统一
7. 检查“我的”页与资产页是否能相互跳转
8. 检查所有空态与异常态是否补齐
### 最终联调清单
- 首页 → 点餐 → 结算 → 支付成功 → 订单详情
- 订单 → 退款申请 → 退款详情
- 订单详情 → 评价页
- 我的 → 会员中心
- 我的 → 积分商城
- 我的 → 储值充值
- 我的 → 次卡页
- 首页 → 秒杀活动页
- 首页 → 限时折扣活动页
- 扫码 → 堂食扫码确认 → 点餐页(堂食)
### 本阶段完成标准
- 页面可完整演示
- 路由不死链
- 页面结构和文档一致
- 可交由下一个 AI 或开发继续接手
---
## 4. 页面级执行模板
Gemini 每做一个页面,必须遵守以下步骤:
### Step 1先读规格
- 读取对应 `docs/07-页面规格/*.md`
- 同时读取依赖的全局规则和组件文档
### Step 2先搭骨架
- 先按区块顺序搭页面结构
- 不要一开始就处理细节视觉
### Step 3接入交互
- 接 CTA
- 接跳转
- 接抽屉 / 弹层
- 接状态切换
### Step 4补状态
- 默认态
- 空态
- 异常态
- 禁用态
### Step 5对照文档自检
检查:
- 区块是否缺失
- 交互是否缺失
- 页面是否越权扩展功能
- 页面命名是否和文档一致
---
## 5. 统一 mock 数据策略
为了让原型可演示,需要统一准备 mock 数据。
所有 mock 数据都要贴近餐饮小程序真实场景。
### 建议 mock 数据域
- 门店数据
- 分类数据
- 商品数据
- SKU 数据
- 加料数据
- 购物车数据
- 地址数据
- 优惠券数据
- 积分数据
- 储值数据
- 次卡数据
- 订单数据
- 退款数据
- 消息数据
### mock 数据要求
- 能反映三场景差异
- 能反映活动状态差异
- 能反映订单状态差异
- 能反映资产是否可用
---
## 6. 视觉与交互约束
### 6.1 视觉方向
本次原型建议保持:
- 移动端优先
- 餐饮类产品风格
- 清晰、轻快、信息密度适中
- 优惠信息突出但不杂乱
### 6.2 交互方向
- 主要操作尽量底部固定
- 商品加购尽量少跳页
- 抽屉优先承载短流程
- 二级页承载完整流程
### 6.3 文案方向
- 以直接、明确、可操作为主
- 不用过度营销化表达
- 状态文案必须稳定统一
---
## 7. 阶段交付物清单
### 阶段 1 交付物
- 全局壳层
- 路由骨架
- 通用组件第一版
### 阶段 2 交付物
- 交易主链路页面
- 购物车与结算闭环
- 三场景基本表达
### 阶段 3 交付物
- 退款链路
- 评价链路
- 订单状态链路
### 阶段 4 交付物
- 我的页
- 会员与资产页
- 资产承接链路
### 阶段 5 交付物
- 活动页
- 辅助页
- 堂食扫码辅助页
### 阶段 6 交付物
- 完整演示版原型
- 全链路可点击
- 页面命名与结构统一
---
## 8. 最终验收标准
只有当下面全部满足时,本计划才算执行完成:
1. 所有 `docs/05-页面清单总表.md` 中列出的页面都已实现
2. 所有主 CTA 都有去向
3. 外卖、自提、堂食三场景均可演示
4. 结算、订单、退款、评价链路可演示
5. 会员、积分、储值、次卡、领券链路可演示
6. 页面状态具备最基本的空态和异常态
7. 页面结构与文档一致
8. 另一个开发或 AI 接手时,不需要重新猜测页面应该长什么样
---
## 9. 执行顺序简表
按下面固定顺序执行,不要跳步:
1. 全局骨架
2. 首页
3. 点餐页
4. 商品详情抽屉
5. 购物车抽屉
6. 结算确认页
7. 支付成功页
8. 订单页
9. 订单详情页
10. 退款申请页
11. 退款详情页
12. 评价页
13. 我的页
14. 会员中心页
15. 积分商城页
16. 储值充值页
17. 次卡页
18. 领券中心页
19. 秒杀活动页
20. 限时折扣活动页
21. 门店选择页
22. 地址管理页
23. 消息中心页
24. 帮助中心页
25. 堂食扫码确认页
26. 全局联调与统一修正
---
## 10. 最后要求
如果你是 Gemini请不要一上来就做全部页面。
请严格按照本 `plan.md`
- 一阶段一阶段推进
- 一页面一页面落地
- 每完成一个页面就自检
- 每完成一个阶段再进入下一个阶段
本计划不是参考建议,而是执行顺序。

View File

@@ -0,0 +1,504 @@
# 小程序 C 端功能需求文档
- 文档版本:`V1.0`
- 生成日期:`2026-03-06`
- 适用项目:`TakeoutSaaS` 小程序 C 端
- 原型来源:`D:/HAZCode/TakeoutSaaS/TakeoutSaaS.Prototypes`
- 目标用户:顾客 / 点餐下单用户
- 对应后台:租户端运营后台(门店、商品、订单、营销、会员等配置由后台提供)
---
## 1. 文档目的
本文档用于把现有租户端原型能力,整理为面向顾客的小程序 C 端需求说明。
租户端原型主要解决“商家如何配置和运营”,小程序 C 端主要解决“顾客如何选店、点餐、支付、履约、售后、复购”。
一期默认建设目标:
- 同时支持 `外卖配送``到店自提``堂食扫码点餐` 三种场景
- 同时支持 `会员``优惠券``满减``限时折扣``秒杀``积分``储值``次卡` 等用户资产能力
- 以“顾客下单闭环 + 履约闭环 + 复购闭环”为核心
---
## 2. 底部菜单设计
建议小程序底部使用 4 个主菜单:
| 菜单 | 菜单定位 | 核心目标 |
| --- | --- | --- |
| 首页 | 顾客进入小程序后的综合入口 | 选门店、看活动、进入正确点单场景 |
| 点餐 | 商品浏览与下单主阵地 | 选商品、选规格、加购、结算、支付 |
| 订单 | 订单履约与售后中心 | 看进度、催单、退款、评价、复购 |
| 我的 | 顾客资产和个人服务中心 | 管理会员、优惠券、积分、储值、次卡、地址、消息 |
说明:
- `堂食扫码` 不建议单独放入底部菜单,而是通过扫码直达或首页入口进入
- `门店选择``地址管理``会员中心``领券中心``积分商城` 等作为二级页面存在
---
## 3. 整体功能分层
### 3.1 顾客核心链路
1. 进入小程序
2. 定位或选择门店
3. 选择场景(外卖 / 自提 / 堂食)
4. 浏览商品并加入购物车
5. 选择优惠与支付方式
6. 完成支付
7. 查看订单履约进度
8. 完成售后、评价与复购
### 3.2 顾客核心能力模块
- 门店与场景能力
- 商品与购物车能力
- 订单与履约能力
- 营销与活动能力
- 会员与资产能力
- 评价与售后能力
- 消息与服务能力
---
## 4. 菜单一:首页
### 4.1 菜单定位
首页用于承接“选店 + 场景选择 + 活动导流 + 热门推荐”。
顾客进入小程序后,优先完成“去哪家店、用什么方式点单、当前有什么活动”。
### 4.2 功能大类
- 门店与场景入口
- 活动与优惠导流
- 推荐与快速点单
- 门店服务信息
### 4.3 详细功能清单
| 功能大类 | 具体功能名称 | 功能作用 | 备注 / 来源能力 |
| --- | --- | --- | --- |
| 门店与场景入口 | 定位推荐门店 | 根据用户当前位置推荐最近可服务门店 | 对应门店列表、配送范围 |
| 门店与场景入口 | 手动切换门店 | 顾客可主动切换其他门店下单 | 对应门店列表 |
| 门店与场景入口 | 门店营业状态展示 | 显示营业中、休息中、即将打烊、特殊营业 | 对应营业时间 |
| 门店与场景入口 | 外卖入口 | 进入外卖配送场景点单 | 对应配送设置 |
| 门店与场景入口 | 自提入口 | 进入到店自提场景点单 | 对应自提设置 |
| 门店与场景入口 | 堂食入口 | 进入堂食点餐,或引导扫码入桌 | 对应堂食管理 |
| 门店与场景入口 | 扫码入桌快捷入口 | 顾客通过桌码进入堂食流程 | 对应堂食桌位 |
| 门店与场景入口 | 门店信息卡片 | 展示门店名称、地址、距离、电话、营业时间 | 门店基础信息 |
| 活动与优惠导流 | 首页 Banner | 展示门店主推活动、主题活动、节日活动 | 对应营销日历 |
| 活动与优惠导流 | 新客有礼入口 | 新用户看到欢迎礼包、首单优惠等 | 对应新客有礼 |
| 活动与优惠导流 | 领券中心入口 | 查看并领取当前可领优惠券 | 对应优惠券 |
| 活动与优惠导流 | 满减活动入口 | 导流至当前门店可参与的满减活动 | 对应满减活动 |
| 活动与优惠导流 | 限时折扣入口 | 展示限时折扣专区、折扣商品入口 | 对应限时折扣 |
| 活动与优惠导流 | 秒杀活动入口 | 展示秒杀会场、倒计时、秒杀商品 | 对应秒杀活动 |
| 活动与优惠导流 | 会员日入口 | 展示会员日权益和活动提醒 | 对应会员等级 / 会员日 |
| 活动与优惠导流 | 储值活动入口 | 引导顾客充值享赠金 | 对应储值卡 |
| 活动与优惠导流 | 次卡活动入口 | 引导顾客购买午餐卡、咖啡卡等 | 对应次卡管理 |
| 推荐与快速点单 | 热销推荐 | 展示销量高、转化高的商品 | 对应商品分析 / 热销标签 |
| 推荐与快速点单 | 套餐推荐 | 展示组合套餐、多人套餐 | 对应商品套餐 |
| 推荐与快速点单 | 复购推荐 | 给老客展示常点商品和最近下单商品 | 对应客户画像 / 订单历史 |
| 推荐与快速点单 | 猜你喜欢 | 基于顾客偏好推荐商品 | 对应客户画像 |
| 推荐与快速点单 | 快速再来一单 | 让用户从首页直接复购最近订单 | 复购能力 |
| 门店服务信息 | 营业时间展示 | 展示今日营业时段和特殊营业说明 | 对应营业时间 |
| 门店服务信息 | 配送费与起送价说明 | 展示基础配送费、起送门槛、免配送费门槛 | 对应费用设置 |
| 门店服务信息 | 配送范围说明 | 展示超出范围不可配送的提示 | 对应配送设置 |
| 门店服务信息 | 自提规则说明 | 展示自提时段、预约规则、取餐说明 | 对应自提设置 |
| 门店服务信息 | 堂食规则说明 | 展示桌码点餐、加菜、结账说明 | 对应堂食管理 |
| 门店服务信息 | 联系门店 | 一键拨打电话或联系客服 | 服务能力 |
| 门店服务信息 | 到店导航 | 跳转地图导航到店 | 自提 / 堂食场景使用 |
### 4.4 首页重点说明
- 首页的第一目标不是展示全部功能,而是让顾客快速进入正确门店与正确场景
- 如果是扫码进入,则首页可弱化,直接进入堂食流程
- 若顾客是老用户,首页优先展示复购商品和可用优惠
---
## 5. 菜单二:点餐
### 5.1 菜单定位
点餐页是小程序最核心页面,负责完成从“浏览商品”到“提交订单”的完整转化。
### 5.2 功能大类
- 菜单浏览与筛选
- 商品详情与选配
- 购物车管理
- 结算与支付
### 5.3 详细功能清单
| 功能大类 | 具体功能名称 | 功能作用 | 备注 / 来源能力 |
| --- | --- | --- | --- |
| 菜单浏览与筛选 | 场景切换条 | 在外卖、自提、堂食之间切换,刷新可售规则 | 三场景统一支持 |
| 菜单浏览与筛选 | 当前门店展示 | 显示当前门店,并支持切换门店 | 门店列表 |
| 菜单浏览与筛选 | 分类导航 | 按商品分类浏览菜单 | 商品分类 |
| 菜单浏览与筛选 | 商品搜索 | 按商品名称、关键词搜索商品 | 商品列表 |
| 菜单浏览与筛选 | 标签筛选 | 按热销、招牌、新品、推荐等标签筛选 | 商品标签 |
| 菜单浏览与筛选 | 时段供应提示 | 标记早餐、午餐、晚餐、夜宵等可售时段 | 时段供应 |
| 菜单浏览与筛选 | 售罄状态展示 | 展示售罄、下架、当前不可售 | 库存 / 时段 / 状态控制 |
| 菜单浏览与筛选 | 活动商品专区 | 在点餐页突出显示秒杀、折扣商品 | 营销活动 |
| 菜单浏览与筛选 | 套餐专区 | 展示单人餐、双人餐、家庭餐等套餐 | 商品套餐 |
| 商品详情与选配 | 商品主图与副图 | 展示商品图片,增强购买欲望 | 商品详情 |
| 商品详情与选配 | 商品名称与描述 | 展示卖点、口味、原料说明 | 商品详情 |
| 商品详情与选配 | 规格做法选择 | 选择大份小份、冷热、辣度、甜度等 | 规格做法 |
| 商品详情与选配 | 加料选择 | 增加小料、配菜、附加项 | 加料管理 |
| 商品详情与选配 | SKU 联动价格 | 根据规格组合实时变更价格 | SKU 管理 |
| 商品详情与选配 | SKU 联动库存 | 根据规格组合判断库存是否足够 | SKU 管理 |
| 商品详情与选配 | 划线价显示 | 显示原价与优惠价对比 | 商品价格 |
| 商品详情与选配 | 打包费展示 | 展示商品或门店打包费 | 费用设置 |
| 商品详情与选配 | 商品标签展示 | 显示热销、招牌、推荐、新品等标签 | 商品标签 |
| 商品详情与选配 | 限购信息展示 | 展示活动商品每单限购数量 | 秒杀 / 折扣 |
| 商品详情与选配 | 立即加购 | 将当前商品加入购物车 | 主转化动作 |
| 商品详情与选配 | 立即下单 | 跳过继续浏览,直接前往结算 | 缩短购买路径 |
| 购物车管理 | 购物车悬浮入口 | 随时查看已选商品数和金额 | 点餐核心交互 |
| 购物车管理 | 购物车明细浮层 | 查看全部已选商品 | 购物车 |
| 购物车管理 | 数量增减 | 修改单品购买数量 | 购物车 |
| 购物车管理 | 同商品不同规格区分 | 避免不同规格混淆 | SKU 组合 |
| 购物车管理 | 失效商品提醒 | 提示商品售罄、活动失效、超时段不可售 | 保护结算成功率 |
| 购物车管理 | 凑单提示 | 提示距离起送价、满减、免配送费还差多少 | 提升转化 |
| 购物车管理 | 场景购物车隔离 | 外卖 / 自提 / 堂食购物车分开 | 防止混单 |
| 购物车管理 | 清空购物车 | 一键清空当前场景商品 | 便于重选 |
| 结算与支付 | 结算确认页 | 汇总商品、费用、优惠、场景信息 | 核心结算页 |
| 结算与支付 | 收货地址选择 | 外卖场景选择地址 | 地址管理 |
| 结算与支付 | 地址新增编辑 | 新增和修改配送地址 | 地址管理 |
| 结算与支付 | 配送范围校验 | 判断地址是否在配送范围内 | 配送设置 |
| 结算与支付 | 起送价校验 | 判断订单是否满足起送门槛 | 费用设置 |
| 结算与支付 | 配送费计算 | 按距离或区域计算配送费 | 配送规则 |
| 结算与支付 | 免配送费门槛判断 | 满额自动减免配送费 | 门店费用设置 |
| 结算与支付 | 预计送达时间 | 展示预计送达时间 | 外卖履约信息 |
| 结算与支付 | 自提时段选择 | 顾客选择可预约的取餐时间段 | 自提时段 |
| 结算与支付 | 自提人信息 | 填写取餐人姓名和手机号 | 自提必填 |
| 结算与支付 | 取餐规则说明 | 展示提前预约、截止时间、取餐方式 | 自提设置 |
| 结算与支付 | 堂食桌号确认 | 展示当前桌号和门店信息 | 堂食流程 |
| 结算与支付 | 订单备注 | 填写口味、忌口、特殊要求 | 订单备注 |
| 结算与支付 | 餐具选择 | 顾客选择餐具数量或无需餐具 | 费用设置 |
| 结算与支付 | 优惠券选择 | 选择可用优惠券参与结算 | 优惠券 |
| 结算与支付 | 满减自动匹配 | 自动命中可用满减活动 | 满减活动 |
| 结算与支付 | 折扣自动匹配 | 命中限时折扣或秒杀价 | 折扣 / 秒杀 |
| 结算与支付 | 新客礼包自动生效 | 新用户下单自动带入礼包优惠 | 新客有礼 |
| 结算与支付 | 会员优惠展示 | 展示会员等级折扣、会员日权益 | 会员体系 |
| 结算与支付 | 积分抵扣 | 使用积分抵扣部分金额 | 积分体系 |
| 结算与支付 | 储值余额抵扣 | 使用储值余额支付订单 | 储值卡 |
| 结算与支付 | 次卡核销 | 对可用商品使用次卡直接抵扣 | 次卡管理 |
| 结算与支付 | 费用明细展示 | 展示商品金额、包装费、配送费、优惠、实付金额 | 提升透明度 |
| 结算与支付 | 微信支付 | 通过微信支付完成下单 | 一期主支付方式 |
| 结算与支付 | 余额支付 | 使用储值余额直接支付 | 会员资产能力 |
| 结算与支付 | 支付成功页 | 展示支付成功、预计送达 / 取餐时间、后续入口 | 支付闭环 |
### 5.4 点餐重点说明
- 点餐页必须围绕“快”和“准”设计:快找到商品,准确理解价格和优惠
- 商品规格、加料、优惠命中、库存与价格联动必须清晰
- 结算页必须把“为什么是这个价格”解释清楚
---
## 6. 菜单三:订单
### 6.1 菜单定位
订单页用于承接顾客付款后的全部行为,包括查看状态、催单、退款、评价、复购。
### 6.2 功能大类
- 订单列表
- 订单详情
- 履约互动
- 售后与评价
### 6.3 详细功能清单
| 功能大类 | 具体功能名称 | 功能作用 | 备注 / 来源能力 |
| --- | --- | --- | --- |
| 订单列表 | 订单状态筛选 | 按待支付、进行中、已完成、退款售后查看订单 | 订单列表 |
| 订单列表 | 场景标识 | 标识外卖、自提、堂食订单 | 多场景识别 |
| 订单列表 | 订单卡片摘要 | 显示门店、商品摘要、金额、状态、时间 | 顾客快速找单 |
| 订单列表 | 搜索订单 | 根据订单号、门店、手机号等搜索 | 提高查询效率 |
| 订单列表 | 待支付订单入口 | 快速继续支付未完成订单 | 降低流失 |
| 订单列表 | 再来一单入口 | 基于历史订单快速复购 | 复购能力 |
| 订单详情 | 订单基础信息 | 查看订单号、下单时间、支付方式、支付时间 | 订单明细 |
| 订单详情 | 商品清单 | 查看商品、规格、加料、数量 | 核对订单 |
| 订单详情 | 费用明细 | 查看金额组成与优惠明细 | 核对支付金额 |
| 订单详情 | 履约时间轴 | 展示支付成功、接单、制作、配送 / 待取 / 完成等节点 | 订单进度 |
| 订单详情 | 场景信息展示 | 外卖显示地址,自提显示取餐码,堂食显示桌号 | 场景化详情 |
| 订单详情 | 联系门店 | 从订单详情直接联系商家 | 服务能力 |
| 订单详情 | 评价入口 | 已完成订单可评价 | 对应评价管理 |
| 订单详情 | 再来一单 | 按历史订单快速重新加入购物车 | 复购闭环 |
| 履约互动 | 待支付倒计时 | 显示支付剩余时间 | 待支付订单 |
| 履约互动 | 继续支付 | 对未支付订单继续拉起支付 | 订单支付恢复 |
| 履约互动 | 取消订单 | 在允许时间内主动取消未履约订单 | 订单规则 |
| 履约互动 | 催单 | 当制作时间较长时发起催单 | 对应催单提醒 |
| 履约互动 | 外卖配送进度 | 查看配送中状态与预计送达 | 外卖重点能力 |
| 履约互动 | 自提取餐码 | 查看取餐码、取餐时间、取餐人信息 | 自提重点能力 |
| 履约互动 | 堂食加菜 / 续单 | 顾客在用餐中可继续加购 | 堂食场景能力 |
| 履约互动 | 完成标记提示 | 提示顾客订单已完成可评价 | 促进评价 |
| 售后与评价 | 申请退款 | 提交退款原因、退款内容 | 退款售后 |
| 售后与评价 | 退款进度查询 | 查看退款处理中、已退款、已拒绝 | 售后透明 |
| 售后与评价 | 退款结果说明 | 查看退款金额、驳回原因、处理说明 | 售后结果 |
| 售后与评价 | 订单评价 | 对订单或商品进行星级评价 | 评价管理 |
| 售后与评价 | 晒图评价 | 上传图片补充体验内容 | 图文评价 |
| 售后与评价 | 匿名评价 | 保护顾客隐私 | 常用评价能力 |
| 售后与评价 | 查看商家回复 | 查看商家对评价的回复 | 评价闭环 |
| 售后与评价 | 评价奖励提示 | 告知评价可获得积分等奖励 | 积分规则 |
### 6.4 订单重点说明
- 订单页的重点是“透明感”,顾客要知道订单到哪一步了
- 自提和堂食不能简单复用外卖逻辑,必须突出取餐码、桌号、用餐状态
- 售后入口必须清楚,避免顾客找不到退款路径
---
## 7. 菜单四:我的
### 7.1 菜单定位
我的页用于承接顾客身份、用户资产、服务入口和复购能力,是长期留存的重要页面。
### 7.2 功能大类
- 账户与基础资料
- 会员与资产
- 服务与消息
- 复购与个性化
### 7.3 详细功能清单
| 功能大类 | 具体功能名称 | 功能作用 | 备注 / 来源能力 |
| --- | --- | --- | --- |
| 账户与基础资料 | 微信授权登录 | 获取用户基础身份信息 | 小程序基础能力 |
| 账户与基础资料 | 手机号绑定 | 绑定下单手机号,便于通知和履约 | 顾客身份 |
| 账户与基础资料 | 头像昵称展示 | 显示顾客基础资料 | 我的首页头部 |
| 账户与基础资料 | 收货地址管理 | 新增、编辑、删除常用收货地址 | 地址能力 |
| 账户与基础资料 | 常用门店 | 展示顾客常用下单门店 | 多门店复购 |
| 账户与基础资料 | 场景偏好记录 | 沉淀外卖、自提、堂食偏好 | 个性化推荐 |
| 会员与资产 | 会员中心 | 集中展示会员等级、成长值、权益 | 会员管理 |
| 会员与资产 | 会员等级展示 | 展示当前等级和升级条件 | 会员等级体系 |
| 会员与资产 | 成长值进度 | 展示距离下一级还差多少 | 激励升级 |
| 会员与资产 | 会员权益展示 | 展示折扣、积分倍率、生日特权、会员日权益 | 会员等级配置 |
| 会员与资产 | 优惠券列表 | 查看未使用、已使用、已过期优惠券 | 优惠券资产 |
| 会员与资产 | 券详情说明 | 展示门槛、有效期、适用门店、适用场景 | 优惠券使用说明 |
| 会员与资产 | 积分余额 | 展示当前可用积分 | 积分体系 |
| 会员与资产 | 积分明细 | 查看积分获取、使用、过期记录 | 积分规则 |
| 会员与资产 | 积分商城 | 使用积分兑换商品、权益或优惠券 | 积分商城 |
| 会员与资产 | 积分兑换记录 | 查看积分兑换历史 | 积分记录 |
| 会员与资产 | 储值余额 | 展示当前储值可用余额 | 储值卡 |
| 会员与资产 | 充值方案列表 | 展示可选充值金额、赠送金额、到账金额 | 储值卡配置 |
| 会员与资产 | 充值记录 | 查看每次充值的支付方式和到账明细 | 储值记录 |
| 会员与资产 | 次卡列表 | 查看已购买次卡、剩余次数、有效期 | 次卡管理 |
| 会员与资产 | 次卡适用范围说明 | 展示次卡适用商品或分类 | 次卡使用说明 |
| 会员与资产 | 次卡使用记录 | 查看每次核销明细 | 次卡记录 |
| 会员与资产 | 新客礼包 | 查看已领取的新客礼包内容与使用状态 | 新客有礼 |
| 服务与消息 | 消息中心 | 集中查看订单消息、营销消息、系统通知 | 消息中心 |
| 服务与消息 | 订单消息 | 查看支付成功、接单、配送、退款消息 | 订单通知 |
| 服务与消息 | 营销消息 | 查看发券通知、活动提醒、会员日提醒 | 营销触达 |
| 服务与消息 | 系统通知 | 查看规则变化、服务公告等 | 系统消息 |
| 服务与消息 | 帮助中心 | 查看常见问题、订单帮助、支付帮助、退款帮助 | 帮助中心 |
| 服务与消息 | 联系客服 | 联系在线客服或电话客服 | 服务入口 |
| 服务与消息 | 意见反馈 | 反馈问题、建议或投诉 | 用户反馈 |
| 服务与消息 | 用户协议与隐私说明 | 查看协议、隐私政策、授权说明 | 合规要求 |
| 复购与个性化 | 最近订单 | 快速查看最近下单记录 | 复购入口 |
| 复购与个性化 | 常点商品 | 展示顾客高频购买商品 | 个性化推荐 |
| 复购与个性化 | 猜你喜欢 | 根据历史偏好推荐商品 | 客户画像结果承接 |
| 复购与个性化 | 一键再来一单 | 基于历史订单直接重建购物车 | 提升复购转化 |
| 复购与个性化 | 会员专享推荐 | 向会员展示专享商品、专享活动 | 会员价值感 |
### 7.4 我的页重点说明
- “我的”不是简单信息页,而是资产页 + 服务页 + 复购页
- 必须把“我有什么优惠、我还剩多少积分、我能不能更便宜地下单”表达清楚
- 对老客来说,“我的”页是复购和资产回访的核心入口
---
## 8. 重点专项页面(非底部菜单)
### 8.1 堂食扫码入桌页
| 功能名称 | 功能作用 |
| --- | --- |
| 扫码识别门店 | 识别当前桌码所属门店 |
| 扫码识别桌号 | 自动带出桌号 / 桌台编号 |
| 确认入桌 | 顾客确认当前桌号正确 |
| 查看同桌订单状态 | 查看本桌当前点单情况 |
| 堂食菜单入口 | 进入堂食点餐页 |
| 加菜入口 | 已点单后继续加菜 |
| 呼叫服务入口 | 需要时联系门店服务人员 |
作用说明:
- 这是堂食场景最关键页面,决定顾客能否无障碍进入堂食流程
- 扫码成功后应尽量少让用户做选择,自动绑定桌号与门店
### 8.2 领券中心页
| 功能名称 | 功能作用 |
| --- | --- |
| 可领取优惠券列表 | 查看所有可领取优惠券 |
| 已领取状态展示 | 告知顾客是否已领取 |
| 优惠券使用门槛展示 | 展示满减门槛、适用范围 |
| 有效期展示 | 告知过期时间 |
| 立即使用入口 | 领取后直接去点餐 |
### 8.3 会员中心页
| 功能名称 | 功能作用 |
| --- | --- |
| 当前会员等级 | 展示顾客等级 |
| 升级条件 | 展示还差多少成长值 / 消费额可升级 |
| 权益总览 | 展示折扣、积分倍率、生日券、会员日等 |
| 等级说明 | 展示全部等级和对应权益 |
| 会员任务 / 激励 | 引导用户消费、评价、签到等积累成长 |
### 8.4 积分商城页
| 功能名称 | 功能作用 |
| --- | --- |
| 积分商品列表 | 展示可兑换商品或权益 |
| 积分兑换详情 | 展示兑换所需积分和规则 |
| 兑换记录 | 查看已兑换记录 |
| 兑换状态 | 展示待核销、已核销、已失效等状态 |
### 8.5 储值充值页
| 功能名称 | 功能作用 |
| --- | --- |
| 充值方案列表 | 展示充多少送多少 |
| 实付与到账金额说明 | 清楚展示实充、赠送、到账 |
| 充值支付 | 发起微信支付充值 |
| 充值记录 | 查看充值历史和支付方式 |
| 储值余额说明 | 解释余额如何使用 |
### 8.6 次卡页
| 功能名称 | 功能作用 |
| --- | --- |
| 次卡购买列表 | 展示可购买的次卡 |
| 次卡详情 | 展示适用商品、有效期、次数 |
| 已购次卡列表 | 展示个人已购买次卡 |
| 次卡剩余次数 | 告知还能用几次 |
| 次卡核销记录 | 追踪使用情况 |
---
## 9. 公共能力与通用规则
### 9.1 登录与身份规则
- 顾客首次进入可以先浏览首页和门店信息
- 在以下行为前必须完成必要授权或绑定:
- 提交订单
- 使用优惠券、积分、储值、次卡
- 查看“我的”资产
- 接收订单通知
### 9.2 门店与场景规则
- 所有商品、价格、活动、履约规则均以“当前门店 + 当前场景”为准
- 外卖、自提、堂食的商品、价格、活动支持存在差异
- 堂食扫码进入后,应尽量锁定门店与桌号,避免误切换
### 9.3 价格与优惠规则
- 顾客端负责展示:
- 可用优惠券
- 命中的满减 / 折扣 / 秒杀
- 可用积分和储值余额
- 实付金额计算结果
- 后台负责配置具体命中规则、适用门店、适用时段、适用场景和优先级
### 9.4 消息通知规则
顾客端消息建议分为三类:
- 订单消息:支付成功、接单、出餐、配送、退款处理
- 营销消息:发券通知、活动提醒、会员日提醒、储值活动
- 系统通知:服务公告、规则更新、门店通知
### 9.5 评价与售后规则
- 订单完成后应引导评价
- 评价支持星级、文字、图片、匿名
- 商家回复后,顾客端应可见
- 退款申请需有明确状态与处理结果说明
---
## 10. 不进入 C 端菜单的后台模块
以下模块属于租户后台能力,不需要做成顾客端独立页面:
| 后台模块 | 不做成 C 端页面的原因 |
| --- | --- |
| 财务概览 / 交易流水 / 到账查询 | 属于商家经营数据,不对顾客开放 |
| 成本管理 / 发票管理 / 经营报表 | 属于商家经营与财务管理 |
| 商品分析 / 订单分析 / 营销分析 / 客户分析 | 用于商家运营决策,不是顾客操作页面 |
| 库存总览 / 出入库 / 采购 / 效期管理 | 属于供应链与库存后台 |
| 渠道管理 / 订单聚合 / 菜单同步 / 配送调度 | 属于平台聚合与运营后台 |
| 系统角色 / 子账号 / 日志 / 计费 / 升级 | 属于系统管理与 SaaS 管理 |
| 打印设置 / 后厨联 / 小票模板 | 属于门店作业能力 |
| 门店员工 / 资质证照 / 子账号管理 | 属于商家组织与合规管理 |
说明:
- 这些后台模块虽然不出现在顾客端页面里,但它们的配置结果会影响顾客端体验
- 例如:营业时间、配送范围、商品库存、活动规则、会员权益,都要在顾客端准确承接
---
## 11. 页面清单建议
### 11.1 主页面
- 首页
- 点餐页
- 订单页
- 我的页
### 11.2 二级页面
- 门店选择页
- 地址管理页
- 商品详情页 / 弹层
- 购物车浮层
- 结算确认页
- 支付成功页
- 订单详情页
- 退款申请页
- 退款详情页
- 评价页
- 领券中心页
- 秒杀活动页
- 限时折扣活动页
- 会员中心页
- 积分商城页
- 储值充值页
- 次卡页
- 消息中心页
- 帮助中心页
- 堂食扫码确认页
---
## 12. 一期验收标准
### 12.1 必须跑通的链路
- 新用户进入首页并可看到新客有礼
- 用户可切换门店与点单场景
- 用户可浏览商品、选择规格和加料并加入购物车
- 用户可使用优惠券、积分、储值等资产参与结算
- 用户可用微信支付完成下单
- 外卖订单可查看配送进度
- 自提订单可查看取餐码和取餐时间
- 堂食扫码后可完成点餐和加菜
- 用户可查看订单状态、发起退款、提交评价
- 用户可在“我的”中查看会员、券、积分、储值、次卡和消息
### 12.2 关键边界场景
- 地址超出配送范围时禁止提交外卖订单
- 未达到起送门槛时要明确提示差额
- 商品售罄、活动失效、超营业时间时要清晰提示
- 门店休息或特殊营业时,首页和点餐页同步提示
- 堂食扫码桌号失效时,提示重新扫码或联系门店
- 优惠不可用时必须说明原因,例如门槛不足、已过期、场景不匹配
---
## 13. 结论
本需求文档将租户端原型能力映射为顾客小程序的 4 个主菜单和多个二级页面。
其中:
- `首页` 负责选店与导流
- `点餐` 负责转化与支付
- `订单` 负责履约与售后
- `我的` 负责资产、服务与复购
如果进入下一步设计与实施,建议按以下顺序继续输出:
1. 页面结构图 / 信息架构图
2. 用户流程图(外卖 / 自提 / 堂食)
3. 页面级原型清单
4. 接口清单与字段定义
5. 小程序 UI 规范与组件规范

Some files were not shown because too many files have changed in this diff Show More