4.1 KiB
4.1 KiB
代理首页佣金展示 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 | 冻结佣金，单位分 |
约束
- 首页不得新增新的佣金概览接口请求
- 首页直接复用现有
commissionSummary - 本次不改后端接口、不改接口字段
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 === 3commissionSummary.available_commission = 85000
期望：
- 首页显示代理佣金卡片
- 首页不显示“佣金概览”标题
- 主金额显示
¥850.00
用例 2：代理账号但接口无值
前置条件：
user_type === 3commissionSummary = null
期望：
- 首页仍显示代理佣金卡片
可提现佣金 / 累计佣金 / 已提现 / 冻结均显示--- 今日佣金区域仍显示
用例 3：代理账号且接口失败
前置条件：
user_type === 3getFundSummary()请求失败
期望：
- 首页仍显示代理佣金卡片
- 金额不显示错误数据
- 页面其他内容正常渲染
用例 4：企业账号
前置条件：
user_type === 4
期望：
- 首页不显示代理佣金区域
用例 5：不重复请求
前置条件：
- 首页已执行
getFundSummary()
期望：
- 不因本次需求新增第二次佣金接口请求
- 页面继续复用
commissionSummary