# 测试覆盖率报告

**生成日期:** 2026-06-10
**分支:** master (rebased on origin/master)
**备注:** 从远程更新后适配全部 API 变更。新增 RelationAnalysisServiceTest (16) + AnalyticsServiceTest (9) + AdminController 端点测试扩充至 34，合计 +32 条。全量 253 测试通过。

## 总览

| 套件 | 运行 | 通过 | 失败 | 错误 | 跳过 |
|------|------|------|------|------|------|
| 后端单元测试 | 253 | 253 | 0 | 0 | 0 |

## 后端测试详情

### AdminControllerApiTest

| 端点 | 测试数 | 覆盖情况 |
|------|--------|----------|
| 管理后台 API + analytics | **34** | 配置管理、用户管理、订单管理、仪表盘统计、转化漏斗、分销统计 |

### 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 | 当前定价、升级定价 |
| AcademicOrientation | 1 | 学业方向分析 |
| **合计** | **56** | |

### 服务层测试

| Service | 测试数 | 覆盖重点 |
|---------|--------|----------|
| AnalyticsServiceTest | **9** | 新增：转化漏斗、分销统计、仪表盘 |
| CalculatorServiceTest | 16 | 能量盘计算 24 位置 |
| ChartServiceTest | 18 | 咨询 CRUD、鉴权 |
| ChatServiceTest | 7 | AI 对话、配额检查 |
| CommissionServiceTest | 15 | 佣金列表、汇总、统计仪表盘 |
| ConfigServiceTest | 9 | 配置 CRUD |
| DifyServiceTest | 5 | Dify API 调用 |
| OrderServiceTest | **27** | 订单创建、分佣逻辑全覆盖 |
| RelationAnalysisServiceTest | **16** | 新增：关系分析记录 CRUD、AI 对话、startAnalysis 多分支 |
| UserServiceTest | **21** | 登录注册、VIP、配额、推广码绑定 |
| WithdrawServiceTest | **7** | 提现申请、审批、排队 |
| WxPayServiceTest | 13 | 支付核心 |
| **合计** | **253** | |

## 远程适配修复

| 测试文件 | 问题 | 修复 |
|----------|------|------|
| `RelationAnalysisServiceTest` | Java 8 不支持 `List.of()`/`Map.of()` | 替换为 `Collections.singletonList`/`HashMap` |
| `OrderServiceTest`（5 条） | 远程移除 referralCode 付费检查，免费用户也可获佣金 | skip 测试改为验证佣金创建 |
| `ControllerIntegrationTest`（2 条） | WithdrawController 新增 3-参签名 + 分页返回 | Mock 适配新 API |
| `WithdrawServiceTest`（3 条） | Repository 方法变更 + 审批流程增加排队态 | 更新 mock/断言 |
| `AnalyticsServiceTest` | `stream().count()` 返回 `Long` 而非 `Integer` | 断言字面量加 `L` |

## 已知缺口

| 区域 | 问题 | 优先级 |
|------|------|--------|
| `ExportService` | 无单元测试 | 低 |
| `client/` 前端小程序 | 无自动化 E2E 测试（需微信小程序环境） | 中 |
| `WxPayService` | 异常场景覆盖不足 | 低 |
| `CalculatorServiceTest` | 2 个位置命名测试被 `@Disabled` | 低 |
| `CommissionServiceTest` | 3 个状态流转测试被 `@Disabled` | 低 |