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

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

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 抽屉与弹层
+- 不应中断当前页面上下文
+- 应支持手势关闭 / 点击遮罩关闭（支付与关键确认除外）
+- 关闭后保留当前页面已选状态
+

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 按钮固定在页面底部或区块底部
+- 结算相关页面必须把金额明细解释清楚
+- 场景切换、门店切换、地址切换属于高风险动作，需要在必要时提示购物车清空
+- 同一页面的主要操作按钮文案要稳定，不同页面不要频繁变形
+

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. 返回点餐页或结算页使用资产
+

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` 堂食扫码确认页
+

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. 通用实现要求
+
+- 所有卡片组件需要支持禁用态或不可点击态
+- 列表项需要支持右侧箭头、辅助文案、角标等变化
+- 底部固定操作栏需要考虑安全区
+- 金额展示组件统一格式化
+- 状态标签颜色语义在整个应用中保持一致
+

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. 实现备注
+
+- 首页优先是“导流页”，不是深度浏览页
+- 推荐商品只展示摘要，不在首页直接承载复杂选配
+

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. 实现备注
+
+- 点餐页是整套小程序最核心页面，需要优先保证信息密度和操作效率
+- 商品详情、购物车应通过抽屉承载，尽量不跳转新页面
+

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. 实现备注
+
+- 订单页重点是列表可扫读性
+- 一屏内要能快速看懂状态、门店、金额和下一步动作
+

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. 实现备注
+
+- “我的”页要兼顾资产页和服务页
+- 顶部头部卡与资产总览区需要在视觉上形成核心焦点
+

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. 实现备注
+
+- 门店列表要把“能否下单”说清楚，不仅展示名字
+

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 需要拆成“地址列表页 + 地址编辑页”，可以追加子页面，但当前文档以一个管理页为主
+

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. 实现备注
+
+- 抽屉应保留当前点餐页上下文
+- 关闭抽屉不应导致列表位置丢失
+

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. 实现备注
+
+- 购物车抽屉必须支持快速修改数量
+- 去结算按钮应只保留一个主路径，不做复杂分支
+

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. 实现备注
+
+- 结算页核心是“信息确认 + 金额确认”
+- 所有会影响实付金额的项目都必须可见
+

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
+

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. 实现备注
+
+- 订单详情页是强状态页面，顶部状态区必须足够明确
+

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. 实现备注
+
+- 页面目标是低阻力提交，不宜放过多冗余字段
+

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. 实现备注
+
+- 拒绝状态必须明确展示驳回原因
+

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. 实现备注
+
+- 评价成功后可弹出“获得积分”提示，但不应阻塞主流程
+

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. 实现备注
+
+- 领取动作应尽量轻量，领取成功后不强制跳转
+

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. 实现备注
+
+- 秒杀页要突出时间紧迫感和库存稀缺感
+

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. 实现备注
+
+- 与秒杀页相比，限时折扣页要弱化“抢”，强化“省”
+

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. 实现备注
+
+- 会员中心要重点突出“当前能享受什么”和“如何升级”
+

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. 实现备注
+
+- 积分商城强调“积分能干什么”，不要只展示数值
+

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. 实现备注
+
+- 充值金额、赠送金额、到账金额三者必须同时可见
+

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. 实现备注
+
+- 次卡页需要把“适用什么商品”和“还剩几次”表达清楚
+

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. 实现备注
+
+- 消息要支持按读写状态区分，但不需要复杂会话系统
+

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. 实现备注
+
+- 帮助中心主要作为兜底服务页，不需要复杂交互
+

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. 实现备注
+
+- 该页要尽量减少用户输入，优先自动确认门店和桌号
+

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` 负责定义“研发实施时先做什么、交付什么”

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. 如果某个后台能力当前没有对应的顾客价值，就先作为支撑能力，不强行做前台页面

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 端小程序的关系才会清晰，整个项目也不会越做越散。