# 所有功能接口参数分析

> 请逐项判断：**哪些功能应该支持选择家庭成员（memberId）？**

## 参数说明

| 参数 | 语义 | 谁操作 |
|------|------|--------|
| `childId` | 孩子自己操作 | 孩子用户执行，不需要选人 |
| `memberId` | 用户选择家庭成员 | 家长可为任何家庭成员代操作（含孩子、配偶、老人） |
| 无参数 | 自己操作自己 | 不需要选人 |

## 按功能模块列出

### 认证与用户管理

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 1 | 登录/注册 | 多个 | 无 | 自己 | 自己登录 |
| 2 | 用户信息 | `/api/user/info` | 无 | 自己 | 自己的信息 |
| 3 | 角色列表 | `/api/family/user/roles` | 无 | 自己 | 自己的角色 |
| 4 | 切换到孩子视图 | `/api/family/member/switch` | `memberId` | 家长 | 切换到孩子视角 |
| 5 | 切换回家长 | `/api/family/user/switch-back-to-parent` | 无 | 自己 | 切换回来 |

### 家庭管理

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 6 | 家庭成员列表 | `/api/family/member/list` | 无 | 自己 | 查看家庭 |
| 7 | 孩子列表 | `/api/family/children` | 无 | 自己 | 查看孩子 |
| 8 | 关系问卷生成 | `/api/family/questionnaire/generate` | **`memberId`** | 家长 | 为某成员生成问卷 |
| 9 | 关系质量评分 | `/api/family/relationship/scores` | 无 | 自己 | 家庭关系 |
| 10 | 互动类型/列表 | `/api/family/interaction/*` | 无 | 自己 | 家庭互动 |
| 11 | 邀请码 | `/api/family/invite-code` | 无 | 自己 | 自己的邀请码 |
| 12 | 待审批绑定 | `/api/family/pending-bindings` | 无 | 自己 | 家庭绑定 |

### 任务管理

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 13 | 创建任务 | `/api/tasks/create` | `childId` | 家长 | 给某孩子创建任务 |
| 14 | 今日任务列表 | `/api/tasks/today` | `childId` | 孩子 | 孩子看自己的任务 |
| 15 | 完成任务 | `/api/tasks/{id}/complete` | 无 | 孩子 | 孩子完成任务 |
| 16 | 任务历史 | `/api/tasks/history` | `childId` | 孩子 | 孩子看自己的历史 |
| 17 | 待审核列表 | `/api/tasks/pending-review` | 无 | 家长 | 家长审核 |
| 18 | 审核任务 | `/api/tasks/{id}/review` | 无 | 家长 | 家长审核 |
| 19 | 即将到期任务 | `/api/task-reminders/upcoming/{childId}` | `childId` | 家长 | 查看某孩子的到期任务 |
| 20 | 任务统计 | `/api/task-reminders/statistics/{childId}` | `childId` | 家长 | 查看某孩子的任务统计 |

### 心愿管理

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 21 | 创建心愿 | `/api/wishes/create` | 无 | 孩子 | 孩子自己的心愿 |
| 22 | 待处理心愿 | `/api/wishes/pending` | 无 | 家长 | 家长审批 |
| 23 | 心愿列表 | `/api/wishes/list` | 无 | 孩子 | 孩子看自己的心愿 |

### 五维能量系统

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 24 | 能量概览 | `/api/energy/overview` | `childId` | 家长/孩子 | 看某孩子的能量 |
| 25 | 能量沙盘 | `/api/energy/sandbox` | 无 | 家长 | 家庭能量聚合 |
| 26 | 能量流水 | `/api/energy/logs` | `childId` | 家长/孩子 | 看某孩子的流水 |
| 27 | 发放能量 | `/api/energy/grant` | `childId` | 家长 | 给某孩子发能量 |
| 28 | 心愿扣除 | `/api/energy/deduct-for-wish` | `childId` | 孩子 | 孩子兑换扣除 |
| 29 | 五维分数历史 | `/api/energy/score-history` | **`memberId, memberType`** | 家长 | 查看某成员的历史分数 |
| 30 | 维度概览 | `/api/dimension/overview` | **`memberId`** | 家长 | 查看某成员的维度 |
| 31 | 维度历史 | `/api/dimension/history` | **`memberId`** | 家长 | 查看某成员的维度历史 |
| 32 | 富维度详情 | `/api/energy/wealth-detail` | **`memberId, memberType`** | 家长 | 某成员的财富详情 |
| 33 | 家庭收入汇总 | `/api/earnings/family/summary` | 无 | 自己 | 家庭收入 |

