测试用例矩阵 — 角色 × 功能 × 业务流程
生成时间: 2026-07-01（更新）
测试环境: http://cfc.iwintrue.com:80
测试分支: cfclub (commit 2a1ac7d)
最后更新: Sisyphus (2026-07-01 第三轮测试)
一、角色权限总览
| 角色 |
认证方式 |
核心能力 |
admin |
JWT (skip-captcha) |
用户管理、商品审核、文章发布、活动审核、供应商审核 |
parent |
JWT |
家庭管理、孩子管理、购买商品/测评、参与活动、打卡记录 |
teacher (成长规划师) |
JWT |
绑定家庭、审核成长任务、查看成长报告 |
vendor (商品供应商) |
X-User-Id header |
商品创建/上下架、申请供应商状态 |
child |
JWT |
查看任务、执行打卡（受限） |
二、测试用例矩阵
2.1 认证模块 (AUTH)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| AUTH-ADMIN-001 |
/api/admin-auth/login |
POST |
admin |
管理员验证码登录 |
返回token+userId |
✅ 可用 |
| AUTH-ADMIN-002 |
/api/admin-auth/send-code |
POST |
admin |
发送登录验证码 |
验证码发送成功 |
✅ 可用 |
| AUTH-PARENT-001 |
/api-auth/login |
POST |
parent |
家长手机号登录 |
返回token |
✅ 可用 |
| AUTH-VENDOR-001 |
/api/vendor/apply |
POST |
vendor |
供应商申请（X-User-Id） |
申请成功 |
⚠️ 待验证 |
2.2 用户管理模块 (USER)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| USER-ADMIN-001 |
/api/admin/users/create |
POST |
admin |
创建用户（家长） |
返回新用户 |
✅ 已验证修复 |
| USER-ADMIN-002 |
/api/admin/users/list |
POST |
admin |
用户列表查询 |
返回分页用户 |
✅ 可用 |
| USER-ADMIN-003 |
/api/admin/users/delete |
POST |
admin |
删除用户 |
删除成功 |
✅ 可用 |
| USER-ADMIN-004 |
/api/admin/users/{id} |
GET |
admin |
查看用户详情 |
返回用户信息 |
✅ 可用 |
2.3 家庭管理模块 (FAMILY)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| FAMILY-PARENT-001 |
/api/family/member/add |
POST |
parent |
添加家庭成员 |
成员添加成功 |
✅ 可用 |
| FAMILY-PARENT-002 |
/api/family/member/list |
POST |
parent |
家庭成员列表 |
返回成员列表 |
✅ 可用 |
| FAMILY-PARENT-003 |
/api/family/member/relationship-types |
GET |
parent |
获取关系类型 |
返回关系类型列表 |
✅ 可用 |
| FAMILY-PARENT-004 |
/api/family/member/switch |
POST |
parent |
切换当前孩子 |
切换成功 |
✅ 可用 |
2.4 供应商模块 (VENDOR)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| VENDOR-ADMIN-001 |
/api/admin/vendor/apply |
POST |
admin |
审核供应商申请 |
审核成功 |
✅ 可用 |
| VENDOR-ADMIN-002 |
/api/admin/vendor/list |
POST |
admin |
供应商列表 |
返回供应商列表 |
✅ 可用 |
| VENDOR-VENDOR-001 |
/api/vendor/apply |
POST |
vendor |
供应商申请 |
申请成功pending |
⚠️ 待验证 |
| VENDOR-VENDOR-002 |
/api/vendor/status |
GET |
vendor |
查询供应商状态 |
返回当前状态 |
⚠️ 待验证 |
| VENDOR-VENDOR-003 |
/api/vendor/info |
GET |
vendor |
供应商信息 |
返回供应商信息 |
⚠️ 待验证 |
2.5 商品模块 (PRODUCT)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| PRODUCT-VENDOR-001 |
/api/product/create |
POST |
vendor |
创建商品 |
返回商品ID |
⚠️ 待验证 |
| PRODUCT-VENDOR-002 |
/api/product/shelve |
POST |
vendor |
商品上架 |
上架成功 |
✅ 已修复 |
| PRODUCT-VENDOR-003 |
/api/product/unshelve |
POST |
vendor |
商品下架 |
下架成功 |
✅ 已修复 |
| PRODUCT-ADMIN-001 |
/api/admin/product/review |
POST |
admin |
审核商品 |
审核成功 |
✅ 可用 |
| PRODUCT-ADMIN-002 |
/api/admin/product/shelve |
POST |
admin |
管理员上架商品 |
上架成功 |
✅ 可用 |
| PRODUCT-ADMIN-003 |
/api/admin/product/list |
POST |
admin |
商品列表 |
返回商品列表 |
✅ 可用 |
| PRODUCT-PARENT-001 |
/api/product/list |
POST |
parent |
家长浏览商品 |
返回商品列表 |
✅ 可用 |
| PRODUCT-PARENT-002 |
/api/product/detail |
GET |
parent |
商品详情 |
返回商品详情 |
✅ 可用 |
2.6 文章模块 (ARTICLE)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| ARTICLE-ADMIN-001 |
/api/admin/articles/create |
POST |
admin |
创建文章 |
返回文章ID |
✅ 可用 |
| ARTICLE-ADMIN-002 |
/api/admin/articles/publish |
POST |
admin |
发布文章 |
发布成功 |
✅ 已解决 |
| ARTICLE-ADMIN-003 |
/api/admin/articles/list |
POST |
admin |
文章列表 |
返回文章列表 |
✅ 可用 |
| ARTICLE-ADMIN-004 |
/api/admin/articles/{id} |
GET |
admin |
文章详情 |
返回文章详情 |
✅ 可用 |
| ARTICLE-PARENT-001 |
/api/article/list |
POST |
parent |
家长浏览文章 |
返回文章列表 |
✅ 可用 |
| ARTICLE-PARENT-002 |
/api/article/detail |
GET |
parent |
文章详情 |
返回文章详情 |
✅ 可用 |
2.7 活动模块 (ACTIVITY)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| ACTIVITY-ADMIN-001 |
/api/admin/activity/create |
POST |
admin |
创建活动 |
返回活动ID |
✅ 可用 |
| ACTIVITY-ADMIN-002 |
/api/admin/activity/publish |
POST |
admin |
发布活动 |
发布成功 |
✅ 可用 |
| ACTIVITY-ADMIN-003 |
/api/admin/activity/list |
POST |
admin |
活动列表 |
返回活动列表 |
✅ 可用 |
| ACTIVITY-PARENT-001 |
/api/activity/list |
POST |
parent |
家长浏览活动 |
返回活动列表 |
✅ 可用 |
| ACTIVITY-PARENT-002 |
/api/activity/detail |
GET |
parent |
活动详情 |
返回活动详情 |
✅ 可用 |
| ACTIVITY-PARENT-003 |
/api/activity/signup |
POST |
parent |
报名活动 |
报名成功 |
✅ 可用 |
2.8 测评模块 (ASSESSMENT)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| ASSESS-PARENT-001 |
/api/assessment/orders |
POST |
parent |
创建测评订单 |
返回订单ID |
✅ 可用 |
| ASSESS-PARENT-002 |
/api/assessment/order/list |
POST |
parent |
订单列表 |
返回订单列表 |
✅ 可用 |
| ASSESS-TEACHER-001 |
/api/assessment/order/{id} |
GET |
teacher |
查看订单详情 |
返回订单详情 |
✅ 可用 |
| ASSESS-TEACHER-002 |
/api/assessment/result |
POST |
teacher |
填写测评结果 |
提交成功 |
✅ 可用 |
2.9 健康打卡模块 (HEALTH)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| HEALTH-PARENT-001 |
/api/health/checkin/create |
POST |
parent |
创建打卡 |
打卡成功+5能量 |
✅ 可用 |
| HEALTH-PARENT-002 |
/api/health/checkin/list |
POST |
parent |
打卡列表 |
返回打卡列表 |
✅ 可用 |
| HEALTH-PARENT-003 |
/api/health/checkin/stats |
POST |
parent |
打卡统计 |
返回统计数据 |
✅ 可用 |
2.10 财商打卡模块 (FINANCE)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| FINANCE-PARENT-001 |
/api/wealth/checkin/create |
POST |
parent |
财商打卡 |
打卡成功 |
✅ 可用 |
| FINANCE-PARENT-002 |
/api/wealth/checkin/list |
POST |
parent |
财商打卡列表 |
返回列表 |
✅ 可用 |
| FINANCE-PARENT-003 |
/api/wealth/checkin/stats |
POST |
parent |
财商打卡统计 |
返回统计 |
✅ 可用 |
2.11 成长档案模块 (GROWTH)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| GROWTH-PARENT-001 |
/api/growth/record |
POST |
parent |
创建成长记录 |
记录成功 |
✅ 可用 |
| GROWTH-PARENT-002 |
/api/growth/list |
POST |
parent |
成长记录列表 |
返回记录列表 |
✅ 可用 |
| GROWTH-TEACHER-001 |
/api/growth/records |
POST |
teacher |
查看家庭成长记录 |
返回记录列表 |
✅ 可用 |
2.12 能量系统模块 (ENERGY)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| ENERGY-PARENT-001 |
/api/energy/summary |
POST |
parent |
能量总览 |
返回五维能量 |
✅ 可用 |
| ENERGY-PARENT-002 |
/api/energy/detail |
POST |
parent |
能量明细 |
返回能量明细 |
✅ 可用 |
2.13 邀请销售模块 (INVITE)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| INVITE-PARENT-001 |
/api/invite/code |
POST |
parent |
获取邀请码 |
返回邀请码 |
✅ 可用 |
| INVITE-PARENT-002 |
/api/invite/bind |
POST |
parent |
绑定邀请码 |
绑定成功 |
✅ 可用 |
| INVITE-PARENT-003 |
/api/invite/summary |
POST |
parent |
销售汇总 |
返回销售统计 |
✅ 可用 |
| INVITE-PARENT-004 |
/api/invite/list |
POST |
parent |
下线列表 |
返回下线列表 |
✅ 可用 |
| INVITE-PARENT-005 |
/api/invite/qrcode |
POST |
parent |
推广二维码 |
返回二维码 |
✅ 可用 |
2.14 规划师模块 (GUIDE)
| 用例ID |
端点 |
方法 |
角色 |
业务流程 |
预期结果 |
状态 |
| GUIDE-TEACHER-001 |
/api/guide/training/plans |
POST |
teacher |
获取训练计划 |
返回计划列表 |
✅ 可用 |
| GUIDE-TEACHER-002 |
/api/guide/task/review |
POST |
teacher |
审核任务 |
审核成功 |
✅ 可用 |
| GUIDE-TEACHER-003 |
/api/guide/bind/list |
POST |
teacher |
绑定家庭列表 |
返回列表 |
✅ 可用 |
| GUIDE-ADMIN-001 |
/api/admin/guide/applications/pending |
POST |
admin |
待审核申请 |
返回申请列表 |
✅ 可用 |
| GUIDE-ADMIN-002 |
/api/admin/guide/applications/{id}/approve |
POST |
admin |
批准规划师 |
批准成功 |
✅ 可用 |
三、ISSUE追踪测试用例
| 用例ID |
对应ISSUE |
测试目标 |
状态 |
| ISSUE001-FULLFLOW |
ISSUE-001 |
供应商商品：创建→审核→上架→下架完整流程 |
⚠️ 供应商pending |
| ISSUE002-PUBLISH |
ISSUE-002 |
文章：创建→发布完整流程 |
✅ 已解决 |
| ISSUE003-CREATEUSER |
ISSUE-003 |
管理员创建用户 |
✅ 已验证修复 |
四、测试执行记录
2026-07-01 第三轮测试（完整覆盖）
- 环境：
http://cfc.iwintrue.com:80
- 脚本：
e2e_complete_test.py
- 结果：
- ISSUE-001：⏳ 待验证（供应商81069仍为pending）
- ISSUE-002：✅ 持续通过（文章创建→发布正常）
- ISSUE-003：✅ 已修复并验证（创建用户成功userId=81178）
- 新问题 ISSUE-004~006：打卡/财商/能量 相关端点异常
- 总计：32用例 | PASS=25 | FAIL=5 | WARN=2 | 通过率78%
2026-06-30 第二轮测试
- 环境：修复后重新部署
- ISSUE-001：✅ 已修复（ProductService.shelve 状态检查）
- ISSUE-003：❌ 修复未部署（commit
d7a1c29 未发布）
2026-06-29 第一轮测试
- 环境：初始部署
- 结果：发现 ISSUE-001/002/003
五、部署状态检查清单
