# 客户账户管理规范

## 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** 系统显示"暂无数据"提示