# 积分兑换管理模块需求文档
## 一、模块概述
本模块为**运维通管理平台**中的积分礼品兑换管理功能，主要涵盖以下子模块：
- 积分兑换订单列表（汇总视图）
- 积分礼品用户明细列表
- 明细详情页
- 发货操作弹窗
---
## 二、积分兑换订单列表
### 2.1 页面说明
展示每期积分活动结束后，系统自动生成的兑换订单汇总记录。订单以**诊所为单位**聚合生成，即每期活动结束后，系统自动将满足条件的用户按诊所维度汇总为一条订单记录。
### 2.2 搜索筛选条件
| **字段名** | **控件类型** | **说明** |
| --- | --- | --- |
| 兑换礼品 | 文本输入框 | 按礼品名称模糊搜索 |
| 收件人电话 | 文本输入框 | 按收件人手机号搜索 |
| 订单状态 | 下拉选择框 | 可选：待发货 / 已发货（以实际状态枚举为准） |
| 下单时间 | 日期范围选择器 | 选择开始时间 ~ 结束时间 |
操作按钮：**重置**（清空所有筛选条件）、**搜索**（触发查询）
### 2.3 列表字段
| **序号** | **字段名** | **说明** | **备注** |
| --- | --- | --- | --- |
| 1 | 序号 | 列表行序号，从1开始 | — |
| 2 | 礼品名称 | 用户兑换的礼品名称 | 示例：XXX礼品 |
| 3 | 活动日期范围 | 本期积分活动的有效时间段 | 格式：YYYY-MM-DD 至 YYYY-MM-DD |
| 4 | 当前积分值 | 该订单对应的积分数量（高亮显示） | 订单为每期积分活动结束后，系统自动将满足条件的用户以诊所为单位汇总生成；积分值用橙色高亮展示 |
| 5 | 收件诊所 | 收货方所属诊所名称 | — |
| 6 | 收件人电话 | 收货联系人手机号 | 中间4位脱敏，示例：1476905 |
| 7 | 收货地址 | 收货详细地址 | — |
| 8 | 发货数量 | 本次订单发货礼品数量 | — |
| 9 | 订单生成时间 | 订单创建的时间戳 | 格式：YYYY-MM-DD HH:mm |
| 10 | 状态 | 当前订单物流/发货状态 | 枚举值：待发货（橙色）/ 已发货（蓝色） |
| 11 | 操作 | 对应行可执行的操作入口 | 待发货状态显示：发货、详情、删除；已发货状态显示：详情、删除 |
### 2.4 列表操作
- **发货**：仅在订单状态为「待发货」时显示，点击后弹出发货弹窗（见第五节）
- **详情**：跳转至明细列表详情页
- **删除**：删除当前订单记录（需二次确认，防止误删）
- **导出列表**：将当前筛选结果导出为文件（Excel/CSV）
### 2.5 分页
- 共 800 条，每页 10 条，支持页码跳转
---
## 三、积分礼品用户明细列表
### 3.1 页面说明
展示某一兑换订单下的用户级明细记录，点击汇总列表中「详情」进入。
### 3.2 搜索筛选条件
| **字段名** | **控件类型** | **说明** |
| --- | --- | --- |
| 订单编号 | 文本输入框 | 按订单编号精确或模糊搜索 |
| 下单人电话 | 文本输入框 | 按下单用户手机号搜索 |
| 兑换礼品 | 文本输入框 | 按礼品名称模糊搜索 |
| 收件人电话 | 文本输入框 | 按收件人手机号搜索 |
| 订单状态 | 下拉选择框 | 可选：待发货 / 已取消 / 兑换完成（以实际枚举为准） |
| 创建时间 | 日期范围选择器 | 选择开始时间 ~ 结束时间 |
操作按钮：**重置**、**搜索**
### 3.3 列表字段
| **序号** | **字段名** | **说明** | **备注** |
| --- | --- | --- | --- |
| 1 | 订单编号 | 用户明细订单的唯一编号 | 示例：1651615661 |
| 2 | 下单人 | 发起兑换的用户姓名 | 示例：王美丽 |
| 3 | 电话 | 下单人手机号 | 中间4位脱敏，示例：1476905 |
| 4 | 礼品名称 | 兑换的礼品名称 | 示例：XXX礼品 |
| 5 | 积分 | 本次兑换消耗的积分数值 | 橙色高亮展示 |
| 6 | 收件人 | 收货人姓名或诊所名称 | 示例：AA诊所 |
| 7 | 收件人电话 | 收件人手机号 | 中间4位脱敏 |
| 8 | 收货地址 | 收货详细地址 | — |
| 9 | 创建时间 | 明细订单的创建时间 | 格式：YYYY-MM-DD HH:mm |
| 10 | 状态 | 明细订单当前状态 | 枚举值：待发货（橙色）/ 兑换完成（蓝色）/ 已取消（灰色，待确认） |
| 11 | 操作 | 可执行的操作入口 | 待发货状态显示：发货、详情、删除；其他状态显示：详情、删除 |
### 3.4 列表操作
- **发货**：仅待发货状态显示，点击弹出发货弹窗
- **详情**：跳转至明细详情页
- **删除**：删除当前明细记录
- **导出**：导出当前筛选结果
### 3.5 分页
- 共 800 条，每页 10 条，支持页码跳转
---
## 四、明细详情页
### 4.1 页面说明
展示单条明细订单的完整信息，包含收件人信息、订单信息、买家信息及兑换物品信息。页面顶部显示当前订单状态（如：待发货），并提供对应操作按钮。
### 4.2 页面顶部
- **页面标题**：显示当前订单状态，如「待发货」
- **编号**：显示订单编号，如 `SQHHHHHH`
- **操作按钮**：
- **删除**：仅在订单状态为「**已取消**」时显示
- **发货**：仅在订单状态为「**待发货**」时显示
### 4.3 收件人信息
| **字段名** | **说明** | **示例** |
| --- | --- | --- |
| 收件人 | 收货人姓名 | 张三 |
| 联系电话 | 收件人手机号（明文展示） | 14725836901 |
| 收件地址 | 详细收货地址 | XXXXXXXXXXXXXXXX |
### 4.4 订单信息
| **字段名** | **说明** | **示例** |
| --- | --- | --- |
| 订单编号 | 完整订单号，附「复制」按钮 | 20200330161908045 20 |
| 兑换时间 | 用户提交兑换请求的时间 | 2019-09-09 10:40 |
| 积分 | 本次兑换消耗积分（橙色高亮） | 625 |
| 发货时间 | 实际发货时间 | 2019-09-09 10:40 |
| 物流单号 | 快递物流跟踪单号，附「复制」按钮 | XXXXX |
| 收货时间 | 用户确认收货时间 | 2019-09-09 10:40 |
### 4.5 买家信息
| **字段名** | **说明** | **示例** |
| --- | --- | --- |
| 用户姓名 | 下单用户真实姓名 | 曲丽丽 |
| 手机号码 | 下单用户手机号 | 18890900900 |
| 用户ID | 系统内用户唯一标识 | 18890900900 |
| 注册时间 | 用户账号注册时间 | 2019-09-09 10:40 |
### 4.6 物品信息
| **字段名** | **说明** | **示例** |
| --- | --- | --- |
| 物品图片 | 礼品缩略图 | — |
| 物品名称 | 礼品名称（超链接，可点击查看详情） | 西班牙语0-B2高级直达 |
| 所需积分 | 兑换该礼品所需积分（橙色高亮） | 300 积分 |
---
## 五、发货弹窗
### 5.1 触发条件
在以下位置点击「发货」按钮触发弹窗：
- 积分兑换订单列表 → 操作列「发货」
- 积分礼品用户明细列表 → 操作列「发货」
- 明细详情页 → 顶部「发货」按钮
### 5.2 弹窗字段
| **字段名** | **是否必填** | **控件类型** | **校验规则** |
| --- | --- | --- | --- |
| 输入物流单号 | 必填（标红星） | 文本输入框 | 长度限制：5个字以内（原型提示：请输入5个字以内） |
### 5.3 弹窗操作
- **取消**：关闭弹窗，不执行任何操作
- **确定**：提交物流单号，完成发货操作；订单状态由「待发货」变更为「已发货」
### 5.4 交互逻辑
1. 物流单号为必填项，未填写时点击「确定」应给出错误提示
2. 提交成功后刷新当前列表，对应订单状态更新为「已发货」
3. 发货后「发货」按钮隐藏，不可再次发货
---
## 六、状态枚举说明
| **状态值** | **显示颜色** | **说明** | **可用操作** |
| --- | --- | --- | --- |
| 待发货 | 橙色 | 订单已生成，尚未发货 | 发货、详情 |
| 已发货 | 蓝色 | 已填写物流单号并确认发货 | 详情、删除 |
| 兑换完成 | 蓝色 | 用户已确认收货，兑换流程结束 | 详情、删除 |
| 已取消 | 灰色（待确认） | 订单已取消 | 删除 |
---
## 七、业务规则汇总
1. **订单生成规则**：每期积分活动结束后，系统自动将满足积分兑换条件的用户，以**诊所为单位**汇总生成兑换订单，无需人工干预。
2. **积分显示**：积分数值在列表及详情页中统一使用**橙色**高亮展示，以便管理员快速识别。
3. **手机号脱敏**：列表中手机号中间4位统一脱敏处理（如 `147****6905`）；详情页买家信息区域展示明文。
4. **发货操作**：发货时必须填写物流单号（限5字以内），发货成功后订单状态自动流转至「已发货」。
5. **删除操作**：仅「已取消」状态的订单允许删除，其他状态不允许删除（详情页按钮根据状态动态显示）。
6. **订单号/物流单号复制**：详情页中订单编号和物流单号旁提供「复制」快捷按钮，方便操作。
7. **列表分页**：默认每页展示10条，支持切换每页条数和页码跳转。
## 八、积分收支明细
### 8.1 页面说明
展示某一用户或全体用户的积分收入与支出明细记录，管理员可通过多维度筛选查看积分流水，并支持汇总统计与数据导出。
### 8.2 搜索筛选条件
| **字段名** | **控件类型** | **说明** |
| ------------- | -------------- | ------------------------------------------------ |
| 用户电话 | 文本输入框 | 按用户手机号搜索 |
| 诊所地址 | 下拉选择框 | 按诊所所在地区筛选，如：四川省成都市金牛区 |
| 诊所名称 | 文本输入框 | 按关联诊所名称模糊搜索 |
| 收支类型 | 下拉选择框 | 可选：收入 / 支出 |
| 类型 | 下拉选择框 | 积分变动的业务类型，如：观看直播 / 积分兑换 等 |
| 内容 | 文本输入框 | 按积分变动关联内容名称模糊搜索，如课程名、物品名 |
| 订单/课程编号 | 文本输入框 | 按关联订单或课程编号精确/模糊搜索 |
| 操作时间 | 日期范围选择器 | 选择开始时间 ~ 结束时间 |
操作按钮：**重置**（清空所有筛选条件）、**搜索**（触发查询）
### 8.3 汇总统计栏
列表顶部展示当前筛选结果的积分汇总数据，字段如下：
| **统计项** | **说明** | **示例** |
| ---------- | ----------------------------------------- | -------- |
| 总计收入 | 筛选范围内所有收入类积分之和，以 + 号标识 | +15 |
| 总计支出 | 筛选范围内所有支出类积分之和，以 - 号标识 | -15 |
| 观看直播 | 因观看直播产生的积分收入汇总 | +15 |
| 积分兑换 | 因积分兑换产生的积分支出汇总 | -15 |
### 8.4 列表字段
| **序号** | **字段名** | **说明** | **备注** |
| -------- | ------------- | ------------------------------------ | --------------------------------------------------- |
| 1 | 下单用户 | 发生积分变动的用户姓名 | 示例：王美丽 |
| 2 | 电话 | 用户手机号 | 中间4位脱敏，示例：147****6905 |
| 3 | 关联诊所地区 | 用户所属诊所的地理区域 | 示例：四川省成都市金牛区；收入类记录可能为空（"-"） |
| 4 | 关联诊所名称 | 用户所属诊所名称 | 示例：益禾堂成都金牛店；收入类记录可能为空（"-"） |
| 5 | 收支类型 | 本条记录的积分变动方向 | 枚举值：收入 / 支出 |
| 6 | 类型 | 积分变动的业务来源类型 | 示例：观看直播（收入）、积分兑换（支出）等 |
| 7 | 内容 | 积分变动关联的具体内容名称 | 示例：直播课名称1、物品名称1 |
| 8 | 课程/订单编号 | 关联课程或订单的编号，点击可跳转详情 | 蓝色超链接，示例：165165 / 1651615661 |
| 9 | 积分 | 本次变动的积分数值 | 收入为绿色正值（+250），支出为红色负值（-250） |
| 10 | 操作时间 | 积分变动发生的时间戳 | 格式：YYYY-MM-DD HH:mm |
### 8.5 列表操作
- **导出**：将当前筛选结果导出为文件（Excel/CSV），点击页面中「导出」按钮触发
- 本列表为**只读视图**，不提供行级操作入口（无发货、删除等按钮）
### 8.6 分页
- 共 800 条，每页 10 条，支持切换每页条数和页码跳转
### 8.7 业务规则
1. **收支区分**：收支类型为「收入」时积分值以正数展示（绿色），「支出」时以负数展示（红色），便于快速区分。
2. **诊所信息为空场景**：部分收入类型记录（如观看直播）可能不关联具体诊所，关联诊所地区和名称字段显示为"-"。
3. **编号跳转**：课程/订单编号字段为蓝色超链接，点击可跳转至对应课程或订单详情页。
4. **汇总动态计算**：页面顶部统计栏（总计收入、总计支出、各类型小计）根据当前筛选条件实时计算，不反映全量数据。
5. **手机号脱敏**：列表中用户手机号中间4位统一脱敏处理。
### 九、原型图
### 积分兑换列表
### 明细列表
### 明细列表详情
### 发货
### 积分收支明细
