fetch(add): 账户管理
This commit is contained in:
sexygoat
@@ -1,9 +1,11 @@
|
||||
# Change: 客户账户管理功能
|
||||
|
||||
## Why
|
||||
|
||||
运营平台需要统一查看和管理所有客户（包括代理商和企业客户）的账户佣金情况，包括佣金总额、可提现金额、待入账金额、已提现金额等财务数据。目前系统缺少集中的客户账户财务视图，运营人员无法高效地了解客户的佣金和提现状况。
|
||||
|
||||
## What Changes
|
||||
|
||||
- 新增客户账户管理页面（`src/views/finance/customer-account/index.vue`）
|
||||
- 提供客户账户列表查询功能，支持按客户账号、客户名称、客户类型筛选
|
||||
- 展示客户的佣金相关财务数据：
|
||||
@@ -19,6 +21,7 @@
|
||||
- 添加路由配置（财务模块下）
|
||||
|
||||
## Impact
|
||||
|
||||
- 新增规范：`specs/customer-account-management/spec.md`
|
||||
- 新增文件：
|
||||
- `src/views/finance/customer-account/index.vue`
|
||||
|
||||
@@ -3,9 +3,11 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 客户账户列表查询
|
||||
|
||||
系统 SHALL 提供客户账户列表查询功能，运营人员可以查看所有客户的账户财务信息。
|
||||
|
||||
#### Scenario: 查询所有客户账户
|
||||
|
||||
- **WHEN** 运营人员访问客户账户管理页面
|
||||
- **THEN** 系统显示所有客户账户列表，包含以下字段：
|
||||
- 客户账号
|
||||
@@ -19,48 +21,60 @@
|
||||
- 最后提现时间
|
||||
|
||||
#### 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** 系统弹出详情对话框，展示以下信息：
|
||||
- 客户账号
|
||||
@@ -77,68 +91,86 @@
|
||||
- 备注
|
||||
|
||||
#### 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** 系统显示"暂无数据"提示
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
# 实现任务清单
|
||||
|
||||
## 1. 前端页面实现
|
||||
|
||||
- [x] 1.1 创建客户账户管理页面组件 `src/views/finance/customer-account/index.vue`
|
||||
- [x] 1.1.1 实现搜索表单（客户账号、客户名称、客户类型）
|
||||
- [x] 1.1.2 实现数据表格展示（使用 ArtTable）
|
||||
@@ -15,6 +16,7 @@
|
||||
- [x] 1.3.2 在 `src/locales/langs/en.json` 中添加英文文案
|
||||
|
||||
## 2. API 集成（待实现）
|
||||
|
||||
- [ ] 2.1 创建 API 模块 `src/api/modules/customerAccountApi.ts`
|
||||
- [ ] 2.1.1 实现客户账户列表查询接口
|
||||
- [ ] 2.1.2 实现客户账户详情查询接口
|
||||
@@ -26,24 +28,29 @@
|
||||
- [ ] 2.3 替换页面中的模拟数据为真实 API 调用
|
||||
|
||||
## 3. 流水记录功能（待实现）
|
||||
|
||||
- [ ] 3.1 创建流水记录子页面或对话框
|
||||
- [ ] 3.2 实现流水记录列表展示
|
||||
- [ ] 3.3 实现流水记录筛选和分页
|
||||
|
||||
## 4. 权限控制（待实现）
|
||||
|
||||
- [ ] 4.1 配置页面访问权限（后台权限系统）
|
||||
- [ ] 4.2 添加按钮级权限控制（如需要）
|
||||
|
||||
## 5. 测试与优化
|
||||
|
||||
- [ ] 5.1 单元测试（工具函数、业务逻辑）
|
||||
- [ ] 5.2 集成测试（API 调用）
|
||||
- [ ] 5.3 性能优化（大数据量处理）
|
||||
- [ ] 5.4 用户体验优化（加载状态、错误处理）
|
||||
|
||||
## 6. 文档更新
|
||||
|
||||
- [x] 6.1 更新 `docs/功能.md` 功能列表
|
||||
|
||||
## 当前状态
|
||||
|
||||
- ✅ 第 1 阶段（前端页面框架）已完成，使用模拟数据
|
||||
- ⏳ 第 2 阶段（API 集成）待实现
|
||||
- ⏳ 第 3 阶段（流水记录）待实现
|
||||
|
||||
Reference in New Issue
Block a user