docs: split prototype specs and add execution guides

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

View File

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