# 后端测试覆盖清单

## 总览

| 模块 | 测试文件 | 用例数 | 覆盖率 | 优先级 |
|------|---------|--------|--------|--------|
| 服务类型管理 | 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 | 8 | P1 | ✅ 完善 |
| 教师登录 | TeacherLoginTest | 4 | P0 | ✅ 完善 |
| 集成测试 | GuideModuleIntegrationTest | 4 | P0 | ✅ 完善 |
| 小游戏任务 | TaskServiceMinigameTest | 5 | P1 | 已有 |
| 小游戏服务 | MiniGameServiceTest | 5 | P1 | 已有 |
| 认证模块 | AuthControllerTest | 39 | P0 | ✅ 新增 |
| 心愿模块 | WishControllerTest | 27 | P0 | ✅ 新增 |
| 任务模块 | TaskControllerTest | 19 | P0 | ✅ 新增 |
| 家庭模块 | FamilyControllerTest | 10 | P1 | ✅ 新增 |
| 统计模块 | StatsControllerTest | 6 | P1 | ✅ 新增 |
| 文章管理 | AdminArticleControllerTest | 15 | P0 | ✅ 新增 |
| 文章管理 | ArticleCategoryControllerTest | 3 | P0 | ✅ 新增 |
| 文章内容 | ArticleControllerTest | 11 | P1 | ✅ 新增 |
| 文章服务 | ArticleServiceTest | 21 | P0 | ✅ 新增 |
| 活动管理员 | ActivityControllerTest | 16 | P0 | ✅ 新增 |
| 文章管理员 | ArticleAdminControllerTest | 14 | P0 | ✅ 新增 |
| 规划师权限 | GuideRolePermissionTest | 21 | P0 | ✅ 新增 |
| 营养调理师 | HealthReportControllerTest | 19 | P0 | ✅ 新增 |
| **合计** | **32 文件** | **324** | **通过** | ✅ 编译通过 ｜

## 需求 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 |

