docs: 先天画像体系实现完成 - 更新API文档与项目概览

docs/superpowers/PROJECT-OVERVIEW.md

@@ -361,6 +361,7 @@
 | `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-28-plan-standard-content-design.md` | 🟢 已实施 | 生成方案标准内容格式（plan_json.sections[].tasks 唯一事实源 + LangGraph prompt tasks 输出 + Pydantic 校验 + 正则兜底 + 存量懒加载回填 + 规划师端结构化任务编辑 UI） |
+| `2026-08-28-innate-portrait-mind-dimension-design.md` | ✅ 已实施（迁移270-272/3实体/3Mapper/7DTO/2Controller/Service+Agent/前端2页+路由） | 星座/八字/血型/数字能量引入心维度先天画像体系 — 先天画像聚合层、可配置权重、AI解读+模板降级、成长轨迹打通、管理端配置化 |
 | `api/API_REFERENCE.md` | 🟢 已建立（2026-08-18；200+ 接口清单；废弃接口标注；新增接口检查流程） | 后台接口参考文档 |
 
 ### 实施计划（plans/）
@@ -434,6 +435,7 @@
 | `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-28-plan-standard-content.md` | ✅ 已实施（9 Tasks：LangGraph模型/prompt任务契约/Pydantic校验+正则兜底/regenerate/Java任务生成优先+懒加载回填/Java编译/cfc-web结构化任务编辑/小程序tasks回流/文档验收） | 生成方案标准内容格式实施计划（plan_json.sections[].tasks 唯一事实源；设计稿：2026-08-28-plan-standard-content-design.md） |
+| `2026-08-28-innate-portrait-mind-dimension.md` | ✅ 已实施（15 Tasks 全栈：迁移270-272/实体/Mapper/DTO/NumSoulCalculator TDD/Service/Controller×2/AiGateway/AiAgent/LangGraph/管理端2页/小程序2页/验证） | 先天画像体系实施计划（星座/八字/数字能量引入心维度；设计稿：2026-08-28-innate-portrait-mind-dimension-design.md） |
 
 ### 计划与设计文档（specs/）
 

docs/superpowers/api/API_REFERENCE.md

@@ -65,6 +65,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `MembershipController` | `/api/membership` | 会员 | — |
 | `SubscriptionController` | `/api/subscription` | 订阅 | — |
 | `AIChatController` | `/api/ai` | AI 对话 | — |
+| `InnatePortraitController` | `/api/mind/innate` | 先天画像（画像/AI解读/数字能量/成长轨迹） | — |
 | `ArticleController` | `/api/articles` | 文章 | — |
 | `NotificationController` | `/api/notification` | 通知 | — |
 | `StatsController` | `/api/stats` | 统计 | — |
@@ -406,6 +407,8 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `/api/admin/health-plan/*` | 健康方案管理（跨家庭列表/详情） |
 | `/api/admin/knowledge-base/*` | 知识库管理 |
 | `/api/admin/notices/*` | 公告管理 |
+| `/api/admin/innate-portrait-config/*` | 先天画像来源权重配置（list/update/invalidate） |
+| `/api/admin/numsoul-detail-config/*` | 数字能量详细配置（list/create/update/delete） |
 | `/api/admin/package-templates/*` | 套餐模板 |
 | `/api/admin/ppoint-config/*` | P点配置（品类级比例+商品级固定值） |
 | `/api/admin/product/*` | 商品管理 |
@@ -416,7 +419,28 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `/api/admin/unlock-gates/*` | 通关配置 |
 | `/api/migration/run` | 数据迁移 |
 
-### 4.14 统计与通知（`/api/stats`, `/api/notification`）
+### 4.14 先天画像（`/api/mind/innate/*`）
+
+> 五维能量体系"心维度"先天画像聚合接口，基于星座/八字/血型/数字能量生成，AI 解读失败时自动降级模板文案。
+
+| 路径 | 说明 |
+|------|------|
+| `POST /api/mind/innate/portrait` | 先天画像（聚合 mind_base_score + 数字能量详情 + 来源贡献明细） |
+| `POST /api/mind/innate/reading` | AI 解读（缓存到 innate_portrait_report，失败降级模板） |
+| `POST /api/mind/innate/numsoul` | 数字能量计算（生命灵数/天赋数/生日数/命运数） |
+| `POST /api/mind/innate/trajectory` | 先天+后天成长轨迹（EnergyBalance 后天能量对比） |
+
+**请求参数**（portrait/reading/trajectory）：
+```json
+{ "memberId": 123, "memberType": "child", "familyId": 1 }
+```
+
+**numsoul 请求参数**：
+```json
+{ "year": 1990, "month": 5, "day": 15 }
+```
+
+### 4.15 统计与通知（`/api/stats`, `/api/notification`）
 
 | 路径 | 说明 |
 |------|------|
