# 后端测试覆盖清单

## 总览

| 模块 | 测试文件 | 用例数 | 覆盖率 | 优先级 |
|------|---------|--------|--------|--------|
| 服务类型管理 | ServiceTypeServiceTest | 4 | P0-P1 | ✅ 完善 |
| 服务内容管理 | ServiceContentServiceTest | 5 | P0-P1 | ✅ 完善 |
| 套餐模板管理 | GuidePackageTemplateServiceTest | 5 | P0 | ✅ 完善 |
| 指导师套餐 | GuidePackageServiceTest | 6 | P0-P1 | ✅ 新增 |
| 家庭绑定管理 | GuideFamilyServiceTest | 7 | P0 | ✅ 完善 |
| 层级关系 | GuideHierarchyServiceTest | 9 | P0-P1 | ✅ 完善 |
| 团队管理 | GuideTeamControllerTest | 8 | P0 | ✅ 完善 |
| 家庭任务管理 | GuideFamilyTaskControllerTest | 5 | P0-P1 | ✅ 扩充 |
| 订单管理 | GuideOrderControllerTest | 5 | P0-P1 | ✅ 新增 |
| 申请审核 | GuideApplicationServiceTest | 5 | P1 | ✅ 新增 |
| 教师登录 | TeacherLoginTest | 4 | P0 | ✅ 完善 |
| 集成测试 | GuideModuleIntegrationTest | 4 | P0 | ✅ 完善 |
| 小游戏任务 | TaskServiceMinigameTest | - | P1 | 已有 |
| 小游戏服务 | MiniGameServiceTest | - | P1 | 已有 |
| **合计** | **14 文件** | **~82** | | |

## 需求 vs 测试映射

### 服务类型管理 (guide-requirements.md §5.1)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取服务类型列表 | POST /api/admin/service-types/list | testGetActiveTypes | ServiceTypeServiceTest |
| 创建服务类型 | POST /api/admin/service-types/create | testCreateType | ServiceTypeServiceTest |
| 更新服务类型 | POST /api/admin/service-types/update | testUpdateType | ServiceTypeServiceTest |
| 删除服务类型 | POST /api/admin/service-types/delete | testDeleteType | ServiceTypeServiceTest |

### 服务内容管理 (guide-requirements.md §5.2)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取服务内容列表 | POST /api/admin/service-contents/list | testGetActiveContents | ServiceContentServiceTest |
| 按类型查询 | POST /api/admin/service-contents/by-type | testGetContentsByType | ServiceContentServiceTest |
| 创建服务内容 | POST /api/admin/service-contents/create | testCreateContent | ServiceContentServiceTest |
| 更新服务内容 | POST /api/admin/service-contents/update | testUpdateContent | ServiceContentServiceTest |
| 删除服务内容 | POST /api/admin/service-contents/delete | testDeleteContent | ServiceContentServiceTest |
| 富文本内容完整 | (存储) | testRichTextContent | ServiceContentServiceTest |

### 套餐模板管理 (guide-requirements.md §5.3)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取模板列表 | POST /api/guide/package-templates/list | testGetActiveTemplates | GuidePackageTemplateServiceTest |
| 创建模板 | POST /api/guide/package-templates/create | testCreateTemplate | GuidePackageTemplateServiceTest |
| 更新模板 | POST /api/guide/package-templates/update | testUpdateTemplate | GuidePackageTemplateServiceTest |
| 删除模板 | POST /api/guide/package-templates/delete | testDeleteTemplate | GuidePackageTemplateServiceTest |
| 价格验证 | (逻辑) | testPriceValidation | GuidePackageTemplateServiceTest |

### 指导师套餐 (guide-requirements.md §5.4)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 添加套餐 | POST /api/guide/packages/add | testAddGuidePackage_Success | GuidePackageServiceTest |
| 重复添加禁止 | POST /api/guide/packages/add | testAddGuidePackage_Duplicate | GuidePackageServiceTest |
| 套餐不存在 | POST /api/guide/packages/add | testAddGuidePackage_InvalidPackage | GuidePackageServiceTest |
| 获取套餐列表 | POST /api/guide/packages/list | testGetGuidePackages | GuidePackageServiceTest |
| 更新价格 | POST /api/guide/packages/price/update | testUpdatePrice | GuidePackageServiceTest |
| 删除套餐 | POST /api/guide/packages/delete | testDeleteGuidePackage | GuidePackageServiceTest |
| 状态流转 | (DRAFT/PUBLISHED/PAUSED) | testStatusTransition | GuidePackageServiceTest |

