208 lines
4.1 KiB
Markdown
208 lines
4.1 KiB
Markdown
# 代理首页佣金展示 Spec
|
||
|
||
## 1. 背景
|
||
|
||
代理首页当前已经会请求 `getFundSummary()`，但佣金区域使用了 `v-if="isAgent && commissionSummary"`。
|
||
|
||
这会带来两个问题：
|
||
|
||
- 只要 `commissionSummary` 为空，首页代理佣金模块就整块不显示
|
||
- 首页顶部还保留了“佣金概览”标题文案，这个文案本次不再需要
|
||
|
||
本次需求明确为：
|
||
|
||
- 首页里去掉“佣金概览”这个标题文案
|
||
- 只要当前账号是代理账号，就显示首页代理佣金区域
|
||
- 不管接口有没有值，模块都要显示
|
||
|
||
---
|
||
|
||
## 2. 目标
|
||
|
||
- 首页代理佣金区域的外层显示条件改为仅判断 `isAgent`
|
||
- 首页不再展示“佣金概览”标题
|
||
- 当佣金概览数据未返回、为空或请求失败时，佣金卡片仍然保留，金额位置显示占位内容
|
||
|
||
---
|
||
|
||
## 3. 范围
|
||
|
||
### 页面
|
||
|
||
- `src/pages/agent-system/home/index.vue`
|
||
|
||
### 用户
|
||
|
||
- 代理账号显示：`user_type === 3`
|
||
- 企业账号不显示：`user_type === 4`
|
||
|
||
---
|
||
|
||
## 4. 数据来源与约束
|
||
|
||
### 数据来源
|
||
|
||
- 接口：`GET /api/admin/shops/fund-summary`
|
||
- 方法：`getFundSummary()`
|
||
- 现有状态：`commissionSummary`
|
||
|
||
### 关键字段
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `available_commission` | number | 可提现佣金，单位分 |
|
||
| `total_commission` | number | 累计佣金，单位分 |
|
||
| `withdrawn_commission` | number | 已提现佣金，单位分 |
|
||
| `frozen_commission` | number | 冻结佣金，单位分 |
|
||
|
||
### 约束
|
||
|
||
1. 首页不得新增新的佣金概览接口请求
|
||
2. 首页直接复用现有 `commissionSummary`
|
||
3. 本次不改后端接口、不改接口字段
|
||
|
||
---
|
||
|
||
## 5. 展示规则
|
||
|
||
### 5.1 外层显示条件
|
||
|
||
首页代理佣金区域显示条件改为：
|
||
|
||
- `isAgent === true`
|
||
|
||
不再要求：
|
||
|
||
- `commissionSummary` 必须有值
|
||
|
||
### 5.2 标题文案
|
||
|
||
首页移除“佣金概览”标题文案，包括：
|
||
|
||
- 不再在卡片上方展示“佣金概览”
|
||
- 保留卡片内部的“可提现佣金”主标题
|
||
|
||
### 5.3 金额展示
|
||
|
||
佣金卡片继续展示以下内容：
|
||
|
||
- `可提现佣金`
|
||
- `累计佣金`
|
||
- `已提现`
|
||
- `冻结`
|
||
|
||
展示规则：
|
||
|
||
- 有值时，按现有金额格式化规则显示
|
||
- 无值时，显示 `--`
|
||
- 不允许因为空值显示错误金额
|
||
|
||
### 5.4 今日佣金区域
|
||
|
||
“今日佣金”区域继续跟随代理佣金模块一起显示。
|
||
|
||
展示规则保持现状：
|
||
|
||
- 日期无值显示 `--`
|
||
- 佣金金额无值显示 `¥0.00`
|
||
- 订单笔数无值显示 `0`
|
||
- 无当日数据时显示“今日暂无佣金数据”
|
||
|
||
---
|
||
|
||
## 6. 交互与状态
|
||
|
||
### 6.1 跳转
|
||
|
||
点击佣金卡片后跳转到：
|
||
|
||
- `/pages/agent-system/commission-center/index`
|
||
|
||
### 6.2 加载态
|
||
|
||
当 `commissionSummary` 还未返回时：
|
||
|
||
- 佣金卡片仍然显示
|
||
- 金额区域显示 `--`
|
||
|
||
### 6.3 异常态
|
||
|
||
当 `getFundSummary()` 请求失败时：
|
||
|
||
- 佣金卡片仍然显示
|
||
- 金额区域显示 `--`
|
||
- 不影响首页其他模块渲染
|
||
|
||
---
|
||
|
||
## 7. 非目标
|
||
|
||
- 不修改佣金中心页面结构
|
||
- 不修改提现管理页面结构
|
||
- 不新增首页专用佣金接口
|
||
- 不修改企业账号首页展示逻辑
|
||
|
||
---
|
||
|
||
## 8. 验收标准
|
||
|
||
### 用例 1：代理账号且接口有值
|
||
|
||
前置条件：
|
||
|
||
- `user_type === 3`
|
||
- `commissionSummary.available_commission = 85000`
|
||
|
||
期望：
|
||
|
||
- 首页显示代理佣金卡片
|
||
- 首页不显示“佣金概览”标题
|
||
- 主金额显示 `¥850.00`
|
||
|
||
### 用例 2：代理账号但接口无值
|
||
|
||
前置条件：
|
||
|
||
- `user_type === 3`
|
||
- `commissionSummary = null`
|
||
|
||
期望：
|
||
|
||
- 首页仍显示代理佣金卡片
|
||
- `可提现佣金 / 累计佣金 / 已提现 / 冻结` 均显示 `--`
|
||
- 今日佣金区域仍显示
|
||
|
||
### 用例 3：代理账号且接口失败
|
||
|
||
前置条件：
|
||
|
||
- `user_type === 3`
|
||
- `getFundSummary()` 请求失败
|
||
|
||
期望：
|
||
|
||
- 首页仍显示代理佣金卡片
|
||
- 金额不显示错误数据
|
||
- 页面其他内容正常渲染
|
||
|
||
### 用例 4：企业账号
|
||
|
||
前置条件：
|
||
|
||
- `user_type === 4`
|
||
|
||
期望：
|
||
|
||
- 首页不显示代理佣金区域
|
||
|
||
### 用例 5：不重复请求
|
||
|
||
前置条件：
|
||
|
||
- 首页已执行 `getFundSummary()`
|
||
|
||
期望：
|
||
|
||
- 不因本次需求新增第二次佣金接口请求
|
||
- 页面继续复用 `commissionSummary`
|