### 认证模块 (AuthController) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 发送验证码(成功) | POST /api/auth/send-code | sendCode_Success | AuthControllerTest |
| 发送验证码(空手机号) | POST /api/auth/send-code | sendCode_EmptyPhone | AuthControllerTest |
| 发送验证码(格式错误) | POST /api/auth/send-code | sendCode_InvalidPhone | AuthControllerTest |
| 手机验证码登录(成功) | POST /api/auth/phone-login | phoneLogin_Success | AuthControllerTest |
| 手机验证码登录(参数为空) | POST /api/auth/phone-login | phoneLogin_EmptyParams | AuthControllerTest |
| 手机验证码登录(验证码错误) | POST /api/auth/phone-login | phoneLogin_WrongCode | AuthControllerTest |
| 手机验证码登录(异常) | POST /api/auth/phone-login | phoneLogin_UserServiceException | AuthControllerTest |
| 微信手机号登录(成功) | POST /api/auth/wechat-phone-login | wechatPhoneLogin_Success | AuthControllerTest |
| 微信手机号登录(参数为空) | POST /api/auth/wechat-phone-login | wechatPhoneLogin_EmptyParams | AuthControllerTest |
| 微信code登录(成功) | POST /api/auth/wechat-login | wechatLogin_Success | AuthControllerTest |
| 微信code登录(异常) | POST /api/auth/wechat-login | wechatLogin_Exception | AuthControllerTest |
| 静默登录(成功) | POST /api/auth/silent-login | silentLogin_Success | AuthControllerTest |
| 静默登录(无code) | POST /api/auth/silent-login | silentLogin_NoCode | AuthControllerTest |
| openid自动登录(成功) | POST /api/auth/auto-login | autoLogin_Success | AuthControllerTest |
| openid自动登录(用户不存在) | POST /api/auth/auto-login | autoLogin_UserNotFound | AuthControllerTest |
| openid自动登录(无openid) | POST /api/auth/auto-login | autoLogin_NoOpenid | AuthControllerTest |
| 手机+身份证注册(成功) | POST /api/auth/register-with-idcard | registerWithIdCard_Success | AuthControllerTest |
| 手机+身份证注册(空手机号) | POST /api/auth/register-with-idcard | registerWithIdCard_EmptyPhone | AuthControllerTest |
| 手机+身份证注册(身份证格式错) | POST /api/auth/register-with-idcard | registerWithIdCard_InvalidIdCard | AuthControllerTest |
| 手机+身份证注册(真实姓名为空) | POST /api/auth/register-with-idcard | registerWithIdCard_EmptyRealName | AuthControllerTest |
| 当前用户信息(成功) | POST /api/auth/info | getInfo_Success | AuthControllerTest |
| 当前用户信息(未登录) | POST /api/auth/info | getInfo_NotLoggedIn | AuthControllerTest |
| 设置密码(成功) | POST /api/auth/set-password | setPassword_Success | AuthControllerTest |
| 验证密码(正确) | POST /api/auth/verify-password | verifyPassword_Correct | AuthControllerTest |
| 验证密码(错误) | POST /api/auth/verify-password | verifyPassword_Wrong | AuthControllerTest |
| 检查手机号(已注册) | POST /api/auth/check-phone | checkPhone_Registered | AuthControllerTest |
| 检查手机号(未注册) | POST /api/auth/check-phone | checkPhone_NotRegistered | AuthControllerTest |
| 检查手机号(格式错误) | POST /api/auth/check-phone | checkPhone_Invalid | AuthControllerTest |
| 检查手机号(为空) | POST /api/auth/check-phone | checkPhone_Empty | AuthControllerTest |
| 直接注册(成功) | POST /api/auth/direct-register | directRegister_Success | AuthControllerTest |
| 直接注册(已注册) | POST /api/auth/direct-register | directRegister_AlreadyRegistered | AuthControllerTest |
| 直接注册(格式错误) | POST /api/auth/direct-register | directRegister_InvalidPhone | AuthControllerTest |
| 邀请码注册(成功) | POST /api/auth/register-with-invite | registerWithInvite_Success | AuthControllerTest |
| 邀请码注册(空手机号) | POST /api/auth/register-with-invite | registerWithInvite_EmptyPhone | AuthControllerTest |
| 邀请码注册(空邀请码) | POST /api/auth/register-with-invite | registerWithInvite_EmptyInviteCode | AuthControllerTest |
| 邀请码注册(验证码错误) | POST /api/auth/register-with-invite | registerWithInvite_WrongCode | AuthControllerTest |
| 邀请码注册(手机已注册) | POST /api/auth/register-with-invite | registerWithInvite_AlreadyRegistered | AuthControllerTest |
| 切换角色(成功) | POST /api/auth/switch-role | switchRole_Success | AuthControllerTest |
| 切换角色(未登录) | POST /api/auth/switch-role | switchRole_NotLoggedIn | AuthControllerTest |

