瀏覽代碼

docs: 登记管家自选与健康教练接口文档

iwt 3 周之前
父節點
當前提交
fa03284434
共有 2 個文件被更改,包括 13 次插入5 次删除
  1. 4 4
      docs/superpowers/PROJECT-OVERVIEW.md
  2. 9 1
      docs/superpowers/api/API_REFERENCE.md

+ 4 - 4
docs/superpowers/PROJECT-OVERVIEW.md

@@ -2,7 +2,7 @@
 
 **文档版本:** v2.9
 **日期:** 2026-08-23
-**状态:** 已确认(v2.1 Phase 2-4 全栈完成)+ 虚拟支付改造(Tasks 1-12 已完成,退款闭环实施中)+ 新用户注册引导(12 Tasks 全栈完成)+ 家庭成员关系条增强(✅ 已实施)+ TabBar 重构(✅ 4Tab + 中间五维启动器,已提交)+ **LIFETIME 终身会员(✅ 11 Tasks 全栈完成)** + **健康数据中心(✅ 全栈完成)** + **SKU 价格单位统一分 + 规格选择响应式修复(✅ 7 Tasks 全栈完成)** + **AI健康教练人格分化与管家自助选择(🔄 实施中,11 Tasks)**
+**状态:** 已确认(v2.1 Phase 2-4 全栈完成)+ 虚拟支付改造(Tasks 1-12 已完成,退款闭环实施中)+ 新用户注册引导(12 Tasks 全栈完成)+ 家庭成员关系条增强(✅ 已实施)+ TabBar 重构(✅ 4Tab + 中间五维启动器,已提交)+ **LIFETIME 终身会员(✅ 11 Tasks 全栈完成)** + **健康数据中心(✅ 全栈完成)** + **SKU 价格单位统一分 + 规格选择响应式修复(✅ 7 Tasks 全栈完成)** + **AI健康教练人格分化与管家自助选择(✅ 11 Tasks 全栈完成)**
 **维护:** 所有需求变更需更新本文档
 
 ---
@@ -210,7 +210,7 @@
 | 订阅+推广核心实施(P0) | `plans/2026-07-09-family-membership-core.md` |
 | AI健康管家+推荐引擎(P1) | `plans/2026-07-22-comprehensive-implementation.md`(Phase 2 Wave 3) |
 | **LIFETIME 终身会员(方案A:等级扩展+实时聚合+管理员审核)** | `specs/2026-08-07-xaf-partner-ppt-redesign-design.md` + `plans/2026-08-09-lifetime-membership.md` |
-| **AI健康教练人格分化与管家自助选择**(L2 自助绑管/换绑 + 浠宝/福宝人格话术 + 管理端分配管理与停接开关) 🔄 实施中 | `specs/2026-08-23-coach-butler-design.md` + `plans/2026-08-23-coach-butler.md` |
+| **AI健康教练人格分化与管家自助选择**(L2 自助绑管/换绑 + 浠宝/福宝人格话术 + 管理端分配管理与停接开关) ✅ 已完成 | `specs/2026-08-23-coach-butler-design.md` + `plans/2026-08-23-coach-butler.md` |
 
 ---
 
@@ -358,7 +358,7 @@
 | `2026-08-18-homepage-health-funnel-design.md` | ✅ 已实施(四段式漏斗:了解区自测卡/发现区沙盘+上传报告/行动区聚合/内容区降级;未登录态零改动) | 首页重构 — 主动健康漏斗(了解→发现→改变) |
 | `2026-08-13-health-status-survey-design.md` | 🔄 v2 设计已定稿(2026-08-18;v1 已实施;v2 疾病史两源预置清单+确诊时间+服药时长) | 当前状态调研 — 健康现状档案 |
 | `2026-08-18-health-status-survey-v2.md` | 🟢 已实施(单文件改 health-status-form.vue;8 组 54 项预置清单分类多选+确诊时间;用药年月+时长自动计算;后端零变更;v1 旧数据兼容) | 当前状态调研 — 健康现状档案 v2 |
-| `2026-08-23-coach-butler-design.md` | 🔄 实施中 | AI健康教练人格分化(浠宝/福宝话术路由)与 L2 家庭管家自助选择设计 |
+| `2026-08-23-coach-butler-design.md` | ✅ 已实施 | AI健康教练人格分化(浠宝/福宝话术路由)与 L2 家庭管家自助选择设计 |
 | `api/API_REFERENCE.md` | 🟢 已建立(2026-08-18;200+ 接口清单;废弃接口标注;新增接口检查流程) | 后台接口参考文档 |
 
 ### 实施计划(plans/)
@@ -430,7 +430,7 @@
 | `2026-08-10-unlock-gates-implementation.md` | 🟡 待实施 | 通关解锁功能实施计划(三关递进:自检→个人沙盘/邀请→全家沙盘/创建→微行动;沙盘个人全家切换;8种判定+奖励发放;增值关卡购物/会员/报告;管理端关卡配置) |
 | `2026-08-15-daily-task-overview.md` | 🟡 待实施 | 今日任务首页卡片实施计划(仅小程序接入 + 1个只读聚合接口 `/api/daily-task/overview`,聚合打卡/任务/阅读活动/测评报告四类,点击跳转+返回自动刷新;设计稿:2026-08-15-daily-task-overview-design.md) |
 | `2026-08-15-sku-price-cents-and-spec-selector.md` | ✅ 已实施(7 Tasks:实体/DTO/订单/购物车/迁移/管理端/小程序,5 commits) | SKU 规格价格统一分单位 + 详情页规格按钮修复实施计划 |
-| `2026-08-23-coach-butler.md` | 🔄 实施中(11 Tasks:DB迁移/实体Mapper/Service/控制器×2/AI注入/LangGraph路由/小程序/Web管理端/文档验收) | AI健康教练人格分化与管家自助选择实施计划(设计稿:2026-08-23-coach-butler-design.md) |
+| `2026-08-23-coach-butler.md` | ✅ 已完成(11 Tasks:DB迁移/实体Mapper/Service/控制器×2/AI注入/LangGraph路由/小程序/Web管理端/文档验收) | AI健康教练人格分化与管家自助选择实施计划(设计稿:2026-08-23-coach-butler-design.md) |
 
 ### 计划与设计文档(specs/)
 

+ 9 - 1
docs/superpowers/api/API_REFERENCE.md

@@ -323,7 +323,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/ai/chat/messages` | 消息列表 |
 | `POST /api/ai/chat/conversations/{id}/delete` | 删除对话 |
 | `POST /api/ai/nutrition/send` | 营养对话 |
-| `POST /api/ai/health-coach/send` | 健康教练 |
+| `POST /api/ai/health-coach/send` | 健康教练(请求体可选字段 `coach_id` 由服务端自动注入,客户端无需传;LangGraph 按 xibao/fubao 三级回退路由话术) |
 | `POST /api/ai/butler/send` | 管家对话 |
 | `POST /api/ai/context` | 上下文管理 |
 | `POST /api/butler/sessions/create` | 创建会话 |
@@ -634,6 +634,14 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 6. mvn clean compile 验证
 ```
 
+### 4.30 家庭管家选择(`/api/butler/*`)
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/butler/available-list` | 可选管家列表(浏览开放,脱敏;仅 L2 有效订阅家庭可绑定) |
+| `POST /api/butler/my-butler` | 我家当前管家绑定信息(含管家昵称/等级/分配时间) |
+| `POST /api/butler/select` | 绑定/更换管家(校验 L2 订阅、管家容量与接单状态;换绑自动解绑旧关系) |
+
 ---
 
 ## 六、待清理的废弃接口