### 家庭绑定管理 (guide-requirements.md §5.5)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 生成绑定Token | POST /api/guide/families/bind-token | testGenerateBindToken | GuideFamilyServiceTest |
| 确认绑定(新建) | POST /api/guide/families/confirm-bind | testConfirmBind_CreateNew | GuideFamilyServiceTest |
| 确认绑定(更新) | POST /api/guide/families/confirm-bind | testConfirmBind_UpdateExisting | GuideFamilyServiceTest |
| 解除绑定 | POST /api/guide/families/unbind | testUnbind | GuideFamilyServiceTest |
| 查询绑定状态(未绑定) | POST /api/guide/families/is-bound | testIsBound_NoBinding | GuideFamilyServiceTest |
| 按指导师查询(无数据) | POST /api/guide/families/by-guide | testGetFamiliesByGuide_NoData | GuideFamilyServiceTest |
| 按家庭查询指导师 | POST /api/guide/families/guides | testGetGuidesByFamily | GuideFamilyServiceTest |

### 团队管理 (guide-requirements.md §5.6)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取我的团队 | POST /api/guide/team | testGetMyTeam_WithMembers | GuideTeamControllerTest |
| 无团队数据 | POST /api/guide/team | testGetMyTeam_NoInviteCode | GuideTeamControllerTest |
| 获取邀请码(已有) | POST /api/guide/team/invite-code | testGetMyInviteCode_Existing | GuideTeamControllerTest |
| 获取邀请码(新建) | POST /api/guide/team/invite-code | testGetMyInviteCode_CreateNew | GuideTeamControllerTest |
| 生成新邀请码 | POST /api/guide/team/invite-code/generate | testGenerateInviteCode | GuideTeamControllerTest |
| 获取成员列表(有数据) | POST /api/guide/team/members | testGetTeamMembers_WithData | GuideTeamControllerTest |
| 获取成员列表(无数据) | POST /api/guide/team/members | testGetTeamMembers_NoInviteCode | GuideTeamControllerTest |
| 团队统计(有数据) | POST /api/guide/team/stats | testGetTeamStats_WithMembers | GuideTeamControllerTest |
| 团队统计(无数据) | POST /api/guide/team/stats | testGetTeamStats_NoInviteCode | GuideTeamControllerTest |

### 家庭任务管理 (GuideFamilyTaskController)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取绑定的家庭(教师角色) | POST /api/guide/families/bound-families | getBoundFamilies_TeacherRole_Success | GuideFamilyTaskControllerTest |
| 获取绑定的家庭(非教师拒绝) | POST /api/guide/families/bound-families | getBoundFamilies_NonTeacherRole_AccessDenied | GuideFamilyTaskControllerTest |
| 获取绑定的家庭(指导师无关联) | POST /api/guide/families/bound-families | getBoundFamilies_NoFamilies | GuideFamilyTaskControllerTest |
| 获取绑定的家庭(有关联家庭) | POST /api/guide/families/bound-families | getBoundFamilies_WithFamilies | GuideFamilyTaskControllerTest |
| 获取家庭任务概览(教师角色) | POST /api/guide/families/{id}/overview | getFamilyOverview_Success | GuideFamilyTaskControllerTest |

### 订单管理 (guide-requirements.md §5.8)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取订单列表(默认分页) | POST /api/guide/orders/list | testGetOrders_DefaultPagination | GuideOrderControllerTest |
| 获取订单列表(按状态过滤) | POST /api/guide/orders/list | testGetOrders_FilterByStatus | GuideOrderControllerTest |
| 获取订单统计 | POST /api/guide/orders/stats | testGetOrderStats | GuideOrderControllerTest |
| 获取订单详情(存在) | POST /api/guide/orders/detail | testGetOrderDetail_Exists | GuideOrderControllerTest |
| 获取订单详情(不存在) | POST /api/guide/orders/detail | testGetOrderDetail_NotFound | GuideOrderControllerTest |
| 获取订单详情(参数缺失) | POST /api/guide/orders/detail | testGetOrderDetail_MissingParam | GuideOrderControllerTest |

### 申请审核 (GuideApplicationService)

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 申请入驻 | POST /api/guide/apply/new | testApplyNew | GuideApplicationServiceTest |
| 申请升级 | POST /api/guide/apply/upgrade | testApplyUpgrade | GuideApplicationServiceTest |
| 获取待审列表 | POST /api/admin/guide/applications/pending | testGetPendingApplications | GuideApplicationServiceTest |
| 审批通过 | POST /api/admin/guide/applications/{id}/approve | testApproveApplication | GuideApplicationServiceTest |
| 审批拒绝 | POST /api/admin/guide/applications/{id}/reject | testRejectApplication | GuideApplicationServiceTest |
| 审批不存在 | POST /api/admin/guide/applications/{id}/approve | testApprove_NotFound | GuideApplicationServiceTest |

## 测试数据 ID 分配

| 服务 | ID范围 | 说明 |
|------|--------|------|
| GuideFamilyService | 99901-99999 | 已占用 |
| GuideHierarchyService | 81001-81999 | 已占用 |
| GuidePackageService | 82001-82999 | 已分配 |
| GuideApplicationService | 83001-83999 | 已分配 |
| TeacherLoginTest | test_teacher_openid_* | 已占用 |
| GuidePackageTemplateService | 自动生成 | |
| ServiceTypeService | 自动生成 | |
| ServiceContentService | 自动生成 | |