积分兑换管理模块需求文档

一、模块概述

本模块为**运维通管理平台**中的积分礼品兑换管理功能,主要涵盖以下子模块:

  • 积分兑换订单列表(汇总视图)
  • 积分礼品用户明细列表
  • 明细详情页
  • 发货操作弹窗

二、积分兑换订单列表

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位统一脱敏处理。

九、原型图

积分兑换列表

![页面 1](/Users/mitao/code/tcm-training-admin/doc/积分兑换管理模块需求文档.assets/页面 1.png)

明细列表

![页面 1](/Users/mitao/code/tcm-training-admin/doc/积分兑换管理模块需求文档.assets/页面 1-4078070.png)

明细列表详情

![页面 1](/Users/mitao/code/tcm-training-admin/doc/积分兑换管理模块需求文档.assets/页面 1-4078088.png)

发货

![页面 1](/Users/mitao/code/tcm-training-admin/doc/积分兑换管理模块需求文档.assets/页面 1-4078111.png)

积分收支明细

![页面 1](/Users/mitao/code/tcm-training-admin/doc/积分兑换管理模块需求文档.assets/页面 1-4084470.png)