Просмотр исходного кода

docs: 更新成员选择分析 — 按childId/memberId/无参数分类列出全部141个功能接口

E2E Test Bot 3 месяцев назад
Родитель
Сommit
adba8a0964
1 измененных файлов с 287 добавлено и 151 удалено
  1. 287 151
      docs/analysis/member-selection-analysis.md

+ 287 - 151
docs/analysis/member-selection-analysis.md

@@ -1,151 +1,287 @@
-# 家庭成员选择能力分析
-
-## 背景
-
-系统从"亲子互动"模型演变为"独立用户+家庭成员"模型:
-- **家长** 和 **孩子** 都是独立用户(user),各自有自己的账号
-- 孩子作为 **家庭成员**(family_member)出现在家庭中
-- 家长的大部分操作是为自己,不需要选择目标
-- 但部分操作需要 **选择为哪个家庭成员执行**(不限于孩子,可能是配偶、老人等)
-
-## 参数命名规范
-
-| 参数名 | 语义 | 适用范围 |
-|--------|------|---------|
-| `childId` | 孩子用户ID(user.id) | 旧接口,仅限"孩子"角色 |
-| `memberId` | 家庭成员ID(family_member.id) | 新接口,可以是任何家庭成员 |
-| `familyMemberId` | 同 memberId | 少数接口使用 |
-
-## 功能分类分析
-
-### 第一类:已支持选择成员(memberId),无需改动 ✅
-
-这些接口已经使用 `memberId` 参数,可以指定任何家庭成员:
-
-| 功能 | 接口 | 当前参数 | 说明 |
-|------|------|---------|------|
-| 家庭成员切换 | `POST /api/family/member/switch` | `memberId` | 切换到指定成员视图 |
-| 家庭关系问卷 | `POST /api/family/questionnaire/generate` | `memberId` | 为指定成员生成问卷 |
-| 五维分数历史 | `POST /api/energy/score-history` | `memberId, memberType` | 查询指定成员的历史分数 |
-| 维度概览 | `POST /api/dimension/overview` | `memberId` | 指定成员的维度数据 |
-| 维度历史 | `POST /api/dimension/history` | `memberId` | 指定成员的维度历史 |
-| 健康打卡日报 | `POST /api/daily/checkin/list` | `memberId` | 指定成员的打卡记录 |
-| 生长记录 | `POST /api/health/growth/list` | `memberId` | 指定成员生长记录 |
-| 饮食打卡 | `POST /api/health/meal/create` | `memberId` | 指定成员饮食记录 |
-| 睡眠打卡 | `POST /api/health/sleep/create` | `memberId` | 指定成员睡眠记录 |
-| 运动打卡 | `POST /api/health/exercise/create` | `memberId` | 指定成员运动记录 |
-| 喝水打卡 | `POST /api/health/water/create` | `memberId` | 指定成员喝水记录 |
-| 冥想打卡 | `POST /api/health/meditation/create` | `memberId` | 指定成员冥想记录 |
-| 圈子列表 | `POST /api/circle/my-circles` | `memberId` | 指定成员的圈子 |
-| 富维度详情 | `POST /api/energy/wealth-detail` | `memberId, memberType` | 指定成员财富详情 |
-| 商品推荐 | `POST /api/recommend/dimension-products` | `memberId` | 指定成员推荐商品 |
-| 传统镜鉴 | `POST /api/mind/traditional-mirror` | `memberId` | 指定成员传统测评 |
-| 家族属性 | `POST /api/family/attribute` | `memberId` | 指定成员属性 |
-| 家族属性上传 | `POST /api/family/attribute/upload` | `memberId` | 指定成员属性上传 |
-| 天盘运势 | `POST /api/tianpan/fortune` | `memberId` | 指定成员运势 |
-
-### 第二类:使用 childId 但应当支持选择成员 ⚠️
-
-这些接口目前使用 `childId`(仅限孩子),但业务上家长应该可以为 **任何家庭成员** 操作:
-
-| 功能 | 接口 | 当前参数 | 应改为 | 理由 |
-|------|------|---------|--------|------|
-| **健康报告上传** | `POST /api/health/report/upload-and-parse` | `childId` | `memberId` | 家长可以为任何家庭成员上传健康报告(老人、配偶等)|
-| **健康报告列表** | `POST /api/health/report/list` | `childId` | `memberId` | 查看任何家庭成员的健康报告 |
-| **健康指标明细** | `POST /api/health/indicator/list` | `childId` | `memberId` | 查看任何成员的健康指标 |
-| **营养缺乏分析** | `POST /api/health/nutrition/deficiency` | `childId` | `memberId` | 分析任何成员的营养状况 |
-| **活动报名** | `POST /api/activity/register` | `childId` | `memberId` | 家长可以为任何家庭成员报名活动 |
-| **活动我的报名** | `POST /api/activity/my-registrations` | `childId` | `memberId` | 查看任何成员的报名记录 |
-| **活动签到** | `POST /api/activity/checkin` | `childId` | `memberId` | 任何家庭成员签到 |
-| **活动评价** | `POST /api/activity/feedback/submit` | `childId` | `memberId` | 任何家庭成员提交评价 |
-| **测评订单创建** | `POST /api/dan-assessment/order/create` | `childId` | `memberId` | 可以为任何家庭成员购买测评 |
-| **测评最新结果** | `POST /api/assessment/latest-result` | `childId` | `memberId` | 查看任何成员的测评结果 |
-| **测评历史** | `POST /api/assessment/history` | `childId` | `memberId` | 查看任何成员的历史测评 |
-| **家长自评** | `POST /api/parent/assessment/create` | `childId` | `memberId` | 为任何家庭成员创建自评 |
-| **成长档案创建** | `POST /api/growth/record/create` | `childId` | `memberId` | 为任何家庭成员创建档案 |
-| **成长档案列表** | `GET /api/growth/record/list` | `childId` | `memberId` | 查看任何成员的档案 |
-| **成长计划创建** | `POST /api/growth/plan/create` | `childId` | `memberId` | 为任何家庭成员制定计划 |
-| **成长计划列表** | `GET /api/growth/plan/child/{childId}` | `childId` | `memberId` | 查看任何成员的计划 |
-| **每日反馈** | `POST /api/feedback/today` | `childId` | `memberId` | 任何成员的每日反馈 |
-| **健康时间线** | `POST /api/health/timeline/list` | `childId` | `memberId` | 任何成员的健康时间线 |
-| **健康预警** | `POST /api/health/alert/list` | `childId` | `memberId` | 任何成员的健康预警 |
-| **健康积分** | `POST /api/health/score/overview` | `childId` | `memberId` | 任何成员的健康积分 |
-| **健康打卡综合** | `POST /api/daily/checkin/comprehensive` | `childId` | `memberId` | 任何成员的综合打卡 |
-
-### 第三类:使用 childId,适合保持为"孩子" ✅
-
-这些操作是孩子特有的(如游戏、能量、任务执行),不适合扩展到其他家庭成员:
-
-| 功能 | 接口 | 理由 |
-|------|------|------|
-| **能量概览/流水** | `POST /api/energy/overview` | 能量系统是孩子成长体系的一部分 |
-| **能量发放/扣除** | `POST /api/energy/grant` | 能量发放是针对孩子的任务奖励 |
-| **任务创建/执行** | `POST /api/tasks/create` | 任务是亲子任务体系,针对孩子 |
-| **今日任务列表** | `POST /api/tasks/today` | 同上 |
-| **完成任务** | `POST /api/tasks/{id}/complete` | 同上 |
-| **任务历史** | `POST /api/tasks/history` | 同上 |
-| **小游戏** | `POST /api/game/*` | 小游戏是孩子专属功能 |
-| **积分兑换** | `POST /api/points/*` | 积分是孩子奖励体系 |
-| **心愿** | `POST /api/wishes/*` | 心愿是孩子专属功能 |
-| **情绪打卡** | `POST /api/mind/checkin/*` | 情绪管理是孩子成长体系 |
-| **心理筛查** | `POST /api/mind/screening/*` | 心理测评是孩子专属 |
-| **微行动** | `POST /api/micro-action/*` | 微行动是孩子行为养成 |
-| **数学游戏** | `POST /api/wisdom/math/*` | 益智游戏是孩子专属 |
-| **家庭挑战** | `POST /api/family/challenge/*` | 挑战是孩子参与 |
-| **勋章成就** | `POST /api/badge/*` | 勋章是孩子成就体系 |
-
-### 第四类:家长自己操作,不需要选择 ✅
-
-这些操作是家长自己的,不需要选择目标成员:
-
-| 功能 | 理由 |
-|------|------|
-| 认证登录 | 自己的账号 |
-| 家庭管理 | 管理自己的家庭 |
-| 我的信息 | 自己的信息 |
-| 商城购物 | 自己的购物车和订单 |
-| 收货地址 | 自己的地址 |
-| 文章浏览 | 自己的阅读 |
-| AI助手 | 自己的对话 |
-| 会员订阅 | 自己的会员 |
-| 推广邀请 | 自己的推广 |
-| 佣金管理 | 自己的佣金 |
-
-## 建议改造方案
-
-### 第一阶段:高优先级(影响用户体验最大)
-
-| 优先级 | 功能 | 改动量 | 说明 |
-|--------|------|--------|------|
-| 🔴 P0 | 活动报名/签到/评价 | 小 | 将 `childId` → `memberId`,前端增加家庭成员选择器 |
-| 🔴 P0 | 健康报告上传/查看 | 中 | 同上,涉及 PDF 解析逻辑中的 childId 引用 |
-| 🔴 P0 | 测评订单/结果查看 | 中 | 涉及测评订单的 childId 字段 |
-
-### 第二阶段:中优先级
-
-| 优先级 | 功能 | 改动量 | 说明 |
-|--------|------|--------|------|
-| 🟡 P1 | 成长档案/计划 | 中 | 涉及 GrowthRecord/GrowthPlan 实体中的 childId |
-| 🟡 P1 | 每日反馈/健康时间线 | 小 | 参数替换 |
-| 🟡 P1 | 营养缺乏分析 | 小 | 参数替换 |
-
-### 第三阶段:低优先级
-
-| 优先级 | 功能 | 改动量 | 说明 |
-|--------|------|--------|------|
-| 🟢 P2 | 健康打卡系列 | 小 | 已部分使用 memberId,统一规范 |
-| 🟢 P2 | 家长自评 | 小 | 参数替换 |
-
-## 前端改造要点
-
-1. **家庭成员选择器组件**:在需要选择成员的操作前,增加一个通用的家庭成员选择弹窗
-2. **默认行为**:如果用户只有一个孩子,默认选中;如果有多个成员,弹出选择
-3. **缓存选择**:在同一个操作流程中记住上一次选择的成员
-4. **权限控制**:家长可以为所有家庭成员操作;孩子只能为自己操作
-
-## 后端改造要点
-
-1. 统一参数命名:新接口统一使用 `memberId`,废弃 `childId` 参数
-2. 兼容性:旧接口保留 `childId` 参数,内部映射为 `memberId`
-3. 权限校验:校验 `memberId` 是否属于当前用户的家庭
-4. 数据迁移:`growth_records.child_id` → `family_member_id` 等字段对齐
+# 所有功能接口参数分析
+
+> 请逐项判断:**哪些功能应该支持选择家庭成员(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、会员、管理后台 |