177 lines
5.0 KiB
Markdown
177 lines
5.0 KiB
Markdown
# 客户账户管理规范
|
||
|
||
## ADDED Requirements
|
||
|
||
### Requirement: 客户账户列表查询
|
||
|
||
系统 SHALL 提供客户账户列表查询功能，运营人员可以查看所有客户的账户财务信息。
|
||
|
||
#### Scenario: 查询所有客户账户
|
||
|
||
- **WHEN** 运营人员访问客户账户管理页面
|
||
- **THEN** 系统显示所有客户账户列表，包含以下字段：
|
||
- 客户账号
|
||
- 客户名称
|
||
- 客户类型（代理商/企业客户）
|
||
- 佣金总额
|
||
- 可提现金额
|
||
- 待入账金额
|
||
- 已提现金额
|
||
- 提现次数
|
||
- 最后提现时间
|
||
|
||
#### Scenario: 按客户账号搜索
|
||
|
||
- **WHEN** 运营人员在搜索框输入客户账号并点击查询
|
||
- **THEN** 系统返回匹配该账号的客户记录
|
||
|
||
#### Scenario: 按客户名称搜索
|
||
|
||
- **WHEN** 运营人员在搜索框输入客户名称并点击查询
|
||
- **THEN** 系统返回名称包含该关键词的客户记录
|
||
|
||
#### Scenario: 按客户类型筛选
|
||
|
||
- **WHEN** 运营人员选择客户类型（代理商或企业客户）并点击查询
|
||
- **THEN** 系统返回该类型的所有客户记录
|
||
|
||
#### Scenario: 组合条件搜索
|
||
|
||
- **WHEN** 运营人员同时使用多个搜索条件（如账号 + 类型）并点击查询
|
||
- **THEN** 系统返回同时满足所有条件的客户记录
|
||
|
||
#### Scenario: 重置搜索条件
|
||
|
||
- **WHEN** 运营人员点击重置按钮
|
||
- **THEN** 系统清空所有搜索条件并显示完整列表
|
||
|
||
### Requirement: 分页功能
|
||
|
||
系统 SHALL 支持客户账户列表的分页展示，以提高大数据量下的性能和用户体验。
|
||
|
||
#### Scenario: 默认分页显示
|
||
|
||
- **WHEN** 运营人员首次访问页面
|
||
- **THEN** 系统默认显示第 1 页，每页 20 条记录
|
||
|
||
#### Scenario: 切换页码
|
||
|
||
- **WHEN** 运营人员点击分页器的页码
|
||
- **THEN** 系统跳转到对应页面并加载数据
|
||
|
||
#### Scenario: 调整每页显示数量
|
||
|
||
- **WHEN** 运营人员选择不同的每页显示数量（10/20/50/100）
|
||
- **THEN** 系统重新加载数据并按新的数量显示
|
||
|
||
#### Scenario: 显示总记录数
|
||
|
||
- **WHEN** 数据加载完成后
|
||
- **THEN** 分页器显示总记录数
|
||
|
||
### Requirement: 客户账户详情查看
|
||
|
||
系统 SHALL 提供客户账户详情查看功能，展示客户的完整财务信息。
|
||
|
||
#### Scenario: 打开详情对话框
|
||
|
||
- **WHEN** 运营人员点击某个客户的"查看详情"按钮
|
||
- **THEN** 系统弹出详情对话框，展示以下信息：
|
||
- 客户账号
|
||
- 客户名称
|
||
- 客户类型
|
||
- 联系电话
|
||
- 佣金总额
|
||
- 可提现金额
|
||
- 待入账金额
|
||
- 已提现金额
|
||
- 提现次数
|
||
- 最后提现时间
|
||
- 注册时间
|
||
- 备注
|
||
|
||
#### Scenario: 关闭详情对话框
|
||
|
||
- **WHEN** 运营人员点击对话框关闭按钮或遮罩层
|
||
- **THEN** 系统关闭详情对话框
|
||
|
||
### Requirement: 客户流水记录入口
|
||
|
||
系统 SHALL 提供客户流水记录查看入口，方便运营人员查看客户的佣金流水明细。
|
||
|
||
#### Scenario: 触发流水记录查看
|
||
|
||
- **WHEN** 运营人员点击某个客户的"流水记录"按钮
|
||
- **THEN** 系统导航到该客户的流水记录页面或打开流水记录对话框
|
||
|
||
### Requirement: 数据展示样式
|
||
|
||
系统 SHALL 使用不同的视觉样式区分不同类型的数据，提升可读性。
|
||
|
||
#### Scenario: 客户类型标签样式
|
||
|
||
- **WHEN** 列表或详情中显示客户类型
|
||
- **THEN** 代理商显示为绿色标签，企业客户显示为蓝色标签
|
||
|
||
#### Scenario: 金额颜色区分
|
||
|
||
- **WHEN** 列表或详情中显示金额数据
|
||
- **THEN** 可提现金额使用绿色高亮，待入账金额使用橙色高亮
|
||
|
||
#### Scenario: 金额格式化
|
||
|
||
- **WHEN** 系统显示金额数据
|
||
- **THEN** 金额显示为货币格式，保留两位小数，前缀人民币符号"¥"
|
||
|
||
### Requirement: 国际化支持
|
||
|
||
系统 SHALL 支持中英文双语界面，所有文案通过国际化文件管理。
|
||
|
||
#### Scenario: 中文界面显示
|
||
|
||
- **WHEN** 系统语言设置为中文
|
||
- **THEN** 所有界面文案显示为中文
|
||
|
||
#### Scenario: 英文界面显示
|
||
|
||
- **WHEN** 系统语言设置为英文
|
||
- **THEN** 所有界面文案显示为英文
|
||
|
||
### Requirement: 数据权限控制
|
||
|
||
系统 SHALL 根据运营人员的权限角色，控制其可见的客户账户范围。
|
||
|
||
#### Scenario: 管理员权限
|
||
|
||
- **WHEN** 管理员访问客户账户页面
|
||
- **THEN** 系统显示所有客户账户
|
||
|
||
#### Scenario: 普通运营人员权限
|
||
|
||
- **WHEN** 普通运营人员访问客户账户页面
|
||
- **THEN** 系统仅显示其权限范围内的客户账户
|
||
|
||
### Requirement: 异常处理与用户反馈
|
||
|
||
系统 SHALL 在操作过程中提供清晰的用户反馈和错误处理。
|
||
|
||
#### Scenario: 查询成功反馈
|
||
|
||
- **WHEN** 用户执行搜索操作且成功返回结果
|
||
- **THEN** 系统显示成功消息提示
|
||
|
||
#### Scenario: 查询失败处理
|
||
|
||
- **WHEN** API 请求失败或超时
|
||
- **THEN** 系统显示错误消息，并提示用户重试
|
||
|
||
#### Scenario: 数据加载状态
|
||
|
||
- **WHEN** 系统正在加载数据
|
||
- **THEN** 显示加载动画或骨架屏，防止用户误操作
|
||
|
||
#### Scenario: 空数据提示
|
||
|
||
- **WHEN** 查询结果为空
|
||
- **THEN** 系统显示"暂无数据"提示
|