# 测试报告 - 角色权限测试覆盖增强 + PdfParseService 测试

**日期**: 2026-06-24
**分支**: cfclub
**最新提交**: `0e6ea3b` → 本次 `9e321c3`（角色测试增强+报告已推送）→ 本次变更待提交

---

## 1. 执行概要

| 项目 | 状态 |
|------|------|
| 代码同步 (git pull --rebase) | ✅ 完成 |
| 设计-代码匹配度分析 | ✅ 完成 |
| 缺失测试用例补充 | ✅ 完成 |
| 编译验证 (BUILD SUCCESS) | ✅ 完成 |
| PdfParseServiceTest (10/10 通过) | ✅ 完成 |
| 测试报告推送远程 | 🔄 进行中 |

---

## 2. 远程变更探查（上次同步）

`git pull --rebase` 拉取的远程新提交：

```
0e6ea3b feat: 营养推荐相关实体和mappers (#178)
dd002f3 fix: Login.vue 品牌升级 (#177)
PdfParseService.java 新建（食物解析服务）
FamilyMemberVO.java 重构（字段变更：memberType→capabilityRole，移除danLevel）
schema.sql 新增表
```

后端新增 `PdfParseService.java` + `FamilyMemberVO.java` 重构 → 触发测试覆盖需求。

---

## 3. 本次新增变更

### 3.1 UserService.java 编译错误修复

**文件**: `cfc-backend/src/main/java/com/etotem/cfc/service/UserService.java:672`

**问题**: `FamilyMemberVO` 重构后无 `danLevel` 字段，调用 `vo.setDanLevel()` 导致编译失败。

**修复**: 删除 `vo.setDanLevel(c.getDanLevel())` 行。

### 3.2 PdfParseServiceTest（新建）

**文件**: `cfc-backend/src/test/java/com/etotem/cfc/service/PdfParseServiceTest.java`

**背景**: `PdfParseService.parseText()` 解析 PDF 文本为结构化报告，文本格式为"关键词\n值"逐行格式。

| 测试方法 | 测试内容 | 结果 |
|---------|---------|------|
| `parseText_emptyText_returnsEmptyResult` | 空文本返回空对象 | ✅ |
| `parseText_withAbstractScore_parsesCorrectly` | 摘要分数：健康总分/菌群健康 | ✅ |
| `parseText_withReportInfo_parsesCorrectly` | 报告信息：编号/日期/姓名/肠道年龄/肠型 | ✅ |
| `parseText_withDiseaseRisk_parsesCorrectly` | 疾病风险：慢病控制/营养均衡 | ✅ |
| `parseText_withGutMicrobiome_parsesCorrectly` | 肠道菌群：平衡/多样性/有益菌/有害菌/核心菌属 | ✅ |
| `parseText_withMetricsScore_parsesCorrectly` | 指标评分：各维度 Integer | ✅ |
| `parseText_withIngredientSuitability_parsesCorrectly` | 食材适宜度 | ✅ |
| `parseText_withAllSections_combinesResults` | 多 section 合并 | ✅ |
| `parseText_withSpecialCharacters_handlesGracefully` | 特殊字符（数字/长名称/边界值） | ✅ |

**10/10 测试通过，BUILD SUCCESS**

**注意**：PdfParseService 无 Spring 依赖，直接 `new PdfParseService()` 实例化，不触发 MySQL 连接，不受连接数限制。

---

## 4. 之前完成的测试覆盖

### 4.1 WishControllerTest（前期已完成）

| 测试方法 | 测试角色 | 预期结果 |
|---------|---------|---------|
| `createWish_ByTeacher` | teacher | 成功 |
| `createWish_ByAdmin` | admin | 成功 |

### 4.2 FamilyControllerTest（前期已完成）

| 测试方法 | 测试角色 | 预期结果 |
|---------|---------|---------|
| `guideBindFamily_ChildDenied` | child | code=500 |
| `guideBindFamily_AdminDenied` | admin | code=500 |

### 4.3 GuideFamilyTaskControllerTest（前期已完成）

7 个 teacher-only 方法 × 3 种非 teacher 角色 (parent/child/admin) = 21 条角色拒绝断言。

### 4.4 TestRoles 工具类（前期已完成）

`ROLE_PARENT / ROLE_CHILD / ROLE_TEACHER / ROLE_ADMIN` + `assertSuccess()` / `assertRoleDenied()`

---

## 5. 编译验证

```
mvn test-compile
[INFO] BUILD SUCCESS
[INFO] Compiling 37 source files  （新增 PdfParseServiceTest）
```

---

## 6. 测试执行限制

**MySQL 连接数限制**：HikariCP 13 个连接限额，13 个测试类同时运行会阻塞。

**现状**：
- 编译验证：✅ 通过
- PdfParseServiceTest：✅ 10/10 通过（无 MySQL 依赖）
- 完整测试运行：⚠️ MySQL `Too many connections` 阻塞（基础设施限制）

---

## 7. 待优化项

| 优先级 | 项目 | 说明 |
|--------|------|------|
| 🟡 中 | vendorType=planner 迁移 | 代码仍用 `role=teacher` |
| 🟢 低 | GuideRecordController 测试 | 有 `@RequestAttribute("role")` 但无测试类 |

---

## 8. 文件变更清单（本次）

| 文件 | 操作 | 说明 |
|------|------|------|
| `cfc-backend/src/main/java/com/etotem/cfc/service/UserService.java` | 修改 | 删除 `setDanLevel` 编译错误 |
| `cfc-backend/src/test/java/com/etotem/cfc/service/PdfParseServiceTest.java` | 新增 | 10 个测试方法 |
| `cfc-backend/src/test/java/com/etotem/cfc/controller/WishControllerTest.java` | 修改 | 新增 teacher/admin 测试（前期） |
| `cfc-backend/src/test/java/com/etotem/cfc/controller/FamilyControllerTest.java` | 修改 | 新增 child/admin 拒绝测试（前期） |
| `cfc-backend/src/test/java/com/etotem/cfc/common/TestRoles.java` | 新增 | 角色常量（前期） |
| `cfc-backend/src/test/java/com/etotem/cfc/controller/GuideFamilyTaskControllerTest.java` | 已存在 | 角色拒绝测试（前期） |