### 健康打卡

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 34 | 综合打卡 | `/api/daily/checkin/comprehensive` | `childId` | 孩子 | 孩子自己打卡 |
| 35 | 运动打卡 | `/api/health/exercise/create` | **`memberId`** | 自己 | 自己运动打卡 |
| 36 | 饮食打卡 | `/api/health/meal/create` | **`memberId`** | 自己 | 自己饮食打卡 |
| 37 | 睡眠打卡 | `/api/health/sleep/create` | **`memberId`** | 自己 | 自己睡眠打卡 |
| 38 | 喝水打卡 | `/api/health/water/create` | **`memberId`** | 自己 | 自己喝水打卡 |
| 39 | 冥想打卡 | `/api/health/meditation/create` | **`memberId`** | 自己 | 自己冥想打卡 |
| 40 | 打卡列表 | `/api/daily/checkin/list` | **`memberId`** | 自己 | 看自己的打卡记录 |
| 41 | 打卡统计 | `/api/daily/checkin/stats` | **`memberId`** | 自己 | 自己统计 |
| 42 | 打卡进度 | `/api/daily/checkin/streak` | **`memberId`** | 自己 | 自己连续打卡 |
| 43 | 健康积分 | `/api/health/score/overview` | `childId` | 孩子 | 孩子健康积分 |
| 44 | 健康时间线 | `/api/health/timeline/list` | `childId` | 孩子 | 孩子健康时间线 |
| 45 | 健康预警 | `/api/health/alert/list` | `childId` | 孩子 | 孩子健康预警 |

### 成长档案

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 46 | 创建成长档案 | `/api/growth/record/create` | `childId` | 家长 | 为某孩子创建档案 |
| 47 | 档案列表 | `/api/growth/record/list` | 无 | 家长 | 自己家庭的档案 |
| 48 | 指定孩子档案 | `/api/growth/record/child/{childId}` | `childId` | 家长 | 某孩子的档案 |
| 49 | 档案详情 | `/api/growth/record/{id}` | 无 | 家长 | 某条档案详情 |
| 50 | 生长记录列表 | `/api/health/growth/list` | **`memberId`** | 家长 | 某成员的生长记录 |
| 51 | 创建生长记录 | `/api/health/growth/create` | 无 | 家长 | 记录生长数据 |
| 52 | 创建成长计划 | `/api/growth/plan/create` | `childId` | 规划师 | 为某孩子制定计划 |
| 53 | 查看孩子计划 | `/api/growth/plan/child/{childId}` | `childId` | 家长 | 某孩子的计划 |

### DAN测评

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 54 | 测评材料列表 | `/api/assessment/materials` | 无 | 自己 | 查看材料 |
| 55 | 创建测评订单 | `/api/dan-assessment/order/create` | `childId` | 家长 | 为某孩子购买测评 |
| 56 | 评估师列表 | `/api/assessment/appointment/assessor-list` | 无 | 自己 | 查看评估师 |
| 57 | 最新测评结果 | `/api/assessment/latest-result` | `childId` | 家长 | 某孩子的结果 |
| 58 | 测评历史 | `/api/assessment/history` | `childId` | 家长 | 某孩子的历史 |
| 59 | 家长自评 | `/api/parent/assessment/create` | `childId` | 家长 | 为某孩子自评 |
| 60 | 自评记录 | `/api/parent/assessment/records` | 无 | 自己 | 自己的自评 |

### 商城交易

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 61 | 商品列表 | `/api/product/list` | 无 | 自己 | 浏览商品 |
| 62 | 购物车 | `/api/cart/list` | 无 | 自己 | 自己的购物车 |
| 63 | 创建订单 | `/api/product/order/create` | 无 | 自己 | 自己下单 |
| 64 | 我的订单 | `/api/product/order/my` | 无 | 自己 | 自己的订单 |
| 65 | 收货地址 | `/api/consignee/list` | 无 | 自己 | 自己的地址 |

### 积分兑换

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 66 | 积分余额 | `/api/points/balance` | `childId` | 孩子 | 孩子自己的积分 |
| 67 | 积分流水 | `/api/points/logs` | `childId` | 孩子 | 孩子自己的流水 |
| 68 | 兑换商品列表 | `/api/points/exchange/products` | 无 | 自己 | 浏览可兑换商品 |
| 69 | 兑换积分 | `/api/points/exchange` | `childId` | 孩子 | 孩子兑换 |

