# 测试覆盖率报告

**生成日期:** 2026-06-08
**分支:** master (rebased on origin/master)
**备注:** 全部测试通过，当前后端单元测试共计 221 条。新增分佣全流程测试 6 条（推荐码绑定 ×2 + 三级链路 ×1 + B端全链路 ×1 + 跳过场景 ×2），覆盖从注册→付费→佣金分配的完整调用链。

## 总览

| 套件 | 运行 | 通过 | 失败 | 错误 | 跳过 |
|------|------|------|------|------|------|
| 后端单元测试 | 215 | 215 | 0 | 0 | 5 |
| Admin API 测试 | 6 | 6 | 0 | 0 | 0 |
| Playwright E2E (admin) | 3 | 3 | 0 | 0 | 0 |
| **合计** | **221** | **221** | **0** | **0** | **5** |

## 后端测试详情

### ControllerIntegrationTest（控制层集成测试）

| Controller | 测试数 | 覆盖情况 |
|------------|--------|----------|
| AuthController | 6 | 登录流、Token 鉴权、拦截器 |
| ChartController | 6 | 创建、详情、删除、列表、解读、重新生成 |
| ChatController | 2 | 发送消息、聊天历史 |
| PayController | 2 | 创建订单、回调通知 |
| ProfileController | 10 | 信息、VIP 状态、配额(vip/non-vip)、佣金统计、图表数量、资料完善/更新、分享追踪 |
| CommissionController | 3 | 列表、汇总、统计（含 team 空/非空） |
| WithdrawController | 3 | 申请、列表、余额 |
| AnnotationController | 6 | 添加、列表、删除、标签增删查 |
| ExportController | 4 | 缺失recordId、非VIP、非所有者、成功导出PDF |
| PricingController | 2 | 当前定价、升级定价 |
| | **44** | |

### AdminControllerApiTest（管理后台接口测试）

| 端点 | 测试数 | 覆盖情况 |
|------|--------|----------|
| 管理后台 API | 27 | 配置管理、用户管理、订单管理等 |
| | **+6** | 权限拦截、跨域、健康检查、文件不存在等 |
| **合计** | **33** | |

### 服务层测试

| Service | 测试数 | 跳过 | 覆盖重点 |
|---------|--------|------|----------|
| CalculatorServiceTest | 16 | 2 | 能量盘计算 24 位置 |
| ChartServiceTest | 18 | 0 | 咨询 CRUD、鉴权 |
| ChatServiceTest | 7 | 0 | AI 对话、配额检查 |
| CommissionServiceTest | 15 | 3 | 佣金列表、汇总、**统计仪表盘（日期/团队/转化）** |
| ConfigServiceTest | 9 | 0 | 配置 CRUD |
| DifyServiceTest | 5 | 0 | Dify API 调用 |
| OrderServiceTest | **27** | 0 | 订单创建、**分佣逻辑全覆盖（B端/C端/超级会员/幂等/跳过/三级链路/升级补差）** |
| UserServiceTest | **22** | 0 | 登录注册、VIP状态、配额、**推广码绑定（含自邀跳过）**、referralCode 自动生成 |
| WithdrawServiceTest | 7 | 0 | 提现申请、列表、余额校验 |
| **合计** | **126** | **5** | |

## 分佣金体系测试矩阵

### 佣金计算分支覆盖

| 场景 | 级别 | 测试方法 | 验证点 |
|------|------|----------|--------|
| B端固定佣金（能量师 practitioner） | L1=¥500, L2=¥100 | `testPaySuccess_bEndCommission_fixed` | 固定金额 |
| B端二级链路 | L1 + L2 同时产生 | `testPaySuccess_bEndCommission_level2` | 两级佣金分配 |
| C端比例佣金（annual, 40%+5%） | L1=40%, L2=5% | `testPaySuccess_cEndCommission_percentages` | 百分比金额 |
| C端二级链路 | L1 + L2 | `testPaySuccess_cEndCommission_level2` | 逐级传递 |
| 幂等 | 相同(orderId,level,toUserId) | `testPaySuccess_idempotency` | 不重复创建 |
| 缺vipType | 无产品类型 | `testPaySuccess_bEnd_noVipType_skipsCommission` | 跳过 |
| C端半额 | annual 续费半价 | `testPaySuccess_bEnd_cendHalfAmount` | 金额减半 |
| 未知vipType | 非标 productType | `testPaySuccess_bEnd_unknownVipType_skips` | 跳过 |
| 无推广码引荐 | C端 inviter.referralCode==null | `testPaySuccess_cEnd_noReferralCode_skips` | 跳过 |
| 上级无码跳L2 | C端上级无 referralCode | `testPaySuccess_cEnd_upperNoReferralCode_skipsL2` | 仅L1 |
| 超级会员 L1 | super_member 30% | `testPaySuccess_superMemberCommission_l1` | 百分比 |
| 超级会员 L2 | 5% + 引荐人未付费 | `testPaySuccess_superMemberCommission_l2` | 两步链 |
| B端幂等 | 同订单重复调用 | `testPaySuccess_bEnd_idempotentCommission` | 不重复 |
| B端升级补差 | practitioner 升级补差价 | `testPaySuccess_bEndUpgrade_deduction` | 44760 |
| B端补差归零 | 已付超默认 L1 | `testPaySuccess_bEndUpgrade_zeroDeduction` | 归零 |

