diff --git a/Cend-MiniProgram-Prototype/GEMINI.MD b/Cend-MiniProgram-Prototype/GEMINI.MD new file mode 100644 index 0000000..6ac5a08 --- /dev/null +++ b/Cend-MiniProgram-Prototype/GEMINI.MD @@ -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 能在此基础上继续做真实代码实现 + +你当前的目标不是把代码做复杂，而是把原型做准确。 diff --git a/Cend-MiniProgram-Prototype/README.md b/Cend-MiniProgram-Prototype/README.md new file mode 100644 index 0000000..47b7201 --- /dev/null +++ b/Cend-MiniProgram-Prototype/README.md @@ -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` +- 页面覆盖：首页、点餐、订单、我的、结算、支付成功、订单详情、退款、评价、会员资产、活动页、辅助页 +- 演示结构：左侧为阶段计划与页面导航，右侧为移动端原型画布 diff --git a/Cend-MiniProgram-Prototype/README.patch b/Cend-MiniProgram-Prototype/README.patch new file mode 100644 index 0000000..2620c86 --- /dev/null +++ b/Cend-MiniProgram-Prototype/README.patch @@ -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 diff --git a/Cend-MiniProgram-Prototype/docs/01-文档导航与实施顺序.md b/Cend-MiniProgram-Prototype/docs/01-文档导航与实施顺序.md new file mode 100644 index 0000000..7f9edb2 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/01-文档导航与实施顺序.md @@ -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. 交付标准 + +如果页面是按本套文档完成的，应满足以下要求： + +- 页面层级、路由、入口与出口清晰 +- 页面从上到下的区块顺序与文档一致 +- 每个区块具备文档要求的字段与交互 +- 页面具备默认态、空态、异常态、禁用态等必要状态 +- 业务对象和后台配置关系清晰可追溯 + diff --git a/Cend-MiniProgram-Prototype/docs/02-信息架构与路由.md b/Cend-MiniProgram-Prototype/docs/02-信息架构与路由.md new file mode 100644 index 0000000..e11401a --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/02-信息架构与路由.md @@ -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 抽屉与弹层 +- 不应中断当前页面上下文 +- 应支持手势关闭 / 点击遮罩关闭（支付与关键确认除外） +- 关闭后保留当前页面已选状态 + diff --git a/Cend-MiniProgram-Prototype/docs/03-全局业务规则.md b/Cend-MiniProgram-Prototype/docs/03-全局业务规则.md new file mode 100644 index 0000000..da56526 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/03-全局业务规则.md @@ -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 按钮固定在页面底部或区块底部 +- 结算相关页面必须把金额明细解释清楚 +- 场景切换、门店切换、地址切换属于高风险动作，需要在必要时提示购物车清空 +- 同一页面的主要操作按钮文案要稳定，不同页面不要频繁变形 + diff --git a/Cend-MiniProgram-Prototype/docs/04-核心用户流程.md b/Cend-MiniProgram-Prototype/docs/04-核心用户流程.md new file mode 100644 index 0000000..97f9482 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/04-核心用户流程.md @@ -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. 返回点餐页或结算页使用资产 + diff --git a/Cend-MiniProgram-Prototype/docs/05-页面清单总表.md b/Cend-MiniProgram-Prototype/docs/05-页面清单总表.md new file mode 100644 index 0000000..403d21a --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/05-页面清单总表.md @@ -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` 堂食扫码确认页 + diff --git a/Cend-MiniProgram-Prototype/docs/06-通用组件清单.md b/Cend-MiniProgram-Prototype/docs/06-通用组件清单.md new file mode 100644 index 0000000..34031cb --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/06-通用组件清单.md @@ -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. 通用实现要求 + +- 所有卡片组件需要支持禁用态或不可点击态 +- 列表项需要支持右侧箭头、辅助文案、角标等变化 +- 底部固定操作栏需要考虑安全区 +- 金额展示组件统一格式化 +- 状态标签颜色语义在整个应用中保持一致 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/01-Tab-首页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/01-Tab-首页.md new file mode 100644 index 0000000..de5a44d --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/01-Tab-首页.md @@ -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. 实现备注 + +- 首页优先是“导流页”，不是深度浏览页 +- 推荐商品只展示摘要，不在首页直接承载复杂选配 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/02-Tab-点餐页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/02-Tab-点餐页.md new file mode 100644 index 0000000..8489f71 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/02-Tab-点餐页.md @@ -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. 实现备注 + +- 点餐页是整套小程序最核心页面，需要优先保证信息密度和操作效率 +- 商品详情、购物车应通过抽屉承载，尽量不跳转新页面 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/03-Tab-订单页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/03-Tab-订单页.md new file mode 100644 index 0000000..48f0f33 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/03-Tab-订单页.md @@ -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. 实现备注 + +- 订单页重点是列表可扫读性 +- 一屏内要能快速看懂状态、门店、金额和下一步动作 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/04-Tab-我的页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/04-Tab-我的页.md new file mode 100644 index 0000000..4ca05f2 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/04-Tab-我的页.md @@ -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. 实现备注 + +- “我的”页要兼顾资产页和服务页 +- 顶部头部卡与资产总览区需要在视觉上形成核心焦点 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/05-门店选择页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/05-门店选择页.md new file mode 100644 index 0000000..e0f91cf --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/05-门店选择页.md @@ -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. 实现备注 + +- 门店列表要把“能否下单”说清楚，不仅展示名字 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/06-地址管理页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/06-地址管理页.md new file mode 100644 index 0000000..fce82cc --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/06-地址管理页.md @@ -0,0 +1,47 @@ +# P02 地址管理页 + +- 页面编码：`P02` +- 页面层级：`二级页` +- 页面目标：管理顾客常用收货地址，并服务外卖结算 +- 主要依赖组件：`G01` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. 地址列表区 +3. 新增地址按钮 + +## 2. 区块说明 + +### 2.1 地址列表区 +- 每个地址项展示： + - 收货人姓名 + - 手机号 + - 详细地址 + - 默认地址标签 + - 适用范围提示（可选） +- 支持动作： + - 设为默认 + - 编辑 + - 删除 + - 选择用于本次结算 + +### 2.2 新增地址按钮 +- 固定在页面底部或列表底部 +- 点击后进入编辑态（可独立页或表单弹层） + +## 3. 页面状态 + +### 默认态 +- 展示已有地址 + +### 空态 +- 无地址时展示空态和新增 CTA + +### 异常态 +- 地址保存失败 / 删除失败时需要提示 + +## 4. 实现备注 + +- 如果另一位 AI 需要拆成“地址列表页 + 地址编辑页”，可以追加子页面，但当前文档以一个管理页为主 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/07-商品详情抽屉.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/07-商品详情抽屉.md new file mode 100644 index 0000000..2ed5933 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/07-商品详情抽屉.md @@ -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. 实现备注 + +- 抽屉应保留当前点餐页上下文 +- 关闭抽屉不应导致列表位置丢失 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/08-购物车抽屉.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/08-购物车抽屉.md new file mode 100644 index 0000000..139c678 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/08-购物车抽屉.md @@ -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. 实现备注 + +- 购物车抽屉必须支持快速修改数量 +- 去结算按钮应只保留一个主路径，不做复杂分支 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/09-结算确认页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/09-结算确认页.md new file mode 100644 index 0000000..5a1237d --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/09-结算确认页.md @@ -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. 实现备注 + +- 结算页核心是“信息确认 + 金额确认” +- 所有会影响实付金额的项目都必须可见 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/10-支付成功页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/10-支付成功页.md new file mode 100644 index 0000000..e6b5eba --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/10-支付成功页.md @@ -0,0 +1,42 @@ +# P04 支付成功页 + +- 页面编码：`P04` +- 页面层级：`二级页` +- 页面目标：明确告诉用户支付已完成，并引导后续查看订单或继续点单 +- 主要依赖组件：`G01` + +## 1. 页面结构（从上到下） + +1. 成功状态区 +2. 订单摘要区 +3. 场景关键信息区 +4. 后续动作区 + +## 2. 区块说明 + +### 2.1 成功状态区 +- 成功图标 +- 标题：支付成功 +- 副文案：订单已提交，等待商家处理 + +### 2.2 订单摘要区 +- 展示订单号、门店名称、支付金额 + +### 2.3 场景关键信息区 +- 外卖：预计送达时间 +- 自提：取餐时间和取餐说明 +- 堂食：桌号与用餐状态 + +### 2.4 后续动作区 +- 查看订单详情 +- 继续点餐 / 再逛逛 + +## 3. 页面状态 + +- 支付成功为唯一主状态 +- 若返回支付结果异常，应回退到结算页或订单详情页校验状态 + +## 4. 实现备注 + +- 成功页停留时间不宜过长，应明确给出下一步 CTA + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/11-订单详情页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/11-订单详情页.md new file mode 100644 index 0000000..f1ab0e8 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/11-订单详情页.md @@ -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. 实现备注 + +- 订单详情页是强状态页面，顶部状态区必须足够明确 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/12-退款申请页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/12-退款申请页.md new file mode 100644 index 0000000..ab411c4 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/12-退款申请页.md @@ -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. 实现备注 + +- 页面目标是低阻力提交，不宜放过多冗余字段 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/13-退款详情页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/13-退款详情页.md new file mode 100644 index 0000000..f881fdd --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/13-退款详情页.md @@ -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. 实现备注 + +- 拒绝状态必须明确展示驳回原因 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/14-评价页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/14-评价页.md new file mode 100644 index 0000000..8a92463 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/14-评价页.md @@ -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. 实现备注 + +- 评价成功后可弹出“获得积分”提示，但不应阻塞主流程 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/15-领券中心页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/15-领券中心页.md new file mode 100644 index 0000000..4b7e161 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/15-领券中心页.md @@ -0,0 +1,42 @@ +# P09 领券中心页 + +- 页面编码：`P09` +- 页面层级：`二级页` +- 页面目标：集中展示可领取优惠券，并引导回到点餐使用 +- 主要依赖组件：`G01`、`G43` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. 券分类筛选区 +3. 优惠券列表区 +4. 底部引导区 + +## 2. 区块说明 + +### 2.1 券分类筛选区 +- 可按全部、满减券、折扣券、免配送费券筛选 + +### 2.2 优惠券列表区 +- 使用 `G43` +- 每张券卡必须展示： + - 券名称 + - 金额 / 折扣 + - 使用门槛 + - 有效期 + - 适用门店 / 场景 + - 领取状态 + +### 2.3 底部引导区 +- 提供“去点餐”入口 + +## 3. 页面状态 + +- 默认态：有可领取券 +- 空态：无券可领 +- 已领取态：按钮改为已领取或去使用 + +## 4. 实现备注 + +- 领取动作应尽量轻量，领取成功后不强制跳转 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/16-秒杀活动页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/16-秒杀活动页.md new file mode 100644 index 0000000..5d1e577 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/16-秒杀活动页.md @@ -0,0 +1,41 @@ +# P10 秒杀活动页 + +- 页面编码：`P10` +- 页面层级：`二级页` +- 页面目标：承接强时效抢购活动，提升转化 +- 主要依赖组件：`G01`、`G21` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. 秒杀头图区 +3. 场次切换区 +4. 秒杀商品列表区 + +## 2. 区块说明 + +### 2.1 秒杀头图区 +- 展示活动标题、主视觉、倒计时 + +### 2.2 场次切换区 +- 展示当前场次、即将开始场次、已结束场次 + +### 2.3 秒杀商品列表区 +- 商品卡展示： + - 商品图片 + - 秒杀价 + - 原价 + - 剩余库存 / 已售比例 + - 每单限购 + - 立即抢购 + +## 3. 页面状态 + +- 未开始态 +- 进行中态 +- 已结束态 + +## 4. 实现备注 + +- 秒杀页要突出时间紧迫感和库存稀缺感 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/17-限时折扣活动页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/17-限时折扣活动页.md new file mode 100644 index 0000000..026199f --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/17-限时折扣活动页.md @@ -0,0 +1,43 @@ +# P11 限时折扣活动页 + +- 页面编码：`P11` +- 页面层级：`二级页` +- 页面目标：承接限时折扣活动，集中展示折扣商品 +- 主要依赖组件：`G01`、`G21` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. 活动头图区 +3. 活动时间筛选区 +4. 折扣商品列表区 + +## 2. 区块说明 + +### 2.1 活动头图区 +- 展示活动标题、当前折扣主题、时间说明 + +### 2.2 活动时间筛选区 +- 当前进行中 +- 即将开始 +- 已结束 + +### 2.3 折扣商品列表区 +- 商品卡展示： + - 图片 + - 商品名称 + - 折扣价 + - 原价 + - 折扣力度 + - 立即购买 + +## 3. 页面状态 + +- 进行中：可购买 +- 未开始：展示开始时间 +- 已结束：置灰展示 + +## 4. 实现备注 + +- 与秒杀页相比，限时折扣页要弱化“抢”，强化“省” + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/18-会员中心页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/18-会员中心页.md new file mode 100644 index 0000000..2756984 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/18-会员中心页.md @@ -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. 实现备注 + +- 会员中心要重点突出“当前能享受什么”和“如何升级” + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/19-积分商城页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/19-积分商城页.md new file mode 100644 index 0000000..b44d497 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/19-积分商城页.md @@ -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. 实现备注 + +- 积分商城强调“积分能干什么”，不要只展示数值 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/20-储值充值页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/20-储值充值页.md new file mode 100644 index 0000000..3711ff1 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/20-储值充值页.md @@ -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. 实现备注 + +- 充值金额、赠送金额、到账金额三者必须同时可见 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/21-次卡页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/21-次卡页.md new file mode 100644 index 0000000..0414e76 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/21-次卡页.md @@ -0,0 +1,38 @@ +# P15 次卡页 + +- 页面编码：`P15` +- 页面层级：`二级页` +- 页面目标：展示可购买次卡、已购次卡和核销记录 +- 主要依赖组件：`G01`、`G45` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. Tab 切换区 +3. 次卡列表区 + +## 2. 区块说明 + +### 2.1 Tab 切换区 +- 可购买次卡 +- 我的次卡 +- 使用记录（可选） + +### 2.2 次卡列表区 +- 使用 `G45` +- 次卡卡片展示： + - 次卡名称 + - 适用范围 + - 有效期 + - 剩余次数 / 总次数 + - 购买或查看详情按钮 + +## 3. 页面状态 + +- 默认态：有可购或已购次卡 +- 空态：暂无次卡 + +## 4. 实现备注 + +- 次卡页需要把“适用什么商品”和“还剩几次”表达清楚 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/22-消息中心页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/22-消息中心页.md new file mode 100644 index 0000000..50cbc06 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/22-消息中心页.md @@ -0,0 +1,39 @@ +# P16 消息中心页 + +- 页面编码：`P16` +- 页面层级：`二级页` +- 页面目标：集中查看订单消息、营销消息和系统通知 +- 主要依赖组件：`G01`、`G46` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. 消息分类切换区 +3. 消息列表区 + +## 2. 区块说明 + +### 2.1 消息分类切换区 +- 全部 +- 订单消息 +- 营销消息 +- 系统通知 + +### 2.2 消息列表区 +- 使用 `G46` +- 每条消息展示： + - 标题 + - 摘要 + - 时间 + - 未读状态 +- 点击消息跳转到对应业务页面 + +## 3. 页面状态 + +- 默认态：有消息 +- 空态：暂无消息 + +## 4. 实现备注 + +- 消息要支持按读写状态区分，但不需要复杂会话系统 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/23-帮助中心页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/23-帮助中心页.md new file mode 100644 index 0000000..414bd1a --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/23-帮助中心页.md @@ -0,0 +1,44 @@ +# P17 帮助中心页 + +- 页面编码：`P17` +- 页面层级：`二级页` +- 页面目标：承接常见问题、规则说明和客服联系 +- 主要依赖组件：`G01` + +## 1. 页面结构（从上到下） + +1. 顶部导航栏 +2. 常见问题区 +3. 专题帮助区 +4. 联系客服区 + +## 2. 区块说明 + +### 2.1 常见问题区 +- 以折叠列表形式展示 +- 建议覆盖： + - 如何下单 + - 如何使用优惠券 + - 如何申请退款 + - 如何查看取餐码 + +### 2.2 专题帮助区 +- 支付帮助 +- 配送帮助 +- 自提帮助 +- 堂食帮助 +- 会员与资产帮助 + +### 2.3 联系客服区 +- 在线客服入口 +- 电话客服入口 + +## 3. 页面状态 + +- 默认态即可 +- 若帮助内容为空，则展示联系客服入口 + +## 4. 实现备注 + +- 帮助中心主要作为兜底服务页，不需要复杂交互 + diff --git a/Cend-MiniProgram-Prototype/docs/07-页面规格/24-堂食扫码确认页.md b/Cend-MiniProgram-Prototype/docs/07-页面规格/24-堂食扫码确认页.md new file mode 100644 index 0000000..023ae06 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/07-页面规格/24-堂食扫码确认页.md @@ -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. 实现备注 + +- 该页要尽量减少用户输入，优先自动确认门店和桌号 + diff --git a/Cend-MiniProgram-Prototype/docs/08-全周期版本规划与范围分层.md b/Cend-MiniProgram-Prototype/docs/08-全周期版本规划与范围分层.md new file mode 100644 index 0000000..c431bc1 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/08-全周期版本规划与范围分层.md @@ -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` 负责定义“研发实施时先做什么、交付什么” diff --git a/Cend-MiniProgram-Prototype/docs/09-租户后台与C端功能映射总表.md b/Cend-MiniProgram-Prototype/docs/09-租户后台与C端功能映射总表.md new file mode 100644 index 0000000..4fb3608 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/09-租户后台与C端功能映射总表.md @@ -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. 如果某个后台能力当前没有对应的顾客价值，就先作为支撑能力，不强行做前台页面 diff --git a/Cend-MiniProgram-Prototype/docs/10-全周期研发实施顺序与交付清单.md b/Cend-MiniProgram-Prototype/docs/10-全周期研发实施顺序与交付清单.md new file mode 100644 index 0000000..1c51ce1 --- /dev/null +++ b/Cend-MiniProgram-Prototype/docs/10-全周期研发实施顺序与交付清单.md @@ -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 端小程序的关系才会清晰，整个项目也不会越做越散。 diff --git a/Cend-MiniProgram-Prototype/docs/before-home.png b/Cend-MiniProgram-Prototype/docs/before-home.png new file mode 100644 index 0000000..ddaac2d Binary files /dev/null and b/Cend-MiniProgram-Prototype/docs/before-home.png differ diff --git a/Cend-MiniProgram-Prototype/index.html b/Cend-MiniProgram-Prototype/index.html new file mode 100644 index 0000000..cd9cfcf --- /dev/null +++ b/Cend-MiniProgram-Prototype/index.html @@ -0,0 +1,1511 @@ + + + + + + TakeoutSaaS C端小程序原型 + + + +
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ + + + diff --git a/Cend-MiniProgram-Prototype/plan.md b/Cend-MiniProgram-Prototype/plan.md new file mode 100644 index 0000000..a10c749 --- /dev/null +++ b/Cend-MiniProgram-Prototype/plan.md @@ -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`： +- 一阶段一阶段推进 +- 一页面一页面落地 +- 每完成一个页面就自检 +- 每完成一个阶段再进入下一个阶段 + +本计划不是参考建议，而是执行顺序。 diff --git a/Cend-MiniProgram-Prototype/小程序C端功能需求文档.md b/Cend-MiniProgram-Prototype/小程序C端功能需求文档.md new file mode 100644 index 0000000..8082189 --- /dev/null +++ b/Cend-MiniProgram-Prototype/小程序C端功能需求文档.md @@ -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 规范与组件规范 diff --git a/.claude/settings.local.json b/Tenant-Admin-UI-Prototype/.claude/settings.local.json similarity index 100% rename from .claude/settings.local.json rename to Tenant-Admin-UI-Prototype/.claude/settings.local.json diff --git a/docker-compose.yml b/Tenant-Admin-UI-Prototype/docker-compose.yml similarity index 100% rename from docker-compose.yml rename to Tenant-Admin-UI-Prototype/docker-compose.yml diff --git a/index.html b/Tenant-Admin-UI-Prototype/index.html similarity index 100% rename from index.html rename to Tenant-Admin-UI-Prototype/index.html diff --git a/nginx.conf b/Tenant-Admin-UI-Prototype/nginx.conf similarity index 100% rename from nginx.conf rename to Tenant-Admin-UI-Prototype/nginx.conf diff --git a/pages/_b64chunk.txt b/Tenant-Admin-UI-Prototype/pages/_b64chunk.txt similarity index 100% rename from pages/_b64chunk.txt rename to Tenant-Admin-UI-Prototype/pages/_b64chunk.txt diff --git a/pages/_b64write.py b/Tenant-Admin-UI-Prototype/pages/_b64write.py similarity index 100% rename from pages/_b64write.py rename to Tenant-Admin-UI-Prototype/pages/_b64write.py diff --git a/pages/_create_cust_analysis.py b/Tenant-Admin-UI-Prototype/pages/_create_cust_analysis.py similarity index 100% rename from pages/_create_cust_analysis.py rename to Tenant-Admin-UI-Prototype/pages/_create_cust_analysis.py diff --git a/pages/_gen.py b/Tenant-Admin-UI-Prototype/pages/_gen.py similarity index 100% rename from pages/_gen.py rename to Tenant-Admin-UI-Prototype/pages/_gen.py diff --git a/pages/ch-delivery.html b/Tenant-Admin-UI-Prototype/pages/ch-delivery.html similarity index 100% rename from pages/ch-delivery.html rename to Tenant-Admin-UI-Prototype/pages/ch-delivery.html diff --git a/pages/ch-menu-sync.html b/Tenant-Admin-UI-Prototype/pages/ch-menu-sync.html similarity index 100% rename from pages/ch-menu-sync.html rename to Tenant-Admin-UI-Prototype/pages/ch-menu-sync.html diff --git a/pages/ch-orders.html b/Tenant-Admin-UI-Prototype/pages/ch-orders.html similarity index 100% rename from pages/ch-orders.html rename to Tenant-Admin-UI-Prototype/pages/ch-orders.html diff --git a/pages/ch-platform.html b/Tenant-Admin-UI-Prototype/pages/ch-platform.html similarity index 100% rename from pages/ch-platform.html rename to Tenant-Admin-UI-Prototype/pages/ch-platform.html diff --git a/pages/cpl-expiry.html b/Tenant-Admin-UI-Prototype/pages/cpl-expiry.html similarity index 100% rename from pages/cpl-expiry.html rename to Tenant-Admin-UI-Prototype/pages/cpl-expiry.html diff --git a/pages/cpl-inspect.html b/Tenant-Admin-UI-Prototype/pages/cpl-inspect.html similarity index 100% rename from pages/cpl-inspect.html rename to Tenant-Admin-UI-Prototype/pages/cpl-inspect.html diff --git a/pages/cpl-license.html b/Tenant-Admin-UI-Prototype/pages/cpl-license.html similarity index 100% rename from pages/cpl-license.html rename to Tenant-Admin-UI-Prototype/pages/cpl-license.html diff --git a/pages/cpl-trace.html b/Tenant-Admin-UI-Prototype/pages/cpl-trace.html similarity index 100% rename from pages/cpl-trace.html rename to Tenant-Admin-UI-Prototype/pages/cpl-trace.html diff --git a/pages/cust-analysis.html b/Tenant-Admin-UI-Prototype/pages/cust-analysis.html similarity index 100% rename from pages/cust-analysis.html rename to Tenant-Admin-UI-Prototype/pages/cust-analysis.html diff --git a/pages/cust-list.html b/Tenant-Admin-UI-Prototype/pages/cust-list.html similarity index 100% rename from pages/cust-list.html rename to Tenant-Admin-UI-Prototype/pages/cust-list.html diff --git a/pages/cust-profile.html b/Tenant-Admin-UI-Prototype/pages/cust-profile.html similarity index 100% rename from pages/cust-profile.html rename to Tenant-Admin-UI-Prototype/pages/cust-profile.html diff --git a/pages/dashboard.html b/Tenant-Admin-UI-Prototype/pages/dashboard.html similarity index 100% rename from pages/dashboard.html rename to Tenant-Admin-UI-Prototype/pages/dashboard.html diff --git a/pages/fin-cost.html b/Tenant-Admin-UI-Prototype/pages/fin-cost.html similarity index 100% rename from pages/fin-cost.html rename to Tenant-Admin-UI-Prototype/pages/fin-cost.html diff --git a/pages/fin-invoice.html b/Tenant-Admin-UI-Prototype/pages/fin-invoice.html similarity index 100% rename from pages/fin-invoice.html rename to Tenant-Admin-UI-Prototype/pages/fin-invoice.html diff --git a/pages/fin-overview.html b/Tenant-Admin-UI-Prototype/pages/fin-overview.html similarity index 100% rename from pages/fin-overview.html rename to Tenant-Admin-UI-Prototype/pages/fin-overview.html diff --git a/pages/fin-reports.html b/Tenant-Admin-UI-Prototype/pages/fin-reports.html similarity index 100% rename from pages/fin-reports.html rename to Tenant-Admin-UI-Prototype/pages/fin-reports.html diff --git a/pages/fin-settlement.html b/Tenant-Admin-UI-Prototype/pages/fin-settlement.html similarity index 100% rename from pages/fin-settlement.html rename to Tenant-Admin-UI-Prototype/pages/fin-settlement.html diff --git a/pages/fin-transactions.html b/Tenant-Admin-UI-Prototype/pages/fin-transactions.html similarity index 100% rename from pages/fin-transactions.html rename to Tenant-Admin-UI-Prototype/pages/fin-transactions.html diff --git a/pages/help-center.html b/Tenant-Admin-UI-Prototype/pages/help-center.html similarity index 100% rename from pages/help-center.html rename to Tenant-Admin-UI-Prototype/pages/help-center.html diff --git a/pages/inv-expiry.html b/Tenant-Admin-UI-Prototype/pages/inv-expiry.html similarity index 100% rename from pages/inv-expiry.html rename to Tenant-Admin-UI-Prototype/pages/inv-expiry.html diff --git a/pages/inv-inout.html b/Tenant-Admin-UI-Prototype/pages/inv-inout.html similarity index 100% rename from pages/inv-inout.html rename to Tenant-Admin-UI-Prototype/pages/inv-inout.html diff --git a/pages/inv-overview.html b/Tenant-Admin-UI-Prototype/pages/inv-overview.html similarity index 100% rename from pages/inv-overview.html rename to Tenant-Admin-UI-Prototype/pages/inv-overview.html diff --git a/pages/inv-purchase.html b/Tenant-Admin-UI-Prototype/pages/inv-purchase.html similarity index 100% rename from pages/inv-purchase.html rename to Tenant-Admin-UI-Prototype/pages/inv-purchase.html diff --git a/pages/inv-soldout.html b/Tenant-Admin-UI-Prototype/pages/inv-soldout.html similarity index 100% rename from pages/inv-soldout.html rename to Tenant-Admin-UI-Prototype/pages/inv-soldout.html diff --git a/pages/mbr-customers.html b/Tenant-Admin-UI-Prototype/pages/mbr-customers.html similarity index 100% rename from pages/mbr-customers.html rename to Tenant-Admin-UI-Prototype/pages/mbr-customers.html diff --git a/pages/mbr-members.html b/Tenant-Admin-UI-Prototype/pages/mbr-members.html similarity index 100% rename from pages/mbr-members.html rename to Tenant-Admin-UI-Prototype/pages/mbr-members.html diff --git a/pages/mbr-messaging.html b/Tenant-Admin-UI-Prototype/pages/mbr-messaging.html similarity index 100% rename from pages/mbr-messaging.html rename to Tenant-Admin-UI-Prototype/pages/mbr-messaging.html diff --git a/pages/mbr-points.html b/Tenant-Admin-UI-Prototype/pages/mbr-points.html similarity index 100% rename from pages/mbr-points.html rename to Tenant-Admin-UI-Prototype/pages/mbr-points.html diff --git a/pages/mbr-prepaid.html b/Tenant-Admin-UI-Prototype/pages/mbr-prepaid.html similarity index 100% rename from pages/mbr-prepaid.html rename to Tenant-Admin-UI-Prototype/pages/mbr-prepaid.html diff --git a/pages/mkt-calendar.html b/Tenant-Admin-UI-Prototype/pages/mkt-calendar.html similarity index 100% rename from pages/mkt-calendar.html rename to Tenant-Admin-UI-Prototype/pages/mkt-calendar.html diff --git a/pages/mkt-coupon.html b/Tenant-Admin-UI-Prototype/pages/mkt-coupon.html similarity index 100% rename from pages/mkt-coupon.html rename to Tenant-Admin-UI-Prototype/pages/mkt-coupon.html diff --git a/pages/mkt-flash-sale.html b/Tenant-Admin-UI-Prototype/pages/mkt-flash-sale.html similarity index 100% rename from pages/mkt-flash-sale.html rename to Tenant-Admin-UI-Prototype/pages/mkt-flash-sale.html diff --git a/pages/mkt-new-customer.html b/Tenant-Admin-UI-Prototype/pages/mkt-new-customer.html similarity index 100% rename from pages/mkt-new-customer.html rename to Tenant-Admin-UI-Prototype/pages/mkt-new-customer.html diff --git a/pages/mkt-pass-card.html b/Tenant-Admin-UI-Prototype/pages/mkt-pass-card.html similarity index 100% rename from pages/mkt-pass-card.html rename to Tenant-Admin-UI-Prototype/pages/mkt-pass-card.html diff --git a/pages/mkt-reduction.html b/Tenant-Admin-UI-Prototype/pages/mkt-reduction.html similarity index 100% rename from pages/mkt-reduction.html rename to Tenant-Admin-UI-Prototype/pages/mkt-reduction.html diff --git a/pages/mkt-seckill.html b/Tenant-Admin-UI-Prototype/pages/mkt-seckill.html similarity index 100% rename from pages/mkt-seckill.html rename to Tenant-Admin-UI-Prototype/pages/mkt-seckill.html diff --git a/pages/msg-center.html b/Tenant-Admin-UI-Prototype/pages/msg-center.html similarity index 100% rename from pages/msg-center.html rename to Tenant-Admin-UI-Prototype/pages/msg-center.html diff --git a/pages/my-profile.html b/Tenant-Admin-UI-Prototype/pages/my-profile.html similarity index 100% rename from pages/my-profile.html rename to Tenant-Admin-UI-Prototype/pages/my-profile.html diff --git a/pages/order-board.html b/Tenant-Admin-UI-Prototype/pages/order-board.html similarity index 100% rename from pages/order-board.html rename to Tenant-Admin-UI-Prototype/pages/order-board.html diff --git a/pages/order-list.html b/Tenant-Admin-UI-Prototype/pages/order-list.html similarity index 100% rename from pages/order-list.html rename to Tenant-Admin-UI-Prototype/pages/order-list.html diff --git a/pages/order-refund.html b/Tenant-Admin-UI-Prototype/pages/order-refund.html similarity index 100% rename from pages/order-refund.html rename to Tenant-Admin-UI-Prototype/pages/order-refund.html diff --git a/pages/order-settings.html b/Tenant-Admin-UI-Prototype/pages/order-settings.html similarity index 100% rename from pages/order-settings.html rename to Tenant-Admin-UI-Prototype/pages/order-settings.html diff --git a/pages/product-addons.html b/Tenant-Admin-UI-Prototype/pages/product-addons.html similarity index 100% rename from pages/product-addons.html rename to Tenant-Admin-UI-Prototype/pages/product-addons.html diff --git a/pages/product-batch.html b/Tenant-Admin-UI-Prototype/pages/product-batch.html similarity index 100% rename from pages/product-batch.html rename to Tenant-Admin-UI-Prototype/pages/product-batch.html diff --git a/pages/product-category.html b/Tenant-Admin-UI-Prototype/pages/product-category.html similarity index 100% rename from pages/product-category.html rename to Tenant-Admin-UI-Prototype/pages/product-category.html diff --git a/pages/product-combos.html b/Tenant-Admin-UI-Prototype/pages/product-combos.html similarity index 100% rename from pages/product-combos.html rename to Tenant-Admin-UI-Prototype/pages/product-combos.html diff --git a/pages/product-detail.html b/Tenant-Admin-UI-Prototype/pages/product-detail.html similarity index 100% rename from pages/product-detail.html rename to Tenant-Admin-UI-Prototype/pages/product-detail.html diff --git a/pages/product-labels.html b/Tenant-Admin-UI-Prototype/pages/product-labels.html similarity index 100% rename from pages/product-labels.html rename to Tenant-Admin-UI-Prototype/pages/product-labels.html diff --git a/pages/product-list.html b/Tenant-Admin-UI-Prototype/pages/product-list.html similarity index 100% rename from pages/product-list.html rename to Tenant-Admin-UI-Prototype/pages/product-list.html diff --git a/pages/product-schedule.html b/Tenant-Admin-UI-Prototype/pages/product-schedule.html similarity index 100% rename from pages/product-schedule.html rename to Tenant-Admin-UI-Prototype/pages/product-schedule.html diff --git a/pages/product-specs.html b/Tenant-Admin-UI-Prototype/pages/product-specs.html similarity index 100% rename from pages/product-specs.html rename to Tenant-Admin-UI-Prototype/pages/product-specs.html diff --git a/pages/reviews.html b/Tenant-Admin-UI-Prototype/pages/reviews.html similarity index 100% rename from pages/reviews.html rename to Tenant-Admin-UI-Prototype/pages/reviews.html diff --git a/pages/stat-customer.html b/Tenant-Admin-UI-Prototype/pages/stat-customer.html similarity index 100% rename from pages/stat-customer.html rename to Tenant-Admin-UI-Prototype/pages/stat-customer.html diff --git a/pages/stat-marketing.html b/Tenant-Admin-UI-Prototype/pages/stat-marketing.html similarity index 100% rename from pages/stat-marketing.html rename to Tenant-Admin-UI-Prototype/pages/stat-marketing.html diff --git a/pages/stat-order.html b/Tenant-Admin-UI-Prototype/pages/stat-order.html similarity index 100% rename from pages/stat-order.html rename to Tenant-Admin-UI-Prototype/pages/stat-order.html diff --git a/pages/stat-product.html b/Tenant-Admin-UI-Prototype/pages/stat-product.html similarity index 100% rename from pages/stat-product.html rename to Tenant-Admin-UI-Prototype/pages/stat-product.html diff --git a/pages/store-delivery.html b/Tenant-Admin-UI-Prototype/pages/store-delivery.html similarity index 100% rename from pages/store-delivery.html rename to Tenant-Admin-UI-Prototype/pages/store-delivery.html diff --git a/pages/store-dinein.html b/Tenant-Admin-UI-Prototype/pages/store-dinein.html similarity index 100% rename from pages/store-dinein.html rename to Tenant-Admin-UI-Prototype/pages/store-dinein.html diff --git a/pages/store-fees.html b/Tenant-Admin-UI-Prototype/pages/store-fees.html similarity index 100% rename from pages/store-fees.html rename to Tenant-Admin-UI-Prototype/pages/store-fees.html diff --git a/pages/store-hours.html b/Tenant-Admin-UI-Prototype/pages/store-hours.html similarity index 100% rename from pages/store-hours.html rename to Tenant-Admin-UI-Prototype/pages/store-hours.html diff --git a/pages/store-list.html b/Tenant-Admin-UI-Prototype/pages/store-list.html similarity index 100% rename from pages/store-list.html rename to Tenant-Admin-UI-Prototype/pages/store-list.html diff --git a/pages/store-pickup.html b/Tenant-Admin-UI-Prototype/pages/store-pickup.html similarity index 100% rename from pages/store-pickup.html rename to Tenant-Admin-UI-Prototype/pages/store-pickup.html diff --git a/pages/store-qualifications.html b/Tenant-Admin-UI-Prototype/pages/store-qualifications.html similarity index 100% rename from pages/store-qualifications.html rename to Tenant-Admin-UI-Prototype/pages/store-qualifications.html diff --git a/pages/store-staff.html b/Tenant-Admin-UI-Prototype/pages/store-staff.html similarity index 100% rename from pages/store-staff.html rename to Tenant-Admin-UI-Prototype/pages/store-staff.html diff --git a/pages/sys-basic.html b/Tenant-Admin-UI-Prototype/pages/sys-basic.html similarity index 100% rename from pages/sys-basic.html rename to Tenant-Admin-UI-Prototype/pages/sys-basic.html diff --git a/pages/sys-billing.html b/Tenant-Admin-UI-Prototype/pages/sys-billing.html similarity index 100% rename from pages/sys-billing.html rename to Tenant-Admin-UI-Prototype/pages/sys-billing.html diff --git a/pages/sys-logs.html b/Tenant-Admin-UI-Prototype/pages/sys-logs.html similarity index 100% rename from pages/sys-logs.html rename to Tenant-Admin-UI-Prototype/pages/sys-logs.html diff --git a/pages/sys-notify.html b/Tenant-Admin-UI-Prototype/pages/sys-notify.html similarity index 100% rename from pages/sys-notify.html rename to Tenant-Admin-UI-Prototype/pages/sys-notify.html diff --git a/pages/sys-payment.html b/Tenant-Admin-UI-Prototype/pages/sys-payment.html similarity index 100% rename from pages/sys-payment.html rename to Tenant-Admin-UI-Prototype/pages/sys-payment.html diff --git a/pages/sys-plan.html b/Tenant-Admin-UI-Prototype/pages/sys-plan.html similarity index 100% rename from pages/sys-plan.html rename to Tenant-Admin-UI-Prototype/pages/sys-plan.html diff --git a/pages/sys-printer.html b/Tenant-Admin-UI-Prototype/pages/sys-printer.html similarity index 100% rename from pages/sys-printer.html rename to Tenant-Admin-UI-Prototype/pages/sys-printer.html diff --git a/pages/sys-roles.html b/Tenant-Admin-UI-Prototype/pages/sys-roles.html similarity index 100% rename from pages/sys-roles.html rename to Tenant-Admin-UI-Prototype/pages/sys-roles.html diff --git a/pages/sys-subaccount.html b/Tenant-Admin-UI-Prototype/pages/sys-subaccount.html similarity index 100% rename from pages/sys-subaccount.html rename to Tenant-Admin-UI-Prototype/pages/sys-subaccount.html diff --git a/pages/sys-upgrade.html b/Tenant-Admin-UI-Prototype/pages/sys-upgrade.html similarity index 100% rename from pages/sys-upgrade.html rename to Tenant-Admin-UI-Prototype/pages/sys-upgrade.html