### 心愿模块 (WishController) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 孩子创建心愿 | POST /api/wishes/create | createWish_ByChild | WishControllerTest |
| 家长创建心愿 | POST /api/wishes/create | createWish_ByParent | WishControllerTest |
| 创建心愿(异常) | POST /api/wishes/create | createWish_Exception | WishControllerTest |
| 家长定价(成功) | PUT /api/wishes/{id}/set-price | setPrice_Success | WishControllerTest |
| 家长定价(积分无效) | PUT /api/wishes/{id}/set-price | setPrice_InvalidPoints | WishControllerTest |
| 家长定价(服务失败) | PUT /api/wishes/{id}/set-price | setPrice_ServiceFailed | WishControllerTest |
| 家长拒绝心愿(成功) | PUT /api/wishes/{id}/reject | rejectWish_Success | WishControllerTest |
| 家长拒绝心愿(失败) | PUT /api/wishes/{id}/reject | rejectWish_Failed | WishControllerTest |
| 申请兑换(成功) | POST /api/wishes/{id}/exchange | requestExchange_Success | WishControllerTest |
| 申请兑换(失败) | POST /api/wishes/{id}/exchange | requestExchange_Failed | WishControllerTest |
| 审批兑换(批准) | PUT /api/wishes/{id}/approve-exchange | approveExchange_Approved | WishControllerTest |
| 审批兑换(拒绝) | PUT /api/wishes/{id}/approve-exchange | approveExchange_Rejected | WishControllerTest |
| 审批兑换(缺审批结果) | PUT /api/wishes/{id}/approve-exchange | approveExchange_MissingDecision | WishControllerTest |
| 标记已购买(成功) | PUT /api/wishes/{id}/fulfill | markFulfilled_Success | WishControllerTest |
| 标记已购买(失败) | PUT /api/wishes/{id}/fulfill | markFulfilled_Failed | WishControllerTest |
| 孩子确认收货(成功) | PUT /api/wishes/{id}/confirm | confirmReceived_Success | WishControllerTest |
| 孩子确认收货(失败) | PUT /api/wishes/{id}/confirm | confirmReceived_Failed | WishControllerTest |
| 取消心愿(成功) | DELETE /api/wishes/{id} | cancelWish_Success | WishControllerTest |
| 取消心愿(失败) | DELETE /api/wishes/{id} | cancelWish_Failed | WishControllerTest |
| 心愿列表(孩子视角) | POST /api/wishes/list | getWishes_ChildView | WishControllerTest |
| 心愿列表(家长指定孩子) | POST /api/wishes/list | getWishes_ParentViewByChild | WishControllerTest |
| 心愿列表(家长查看家庭) | POST /api/wishes/list | getWishes_ParentViewByFamily | WishControllerTest |
| 心愿列表(缺少条件) | POST /api/wishes/list | getWishes_MissingCondition | WishControllerTest |
| 待处理列表(成功) | POST /api/wishes/pending | getPendingWishes_Success | WishControllerTest |
| 待处理列表(缺家庭ID) | POST /api/wishes/pending | getPendingWishes_NoFamilyId | WishControllerTest |
| 心愿详情(成功) | POST /api/wishes/{id} | getWishById_Success | WishControllerTest |
| 心愿详情(不存在) | POST /api/wishes/{id} | getWishById_NotFound | WishControllerTest |

### 任务模块 (TaskController) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取小游戏列表(有数据) | POST /api/tasks/minigame-options | getMinigameOptions_Success | TaskControllerTest |
| 获取小游戏列表(空) | POST /api/tasks/minigame-options | getMinigameOptions_Empty | TaskControllerTest |
| 创建任务(成功) | POST /api/tasks/create | createTask_Success | TaskControllerTest |
| 获取今日任务 | POST /api/tasks/today | getTodayTasks_Success | TaskControllerTest |
| 完成任务 | POST /api/tasks/{id}/complete | completeTask_Success | TaskControllerTest |
| 审核任务(通过) | POST /api/tasks/{id}/review | reviewTask_Approved | TaskControllerTest |
| 审核任务(拒绝) | POST /api/tasks/{id}/review | reviewTask_Rejected | TaskControllerTest |
| 任务历史(有数据) | POST /api/tasks/history | getTaskHistory_Success | TaskControllerTest |
| 任务历史(默认分页) | POST /api/tasks/history | getTaskHistory_DefaultPagination | TaskControllerTest |
| 待审核任务 | POST /api/tasks/pending-review | getPendingReviewTasks_Success | TaskControllerTest |
| 家长今日任务 | POST /api/tasks/today-parent | getTodayParentTasks_Success | TaskControllerTest |
| 家长完成任务 | POST /api/tasks/{id}/complete-parent | completeParentTask_Success | TaskControllerTest |
| 删除任务(成功) | DELETE /api/tasks/{id} | deleteTask_Success | TaskControllerTest |
| 完成小游戏任务(含参数) | POST /api/tasks/{id}/complete-minigame | completeMinigameTask_Success | TaskControllerTest |
| 完成小游戏任务(无分数) | POST /api/tasks/{id}/complete-minigame | completeMinigameTask_NoScore | TaskControllerTest |
| 批量完成(成功) | POST /api/tasks/batch-complete | batchComplete_Success | TaskControllerTest |
| 批量完成(空ID) | POST /api/tasks/batch-complete | batchComplete_EmptyIds | TaskControllerTest |
| 批量删除(成功) | POST /api/tasks/batch-delete | batchDelete_Success | TaskControllerTest |
| 批量删除(空ID) | POST /api/tasks/batch-delete | batchDelete_EmptyIds | TaskControllerTest |