### 分佣全流程测试（新）

| 场景 | 流程 | 测试方法 | 验证点 |
|------|------|----------|--------|
| **C端三级链路** | A(有码)→B→C, B付annual | `testCommissionFlow_cEnd_threeTier` | A获L1=5240, C获L2=655 |
| **B端全链路** | B(能量师)→A, A付practitioner | `testCommissionFlow_bEnd_fullPipeline` | B获L1=50000, C获L2=10000 |
| **引荐人未付费跳过** | 上级无referralCode | `testCommissionFlow_inviterNotPaid_skipsCommission` | 不产生佣金 |
| **自然流量无佣金** | buyer无invitedBy | `testCommissionFlow_naturalFlow_noCommission` | 不产生佣金 |
| **B端升级分阶段** | 先付annual→升级practitioner | `testCommissionFlow_bEnd_upgradeDeduction_chain` | 5240+44760=50000=默认L1, 不超额 |
| **推广码注册** | 用户携码注册 | `testLoginOrRegister_withReferralCode` | invitedBy绑定+directCount递增 |
| **自邀跳过** | 用户填自己推广码 | `testLoginOrRegister_selfReferral_doesNotBind` | 不绑定+不计directCount |

### CommissionService 统计

| 场景 | 测试方法 | 验证点 |
|------|----------|--------|
| 完整仪表盘 | `testGetStats_fullDashboard` | 团队人数、直接/间接、佣金汇总、VIP转化统计 |
| 无团队 | `testGetStats_noTeam` | 各项归零 |
| 仅为会员无团队 | `testGetStats_vipOnly` | 团队为空 |
| 日期过滤 | `testGetStats_dateFiltering` | 近7天/30天/本年度 |
| VIP转化统计 | `testGetStats_vipConversion` | 转化率、新会员数 |
| 今日统计 | `testGetStats_todayStats` | 今日新增佣金、团队人数 |

## 前端 E2E 测试

| 测试 | 状态 |
|------|------|
| 管理后台页面加载 | ✅ |
| 核心操作流程 | ✅ |
| 数据展示验证 | ✅ |

## 主题切换修复（v20260608）

| 页面 | 修复项 | 说明 |
|------|--------|------|
| `client/pages/commission/index.vue` | `.section` 背景 `#fff` → `--color-bg-card` | 卡片不跟主题切换 |
| | `.section-sub`, `.comm-amount`, `.comm-remark`, `.tool-arrow` | 硬编码字体颜色 → CSS 变量 |
| | 状态徽章 `.status-settled/pending/available` | 背景和文字颜色 → 语义变量 |
| `client/pages/withdraw/index.vue` | `.input-section`, `.rules-card` 背景 `#fff` → `--color-bg-card` | 卡片不跟主题切换 |
| | `.hint-link` `#3B82F6` → `--color-info` | 链接颜色 |
| | `.error-text` `#EF4444` → `--color-danger` | 错误提示颜色 |
| **剩余已知问题** | `client/pages/profile/` 仍有 `#FEF3C7`, `#E5E7EB`, `#F9FAFB` 等硬编码 | 需后续处理 |
| | `client/pages/relations/*.vue` 21处 `color: #FFFFFF` | 部分在深色背景上可保留，需逐一确认 |

## 已知缺口

| 区域 | 问题 | 优先级 |
|------|------|--------|
| `ExportService` | 无单元测试 | 低 |
| `client/` 前端小程序 | 无自动化 E2E 测试（需微信小程序环境） | 中 |
| `WxPayService` | 无单元测试（189行，支付核心） | 高 🔴 |
| `RelationAnalysisService` | 新模块，尚无单元测试 | 中 |
| `CalculatorServiceTest` | 2个 @Disabled 外部位置测试 | 低 |
| `CommissionServiceTest` | 3个 @Disabled 状态流转测试 | 低 |