### 小游戏

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 70 | 游戏列表 | `/api/game/list` | 无 | 自己 | 浏览游戏 |
| 71 | 完成游戏 | `/api/game/complete` | `childId` | 孩子 | 孩子自己玩游戏 |
| 72 | 游戏历史 | `/api/game/history` | `childId` | 孩子 | 孩子自己的历史 |
| 73 | 最佳成绩 | `/api/game/best` | `childId` | 孩子 | 孩子自己的成绩 |
| 74 | 排行榜 | `/api/game/leaderboard` | 无 | 自己 | 全局排行榜 |

### 营养与饮食

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 75 | 食谱推荐 | `/api/meal/recommend` | 无 | 自己 | 推荐食谱 |
| 76 | 饮食日志 | `/api/meal/logs` | 无 | 自己 | 自己的饮食日志 |
| 77 | 营养摄入统计 | `/api/meal/nutrition/summary` | 无 | 自己 | 自己的营养统计 |
| 78 | 食材推荐指数 | `/api/food/recommendation/index` | 无 | 自己 | 食材推荐 |
| 79 | 营养偏好 | `/api/nutrition/profile/get` | 无 | 自己 | 自己的偏好 |
| 80 | 维度推荐商品 | `/api/recommend/dimension-products` | **`memberId`** | 家长 | 为某成员推荐商品 |
| 81 | 营养知识库 | `/api/nutrition/beijing/kb/list` | 无 | 自己 | 知识库浏览 |

### 心理与情绪

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 82 | 情绪打卡 | `/api/mind/checkin/create` | `childId` | 孩子 | 孩子自己打卡 |
| 83 | 情绪列表 | `/api/mind/checkin/list` | `childId` | 孩子 | 孩子自己的情绪 |
| 84 | 最新情绪 | `/api/mind/checkin/latest` | `childId` | 孩子 | 孩子最新情绪 |
| 85 | 情绪趋势 | `/api/mind/checkin/trend` | `childId` | 孩子 | 孩子情绪趋势 |
| 86 | 情绪统计 | `/api/mind/checkin/stats` | `childId` | 孩子 | 孩子情绪统计 |
| 87 | 筛查历史 | `/api/mind/screening/history` | `childId` | 孩子 | 孩子筛查历史 |
| 88 | 心理运势 | `/api/mind/fortune` | 无 | 自己 | 自己的运势 |
| 89 | EMI报告 | `/api/mind/emireport/latest` | `childId` | 孩子 | 孩子EMI报告 |

### 身体健康检测

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 90 | 健康报告列表 | `/api/health/report/list` | `childId` | 家长 | 某孩子的报告 |
| 91 | 最新报告 | `/api/health/report/latest` | `childId` | 家长 | 某孩子的最新报告 |
| 92 | 指标明细 | `/api/health/indicator/list` | `childId` | 家长 | 某孩子的指标 |
| 93 | 营养缺乏分析 | `/api/health/nutrition/deficiency` | `childId` | 家长 | 某孩子的营养分析 |
| 94 | 上传PDF报告 | `/api/growth/record/upload-and-parse` | `childId` | 家长 | 上传某孩子的报告 |

### 活动管理

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 95 | 活动列表 | `/api/activity/list` | 无 | 自己 | 浏览活动 |
| 96 | 活动详情 | `/api/activity/detail` | 无 | 自己 | 查看详情 |
| 97 | 活动报名 | `/api/activity/register` | `childId` | 家长 | 为某孩子报名 |
| 98 | 取消报名 | `/api/activity/cancel-registration` | `childId` | 家长 | 取消某孩子的报名 |
| 99 | 我的报名 | `/api/activity/my-registrations` | `childId` | 自己 | 自己的报名记录 |
| 100 | 活动签到 | `/api/activity/checkin` | `childId` | 自己 | 报的谁谁签到，不需要选人 |
| 101 | 活动评价提交 | `/api/activity/feedback/submit` | `childId` | 自己 | 参加者评价 |
| 102 | 活动评价列表 | `/api/activity/feedback/list` | 无 | 自己 | 查看评价 |

### 内容与媒体

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 103 | 文章列表 | `/api/articles/list` | 无 | 自己 | 浏览文章 |
| 104 | 文章分类 | `/api/articles/categories` | 无 | 自己 | 浏览分类 |
| 105 | 精选文章 | `/api/articles/featured` | 无 | 自己 | 浏览精选 |
| 106 | 每日贴士 | `/api/articles/daily-tip` | 无 | 自己 | 浏览贴士 |
| 107 | 我的分享 | `/api/share/my` | 无 | 自己 | 自己的分享 |
| 108 | 保存文字记录 | `/api/media/upload-text` | 无 | 自己 | 自己记录 |