### 家庭模块 (FamilyController) — 新增 P1

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取邀请码(已有) | POST /api/family/invite-code | getInviteCode_Success | FamilyControllerTest |
| 获取邀请码(无家庭) | POST /api/family/invite-code | getInviteCode_UserNoFamily | FamilyControllerTest |
| 获取邀请码(用户不存在) | POST /api/family/invite-code | getInviteCode_UserNotFound | FamilyControllerTest |
| 获取邀请码(自动生成) | POST /api/family/invite-code | getInviteCode_GenerateIfMissing | FamilyControllerTest |
| 生成新邀请码(成功) | POST /api/family/invite-code/generate | generateNewInviteCode_Success | FamilyControllerTest |
| 生成新邀请码(无家庭) | POST /api/family/invite-code/generate | generateNewInviteCode_UserNoFamily | FamilyControllerTest |
| 规划师绑定家庭(成功) | POST /api/family/guide-bind | guideBindFamily_Success | FamilyControllerTest |
| 规划师绑定家庭(空邀请码) | POST /api/family/guide-bind | guideBindFamily_EmptyInviteCode | FamilyControllerTest |
| 规划师绑定家庭(非规划师) | POST /api/family/guide-bind | guideBindFamily_NotTeacher | FamilyControllerTest |
| 规划师绑定家庭(无效邀请码) | POST /api/family/guide-bind | guideBindFamily_InvalidCode | FamilyControllerTest |

### 统计模块 (StatsController) — 新增 P1

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 孩子完成率(有数据) | POST /api/stats/child-completion | childCompletion_Success | StatsControllerTest |
| 孩子完成率(用户不存在) | POST /api/stats/child-completion | childCompletion_UserNotFound | StatsControllerTest |
| 孩子完成率(无日期参数) | POST /api/stats/child-completion | childCompletion_NoDates | StatsControllerTest |
| 家庭完成率(成功) | POST /api/stats/family-completion | familyCompletion_Success | StatsControllerTest |
| 家庭完成率(用户不存在) | POST /api/stats/family-completion | familyCompletion_UserNotFound | StatsControllerTest |
| 家庭完成率(未关联家庭) | POST /api/stats/family-completion | familyCompletion_NoFamily | StatsControllerTest |

### 文章管理模块 — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 获取文章列表 | POST /api/admin/articles/list | getArticlesList_Success | AdminArticleControllerTest |
| 获取文章详情 | POST /api/admin/articles/{id} | getArticleDetail_Exists | AdminArticleControllerTest |
| 创建文章 | POST /api/admin/articles/create | createArticle_Success | AdminArticleControllerTest |
| 更新文章 | POST /api/admin/articles/update | updateArticle_Success | AdminArticleControllerTest |
| 删除文章 | POST /api/admin/articles/{id}/delete | deleteArticle_Success | AdminArticleControllerTest |
| 切换发布状态 | POST /api/admin/articles/{id}/toggle-status | toggleStatus_Success | AdminArticleControllerTest |
| 切换置顶 | POST /api/admin/articles/{id}/toggle-featured | toggleFeatured_Success | AdminArticleControllerTest |
| 图片上传 | POST /api/admin/articles/upload/image | uploadImage_Success | AdminArticleControllerTest |
| 文章分类列表 | POST /api/admin/articles/categories/list | getCategories_WithData | AdminArticleControllerTest |
| 创建文章分类 | POST /api/admin/articles/categories/create | createCategory_Success | AdminArticleControllerTest |
| 更新文章分类 | POST /api/admin/articles/categories/update | updateCategory_Success | AdminArticleControllerTest |
| 删除文章分类 | POST /api/admin/articles/categories/delete | deleteCategory_Success | AdminArticleControllerTest |
| 公开文章列表 | POST /api/articles/list | getArticles_Success | ArticleControllerTest |
| 公开文章详情 | POST /api/articles/{id} | getArticleById_Exists | ArticleControllerTest |
| 公开分类列表 | POST /api/articles/categories | getCategories_HasData | ArticleCategoryControllerTest |

### 文章服务层 (ArticleService)

