第三次版本迭代更新
This commit is contained in:
andy
60
H5页面规划.md
60
H5页面规划.md
@@ -1,4 +1,4 @@
|
||||
# 酒店员工端 H5 页面规划
|
||||
# 员工端 H5 页面规划
|
||||
|
||||
## 产品定位
|
||||
|
||||
@@ -52,9 +52,9 @@
|
||||
|---|---|---|
|
||||
| 工作台 | `/home` | 展示关键数据和快捷入口 |
|
||||
| 订单 | `/orders` | 查询订单、进入详情 |
|
||||
| 核销 | `/verify` | 扫码或输入订单号核销 |
|
||||
| 核销 | `/verify` | 手机摄像头扫码核销 |
|
||||
| 事件 | `/events` | 查看事件列表 |
|
||||
| 我的 | `/mine` | 当前账号、接口模式、退出登录 |
|
||||
| 我的 | `/mine` | 当前账号、登录状态、退出登录 |
|
||||
|
||||
## 核心流程
|
||||
|
||||
@@ -66,6 +66,7 @@
|
||||
-> 输入验证码
|
||||
-> 调用 OAuth2 手机号登录
|
||||
-> 保存 access_token
|
||||
-> 调用组织关系接口
|
||||
-> 进入工作台
|
||||
```
|
||||
|
||||
@@ -96,11 +97,12 @@
|
||||
-> 核销结果
|
||||
```
|
||||
|
||||
也支持：
|
||||
扫码入口支持：
|
||||
|
||||
```text
|
||||
核销入口
|
||||
-> 输入订单号
|
||||
-> 点击进行扫码
|
||||
-> 解析二维码内容
|
||||
-> 查询订单详情
|
||||
-> 核销确认
|
||||
-> 核销结果
|
||||
@@ -114,7 +116,9 @@
|
||||
| 订单详情 | `POST /hotelStaff/order/userOrderDetail` |
|
||||
| 确认核销 | `POST /hotelStaff/order/writeOff` |
|
||||
|
||||
当前后端核销能力以 `orderId` 为核心，暂未看到独立“核销码查询”接口。第一版扫码可先约定二维码内容为订单号；如果业务需要独立券码，后端建议补充“按核销码查询订单/商品”的接口。
|
||||
当前二维码内容规则是 `orderId&packageName`，其中 `packageName` 是套餐名称。前端也兼容只有 `orderId` 的二维码内容。
|
||||
|
||||
扫码内容带 `packageName` 时，核销确认页只能核销该套餐商品；扫码内容只有 `orderId` 时，核销确认页按订单详情展示可选套餐。
|
||||
|
||||
### 事件流程
|
||||
|
||||
@@ -164,7 +168,7 @@
|
||||
- 当前日期
|
||||
- 当前账号
|
||||
- 待使用订单数
|
||||
- 今日核销数
|
||||
- 待确认订单数
|
||||
- 生效事件数
|
||||
- 今日订单数
|
||||
- 快捷入口：扫码核销、订单列表、发布事件、事件列表
|
||||
@@ -184,9 +188,8 @@
|
||||
|
||||
展示内容：
|
||||
|
||||
- 搜索框：订单号/手机号
|
||||
- 搜索框：手机号
|
||||
- 状态筛选：全部、待使用、待确认、退款中、已完成
|
||||
- 商品类型筛选：全部、酒店、门票、餐饮
|
||||
- 订单卡片：订单号、状态、商品名、联系人、手机号、金额、数量、时间
|
||||
|
||||
主要操作：
|
||||
@@ -228,18 +231,18 @@
|
||||
|
||||
展示内容：
|
||||
|
||||
- 扫码核销入口
|
||||
- 手动输入订单号
|
||||
- 点击进行扫码
|
||||
|
||||
主要操作：
|
||||
|
||||
- 输入订单号查询订单
|
||||
- 调起手机摄像头扫码
|
||||
- 解析 `orderId&packageName` 或 `orderId`
|
||||
- 进入核销确认
|
||||
|
||||
备注：
|
||||
|
||||
- 当前扫码入口已预留。
|
||||
- 第一版先按订单号核销。
|
||||
- 当前不提供手动输入订单号兜底。
|
||||
- 摄像头扫码要求浏览器支持摄像头能力，生产环境建议使用 HTTPS。
|
||||
|
||||
### `/verify/confirm` 核销确认
|
||||
|
||||
@@ -252,7 +255,9 @@
|
||||
- 商品名称
|
||||
- 联系人
|
||||
- 核销套餐
|
||||
- 购买数量
|
||||
- 可核销商品数
|
||||
- 已核销商品数
|
||||
- 总数量
|
||||
- 预约时间
|
||||
- 实付金额
|
||||
|
||||
@@ -261,9 +266,17 @@
|
||||
- 确认核销
|
||||
- 取消返回
|
||||
|
||||
规则：
|
||||
|
||||
- 从扫码入口进入且二维码带套餐名称时，只展示当前扫码套餐，不允许切换其他套餐。
|
||||
- 核销确认页优先使用后端套餐配置里的 `count`、`writeOffCount`、`packageStatus` 计算数量。
|
||||
- 当可核销商品数为 `0` 时，确认核销按钮不可点击，并提示当前套餐商品已核销完。
|
||||
- 调用核销接口后，必须检查 `/hotelStaff/order/writeOff` 返回的 `Boolean`；返回 `false` 时按核销失败处理。
|
||||
|
||||
状态：
|
||||
|
||||
- 可核销
|
||||
- 套餐已核销完
|
||||
- 当前订单不可核销
|
||||
- 核销提交中
|
||||
- 核销失败
|
||||
@@ -291,14 +304,12 @@
|
||||
|
||||
展示内容：
|
||||
|
||||
- 搜索框：实体名称
|
||||
- 状态筛选：全部、开启、关闭
|
||||
- 事件卡片：实体名称、事件描述、事件状态、显示状态、生效时间、发布人、是否弹窗提醒
|
||||
- 搜索框：事件标题
|
||||
- 事件卡片：事件标题、事件描述、显示状态、生效时间、发布人、是否弹窗提醒
|
||||
|
||||
主要操作：
|
||||
|
||||
- 搜索事件
|
||||
- 筛选状态
|
||||
- 进入发布事件页
|
||||
|
||||
### `/events/create` 发布事件
|
||||
@@ -307,7 +318,7 @@
|
||||
|
||||
展示内容：
|
||||
|
||||
- 实体名称
|
||||
- 事件标题
|
||||
- 事件描述
|
||||
- 图片上传
|
||||
- 发布时间
|
||||
@@ -322,13 +333,13 @@
|
||||
|
||||
校验：
|
||||
|
||||
- 实体名称必填
|
||||
- 事件标题必填
|
||||
- 事件描述必填
|
||||
- 生效时间必填
|
||||
|
||||
### `/mine` 我的
|
||||
|
||||
目标：查看当前登录和接口配置状态。
|
||||
目标：查看当前登录状态。
|
||||
|
||||
展示内容：
|
||||
|
||||
@@ -336,10 +347,6 @@
|
||||
- 登录状态
|
||||
- 手机号绑定状态
|
||||
- 租户
|
||||
- 接口模式：Mock/真实接口
|
||||
- `clientId`
|
||||
- `clientConfigId`
|
||||
- 员工端接口前缀
|
||||
|
||||
主要操作：
|
||||
|
||||
@@ -397,7 +404,6 @@
|
||||
暂缓内容：
|
||||
|
||||
- 独立核销码查询
|
||||
- 扫码真实调用微信/浏览器能力
|
||||
- 订单复杂高级筛选
|
||||
- 事件编辑/关闭/删除
|
||||
- 员工权限细分
|
||||
|
||||
Reference in New Issue
Block a user