### AI助手

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 109 | AI会话列表 | `/api/ai/conversations` | 无 | 自己 | 自己的会话 |
| 110 | AI管家会话 | `/api/ai/butler/sessions` | 无 | 自己 | 自己的管家 |

### 会员与订阅

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 111 | 会员等级 | `/api/membership/levels` | 无 | 自己 | 查看等级 |
| 112 | 我的会员 | `/api/membership/my` | 无 | 自己 | 自己的会员 |
| 113 | 订阅状态 | `/api/membership/subscription` | 无 | 自己 | 自己的订阅 |

### 管理后台

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 114 | 用户管理 | `/api/admin/users` | 无 | 管理员 | 管理用户 |
| 115 | 家庭管理 | `/api/admin/families` | 无 | 管理员 | 管理家庭 |
| 116 | 任务管理 | `/api/admin/tasks` | 无 | 管理员 | 管理任务 |
| 117 | 商品管理 | `/api/admin/product/*` | 无 | 管理员 | 管理商品 |
| 118 | 订单管理 | `/api/admin/product/order/*` | 无 | 管理员 | 管理订单 |
| 119 | 规划师审核 | `/api/admin/guide/*` | 无 | 管理员 | 审核规划师 |

### 规划师体系

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 120 | 我的信息 | `/api/guide/my` | 无 | 规划师 | 自己的信息 |
| 121 | 绑定家庭 | `/api/guide/families/bound-families` | 无 | 规划师 | 自己的绑定 |
| 122 | 家庭任务概览 | `/api/guide/families/{familyId}/overview` | 无 | 规划师 | 某家庭概览 |
| 123 | 孩子任务 | `/api/guide/families/{familyId}/children/{childId}/tasks` | `childId` | 规划师 | 某孩子的任务 |
| 124 | 批量审核 | `/api/guide/families/{familyId}/tasks/batch-review` | 无 | 规划师 | 批量审核 |
| 125 | 训练方案 | `/api/guide/training-plans/*` | 无 | 规划师 | 管理方案 |
| 126 | 活动管理 | `/api/guide/activities/*` | 无 | 规划师 | 管理活动 |

### 管家服务

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 127 | 管家档案 | `/api/butler/profile` | 无 | 管家 | 自己的档案 |
| 128 | 家庭成员列表 | `/api/butler/members` | 无 | 管家 | 管家的成员 |

### 营养师管理

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 129 | 营养师状态 | `/api/nutritionist/status` | 无 | 营养师 | 自己的状态 |
| 130 | 营养师申请 | `/api/nutritionist/apply` | 无 | 自己 | 申请成为营养师 |

### 圈子与联系人

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 131 | 我的圈子 | `/api/circle/my-circles` | **`memberId`** | 自己 | 某成员的圈子 |
| 132 | 发现圈子 | `/api/circle/discover` | `childId` | 孩子 | 孩子发现圈子 |
| 133 | 联系人列表 | `/api/contact/list` | 无 | 自己 | 自己的联系人 |
| 134 | 家庭挑战 | `/api/family/challenge/list` | `childId` | 孩子 | 孩子的挑战 |

### 知识库与邀请

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 135 | 知识库列表 | `/api/admin/knowledge-base/list` | 无 | 管理员 | 管理知识 |
| 136 | 生成邀请码 | `/api/invite/code/generate` | 无 | 自己 | 生成邀请码 |
| 137 | 邀请列表 | `/api/invite/list` | 无 | 自己 | 邀请记录 |
| 138 | 里程碑列表 | `/api/invite/milestone/list` | 无 | 自己 | 邀请里程碑 |

### 其他功能

| # | 功能 | 接口 | 当前参数 | 操作者 | 说明 |
|---|------|------|---------|--------|------|
| 139 | 吉祥物 | `/api/user/mascot/get` | 无 | 自己 | 自己的吉祥物 |
| 140 | 每日反馈 | `/api/feedback/today` | `childId` | 孩子 | 孩子自己的反馈 |
| 141 | 引导进度 | `/api/onboarding/progress` | 无 | 自己 | 自己的引导 |

## 汇总速查

| 参数类型 | 接口数 | 典型功能 |
|---------|--------|---------|
| `childId`（孩子自己操作） | ~30 | 任务、游戏、积分、心愿、情绪、能量概览、健康报告、活动报名 |
| **`memberId`（可选成员）** | **~20** | **健康打卡、维度管理、生长记录、圈子、推荐、问卷** |
| 无参数（自己操作自己） | ~90 | 认证、家庭、商城、文章、AI、会员、管理后台 |