5.0 KiB
5.0 KiB
客户账户管理规范
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 系统显示"暂无数据"提示