Files

sexygoat 222e5bb11a Initial commit: One Pipe System

完整的管理系统，包含账户管理、卡片管理、套餐管理、财务管理等功能模块。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2026-01-22 16:35:33 +08:00

5.0 KiB

Raw Blame History

客户账户管理规范

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

5.0 KiB Raw Blame History Unescape Escape