# 测试用例矩阵 — 角色 × 功能 × 业务流程

**生成时间**: 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

---

## 五、部署状态检查清单

- [x] commit `d7a1c29` (ISSUE-001/003 修复) 已部署到测试环境
- [x] **ISSUE-003 固定已验证**：创建用户成功
- [ ] 供应商 81069 状态确认为 approved（当前pending）
- [ ] 完整执行 ISSUE001-FULLFLOW 测试用例
- [ ] 调查 ISSUE-004~006（打卡统计/财商打卡/能量总览异常）
- [ ] 更新所有标记为 "⚠️ 待验证" 的用例