docs: API参考文档补全13个Controller共65+接口及废弃状态更新

Ultrawwork with Sisyphus

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

docs/superpowers/api/API_REFERENCE.md

@@ -398,8 +398,14 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `/api/admin/dimension/*` | 维度配置 |
 | `/api/admin/dimension-config/*` | 维度权重 |
 | `/api/admin/energy/*` | 能量配置 |
+| `/api/admin/energy-config/*` | 五行能量来源/每日限制配置 |
+| `/api/admin/ecom-supplier/*` | 电商供应商管理 |
+| `/api/admin/guide/*` | 成长规划师管理（申请/套餐） |
+| `/api/admin/growth-archive-product/*` | 成长档案关联商品 |
 | `/api/admin/knowledge-base/*` | 知识库管理 |
+| `/api/admin/notices/*` | 公告管理 |
 | `/api/admin/package-templates/*` | 套餐模板 |
+| `/api/admin/ppoint-config/*` | P点配置（品类级比例+商品级固定值） |
 | `/api/admin/product/*` | 商品管理 |
 | `/api/admin/report-parser/*` | 报告解析配置 |
 | `/api/admin/report-template/*` | 报告展示模板管理 |
@@ -458,6 +464,156 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/wealth/checkin/*` | 财富打卡 |
 | `POST /api/insurance/*` | 保险规划 |
 
+### 4.17 日常任务聚合（`/api/daily-task/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/daily-task/overview` | 今日任务总览（打卡/任务/阅读活动/测评报告四类聚合） |
+
+### 4.18 健康维度评分（`/api/dimension/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/dimension/overview` | 获取健康维度概览（七维评分+百分位） |
+| `POST /api/dimension/upload` | 手动录入维度评分 |
+| `POST /api/dimension/questionnaire` | 问卷提交维度评分 |
+| `POST /api/dimension/history` | 获取维度历史记录 |
+
+### 4.19 家庭成员关系质量（`/api/family/relationship/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/family/relationship/scores` | 获取家庭成员关系质量评分 |
+| `POST /api/family/relationship/calculate` | 计算并保存关系质量评分 |
+| `POST /api/family/relationship/health-alerts` | 获取健康预警列表 |
+| `POST /api/family/relationship/milestones` | 获取即将到来的里程碑 |
+| `POST /api/family/relationship/pairwise` | 获取以指定成员为中心的所有成员关系 |
+
+### 4.20 佣金管理（`/api/commission/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/commission/summary` | 获取佣金汇总 |
+| `POST /api/commission/list` | 佣金流水列表 |
+| `POST /api/commission/team` | 团队统计（L1/L2） |
+| `POST /api/commission/stats` | 佣金统计面板 |
+| `POST /api/commission/balance` | 可提现余额详情 |
+| `POST /api/commission/team/list` | 团队成员列表 |
+| `POST /api/commission/funnel` | 佣金转化漏斗 |
+
+### 4.21 管理端-能量配置（`/api/admin/energy-config/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/energy-config/source-list` | 能量来源配置列表 |
+| `POST /api/admin/energy-config/source-save` | 保存能量来源配置（新增/更新） |
+| `POST /api/admin/energy-config/source-delete` | 删除能量来源配置 |
+| `POST /api/admin/energy-config/daily-limits` | 获取每日能量限制 |
+| `POST /api/admin/energy-config/daily-limit-save` | 保存每日能量限制 |
+| `POST /api/admin/energy-config/overview` | 能量配置总览（来源+限制） |
+
+### 4.22 管理端-公告（`/api/admin/notices/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/notices/list` | 公告列表（分页） |
+| `POST /api/admin/notices/all` | 全量公告列表 |
+| `POST /api/admin/notices/create` | 创建公告 |
+| `POST /api/admin/notices/update` | 更新公告 |
+| `POST /api/admin/notices/delete` | 删除公告（软删） |
+| `POST /api/admin/notices/pin` | 置顶公告 |
+
+### 4.23 管理端-成长规划师（`/api/admin/guide/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/guide/applications/pending` | 待审批规划师申请 |
+| `POST /api/admin/guide/applications/{id}/approve` | 审批通过 |
+| `POST /api/admin/guide/applications/{id}/reject` | 驳回申请 |
+| `POST /api/admin/guide/guides` | 获取所有成长规划师列表 |
+| `POST /api/admin/guide/guides/level/{level}` | 按级别获取规划师 |
+| `POST /api/admin/guide/guides/approved` | 获取已入驻（approved）的服务商列表 |
+| `POST /api/admin/guide/packages` | 获取所有套餐模板 |
+| `POST /api/admin/guide/packages/create` | 创建套餐 |
+| `POST /api/admin/guide/packages/{id}/update` | 更新套餐 |
+| `POST /api/admin/guide/packages/{id}/status` | 更新套餐状态 |
+
+### 4.24 管理端-商品（`/api/admin/product/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/product/list` | 商品列表（分页/筛选/搜索） |
+| `POST /api/admin/product/review` | 审核商品（approve/reject） |
+| `POST /api/admin/product/shelve` | 商品上下架 |
+| `POST /api/admin/product/detail` | 商品详情 |
+| `POST /api/admin/product/create` | 创建商品 |
+| `POST /api/admin/product/update` | 更新商品 |
+| `POST /api/admin/product/copy` | 复制商品 |
+| `POST /api/admin/product/delete` | 删除商品 |
+
+### 4.25 管理端-成长档案关联商品（`/api/admin/growth-archive-product/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/growth-archive-product/save` | 保存关联商品规则 |
+| `POST /api/admin/growth-archive-product/detail` | 关联商品规则详情 |
+| `POST /api/admin/growth-archive-product/delete` | 删除关联商品规则 |
+
+### 4.26 管理端-电商供应商（`/api/admin/ecom-supplier/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/ecom-supplier/list` | 供应商列表（分页/搜索） |
+| `POST /api/admin/ecom-supplier/all` | 所有供应商（下拉选择） |
+| `POST /api/admin/ecom-supplier/save` | 创建供应商 |
+| `POST /api/admin/ecom-supplier/update` | 更新供应商 |
+| `POST /api/admin/ecom-supplier/delete` | 删除供应商 |
+
+### 4.27 管理端-测评材料（`/api/admin/assessment/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/assessment/materials` | 测评资料列表 |
+| `POST /api/admin/assessment/materials/{id}` | 测评资料详情 |
+| `POST /api/admin/assessment/materials/create` | 创建测评资料 |
+| `POST /api/admin/assessment/materials/{id}/update` | 更新测评资料 |
+| `POST /api/admin/assessment/materials/{id}/delete` | 删除测评资料（软删） |
+| `POST /api/admin/assessment/config` | 获取积分配置 |
+| `POST /api/admin/assessment/config/update` | 更新积分配置 |
+
+### 4.28 管理端-P点配置（`/api/admin/ppoint-config/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/ppoint-config/category/list` | 品类级P点比例列表 |
+| `POST /api/admin/ppoint-config/category/save` | 保存品类级P点比例 |
+| `POST /api/admin/ppoint-config/category/delete` | 删除品类级P点比例 |
+| `POST /api/admin/ppoint-config/category/by-category` | 按品类ID获取P点比例 |
+| `POST /api/admin/ppoint-config/product/list` | 商品级P点列表 |
+| `POST /api/admin/ppoint-config/product/save` | 保存商品级P点 |
+| `POST /api/admin/ppoint-config/product/delete` | 删除商品级P点 |
+| `POST /api/admin/ppoint-config/product/by-product` | 按商品ID获取P点 |
+| `POST /api/admin/ppoint-config/effective` | 获取商品综合有效P点值 |
+
+### 4.29 管理端-报告解析（`/api/admin/report-parser/*`）
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/admin/report-parser/types` | 报告类型列表 |
+| `POST /api/admin/report-parser/types/save` | 保存/更新报告类型 |
+| `POST /api/admin/report-parser/types/toggle` | 启用/停用报告类型 |
+| `POST /api/admin/report-parser/types/delete` | 删除报告类型 |
+| `POST /api/admin/report-parser/fingerprints/list` | 指纹规则列表 |
+| `POST /api/admin/report-parser/fingerprints/save` | 保存指纹规则 |
+| `POST /api/admin/report-parser/fingerprints/delete` | 删除指纹规则 |
+| `POST /api/admin/report-parser/imports` | 导入记录列表 |
+| `POST /api/admin/report-parser/imports/import` | 上传导入包 |
+| `POST /api/admin/report-parser/imports/approve` | 审批导入 |
+| `POST /api/admin/report-parser/imports/reject` | 驳回导入 |
+| `POST /api/admin/report-parser/unknown-clusters` | 未知报告聚类列表 |
+| `POST /api/admin/report-parser/unknown-uploads` | 聚类上传记录 |
+| `POST /api/admin/report-parser/generate-type` | 自学习生成报告类型 |
+
 ---
 
 ## 五、新增接口流程
@@ -481,15 +637,16 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 
 ## 六、待清理的废弃接口
 
-| Controller | 废弃接口 | 替代方案 | 清理条件 |
-|------------|----------|----------|----------|
-| `FamilyController` | `/invite-code`, `/invite-code/generate` | `/api/family/invite/generate` | 确认前端无调用 |
-| `FamilyUserController` | `/switch-mode`, `/switch-to-child`, `/switch-back-to-parent`, `/switch-back-verify` | `/api/family/member/switch` | 确认前端无调用 |
-| `ButlerController` | `/service-records`, `/commissions` | — | 无替代，可删除 |
-| `TeacherController` | 全部 `/api/teacher/*` 方法 | `/api/guide/families/*` | 确认规划师端无调用 |
-| `DanAssessmentController` | `/current`（获取当前测评） | — | 无前端调用方 |
-| `NoticeController` | `GET /list`（违反 POST 规范） | — | 重构为 POST |
+| Controller | 废弃接口 | 替代方案 | 当前状态 | 清理条件 |
+|------------|----------|----------|----------|----------|
+| `FamilyController` | `/invite-code`, `/invite-code/generate` | `/api/family/invite/generate` | @Deprecated + 410 ✓ | 确认前端无调用 |
+| `FamilyUserController` | `/switch-mode`, `/switch-to-child` | `/api/family/member/switch` | @Deprecated + 410 ✓ | 确认前端无调用 |
+| `FamilyUserController` | `/switch-back-to-parent`, `/switch-back-verify` | `/api/family/member/switch` | 已修复：@Deprecated + 410 | 确认前端无调用 |
+| `ButlerController` | `/service-records`, `/commissions` | — | @Deprecated + 410 ✓ | 可删除 |
+| `TeacherController` | 全部 `/api/teacher/*` 方法 | `/api/guide/families/*` | @Deprecated + UnsupportedOperationException | 确认规划师端无调用 |
+| `DanAssessmentController` | `/current` | — | 需验证 | 无前端调用方 |
+| `NoticeController` | `GET /list`（违反 POST 规范） | `/api/admin/notices/list` | 已修复：@Deprecated + 410 | 可删除 |
 
 ---
 
-*文档最后更新：2026-08-22*
+*文档最后更新：2026-08-23*