@@ -428,7 +452,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/notification/list` | 通知列表 |
 | `POST /api/notification/read` | 标记已读 |
 
-### 4.15 报告模板管理（`/api/admin/report-template`）
+### 4.16 报告模板管理（`/api/admin/report-template`）
 
 | 路径 | 说明 |
 |------|------|
@@ -452,7 +476,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 }
 ```
 
-### 4.16 其他接口
+### 4.17 其他接口
 
 | 路径 | 说明 |
 |------|------|
@@ -466,13 +490,13 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/wealth/checkin/*` | 财富打卡 |
 | `POST /api/insurance/*` | 保险规划 |
 
-### 4.17 日常任务聚合（`/api/daily-task/*`）
+### 4.18 日常任务聚合（`/api/daily-task/*`）
 
 | 路径 | 说明 |
 |------|------|
 | `POST /api/daily-task/overview` | 今日任务总览（打卡/任务/阅读活动/测评报告四类聚合） |
 
-### 4.18 健康维度评分（`/api/dimension/*`）
+### 4.19 健康维度评分（`/api/dimension/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -481,7 +505,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/dimension/questionnaire` | 问卷提交维度评分 |
 | `POST /api/dimension/history` | 获取维度历史记录 |
 
-### 4.19 家庭成员关系质量（`/api/family/relationship/*`）
+### 4.20 家庭成员关系质量（`/api/family/relationship/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -491,7 +515,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/family/relationship/milestones` | 获取即将到来的里程碑 |
 | `POST /api/family/relationship/pairwise` | 获取以指定成员为中心的所有成员关系 |
 
-### 4.20 佣金管理（`/api/commission/*`）
+### 4.21 佣金管理（`/api/commission/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -503,7 +527,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/commission/team/list` | 团队成员列表 |
 | `POST /api/commission/funnel` | 佣金转化漏斗 |
 
-### 4.21 管理端-能量配置（`/api/admin/energy-config/*`）
+### 4.22 管理端-能量配置（`/api/admin/energy-config/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -514,7 +538,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/energy-config/daily-limit-save` | 保存每日能量限制 |
 | `POST /api/admin/energy-config/overview` | 能量配置总览（来源+限制） |
 
-### 4.22 管理端-公告（`/api/admin/notices/*`）
+### 4.23 管理端-公告（`/api/admin/notices/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -525,7 +549,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/notices/delete` | 删除公告（软删） |
 | `POST /api/admin/notices/pin` | 置顶公告 |
 
-### 4.23 管理端-成长规划师（`/api/admin/guide/*`）
+### 4.24 管理端-成长规划师（`/api/admin/guide/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -540,7 +564,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/guide/packages/{id}/update` | 更新套餐 |
 | `POST /api/admin/guide/packages/{id}/status` | 更新套餐状态 |
 
-### 4.24 管理端-商品（`/api/admin/product/*`）
+### 4.25 管理端-商品（`/api/admin/product/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -553,7 +577,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/product/copy` | 复制商品 |
 | `POST /api/admin/product/delete` | 删除商品 |
 
-### 4.25 管理端-成长档案关联商品（`/api/admin/growth-archive-product/*`）
+### 4.26 管理端-成长档案关联商品（`/api/admin/growth-archive-product/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -561,7 +585,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/growth-archive-product/detail` | 关联商品规则详情 |
 | `POST /api/admin/growth-archive-product/delete` | 删除关联商品规则 |
 
-### 4.26 管理端-电商供应商（`/api/admin/ecom-supplier/*`）
+### 4.27 管理端-电商供应商（`/api/admin/ecom-supplier/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -571,7 +595,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/ecom-supplier/update` | 更新供应商 |
 | `POST /api/admin/ecom-supplier/delete` | 删除供应商 |
 
-### 4.27 管理端-测评材料（`/api/admin/assessment/*`）
+### 4.28 管理端-测评材料（`/api/admin/assessment/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -583,7 +607,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/assessment/config` | 获取积分配置 |
 | `POST /api/admin/assessment/config/update` | 更新积分配置 |
 
-### 4.28 管理端-P点配置（`/api/admin/ppoint-config/*`）
+### 4.29 管理端-P点配置（`/api/admin/ppoint-config/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -597,7 +621,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/admin/ppoint-config/product/by-product` | 按商品ID获取P点 |
 | `POST /api/admin/ppoint-config/effective` | 获取商品综合有效P点值 |
 
-### 4.29 管理端-报告解析（`/api/admin/report-parser/*`）
+### 4.30 管理端-报告解析（`/api/admin/report-parser/*`）
 
 | 路径 | 说明 |
 |------|------|
@@ -635,7 +659,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 6. mvn clean compile 验证
 ```
 
-### 4.30 家庭管家选择（`/api/butler/*`）
+### 4.31 家庭管家选择（`/api/butler/*`）
 
 | 路径 | 说明 |
 |------|------|