| 需求 | 测试用例 | 文件 |
|------|---------|------|
| 记录阅读(ViewCount+1) | recordRead_IncrementsViewCount | ArticleServiceTest |
| 创建(初始值) | create_SetsInitialValues | ArticleServiceTest |
| 创建已发布(设publishTime) | create_PublishedSetsPublishTime | ArticleServiceTest |
| 更新(设updatedAt) | update_SetsUpdatedAt | ArticleServiceTest |
| 删除(指定ID) | delete_DeletesById | ArticleServiceTest |
| 发布(DRAFT→PUBLISHED) | toggleStatus_Publish | ArticleServiceTest |
| 草稿(PUBLISHED→DRAFT) | toggleStatus_Draft | ArticleServiceTest |
| 文章不存在 | toggleStatus_ArticleNotFound | ArticleServiceTest |
| 置顶 | toggleFeatured_SetFeatured | ArticleServiceTest |
| 取消置顶 | toggleFeatured_RemoveFeatured | ArticleServiceTest |

### 活动管理员 (ActivityController) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 活动列表(全部) | POST /api/activity/list | list_AllPublished | ActivityControllerTest |
| 活动列表(按维度过滤) | POST /api/activity/list | list_FilterByDimension | ActivityControllerTest |
| 活动列表(空结果) | POST /api/activity/list | list_NoData | ActivityControllerTest |
| 活动详情(存在) | POST /api/activity/detail | detail_Exists | ActivityControllerTest |
| 活动详情(不存在) | POST /api/activity/detail | detail_NotFound | ActivityControllerTest |
| 活动详情(参数缺失) | POST /api/activity/detail | detail_MissingId | ActivityControllerTest |
| 创建活动 | POST /api/activity/create | create_Success | ActivityControllerTest |
| 创建活动(无标题) | POST /api/activity/create | create_MissingTitle | ActivityControllerTest |
| 更新活动 | POST /api/activity/update | update_Success | ActivityControllerTest |
| 更新活动(不存在) | POST /api/activity/update | update_NotFound | ActivityControllerTest |
| 删除活动 | POST /api/activity/delete | delete_Success | ActivityControllerTest |
| 删除活动(不存在) | POST /api/activity/delete | delete_NotFound | ActivityControllerTest |
| 发布活动 | POST /api/activity/publish | publish_Success | ActivityControllerTest |
| 发布活动(参数缺失) | POST /api/activity/publish | publish_MissingId | ActivityControllerTest |
| 取消发布 | POST /api/activity/unpublish | unpublish_Success | ActivityControllerTest |
| 取消发布(已下线) | POST /api/activity/unpublish | unpublish_AlreadyInactive | ActivityControllerTest |

### 文章管理员 (AdminArticleController) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 文章列表(全部) | POST /api/admin/articles/list | list_AllArticles | ArticleAdminControllerTest |
| 文章列表(按状态/分类过滤) | POST /api/admin/articles/list | list_WithFilters | ArticleAdminControllerTest |
| 文章列表(空结果) | POST /api/admin/articles/list | list_NoData | ArticleAdminControllerTest |
| 文章详情(存在) | POST /api/admin/articles/detail | detail_Exists | ArticleAdminControllerTest |
| 文章详情(不存在) | POST /api/admin/articles/detail | detail_NotFound | ArticleAdminControllerTest |
| 创建文章 | POST /api/admin/articles/create | create_Success | ArticleAdminControllerTest |
| 创建文章(无标题) | POST /api/admin/articles/create | create_MissingTitle | ArticleAdminControllerTest |
| 更新文章 | POST /api/admin/articles/update | update_Success | ArticleAdminControllerTest |
| 更新文章(不存在) | POST /api/admin/articles/update | update_NotFound | ArticleAdminControllerTest |
| 删除文章 | POST /api/admin/articles/delete | delete_Success | ArticleAdminControllerTest |
| 发布/下架文章 | POST /api/admin/articles/toggle-status | toggleStatus_Publish | ArticleAdminControllerTest |
| 文章分类列表 | POST /api/admin/article-categories/list | categories_list | ArticleAdminControllerTest |
| 创建文章分类 | POST /api/admin/article-categories/create | categories_create_Success | ArticleAdminControllerTest |
| 更新文章分类 | POST /api/admin/article-categories/update | categories_update_Success | ArticleAdminControllerTest |

