# 全局业务规则

## 1. 用户身份与登录

### 1.1 可匿名浏览的范围

- 首页
- 门店选择页
- 点餐页基础浏览
- 商品详情查看
- 活动会场基础浏览

### 1.2 必须登录 / 绑定手机号的动作

- 提交订单
- 使用优惠券、余额、次卡
- 查看“我的”资产
- 查看订单与售后
- 提交退款申请
- 提交评价

### 1.3 登录拦截方式

- 优先使用 `C03 登录授权弹层`
- 拦截后登录成功，应返回原业务场景继续执行

## 2. 门店与场景规则

### 2.1 场景枚举

| 值 | 名称 | 说明 |
| --- | --- | --- |
| `delivery` | 外卖配送 | 需要地址、配送范围和配送费 |
| `pickup` | 到店自提 | 需要取餐时间、取餐人信息 |
| `dine_in` | 堂食扫码 | 需要门店和桌号 |

### 2.2 门店选择规则

- 顾客必须在“某一家门店”下点单
- 同一时间购物车只属于一个门店 + 一个场景
- 场景切换必须受门店真实 `serviceTypes` 约束
- 切换门店或切换场景时，应提示当前购物车可能清空

### 2.3 堂食规则

- 堂食优先由扫码进入
- 扫码后自动识别门店与桌号
- 堂食场景默认不展示配送地址与配送费模块

## 3. 商品与价格规则

### 3.1 商品展示规则

- 商品按分类展示
- 商品与类目展示必须按当前场景过滤
- 支持热销、招牌、新品、推荐等标签
- 商品在以下情况下显示不可售：
  - 售罄
  - 下架
  - 超出供应时段
  - 当前场景不可售

### 3.2 SKU 与规格规则

- 规格做法与加料均在商品详情抽屉中完成
- 当商品启用多规格时，价格与库存以 SKU 为准
- 简单商品可直接加购
- 套餐商品必须先完成套餐组选择
- 如果规格变化导致库存不足，应立即提示

### 3.3 费用结构

结算时至少展示以下金额项：

- 商品金额
- 打包费
- 餐具费
- 配送费
- 优惠减免
- 实付金额

## 4. 优惠与资产规则

### 4.1 资产类型

| 类型 | 说明 |
| --- | --- |
| 优惠券 | 满减券、折扣券、免配送费券 |
| 积分 | 获取、兑换；是否支持订单抵扣当前不冻结 |
| 储值余额 | 充值后可支付订单 |
| 次卡 | 对特定商品或分类核销 |
| 会员等级 | 折扣、积分倍率、生日权益、会员日权益 |

### 4.2 使用原则

- 顾客手动选择的资产当前只确认：
  - 优惠券
  - 余额
  - 次卡
- 自动命中的结果当前主要包括：
  - 满减
  - 新客优惠
  - 会员折扣
  - 免配送费
- 具体叠加、互斥、优先级由后台规则决定
- 若资产不可用，必须给出原因说明

### 4.3 典型不可用原因

- 未达到金额门槛
- 不适用当前门店
- 不适用当前场景
- 不适用当前商品
- 已过期
- 已使用
- 余额不足

## 5. 订单状态规则

### 5.1 顾客视角状态分组

订单页顶层统一使用顾客任务语言：

- 全部
- 待支付
- 进行中
- 已完成
- 售后

### 5.2 顾客可感知的细分状态

- 商家处理中
- 制作中
- 配送中
- 待取餐
- 已完成
- 退款中
- 已退款
- 已取消

### 5.3 订单动作与状态对应

- `待支付`：可继续支付、取消订单
- `进行中`：以查看详情和查看履约信息为主
- `已完成`：可评价、再来一单
- `售后`：可查看退款详情
- `已取消` 等结果态：以查看信息为主

当前不把以下能力冻结为所有订单的固定动作：

- 催单
- 取餐码查看
- 骑手轨迹

## 6. 消息与服务规则

### 6.1 消息中心边界

- `P16 消息中心页` 当前保留页面职责
- 当前已知后台事实源更接近“运营发送中心”，不是顾客 inbox
- 因此下列能力暂不冻结为正式前台契约：
  - 完整消息分类
  - 未读 / 已读状态流转
  - 消息点击跳转规则
  - 消息角标数量

### 6.2 帮助中心边界

- `P17 帮助中心页` 当前作为服务兜底页保留
- FAQ 分类、帮助文章 CMS、在线客服、电话客服等动态能力当前不冻结

## 7. 页面通用状态

所有列表页和详情页都要考虑以下状态：

- 加载态
- 空态
- 错误态
- 禁用态
- 网络重试态

### 7.1 典型空态

- 无门店可选
- 当前分类无商品
- 无可见券模板
- 无历史订单
- 暂无可展示消息

### 7.2 典型错误态

- 网络异常
- 定位失败
- 支付失败
- 加载订单失败
- 退款提交失败

## 8. 通用交互约束

- 金额统一用 `¥` 展示
- 主要 CTA 按钮固定在页面底部或区块底部
- 结算相关页面必须把金额明细解释清楚
- 场景切换、门店切换、地址切换属于高风险动作，需要在必要时提示购物车清空
- 同一页面的主要操作按钮文案要稳定，不同页面不要频繁变形
- 活动页必须导流回商品、购物车、结算主链路，不单独生长成一套交易系统