### 规划师权限 (GuideRolePermission) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 规划师注册(基本信息) | POST /api/guide/apply/new | register_BasicInfo | GuideRolePermissionTest |
| 规划师升级申请 | POST /api/guide/apply/upgrade | upgrade_Success | GuideRolePermissionTest |
| 禁用规划师 | POST /api/admin/guide/disable | disable_Success | GuideRolePermissionTest |
| 获取待审申请 | POST /api/admin/guide/applications/pending | getPendingApplications_Success | GuideRolePermissionTest |
| 审批通过 | POST /api/admin/guide/applications/{id}/approve | approve_Success | GuideRolePermissionTest |
| 审批拒绝 | POST /api/admin/guide/applications/{id}/reject | reject_Success | GuideRolePermissionTest |
| 获取我的团队 | POST /api/guide/team | getMyTeam_Success | GuideRolePermissionTest |
| 获取邀请码 | POST /api/guide/team/invite-code | getInviteCode_Success | GuideRolePermissionTest |
| 获取订单列表 | POST /api/guide/orders/list | getOrders_Success | GuideRolePermissionTest |
| 获取家庭任务概览 | POST /api/guide/families/{id}/overview | getFamilyOverview_Success | GuideRolePermissionTest |
| 审核家庭任务 | POST /api/guide/families/tasks/review | reviewTask_Success | GuideRolePermissionTest |
| 非教师拒绝 | POST /api/guide/team | nonTeacher_AccessDenied | GuideRolePermissionTest |
| 家长权限隔离(任务审核) | POST /api/guide/families/tasks/review | parentRole_AccessDenied | GuideRolePermissionTest |
| 测评配置 | POST /api/guide/assessment/config | assessmentConfig_Success | GuideRolePermissionTest |
| 测评配置(参数缺失) | POST /api/guide/assessment/config | assessmentConfig_NoData | GuideRolePermissionTest |

### 营养调理师 (HealthReportController) — 新增 P0

| 需求 | API | 测试用例 | 文件 |
|------|-----|---------|------|
| 创建体检报告 | POST /api/health/report/create | createReport_PhysicalExam | HealthReportControllerTest |
| 创建菌群报告 | POST /api/health/report/create | createReport_GutTest | HealthReportControllerTest |
| 创建报告(参数缺失) | POST /api/health/report/create | createReport_MissingParams | HealthReportControllerTest |
| 获取报告列表 | POST /api/health/report/list | getReports_WithData | HealthReportControllerTest |
| 获取报告列表(无数据) | POST /api/health/report/list | getReports_NoData | HealthReportControllerTest |
| 获取报告详情(存在) | POST /api/health/report/detail | getReportDetail_Exists | HealthReportControllerTest |
| 获取报告详情(不存在) | POST /api/health/report/detail | getReportDetail_NotFound | HealthReportControllerTest |
| 获取最新报告(存在) | POST /api/health/report/latest | getLatestReport_Exists | HealthReportControllerTest |
| 获取最新报告(不存在) | POST /api/health/report/latest | getLatestReport_NotFound | HealthReportControllerTest |
| 获取指标列表 | POST /api/health/report/indicators | getIndicators_WithData | HealthReportControllerTest |
| 获取指标列表(无数据) | POST /api/health/report/indicators | getIndicators_NoData | HealthReportControllerTest |
| 获取指标列表(无报告ID) | POST /api/health/report/indicators | listIndicators_MissingReportId | HealthReportControllerTest |
| 归档报告(成功) | POST /api/health/report/archive | archiveReport_Success | HealthReportControllerTest |
| 归档报告(无报告ID) | POST /api/health/report/archive | archiveReport_MissingReportId | HealthReportControllerTest |
| 肠道菌群详情 | POST /api/health/report/gut-flora | getGutFlora_Success | HealthReportControllerTest |
| 疾病风险评估 | POST /api/health/report/disease-risk | getDiseaseRisk_Success | HealthReportControllerTest |
| 追加指标 | POST /api/health/report/indicators/add | addIndicators_Success | HealthReportControllerTest |
| 删除指标 | POST /api/health/report/indicators/delete | deleteIndicator_Success | HealthReportControllerTest |
| 疾病风险(参数缺失) | POST /api/health/report/disease-risk | getDiseaseRisk_MissingParams | HealthReportControllerTest |

## 测试数据 ID 分配

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