chore: auto bump version and changelog [skip ci]

cfc-web/.last_build_commit

@@ -1 +1 @@
-4c194577fce8f4cc5e0845926089a42645e986f1
+130228b4dc279464571d7b078ba531f66fdc2c3b

cfc-web/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "cfc-web",
-  "version": "1.0.561",
+  "version": "1.0.562",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "cfc-web",
-      "version": "1.0.561",
+      "version": "1.0.562",
       "dependencies": {
         "@wangeditor/editor": "^5.1.23",
         "@wangeditor/editor-for-vue": "^1.0.2",

cfc-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cfc-web",
-  "version": "1.0.562",
+  "version": "1.0.563",
   "private": true,
   "scripts": {
     "dev": "vue-cli-service serve",

cfc-web/public/CHANGELOG-v1.0.md

@@ -4,6 +4,17 @@
 
 ---
 
+## v1.0.563 (2026-07-26)
+
+### 新功能
+- 行首页 OctopusGraph → 圈子区块替换
+
+### 其他
+- - cfc-frontend/pages/action/index.vue: 移除 OctopusGraph 组件, 新增「我的圈子+发现推荐」区块
+- - docs: 设计文档 + 实现计划
+- 
+
+
 ## v1.0.562 (2026-07-26)
 
 ### Bug 修复

cfc-web/public/CHANGELOG.md

@@ -1,6 +1,6 @@
 # 更新日志
 
-> 当前版本: v1.0.562
+> 当前版本: v1.0.563
 
 ## 历史版本
 
@@ -8,6 +8,17 @@
 
 ---
 
+## v1.0.563 (2026-07-26)
+
+### 新功能
+- 行首页 OctopusGraph → 圈子区块替换
+
+### 其他
+- - cfc-frontend/pages/action/index.vue: 移除 OctopusGraph 组件, 新增「我的圈子+发现推荐」区块
+- - docs: 设计文档 + 实现计划
+- 
+
+
 ## v1.0.562 (2026-07-26)
 
 ### Bug 修复

docs/flows/activity-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 活动管理
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,94 +11,98 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 活动创建（活动管理员）
-        A1(("活动管理员")) --> A2[创建活动 /create]
-        A2 --> A3[设置基本信息：标题/描述/封面/维度]
-        A3 --> A4[设置活动类型 offline/online/campaign]
-        A4 --> A5[设置时间地点：开始/结束/位置]
-        A5 --> A6[设置报名规则]
-        A6 --> A7{是否限制人数?}
-        A7 -->|是| A8[设置最大人数 maxParticipants]
+        A1(("🔧 活动管理员")):::portAdmin --> A2[🖥 创建活动 /create]:::portAdmin
+        A2 --> A3[🖥 设置基本信息：标题/描述/封面/维度]:::portAdmin
+        A3 --> A4[🖥 设置活动类型 offline/online/campaign]:::portAdmin
+        A4 --> A5[🖥 设置时间地点：开始/结束/位置]:::portAdmin
+        A5 --> A6[🖥 设置报名规则]:::portAdmin
+        A6 --> A7{🖥 是否限制人数?}:::portAdmin
+        A7 -->|是| A8[🖥 设置最大人数 maxParticipants]:::portAdmin
         A7 -->|否| A9[不限制人数]
-        A8 --> A10[设置价格体系]
+        A8 --> A10[🖥 设置价格体系]:::portAdmin
         A9 --> A10
-        A10 --> A11[普通价 price]
-        A11 --> A12[会员价 memberPrice]
-        A12 --> A13[签到积分 checkinPoints]
-        A13 --> A14[设置可见范围 public/restricted/member]
-        A14 --> A15[保存草稿]
+        A10 --> A11[🖥 普通价 price]:::portAdmin
+        A11 --> A12[🖥 会员价 memberPrice]:::portAdmin
+        A12 --> A13[🖥 签到积分 checkinPoints]:::portAdmin
+        A13 --> A14[🖥 设置可见范围 public/restricted/member]:::portAdmin
+        A14 --> A15[🖥 保存草稿]:::portAdmin
     end
 
     subgraph 活动审核流程
-        A15 --> B1[提交审核 /submit-review]
-        B1 --> B2{管理员审核 /audit}
+        A15 --> B1[🖥 提交审核 /submit-review]:::portAdmin
+        B1 --> B2{🖥 管理员审核 /audit}:::portAdmin
         B2 -->|通过| B3[活动发布]
-        B2 -->|驳回| B4[查看驳回原因]
-        B4 --> B5[编辑后重新提交]
+        B2 -->|驳回| B4[🖥 查看驳回原因]:::portAdmin
+        B4 --> B5[🖥 编辑后重新提交]:::portAdmin
         B5 --> B1
     end
 
     subgraph 发布与下架
-        B3 --> C1[发布活动 /publish]
+        B3 --> C1[🖥 发布活动 /publish]:::portAdmin
         C1 --> C2[活动上线]
         C2 --> C3{活动到期或结束操作}
-        C3 -->|手动结束| C4[结束活动 /end]
+        C3 -->|手动结束| C4[🖥 结束活动 /end]:::portAdmin
         C3 -->|截止时间到| C4
         C4 --> C5[活动结束<br>不可再报名]
     end
 
     subgraph 用户浏览与报名
-        C2 --> D1(("家长")) --> D2[浏览活动列表 /list]
-        D2 --> D3[查看详情 /detail]
-        D3 --> D4{报名条件检查}
-        D4 -->|人数已满| D5[提示已满员]
-        D4 -->|已截止| D6[提示报名结束]
-        D4 -->|可报名| D7[选择参加的孩子 childId]
-        D7 --> D8[填写参加人身份信息]
-        D8 --> D9{用户会员等级}
-        D9 -->|普通用户| D10[普通价 price]
-        D9 -->|会员用户| D11[会员价 memberPrice]
-        D10 --> D12[提交报名 /register]
+        C2 --> D1(("👤 家长")):::portMiniApp --> D2[📱 浏览活动列表 /list]:::portMiniApp
+        D2 --> D3[📱 查看详情 /detail]:::portMiniApp
+        D3 --> D4{📱 报名条件检查}:::portMiniApp
+        D4 -->|人数已满| D5[📱 提示已满员]:::portMiniApp
+        D4 -->|已截止| D6[📱 提示报名结束]:::portMiniApp
+        D4 -->|可报名| D7[📱 选择参加的孩子 childId]:::portMiniApp
+        D7 --> D8[📱 填写参加人身份信息]:::portMiniApp
+        D8 --> D9{📱 用户会员等级}:::portMiniApp
+        D9 -->|普通用户| D10[📱 普通价 price]:::portMiniApp
+        D9 -->|会员用户| D11[📱 会员价 memberPrice]:::portMiniApp
+        D10 --> D12[📱 提交报名 /register]:::portMiniApp
         D11 --> D12
-        D12 --> D13{报名需审核?}
-        D13 -->|是| D14[等待管理员审批]
-        D13 -->|否| D15[报名成功]
-        D14 --> D16{管理员操作}
+        D12 --> D13{📱 报名需审核?}:::portMiniApp
+        D13 -->|是| D14[📱 等待管理员审批]:::portMiniApp
+        D13 -->|否| D15[📱 报名成功]:::portMiniApp
+        D14 --> D16{🖥 管理员操作}:::portAdmin
         D16 -->|通过| D15
-        D16 -->|拒绝| D17[报名被驳回]
+        D16 -->|拒绝| D17[📱 报名被驳回]:::portMiniApp
     end
 
     subgraph 报名管理
-        D15 --> E1[我的报名 /my-registrations]
-        E1 --> E2{活动开始前?}
-        E2 -->|是| E3[取消报名 /cancel-registration]
-        E2 -->|否| E4[等待签到]
+        D15 --> E1[📱 我的报名 /my-registrations]:::portMiniApp
+        E1 --> E2{📱 活动开始前?}:::portMiniApp
+        E2 -->|是| E3[📱 取消报名 /cancel-registration]:::portMiniApp
+        E2 -->|否| E4[📱 等待签到]:::portMiniApp
     end
 
     subgraph 签到
-        E4 --> F1[签到 /checkin]
-        F1 --> F2{需审核签到?}
-        F2 -->|是| F3[等待审核]
-        F2 -->|否| F4[签到成功<br>发放积分]
+        E4 --> F1[📱 签到 /checkin]:::portMiniApp
+        F1 --> F2{📱 需审核签到?}:::portMiniApp
+        F2 -->|是| F3[📱 等待审核]:::portMiniApp
+        F2 -->|否| F4[📱 签到成功<br>发放积分]:::portMiniApp
     end
 
     subgraph 活动反馈（活动结束后）
-        C5 --> G1[已签到参与者]
-        G1 --> G2[提交活动反馈]
+        C5 --> G1[📱 已签到参与者]:::portMiniApp
+        G1 --> G2[📱 提交活动反馈]:::portMiniApp
     end
 
     subgraph 管理员报名管理
-        D14 --> H1[报名列表 /admin/activity/registration/list]
-        H1 --> H2[审批 /approve]
-        H2 --> H3[拒绝 /reject]
+        D14 --> H1[🖥 报名列表 /admin/activity/registration/list]:::portAdmin
+        H1 --> H2[🖥 审批 /approve]:::portAdmin
+        H2 --> H3[🖥 拒绝 /reject]:::portAdmin
     end
 
     subgraph 管理后台
-        B2 --> I1[活动列表 /admin/activity/list]
-        I1 --> I2[活动审核 /review]
-        I2 --> I3[撤回 /withdraw]
-        I3 --> I4[转草稿 /re-draft]
+        B2 --> I1[🖥 活动列表 /admin/activity/list]:::portAdmin
+        I1 --> I2[🖥 活动审核 /review]:::portAdmin
+        I2 --> I3[🖥 撤回 /withdraw]:::portAdmin
+        I3 --> I4[🖥 转草稿 /re-draft]:::portAdmin
     end
 
     R1(("🔧 活动管理员<br>role=activity_admin")):::actor
@@ -126,25 +132,25 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/activity/list` | ActivityController | 活动列表（支持维度过滤+分页） |
-| `/api/activity/detail` | ActivityController | 活动详情 |
-| `/api/activity/create` | ActivityController | 创建活动（需admin/activity_admin） |
-| `/api/activity/update` | ActivityController | 修改活动（需admin/activity_admin） |
-| `/api/activity/publish` | ActivityController | 发布活动 |
-| `/api/activity/end` | ActivityController | 结束活动 |
-| `/api/activity/register` | ActivityController | 报名（activityId + childId） |
-| `/api/activity/cancel-registration` | ActivityController | 取消报名 |
-| `/api/activity/my-registrations` | ActivityController | 我的报名列表 |
-| `/api/activity/checkin` | ActivityController | 签到 |
-| `/api/admin/activity/list` | AdminActivityController | 管理员活动列表 |
-| `/api/admin/activity/detail` | AdminActivityController | 活动详情 |
-| `/api/admin/activity/review` | AdminActivityController | 审核 |
-| `/api/admin/activity/submit-review` | AdminActivityController | 提交审核 |
-| `/api/admin/activity/audit` | AdminActivityController | 审批(通过/驳回) |
-| `/api/admin/activity/withdraw` | AdminActivityController | 撤回审核 |
-| `/api/admin/activity/re-draft` | AdminActivityController | 转草稿 |
-| `/api/admin/activity/registration/list` | AdminActivityRegistrationController | 报名列表 |
-| `/api/admin/activity/registration/approve` | AdminActivityRegistrationController | 审批报名通过 |
-| `/api/admin/activity/registration/reject` | AdminActivityRegistrationController | 拒绝报名 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/activity/list` | 活动列表（支持维度过滤+分页） | 📱小程序 |
+| `/api/activity/detail` | 活动详情 | 📱小程序 |
+| `/api/activity/register` | 报名（activityId + childId） | 📱小程序 |
+| `/api/activity/cancel-registration` | 取消报名 | 📱小程序 |
+| `/api/activity/my-registrations` | 我的报名列表 | 📱小程序 |
+| `/api/activity/checkin` | 签到 | 📱小程序 |
+| `/api/activity/create` | 创建活动（需admin/activity_admin） | 🖥管理后台 |
+| `/api/activity/update` | 修改活动（需admin/activity_admin） | 🖥管理后台 |
+| `/api/activity/publish` | 发布活动 | 🖥管理后台 |
+| `/api/activity/end` | 结束活动 | 🖥管理后台 |
+| `/api/admin/activity/list` | 管理员活动列表 | 🖥管理后台 |
+| `/api/admin/activity/detail` | 活动详情 | 🖥管理后台 |
+| `/api/admin/activity/review` | 审核 | 🖥管理后台 |
+| `/api/admin/activity/submit-review` | 提交审核 | 🖥管理后台 |
+| `/api/admin/activity/audit` | 审批(通过/驳回) | 🖥管理后台 |
+| `/api/admin/activity/withdraw` | 撤回审核 | 🖥管理后台 |
+| `/api/admin/activity/re-draft` | 转草稿 | 🖥管理后台 |
+| `/api/admin/activity/registration/list` | 报名列表 | 🖥管理后台 |
+| `/api/admin/activity/registration/approve` | 审批报名通过 | 🖥管理后台 |
+| `/api/admin/activity/registration/reject` | 拒绝报名 | 🖥管理后台 |

docs/flows/admin-overview-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 管理后台
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,83 +11,87 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 管理员登录
-        A1(("管理员")) --> A2[发送验证码 /send-code]
-        A2 --> A3[登录 /login]
-        A3 --> A4[获取信息 /info]
-        A4 --> A5[修改密码 /change-password]
-        A5 --> A6[密码登录 /login-by-password]
+        A1(("🔧 管理员")):::portAdmin --> A2[🖥 发送验证码 /send-code]:::portAdmin
+        A2 --> A3[🖥 登录 /login]:::portAdmin
+        A3 --> A4[🖥 获取信息 /info]:::portAdmin
+        A4 --> A5[🖥 修改密码 /change-password]:::portAdmin
+        A5 --> A6[🖥 密码登录 /login-by-password]:::portAdmin
     end
 
     subgraph 用户管理
-        A6 --> B1[用户列表 /admin/users]
-        B1 --> B2[创建用户 /admin/users/create]
-        B2 --> B3[用户详情 /admin/users/{id}]
-        B3 --> B4[更新用户 /admin/users/{id}/update]
-        B4 --> B5[重置密码 /admin/users/{id}/reset-password]
-        B5 --> B6[搜索用户 /admin/user/search]
-        B6 --> B7[删除用户 /admin/users/{id}/delete]
+        A6 --> B1[🖥 用户列表 /admin/users]:::portAdmin
+        B1 --> B2[🖥 创建用户 /admin/users/create]:::portAdmin
+        B2 --> B3[🖥 用户详情 /admin/users/{id}]:::portAdmin
+        B3 --> B4[🖥 更新用户 /admin/users/{id}/update]:::portAdmin
+        B4 --> B5[🖥 重置密码 /admin/users/{id}/reset-password]:::portAdmin
+        B5 --> B6[🖥 搜索用户 /admin/user/search]:::portAdmin
+        B6 --> B7[🖥 删除用户 /admin/users/{id}/delete]:::portAdmin
     end
 
     subgraph 孩子管理
-        B7 --> C1[孩子列表 /admin/children]
-        C1 --> C2[详情 /admin/children/{id}]
-        C2 --> C3[更新 /admin/children/{id}/update]
-        C3 --> C4[调整积分 /admin/children/{id}/adjust-points]
+        B7 --> C1[🖥 孩子列表 /admin/children]:::portAdmin
+        C1 --> C2[🖥 详情 /admin/children/{id}]:::portAdmin
+        C2 --> C3[🖥 更新 /admin/children/{id}/update]:::portAdmin
+        C3 --> C4[🖥 调整积分 /admin/children/{id}/adjust-points]:::portAdmin
     end
 
     subgraph 家庭管理
-        C4 --> D1[家庭列表 /admin/families]
-        D1 --> D2[详情 /admin/families/{id}]
-        D2 --> D3[成员 /admin/families/{id}/members]
-        D3 --> D4[更新 /admin/families/{id}/update]
-        D4 --> D5[删除 /admin/families/{id}/delete]
+        C4 --> D1[🖥 家庭列表 /admin/families]:::portAdmin
+        D1 --> D2[🖥 详情 /admin/families/{id}]:::portAdmin
+        D2 --> D3[🖥 成员 /admin/families/{id}/members]:::portAdmin
+        D3 --> D4[🖥 更新 /admin/families/{id}/update]:::portAdmin
+        D4 --> D5[🖥 删除 /admin/families/{id}/delete]:::portAdmin
     end
 
     subgraph 任务审核
-        D5 --> E1[任务列表 /admin/tasks]
-        E1 --> E2[任务统计 /admin/tasks/stats]
+        D5 --> E1[🖥 任务列表 /admin/tasks]:::portAdmin
+        E1 --> E2[🖥 任务统计 /admin/tasks/stats]:::portAdmin
     end
 
     subgraph 奖励审核
-        E2 --> F1[奖励列表 /admin/rewards]
-        F1 --> F2[模板列表 /admin/rewards/templates]
-        F2 --> F3[创建模板 /admin/rewards/create]
-        F3 --> F4[审批 /admin/rewards/{id}/approve]
+        E2 --> F1[🖥 奖励列表 /admin/rewards]:::portAdmin
+        F1 --> F2[🖥 模板列表 /admin/rewards/templates]:::portAdmin
+        F2 --> F3[🖥 创建模板 /admin/rewards/create]:::portAdmin
+        F3 --> F4[🖥 审批 /admin/rewards/{id}/approve]:::portAdmin
     end
 
     subgraph 积分管理
-        F4 --> G1[积分日志 /admin/points/logs]
-        G1 --> G2[积分统计 /admin/points/stats]
+        F4 --> G1[🖥 积分日志 /admin/points/logs]:::portAdmin
+        G1 --> G2[🖥 积分统计 /admin/points/stats]:::portAdmin
     end
 
     subgraph 任务模板管理
-        G2 --> H1[模板列表 /admin/task-templates]
-        H1 --> H2[创建 /admin/task-templates/create]
+        G2 --> H1[🖥 模板列表 /admin/task-templates]:::portAdmin
+        H1 --> H2[🖥 创建 /admin/task-templates/create]:::portAdmin
     end
 
     subgraph 规划师审核
-        H2 --> I1[待审批列表 /admin/guide/applications/pending]
-        I1 --> I2[审批通过 /admin/guide/applications/{id}/approve]
-        I2 --> I3[驳回 /admin/guide/applications/{id}/reject]
-        I3 --> I4[列表 /admin/guide/guides]
+        H2 --> I1[🖥 待审批列表 /admin/guide/applications/pending]:::portAdmin
+        I1 --> I2[🖥 审批通过 /admin/guide/applications/{id}/approve]:::portAdmin
+        I2 --> I3[🖥 驳回 /admin/guide/applications/{id}/reject]:::portAdmin
+        I3 --> I4[🖥 列表 /admin/guide/guides]:::portAdmin
     end
 
     subgraph 商品审核
-        I4 --> J1[商品列表 /admin/product/list]
-        J1 --> J2[审核商品 /admin/product/review]
-        J2 --> J3[上下架 /admin/product/shelve]
+        I4 --> J1[🖥 商品列表 /admin/product/list]:::portAdmin
+        J1 --> J2[🖥 审核商品 /admin/product/review]:::portAdmin
+        J2 --> J3[🖥 上下架 /admin/product/shelve]:::portAdmin
     end
 
     subgraph 订单管理
-        J3 --> K1[订单列表 /admin/product/order/list]
-        K1 --> K2[发货 /admin/product/order/ship]
-        K2 --> K3[退款审核 /admin/product/order/refund/approve]
+        J3 --> K1[🖥 订单列表 /admin/product/order/list]:::portAdmin
+        K1 --> K2[🖥 发货 /admin/product/order/ship]:::portAdmin
+        K2 --> K3[🖥 退款审核 /admin/product/order/refund/approve]:::portAdmin
     end
 
     subgraph 系统管理
-        K3 --> L1[健康检查 /system/health]
+        K3 --> L1[⚙️ 健康检查 /system/health]:::portSystem
     end
 
     R1(("🔧 管理员")):::actor
@@ -97,17 +103,17 @@ flowchart TD
 
 ## 主要管理端点
 
-| 领域 | 端点示例 | 说明 |
-|------|----------|------|
-| 认证 | `/api/admin-auth/login` | 管理员登录 |
-| 用户 | `/api/admin/users` | 用户管理 |
-| 孩子 | `/api/admin/children` | 孩子管理 |
-| 家庭 | `/api/admin/families` | 家庭管理 |
-| 任务 | `/api/admin/tasks` | 任务管理 |
-| 奖励 | `/api/admin/rewards` | 奖励审批 |
-| 积分 | `/api/admin/points/logs` | 积分管理 |
-| 模板 | `/api/admin/task-templates` | 任务模板 |
-| 规划师 | `/api/admin/guide/applications/pending` | 规划师审批 |
-| 商品 | `/api/admin/product/review` | 商品审核 |
-| 订单 | `/api/admin/product/order/list` | 订单管理 |
-| 健康 | `/api/system/health` | 运行状态 |
+| 领域 | 端点示例 | 说明 | 端口 |
+|------|----------|------|------|
+| 认证 | `/api/admin-auth/login` | 管理员登录 | 🖥管理后台 |
+| 用户 | `/api/admin/users` | 用户管理 | 🖥管理后台 |
+| 孩子 | `/api/admin/children` | 孩子管理 | 🖥管理后台 |
+| 家庭 | `/api/admin/families` | 家庭管理 | 🖥管理后台 |
+| 任务 | `/api/admin/tasks` | 任务管理 | 🖥管理后台 |
+| 奖励 | `/api/admin/rewards` | 奖励审批 | 🖥管理后台 |
+| 积分 | `/api/admin/points/logs` | 积分管理 | 🖥管理后台 |
+| 模板 | `/api/admin/task-templates` | 任务模板 | 🖥管理后台 |
+| 规划师 | `/api/admin/guide/applications/pending` | 规划师审批 | 🖥管理后台 |
+| 商品 | `/api/admin/product/review` | 商品审核 | 🖥管理后台 |
+| 订单 | `/api/admin/product/order/list` | 订单管理 | 🖥管理后台 |
+| 健康 | `/api/system/health` | 运行状态 | ⚙️系统自动 |

docs/flows/ai-assistant-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — AI助手
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,46 +11,50 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph AI聊天
-        A1(("用户")) --> A2[发送聊天消息 /chat/send]
-        A2 --> A3{消息类型}
-        A3 -->|普通咨询| A4[Dify AI 响应]
-        A3 -->|报告解读| A5[传入reportId]
-        A5 --> A6[AI解读健康报告指标]
-        A4 --> A7[返回AI回答]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 发送聊天消息 /chat/send]:::portMiniApp
+        A2 --> A3{📱 消息类型}:::portMiniApp
+        A3 -->|普通咨询| A4[⚙️ Dify AI 响应]:::portSystem
+        A3 -->|报告解读| A5[📱 传入reportId]:::portMiniApp
+        A5 --> A6[⚙️ AI解读健康报告指标]:::portSystem
+        A4 --> A7[📱 返回AI回答]:::portMiniApp
         A6 --> A7
     end
 
     subgraph 会话管理
-        A7 --> B1[获取会话列表 /chat/conversations]
-        B1 --> B2[获取消息历史 /chat/messages]
-        B2 --> B3[删除会话 /chat/conversations/{id}/delete]
+        A7 --> B1[📱 获取会话列表 /chat/conversations]:::portMiniApp
+        B1 --> B2[📱 获取消息历史 /chat/messages]:::portMiniApp
+        B2 --> B3[📱 删除会话 /chat/conversations/{id}/delete]:::portMiniApp
     end
 
     subgraph AI营养分析
-        B3 --> C1[发送营养分析 /nutrition/send]
-        C1 --> C2[基于菌群报告]
-        C2 --> C3[AI生成营养建议]
+        B3 --> C1[📱 发送营养分析 /nutrition/send]:::portMiniApp
+        C1 --> C2[⚙️ 基于菌群报告]:::portSystem
+        C2 --> C3[📱 AI生成营养建议]:::portMiniApp
     end
 
     subgraph AI管家
-        C3 --> D1[创建新会话 /sessions/create]
-        D1 --> D2[更新Dify会话ID /sessions/update-conversation]
-        D2 --> D3[归档会话 /sessions/archive]
-        D3 --> D4[获取会话列表 /sessions/list]
-        D4 --> D5[会话详情 /sessions/detail]
-        D5 --> D6[删除会话 /sessions/delete]
+        C3 --> D1[📱 创建新会话 /sessions/create]:::portMiniApp
+        D1 --> D2[📱 更新Dify会话ID /sessions/update-conversation]:::portMiniApp
+        D2 --> D3[📱 归档会话 /sessions/archive]:::portMiniApp
+        D3 --> D4[📱 获取会话列表 /sessions/list]:::portMiniApp
+        D4 --> D5[📱 会话详情 /sessions/detail]:::portMiniApp
+        D5 --> D6[📱 删除会话 /sessions/delete]:::portMiniApp
     end
 
     subgraph AI上下文
-        D6 --> E1[供LangGraph调用的上下文 /api/ai/context]
+        D6 --> E1[📱 供LangGraph调用的上下文 /api/ai/context]:::portMiniApp
     end
 
     subgraph AI推荐
-        E1 --> F1[按标签搜索推荐 /recommend/search]
-        F1 --> F2[获取复购提醒 /recommend/repurchase-reminders]
-        F2 --> F3[标记提醒已点击 /repurchase-reminder/{id}/click]
+        E1 --> F1[📱 按标签搜索推荐 /recommend/search]:::portMiniApp
+        F1 --> F2[📱 获取复购提醒 /recommend/repurchase-reminders]:::portMiniApp
+        F2 --> F3[📱 标记提醒已点击 /repurchase-reminder/{id}/click]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -60,23 +66,23 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/ai/chat/send` | 发送聊天消息 |
-| `/api/ai/chat/conversations` | 会话列表 |
-| `/api/ai/chat/messages` | 消息历史 |
-| `/api/ai/chat/conversations/{id}/delete` | 删除会话 |
-| `/api/ai/nutrition/send` | 营养分析消息 |
-| `/api/ai/butler/sessions/create` | 创建AI管家会话 |
-| `/api/ai/butler/sessions/update-conversation` | 更新会话ID |
-| `/api/ai/butler/sessions/archive` | 归档会话 |
-| `/api/ai/butler/sessions/list` | 会话列表 |
-| `/api/ai/butler/sessions/detail` | 会话详情 |
-| `/api/ai/butler/sessions/delete` | 删除会话 |
-| `/api/ai/context` | AI上下文数据 |
-| `/api/recommend/search` | 营养标签搜索 |
-| `/api/recommend/repurchase-reminders` | 复购提醒 |
-| `/api/recommend/repurchase-reminder/{id}/click` | 标记已点击 |
-| `/api/feedback/today` | 获取今日AI反馈 |
-| `/api/feedback/read` | 标记已读 |
-| `/api/feedback/recent` | 最近反馈列表 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/ai/chat/send` | 发送聊天消息 | 📱小程序 |
+| `/api/ai/chat/conversations` | 会话列表 | 📱小程序 |
+| `/api/ai/chat/messages` | 消息历史 | 📱小程序 |
+| `/api/ai/chat/conversations/{id}/delete` | 删除会话 | 📱小程序 |
+| `/api/ai/nutrition/send` | 营养分析消息 | 📱小程序 |
+| `/api/ai/butler/sessions/create` | 创建AI管家会话 | 📱小程序 |
+| `/api/ai/butler/sessions/update-conversation` | 更新会话ID | 📱小程序 |
+| `/api/ai/butler/sessions/archive` | 归档会话 | 📱小程序 |
+| `/api/ai/butler/sessions/list` | 会话列表 | 📱小程序 |
+| `/api/ai/butler/sessions/detail` | 会话详情 | 📱小程序 |
+| `/api/ai/butler/sessions/delete` | 删除会话 | 📱小程序 |
+| `/api/ai/context` | AI上下文数据 | 📱小程序 |
+| `/api/recommend/search` | 营养标签搜索 | 📱小程序 |
+| `/api/recommend/repurchase-reminders` | 复购提醒 | 📱小程序 |
+| `/api/recommend/repurchase-reminder/{id}/click` | 标记已点击 | 📱小程序 |
+| `/api/feedback/today` | 获取今日AI反馈 | 📱小程序 |
+| `/api/feedback/read` | 标记已读 | 📱小程序 |
+| `/api/feedback/recent` | 最近反馈列表 | 📱小程序 |

docs/flows/badge-microaction-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 勋章与微行动
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,32 +11,36 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 勋章浏览
-        A1(("用户")) --> A2[获取启用的勋章列表 /list]
-        A2 --> A3[获取勋章详情 /detail]
-        A3 --> A4[收藏/取消收藏 /favorite]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取启用的勋章列表 /list]:::portMiniApp
+        A2 --> A3[📱 获取勋章详情 /detail]:::portMiniApp
+        A3 --> A4[📱 收藏/取消收藏 /favorite]:::portMiniApp
     end
 
     subgraph 勋章获得
-        A4 --> B1[获取孩子勋章列表 /child/list]
-        B1 --> B2[孩子勋章统计 /statistics/child]
-        B2 --> B3[家庭勋章排行 /ranking/family]
+        A4 --> B1[📱 获取孩子勋章列表 /child/list]:::portMiniApp
+        B1 --> B2[📱 孩子勋章统计 /statistics/child]:::portMiniApp
+        B2 --> B3[📱 家庭勋章排行 /ranking/family]:::portMiniApp
     end
 
     subgraph 管理员授勋
-        B3 --> C1[获取所有勋章 /all]
-        C1 --> C2[创建勋章 /create]
-        C2 --> C3[更新勋章 /update]
-        C3 --> C4[删除勋章 /delete]
-        C4 --> C5[手动授予勋章 /grant]
+        B3 --> C1[🖥 获取所有勋章 /all]:::portAdmin
+        C1 --> C2[🖥 创建勋章 /create]:::portAdmin
+        C2 --> C3[🖥 更新勋章 /update]:::portAdmin
+        C3 --> C4[🖥 删除勋章 /delete]:::portAdmin
+        C4 --> C5[🖥 手动授予勋章 /grant]:::portAdmin
     end
 
     subgraph 微行动
-        A1 --> D1[获取所有微行动列表 /micro-action/list]
-        D1 --> D2[获取今日推荐 /micro-action/today]
-        D2 --> D3[完成微行动 /micro-action/complete]
-        D3 --> D4[检查今日完成 /micro-action/check-today]
+        A1 --> D1[📱 获取所有微行动列表 /micro-action/list]:::portMiniApp
+        D1 --> D2[📱 获取今日推荐 /micro-action/today]:::portMiniApp
+        D2 --> D3[📱 完成微行动 /micro-action/complete]:::portMiniApp
+        D3 --> D4[📱 检查今日完成 /micro-action/check-today]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -46,20 +52,20 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/badges/list` | 启用的勋章列表 |
-| `/api/badges/all` | 所有勋章(管理端) |
-| `/api/badges/detail` | 勋章详情 |
-| `/api/badges/create` | 创建勋章 |
-| `/api/badges/update` | 更新勋章 |
-| `/api/badges/delete` | 删除勋章 |
-| `/api/badges/grant` | 手动授予勋章 |
-| `/api/badges/child/list` | 孩子勋章列表 |
-| `/api/badges/favorite` | 收藏/取消 |
-| `/api/badges/statistics/child` | 孩子勋章统计 |
-| `/api/badges/ranking/family` | 家庭勋章排行 |
-| `/api/micro-action/list` | 微行动列表 |
-| `/api/micro-action/today` | 今日推荐 |
-| `/api/micro-action/complete` | 完成微行动 |
-| `/api/micro-action/check-today` | 检查今日完成 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/badges/list` | 启用的勋章列表 | 📱小程序 |
+| `/api/badges/detail` | 勋章详情 | 📱小程序 |
+| `/api/badges/child/list` | 孩子勋章列表 | 📱小程序 |
+| `/api/badges/favorite` | 收藏/取消 | 📱小程序 |
+| `/api/badges/statistics/child` | 孩子勋章统计 | 📱小程序 |
+| `/api/badges/ranking/family` | 家庭勋章排行 | 📱小程序 |
+| `/api/micro-action/list` | 微行动列表 | 📱小程序 |
+| `/api/micro-action/today` | 今日推荐 | 📱小程序 |
+| `/api/micro-action/complete` | 完成微行动 | 📱小程序 |
+| `/api/micro-action/check-today` | 检查今日完成 | 📱小程序 |
+| `/api/badges/all` | 所有勋章 | 🖥管理后台 |
+| `/api/badges/create` | 创建勋章 | 🖥管理后台 |
+| `/api/badges/update` | 更新勋章 | 🖥管理后台 |
+| `/api/badges/delete` | 删除勋章 | 🖥管理后台 |
+| `/api/badges/grant` | 手动授予勋章 | 🖥管理后台 |

docs/flows/cart-coupon-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 购物车与优惠券
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,27 +11,31 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 购物车
-        A1(("用户")) --> A2[添加购物车 /cart/add]
-        A2 --> A3[获取购物车列表 /cart/list]
-        A3 --> A4[更新数量 /cart/update]
-        A4 --> A5[移除商品 /cart/remove]
-        A5 --> A6[获取数量 /cart/count]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 添加购物车 /cart/add]:::portMiniApp
+        A2 --> A3[📱 获取购物车列表 /cart/list]:::portMiniApp
+        A3 --> A4[📱 更新数量 /cart/update]:::portMiniApp
+        A4 --> A5[📱 移除商品 /cart/remove]:::portMiniApp
+        A5 --> A6[📱 获取数量 /cart/count]:::portMiniApp
     end
 
     subgraph 优惠券
-        A6 --> B1[获取可用优惠券 /coupon/list]
-        B1 --> B2[领取优惠券 /coupon/claim]
-        B2 --> B3[应用优惠券 /coupon/apply]
+        A6 --> B1[📱 获取可用优惠券 /coupon/list]:::portMiniApp
+        B1 --> B2[📱 领取优惠券 /coupon/claim]:::portMiniApp
+        B2 --> B3[📱 应用优惠券 /coupon/apply]:::portMiniApp
     end
 
     subgraph 管理员优惠券
-        B3 --> C1[优惠券列表 /admin/coupon/list]
-        C1 --> C2[创建优惠券 /admin/coupon/create]
-        C2 --> C3[更新 /admin/coupon/update]
-        C3 --> C4[发放 /admin/coupon/issue]
-        C4 --> C5[删除 /admin/coupon/delete]
+        B3 --> C1[🖥 优惠券列表 /admin/coupon/list]:::portAdmin
+        C1 --> C2[🖥 创建优惠券 /admin/coupon/create]:::portAdmin
+        C2 --> C3[🖥 更新 /admin/coupon/update]:::portAdmin
+        C3 --> C4[🖥 发放 /admin/coupon/issue]:::portAdmin
+        C4 --> C5[🖥 删除 /admin/coupon/delete]:::portAdmin
     end
 
     R1(("👤 用户")):::actor
@@ -41,18 +47,18 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/cart/add` | 添加购物车 |
-| `/api/cart/list` | 购物车列表 |
-| `/api/cart/update` | 更新购物车 |
-| `/api/cart/remove` | 移除商品 |
-| `/api/cart/count` | 购物车数量 |
-| `/api/coupon/list` | 优惠券列表 |
-| `/api/coupon/claim` | 领取优惠券 |
-| `/api/coupon/apply` | 应用优惠券 |
-| `/api/admin/coupon/list` | 管理优惠券列表 |
-| `/api/admin/coupon/create` | 创建优惠券 |
-| `/api/admin/coupon/update` | 更新优惠券 |
-| `/api/admin/coupon/issue` | 发放优惠券 |
-| `/api/admin/coupon/delete` | 删除优惠券 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/cart/add` | 添加购物车 | 📱小程序 |
+| `/api/cart/list` | 购物车列表 | 📱小程序 |
+| `/api/cart/update` | 更新购物车 | 📱小程序 |
+| `/api/cart/remove` | 移除商品 | 📱小程序 |
+| `/api/cart/count` | 购物车数量 | 📱小程序 |
+| `/api/coupon/list` | 优惠券列表 | 📱小程序 |
+| `/api/coupon/claim` | 领取优惠券 | 📱小程序 |
+| `/api/coupon/apply` | 应用优惠券 | 📱小程序 |
+| `/api/admin/coupon/list` | 管理优惠券列表 | 🖥管理后台 |
+| `/api/admin/coupon/create` | 创建优惠券 | 🖥管理后台 |
+| `/api/admin/coupon/update` | 更新优惠券 | 🖥管理后台 |
+| `/api/admin/coupon/issue` | 发放优惠券 | 🖥管理后台 |
+| `/api/admin/coupon/delete` | 删除优惠券 | 🖥管理后台 |

docs/flows/circle-contact-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 圈子与联系人
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,52 +11,56 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 圈子管理
-        A1(("用户")) --> A2[获取我的圈子 /my-circles]
-        A2 --> A3[发现圈子 /discover]
-        A3 --> A4[加入圈子 /join]
-        A4 --> A5[退出圈子 /leave]
-        A5 --> A6[创建圈子 /create]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取我的圈子 /my-circles]:::portMiniApp
+        A2 --> A3[📱 发现圈子 /discover]:::portMiniApp
+        A3 --> A4[📱 加入圈子 /join]:::portMiniApp
+        A4 --> A5[📱 退出圈子 /leave]:::portMiniApp
+        A5 --> A6[📱 创建圈子 /create]:::portMiniApp
     end
 
     subgraph 健康圈子
-        A6 --> B1[获取健康圈子列表 /health/circle/list]
-        B1 --> B2[创建健康圈子 /health/circle/create]
-        B2 --> B3[加入 /health/circle/join]
-        B3 --> B4[退出 /health/circle/leave]
-        B4 --> B5[排行榜 /health/circle/ranking]
+        A6 --> B1[📱 获取健康圈子列表 /health/circle/list]:::portMiniApp
+        B1 --> B2[📱 创建健康圈子 /health/circle/create]:::portMiniApp
+        B2 --> B3[📱 加入 /health/circle/join]:::portMiniApp
+        B3 --> B4[📱 退出 /health/circle/leave]:::portMiniApp
+        B4 --> B5[📱 排行榜 /health/circle/ranking]:::portMiniApp
     end
 
     subgraph 圈子挑战
-        B5 --> C1[挑战列表 /health/circle/challenge/list]
-        C1 --> C2[挑战历史 /health/circle/challenge/history]
+        B5 --> C1[📱 挑战列表 /health/circle/challenge/list]:::portMiniApp
+        C1 --> C2[📱 挑战历史 /health/circle/challenge/history]:::portMiniApp
     end
 
     subgraph 家庭挑战
-        C2 --> D1[家庭挑战列表 /health/challenge/list]
-        D1 --> D2[挑战历史 /health/challenge/history]
-        D2 --> D3[挑战进度 /health/challenge/progress]
+        C2 --> D1[📱 家庭挑战列表 /health/challenge/list]:::portMiniApp
+        D1 --> D2[📱 挑战历史 /health/challenge/history]:::portMiniApp
+        D2 --> D3[📱 挑战进度 /health/challenge/progress]:::portMiniApp
     end
 
     subgraph 联系人
-        A1 --> E1[获取联系人列表 /contact/list]
-        E1 --> E2[创建联系人 /contact/create]
-        E2 --> E3[更新联系人 /contact/update]
-        E3 --> E4[删除联系人 /contact/delete]
-        E4 --> E5[获取详情 /contact/detail]
-        E5 --> E6[导入手机联系人 /contact/import-phone]
-        E6 --> E7[记录互动 /contact/interaction]
-        E7 --> E8[邀请到家庭 /contact/invite-to-family]
+        A1 --> E1[📱 获取联系人列表 /contact/list]:::portMiniApp
+        E1 --> E2[📱 创建联系人 /contact/create]:::portMiniApp
+        E2 --> E3[📱 更新联系人 /contact/update]:::portMiniApp
+        E3 --> E4[📱 删除联系人 /contact/delete]:::portMiniApp
+        E4 --> E5[📱 获取详情 /contact/detail]:::portMiniApp
+        E5 --> E6[📱 导入手机联系人 /contact/import-phone]:::portMiniApp
+        E6 --> E7[📱 记录互动 /contact/interaction]:::portMiniApp
+        E7 --> E8[📱 邀请到家庭 /contact/invite-to-family]:::portMiniApp
     end
 
     subgraph 联系人匹配
-        E8 --> F1[发送匹配请求 /contact/match/send]
-        F1 --> F2[接受匹配 /contact/match/accept]
-        F2 --> F3[拒绝匹配 /contact/match/reject]
-        F3 --> F4[收到的请求 /contact/match/received]
-        F4 --> F5[发出的请求 /contact/match/sent]
-        F5 --> F6[已匹配 /contact/match/matched]
+        E8 --> F1[📱 发送匹配请求 /contact/match/send]:::portMiniApp
+        F1 --> F2[📱 接受匹配 /contact/match/accept]:::portMiniApp
+        F2 --> F3[📱 拒绝匹配 /contact/match/reject]:::portMiniApp
+        F3 --> F4[📱 收到的请求 /contact/match/received]:::portMiniApp
+        F4 --> F5[📱 发出的请求 /contact/match/sent]:::portMiniApp
+        F5 --> F6[📱 已匹配 /contact/match/matched]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -66,33 +72,33 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/circle/my-circles` | 我的圈子 |
-| `/api/circle/discover` | 发现圈子 |
-| `/api/circle/join` | 加入圈子 |
-| `/api/circle/leave` | 退出圈子 |
-| `/api/circle/create` | 创建圈子 |
-| `/api/health/circle/list` | 健康圈子列表 |
-| `/api/health/circle/create` | 创建健康圈子 |
-| `/api/health/circle/join` | 加入健康圈子 |
-| `/api/health/circle/leave` | 退出健康圈子 |
-| `/api/health/circle/ranking` | 健康圈子排行 |
-| `/api/health/circle/challenge/list` | 挑战列表 |
-| `/api/health/circle/challenge/history` | 挑战历史 |
-| `/api/health/challenge/list` | 家庭挑战列表 |
-| `/api/health/challenge/history` | 家庭挑战历史 |
-| `/api/health/challenge/progress` | 挑战进度 |
-| `/api/health/family/ranking` | 家庭健康排行 |
-| `/api/contact/list` | 联系人列表 |
-| `/api/contact/create` | 创建联系人 |
-| `/api/contact/update` | 更新联系人 |
-| `/api/contact/delete` | 删除联系人 |
-| `/api/contact/detail` | 联系人详情 |
-| `/api/contact/import-phone` | 导入手机联系人 |
-| `/api/contact/interaction` | 记录互动 |
-| `/api/contact/invite-to-family` | 邀请到家庭 |
-| `/api/contact/match/send` | 发送匹配 |
-| `/api/contact/match/accept` | 接受匹配 |
-| `/api/contact/match/reject` | 拒绝匹配 |
-| `/api/contact/match/matched` | 已匹配 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/circle/my-circles` | 我的圈子 | 📱小程序 |
+| `/api/circle/discover` | 发现圈子 | 📱小程序 |
+| `/api/circle/join` | 加入圈子 | 📱小程序 |
+| `/api/circle/leave` | 退出圈子 | 📱小程序 |
+| `/api/circle/create` | 创建圈子 | 📱小程序 |
+| `/api/health/circle/list` | 健康圈子列表 | 📱小程序 |
+| `/api/health/circle/create` | 创建健康圈子 | 📱小程序 |
+| `/api/health/circle/join` | 加入健康圈子 | 📱小程序 |
+| `/api/health/circle/leave` | 退出健康圈子 | 📱小程序 |
+| `/api/health/circle/ranking` | 健康圈子排行 | 📱小程序 |
+| `/api/health/circle/challenge/list` | 挑战列表 | 📱小程序 |
+| `/api/health/circle/challenge/history` | 挑战历史 | 📱小程序 |
+| `/api/health/challenge/list` | 家庭挑战列表 | 📱小程序 |
+| `/api/health/challenge/history` | 家庭挑战历史 | 📱小程序 |
+| `/api/health/challenge/progress` | 挑战进度 | 📱小程序 |
+| `/api/health/family/ranking` | 家庭健康排行 | 📱小程序 |
+| `/api/contact/list` | 联系人列表 | 📱小程序 |
+| `/api/contact/create` | 创建联系人 | 📱小程序 |
+| `/api/contact/update` | 更新联系人 | 📱小程序 |
+| `/api/contact/delete` | 删除联系人 | 📱小程序 |
+| `/api/contact/detail` | 联系人详情 | 📱小程序 |
+| `/api/contact/import-phone` | 导入手机联系人 | 📱小程序 |
+| `/api/contact/interaction` | 记录互动 | 📱小程序 |
+| `/api/contact/invite-to-family` | 邀请到家庭 | 📱小程序 |
+| `/api/contact/match/send` | 发送匹配 | 📱小程序 |
+| `/api/contact/match/accept` | 接受匹配 | 📱小程序 |
+| `/api/contact/match/reject` | 拒绝匹配 | 📱小程序 |
+| `/api/contact/match/matched` | 已匹配 | 📱小程序 |

docs/flows/content-media-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 内容与媒体
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -8,43 +10,47 @@ flowchart TD
     classDef system fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
-    classDef endpoint fill:#f5f5f5,stroke:#616111,stroke-width:1px
+    classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 文章浏览
-        A1(("用户")) --> A2[获取文章列表 /list]
-        A2 --> A3[获取文章分类 /categories]
-        A3 --> A4[获取文章详情 /detail]
-        A4 --> A5[获取精选文章 /featured]
-        A5 --> A6[记录阅读 /record-read]
-        A6 --> A7[获取阅读统计 /reading-stats]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取文章列表 /list]:::portMiniApp
+        A2 --> A3[📱 获取文章分类 /categories]:::portMiniApp
+        A3 --> A4[📱 获取文章详情 /detail]:::portMiniApp
+        A4 --> A5[📱 获取精选文章 /featured]:::portMiniApp
+        A5 --> A6[📱 记录阅读 /record-read]:::portMiniApp
+        A6 --> A7[📱 获取阅读统计 /reading-stats]:::portMiniApp
     end
 
     subgraph 每日贴士
-        A7 --> B1[获取每日贴士 /daily-tip]
-        B1 --> B2[获取AI问题列表 /ai-questions]
-        B2 --> B3[提交答案 /submit-answers]
+        A7 --> B1[📱 获取每日贴士 /daily-tip]:::portMiniApp
+        B1 --> B2[📱 获取AI问题列表 /ai-questions]:::portMiniApp
+        B2 --> B3[📱 提交答案 /submit-answers]:::portMiniApp
     end
 
     subgraph 内容发布
-        B3 --> C1[发布文章 /publish]
-        C1 --> C2[获取我的帖子 /my-posts]
+        B3 --> C1[📱 发布文章 /publish]:::portMiniApp
+        C1 --> C2[📱 获取我的帖子 /my-posts]:::portMiniApp
     end
 
     subgraph 内容分享
-        C2 --> D1[创建分享记录 /share/create]
-        D1 --> D2[记录点击 /share/click]
-        D2 --> D3[记录阅读 /share/read]
-        D3 --> D4[获取我的分享 /share/my]
-        D4 --> D5[获取分享统计 /share/stats]
-        D5 --> D6[获取家庭足迹 /share/family-footprint]
+        C2 --> D1[📱 创建分享记录 /share/create]:::portMiniApp
+        D1 --> D2[📱 记录点击 /share/click]:::portMiniApp
+        D2 --> D3[📱 记录阅读 /share/read]:::portMiniApp
+        D3 --> D4[📱 获取我的分享 /share/my]:::portMiniApp
+        D4 --> D5[📱 获取分享统计 /share/stats]:::portMiniApp
+        D5 --> D6[📱 获取家庭足迹 /share/family-footprint]:::portMiniApp
     end
 
     subgraph 媒体管理
-        D6 --> E1[上传媒体文件 /media/upload]
-        E1 --> E2[保存文字记录 /media/upload-text]
-        E2 --> E3[获取任务媒体 /media/task/{taskId}]
-        E3 --> E4[删除媒体 /media/{mediaId}]
-        E4 --> E5[批量关联 /media/attach]
+        D6 --> E1[📱 上传媒体文件 /media/upload]:::portMiniApp
+        E1 --> E2[📱 保存文字记录 /media/upload-text]:::portMiniApp
+        E2 --> E3[📱 获取任务媒体 /media/task/{taskId}]:::portMiniApp
+        E3 --> E4[📱 删除媒体 /media/{mediaId}]:::portMiniApp
+        E4 --> E5[📱 批量关联 /media/attach]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -56,27 +62,27 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/articles/list` | 文章列表 |
-| `/api/articles/categories` | 文章分类 |
-| `/api/articles/detail` | 文章详情 |
-| `/api/articles/featured` | 精选文章 |
-| `/api/articles/record-read` | 记录阅读 |
-| `/api/articles/reading-stats` | 阅读统计 |
-| `/api/articles/daily-tip` | 每日贴士 |
-| `/api/articles/ai-questions` | AI问题列表 |
-| `/api/articles/submit-answers` | 提交答案 |
-| `/api/articles/publish` | 发布文章 |
-| `/api/articles/my-posts` | 我的帖子 |
-| `/api/share/create` | 创建分享 |
-| `/api/share/click` | 记录点击 |
-| `/api/share/read` | 记录阅读 |
-| `/api/share/my` | 我的分享 |
-| `/api/share/stats` | 分享统计 |
-| `/api/share/family-footprint` | 家庭足迹 |
-| `/api/media/upload` | 上传媒体 |
-| `/api/media/upload-text` | 保存文字 |
-| `/api/media/task/{taskId}` | 任务媒体 |
-| `/api/media/{mediaId}` | 删除媒体 |
-| `/api/media/attach` | 批量关联 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/articles/list` | 文章列表 | 📱小程序 |
+| `/api/articles/categories` | 文章分类 | 📱小程序 |
+| `/api/articles/detail` | 文章详情 | 📱小程序 |
+| `/api/articles/featured` | 精选文章 | 📱小程序 |
+| `/api/articles/record-read` | 记录阅读 | 📱小程序 |
+| `/api/articles/reading-stats` | 阅读统计 | 📱小程序 |
+| `/api/articles/daily-tip` | 每日贴士 | 📱小程序 |
+| `/api/articles/ai-questions` | AI问题列表 | 📱小程序 |
+| `/api/articles/submit-answers` | 提交答案 | 📱小程序 |
+| `/api/articles/publish` | 发布文章 | 📱小程序 |
+| `/api/articles/my-posts` | 我的帖子 | 📱小程序 |
+| `/api/share/create` | 创建分享 | 📱小程序 |
+| `/api/share/click` | 记录点击 | 📱小程序 |
+| `/api/share/read` | 记录阅读 | 📱小程序 |
+| `/api/share/my` | 我的分享 | 📱小程序 |
+| `/api/share/stats` | 分享统计 | 📱小程序 |
+| `/api/share/family-footprint` | 家庭足迹 | 📱小程序 |
+| `/api/media/upload` | 上传媒体 | 📱小程序 |
+| `/api/media/upload-text` | 保存文字 | 📱小程序 |
+| `/api/media/task/{taskId}` | 任务媒体 | 📱小程序 |
+| `/api/media/{mediaId}` | 删除媒体 | 📱小程序 |
+| `/api/media/attach` | 批量关联 | 📱小程序 |

docs/flows/dan-assessment-flow.md

@@ -1,4 +1,8 @@
-# 用户使用流程图 — DAN专注力测评
+# 用户使用流程图 — DAN 认知测评
+
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
+## 流程图
 
 ```mermaid
 flowchart TD
@@ -8,118 +12,229 @@ flowchart TD
     classDef system fill:#e8f5e9,stroke:#388e3c,stroke-width:1px
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
+    classDef endpoint fill:#f5f5f5,stroke:#616111,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
+
+    subgraph 测评准备
+        A1(("👤 家长")):::portMiniApp --> A2[📱 浏览测评材料<br>/material/list]:::portMiniApp
+        A2 --> A3[📱 获取当前启用材料<br>/material/active]:::portMiniApp
+        A3 --> A4{📱 家庭测评已启用?}:::portMiniApp
+        A4 -->|否| A5[📱 启用家庭测评<br>/family/enable]:::portMiniApp
+        A4 -->|是| A6[📱 查看家庭配置<br>/family/config]:::portMiniApp
+        A5 --> A6
+        A6 --> A7[📱 查看可用额度<br>/quota/my-list]:::portMiniApp
+        A7 --> A8[📱 额度详情<br>/quota/detail]:::portMiniApp
+    end
 
-    subgraph 注册与准备
-        P1(("家长<br>开始")) --> P2[微信授权登录]
-        P2 --> P3[创建/加入家庭]
-        P3 --> P4[添加孩子为家庭成员]
+    subgraph 下单与支付
+        A8 --> B1[📱 选择评估师/规划师<br>/appointment/assessor-list]:::portMiniApp
+        B1 --> B2[📱 创建测评订单<br>/order/create]:::portMiniApp
+        B2 --> B3[📱 支付订单<br>/order/pay]:::portMiniApp
+        B3 --> B4[📱 查看订单详情<br>/order/detail]:::portMiniApp
+        B4 --> B5{📱 支付成功?}:::portMiniApp
+        B5 -->|否| B6[📱 取消订单<br>/order/cancel]:::portMiniApp
+        B5 -->|是| B7[⚙️ 订单状态: paid<br>生成额度<br>进入预约流程]:::portSystem
     end
 
-    subgraph 选购套餐与下单
-        P4 --> S1[浏览测评套餐/材料<br>POST /material/list]
-        S1 --> S2[选择成长规划师<br>浏览规划师列表]
-        S2 --> S3{是否首次测评?}
-        S3 -->|是| S4[填写孩子信息快照<br>身高/体重/学校等]
-        S3 -->|否| S5[选择已有孩子档案]
-        S4 --> S6[创建订单含预约信息<br>POST /order/create]
-        S5 --> S6
-        S6 --> S7[选择支付方式<br>POST /order/pay]
-        S7 --> S8[支付完成<br>订单状态: paid]
+    subgraph 预约管理
+        B7 --> C1[📱 创建预约<br>/appointment/create<br>消耗额度 · 生成执行记录]:::portMiniApp
+        C1 --> C2[📱 评估师列表<br>/appointment/guide-list]:::portMiniApp
+        C2 --> C3[📱 我的预约列表<br>/appointment/my-list]:::portMiniApp
+        C3 --> C4[📱 用户预约列表<br>/appointment/user]:::portMiniApp
+        C4 --> C5[📋 规划师预约列表<br>/appointment/guide]:::portGuide
+        C5 --> C6[📋 预约确认<br>/appointment/confirm]:::portGuide
+        C6 --> C7[线下/线上执行测评]
+        C7 --> C8[📋 完成预约<br>/appointment/complete]:::portGuide
     end
 
-    subgraph 预约与执行
-        S8 --> A1[系统创建预约记录<br>POST /appointment/create]
-        A1 --> A2[规划师确认预约<br>POST /appointment/confirm]
-        A2 --> A3[家长与孩子赴约<br>线下/线上测评]
-        A3 --> A4[规划师完成测评执行<br>POST /appointment/complete]
+    subgraph 执行与确认
+        C8 --> D1[📋 规划师完成任务<br>/dan-execution/complete]:::portGuide
+        D1 --> D2[📱 用户确认服务<br>/dan-execution/confirm]:::portMiniApp
+        D2 --> D3[📱 执行详情<br>/dan-execution/detail]:::portMiniApp
+        D3 --> D4[📱 用户评价<br>/dan-execution/rate]:::portMiniApp
+        D4 --> D5[📱 我的执行记录<br>/dan-execution/my-list]:::portMiniApp
+        D5 --> D6[📋 规划师待办<br>/dan-execution/guide/my-tasks]:::portGuide
     end
 
-    subgraph 结果录入与上传
-        A4 --> R1{报告来源?}
-        R1 -->|系统执行端录入| R2[规划师录入测评结果<br>POST /result/record]
-        R1 -->|PDF报告上传| R3[上传DAN PDF报告<br>POST /dan-assessment/report/parse-preview]
+    subgraph 结果录入
+        D6 --> E1{结果来源}
+        E1 -->|评估师录入| E2[📋 录入测评结果<br>/result/record]:::portGuide
+        E1 -->|家长上传PDF| E3[📱 上传报告<br>/result/upload<br>async AI解析]:::portMiniApp
+        E1 -->|DAN PDF上传| E4[📱 上传预览<br>/report/parse-preview<br>Phase 1 AI解析]:::portMiniApp
+        
+        E2 --> E5[⚙️ 结构化分析<br>/results/{id}/structured]:::portSystem
+        E3 --> E6[⚙️ AI解析完成 → 草稿]:::portSystem
+        E4 --> E7[⚙️ 预览解析结果]:::portSystem
         
-        R3 --> R4[AI解析PDF<br>Phase 1 /parse-preview]
-        R4 --> R5[家长预览解析结果<br>编辑/确认]
-        R5 --> R6[确认入库<br>Phase 2 /confirm]
-        R6 --> R7[独立化流程: <br>/api/dan-report/confirm]
-        R7 --> R8[完成分析<br>/complete-analysis]
+        E7 --> E8[📱 确认入库<br>/report/confirm<br>Phase 2]:::portMiniApp
+        E6 --> E9[📱 确认上传<br>/result/{resultId}/confirm-upload]:::portMiniApp
         
-        R2 --> R9[测评结果写入<br>DanAssessmentResult]
-        R8 --> R9
+        E5 --> E10[📱 获取成长建议<br>/result/{resultId}/guidance]:::portMiniApp
+        E10 --> E11[📋 保存成长建议<br>/result/{resultId}/guidance/save]:::portGuide
+        E8 --> E12[📱 孩子报告列表<br>/report/child]:::portMiniApp
+        E9 --> E12
     end
 
-    subgraph 测评报告与AI解读
-        R9 --> V1[家长查看测评报告]
-        V1 --> V2{是否需要<br>AI解读?}
-        V2 -->|是| V3[AI聊天解读<br>POST /api/ai/chat/send<br>传入 reportId]
-        V3 --> V4[AI分析各维度得分<br>注意力/记忆力/逻辑等]
-        V4 --> V5[AI生成个性化建议<br>训练方案/改善计划]
-        V5 --> V6[家长查看AI解读结果]
-        V2 -->|否| M1
+    subgraph 独立报告流程
+        E12 --> F1[📱 上传独立PDF<br>/dan-report/upload]:::portMiniApp
+        F1 --> F2[📱 编辑草稿<br>/{id}/edit]:::portMiniApp
+        F2 --> F3[📱 确认入库<br>/{id}/confirm]:::portMiniApp
+        F3 --> F4[📱 完成分析<br>/{id}/complete-analysis]:::portMiniApp
+        F4 --> F5[📱 报告详情<br>/{id}]:::portMiniApp
+        F5 --> F6[📱 废弃草稿<br>/{id}/discard]:::portMiniApp
+        F6 --> F7[📱 报告列表<br>/dan-report/list]:::portMiniApp
     end
 
-    subgraph 专业身份介入
-        V6 --> M1{是否需要<br>深度服务?}
-        M1 -->|全方位跟进| M2[管家介入]
-        M1 -->|成长规划| M3[规划师深度介入]
-        M1 -->|自行训练| M4[查看成长档案]
-        
-        M2 --> M2a[申请管家服务]
-        M2a --> M2b[管家审核建档]
-        M2b --> M2c[管家协调规划师+营养师]
-        M2c --> M2d[定期跟踪测评进展]
-        M2d --> M4
-        
-        M3 --> M3a[规划师分析测评报告]
-        M3a --> M3b[规划师制定成长任务]
-        M3b --> M3c[孩子执行任务<br>含小游戏训练]
-        M3c --> M3d[规划师审核任务]
-        M3d --> M3e[调整下一阶段方案]
-        M3e --> M4
+    subgraph 结果查询与对比
+        F7 --> G1[📱 最新测评结果<br>/assessment/latest-result]:::portMiniApp
+        G1 --> G2[📱 测评历史<br>/assessment/history]:::portMiniApp
+        G2 --> G3{📱 对比分析}:::portMiniApp
+        G3 -->|孩子整体对比| G4[📱 首次vs最新<br>/compare/by-child]:::portMiniApp
+        G3 -->|单维度变化| G5[📱 维度对比<br>/compare/by-child-dimension]:::portMiniApp
+        G3 -->|家庭对比| G6[📱 家庭对比<br>/compare/by-family]:::portMiniApp
+        G3 -->|综合分析| G7[📱 综合分析<br>/compare/narrative]:::portMiniApp
+        G4 --> G8[📱 我的报告列表<br>/assessment/my-results]:::portMiniApp
+        G5 --> G8
+        G6 --> G8
+        G7 --> G8
+        G8 --> G9[📋 下级规划师报告<br>/assessment/child-results]:::portGuide
     end
 
-    subgraph 成长档案追踪
-        M4 --> T1[测评结果进入成长档案<br>GrowthRecordController]
-        T1 --> T2[系统生成五维能量变化]
-        T2 --> T3[家长查看成长趋势]
-        T3 --> T4{是否需要<br>下一轮测评?}
-        T4 -->|是| S1
-        T4 -->|否| T5[结束]
+    subgraph 家长端自评
+        G9 --> H1[📱 创建自评<br>/parent/assessment/create]:::portMiniApp
+        H1 --> H2[📱 当前进度<br>/parent/assessment/current]:::portMiniApp
+        H2 --> H3[📱 提交自评<br>/parent/assessment/complete/{recordId}]:::portMiniApp
+        H3 --> H4[📱 自评记录<br>/parent/assessment/records]:::portMiniApp
     end
 
-    %% ============ 角色标注 ============
-    RP1(("👤 家长")):::actor
-    RC(("👶 孩子")):::actor
-    RT(("📋 成长规划师")):::role
-    RA(("🤖 AI教练")):::role
-    RB(("🏠 管家")):::role
-
-    P4 -.- RC
-    S2 -.- RT
-    A2 -.- RT
-    A4 -.- RT
-    V3 -.- RA
-    M2 -.- RB
-    M3 -.- RT
-```
-
-## 角色说明
-
-| 角色 | 系统映射 | 职责 |
-|:----|:---------|:-----|
-| **家长** | `role=parent` | 发起测评、选购套餐、下单支付、查看报告、选择服务 |
-| **孩子** | `role=child` | 接受测评、执行训练任务 |
-| **成长规划师** | `role=teacher` | 确认预约、执行测评、录入结果、制定改善任务、审核跟踪 |
-| **AI教练** | `AIChatController` + Dify + DAN知识库 | 自动解析PDF报告、解读维度得分、生成建议与训练方案 |
-| **管家** | `ButlerService` / `butler` role | 全程服务协调，对接规划师/营养师等资源 |
-| **管理员** | `role=admin` | 测评材料管理、套餐配置、审核管理（后台） |
-
----
+    subgraph 规划师端评估管理
+        H4 --> I1[📋 家庭测评列表<br>/guide/assessment/families]:::portGuide
+        I1 --> I2[📋 家庭详情<br>/family/{familyId}]:::portGuide
+        I2 --> I3[📋 启用/禁用<br>/family/{familyId}/disable]:::portGuide
+        I3 --> I4[📋 培训计划<br>/guide/training-plans]:::portGuide
+    end
 
-## 文件保存位置
+    %% 角色标注
+    RP1(("👤 家长")):::actor
+    RT(("📋 规划师/评估师")):::role
+    RS(("⚙️ AI解析引擎")):::system
 
-- **身体健康检测流程图**: `docs/flows/health-detection-flow.md`
-- **DAN测评流程图**: `docs/flows/dan-assessment-flow.md`
+    A1 -.- RP1
+    B1 -.- RT
+    C2 -.- RT
+    D1 -.- RT
+```
 
-> 使用支持 Mermaid 的 Markdown 渲染器（如 GitHub、VS Code 插件）查看流程图。两张图分别覆盖了完整的用户旅程和所有角色交互节点。
+## 端点明细
+
+### 测评准备
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-assessment/material/list` | 浏览测评材料 | 📱小程序 |
+| `/api/dan-assessment/material/active` | 获取当前启用材料 | 📱小程序 |
+| `/api/dan-assessment/family/enable` | 启用家庭测评 | 📱小程序 |
+| `/api/dan-assessment/family/disable` | 禁用家庭测评 | 📱小程序 |
+| `/api/dan-assessment/family/config` | 获取家庭测评配置 | 📱小程序 |
+| `/api/dan-assessment/points-config` | 获取积分配置 | 📱小程序 |
+| `/api/assessment/quota/my-list` | 我的可用额度列表 | 📱小程序 |
+| `/api/assessment/quota/detail` | 额度详情 | 📱小程序 |
+
+### 下单与支付
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-assessment/order/create` | 创建测评订单 | 📱小程序 |
+| `/api/dan-assessment/order/pay` | 支付订单 | 📱小程序 |
+| `/api/dan-assessment/order/detail` | 订单详情 | 📱小程序 |
+| `/api/dan-assessment/order/family` | 家庭订单列表 | 📱小程序 |
+| `/api/dan-assessment/order/cancel` | 取消订单 | 📱小程序 |
+
+### 预约管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-assessment/appointment/create` | 创建预约 | 📱小程序 |
+| `/api/dan-assessment/appointment/confirm` | 确认预约 | 📋规划师端 |
+| `/api/dan-assessment/appointment/complete` | 完成预约 | 📋规划师端 |
+| `/api/dan-assessment/appointment/cancel` | 取消预约 | 📱小程序 |
+| `/api/dan-assessment/appointment/user` | 用户预约列表 | 📱小程序 |
+| `/api/dan-assessment/appointment/guide` | 规划师预约列表 | 📋规划师端 |
+| `/api/assessment/appointment/create` | 创建评估预约（含执行记录） | 📱小程序 |
+| `/api/assessment/appointment/confirm/{id}` | 确认评估预约 | 📋规划师端 |
+| `/api/assessment/appointment/cancel/{id}` | 取消评估预约 | 📱小程序 |
+| `/api/assessment/appointment/guide-list` | 评估师可选列表 | 📱小程序 |
+| `/api/assessment/appointment/my-list` | 我的预约列表 | 📱小程序 |
+| `/api/assessment/appointment/assessor-list` | 评估师列表 | 📱小程序 |
+| `/api/assessment/appointment/user` | 用户端预约列表 | 📱小程序 |
+
+### 执行与确认
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-execution/complete` | 规划师完成服务 | 📋规划师端 |
+| `/api/dan-execution/confirm` | 用户确认服务完成 | 📱小程序 |
+| `/api/dan-execution/rate` | 用户评价服务 | 📱小程序 |
+| `/api/dan-execution/detail` | 执行详情（含结算） | 📱小程序/📋规划师端 |
+| `/api/dan-execution/my-list` | 用户执行记录 | 📱小程序 |
+| `/api/dan-execution/guide/my-tasks` | 规划师待执行任务 | 📋规划师端 |
+| `/api/dan-execution/by-order` | 按订单查询执行 | 📱小程序/📋规划师端 |
+
+### 结果录入
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-assessment/result/record` | 记录测评结果 | 📋规划师端 |
+| `/api/dan-assessment/result/upload` | 家长上传报告 | 📱小程序 |
+| `/api/dan-assessment/result/{id}` | 获取结果详情 | 📱小程序/📋规划师端 |
+| `/api/dan-assessment/result/{resultId}/confirm-upload` | 确认上传 | 📱小程序 |
+| `/api/dan-assessment/result/{resultId}/guidance` | 获取成长建议 | 📱小程序 |
+| `/api/dan-assessment/result/{resultId}/guidance/save` | 保存成长建议 | 📋规划师端 |
+| `/api/dan-assessment/results/{id}/structured` | 结构化分析 | ⚙️系统自动 |
+| `/api/dan-assessment/record/create` | 创建测评记录 | 📱小程序 |
+| `/api/dan-assessment/record/complete` | 完成测评记录 | 📋规划师端 |
+| `/api/dan-assessment/record/family` | 家庭测评记录列表 | 📱小程序 |
+| `/api/dan-assessment/record/current` | 当前测评 | 📱小程序 |
+
+### 报告上传（DanAssessmentController）
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-assessment/report/parse-preview` | DAN PDF上传预览（Phase 1 AI解析） | 📱小程序 |
+| `/api/dan-assessment/report/confirm` | 确认入库（Phase 2） | 📱小程序 |
+| `/api/dan-assessment/report/child` | 孩子DAN报告列表 | 📱小程序 |
+
+### 独立报告流程（DanReportController）
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/dan-report/upload` | 上传独立PDF | 📱小程序 |
+| `/api/dan-report/{id}/edit` | 编辑草稿 | 📱小程序 |
+| `/api/dan-report/{id}/confirm` | 确认入库 | 📱小程序 |
+| `/api/dan-report/{id}/discard` | 废弃草稿 | 📱小程序 |
+| `/api/dan-report/{id}/complete-analysis` | 完成分析 | 📱小程序 |
+| `/api/dan-report/{id}` | 报告详情 | 📱小程序/📋规划师端 |
+| `/api/dan-report/list` | 报告列表 | 📱小程序/📋规划师端 |
+
+### 结果查询与对比
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/assessment/latest-result` | 孩子最新测评结果 | 📱小程序 |
+| `/api/assessment/history` | 测评历史记录 | 📱小程序 |
+| `/api/assessment/my-results` | 我的报告列表 | 📱小程序/📋规划师端 |
+| `/api/assessment/child-results` | 下级规划师报告 | 📋规划师端 |
+| `/api/assessment/compare/by-child` | 孩子首次vs最新对比 | 📱小程序 |
+| `/api/assessment/compare/by-child-dimension` | 孩子单维度变化对比 | 📱小程序 |
+| `/api/assessment/compare/by-family` | 家庭对比分析 | 📱小程序 |
+| `/api/assessment/compare/narrative` | 综合分析报告 | 📱小程序 |
+
+### 家长端自评
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/parent/assessment/create` | 创建家长自评 | 📱小程序 |
+| `/api/parent/assessment/current` | 当前自评进度 | 📱小程序 |
+| `/api/parent/assessment/complete/{recordId}` | 提交自评 | 📱小程序 |
+| `/api/parent/assessment/records` | 自评记录 | 📱小程序 |
+
+### 规划师端评估管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/assessment/families` | 家庭测评列表 | 📋规划师端 |
+| `/api/guide/assessment/family/{familyId}` | 家庭测评详情 | 📋规划师端 |
+| `/api/guide/assessment/family/{familyId}/disable` | 禁用家庭测评 | 📋规划师端 |

docs/flows/energy-system-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 五维能量沙盘
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,40 +11,44 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 能量概览
-        A1(("家长/孩子")) --> A2[获取能量沙盘 /sandbox]
-        A2 --> A3[获取五维概览 /overview]
-        A3 --> A4[获取家庭五维聚合 /family-score-history]
-        A4 --> A5[获取五维分数历史 /score-history]
+        A1(("👤 家长/孩子")):::portMiniApp --> A2[📱 获取能量沙盘 /sandbox]:::portMiniApp
+        A2 --> A3[📱 获取五维概览 /overview]:::portMiniApp
+        A3 --> A4[📱 获取家庭五维聚合 /family-score-history]:::portMiniApp
+        A4 --> A5[📱 获取五维分数历史 /score-history]:::portMiniApp
     end
 
     subgraph 能量流水
-        A5 --> B1[查询能量流水 /logs]
-        B1 --> B2[获取富维度详情 /wealth-detail]
+        A5 --> B1[📱 查询能量流水 /logs]:::portMiniApp
+        B1 --> B2[📱 获取富维度详情 /wealth-detail]:::portMiniApp
     end
 
     subgraph 能量操作
-        A3 --> C1[发放能量 /grant]
-        C1 --> C2[心愿兑换扣除 /deduct-for-wish]
-        C2 --> C3[配置来源比例 /configure]
+        A3 --> C1[📱 发放能量 /grant]:::portMiniApp
+        C1 --> C2[📱 心愿兑换扣除 /deduct-for-wish]:::portMiniApp
+        C2 --> C3[📱 配置来源比例 /configure]:::portMiniApp
     end
 
     subgraph 维度管理
-        C3 --> D1[获取维度概览 /overview]
-        D1 --> D2[手动录入维度 /upload]
-        D2 --> D3[问卷提交维度 /questionnaire]
-        D3 --> D4[获取维度历史 /history]
+        C3 --> D1[📱 获取维度概览 /overview]:::portMiniApp
+        D1 --> D2[📱 手动录入维度 /upload]:::portMiniApp
+        D2 --> D3[📱 问卷提交维度 /questionnaire]:::portMiniApp
+        D3 --> D4[📱 获取维度历史 /history]:::portMiniApp
     end
 
     subgraph 年度能量
-        D4 --> E1[获取年度五维能量 /energy]
+        D4 --> E1[📱 获取年度五维能量 /energy]:::portMiniApp
     end
 
     subgraph 家庭收入
-        C3 --> F1[获取家庭收入汇总 /family/summary]
-        F1 --> F2[获取成员收入 /family/members]
-        F2 --> F3[获取收入记录 /family/records]
+        C3 --> F1[📱 获取家庭收入汇总 /family/summary]:::portMiniApp
+        F1 --> F2[📱 获取成员收入 /family/members]:::portMiniApp
+        F2 --> F3[📱 获取收入记录 /family/records]:::portMiniApp
     end
 
     R1(("👤 家长/孩子")):::actor
@@ -54,23 +60,23 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/energy/sandbox` | EnergyController | 获取能量沙盘 |
-| `/api/energy/overview` | EnergyController | 获取五维概览 |
-| `/api/energy/logs` | EnergyController | 查询能量流水 |
-| `/api/energy/grant` | EnergyController | 发放能量 |
-| `/api/energy/deduct-for-wish` | EnergyController | 心愿扣除能量 |
-| `/api/energy/configure` | EnergyController | 配置来源比例 |
-| `/api/energy/score-history` | EnergyController | 五维分数历史 |
-| `/api/energy/family-score-history` | EnergyController | 家庭五维聚合 |
-| `/api/energy/wealth-detail` | EnergyController | 富维度详情 |
-| `/api/energy/seed` | SeedEnergyController | 生成种子数据 |
-| `/api/zodiac/energy` | ZodiacEnergyController | 年度五维能量 |
-| `/api/dimension/overview` | HealthDimensionController | 维度概览 |
-| `/api/dimension/upload` | HealthDimensionController | 手动录入维度 |
-| `/api/dimension/questionnaire` | HealthDimensionController | 问卷提交 |
-| `/api/dimension/history` | HealthDimensionController | 维度历史 |
-| `/api/earnings/family/summary` | FamilyEarningsController | 家庭收入汇总 |
-| `/api/earnings/family/members` | FamilyEarningsController | 成员收入 |
-| `/api/earnings/family/records` | FamilyEarningsController | 收入记录 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/energy/sandbox` | 获取能量沙盘 | 📱小程序 |
+| `/api/energy/overview` | 获取五维概览 | 📱小程序 |
+| `/api/energy/logs` | 查询能量流水 | 📱小程序 |
+| `/api/energy/grant` | 发放能量 | 📱小程序 |
+| `/api/energy/deduct-for-wish` | 心愿扣除能量 | 📱小程序 |
+| `/api/energy/configure` | 配置来源比例 | 📱小程序 |
+| `/api/energy/score-history` | 五维分数历史 | 📱小程序 |
+| `/api/energy/family-score-history` | 家庭五维聚合 | 📱小程序 |
+| `/api/energy/wealth-detail` | 富维度详情 | 📱小程序 |
+| `/api/energy/seed` | 生成种子数据 | ⚙️系统自动 |
+| `/api/zodiac/energy` | 年度五维能量 | 📱小程序 |
+| `/api/dimension/overview` | 维度概览 | 📱小程序 |
+| `/api/dimension/upload` | 手动录入维度 | 📱小程序 |
+| `/api/dimension/questionnaire` | 问卷提交 | 📱小程序 |
+| `/api/dimension/history` | 维度历史 | 📱小程序 |
+| `/api/earnings/family/summary` | 家庭收入汇总 | 📱小程序 |
+| `/api/earnings/family/members` | 成员收入 | 📱小程序 |
+| `/api/earnings/family/records` | 收入记录 | 📱小程序 |

docs/flows/extra-features-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 其他功能
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,39 +11,43 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 用户吉祥物
-        A1(("用户")) --> A2[设置吉祥物 /user/mascot/set]
-        A2 --> A3[获取吉祥物 /user/mascot/get]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 设置吉祥物 /user/mascot/set]:::portMiniApp
+        A2 --> A3[📱 获取吉祥物 /user/mascot/get]:::portMiniApp
     end
 
     subgraph 用户分群
-        A3 --> B1[RFM计算 /segmentation/rfm/calculate]
-        B1 --> B2[RFM详情 /segmentation/rfm/detail]
-        B2 --> B3[触发规则 /segmentation/trigger/rules]
+        A3 --> B1[📱 RFM计算 /segmentation/rfm/calculate]:::portMiniApp
+        B1 --> B2[📱 RFM详情 /segmentation/rfm/detail]:::portMiniApp
+        B2 --> B3[📱 触发规则 /segmentation/trigger/rules]:::portMiniApp
     end
 
     subgraph 外部同步
-        B3 --> C1[同步客户到zkxz /sncp/addClient/{clientId}]
-        C1 --> C2[获取通知 /sncp/notice/{userLogin}]
+        B3 --> C1[📱 同步客户到zkxz /sncp/addClient/{clientId}]:::portMiniApp
+        C1 --> C2[📱 获取通知 /sncp/notice/{userLogin}]:::portMiniApp
     end
 
     subgraph 每日反馈
-        C2 --> D1[获取今日反馈 /feedback/today]
-        D1 --> D2[标记已读 /feedback/read]
-        D2 --> D3[获取最近反馈 /feedback/recent]
+        C2 --> D1[📱 获取今日反馈 /feedback/today]:::portMiniApp
+        D1 --> D2[📱 标记已读 /feedback/read]:::portMiniApp
+        D2 --> D3[📱 获取最近反馈 /feedback/recent]:::portMiniApp
     end
 
     subgraph 健康互动
-        D3 --> E1[点赞 /health/interact/like]
+        D3 --> E1[📱 点赞 /health/interact/like]:::portMiniApp
     end
 
     subgraph 商品推荐
-        E1 --> F1[维度页推荐 /recommend/dimension-products]
+        E1 --> F1[📱 维度页推荐 /recommend/dimension-products]:::portMiniApp
     end
 
     subgraph 通用工具
-        F1 --> G1[生成小程序码 /common/qrcode]
+        F1 --> G1[📱 生成小程序码 /common/qrcode]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -51,20 +57,20 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/user/mascot/set` | 设置吉祥物 |
-| `/api/user/mascot/get` | 获取吉祥物 |
-| `/api/segmentation/rfm/calculate` | RFM计算 |
-| `/api/segmentation/rfm/detail` | RFM详情 |
-| `/api/segmentation/trigger/rules` | 触发规则 |
-| `/api/sncp/addClient/{clientId}` | 同步客户 |
-| `/api/sncp/notice/{userLogin}` | 获取通知 |
-| `/api/feedback/today` | 今日反馈 |
-| `/api/feedback/read` | 标记已读 |
-| `/api/feedback/recent` | 最近反馈 |
-| `/api/health/interact/like` | 点赞 |
-| `/api/recommend/dimension-products` | 维度推荐 |
-| `/api/common/qrcode` | 生成小程序码 |
-| `/api/onboarding/progress` | 引导进度 |
-| `/api/onboarding/claim` | 领取奖励 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/user/mascot/set` | 设置吉祥物 | 📱小程序 |
+| `/api/user/mascot/get` | 获取吉祥物 | 📱小程序 |
+| `/api/segmentation/rfm/calculate` | RFM计算 | 📱小程序 |
+| `/api/segmentation/rfm/detail` | RFM详情 | 📱小程序 |
+| `/api/segmentation/trigger/rules` | 触发规则 | 📱小程序 |
+| `/api/sncp/addClient/{clientId}` | 同步客户 | 📱小程序 |
+| `/api/sncp/notice/{userLogin}` | 获取通知 | 📱小程序 |
+| `/api/feedback/today` | 今日反馈 | 📱小程序 |
+| `/api/feedback/read` | 标记已读 | 📱小程序 |
+| `/api/feedback/recent` | 最近反馈 | 📱小程序 |
+| `/api/health/interact/like` | 点赞 | 📱小程序 |
+| `/api/recommend/dimension-products` | 维度推荐 | 📱小程序 |
+| `/api/common/qrcode` | 生成小程序码 | 📱小程序 |
+| `/api/onboarding/progress` | 引导进度 | 📱小程序 |
+| `/api/onboarding/claim` | 领取奖励 | 📱小程序 |

docs/flows/family-management-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 家庭管理
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,97 +11,176 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 家庭创建与加入
-        A1(("家长")) --> A2{是否有家庭?}
-        A2 -->|无| A3[创建新家庭 /create-family]
-        A2 -->|有| A4[加入其他家庭 /join-family]
-        A3 --> A5[生成邀请码 /qrcode]
-        A4 --> A6[通过邀请码加入 /accept-by-code]
-        A5 --> A7[生成家庭邀请二维码 /generate]
-        A7 --> A8[校验邀请令牌 /validate]
-        A8 --> A9[接受邀请 /accept]
+        A1(("👤 家长")):::portMiniApp --> A2{📱 是否有家庭?}:::portMiniApp
+        A2 -->|无| A3[📱 创建新家庭 /user/create-family]:::portMiniApp
+        A2 -->|有| A4[📱 加入其他家庭 /user/join-family]:::portMiniApp
+        A3 --> A5[📱 生成邀请链接 /invite/generate]:::portMiniApp
+        A5 --> A6[📱 生成二维码 /invite/qrcode]:::portMiniApp
+        A6 --> A7[📱 查看邀请码 /invite-code]:::portMiniApp
+        A7 --> A8[📱 生成新邀请码 /invite-code/generate]:::portMiniApp
+        A4 --> A9[📱 通过邀请码加入 /invite/accept-by-code]:::portMiniApp
+        A8 --> A10[📱 校验邀请令牌 /invite/validate]:::portMiniApp
+        A10 --> A11[📱 接受邀请 /invite/accept]:::portMiniApp
+        A11 --> A12[📱 查询家庭状态 /invite/check-family]:::portMiniApp
+    end
+
+    subgraph 用户与角色管理
+        A12 --> B1[📱 用户信息 /user/info · 更新 /user/update]:::portMiniApp
+        B1 --> B2[📱 角色列表 /user/roles]:::portMiniApp
+        B2 --> B3{📱 切换模式}:::portMiniApp
+        B3 -->|切换角色| B4[📱 切换 /user/switch-role]:::portMiniApp
+        B3 -->|切换模式| B5[📱 切换模式 /user/switch-mode]:::portMiniApp
+        B3 -->|切换到孩子| B6[📱 切换到孩子 /user/switch-to-child]:::portMiniApp
+        B6 --> B7[📱 切换回家长 /user/switch-back-to-parent]:::portMiniApp
+        B7 --> B8[📱 切换验证 /user/switch-back-verify]:::portMiniApp
     end
 
     subgraph 家庭成员管理
-        A9 --> B1[添加家庭成员 /add]
-        B1 --> B2[获取家庭成员列表 /list]
-        B2 --> B3[更新成员信息 /update]
-        B3 --> B4[切换到成员视图 /switch]
-        B4 --> B5[检查成员可编辑性 /editable]
-        B5 --> B6[踢出成员 /kick]
-        B6 --> B7[成员变更日志 /logs]
+        B8 --> C1[📱 添加成员 /member/add]:::portMiniApp
+        C1 --> C2[📱 成员列表 /member/list<br>可见成员 /user/members/visible]:::portMiniApp
+        C2 --> C3[📱 更新信息 /member/update<br>孩子更新 /user/children/update]:::portMiniApp
+        C3 --> C4[📱 更新可见性 /user/members/update-visibility]:::portMiniApp
+        C4 --> C5[📱 切换成员视图 /member/switch]:::portMiniApp
+        C5 --> C6[📱 检查可编辑性 /member/editable]:::portMiniApp
+        C6 --> C7[📱 踢出成员 /member/kick · /user/kick]:::portMiniApp
+        C7 --> C8[📱 变更日志 /member/logs]:::portMiniApp
     end
 
     subgraph 家庭设置
-        B7 --> C1[转让家庭管理员 /transfer-admin]
-        C1 --> C2[查询家庭状态 /check-family]
-        C2 --> C3[吊销邀请链接 /revoke]
+        C8 --> D1[📱 转让管理员 /invite/transfer-admin]:::portMiniApp
+        D1 --> D2[📱 吊销邀请 /invite/revoke]:::portMiniApp
+        D2 --> D3[📱 创建孩子 /user/children<br>孩子列表 /user/children/list]:::portMiniApp
+        D3 --> D4[📱 家庭成员列表 /user/family-members]:::portMiniApp
+    end
+
+    subgraph 家庭关系问卷
+        D4 --> E1[⚙️ AI生成问卷 /questionnaire/generate]:::portSystem
+        E1 --> E2[📱 提交答案 /questionnaire/submit]:::portMiniApp
+        E2 --> E3[📱 问卷历史 /questionnaire/history/{memberId}]:::portMiniApp
+        E3 --> E4[📱 查看快照 /questionnaire/snapshot/{memberId}]:::portMiniApp
+    end
+
+    subgraph 关系质量分析
+        E4 --> F1[⚙️ 计算评分 /relationship/calculate]:::portSystem
+        F1 --> F2[📱 质量评分 /relationship/scores]:::portMiniApp
+        F2 --> F3[📱 健康预警 /relationship/health-alerts]:::portMiniApp
+        F3 --> F4[📱 里程碑 /relationship/milestones]:::portMiniApp
+        F4 --> F5[📱 家庭属性 /attributes/get<br>计算 /attributes/calculate · 更新 /attributes/update]:::portMiniApp
     end
 
-    subgraph 家庭关系管理
-        C3 --> D1[AI生成关系问卷 /generate]
-        D1 --> D2[提交问卷答案 /submit]
-        D2 --> D3[获取关系质量评分 /scores]
-        D3 --> D4[计算保存评分 /calculate]
-        D4 --> D5[获取健康预警 /health-alerts]
-        D5 --> D6[获取里程碑 /milestones]
-        D6 --> D7[互动记录 /add]
-        D7 --> D8[互动列表 /list]
+    subgraph 互动记录
+        F5 --> G1[📱 互动类型 /interaction/types]:::portMiniApp
+        G1 --> G2[📱 添加互动 /interaction/add]:::portMiniApp
+        G2 --> G3[📱 互动列表 /interaction/list]:::portMiniApp
     end
 
-    subgraph 家长绑定指导师
-        C3 --> E1[确认绑定指导师 /accept]
-        E1 --> E2[获取绑定指导师列表 /guides]
-        E2 --> E3[解除绑定 /unbind]
+    subgraph 规划师绑定
+        G3 --> H1[📱 待审批绑定 /teacher-bindings/pending]:::portMiniApp
+        H1 --> H2[📱 审批通过 /teacher-bindings/approve<br>拒绝 /teacher-bindings/reject]:::portMiniApp
+        H2 --> H3[📱 我的请求 /teacher-bindings/my-requests]:::portMiniApp
+        H3 --> H4[📱 取消绑定 /teacher-bindings/cancel]:::portMiniApp
+        H4 --> H5[📋 规划师绑定 /guide-bind]:::portGuide
     end
 
-    R1(("👤 家长")):::actor
-    R2(("👶 孩子")):::role
-    R3(("👨‍🏫 规划师")):::role
+    %% 角色标注
+    RP(("👤 家长")):::actor
+    RC(("👶 孩子")):::role
+    RT(("📋 规划师")):::role
 
-    B2 -.- R2
-    E2 -.- R3
+    B6 -.- RC
+    H5 -.- RT
 ```
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/family/user/create-family` | FamilyUserController | 创建新家庭 |
-| `/api/family/user/join-family` | FamilyUserController | 加入家庭 |
-| `/api/family/user/info` | FamilyUserController | 获取用户信息 |
-| `/api/family/user/update` | FamilyUserController | 更新用户信息 |
-| `/api/family/user/children` | FamilyUserController | 创建孩子 |
-| `/api/family/user/children/list` | FamilyUserController | 获取孩子列表 |
-| `/api/family/user/kick` | FamilyUserController | 踢出家庭成员 |
-| `/api/family/user/switch-role` | FamilyUserController | 切换角色 |
-| `/api/family/user/roles` | FamilyUserController | 获取角色列表 |
-| `/api/family/user/members/visible` | FamilyUserController | 可见成员列表 |
-| `/api/family/invite/generate` | FamilyInviteController | 生成邀请 |
-| `/api/family/invite/qrcode` | FamilyInviteController | 生成邀请二维码 |
-| `/api/family/invite/accept-by-code` | FamilyInviteController | 通过邀请码加入 |
-| `/api/family/invite/validate` | FamilyInviteController | 校验邀请令牌 |
-| `/api/family/invite/accept` | FamilyInviteController | 接受邀请 |
-| `/api/family/invite/revoke` | FamilyInviteController | 吊销邀请 |
-| `/api/family/invite/transfer-admin` | FamilyInviteController | 转让管理员 |
-| `/api/family/member/add` | FamilyMembersController | 添加家庭成员 |
-| `/api/family/member/list` | FamilyMembersController | 获取成员列表 |
-| `/api/family/member/switch` | FamilyMembersController | 切换成员视图 |
-| `/api/family/member/kick` | FamilyMembersController | 踢出成员 |
-| `/api/family/member/update` | FamilyMembersController | 更新成员信息 |
-| `/api/family/member/editable` | FamilyMembersController | 检查可编辑性 |
-| `/api/family/member/logs` | FamilyMembersController | 变更日志 |
-| `/api/bind/accept` | BindController | 确认绑定指导师 |
-| `/api/bind/guides` | BindController | 获取绑定指导师 |
-| `/api/bind/unbind` | BindController | 解除绑定规划师 |
-| `/api/family/relationship/scores` | RelationshipQualityController | 关系质量评分 |
-| `/api/family/relationship/calculate` | RelationshipQualityController | 计算评分 |
-| `/api/family/relationship/health-alerts` | RelationshipQualityController | 健康预警 |
-| `/api/family/relationship/milestones` | RelationshipQualityController | 里程碑 |
-| `/api/family/questionnaire/generate` | RelationshipQuestionnaireController | AI生成问卷 |
-| `/api/family/questionnaire/submit` | RelationshipQuestionnaireController | 提交问卷 |
-| `/api/family/interaction/add` | InteractionLogController | 添加互动记录 |
-| `/api/family/interaction/list` | InteractionLogController | 互动记录列表 |
-| `/api/family/teacher-bindings/pending` | TeacherFamilyBindingController | 待审批绑定 |
-| `/api/family/teacher-bindings/approve` | TeacherFamilyBindingController | 审批通过 |
+### 家庭创建与加入
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/user/create-family` | 创建新家庭 | 📱小程序 |
+| `/api/family/user/join-family` | 加入家庭 | 📱小程序 |
+| `/api/family/invite/generate` | 生成邀请 | 📱小程序 |
+| `/api/family/invite/qrcode` | 生成邀请二维码 | 📱小程序 |
+| `/api/family/invite-code` | 查看邀请码 | 📱小程序 |
+| `/api/family/invite-code/generate` | 生成新邀请码 | 📱小程序 |
+| `/api/family/invite/accept-by-code` | 通过邀请码加入 | 📱小程序 |
+| `/api/family/invite/validate` | 校验邀请令牌 | 📱小程序 |
+| `/api/family/invite/accept` | 接受邀请 | 📱小程序 |
+| `/api/family/invite/check-family` | 查询家庭状态 | 📱小程序 |
+| `/api/family/invite/revoke` | 吊销邀请 | 📱小程序 |
+
+### 用户与角色管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/user/info` | 获取用户信息 | 📱小程序 |
+| `/api/family/user/update` | 更新用户信息 | 📱小程序 |
+| `/api/family/user/roles` | 获取角色列表 | 📱小程序 |
+| `/api/family/user/switch-role` | 切换角色 | 📱小程序 |
+| `/api/family/user/switch-mode` | 切换模式 | 📱小程序 |
+| `/api/family/user/switch-to-child` | 切换到孩子视角 | 📱小程序 |
+| `/api/family/user/switch-back-to-parent` | 切换回家长 | 📱小程序 |
+| `/api/family/user/switch-back-verify` | 切换回家长验证 | 📱小程序 |
+
+### 家庭成员管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/member/add` | 添加家庭成员 | 📱小程序 |
+| `/api/family/member/list` | 成员列表 | 📱小程序 |
+| `/api/family/member/switch` | 切换成员视图 | 📱小程序 |
+| `/api/family/member/kick` | 踢出成员 | 📱小程序 |
+| `/api/family/member/update` | 更新成员信息 | 📱小程序 |
+| `/api/family/member/editable` | 检查可编辑性 | 📱小程序 |
+| `/api/family/member/logs` | 变更日志 | 📱小程序 |
+| `/api/family/user/children` | 创建孩子 | 📱小程序 |
+| `/api/family/user/children/list` | 孩子列表 | 📱小程序 |
+| `/api/family/user/children/update` | 更新孩子信息 | 📱小程序 |
+| `/api/family/user/members/visible` | 可见成员列表 | 📱小程序 |
+| `/api/family/user/members/update-visibility` | 更新可见性 | 📱小程序 |
+| `/api/family/user/kick` | 踢出成员 | 📱小程序 |
+| `/api/family/user/family-members` | 家庭成员列表 | 📱小程序 |
+
+### 家庭设置
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/invite/transfer-admin` | 转让管理员 | 📱小程序 |
+
+### 家庭关系问卷
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/questionnaire/generate` | AI生成关系问卷 | ⚙️系统自动 |
+| `/api/family/questionnaire/submit` | 提交问卷答案 | 📱小程序 |
+| `/api/family/questionnaire/history/{memberId}` | 问卷历史 | 📱小程序 |
+| `/api/family/questionnaire/snapshot/{memberId}` | 问卷快照 | 📱小程序 |
+
+### 关系质量分析
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/relationship/calculate` | 计算保存评分 | ⚙️系统自动 |
+| `/api/family/relationship/scores` | 关系质量评分 | 📱小程序 |
+| `/api/family/relationship/health-alerts` | 健康预警 | 📱小程序 |
+| `/api/family/relationship/milestones` | 里程碑 | 📱小程序 |
+| `/api/family/attributes/get` | 获取家庭属性 | 📱小程序 |
+| `/api/family/attributes/calculate` | 计算家庭属性 | ⚙️系统自动 |
+| `/api/family/attributes/update` | 更新家庭属性 | 📱小程序 |
+
+### 互动记录
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/interaction/types` | 互动类型列表 | 📱小程序 |
+| `/api/family/interaction/add` | 添加互动记录 | 📱小程序 |
+| `/api/family/interaction/list` | 互动记录列表 | 📱小程序 |
+
+### 规划师绑定
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/family/teacher-bindings/pending` | 待审批绑定 | 📱小程序 |
+| `/api/family/teacher-bindings/approve` | 审批通过 | 📱小程序 |
+| `/api/family/teacher-bindings/reject` | 拒绝绑定 | 📱小程序 |
+| `/api/family/teacher-bindings/my-requests` | 我的请求 | 📱小程序 |
+| `/api/family/teacher-bindings/cancel` | 取消绑定 | 📱小程序 |
+| `/api/family/guide-bind` | 规划师绑定 | 📋规划师端 |

docs/flows/growth-record-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 成长档案
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,44 +11,57 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 成长档案创建
-        A1(("家长")) --> A2{创建方式}
-        A2 -->|手动创建| A3[创建成长档案 /record/create]
-        A2 -->|上传PDF报告| A4[上传测评报告PDF /upload-and-parse]
-        A2 -->|创建并购买测评| A5[创建档案+购买 /create-with-order]
-        A4 --> A6[PDF解析引擎 (Stage 1)]
-        A6 --> A7{是否重复?}
-        A7 -->|重复| A8[检查哈希去重 /check-duplicate]
-        A7 -->|新记录| A9[创建成长档案 (Stage 2) /create-from-upload]
-        A3 --> A10[录入基础信息]
+        A1(("👤 家长")):::portMiniApp --> A2{📱 创建方式}:::portMiniApp
+        A2 -->|手动创建| A3[📱 创建成长档案 /record/create]:::portMiniApp
+        A2 -->|上传PDF报告| A4[📱 上传测评报告PDF /upload-and-parse]:::portMiniApp
+        A2 -->|创建并购买测评| A5[📱 创建档案+购买 /create-with-order]:::portMiniApp
+        A4 --> A6[⚙️ PDF解析引擎 (Stage 1)]:::portSystem
+        A6 --> A7{⚙️ 是否重复?}:::portSystem
+        A7 -->|重复| A8[⚙️ 检查哈希去重 /check-duplicate]:::portSystem
+        A7 -->|新记录| A9[📱 创建成长档案 (Stage 2) /create-from-upload]:::portMiniApp
+        A3 --> A10[📱 录入基础信息]:::portMiniApp
         A9 --> A10
     end
 
     subgraph 补充材料
-        A10 --> B1[创建补充记录 /supplement]
-        B1 --> B2[获取补充记录列表 /{id}/supplements]
+        A10 --> B1[📱 创建补充记录 /supplement]:::portMiniApp
+        B1 --> B2[📱 获取补充记录列表 /{id}/supplements]:::portMiniApp
     end
 
     subgraph 外部数据同步
-        A10 --> C1[外部系统测评同步 /external/sync]
-        C1 --> C2[数据融合]
+        A10 --> C1[📱 外部系统测评同步 /external/sync]:::portMiniApp
+        C1 --> C2[⚙️ 数据融合]:::portSystem
     end
 
     subgraph 查询与管理
-        C2 --> D1[获取家长的成长档案列表 /list]
-        D1 --> D2[获取指定孩子的档案 /child/{childId}]
-        D2 --> D3[获取孩子的档案 /child-records]
-        D3 --> D4[获取档案详情 /{id}]
-        D4 --> D5[删除成长档案 /{id}/delete]
+        C2 --> D1[📱 获取家长的成长档案列表 /list]:::portMiniApp
+        D1 --> D2[📱 获取指定孩子的档案 /child/{childId}]:::portMiniApp
+        D2 --> D3[📱 获取孩子的档案 /child-records]:::portMiniApp
+        D3 --> D4[📱 获取档案详情 /{id}]:::portMiniApp
+        D4 --> D5[📱 删除成长档案 /{id}/delete]:::portMiniApp
     end
 
     subgraph 生长记录
-        D1 --> E1[获取生长记录列表 /list]
-        E1 --> E2[获取生长记录详情 /detail]
-        E2 --> E3[创建生长记录 /create]
-        E3 --> E4[更新生长记录 /update]
-        E4 --> E5[删除生长记录 /delete]
+        D1 --> E1[📱 获取生长记录列表 /list]:::portMiniApp
+        E1 --> E2[📱 获取生长记录详情 /detail]:::portMiniApp
+        E2 --> E3[📱 创建生长记录 /create]:::portMiniApp
+        E3 --> E4[📱 更新生长记录 /update]:::portMiniApp
+        E4 --> E5[📱 删除生长记录 /delete]:::portMiniApp
+    end
+
+    subgraph 成长计划
+        E5 --> F1[📱 创建计划 /growth/plan/create]:::portMiniApp
+        F1 --> F2[📱 更新计划 /growth/plan/update]:::portMiniApp
+        F2 --> F3[📱 查看孩子计划 /growth/plan/child/{childId}]:::portMiniApp
+        F3 --> F4[📱 激活计划 /growth/plan/child/{childId}/active]:::portMiniApp
+        F4 --> F5[📱 计划详情 /growth/plan/{id}]:::portMiniApp
+        F5 --> F6[📱 审核计划 /growth/plan/{id}/review]:::portMiniApp
     end
 
     R1(("👤 家长")):::actor
@@ -60,23 +75,29 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/growth/record/create` | 创建成长档案 |
-| `/api/growth/record/create-with-order` | 创建档案并购买测评 |
-| `/api/growth/record/list` | 获取家长的档案列表 |
-| `/api/growth/record/child/{childId}` | 获取指定孩子档案 |
-| `/api/growth/record/child-records` | 获取孩子的成长档案 |
-| `/api/growth/record/{id}` | 获取档案详情 |
-| `/api/growth/record/{id}/delete` | 删除成长档案 |
-| `/api/growth/external/sync` | 外部系统同步 |
-| `/api/growth/record/upload-and-parse` | 上传并解析PDF |
-| `/api/growth/record/create-from-upload` | 创建成长档案（从上传） |
-| `/api/growth/record/supplement` | 创建补充记录 |
-| `/api/growth/record/check-duplicate` | 检查重复记录 |
-| `/api/growth/record/{id}/supplements` | 获取补充记录 |
-| `/api/health/growth/list` | 获取生长记录列表 |
-| `/api/health/growth/detail` | 获取生长记录详情 |
-| `/api/health/growth/create` | 创建生长记录 |
-| `/api/health/growth/update` | 更新生长记录 |
-| `/api/health/growth/delete` | 删除生长记录 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/growth/record/create` | 创建成长档案 | 📱小程序 |
+| `/api/growth/record/create-with-order` | 创建档案并购买测评 | 📱小程序 |
+| `/api/growth/record/list` | 获取家长的档案列表 | 📱小程序 |
+| `/api/growth/record/child/{childId}` | 获取指定孩子档案 | 📱小程序 |
+| `/api/growth/record/child-records` | 获取孩子的成长档案 | 📱小程序 |
+| `/api/growth/record/{id}` | 获取档案详情 | 📱小程序 |
+| `/api/growth/record/{id}/delete` | 删除成长档案 | 📱小程序 |
+| `/api/growth/external/sync` | 外部系统同步 | 📱小程序 |
+| `/api/growth/record/upload-and-parse` | 上传并解析PDF | 📱小程序 |
+| `/api/growth/record/create-from-upload` | 创建成长档案（从上传） | 📱小程序 |
+| `/api/growth/record/supplement` | 创建补充记录 | 📱小程序 |
+| `/api/growth/record/check-duplicate` | 检查重复记录 | ⚙️系统自动 |
+| `/api/growth/record/{id}/supplements` | 获取补充记录 | 📱小程序 |
+| `/api/health/growth/list` | 获取生长记录列表 | 📱小程序 |
+| `/api/health/growth/detail` | 获取生长记录详情 | 📱小程序 |
+| `/api/health/growth/create` | 创建生长记录 | 📱小程序 |
+| `/api/health/growth/update` | 更新生长记录 | 📱小程序 |
+| `/api/health/growth/delete` | 删除生长记录 | 📱小程序 |
+| `/api/growth/plan/create` | 创建成长计划 | 📱小程序 |
+| `/api/growth/plan/update` | 更新成长计划 | 📱小程序 |
+| `/api/growth/plan/child/{childId}` | 查看孩子成长计划 | 📱小程序 |
+| `/api/growth/plan/child/{childId}/active` | 激活孩子成长计划 | 📱小程序 |
+| `/api/growth/plan/{id}` | 查看计划详情 | 📱小程序 |
+| `/api/growth/plan/{id}/review` | 审核成长计划 | 📱小程序 |

docs/flows/growth-task-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 成长任务
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,13 +11,17 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 成长任务
-        A1(("孩子")) --> A2[获取成长任务列表 /list]
-        A2 --> A3{任务状态}
-        A3 -->|可领取| A4[领取任务 /claim]
-        A3 -->|动态任务| A5[接受动态任务 /accept-dynamic]
-        A4 --> A6[执行成长任务]
+        A1(("👶 孩子")):::portMiniApp --> A2[📱 获取成长任务列表 /list]:::portMiniApp
+        A2 --> A3{📱 任务状态}:::portMiniApp
+        A3 -->|可领取| A4[📱 领取任务 /claim]:::portMiniApp
+        A3 -->|动态任务| A5[📱 接受动态任务 /accept-dynamic]:::portMiniApp
+        A4 --> A6[📱 执行成长任务]:::portMiniApp
         A5 --> A6
     end
 
@@ -26,8 +32,8 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/growth-task/list` | 成长任务列表 |
-| `/api/growth-task/claim` | 领取任务 |
-| `/api/growth-task/accept-dynamic` | 接受动态任务 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/growth-task/list` | 成长任务列表 | 📱小程序 |
+| `/api/growth-task/claim` | 领取任务 | 📱小程序 |
+| `/api/growth-task/accept-dynamic` | 接受动态任务 | 📱小程序 |

docs/flows/guide-system-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 成长规划师体系
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,119 +11,329 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
+
+    subgraph 入驻与认证
+        A1(("📋 成长规划师")):::portGuide --> A2{已有账号?}
+        A2 -->|否| A3[📋 注册 /register]:::portGuide
+        A3 --> A4[📋 提交入驻申请 /application/submit]:::portGuide
+        A2 -->|是| A5[📋 登录 → 查看状态 /applications]:::portGuide
+        A4 --> A6[🖥 管理员审批]:::portAdmin
+        A6 --> A7{审批结果}
+        A7 -->|通过| A8[📋 规划师激活<br>查看激活记录 /application/{id}/records]:::portGuide
+        A7 -->|驳回| A9[📋 撤回 /withdraw · 重新提交 /resubmit]:::portGuide
+        A9 --> A4
+        A8 --> A10[📋 查看我的申请 /applications/my]:::portGuide
+    end
 
-    subgraph 规划师入驻
-        A1(("成长规划师")) --> A2{是否已注册}
-        A2 -->|否| A3[规划师注册 /register]
-        A3 --> A4[提交申请 /application/submit]
-        A4 --> A5[管理员审批]
-        A5 --> A6{审批结果}
-        A6 -->|通过| A7[规划师激活]
-        A6 -->|驳回| A8[撤回申请 /withdraw]
-        A8 --> A9[重新提交 /resubmit]
-        A7 --> A10[获取申请记录 /applications]
+    subgraph 个人信息
+        A10 --> B1[📋 我的信息 /my]:::portGuide
+        B1 --> B2[📋 我的套餐 /my/packages]:::portGuide
+        B2 --> B3[📋 上级规划师 /parent-guide]:::portGuide
+        B3 --> B4[📋 下级列表 /child-guides<br>全部下级 /all-child-guides]:::portGuide
     end
 
     subgraph 团队管理
-        A10 --> B1[获取我的团队 /my-team]
-        B1 --> B2[获取邀请码 /invite-code]
-        B2 --> B3[生成邀请码 /invite-code/generate]
-        B3 --> B4[获取成员列表 /members]
-        B4 --> B5[通过邀请码加入 /join-by-invite]
-        B5 --> B6[检查邀请状态 /check-status]
-        B6 --> B7[离开团队 /leave]
-        B7 --> B8[获取团队统计 /stats]
+        B4 --> C1[📋 我的团队 /team/my-team]:::portGuide
+        C1 --> C2[📋 获取邀请码 /team/invite-code]:::portGuide
+        C2 --> C3[📋 生成新邀请码 /team/invite-code/generate]:::portGuide
+        C3 --> C4[📋 成员列表 /team/members]:::portGuide
+        C4 --> C5[📋 检查邀请 /team/check-status]:::portGuide
+        C5 --> C6[📋 通过码加入 /team/join-by-invite]:::portGuide
+        C6 --> C7[📋 离开团队 /team/leave]:::portGuide
+        C7 --> C8[📋 团队统计 /team/stats]:::portGuide
+    end
+
+    subgraph 邀请与绑定家庭
+        C8 --> D1[📋 生成家长邀请 /parent-invite/generate]:::portGuide
+        D1 --> D2[📱 家长接受邀请 /parent-invite/accept]:::portMiniApp
+        D2 --> D3[📋 生成绑定邀请 /bind/invite]:::portGuide
+        D3 --> D4[📋 校验邀请 /bind/validate]:::portGuide
+        D4 --> D5[📋 获取绑定家庭 /families/bound-families]:::portGuide
+        D5 --> D6[📋 家庭列表 /family/list]:::portGuide
     end
 
-    subgraph 绑定家庭
-        A10 --> C1[生成绑定邀请 /invite]
-        C1 --> C2[校验邀请 /validate]
-        C2 --> C3[家长审批绑定]
-        C3 --> C4[获取绑定家庭列表 /bound-families]
+    subgraph 家庭管理与任务
+        D6 --> E1[📋 家庭概览 /families/{familyId}/overview]:::portGuide
+        E1 --> E2[📋 仪表盘统计 /families/dashboard-stats]:::portGuide
+        E2 --> E3[📋 查看孩子任务 /families/{familyId}/children/{childId}/tasks]:::portGuide
+        E3 --> E4[📋 待审核 /children/{childId}/pending-review]:::portGuide
+        E4 --> E5[📋 任务审核 /families/{familyId}/tasks/{taskId}/review]:::portGuide
+        E5 --> E6[📋 批量审核 /tasks/batch-review]:::portGuide
+        E6 --> E7[📋 任务详情 /tasks/{taskId}<br>删除 /tasks/{taskId}/delete]:::portGuide
     end
 
     subgraph 任务模板管理
-        C4 --> D1[获取我的模板 /my]
-        D1 --> D2[创建模板 /create]
-        D2 --> D3[更新模板 /update]
-        D3 --> D4[更新状态 /update-status]
-        D4 --> D5[删除模板 /delete]
-        D5 --> D6[增加销量 /increment-sales]
-        D6 --> D7[获取模板列表 /templates]
+        E7 --> F1[📋 我的模板 /packages/my]:::portGuide
+        F1 --> F2[📋 创建模板 /packages/create]:::portGuide
+        F2 --> F3[📋 更新模板 /packages/update]:::portGuide
+        F3 --> F4[📋 更新状态 /packages/update-status]:::portGuide
+        F4 --> F5[📋 模板列表 /packages/list]:::portGuide
+        F5 --> F6[📋 模板详情 /packages/detail<br>模板定价 /packages/template-detail]:::portGuide
+        F6 --> F7[📋 增加销量 /packages/increment-sales]:::portGuide
+        F7 --> F8[📋 等级筛选 /packages/level/{level}]:::portGuide
+        F8 --> F9[📋 套餐包列表 /guide-packages /package/templates]:::portGuide
+        F9 --> F10[📋 添加套餐 /package/add · 查看 /package/{packageId}<br>更新 /package/{packageId}/update · 删除 /package/{packageId}/delete]:::portGuide
+    end
+
+    subgraph 活动管理
+        F10 --> G1[📋 创建活动 /activities/create]:::portGuide
+        G1 --> G2[📋 活动列表 /activities/list]:::portGuide
+        G2 --> G3[📋 活动详情 /activities/detail]:::portGuide
+        G3 --> G4[📋 更新 /activities/update]:::portGuide
+        G4 --> G5[📋 发布 /activities/publish]:::portGuide
+        G5 --> G6[📋 下架 /activities/cancel · 删除 /activities/delete]:::portGuide
     end
 
     subgraph 训练方案
-        C4 --> E1[获取方案列表 /list]
-        E1 --> E2[创建方案 /create]
-        E2 --> E3[添加项目 /items/add]
-        E3 --> E4[从推荐生成 /generate-from-recommendations]
-        E4 --> E5[下发方案 /deploy]
-        E5 --> E6[执行看板 /execution-board]
-        E6 --> E7[删除方案 /delete]
+        G6 --> H1[📋 方案列表 /training-plans/list]:::portGuide
+        H1 --> H2[📋 创建方案 /training-plans/create]:::portGuide
+        H2 --> H3[📋 添加项目 /training-plans/items/add]:::portGuide
+        H3 --> H4[📋 更新项目 /training-plans/items/update · 删除 /items/delete]:::portGuide
+        H4 --> H5[📋 从推荐生成 /training-plans/generate-from-recommendations]:::portGuide
+        H5 --> H6[📋 下发方案 /training-plans/deploy]:::portGuide
+        H6 --> H7[📋 执行看板 /training-plans/execution-board]:::portGuide
+        H7 --> H8[📋 方案详情 /training-plans/detail]:::portGuide
+        H8 --> H9[📋 更新 /training-plans/update · 删除 /training-plans/delete]:::portGuide
+    end
+
+    subgraph 评估管理
+        H9 --> I1[📋 可用测评资料 /assessment/materials]:::portGuide
+        I1 --> I2[📋 家庭测评列表 /assessment/families]:::portGuide
+        I2 --> I3[📋 启用 /assessment/family/enable]:::portGuide
+        I3 --> I4[📋 查看 /assessment/family/{familyId}]:::portGuide
+        I4 --> I5[📋 禁用 /assessment/family/{familyId}/disable]:::portGuide
+    end
+
+    subgraph 成长计划
+        I5 --> J1[📋 计划列表 /plans/family-list]:::portGuide
+        J1 --> J2[📋 计划详情 /plans/detail]:::portGuide
+        J2 --> J3[📋 激活 /plans/activate]:::portGuide
+        J3 --> J4[📋 审核 /plans/review]:::portGuide
+    end
+
+    subgraph 成长记录
+        J4 --> K1[📋 创建记录 /record/create]:::portGuide
+        K1 --> K2[📋 我的记录 /record/my-records]:::portGuide
+        K2 --> K3[📋 记录详情 /record/detail/{id}]:::portGuide
     end
 
     subgraph 咨询消息
-        C4 --> F1[家长发送咨询 /send]
-        F1 --> F2[规划师回复 /{messageId}/reply]
-        F2 --> F3[咨询列表 /list]
-        F3 --> F4[未读消息数 /unread-count]
+        K3 --> L1[📋 发送咨询 /messages/send]:::portGuide
+        L1 --> L2[📋 我的咨询 /messages/my]:::portGuide
+        L2 --> L3[📋 回复 /messages/{messageId}/reply]:::portGuide
+        L3 --> L4[📋 咨询列表 /messages/list]:::portGuide
+        L4 --> L5[📋 未读消息 /messages/unread-count]:::portGuide
+    end
+
+    subgraph 订单与佣金
+        L5 --> M1[📋 订单列表 /orders/list]:::portGuide
+        M1 --> M2[📋 订单统计 /orders/stats]:::portGuide
+        M2 --> M3[📋 订单详情 /orders/detail]:::portGuide
     end
 
-    subgraph 订单佣金
-        C4 --> G1[获取订单列表 /list]
-        G1 --> G2[获取订单统计 /stats]
-        G2 --> G3[获取订单详情 /detail]
+    subgraph 升迁与新申请
+        M3 --> N1[📋 新入驻申请 /apply/new]:::portGuide
+        N1 --> N2[📋 升级申请 /apply/upgrade]:::portGuide
+        N2 --> A2
     end
 
-    R1(("📋 成长规划师")):::actor
-    R2(("👤 家长")):::role
-    R3(("🔧 管理员")):::role
+    subgraph 教师班级管理
+        N2 --> O1[📋 教师信息 /api/teacher/info]:::portGuide
+        O1 --> O2[📋 班级列表 /api/teacher/classes/list]:::portGuide
+        O2 --> O3[📋 班级详情 /api/teacher/classes]:::portGuide
+        O3 --> O4{📋 操作}:::portGuide
+        O4 -->|学生管理| O5[📋 查看学生 /api/teacher/classes/{classId}/students]:::portGuide
+        O5 --> O6[📋 添加学生 /api/teacher/classes/{classId}/students/add]:::portGuide
+        O6 --> O7[📋 学生详情 /api/teacher/classes/{classId}/students/{studentId}]:::portGuide
+        O4 -->|报告| O8[📋 生成报告 /api/teacher/classes/{classId}/report]:::portGuide
+        O4 -->|进度| O9[📋 学生进度 /api/teacher/students/{studentId}/progress]:::portGuide
+        O3 --> OA[📋 教师任务 /api/teacher/tasks]:::portGuide
+        OA --> OB[📋 任务列表 /api/teacher/tasks/list]:::portGuide
+    end
 
-    A1 -.- R1
-    C3 -.- R2
-    A5 -.- R3
+    %% 角色标注
+    RP(("📋 成长规划师")):::actor
+    RP2(("👤 家长")):::role
+    RADM(("🔧 管理员")):::role
+
+    A1 -.- RP
+    D2 -.- RP2
+    A6 -.- RADM
 ```
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/guide/register` | 规划师注册 |
-| `/api/guide/application/submit` | 提交申请 |
-| `/api/guide/application/withdraw` | 撤回申请 |
-| `/api/guide/application/resubmit` | 重新提交 |
-| `/api/guide/applications` | 申请列表 |
-| `/api/guide/invite-code/generate` | 生成邀请码 |
-| `/api/guide/invite-codes` | 邀请码列表 |
-| `/api/guide/invite-code/validate` | 验证邀请码 |
-| `/api/guide/child-guides` | 下级规划师列表 |
-| `/api/guide/parent-guide` | 上级规划师 |
-| `/api/guide/package/add` | 添加任务模板 |
-| `/api/guide/package/{packageId}` | 查看模板定价 |
-| `/api/guide/team/my-team` | 获取团队 |
-| `/api/guide/team/invite-code` | 团队邀请码 |
-| `/api/guide/team/members` | 团队成员 |
-| `/api/guide/team/join-by-invite` | 通过邀请码加入 |
-| `/api/guide/team/leave` | 离开团队 |
-| `/api/guide/team/stats` | 团队统计 |
-| `/api/guide/bind/invite` | 生成绑定邀请 |
-| `/api/guide/bind/validate` | 校验邀请 |
-| `/api/guide/families/bound-families` | 绑定家庭列表 |
-| `/api/guide/families/{familyId}/overview` | 家庭概览 |
-| `/api/guide/families/{familyId}/children/{childId}/tasks` | 孩子任务 |
-| `/api/guide/packages/my` | 我的模板 |
-| `/api/guide/packages/create` | 创建模板 |
-| `/api/guide/packages/update` | 更新模板 |
-| `/api/guide/packages/delete` | 删除模板 |
-| `/api/guide/training-plans/list` | 方案列表 |
-| `/api/guide/training-plans/create` | 创建方案 |
-| `/api/guide/training-plans/items/add` | 添加项目 |
-| `/api/guide/training-plans/deploy` | 下发方案 |
-| `/api/guide/training-plans/execution-board` | 执行看板 |
-| `/api/guide/orders/list` | 订单列表 |
-| `/api/guide/orders/stats` | 订单统计 |
-| `/api/guide/messages/send` | 发送咨询 |
-| `/api/guide/messages/list` | 咨询列表 |
-| `/api/guide/messages/{messageId}/reply` | 回复咨询 |
-| `/api/guide/assessment/materials` | 可用测评资料 |
-| `/api/guide/assessment/family/enable` | 启用家庭测评 |
+### 入驻与认证
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/register` | 规划师注册 | 📋规划师端 |
+| `/api/guide/application/submit` | 提交入驻申请 | 📋规划师端 |
+| `/api/guide/application/withdraw` | 撤回申请 | 📋规划师端 |
+| `/api/guide/application/resubmit` | 重新提交申请 | 📋规划师端 |
+| `/api/guide/application/{id}/records` | 申请审批记录 | 📋规划师端 |
+| `/api/guide/applications` | 申请列表 | 📋规划师端 |
+| `/api/guide/applications/my` | 我的申请 | 📋规划师端 |
+| `/api/guide/apply/new` | 新入驻申请 | 📋规划师端 |
+| `/api/guide/apply/upgrade` | 升级申请 | 📋规划师端 |
+
+### 个人信息
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/my` | 我的信息 | 📋规划师端 |
+| `/api/guide/my/packages` | 我的套餐 | 📋规划师端 |
+| `/api/guide/parent-guide` | 上级规划师 | 📋规划师端 |
+| `/api/guide/child-guides` | 下级规划师列表 | 📋规划师端 |
+| `/api/guide/all-child-guides` | 全部下级规划师 | 📋规划师端 |
+
+### 团队管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/team/my-team` | 获取我的团队 | 📋规划师端 |
+| `/api/guide/team/invite-code` | 获取团队邀请码 | 📋规划师端 |
+| `/api/guide/team/invite-code/generate` | 生成团队邀请码 | 📋规划师端 |
+| `/api/guide/team/members` | 团队成员列表 | 📋规划师端 |
+| `/api/guide/team/check-status` | 检查邀请状态 | 📋规划师端 |
+| `/api/guide/team/join-by-invite` | 通过邀请码加入 | 📋规划师端 |
+| `/api/guide/team/leave` | 离开团队 | 📋规划师端 |
+| `/api/guide/team/stats` | 团队统计 | 📋规划师端 |
+
+### 邀请与绑定家庭
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/parent-invite/generate` | 生成家长邀请 | 📋规划师端 |
+| `/api/guide/parent-invite/accept` | 家长接受邀请 | 📱小程序 |
+| `/api/guide/bind/invite` | 生成绑定邀请 | 📋规划师端 |
+| `/api/guide/bind/validate` | 校验邀请 | 📋规划师端 |
+| `/api/guide/families/bound-families` | 绑定家庭列表 | 📋规划师端 |
+| `/api/guide/family/list` | 家庭列表 | 📋规划师端 |
+
+### 家庭管理与任务审核
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/families/{familyId}/overview` | 家庭概览 | 📋规划师端 |
+| `/api/guide/families/dashboard-stats` | 仪表盘统计 | 📋规划师端 |
+| `/api/guide/families/{familyId}/children/{childId}/tasks` | 孩子任务列表 | 📋规划师端 |
+| `/api/guide/families/{familyId}/children/{childId}/pending-review` | 待审核任务 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/{taskId}/review` | 审核任务 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/batch-review` | 批量审核任务 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/{taskId}` | 查看任务详情 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/{taskId}/delete` | 删除任务 | 📋规划师端 |
+
+### 任务模板/套餐包管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/packages/my` | 我的模板 | 📋规划师端 |
+| `/api/guide/packages/create` | 创建模板 | 📋规划师端 |
+| `/api/guide/packages/update` | 更新模板 | 📋规划师端 |
+| `/api/guide/packages/update-status` | 更新模板状态 | 📋规划师端 |
+| `/api/guide/packages/delete` | 删除模板 | 📋规划师端 |
+| `/api/guide/packages/list` | 模板列表 | 📋规划师端 |
+| `/api/guide/packages/detail` | 模板详情 | 📋规划师端 |
+| `/api/guide/packages/template-detail` | 模板定价详情 | 📋规划师端 |
+| `/api/guide/packages/increment-sales` | 增加销量 | 📋规划师端 |
+| `/api/guide/packages/level/{level}` | 按等级筛选 | 📋规划师端 |
+| `/api/guide/packages/templates` | 获取模板库 | 📋规划师端 |
+| `/api/guide/guide-packages` | 套餐包列表 | 📋规划师端 |
+| `/api/guide/package/add` | 添加套餐包 | 📋规划师端 |
+| `/api/guide/package/{packageId}` | 查看套餐包详情 | 📋规划师端 |
+| `/api/guide/package/{packageId}/update` | 更新套餐包 | 📋规划师端 |
+| `/api/guide/package/{packageId}/delete` | 删除套餐包 | 📋规划师端 |
+| `/api/guide/package/templates` | 套餐模板列表 | 📋规划师端 |
+
+### 活动管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/activities/create` | 创建活动 | 📋规划师端 |
+| `/api/guide/activities/list` | 活动列表 | 📋规划师端 |
+| `/api/guide/activities/detail` | 活动详情 | 📋规划师端 |
+| `/api/guide/activities/update` | 更新活动 | 📋规划师端 |
+| `/api/guide/activities/publish` | 发布活动 | 📋规划师端 |
+| `/api/guide/activities/cancel` | 下架活动 | 📋规划师端 |
+| `/api/guide/activities/delete` | 删除活动 | 📋规划师端 |
+
+### 训练方案
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/training-plans/list` | 方案列表 | 📋规划师端 |
+| `/api/guide/training-plans/create` | 创建方案 | 📋规划师端 |
+| `/api/guide/training-plans/items/add` | 添加项目 | 📋规划师端 |
+| `/api/guide/training-plans/items/update` | 更新项目 | 📋规划师端 |
+| `/api/guide/training-plans/items/delete` | 删除项目 | 📋规划师端 |
+| `/api/guide/training-plans/generate-from-recommendations` | 从推荐生成 | 📋规划师端 |
+| `/api/guide/training-plans/deploy` | 下发方案 | 📋规划师端 |
+| `/api/guide/training-plans/execution-board` | 执行看板 | 📋规划师端 |
+| `/api/guide/training-plans/detail` | 方案详情 | 📋规划师端 |
+| `/api/guide/training-plans/update` | 更新方案 | 📋规划师端 |
+| `/api/guide/training-plans/delete` | 删除方案 | 📋规划师端 |
+
+### 评估管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/assessment/materials` | 可用测评资料 | 📋规划师端 |
+| `/api/guide/assessment/families` | 家庭测评列表 | 📋规划师端 |
+| `/api/guide/assessment/family/enable` | 启用家庭测评 | 📋规划师端 |
+| `/api/guide/assessment/family/{familyId}` | 家庭测评详情 | 📋规划师端 |
+| `/api/guide/assessment/family/{familyId}/disable` | 禁用家庭测评 | 📋规划师端 |
+
+### 成长计划
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/plans/family-list` | 家庭计划列表 | 📋规划师端 |
+| `/api/guide/plans/detail` | 计划详情 | 📋规划师端 |
+| `/api/guide/plans/activate` | 激活计划 | 📋规划师端 |
+| `/api/guide/plans/review` | 审核计划 | 📋规划师端 |
+
+### 成长记录
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/record/create` | 创建成长记录 | 📋规划师端 |
+| `/api/guide/record/my-records` | 我的记录列表 | 📋规划师端 |
+| `/api/guide/record/detail/{id}` | 记录详情 | 📋规划师端 |
+
+### 咨询消息
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/messages/send` | 发送咨询 | 📋规划师端 |
+| `/api/guide/messages/my` | 我的咨询 | 📋规划师端 |
+| `/api/guide/messages/list` | 咨询列表 | 📋规划师端 |
+| `/api/guide/messages/{messageId}/reply` | 回复咨询 | 📋规划师端 |
+| `/api/guide/messages/unread-count` | 未读消息数 | 📋规划师端 |
+
+### 订单与佣金
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/guide/orders/list` | 订单列表 | 📋规划师端 |
+| `/api/guide/orders/stats` | 订单统计 | 📋规划师端 |
+| `/api/guide/orders/detail` | 订单详情 | 📋规划师端 |
+
+### 教师班级管理
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/teacher/info` | 教师信息 | 📋规划师端 |
+| `/api/teacher/classes/list` | 班级列表 | 📋规划师端 |
+| `/api/teacher/classes` | 班级详情 | 📋规划师端 |
+| `/api/teacher/classes/{classId}/students` | 查看学生 | 📋规划师端 |
+| `/api/teacher/classes/{classId}/students/add` | 添加学生 | 📋规划师端 |
+| `/api/teacher/classes/{classId}/students/{studentId}` | 学生详情 | 📋规划师端 |
+| `/api/teacher/classes/{classId}/report` | 生成报告 | 📋规划师端 |
+| `/api/teacher/students/{studentId}/progress` | 学生进度 | 📋规划师端 |
+| `/api/teacher/tasks` | 教师任务 | 📋规划师端 |
+| `/api/teacher/tasks/list` | 任务列表 | 📋规划师端 |
+
+### 教师班级管理
+| 端点 | 说明 | 角色 |
+|------|------|------|
+| `/api/teacher/info` | 教师信息 | 教师 |
+| `/api/teacher/classes/list` | 班级列表 | 教师 |
+| `/api/teacher/classes` | 班级详情 | 教师 |
+| `/api/teacher/classes/{classId}/students` | 查看学生 | 教师 |
+| `/api/teacher/classes/{classId}/students/add` | 添加学生 | 教师 |
+| `/api/teacher/classes/{classId}/students/{studentId}` | 学生详情 | 教师 |
+| `/api/teacher/classes/{classId}/report` | 生成报告 | 教师 |
+| `/api/teacher/students/{studentId}/progress` | 学生进度 | 教师 |
+| `/api/teacher/tasks` | 教师任务 | 教师 |
+| `/api/teacher/tasks/list` | 任务列表 | 教师 |

docs/flows/health-checkin-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 健康打卡体系
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,45 +11,49 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 每日健康打卡
-        A1(("家长/孩子")) --> A2[获取打卡列表 /list]
-        A2 --> A3[获取打卡详情 /detail]
-        A3 --> A4{打卡类型}
-        A4 -->|综合打卡| B1[创建打卡 /create]
-        A4 -->|运动打卡| B2[创建运动打卡 /create]
-        A4 -->|饮食打卡| B3[创建饮食打卡 /create]
-        A4 -->|睡眠打卡| B4[创建睡眠打卡 /create]
-        A4 -->|喝水打卡| B5[创建喝水打卡 /create]
-        A4 -->|冥想打卡| B6[创建冥想打卡 /create]
+        A1(("👤 家长/孩子")):::portMiniApp --> A2[📱 获取打卡列表 /list]:::portMiniApp
+        A2 --> A3[📱 获取打卡详情 /detail]:::portMiniApp
+        A3 --> A4{📱 打卡类型}:::portMiniApp
+        A4 -->|综合打卡| B1[📱 创建打卡 /create]:::portMiniApp
+        A4 -->|运动打卡| B2[📱 创建运动打卡 /create]:::portMiniApp
+        A4 -->|饮食打卡| B3[📱 创建饮食打卡 /create]:::portMiniApp
+        A4 -->|睡眠打卡| B4[📱 创建睡眠打卡 /create]:::portMiniApp
+        A4 -->|喝水打卡| B5[📱 创建喝水打卡 /create]:::portMiniApp
+        A4 -->|冥想打卡| B6[📱 创建冥想打卡 /create]:::portMiniApp
     end
 
     subgraph 打卡管理
-        B1 --> C1[更新打卡 /update]
-        C1 --> C2[删除打卡 /delete]
+        B1 --> C1[📱 更新打卡 /update]:::portMiniApp
+        C1 --> C2[📱 删除打卡 /delete]:::portMiniApp
     end
 
     subgraph 连续打卡
-        C2 --> D1[获取打卡进度 /progress/{childId}]
-        D1 --> D2[获取打卡统计 /stats]
-        D2 --> D3{打卡中断?}
-        D3 -->|是| D4[重置中断打卡 /reset]
-        D3 -->|否| D5[保持连续]
+        C2 --> D1[📱 获取打卡进度 /progress/{childId}]:::portMiniApp
+        D1 --> D2[📱 获取打卡统计 /stats]:::portMiniApp
+        D2 --> D3{📱 打卡中断?}:::portMiniApp
+        D3 -->|是| D4[📱 重置中断打卡 /reset]:::portMiniApp
+        D3 -->|否| D5[📱 保持连续]:::portMiniApp
     end
 
     subgraph 健康积分
-        D5 --> E1[获取健康积分信息 /info]
-        E1 --> E2[获取连续打卡天数 /streak]
+        D5 --> E1[📱 获取健康积分信息 /info]:::portMiniApp
+        E1 --> E2[📱 获取连续打卡天数 /streak]:::portMiniApp
     end
 
     subgraph 健康时间线
-        C2 --> F1[获取健康时间线 /list]
-        F1 --> F2[查看历史故事]
+        C2 --> F1[📱 获取健康时间线 /list]:::portMiniApp
+        F1 --> F2[📱 查看历史故事]:::portMiniApp
     end
 
     subgraph 健康预警
-        F2 --> G1[获取活跃预警 /list]
-        G1 --> G2[关闭预警 /dismiss]
+        F2 --> G1[📱 获取活跃预警 /list]:::portMiniApp
+        G1 --> G2[📱 关闭预警 /dismiss]:::portMiniApp
     end
 
     R1(("👤 家长/孩子")):::actor
@@ -59,31 +65,31 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/health/checkin/list` | HealthCheckinController | 获取打卡列表 |
-| `/api/health/checkin/create` | HealthCheckinController | 创建打卡记录 |
-| `/api/health/checkin/delete` | HealthCheckinController | 删除打卡记录 |
-| `/api/health/checkin/stats` | HealthCheckinController | 打卡统计 |
-| `/api/daily/checkin/list` | DailyCheckinController | 获取打卡列表 |
-| `/api/daily/checkin/detail` | DailyCheckinController | 获取打卡详情 |
-| `/api/daily/checkin/create` | DailyCheckinController | 创建打卡 |
-| `/api/daily/checkin/update` | DailyCheckinController | 更新打卡 |
-| `/api/daily/checkin/delete` | DailyCheckinController | 删除打卡 |
-| `/api/health/exercise/list` | HealthExerciseController | 运动打卡列表 |
-| `/api/health/exercise/create` | HealthExerciseController | 创建运动打卡 |
-| `/api/health/meal/list` | HealthMealController | 饮食打卡列表 |
-| `/api/health/meal/create` | HealthMealController | 创建饮食打卡 |
-| `/api/health/sleep/list` | HealthSleepController | 睡眠打卡列表 |
-| `/api/health/sleep/create` | HealthSleepController | 创建睡眠打卡 |
-| `/api/health/water/list` | HealthWaterController | 喝水打卡列表 |
-| `/api/health/water/create` | HealthWaterController | 创建喝水打卡 |
-| `/api/health/meditation/list` | HealthMeditationController | 冥想打卡列表 |
-| `/api/health/meditation/create` | HealthMeditationController | 创建冥想打卡 |
-| `/api/streak/progress/{childId}` | StreakController | 打卡进度 |
-| `/api/streak/reset` | StreakController | 重置中断打卡 |
-| `/api/health/score/info` | HealthScoreController | 健康积分信息 |
-| `/api/health/score/streak` | HealthScoreController | 连续天数 |
-| `/api/health/alert/list` | HealthAlertController | 活跃预警列表 |
-| `/api/health/alert/dismiss` | HealthAlertController | 关闭预警 |
-| `/api/health/timeline/list` | HealthTimelineController | 健康时间线 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/health/checkin/list` | 获取打卡列表 | 📱小程序 |
+| `/api/health/checkin/create` | 创建打卡记录 | 📱小程序 |
+| `/api/health/checkin/delete` | 删除打卡记录 | 📱小程序 |
+| `/api/health/checkin/stats` | 打卡统计 | 📱小程序 |
+| `/api/daily/checkin/list` | 获取打卡列表 | 📱小程序 |
+| `/api/daily/checkin/detail` | 获取打卡详情 | 📱小程序 |
+| `/api/daily/checkin/create` | 创建打卡 | 📱小程序 |
+| `/api/daily/checkin/update` | 更新打卡 | 📱小程序 |
+| `/api/daily/checkin/delete` | 删除打卡 | 📱小程序 |
+| `/api/health/exercise/list` | 运动打卡列表 | 📱小程序 |
+| `/api/health/exercise/create` | 创建运动打卡 | 📱小程序 |
+| `/api/health/meal/list` | 饮食打卡列表 | 📱小程序 |
+| `/api/health/meal/create` | 创建饮食打卡 | 📱小程序 |
+| `/api/health/sleep/list` | 睡眠打卡列表 | 📱小程序 |
+| `/api/health/sleep/create` | 创建睡眠打卡 | 📱小程序 |
+| `/api/health/water/list` | 喝水打卡列表 | 📱小程序 |
+| `/api/health/water/create` | 创建喝水打卡 | 📱小程序 |
+| `/api/health/meditation/list` | 冥想打卡列表 | 📱小程序 |
+| `/api/health/meditation/create` | 创建冥想打卡 | 📱小程序 |
+| `/api/streak/progress/{childId}` | 打卡进度 | 📱小程序 |
+| `/api/streak/reset` | 重置中断打卡 | 📱小程序 |
+| `/api/health/score/info` | 健康积分信息 | 📱小程序 |
+| `/api/health/score/streak` | 连续天数 | 📱小程序 |
+| `/api/health/alert/list` | 活跃预警列表 | 📱小程序 |
+| `/api/health/alert/dismiss` | 关闭预警 | 📱小程序 |
+| `/api/health/timeline/list` | 健康时间线 | 📱小程序 |

docs/flows/health-detection-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 身体健康检测
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,90 +11,92 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 注册与家庭
-        A1(("家长<br>开始")) --> A2[微信授权登录]
-        A2 --> A3[创建/加入家庭]
-        A3 --> A4[添加家庭成员<br>（孩子/老人等）]
+        A1(("👤 家长<br>开始")):::portMiniApp --> A2[📱 微信授权登录]:::portMiniApp
+        A2 --> A3[📱 创建/加入家庭]:::portMiniApp
+        A3 --> A4[📱 添加家庭成员<br>（孩子/老人等）]:::portMiniApp
     end
 
     subgraph 数据采集入口
-        A4 --> B0{选择检测方式}
-        B0 --> B1[上传肠道菌群PDF报告]
-        B0 --> B2[上传体检报告/化验单]
-        B0 --> B3[舌诊拍照上传]
-        B0 --> B4[填写健康问卷]
-        B0 --> B5[手动录入维度评分]
+        A4 --> B0{📱 选择检测方式}:::portMiniApp
+        B0 --> B1[📱 上传肠道菌群PDF报告]:::portMiniApp
+        B0 --> B2[📱 上传体检报告/化验单]:::portMiniApp
+        B0 --> B3[📱 舌诊拍照上传]:::portMiniApp
+        B0 --> B4[📱 填写健康问卷]:::portMiniApp
+        B0 --> B5[📱 手动录入维度评分]:::portMiniApp
     end
 
     subgraph AI解析层
-        B1 --> C1[PDF解析引擎<br>PdfParseService]
-        C1 --> C2{是否匹配到<br>家庭成员?}
-        C2 -->|自动匹配<br>姓名+性别+年龄| C3[标记到对应成员]
-        C2 -->|匹配失败| C4[提示家长手动绑定]
+        B1 --> C1[⚙️ PDF解析引擎<br>PdfParseService]:::portSystem
+        C1 --> C2{⚙️ 是否匹配到<br>家庭成员?}:::portSystem
+        C2 -->|自动匹配<br>姓名+性别+年龄| C3[⚙️ 标记到对应成员]:::portSystem
+        C2 -->|匹配失败| C4[📱 提示家长手动绑定]:::portMiniApp
 
-        B2 --> C5[OCR/结构化解析]
-        C5 --> C6[提取指标: 身高/体重/<br>血常规/视力等]
+        B2 --> C5[⚙️ OCR/结构化解析]:::portSystem
+        C5 --> C6[⚙️ 提取指标: 身高/体重/<br>血常规/视力等]:::portSystem
 
-        B3 --> C7[舌诊AI分析<br>TongueDiagnosisService]
-        C7 --> C8[舌苔/舌色/齿痕分析]
+        B3 --> C7[⚙️ 舌诊AI分析<br>TongueDiagnosisService]:::portSystem
+        C7 --> C8[⚙️ 舌苔/舌色/齿痕分析]:::portSystem
 
-        B4 --> C9[问卷评分计算]
-        B5 --> C10[直接录入评分]
+        B4 --> C9[⚙️ 问卷评分计算]:::portSystem
+        B5 --> C10[⚙️ 直接录入评分]:::portSystem
     end
 
     subgraph 报告预览与确认
-        C3 --> D1[生成解析预览<br>Phase 1 /parse-preview]
-        D1 --> D2{家长确认<br>数据是否正确?}
-        D2 -->|修改| D3[家长在线编辑指标]
+        C3 --> D1[📱 生成解析预览<br>Phase 1 /parse-preview]:::portMiniApp
+        D1 --> D2{📱 家长确认<br>数据是否正确?}:::portMiniApp
+        D2 -->|修改| D3[📱 家长在线编辑指标]:::portMiniApp
         D3 --> D2
-        D2 -->|确认| D4[正式入库<br>Phase 2 /confirm]
+        D2 -->|确认| D4[📱 正式入库<br>Phase 2 /confirm]:::portMiniApp
         C6 --> D1
         C8 --> D1
     end
 
     subgraph 7维健康评分
-        D4 --> E1[维度评分引擎]
-        E1 --> E2[刷新7维健康评分]
-        E2 --> E3[营养缺乏分析]
-        E3 --> E4[食材推荐指数]
-        E4 --> E5[健康分析报告]
+        D4 --> E1[⚙️ 维度评分引擎]:::portSystem
+        E1 --> E2[⚙️ 刷新7维健康评分]:::portSystem
+        E2 --> E3[⚙️ 营养缺乏分析]:::portSystem
+        E3 --> E4[⚙️ 食材推荐指数]:::portSystem
+        E4 --> E5[⚙️ 健康分析报告]:::portSystem
     end
 
     subgraph AI教练解读
-        E5 --> F1[家长查看健康报告]
-        F1 --> F2{是否需要<br>AI解读?}
-        F2 -->|是| F3[AI聊天解读报告]
-        F3 --> F4[AI解析报告指标<br>生成改善建议]
-        F4 --> F5[AI生成任务计划]
-        F5 --> F6[家长查看解读结果]
+        E5 --> F1[📱 家长查看健康报告]:::portMiniApp
+        F1 --> F2{📱 是否需要<br>AI解读?}:::portMiniApp
+        F2 -->|是| F3[📱 AI聊天解读报告]:::portMiniApp
+        F3 --> F4[📱 AI解析报告指标<br>生成改善建议]:::portMiniApp
+        F4 --> F5[📱 AI生成任务计划]:::portMiniApp
+        F5 --> F6[📱 家长查看解读结果]:::portMiniApp
         F2 -->|否| G1
     end
 
     subgraph 专业身份介入
-        F6 --> G1{是否需要<br>深度介入?}
-        G1 -->|健康问题咨询| G2[营养师介入]
-        G1 -->|全方位服务| G3[管家介入]
-        G1 -->|成长规划| G4[成长规划师介入]
-        G1 -->|自行跟进| G5[结束]
-
-        G2 --> G2a[申请营养师服务]
-        G2a --> G2b[营养师审核需求]
-        G2b --> G2c[开具营养方案]
-
-        G3 --> G3a[申请管家服务]
-        G3a --> G3b[管家审核]
-        G3b --> G3c[管家建档]
-        G3c --> G3d[定期跟进]
-
-        G4 --> G4a[规划师查看报告]
-        G4a --> G4b[规划师下发改善任务]
+        F6 --> G1{📱 是否需要<br>深度介入?}:::portMiniApp
+        G1 -->|健康问题咨询| G2[📱 申请营养师服务]:::portMiniApp
+        G1 -->|全方位服务| G3[📱 申请管家服务]:::portMiniApp
+        G1 -->|成长规划| G4[📱 规划师查看报告]:::portMiniApp
+        G1 -->|自行跟进| G5[📱 结束]:::portMiniApp
+
+        G2 --> G2a[📋 营养师审核需求]:::portGuide
+        G2a --> G2b[📋 开具营养方案]:::portGuide
+
+        G3 --> G3a[📋 管家审核]:::portGuide
+        G3a --> G3b[📋 管家建档]:::portGuide
+        G3b --> G3c[📋 定期跟进]:::portGuide
+
+        G4 --> G4a[📋 规划师查看报告]:::portGuide
+        G4a --> G4b[📋 规划师下发改善任务]:::portGuide
     end
 
     subgraph 持续跟踪
-        G5 --> H1[家长定期上传新报告]
-        H1 --> H2[系统对比历史趋势]
-        H2 --> H3[提示改善进展/异常]
+        G5 --> H1[📱 家长定期上传新报告]:::portMiniApp
+        H1 --> H2[⚙️ 系统对比历史趋势]:::portSystem
+        H2 --> H3[📱 提示改善进展/异常]:::portMiniApp
         H3 --> F1
     end
 
@@ -105,19 +109,19 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/health/report/create` | 创建健康报告 |
-| `/api/health/report/latest` | 获取最新报告 |
-| `/api/health/report/list` | 报告列表 |
-| `/api/health/report/admin-list` | 管理端报告列表 |
-| `/api/health/report/detail` | 报告完整详情 |
-| `/api/health/report/edit` | 编辑报告 |
-| `/api/health/report/upload` | 上传PDF报告 |
-| `/api/health/report/parse-preview` | 解析预览 |
-| `/api/health/report/confirm` | 确认入库 |
-| `/api/health/report/discard` | 放弃草稿 |
-| `/api/health/report/bind` | 绑定到成员 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/health/report/create` | 创建健康报告 | 📱小程序 |
+| `/api/health/report/latest` | 获取最新报告 | 📱小程序 |
+| `/api/health/report/list` | 报告列表 | 📱小程序 |
+| `/api/health/report/detail` | 报告完整详情 | 📱小程序 |
+| `/api/health/report/edit` | 编辑报告 | 📱小程序 |
+| `/api/health/report/upload` | 上传PDF报告 | 📱小程序 |
+| `/api/health/report/parse-preview` | 解析预览 | 📱小程序 |
+| `/api/health/report/confirm` | 确认入库 | 📱小程序 |
+| `/api/health/report/discard` | 放弃草稿 | 📱小程序 |
+| `/api/health/report/bind` | 绑定到成员 | 📱小程序 |
+| `/api/health/report/admin-list` | 管理端报告列表 | 🖥管理后台 |
 | `/api/health/report/unlinked` | 未绑定报告 |
 | `/api/health/report/permission/add` | 添加查看权限 |
 | `/api/health/report/permission/remove` | 移除权限 |

docs/flows/knowledge-invite-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 健康知识库与邀请
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,47 +11,51 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 健康知识库
-        A1(("管理员")) --> A2[查询知识库 /query]
-        A2 --> A3[批量查询 /batch-query]
-        A3 --> A4[列表查询 /list]
-        A4 --> A5[新增条目 /add]
-        A5 --> A6[更新条目 /update]
-        A6 --> A7[删除条目 /delete]
-        A7 --> A8[从JSON导入 /import]
+        A1(("🔧 管理员")):::portAdmin --> A2[🖥 查询知识库 /query]:::portAdmin
+        A2 --> A3[🖥 批量查询 /batch-query]:::portAdmin
+        A3 --> A4[🖥 列表查询 /list]:::portAdmin
+        A4 --> A5[🖥 新增条目 /add]:::portAdmin
+        A5 --> A6[🖥 更新条目 /update]:::portAdmin
+        A6 --> A7[🖥 删除条目 /delete]:::portAdmin
+        A7 --> A8[🖥 从JSON导入 /import]:::portAdmin
     end
 
     subgraph KB v3查询
-        A8 --> B1[查询菌属功能 /v3/bacteria/query]
-        B1 --> B2[批量查询菌属 /v3/bacteria/batch-query]
-        B2 --> B3[查询指标调整 /v3/indicator/query]
-        B3 --> B4[查询食物营养 /v3/food/query]
-        B4 --> B5[获取原始数据 /v3/section]
+        A8 --> B1[🖥 查询菌属功能 /v3/bacteria/query]:::portAdmin
+        B1 --> B2[🖥 批量查询菌属 /v3/bacteria/batch-query]:::portAdmin
+        B2 --> B3[🖥 查询指标调整 /v3/indicator/query]:::portAdmin
+        B3 --> B4[🖥 查询食物营养 /v3/food/query]:::portAdmin
+        B4 --> B5[🖥 获取原始数据 /v3/section]:::portAdmin
     end
 
     subgraph 邀请码管理
-        C1(("用户")) --> C2[生成邀请码 /invite/code]
-        C2 --> C3[绑定邀请 /invite/bind]
-        C3 --> C4[获取邀请列表 /invite/list]
-        C4 --> C5[获取邀请汇总 /invite/summary]
-        C5 --> C6[获取邀请二维码 /invite/qrcode]
+        C1(("👤 用户")):::portMiniApp --> C2[📱 生成邀请码 /invite/code]:::portMiniApp
+        C2 --> C3[📱 绑定邀请 /invite/bind]:::portMiniApp
+        C3 --> C4[📱 获取邀请列表 /invite/list]:::portMiniApp
+        C4 --> C5[📱 获取邀请汇总 /invite/summary]:::portMiniApp
+        C5 --> C6[📱 获取邀请二维码 /invite/qrcode]:::portMiniApp
     end
 
     subgraph 邀请卡片
-        C6 --> D1[生成邀请码 /invite-card/generate]
-        D1 --> D2[验证邀请码 /invite-card/verify]
-        D2 --> D3[接受邀请 /invite-card/accept]
+        C6 --> D1[📱 生成邀请码 /invite-card/generate]:::portMiniApp
+        D1 --> D2[📱 验证邀请码 /invite-card/verify]:::portMiniApp
+        D2 --> D3[📱 接受邀请 /invite-card/accept]:::portMiniApp
     end
 
     subgraph 邀请里程碑
-        D3 --> E1[获取里程碑列表 /invite/milestone/list]
-        E1 --> E2[领取里程碑奖励 /invite/milestone/claim]
+        D3 --> E1[📱 获取里程碑列表 /invite/milestone/list]:::portMiniApp
+        E1 --> E2[📱 领取里程碑奖励 /invite/milestone/claim]:::portMiniApp
     end
 
     subgraph 入门引导
-        C1 --> F1[获取引导进度 /onboarding/progress]
-        F1 --> F2[领取奖励 /onboarding/claim]
+        C1 --> F1[📱 获取引导进度 /onboarding/progress]:::portMiniApp
+        F1 --> F2[📱 领取奖励 /onboarding/claim]:::portMiniApp
     end
 
     R1(("🔧 管理员")):::actor
@@ -61,29 +67,29 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/health/knowledge/query` | 查询知识库 |
-| `/api/health/knowledge/batch-query` | 批量查询 |
-| `/api/health/knowledge/list` | 列表查询 |
-| `/api/health/knowledge/add` | 新增条目 |
-| `/api/health/knowledge/update` | 更新条目 |
-| `/api/health/knowledge/delete` | 删除条目 |
-| `/api/health/knowledge/import` | 导入数据 |
-| `/api/health/knowledge/v3/bacteria/query` | 菌属功能查询 |
-| `/api/health/knowledge/v3/bacteria/batch-query` | 批量菌属查询 |
-| `/api/health/knowledge/v3/indicator/query` | 指标调整建议 |
-| `/api/health/knowledge/v3/food/query` | 食物营养数据 |
-| `/api/health/knowledge/v3/section` | 原始数据 |
-| `/api/invite/code` | 生成邀请码 |
-| `/api/invite/bind` | 绑定邀请 |
-| `/api/invite/list` | 邀请列表 |
-| `/api/invite/summary` | 邀请汇总 |
-| `/api/invite/qrcode` | 邀请二维码 |
-| `/api/invite-card/generate` | 生成邀请卡片 |
-| `/api/invite-card/verify` | 验证邀请码 |
-| `/api/invite-card/accept` | 接受邀请 |
-| `/api/invite/milestone/list` | 里程碑列表 |
-| `/api/invite/milestone/claim` | 领取奖励 |
-| `/api/onboarding/progress` | 引导进度 |
-| `/api/onboarding/claim` | 领取奖励 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/health/knowledge/query` | 查询知识库 | 🖥管理后台 |
+| `/api/health/knowledge/batch-query` | 批量查询 | 🖥管理后台 |
+| `/api/health/knowledge/list` | 列表查询 | 🖥管理后台 |
+| `/api/health/knowledge/add` | 新增条目 | 🖥管理后台 |
+| `/api/health/knowledge/update` | 更新条目 | 🖥管理后台 |
+| `/api/health/knowledge/delete` | 删除条目 | 🖥管理后台 |
+| `/api/health/knowledge/import` | 导入数据 | 🖥管理后台 |
+| `/api/health/knowledge/v3/bacteria/query` | 菌属功能查询 | 🖥管理后台 |
+| `/api/health/knowledge/v3/bacteria/batch-query` | 批量菌属查询 | 🖥管理后台 |
+| `/api/health/knowledge/v3/indicator/query` | 指标调整建议 | 🖥管理后台 |
+| `/api/health/knowledge/v3/food/query` | 食物营养数据 | 🖥管理后台 |
+| `/api/health/knowledge/v3/section` | 原始数据 | 🖥管理后台 |
+| `/api/invite/code` | 生成邀请码 | 📱小程序 |
+| `/api/invite/bind` | 绑定邀请 | 📱小程序 |
+| `/api/invite/list` | 邀请列表 | 📱小程序 |
+| `/api/invite/summary` | 邀请汇总 | 📱小程序 |
+| `/api/invite/qrcode` | 邀请二维码 | 📱小程序 |
+| `/api/invite-card/generate` | 生成邀请卡片 | 📱小程序 |
+| `/api/invite-card/verify` | 验证邀请码 | 📱小程序 |
+| `/api/invite-card/accept` | 接受邀请 | 📱小程序 |
+| `/api/invite/milestone/list` | 里程碑列表 | 📱小程序 |
+| `/api/invite/milestone/claim` | 领取奖励 | 📱小程序 |
+| `/api/onboarding/progress` | 引导进度 | 📱小程序 |
+| `/api/onboarding/claim` | 领取奖励 | 📱小程序 |

docs/flows/market-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 任务模板市场
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,37 +11,41 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 市场浏览
-        A1(("家长")) --> A2[获取公开模板列表 /packages]
-        A2 --> A3[获取模板详情 /packages/{id}]
-        A3 --> A4[获取任务项 /packages/{id}/items]
-        A4 --> A5[通过分享码获取 /share/{code}]
+        A1(("👤 家长")):::portMiniApp --> A2[📱 获取公开模板列表 /packages]:::portMiniApp
+        A2 --> A3[📱 获取模板详情 /packages/{id}]:::portMiniApp
+        A3 --> A4[📱 获取任务项 /packages/{id}/items]:::portMiniApp
+        A4 --> A5[📱 通过分享码获取 /share/{code}]:::portMiniApp
     end
 
     subgraph 购买流程
-        A5 --> B1[获取模板价格 /price]
-        B1 --> B2[获取可用指导师 /available-guides]
-        B2 --> B3[创建订单 /order/create]
-        B3 --> B4[获取微信支付参数 /wechat params]
-        B4 --> B5[微信支付回调 /notify]
-        B5 --> B6[支付成功后应用 /apply]
-        B6 --> B7[购买并应用模板 /packages/{id}/purchase]
+        A5 --> B1[📱 获取模板价格 /price]:::portMiniApp
+        B1 --> B2[📱 获取可用指导师 /available-guides]:::portMiniApp
+        B2 --> B3[📱 创建订单 /order/create]:::portMiniApp
+        B3 --> B4[⚙️ 获取微信支付参数 /wechat params]:::portSystem
+        B4 --> B5[⚙️ 微信支付回调 /notify]:::portSystem
+        B5 --> B6[⚙️ 支付成功后应用 /apply]:::portSystem
+        B6 --> B7[📱 购买并应用模板 /packages/{id}/purchase]:::portMiniApp
     end
 
     subgraph 我的计划
-        B7 --> C1[获取我的计划 /plans]
-        C1 --> C2[获取计划详情 /plans/{id}]
-        C2 --> C3[获取计划任务项 /plans/{id}/items]
-        C3 --> C4[取消计划 /plans/{id}/cancel]
+        B7 --> C1[📱 获取我的计划 /plans]:::portMiniApp
+        C1 --> C2[📱 获取计划详情 /plans/{id}]:::portMiniApp
+        C2 --> C3[📱 获取计划任务项 /plans/{id}/items]:::portMiniApp
+        C3 --> C4[📱 取消计划 /plans/{id}/cancel]:::portMiniApp
     end
 
     subgraph 模板创建(管理员/规划师)
-        A2 --> D1[创建模板 /create]
-        D1 --> D2[更新模板 /{id}/update]
-        D2 --> D3[添加任务项 /{id}/items]
-        D3 --> D4[提交审核 /{id}/submit]
-        D4 --> D5[审核通过后发布 /{id}/publish]
+        A2 --> D1[🖥 创建模板 /create]:::portAdmin
+        D1 --> D2[🖥 更新模板 /{id}/update]:::portAdmin
+        D2 --> D3[🖥 添加任务项 /{id}/items]:::portAdmin
+        D3 --> D4[🖥 提交审核 /{id}/submit]:::portAdmin
+        D4 --> D5[🖥 审核通过后发布 /{id}/publish]:::portAdmin
     end
 
     R1(("👤 家长")):::actor
@@ -53,26 +59,26 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/market/packages` | 获取公开模板列表 |
-| `/api/market/packages/{id}` | 获取模板详情 |
-| `/api/market/packages/{id}/items` | 获取任务项 |
-| `/api/market/share/{code}` | 通过分享码获取 |
-| `/api/market/packages/{id}/purchase` | 购买并应用 |
-| `/api/market/plans` | 获取我的计划 |
-| `/api/market/plans/{id}` | 计划详情 |
-| `/api/market/plans/{id}/items` | 计划任务项 |
-| `/api/market/plans/{id}/cancel` | 取消计划 |
-| `/api/package/price` | 模板价格 |
-| `/api/package/available-guides` | 可用指导师 |
-| `/api/package/order/create` | 创建订单 |
-| `/api/package/order/{orderNo}` | 订单详情 |
-| `/api/payment/create` | 创建支付订单 |
-| `/api/payment/wechat params` | 微信支付参数 |
-| `/api/payment/notify` | 支付回调 |
-| `/api/payment/apply` | 应用模板 |
-| `/api/packages/create` | 创建模板 |
-| `/api/packages/{id}/update` | 更新模板 |
-| `/api/packages/{id}/submit` | 提交审核 |
-| `/api/packages/{id}/publish` | 发布/下架 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/market/packages` | 获取公开模板列表 | 📱小程序 |
+| `/api/market/packages/{id}` | 获取模板详情 | 📱小程序 |
+| `/api/market/packages/{id}/items` | 获取任务项 | 📱小程序 |
+| `/api/market/share/{code}` | 通过分享码获取 | 📱小程序 |
+| `/api/market/packages/{id}/purchase` | 购买并应用 | 📱小程序 |
+| `/api/market/plans` | 获取我的计划 | 📱小程序 |
+| `/api/market/plans/{id}` | 计划详情 | 📱小程序 |
+| `/api/market/plans/{id}/items` | 计划任务项 | 📱小程序 |
+| `/api/market/plans/{id}/cancel` | 取消计划 | 📱小程序 |
+| `/api/package/price` | 模板价格 | 📱小程序 |
+| `/api/package/available-guides` | 可用指导师 | 📱小程序 |
+| `/api/package/order/create` | 创建订单 | 📱小程序 |
+| `/api/package/order/{orderNo}` | 订单详情 | 📱小程序 |
+| `/api/payment/create` | 创建支付订单 | 📱小程序 |
+| `/api/payment/wechat params` | 微信支付参数 | ⚙️系统自动 |
+| `/api/payment/notify` | 支付回调 | ⚙️系统自动 |
+| `/api/payment/apply` | 应用模板 | ⚙️系统自动 |
+| `/api/packages/create` | 创建模板 | 🖥管理后台 |
+| `/api/packages/{id}/update` | 更新模板 | 🖥管理后台 |
+| `/api/packages/{id}/submit` | 提交审核 | 🖥管理后台 |
+| `/api/packages/{id}/publish` | 发布/下架 | 🖥管理后台 |

docs/flows/membership-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 会员与订阅
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,46 +11,50 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 会员查看
-        A1(("家长")) --> A2[获取会员等级列表 /levels]
-        A2 --> A3[获取我的会员信息 /my]
-        A3 --> A4[获取当前会员等级 /level]
-        A4 --> A5[获取会员等级详情 /current]
-        A5 --> A6[获取升级记录 /records]
+        A1(("👤 家长")):::portMiniApp --> A2[📱 获取会员等级列表 /levels]:::portMiniApp
+        A2 --> A3[📱 获取我的会员信息 /my]:::portMiniApp
+        A3 --> A4[📱 获取当前会员等级 /level]:::portMiniApp
+        A4 --> A5[📱 获取会员等级详情 /current]:::portMiniApp
+        A5 --> A6[📱 获取升级记录 /records]:::portMiniApp
     end
 
     subgraph 会员升级
-        A6 --> B1[创建会员升级订单 /upgrade]
-        B1 --> B2[创建订单 /orders]
-        B2 --> B3{是否需要支付?}
-        B3 -->|是| B4[支付回调 /notify]
-        B3 -->|否| B5[直接升级]
+        A6 --> B1[📱 创建会员升级订单 /upgrade]:::portMiniApp
+        B1 --> B2[📱 创建订单 /orders]:::portMiniApp
+        B2 --> B3{📱 是否需要支付?}:::portMiniApp
+        B3 -->|是| B4[⚙️ 支付回调 /notify]:::portSystem
+        B3 -->|否| B5[📱 直接升级]:::portMiniApp
         B4 --> B5
     end
 
     subgraph 会员权益
-        B5 --> C1[检查功能权限 /can-use]
-        C1 --> C2[应用会员折扣 /discount]
-        C2 --> C3[获取任务模板价格 /plans]
+        B5 --> C1[📱 检查功能权限 /can-use]:::portMiniApp
+        C1 --> C2[📱 应用会员折扣 /discount]:::portMiniApp
+        C2 --> C3[📱 获取任务模板价格 /plans]:::portMiniApp
     end
 
     subgraph 会员试用
-        A6 --> D1[激活试用会员 /trial]
-        D1 --> D2[试用期体验]
+        A6 --> D1[📱 激活试用会员 /trial]:::portMiniApp
+        D1 --> D2[📱 试用期体验]:::portMiniApp
     end
 
     subgraph 订阅管理
-        A3 --> E1[获取订阅状态 /status]
-        E1 --> E2[获取订阅计划 /plans]
-        E2 --> E3[创建订阅 /create]
-        E3 --> E4[确认订阅 /subscribe]
-        E4 --> E5[取消订阅 /cancel]
-        E5 --> E6[自动续费设置 /auto-renew]
-        E6 --> E7[获取我的权益 /benefits/my]
-        E7 --> E8[检查权益 /benefit/check]
-        E8 --> E9[获取当前订阅层级 /tier]
-        E9 --> E10[更新订阅层级 /tier/update]
+        A3 --> E1[📱 获取订阅状态 /status]:::portMiniApp
+        E1 --> E2[📱 获取订阅计划 /plans]:::portMiniApp
+        E2 --> E3[📱 创建订阅 /create]:::portMiniApp
+        E3 --> E4[📱 确认订阅 /subscribe]:::portMiniApp
+        E4 --> E5[📱 取消订阅 /cancel]:::portMiniApp
+        E5 --> E6[📱 自动续费设置 /auto-renew]:::portMiniApp
+        E6 --> E7[📱 获取我的权益 /benefits/my]:::portMiniApp
+        E7 --> E8[📱 检查权益 /benefit/check]:::portMiniApp
+        E8 --> E9[📱 获取当前订阅层级 /tier]:::portMiniApp
+        E9 --> E10[📱 更新订阅层级 /tier/update]:::portMiniApp
     end
 
     R1(("👤 家长")):::actor
@@ -60,27 +66,27 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/membership/levels` | MembershipController | 会员等级列表 |
-| `/api/membership/my` | MembershipController | 我的会员信息 |
-| `/api/membership/level` | MembershipController | 当前等级 |
-| `/api/membership/current` | MembershipController | 等级详情 |
-| `/api/membership/records` | MembershipController | 升级记录 |
-| `/api/membership/upgrade` | MembershipController | 创建升级订单 |
-| `/api/membership/trial` | MembershipController | 激活试用 |
-| `/api/membership/orders` | MembershipController | 创建订单 |
-| `/api/membership/plans` | MembershipController | 任务模板价格 |
-| `/api/membership/notify` | MembershipController | 支付回调 |
-| `/api/membership/can-use` | MembershipController | 功能权限检查 |
-| `/api/membership/discount` | MembershipController | 应用折扣 |
-| `/api/subscription/status` | SubscriptionController | 订阅状态 |
-| `/api/subscription/plans` | SubscriptionController | 订阅计划 |
-| `/api/subscription/create` | SubscriptionController | 创建订阅 |
-| `/api/subscription/subscribe` | SubscriptionController | 确认订阅 |
-| `/api/subscription/cancel` | SubscriptionController | 取消订阅 |
-| `/api/subscription/auto-renew` | SubscriptionController | 自动续费 |
-| `/api/subscription/benefits/my` | SubscriptionController | 我的权益 |
-| `/api/subscription/benefit/check` | SubscriptionController | 检查权益 |
-| `/api/subscription/tier` | SubscriptionController | 订阅层级 |
-| `/api/subscription/tier/update` | SubscriptionController | 更新层级 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/membership/levels` | 会员等级列表 | 📱小程序 |
+| `/api/membership/my` | 我的会员信息 | 📱小程序 |
+| `/api/membership/level` | 当前等级 | 📱小程序 |
+| `/api/membership/current` | 等级详情 | 📱小程序 |
+| `/api/membership/records` | 升级记录 | 📱小程序 |
+| `/api/membership/upgrade` | 创建升级订单 | 📱小程序 |
+| `/api/membership/trial` | 激活试用 | 📱小程序 |
+| `/api/membership/orders` | 创建订单 | 📱小程序 |
+| `/api/membership/plans` | 任务模板价格 | 📱小程序 |
+| `/api/membership/can-use` | 功能权限检查 | 📱小程序 |
+| `/api/membership/discount` | 应用折扣 | 📱小程序 |
+| `/api/membership/notify` | 支付回调 | ⚙️系统自动 |
+| `/api/subscription/status` | 订阅状态 | 📱小程序 |
+| `/api/subscription/plans` | 订阅计划 | 📱小程序 |
+| `/api/subscription/create` | 创建订阅 | 📱小程序 |
+| `/api/subscription/subscribe` | 确认订阅 | 📱小程序 |
+| `/api/subscription/cancel` | 取消订阅 | 📱小程序 |
+| `/api/subscription/auto-renew` | 自动续费 | 📱小程序 |
+| `/api/subscription/benefits/my` | 我的权益 | 📱小程序 |
+| `/api/subscription/benefit/check` | 检查权益 | 📱小程序 |
+| `/api/subscription/tier` | 订阅层级 | 📱小程序 |
+| `/api/subscription/tier/update` | 更新层级 | 📱小程序 |

docs/flows/mind-emotion-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 心理与情绪管理
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,48 +11,52 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 情绪打卡
-        A1(("用户")) --> A2[创建情绪打卡 /mind/checkin/create]
-        A2 --> A3[获取情绪列表 /mind/checkin/list]
-        A3 --> A4[获取最新情绪 /mind/checkin/latest]
-        A4 --> A5[获取情绪趋势 /mind/checkin/trend]
-        A5 --> A6[获取情绪统计 /mind/checkin/stats]
-        A6 --> A7[获取周报 /mind/checkin/weekly-report]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 创建情绪打卡 /mind/checkin/create]:::portMiniApp
+        A2 --> A3[📱 获取情绪列表 /mind/checkin/list]:::portMiniApp
+        A3 --> A4[📱 获取最新情绪 /mind/checkin/latest]:::portMiniApp
+        A4 --> A5[📱 获取情绪趋势 /mind/checkin/trend]:::portMiniApp
+        A5 --> A6[📱 获取情绪统计 /mind/checkin/stats]:::portMiniApp
+        A6 --> A7[📱 获取周报 /mind/checkin/weekly-report]:::portMiniApp
     end
 
     subgraph 情绪预警
-        A7 --> B1[获取活跃预警 /mind/alert/active]
-        B1 --> B2[获取打卡预警 /mind/alert/checkin-alerts]
-        B2 --> B3[处理预警 /mind/alert/resolve]
+        A7 --> B1[📱 获取活跃预警 /mind/alert/active]:::portMiniApp
+        B1 --> B2[📱 获取打卡预警 /mind/alert/checkin-alerts]:::portMiniApp
+        B2 --> B3[📱 处理预警 /mind/alert/resolve]:::portMiniApp
     end
 
     subgraph 心理测评
-        A1 --> C1[提交筛查问卷 /mind/screening/submit]
-        C1 --> C2[获取筛查历史 /mind/screening/history]
-        C2 --> C3[获取最新结果 /mind/screening/latest]
+        A1 --> C1[📱 提交筛查问卷 /mind/screening/submit]:::portMiniApp
+        C1 --> C2[📱 获取筛查历史 /mind/screening/history]:::portMiniApp
+        C2 --> C3[📱 获取最新结果 /mind/screening/latest]:::portMiniApp
     end
 
     subgraph 脑科学与神经递质
-        C3 --> D1[获取神经递质分析 /mind/neurotransmitters]
-        D1 --> D2[获取肠脑洞察 /mind/gut-emotion-insight]
-        D2 --> D3[获取EMI报告 /mind/emireport/latest]
+        C3 --> D1[📱 获取神经递质分析 /mind/neurotransmitters]:::portMiniApp
+        D1 --> D2[📱 获取肠脑洞察 /mind/gut-emotion-insight]:::portMiniApp
+        D2 --> D3[📱 获取EMI报告 /mind/emireport/latest]:::portMiniApp
     end
 
     subgraph 心理运势
-        D3 --> E1[获取心理运势 /mind/fortune]
-        E1 --> E2[刷新运势 /mind/fortune/refresh]
-        E2 --> E3[导出运势 /mind/fortune/export]
+        D3 --> E1[📱 获取心理运势 /mind/fortune]:::portMiniApp
+        E1 --> E2[📱 刷新运势 /mind/fortune/refresh]:::portMiniApp
+        E2 --> E3[📱 导出运势 /mind/fortune/export]:::portMiniApp
     end
 
     subgraph 传统心理镜像
-        E3 --> F1[获取心理镜像 /mind/traditional/mirror]
-        F1 --> F2[获取家庭看板 /mind/traditional/family-dashboard]
-        F2 --> F3[获取兼容性 /mind/traditional/compatibility]
+        E3 --> F1[📱 获取心理镜像 /mind/traditional/mirror]:::portMiniApp
+        F1 --> F2[📱 获取家庭看板 /mind/traditional/family-dashboard]:::portMiniApp
+        F2 --> F3[📱 获取兼容性 /mind/traditional/compatibility]:::portMiniApp
     end
 
     subgraph EMI心理报告
-        F3 --> G1[获取EMI心理报告 /emireport/latest]
+        F3 --> G1[📱 获取EMI心理报告 /emireport/latest]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -62,27 +68,27 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/mind/checkin/create` | EmotionCheckinController | 创建情绪打卡 |
-| `/api/mind/checkin/list` | EmotionCheckinController | 情绪列表 |
-| `/api/mind/checkin/latest` | EmotionCheckinController | 最新情绪 |
-| `/api/mind/checkin/trend` | EmotionCheckinController | 情绪趋势 |
-| `/api/mind/checkin/stats` | EmotionCheckinController | 情绪统计 |
-| `/api/mind/checkin/weekly-report` | EmotionCheckinController | 周报 |
-| `/api/mind/alert/active` | EmotionAlertController | 活跃预警 |
-| `/api/mind/alert/checkin-alerts` | EmotionAlertController | 打卡预警 |
-| `/api/mind/alert/resolve` | EmotionAlertController | 处理预警 |
-| `/api/mind/neurotransmitters` | MindController | 神经递质 |
-| `/api/mind/gut-emotion-insight` | MindController | 肠脑洞察 |
-| `/api/mind/emireport/latest` | MindController | EMI报告 |
-| `/api/mind/fortune` | MindFortuneController | 心理运势 |
-| `/api/mind/fortune/refresh` | MindFortuneController | 刷新运势 |
-| `/api/mind/fortune/export` | MindFortuneController | 导出运势 |
-| `/api/mind/screening/submit` | ScreeningController | 提交筛查 |
-| `/api/mind/screening/history` | ScreeningController | 筛查历史 |
-| `/api/mind/screening/latest` | ScreeningController | 最新结果 |
-| `/api/mind/traditional/mirror` | TraditionalMirrorController | 心理镜像 |
-| `/api/mind/traditional/family-dashboard` | TraditionalMirrorController | 家庭看板 |
-| `/api/mind/traditional/compatibility` | TraditionalMirrorController | 兼容性 |
-| `/api/emireport/latest` | EmiReportController | EMI心理报告 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/mind/checkin/create` | 创建情绪打卡 | 📱小程序 |
+| `/api/mind/checkin/list` | 情绪列表 | 📱小程序 |
+| `/api/mind/checkin/latest` | 最新情绪 | 📱小程序 |
+| `/api/mind/checkin/trend` | 情绪趋势 | 📱小程序 |
+| `/api/mind/checkin/stats` | 情绪统计 | 📱小程序 |
+| `/api/mind/checkin/weekly-report` | 周报 | 📱小程序 |
+| `/api/mind/alert/active` | 活跃预警 | 📱小程序 |
+| `/api/mind/alert/checkin-alerts` | 打卡预警 | 📱小程序 |
+| `/api/mind/alert/resolve` | 处理预警 | 📱小程序 |
+| `/api/mind/neurotransmitters` | 神经递质 | 📱小程序 |
+| `/api/mind/gut-emotion-insight` | 肠脑洞察 | 📱小程序 |
+| `/api/mind/emireport/latest` | EMI报告 | 📱小程序 |
+| `/api/mind/fortune` | 心理运势 | 📱小程序 |
+| `/api/mind/fortune/refresh` | 刷新运势 | 📱小程序 |
+| `/api/mind/fortune/export` | 导出运势 | 📱小程序 |
+| `/api/mind/screening/submit` | 提交筛查 | 📱小程序 |
+| `/api/mind/screening/history` | 筛查历史 | 📱小程序 |
+| `/api/mind/screening/latest` | 最新结果 | 📱小程序 |
+| `/api/mind/traditional/mirror` | 心理镜像 | 📱小程序 |
+| `/api/mind/traditional/family-dashboard` | 家庭看板 | 📱小程序 |
+| `/api/mind/traditional/compatibility` | 兼容性 | 📱小程序 |
+| `/api/emireport/latest` | EMI心理报告 | 📱小程序 |

docs/flows/minigame-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 小游戏
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,39 +11,43 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 游戏浏览
-        A1(("孩子")) --> A2[获取小游戏列表 /list]
-        A2 --> A3[获取游戏详情 /{gameCode}]
+        A1(("👶 孩子")):::portMiniApp --> A2[📱 获取小游戏列表 /list]:::portMiniApp
+        A2 --> A3[📱 获取游戏详情 /{gameCode}]:::portMiniApp
     end
 
     subgraph 游戏执行
-        A3 --> B1{游戏类型}
-        B1 -->|舒尔特方格| B2[完成专注力训练]
-        B1 -->|猜数字| B3[完成逻辑训练]
-        B1 -->|数独| B4[完成思维训练]
-        B2 --> B5[游戏完成 /complete]
+        A3 --> B1{📱 游戏类型}:::portMiniApp
+        B1 -->|舒尔特方格| B2[📱 完成专注力训练]:::portMiniApp
+        B1 -->|猜数字| B3[📱 完成逻辑训练]:::portMiniApp
+        B1 -->|数独| B4[📱 完成思维训练]:::portMiniApp
+        B2 --> B5[📱 游戏完成 /complete]:::portMiniApp
         B3 --> B5
         B4 --> B5
     end
 
     subgraph 游戏记录
-        B5 --> C1[保存游戏记录 /game/record]
-        C1 --> C2[获取游戏历史 /game/history]
-        C2 --> C3[获取最佳成绩 /game/best]
-        C3 --> C4[获取统计概览 /game/stats]
-        C4 --> C5[获取排行榜 /game/leaderboard]
+        B5 --> C1[📱 保存游戏记录 /game/record]:::portMiniApp
+        C1 --> C2[📱 获取游戏历史 /game/history]:::portMiniApp
+        C2 --> C3[📱 获取最佳成绩 /game/best]:::portMiniApp
+        C3 --> C4[📱 获取统计概览 /game/stats]:::portMiniApp
+        C4 --> C5[📱 获取排行榜 /game/leaderboard]:::portMiniApp
     end
 
     subgraph 管理端
-        A2 --> D1[获取所有游戏 /all]
-        D1 --> D2[更新游戏状态 /{id}/status]
+        A2 --> D1[🖥 获取所有游戏 /all]:::portAdmin
+        D1 --> D2[🖥 更新游戏状态 /{id}/status]:::portAdmin
     end
 
     subgraph 智慧数学
-        A1 --> E1[开始答题 /api/wisdom/math/start]
-        E1 --> E2[验证答案 /api/wisdom/math/verify]
-        E2 --> E3[完成游戏 /api/wisdom/math/complete]
+        A1 --> E1[📱 开始答题 /api/wisdom/math/start]:::portMiniApp
+        E1 --> E2[📱 验证答案 /api/wisdom/math/verify]:::portMiniApp
+        E2 --> E3[📱 完成游戏 /api/wisdom/math/complete]:::portMiniApp
     end
 
     R1(("👶 孩子")):::actor
@@ -53,18 +59,18 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/mini-game/list` | 小游戏列表 |
-| `/api/mini-game/{gameCode}` | 游戏详情 |
-| `/api/mini-game/all` | 所有游戏(管理端) |
-| `/api/mini-game/{id}/status` | 更新游戏状态 |
-| `/api/mini-game/complete` | 完成游戏 |
-| `/api/game/record` | 保存游戏记录 |
-| `/api/game/history` | 游戏历史 |
-| `/api/game/best` | 最佳成绩 |
-| `/api/game/stats` | 统计概览 |
-| `/api/game/leaderboard` | 排行榜 |
-| `/api/wisdom/math/start` | 开始数学游戏 |
-| `/api/wisdom/math/verify` | 验证答案 |
-| `/api/wisdom/math/complete` | 完成游戏 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/mini-game/list` | 小游戏列表 | 📱小程序 |
+| `/api/mini-game/{gameCode}` | 游戏详情 | 📱小程序 |
+| `/api/mini-game/complete` | 完成游戏 | 📱小程序 |
+| `/api/game/record` | 保存游戏记录 | 📱小程序 |
+| `/api/game/history` | 游戏历史 | 📱小程序 |
+| `/api/game/best` | 最佳成绩 | 📱小程序 |
+| `/api/game/stats` | 统计概览 | 📱小程序 |
+| `/api/game/leaderboard` | 排行榜 | 📱小程序 |
+| `/api/wisdom/math/start` | 开始数学游戏 | 📱小程序 |
+| `/api/wisdom/math/verify` | 验证答案 | 📱小程序 |
+| `/api/wisdom/math/complete` | 完成游戏 | 📱小程序 |
+| `/api/mini-game/all` | 所有游戏 | 🖥管理后台 |
+| `/api/mini-game/{id}/status` | 更新游戏状态 | 🖥管理后台 |

docs/flows/nutrition-diet-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 营养与饮食推荐
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,41 +11,54 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 食谱推荐
-        A1(("用户")) --> A2[获取食谱推荐 /meal/recommend]
-        A2 --> A3{对推荐满意?}
-        A3 -->|不满意| A4[替换指定食材(一换一菜) /meal/replace]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取食谱推荐 /meal/recommend]:::portMiniApp
+        A2 --> A3{📱 对推荐满意?}:::portMiniApp
+        A3 -->|不满意| A4[📱 替换指定食材(一换一菜) /meal/replace]:::portMiniApp
         A4 --> A3
-        A3 -->|满意| A5[记录饮食日志 /meal/log]
+        A3 -->|满意| A5[📱 记录饮食日志 /meal/log]:::portMiniApp
     end
 
     subgraph 饮食记录查询
-        A5 --> B1[获取近期日志 /meal/logs]
-        B1 --> B2[获取营养摄入统计 /meal/nutrition-summary]
+        A5 --> B1[📱 获取近期日志 /meal/logs]:::portMiniApp
+        B1 --> B2[📱 获取营养摄入统计 /meal/nutrition-summary]:::portMiniApp
     end
 
     subgraph 食材推荐指数
-        B2 --> C1[获取食材推荐指数 /food/recommendation/index]
-        C1 --> C2[获取指数变更历史 /food/recommendation/history]
-        C2 --> C3[按家庭分组获取 /food/recommendation/by-family]
+        B2 --> C1[📱 获取食材推荐指数 /food/recommendation/index]:::portMiniApp
+        C1 --> C2[📱 获取指数变更历史 /food/recommendation/history]:::portMiniApp
+        C2 --> C3[📱 按家庭分组获取 /food/recommendation/by-family]:::portMiniApp
     end
 
     subgraph 营养偏好
-        C3 --> D1[获取营养偏好 /nutrition/profile/get]
-        D1 --> D2[保存营养偏好 /nutrition/profile/save]
+        C3 --> D1[📱 获取营养偏好 /nutrition/profile/get]:::portMiniApp
+        D1 --> D2[📱 保存营养偏好 /nutrition/profile/save]:::portMiniApp
     end
 
     subgraph 营养师服务
-        D2 --> E1[申请营养师 /nutritionist/apply]
-        E1 --> E2[获取申请状态 /nutritionist/status]
+        D2 --> E1[📱 申请营养师 /nutritionist/apply]:::portMiniApp
+        E1 --> E2[📱 获取申请状态 /nutritionist/status]:::portMiniApp
+    end
+
+    subgraph 北京营养知识库
+        E2 --> FA1[📱 查询知识库 /nutrition/beijing/kb/query]:::portMiniApp
+        FA1 --> FA2[📱 知识库列表 /nutrition/beijing/kb/list]:::portMiniApp
+        FA2 --> FA3[📱 知识库详情 /nutrition/beijing/kb/info]:::portMiniApp
+        FA3 --> FA4[📱 AI推荐 /nutrition/beijing/recommend]:::portMiniApp
+        FA4 --> FA5[📱 自定义推荐 /nutrition/beijing/recommend/custom]:::portMiniApp
+        FA5 --> FA6[📱 菌群保存 /nutrition/beijing/bacteria/save]:::portMiniApp
     end
 
     subgraph 推荐商品
-        E2 --> F1[获取维度页推荐 /recommend/dimension-products]
-        F1 --> F2[获取复购提醒 /recommend/repurchase-reminders/list]
-        F2 --> F3[标记已点击 /repurchase-reminders/click]
-        F3 --> F4[标记已购买 /repurchase-reminders/purchased]
+        E2 --> F1[📱 获取维度页推荐 /recommend/dimension-products]:::portMiniApp
+        F1 --> F2[📱 获取复购提醒 /recommend/repurchase-reminders/list]:::portMiniApp
+        F2 --> F3[📱 标记已点击 /repurchase-reminders/click]:::portMiniApp
+        F3 --> F4[📱 标记已购买 /repurchase-reminders/purchased]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -55,21 +70,27 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/meal/recommend` | 获取食谱推荐 |
-| `/api/meal/replace` | 替换指定食材 |
-| `/api/meal/log` | 记录饮食日志 |
-| `/api/meal/logs` | 获取近期日志 |
-| `/api/meal/nutrition-summary` | 营养摄入统计 |
-| `/api/food/recommendation/index` | 食材推荐指数 |
-| `/api/food/recommendation/history` | 指数变更历史 |
-| `/api/food/recommendation/by-family` | 按家庭分组 |
-| `/api/nutrition/profile/get` | 获取营养偏好 |
-| `/api/nutrition/profile/save` | 保存营养偏好 |
-| `/api/nutritionist/apply` | 申请营养师 |
-| `/api/nutritionist/status` | 申请状态 |
-| `/api/recommend/dimension-products` | 维度推荐商品 |
-| `/api/recommend/repurchase-reminders/list` | 复购提醒列表 |
-| `/api/recommend/repurchase-reminders/click` | 标记已点击 |
-| `/api/recommend/repurchase-reminders/purchased` | 标记已购买 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/meal/recommend` | 获取食谱推荐 | 📱小程序 |
+| `/api/meal/replace` | 替换指定食材 | 📱小程序 |
+| `/api/meal/log` | 记录饮食日志 | 📱小程序 |
+| `/api/meal/logs` | 获取近期日志 | 📱小程序 |
+| `/api/meal/nutrition-summary` | 营养摄入统计 | 📱小程序 |
+| `/api/food/recommendation/index` | 食材推荐指数 | 📱小程序 |
+| `/api/food/recommendation/history` | 指数变更历史 | 📱小程序 |
+| `/api/food/recommendation/by-family` | 按家庭分组 | 📱小程序 |
+| `/api/nutrition/profile/get` | 获取营养偏好 | 📱小程序 |
+| `/api/nutrition/profile/save` | 保存营养偏好 | 📱小程序 |
+| `/api/nutritionist/apply` | 申请营养师 | 📱小程序 |
+| `/api/nutritionist/status` | 申请状态 | 📱小程序 |
+| `/api/nutrition/beijing/kb/query` | 查询知识库 | 📱小程序 |
+| `/api/nutrition/beijing/kb/list` | 知识库列表 | 📱小程序 |
+| `/api/nutrition/beijing/kb/info` | 知识库详情 | 📱小程序 |
+| `/api/nutrition/beijing/recommend` | AI推荐 | 📱小程序 |
+| `/api/nutrition/beijing/recommend/custom` | 自定义推荐 | 📱小程序 |
+| `/api/nutrition/beijing/bacteria/save` | 菌群保存 | 📱小程序 |
+| `/api/recommend/dimension-products` | 维度推荐商品 | 📱小程序 |
+| `/api/recommend/repurchase-reminders/list` | 复购提醒列表 | 📱小程序 |
+| `/api/recommend/repurchase-reminders/click` | 标记已点击 | 📱小程序 |
+| `/api/recommend/repurchase-reminders/purchased` | 标记已购买 | 📱小程序 |

docs/flows/points-exchange-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 积分兑换
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,32 +11,36 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 积分概览
-        A1(("家长/孩子")) --> A2[获取积分余额 /balance]
-        A2 --> A3[获取积分流水 /logs]
-        A3 --> A4[按分类查询 /logs-by-category]
-        A4 --> A5[管理系统余额 /system-balance]
+        A1(("👤 家长/孩子")):::portMiniApp --> A2[📱 获取积分余额 /balance]:::portMiniApp
+        A2 --> A3[📱 获取积分流水 /logs]:::portMiniApp
+        A3 --> A4[📱 按分类查询 /logs-by-category]:::portMiniApp
+        A4 --> A5[📱 管理系统余额 /system-balance]:::portMiniApp
     end
 
     subgraph 积分调整
-        A5 --> B1[手动调整积分 /adjust]
+        A5 --> B1[📱 手动调整积分 /adjust]:::portMiniApp
     end
 
     subgraph 兑换商城
-        A2 --> C1[获取兑换商品列表 /product/list]
-        C1 --> C2[获取商品详情 /product/detail]
-        C2 --> C3[提交兑换 /submit]
-        C3 --> C4[获取兑换记录 /records]
-        C4 --> C5[获取兑换统计 /stats]
+        A2 --> C1[📱 获取兑换商品列表 /product/list]:::portMiniApp
+        C1 --> C2[📱 获取商品详情 /product/detail]:::portMiniApp
+        C2 --> C3[📱 提交兑换 /submit]:::portMiniApp
+        C3 --> C4[📱 获取兑换记录 /records]:::portMiniApp
+        C4 --> C5[📱 获取兑换统计 /stats]:::portMiniApp
     end
 
     subgraph 奖励系统
-        A4 --> D1[创建奖励 /create]
-        D1 --> D2[获取奖励模板 /templates]
-        D2 --> D3[兑换奖励 /{id}/exchange]
-        D3 --> D4[审批奖励 /{id}/approve]
-        D4 --> D5[兑换历史 /exchange-history]
+        A4 --> D1[📱 创建奖励 /create]:::portMiniApp
+        D1 --> D2[📱 获取奖励模板 /templates]:::portMiniApp
+        D2 --> D3[📱 兑换奖励 /{id}/exchange]:::portMiniApp
+        D3 --> D4[📱 审批奖励 /{id}/approve]:::portMiniApp
+        D4 --> D5[📱 兑换历史 /exchange-history]:::portMiniApp
     end
 
     R1(("👤 家长/孩子")):::actor
@@ -46,21 +52,21 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 控制器 | 说明 |
-|------|--------|------|
-| `/api/points/balance` | PointsController | 获取积分余额 |
-| `/api/points/logs` | PointsController | 获取积分流水 |
-| `/api/points/adjust` | PointsController | 手动调整积分 |
-| `/api/points/system-balance` | PointsController | 系统余额 |
-| `/api/points/logs-by-category` | PointsController | 按分类查询流水 |
-| `/api/points/exchange/product/list` | PointsExchangeController | 兑换商品列表 |
-| `/api/points/exchange/product/detail` | PointsExchangeController | 商品详情 |
-| `/api/points/exchange/submit` | PointsExchangeController | 提交兑换 |
-| `/api/points/exchange/records` | PointsExchangeController | 兑换记录 |
-| `/api/points/exchange/stats` | PointsExchangeController | 兑换统计 |
-| `/api/rewards/create` | RewardController | 创建奖励 |
-| `/api/rewards/wishlist` | RewardController | 奖励清单 |
-| `/api/rewards/{id}/exchange` | RewardController | 兑换奖励 |
-| `/api/rewards/{id}/approve` | RewardController | 审批奖励 |
-| `/api/rewards/templates` | RewardController | 奖励模板 |
-| `/api/rewards/exchange-history` | RewardController | 兑换历史 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/points/balance` | 获取积分余额 | 📱小程序 |
+| `/api/points/logs` | 获取积分流水 | 📱小程序 |
+| `/api/points/adjust` | 手动调整积分 | 📱小程序 |
+| `/api/points/system-balance` | 系统余额 | 📱小程序 |
+| `/api/points/logs-by-category` | 按分类查询流水 | 📱小程序 |
+| `/api/points/exchange/product/list` | 兑换商品列表 | 📱小程序 |
+| `/api/points/exchange/product/detail` | 商品详情 | 📱小程序 |
+| `/api/points/exchange/submit` | 提交兑换 | 📱小程序 |
+| `/api/points/exchange/records` | 兑换记录 | 📱小程序 |
+| `/api/points/exchange/stats` | 兑换统计 | 📱小程序 |
+| `/api/rewards/create` | 创建奖励 | 📱小程序 |
+| `/api/rewards/wishlist` | 奖励清单 | 📱小程序 |
+| `/api/rewards/{id}/exchange` | 兑换奖励 | 📱小程序 |
+| `/api/rewards/{id}/approve` | 审批奖励 | 📱小程序 |
+| `/api/rewards/templates` | 奖励模板 | 📱小程序 |
+| `/api/rewards/exchange-history` | 兑换历史 | 📱小程序 |

docs/flows/promotion-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 推广分销
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,49 +11,56 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 推广绑定
-        A1(("推广员")) --> A2[绑定推广关系 /bind]
-        A2 --> A3[获取佣金列表 /commission/list]
-        A3 --> A4[获取绑定列表 /bindings/list]
+        A1(("👤 推广员")):::portMiniApp --> A2[📱 绑定推广关系 /bind]:::portMiniApp
+        A2 --> A3[📱 获取佣金列表 /commission/list]:::portMiniApp
+        A3 --> A4[📱 获取绑定列表 /bindings/list]:::portMiniApp
     end
 
     subgraph 销售邀请
-        A1 --> B1[生成销售邀请码 /generate]
-        B1 --> B2[校验邀请码 /validate]
-        B2 --> B3[获取我的虚拟团队 /my-teams]
-        B3 --> B4[获取团队位置 /my-position]
+        A1 --> B1[📱 生成销售邀请码 /generate]:::portMiniApp
+        B1 --> B2[📱 校验邀请码 /validate]:::portMiniApp
+        B2 --> B3[📱 获取我的虚拟团队 /my-teams]:::portMiniApp
+        B3 --> B4[📱 获取团队位置 /my-position]:::portMiniApp
     end
 
     subgraph 佣金系统
-        A3 --> C1[获取佣金汇总 /summary]
-        C1 --> C2[获取佣金明细 /list]
-        C2 --> C3[获取团队佣金 /team]
-        C3 --> C4[获取佣金统计 /stats]
-        C4 --> C5[获取佣金余额 /balance]
-        C5 --> C6[团队列表 /team/list]
-        C6 --> C7[获取转化漏斗 /funnel]
+        A3 --> C1[📱 获取佣金汇总 /summary]:::portMiniApp
+        C1 --> C2[📱 获取佣金明细 /list]:::portMiniApp
+        C2 --> C3[📱 获取团队佣金 /team]:::portMiniApp
+        C3 --> C4[📱 获取佣金统计 /stats]:::portMiniApp
+        C4 --> C5[📱 获取佣金余额 /balance]:::portMiniApp
+        C5 --> C6[📱 团队列表 /team/list]:::portMiniApp
+        C6 --> C7[📱 获取转化漏斗 /funnel]:::portMiniApp
     end
 
     subgraph 推广素材
-        C7 --> D1[获取素材列表 /list]
-        D1 --> D2[获取素材详情 /detail]
-        D2 --> D3[按场景获取 /by-scenario]
+        C7 --> D1[📱 获取素材列表 /list]:::portMiniApp
+        D1 --> D2[📱 获取素材详情 /detail]:::portMiniApp
+        D2 --> D3[📱 按场景获取 /by-scenario]:::portMiniApp
+        D3 --> D4[📱 创建素材 /create]:::portMiniApp
+        D4 --> D5[📱 更新素材 /update]:::portMiniApp
+        D5 --> D6[📱 删除素材 /delete]:::portMiniApp
     end
 
     subgraph 佣金记录
-        A3 --> E1[记录佣金 /record]
-        E1 --> E2[家庭佣金汇总 /family-total]
+        A3 --> E1[📱 记录佣金 /record]:::portMiniApp
+        E1 --> E2[📱 家庭佣金汇总 /family-total]:::portMiniApp
     end
 
     subgraph 提现
-        C5 --> F1[申请提现 /apply]
-        F1 --> F2[提现记录 /history]
+        C5 --> F1[📱 申请提现 /apply]:::portMiniApp
+        F1 --> F2[📱 提现记录 /history]:::portMiniApp
     end
 
     subgraph 推广排行榜
-        E2 --> G1[获取排行榜 /top]
-        G1 --> G2[获取我的排名 /my-rank]
+        E2 --> G1[📱 获取排行榜 /top]:::portMiniApp
+        G1 --> G2[📱 获取我的排名 /my-rank]:::portMiniApp
     end
 
     R1(("👤 推广员")):::actor
@@ -63,30 +72,33 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/promotion/bind` | 绑定推广关系 |
-| `/api/promotion/commission/list` | 佣金列表 |
-| `/api/promotion/bindings/list` | 绑定列表 |
-| `/api/commission/summary` | 佣金汇总 |
-| `/api/commission/list` | 佣金明细 |
-| `/api/commission/team` | 团队佣金 |
-| `/api/commission/stats` | 佣金统计 |
-| `/api/commission/balance` | 余额 |
-| `/api/commission/team/list` | 团队列表 |
-| `/api/commission/funnel` | 转化漏斗 |
-| `/api/promotion/commission/record` | 记录佣金 |
-| `/api/promotion/commission/family-total` | 家庭佣金汇总 |
-| `/api/promotion/material/list` | 素材列表 |
-| `/api/promotion/material/detail` | 素材详情 |
-| `/api/promotion/material/by-scenario` | 按场景获取 |
-| `/api/distribution/invite/generate` | 生成邀请码 |
-| `/api/distribution/invite/validate` | 校验邀请码 |
-| `/api/distribution/invite/my-teams` | 我的团队 |
-| `/api/distribution/invite/my-position` | 团队位置 |
-| `/api/withdrawal/apply` | 申请提现 |
-| `/api/withdrawal/history` | 提现记录 |
-| `/api/leaderboard/top` | 排行榜 |
-| `/api/leaderboard/my-rank` | 我的排名 |
-| `/api/invite/milestone/list` | 里程碑列表 |
-| `/api/invite/milestone/claim` | 领取里程碑 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/promotion/bind` | 绑定推广关系 | 📱小程序 |
+| `/api/promotion/commission/list` | 佣金列表 | 📱小程序 |
+| `/api/promotion/bindings/list` | 绑定列表 | 📱小程序 |
+| `/api/promotion/commission/record` | 记录佣金 | 📱小程序 |
+| `/api/promotion/commission/family-total` | 家庭佣金汇总 | 📱小程序 |
+| `/api/promotion/material/list` | 素材列表 | 📱小程序 |
+| `/api/promotion/material/detail` | 素材详情 | 📱小程序 |
+| `/api/promotion/material/by-scenario` | 按场景获取 | 📱小程序 |
+| `/api/promotion/material/create` | 创建素材 | 📱小程序 |
+| `/api/promotion/material/update` | 更新素材 | 📱小程序 |
+| `/api/promotion/material/delete` | 删除素材 | 📱小程序 |
+| `/api/commission/summary` | 佣金汇总 | 📱小程序 |
+| `/api/commission/list` | 佣金明细 | 📱小程序 |
+| `/api/commission/team` | 团队佣金 | 📱小程序 |
+| `/api/commission/stats` | 佣金统计 | 📱小程序 |
+| `/api/commission/balance` | 余额 | 📱小程序 |
+| `/api/commission/team/list` | 团队列表 | 📱小程序 |
+| `/api/commission/funnel` | 转化漏斗 | 📱小程序 |
+| `/api/distribution/invite/generate` | 生成邀请码 | 📱小程序 |
+| `/api/distribution/invite/validate` | 校验邀请码 | 📱小程序 |
+| `/api/distribution/invite/my-teams` | 我的团队 | 📱小程序 |
+| `/api/distribution/invite/my-position` | 团队位置 | 📱小程序 |
+| `/api/withdrawal/apply` | 申请提现 | 📱小程序 |
+| `/api/withdrawal/history` | 提现记录 | 📱小程序 |
+| `/api/leaderboard/top` | 排行榜 | 📱小程序 |
+| `/api/leaderboard/my-rank` | 我的排名 | 📱小程序 |
+| `/api/invite/milestone/list` | 里程碑列表 | 📱小程序 |
+| `/api/invite/milestone/claim` | 领取里程碑 | 📱小程序 |

docs/flows/shop-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 商城交易
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,55 +11,66 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 商品浏览
-        A1(("用户")) --> A2[获取商品分类 /category/tree]
-        A2 --> A3[查看分类商品 /category/products]
-        A3 --> A4[获取商品列表 /list]
-        A4 --> A5[获取商品详情 /detail]
-        A5 --> A6[获取规格映射 /spec/map]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取商品分类 /category/tree]:::portMiniApp
+        A2 --> A3[📱 查看分类商品 /category/products]:::portMiniApp
+        A3 --> A4[📱 获取商品列表 /list]:::portMiniApp
+        A4 --> A5[📱 获取商品详情 /detail]:::portMiniApp
+        A5 --> A6[📱 获取规格映射 /spec/map]:::portMiniApp
     end
 
     subgraph 购物车
-        A6 --> B1[添加购物车 /cart/add]
-        B1 --> B2[获取购物车列表 /cart/list]
-        B2 --> B3[更新购物车 /cart/update]
-        B3 --> B4[移除商品 /cart/remove]
-        B4 --> B5[获取购物车数量 /cart/count]
+        A6 --> B1[📱 添加购物车 /cart/add]:::portMiniApp
+        B1 --> B2[📱 获取购物车列表 /cart/list]:::portMiniApp
+        B2 --> B3[📱 更新购物车 /cart/update]:::portMiniApp
+        B3 --> B4[📱 移除商品 /cart/remove]:::portMiniApp
+        B4 --> B5[📱 获取购物车数量 /cart/count]:::portMiniApp
     end
 
     subgraph 下单支付
-        B5 --> C1[创建订单 /product/order/create]
-        C1 --> C2[支付 /product/order/pay]
-        C2 --> C3[支付回调 /product/order/notify]
-        C3 --> C4[处理支付成功 /handlePaymentSuccess]
+        B5 --> C1[📱 创建订单 /product/order/create]:::portMiniApp
+        C1 --> C2[📱 支付 /product/order/pay]:::portMiniApp
+        C2 --> C3[⚙️ 支付回调 /product/order/notify]:::portSystem
+        C3 --> C4[⚙️ 处理支付成功 /handlePaymentSuccess]:::portSystem
     end
 
     subgraph 订单管理
-        C4 --> D1[获取我的订单 /my]
-        D1 --> D2[订单数量统计 /my/counts]
-        D2 --> D3[订单详情 /detail]
-        D3 --> D4{订单状态}
-        D4 -->|待发货| D5[取消订单 /cancel]
-        D4 -->|已发货| D6[确认收货 /confirm]
-        D4 -->|待退款| D7[申请退款 /refund/apply]
+        C4 --> D1[📱 获取我的订单 /my]:::portMiniApp
+        D1 --> D2[📱 订单数量统计 /my/counts]:::portMiniApp
+        D2 --> D3[📱 订单详情 /detail]:::portMiniApp
+        D3 --> D4{📱 订单状态}:::portMiniApp
+        D4 -->|待发货| D5[📱 取消订单 /cancel]:::portMiniApp
+        D4 -->|已发货| D6[📱 确认收货 /confirm]:::portMiniApp
+        D4 -->|待退款| D7[📱 申请退款 /refund/apply]:::portMiniApp
     end
 
     subgraph 商家发货
-        D6 --> E1[商家发货 /ship]
-        E1 --> E2[查询物流 /logistics/query]
+        D6 --> E1[🖥 商家发货 /ship]:::portAdmin
+        E1 --> E2[📱 查询物流 /logistics/query]:::portMiniApp
     end
 
     subgraph 售后
-        D7 --> F1[创建售后 /after-sales/create]
-        F1 --> F2[售后列表 /after-sales/list]
-        F2 --> F3[售后详情 /after-sales/detail]
+        D7 --> F1[📱 创建售后 /after-sales/create]:::portMiniApp
+        F1 --> F2[📱 售后列表 /after-sales/list]:::portMiniApp
+        F2 --> F3[📱 售后详情 /after-sales/detail]:::portMiniApp
     end
 
     subgraph 评价
-        D6 --> G1[发表评价 /review/order]
-        G1 --> G2[评价详情 /review/order/detail]
-        G2 --> G3[评价状态 /review/order/status]
+        D6 --> G1[📱 发表评价 /review/order]:::portMiniApp
+        G1 --> G2[📱 评价详情 /review/order/detail]:::portMiniApp
+        G2 --> G3[📱 评价状态 /review/order/status]:::portMiniApp
+    end
+
+    subgraph 收货地址
+        G3 --> H1[📱 地址列表 /consignee/list]:::portMiniApp
+        H1 --> H2[📱 添加地址 /consignee/save]:::portMiniApp
+        H2 --> H3[📱 地址详情 /consignee/detail]:::portMiniApp
+        H3 --> H4[📱 删除地址 /consignee/delete]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -71,44 +84,48 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/product/list` | 商品列表 |
-| `/api/product/detail` | 商品详情 |
-| `/api/product/create` | 创建商品(商家) |
-| `/api/product/update` | 更新商品 |
-| `/api/product/my` | 我的商品 |
-| `/api/product/shelve` | 上下架 |
-| `/api/product/images/update` | 更新图片 |
-| `/api/product/spec/map` | 规格映射 |
-| `/api/product/order/create` | 创建订单 |
-| `/api/product/order/pay` | 支付 |
-| `/api/product/order/cancel` | 取消订单 |
-| `/api/product/order/my` | 我的订单 |
-| `/api/product/order/my/counts` | 订单数量统计 |
-| `/api/product/order/detail` | 订单详情 |
-| `/api/product/order/vendor` | 商家订单 |
-| `/api/product/order/confirm` | 确认收货 |
-| `/api/product/order/ship` | 发货 |
-| `/api/product/order/refund/apply` | 申请退款 |
-| `/api/product/order/handlePaymentSuccess` | 处理支付成功 |
-| `/api/product/order/notify` | 支付回调 |
-| `/api/product/order/activity/audit` | 活动审核 |
-| `/api/product/order/activity/sign-in` | 活动签到 |
-| `/api/product/order/activity/complete` | 活动完成 |
-| `/api/product/order/activity/provision` | 活动供应 |
-| `/api/product/order/activity/qr-image` | 活动二维码 |
-| `/api/cart/add` | 添加购物车 |
-| `/api/cart/list` | 购物车列表 |
-| `/api/cart/update` | 更新购物车 |
-| `/api/cart/remove` | 移除商品 |
-| `/api/cart/count` | 购物车数量 |
-| `/api/shop/category/tree` | 分类树 |
-| `/api/shop/category/products` | 分类商品 |
-| `/api/shop/after-sales/create` | 创建售后 |
-| `/api/shop/after-sales/list` | 售后列表 |
-| `/api/shop/after-sales/detail` | 售后详情 |
-| `/api/shop/logistics/query` | 查询物流 |
-| `/api/review/order` | 发表评价 |
-| `/api/review/order/detail` | 评价详情 |
-| `/api/review/order/status` | 评价状态 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/product/list` | 商品列表 | 📱小程序 |
+| `/api/product/detail` | 商品详情 | 📱小程序 |
+| `/api/product/spec/map` | 规格映射 | 📱小程序 |
+| `/api/product/order/create` | 创建订单 | 📱小程序 |
+| `/api/product/order/pay` | 支付 | 📱小程序 |
+| `/api/product/order/cancel` | 取消订单 | 📱小程序 |
+| `/api/product/order/my` | 我的订单 | 📱小程序 |
+| `/api/product/order/my/counts` | 订单数量统计 | 📱小程序 |
+| `/api/product/order/detail` | 订单详情 | 📱小程序 |
+| `/api/product/order/confirm` | 确认收货 | 📱小程序 |
+| `/api/product/order/refund/apply` | 申请退款 | 📱小程序 |
+| `/api/cart/add` | 添加购物车 | 📱小程序 |
+| `/api/cart/list` | 购物车列表 | 📱小程序 |
+| `/api/cart/update` | 更新购物车 | 📱小程序 |
+| `/api/cart/remove` | 移除商品 | 📱小程序 |
+| `/api/cart/count` | 购物车数量 | 📱小程序 |
+| `/api/shop/category/tree` | 分类树 | 📱小程序 |
+| `/api/shop/category/products` | 分类商品 | 📱小程序 |
+| `/api/shop/after-sales/create` | 创建售后 | 📱小程序 |
+| `/api/shop/after-sales/list` | 售后列表 | 📱小程序 |
+| `/api/shop/after-sales/detail` | 售后详情 | 📱小程序 |
+| `/api/shop/logistics/query` | 查询物流 | 📱小程序 |
+| `/api/review/order` | 发表评价 | 📱小程序 |
+| `/api/review/order/detail` | 评价详情 | 📱小程序 |
+| `/api/review/order/status` | 评价状态 | 📱小程序 |
+| `/api/consignee/list` | 地址列表 | 📱小程序 |
+| `/api/consignee/save` | 添加/保存地址 | 📱小程序 |
+| `/api/consignee/detail` | 地址详情 | 📱小程序 |
+| `/api/consignee/delete` | 删除地址 | 📱小程序 |
+| `/api/product/create` | 创建商品 | 🖥管理后台 |
+| `/api/product/update` | 更新商品 | 🖥管理后台 |
+| `/api/product/my` | 我的商品 | 🖥管理后台 |
+| `/api/product/shelve` | 上下架 | 🖥管理后台 |
+| `/api/product/images/update` | 更新图片 | 🖥管理后台 |
+| `/api/product/order/vendor` | 商家订单 | 🖥管理后台 |
+| `/api/product/order/ship` | 发货 | 🖥管理后台 |
+| `/api/product/order/handlePaymentSuccess` | 处理支付成功 | ⚙️系统自动 |
+| `/api/product/order/notify` | 支付回调 | ⚙️系统自动 |
+| `/api/product/order/activity/audit` | 活动审核 | 🖥管理后台 |
+| `/api/product/order/activity/sign-in` | 活动签到 | 🖥管理后台 |
+| `/api/product/order/activity/complete` | 活动完成 | 🖥管理后台 |
+| `/api/product/order/activity/provision` | 活动供应 | 🖥管理后台 |
+| `/api/product/order/activity/qr-image` | 活动二维码 | 🖥管理后台 |

docs/flows/stats-report-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 统计报表
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,40 +11,44 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 统计报表
-        A1(("管理员/家长")) --> A2[孩子数据概览 /child/overview]
-        A2 --> A3[家庭汇总统计 /family/summary]
-        A3 --> A4[积分排行榜 /points/ranking]
+        A1(("👤 管理员/家长")):::portMiniApp --> A2[📱 孩子数据概览 /child/overview]:::portMiniApp
+        A2 --> A3[📱 家庭汇总统计 /family/summary]:::portMiniApp
+        A3 --> A4[📱 积分排行榜 /points/ranking]:::portMiniApp
     end
 
     subgraph 任务统计
-        A4 --> B1[仪表盘汇总 /dashboard]
-        B1 --> B2[孩子完成率 /child-completion]
-        B2 --> B3[家庭完成率 /family-completion]
-        B3 --> B4[数据总览 /overview]
-        B4 --> B5[收入统计 /revenue]
-        B5 --> B6[会员分布 /membership]
-        B6 --> B7[每日趋势 /trend]
+        A4 --> B1[🖥 仪表盘汇总 /dashboard]:::portAdmin
+        B1 --> B2[📱 孩子完成率 /child-completion]:::portMiniApp
+        B2 --> B3[📱 家庭完成率 /family-completion]:::portMiniApp
+        B3 --> B4[📱 数据总览 /overview]:::portMiniApp
+        B4 --> B5[🖥 收入统计 /revenue]:::portAdmin
+        B5 --> B6[🖥 会员分布 /membership]:::portAdmin
+        B6 --> B7[📱 每日趋势 /trend]:::portMiniApp
     end
 
     subgraph 地址区域
-        A1 --> C1[获取省份 /provinces]
-        C1 --> C2[获取子级 /children/{parentId}]
-        C2 --> C3[获取详情 /{id}]
-        C3 --> C4[获取完整路径 /{id}/path]
-        C4 --> C5[地址搜索 /search]
-        C5 --> C6[区域回退匹配 /{id}/match]
-        C6 --> C7[按区域统计 /stats]
+        A1 --> C1[📱 获取省份 /provinces]:::portMiniApp
+        C1 --> C2[📱 获取子级 /children/{parentId}]:::portMiniApp
+        C2 --> C3[📱 获取详情 /{id}]:::portMiniApp
+        C3 --> C4[📱 获取完整路径 /{id}/path]:::portMiniApp
+        C4 --> C5[📱 地址搜索 /search]:::portMiniApp
+        C5 --> C6[📱 区域回退匹配 /{id}/match]:::portMiniApp
+        C6 --> C7[📱 按区域统计 /stats]:::portMiniApp
     end
 
     subgraph 用户地址
-        A1 --> D1[地址列表 /user/address/list]
-        D1 --> D2[获取地址 /user/address/get]
-        D2 --> D3[创建地址 /user/address/create]
-        D3 --> D4[更新地址 /user/address/update]
-        D4 --> D5[删除地址 /user/address/delete]
-        D5 --> D6[设为默认 /user/address/setDefault]
+        A1 --> D1[📱 地址列表 /user/address/list]:::portMiniApp
+        D1 --> D2[📱 获取地址 /user/address/get]:::portMiniApp
+        D2 --> D3[📱 创建地址 /user/address/create]:::portMiniApp
+        D3 --> D4[📱 更新地址 /user/address/update]:::portMiniApp
+        D4 --> D5[📱 删除地址 /user/address/delete]:::portMiniApp
+        D5 --> D6[📱 设为默认 /user/address/setDefault]:::portMiniApp
     end
 
     R1(("👤 管理员/家长")):::actor
@@ -54,31 +60,31 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/stats/child/overview` | 孩子数据概览 |
-| `/api/stats/family/summary` | 家庭汇总 |
-| `/api/stats/points/ranking` | 积分排行榜 |
-| `/api/stats/dashboard` | 仪表盘汇总 |
-| `/api/stats/child-completion` | 孩子完成率 |
-| `/api/stats/family-completion` | 家庭完成率 |
-| `/api/stats/overview` | 数据总览 |
-| `/api/stats/revenue` | 收入统计 |
-| `/api/stats/membership` | 会员分布 |
-| `/api/stats/trend` | 每日趋势 |
-| `/api/region/provinces` | 省份列表 |
-| `/api/region/cities` | 城市列表 |
-| `/api/region/districts` | 区县列表 |
-| `/api/region/streets` | 街道列表 |
-| `/api/streets/provinces` | 所有省份 |
-| `/api/streets/children/{parentId}` | 子级地址 |
-| `/api/streets/{id}` | 地址详情 |
-| `/api/streets/{id}/path` | 地址路径 |
-| `/api/streets/search` | 搜索地址 |
-| `/api/streets/{id}/match` | 区域回退匹配 |
-| `/api/streets/stats` | 区域统计 |
-| `/api/user/address/list` | 地址列表 |
-| `/api/user/address/create` | 创建地址 |
-| `/api/user/address/update` | 更新地址 |
-| `/api/user/address/delete` | 删除地址 |
-| `/api/user/address/setDefault` | 设为默认 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/stats/child/overview` | 孩子数据概览 | 📱小程序 |
+| `/api/stats/family/summary` | 家庭汇总 | 📱小程序 |
+| `/api/stats/points/ranking` | 积分排行榜 | 📱小程序 |
+| `/api/stats/dashboard` | 仪表盘汇总 | 🖥管理后台 |
+| `/api/stats/child-completion` | 孩子完成率 | 📱小程序 |
+| `/api/stats/family-completion` | 家庭完成率 | 📱小程序 |
+| `/api/stats/overview` | 数据总览 | 📱小程序 |
+| `/api/stats/revenue` | 收入统计 | 🖥管理后台 |
+| `/api/stats/membership` | 会员分布 | 🖥管理后台 |
+| `/api/stats/trend` | 每日趋势 | 📱小程序 |
+| `/api/region/provinces` | 省份列表 | 📱小程序 |
+| `/api/region/cities` | 城市列表 | 📱小程序 |
+| `/api/region/districts` | 区县列表 | 📱小程序 |
+| `/api/region/streets` | 街道列表 | 📱小程序 |
+| `/api/streets/provinces` | 所有省份 | 📱小程序 |
+| `/api/streets/children/{parentId}` | 子级地址 | 📱小程序 |
+| `/api/streets/{id}` | 地址详情 | 📱小程序 |
+| `/api/streets/{id}/path` | 地址路径 | 📱小程序 |
+| `/api/streets/search` | 搜索地址 | 📱小程序 |
+| `/api/streets/{id}/match` | 区域回退匹配 | 📱小程序 |
+| `/api/streets/stats` | 区域统计 | 📱小程序 |
+| `/api/user/address/list` | 地址列表 | 📱小程序 |
+| `/api/user/address/create` | 创建地址 | 📱小程序 |
+| `/api/user/address/update` | 更新地址 | 📱小程序 |
+| `/api/user/address/delete` | 删除地址 | 📱小程序 |
+| `/api/user/address/setDefault` | 设为默认 | 📱小程序 |

docs/flows/task-management-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 任务管理
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,50 +11,66 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 任务创建
-        A1(("家长/规划师")) --> A2{创建来源}
-        A2 -->|手动创建| A3[创建任务 /create]
-        A2 -->|从模板| A4[市场购买模板 → 应用]
-        A2 -->|AI推荐| A5[AI生成任务建议 → 一键添加]
-        A2 -->|训练方案| A6[训练方案下发 /deploy]
-        A3 --> A7[获取可选小游戏 /minigame-options]
+        A1(("👤 家长/规划师")):::portMiniApp --> A2{📱 创建来源}:::portMiniApp
+        A2 -->|手动创建| A3[📱 创建任务 /create]:::portMiniApp
+        A2 -->|从模板| A4[📱 市场购买模板 → 应用]:::portMiniApp
+        A2 -->|AI推荐| A5[📱 AI生成任务建议 → 一键添加]:::portMiniApp
+        A2 -->|训练方案| A6[📱 训练方案下发 /deploy]:::portMiniApp
+        A3 --> A7[📱 获取可选小游戏 /minigame-options]:::portMiniApp
     end
 
     subgraph 任务执行
-        A7 --> B1[获取今日任务 /today]
-        B1 --> B2{任务类型}
-        B2 -->|普通任务| B3[完成任务 /{id}/complete]
-        B2 -->|小游戏| B4[完成小游戏 /{id}/complete-minigame]
-        B2 -->|家长任务| B5[家长完成任务 /{id}/complete-parent]
-        B3 --> B6{需要审核?}
-        B6 -->|是| B7[进入待审核 /pending-review]
-        B6 -->|否| B8[任务完成]
+        A7 --> B1[📱 获取今日任务 /today]:::portMiniApp
+        B1 --> B2{📱 任务类型}:::portMiniApp
+        B2 -->|普通任务| B3[📱 完成任务 /{id}/complete]:::portMiniApp
+        B2 -->|小游戏| B4[📱 完成小游戏 /{id}/complete-minigame]:::portMiniApp
+        B2 -->|家长任务| B5[📱 家长完成任务 /{id}/complete-parent]:::portMiniApp
+        B3 --> B6{📱 需要审核?}:::portMiniApp
+        B6 -->|是| B7[📱 进入待审核 /pending-review]:::portMiniApp
+        B6 -->|否| B8[📱 任务完成]:::portMiniApp
         B4 --> B8
         B5 --> B8
     end
 
     subgraph 任务审核
-        B7 --> C1[获取待审核列表 /pending-review]
-        C1 --> C2[审核任务 /{id}/review]
-        C2 --> C3{审核结果}
-        C3 -->|通过| C4[任务完成 发放能量]
-        C3 -->|驳回| C5[任务退回]
+        B7 --> C1[📱 获取待审核列表 /pending-review]:::portMiniApp
+        C1 --> C2[📱 审核任务 /{id}/review]:::portMiniApp
+        C2 --> C3{📱 审核结果}:::portMiniApp
+        C3 -->|通过| C4[📱 任务完成 发放能量]:::portMiniApp
+        C3 -->|驳回| C5[📱 任务退回]:::portMiniApp
     end
 
     subgraph 规划师批量管理
-        A1 --> D1[获取关联家庭 /bound-families]
-        D1 --> D2[获取家庭任务概览 /{familyId}/overview]
-        D2 --> D3[获取孩子任务 /{familyId}/children/{childId}/tasks]
-        D3 --> D4[批量审核 /batch-review]
-        D4 --> D5[修改任务 /{taskId}]
-        D5 --> D6[删除任务 /{taskId}/delete]
+        A1 --> D1[📋 获取关联家庭 /bound-families]:::portGuide
+        D1 --> D2[📋 获取家庭任务概览 /{familyId}/overview]:::portGuide
+        D2 --> D3[📋 获取孩子任务 /{familyId}/children/{childId}/tasks]:::portGuide
+        D3 --> D4[📋 批量审核 /batch-review]:::portGuide
+        D4 --> D5[📋 修改任务 /{taskId}]:::portGuide
+        D5 --> D6[📋 删除任务 /{taskId}/delete]:::portGuide
     end
 
     subgraph 任务历史与统计
-        B8 --> E1[获取任务历史 /history]
-        E1 --> E2[批量完成任务 /batch-complete]
-        E2 --> E3[批量删除任务 /batch-delete]
+        B8 --> E1[📱 获取任务历史 /history]:::portMiniApp
+        E1 --> E2[📱 批量完成任务 /batch-complete]:::portMiniApp
+        E2 --> E3[📱 批量删除任务 /batch-delete]:::portMiniApp
+    end
+
+    subgraph 任务提醒
+        E3 --> F1[📱 即将到期 /api/task-reminders/upcoming/{childId}]:::portMiniApp
+        F1 --> F2[📱 逾期任务 /api/task-reminders/overdue/{childId}]:::portMiniApp
+        F2 --> F3[📱 提醒设置 /api/task-reminders/reminder/{childId}]:::portMiniApp
+        F3 --> F4{📱 统计分析}:::portMiniApp
+        F4 -->|任务统计| F5[📱 /api/task-reminders/statistics/{childId}]:::portMiniApp
+        F4 -->|分类统计| F6[📱 /api/task-reminders/statistics/category/{childId}]:::portMiniApp
+        F4 -->|日期统计| F7[📱 /api/task-reminders/statistics/date/{childId}]:::portMiniApp
+        F4 -->|家庭统计| F8[📱 /api/task-reminders/statistics/family/{familyId}]:::portMiniApp
+        F3 --> F9[📱 历史过滤 /api/task-reminders/history/filter/{childId}]:::portMiniApp
     end
 
     R1(("👤 家长/规划师")):::actor
@@ -66,25 +84,33 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/tasks/create` | 创建任务 |
-| `/api/tasks/today` | 获取今日任务 |
-| `/api/tasks/{id}/complete` | 完成任务 |
-| `/api/tasks/{id}/review` | 审核任务 |
-| `/api/tasks/history` | 获取任务历史 |
-| `/api/tasks/pending-review` | 获取待审核任务 |
-| `/api/tasks/today-parent` | 获取家长今日任务 |
-| `/api/tasks/{id}/complete-parent` | 家长完成任务 |
-| `/api/tasks/{id}/complete-minigame` | 完成小游戏任务 |
-| `/api/tasks/batch-complete` | 批量完成任务 |
-| `/api/tasks/batch-delete` | 批量删除任务 |
-| `/api/tasks/minigame-options` | 获取可选小游戏 |
-| `/api/guide/families/bound-families` | 获取关联家庭 |
-| `/api/guide/families/{familyId}/overview` | 家庭任务概览 |
-| `/api/guide/families/{familyId}/children/{childId}/tasks` | 孩子任务列表 |
-| `/api/guide/families/{familyId}/children/{childId}/pending-review` | 待审核列表 |
-| `/api/guide/families/{familyId}/tasks/{taskId}/review` | 审核任务 |
-| `/api/guide/families/{familyId}/tasks/batch-review` | 批量审核 |
-| `/api/guide/families/{familyId}/tasks/{taskId}/delete` | 删除任务 |
-| `/api/guide/families/dashboard-stats` | 规划师首页统计 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/tasks/create` | 创建任务 | 📱小程序 |
+| `/api/tasks/today` | 获取今日任务 | 📱小程序 |
+| `/api/tasks/{id}/complete` | 完成任务 | 📱小程序 |
+| `/api/tasks/{id}/review` | 审核任务 | 📱小程序 |
+| `/api/tasks/history` | 获取任务历史 | 📱小程序 |
+| `/api/tasks/pending-review` | 获取待审核任务 | 📱小程序 |
+| `/api/tasks/today-parent` | 获取家长今日任务 | 📱小程序 |
+| `/api/tasks/{id}/complete-parent` | 家长完成任务 | 📱小程序 |
+| `/api/tasks/{id}/complete-minigame` | 完成小游戏任务 | 📱小程序 |
+| `/api/tasks/batch-complete` | 批量完成任务 | 📱小程序 |
+| `/api/tasks/batch-delete` | 批量删除任务 | 📱小程序 |
+| `/api/tasks/minigame-options` | 获取可选小游戏 | 📱小程序 |
+| `/api/task-reminders/upcoming/{childId}` | 即将到期任务 | 📱小程序 |
+| `/api/task-reminders/overdue/{childId}` | 逾期任务 | 📱小程序 |
+| `/api/task-reminders/reminder/{childId}` | 提醒设置 | 📱小程序 |
+| `/api/task-reminders/statistics/{childId}` | 任务统计 | 📱小程序 |
+| `/api/task-reminders/statistics/category/{childId}` | 分类统计 | 📱小程序 |
+| `/api/task-reminders/statistics/date/{childId}` | 日期统计 | 📱小程序 |
+| `/api/task-reminders/statistics/family/{familyId}` | 家庭统计 | 📱小程序 |
+| `/api/task-reminders/history/filter/{childId}` | 历史过滤 | 📱小程序 |
+| `/api/guide/families/bound-families` | 获取关联家庭 | 📋规划师端 |
+| `/api/guide/families/{familyId}/overview` | 家庭任务概览 | 📋规划师端 |
+| `/api/guide/families/{familyId}/children/{childId}/tasks` | 孩子任务列表 | 📋规划师端 |
+| `/api/guide/families/{familyId}/children/{childId}/pending-review` | 待审核列表 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/{taskId}/review` | 审核任务 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/batch-review` | 批量审核 | 📋规划师端 |
+| `/api/guide/families/{familyId}/tasks/{taskId}/delete` | 删除任务 | 📋规划师端 |
+| `/api/guide/families/dashboard-stats` | 规划师首页统计 | 📋规划师端 |

docs/flows/tianpan-fortune-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 天盘与运势
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,17 +11,21 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 天盘首页
-        A1(("用户")) --> A2[获取天盘首页 /dashboard]
-        A2 --> A3[查看成员天盘 /member/{memberId}]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取天盘首页 /dashboard]:::portMiniApp
+        A2 --> A3[📱 查看成员天盘 /member/{memberId}]:::portMiniApp
     end
 
     subgraph 天盘分析
-        A3 --> B1[查看成员兼容性 /compatibility]
-        B1 --> B2[获取年度能量 /annual-energy]
-        B2 --> B3[获取每日运势 /daily-fortune]
-        B3 --> B4[获取相关项目 /related-items]
+        A3 --> B1[📱 查看成员兼容性 /compatibility]:::portMiniApp
+        B1 --> B2[📱 获取年度能量 /annual-energy]:::portMiniApp
+        B2 --> B3[📱 获取每日运势 /daily-fortune]:::portMiniApp
+        B3 --> B4[📱 获取相关项目 /related-items]:::portMiniApp
     end
 
     R1(("👤 用户")):::actor
@@ -29,11 +35,11 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/tianpan/dashboard` | 天盘首页 |
-| `/api/tianpan/member/{memberId}` | 成员天盘 |
-| `/api/tianpan/compatibility` | 成员兼容性 |
-| `/api/tianpan/annual-energy` | 年度能量 |
-| `/api/tianpan/daily-fortune` | 每日运势 |
-| `/api/tianpan/related-items` | 相关项目 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/tianpan/dashboard` | 天盘首页 | 📱小程序 |
+| `/api/tianpan/member/{memberId}` | 成员天盘 | 📱小程序 |
+| `/api/tianpan/compatibility` | 成员兼容性 | 📱小程序 |
+| `/api/tianpan/annual-energy` | 年度能量 | 📱小程序 |
+| `/api/tianpan/daily-fortune` | 每日运势 | 📱小程序 |
+| `/api/tianpan/related-items` | 相关项目 | 📱小程序 |

docs/flows/user-auth-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 认证与用户管理
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,47 +11,51 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 注册登录
-        A1(("用户")) --> A2{已有账号?}
-        A2 -->|否| A3{注册方式}
-        A3 -->|微信授权| A4[微信静默登录 /silent-login]
-        A3 -->|手机号| A5[发送验证码 /send-code]
-        A5 --> A6[手机号验证码登录 /phone-login]
-        A3 -->|手机号+身份证| A7[注册登录 /register-with-idcard]
-        A3 -->|邀请码| A8[邀请码注册 /register-with-invite]
-        A3 -->|直接注册| A9[直接注册 /direct-register]
-        A4 --> A10[系统自动创建账号]
+        A1(("👤 用户")):::portMiniApp --> A2{📱 已有账号?}:::portMiniApp
+        A2 -->|否| A3{📱 注册方式}:::portMiniApp
+        A3 -->|微信授权| A4[📱 微信静默登录 /silent-login]:::portMiniApp
+        A3 -->|手机号| A5[📱 发送验证码 /send-code]:::portMiniApp
+        A5 --> A6[📱 手机号验证码登录 /phone-login]:::portMiniApp
+        A3 -->|手机号+身份证| A7[📱 注册登录 /register-with-idcard]:::portMiniApp
+        A3 -->|邀请码| A8[📱 邀请码注册 /register-with-invite]:::portMiniApp
+        A3 -->|直接注册| A9[📱 直接注册 /direct-register]:::portMiniApp
+        A4 --> A10[⚙️ 系统自动创建账号]:::portSystem
         A6 --> A10
         A7 --> A10
         A8 --> A10
         A9 --> A10
-        A2 -->|是| A11{登录方式}
-        A11 -->|微信| A12[微信code登录 /wechat-login]
-        A11 -->|手机号| A13[手机验证码登录 /phone-login]
-        A11 -->|openid| A14[openid自动登录 /auto-login]
-        A12 --> A15[JWT签发]
+        A2 -->|是| A11{📱 登录方式}:::portMiniApp
+        A11 -->|微信| A12[📱 微信code登录 /wechat-login]:::portMiniApp
+        A11 -->|手机号| A13[📱 手机验证码登录 /phone-login]:::portMiniApp
+        A11 -->|openid| A14[📱 openid自动登录 /auto-login]:::portMiniApp
+        A12 --> A15[⚙️ JWT签发]:::portSystem
         A13 --> A15
         A14 --> A15
         A10 --> A15
     end
 
     subgraph 认证与安全
-        A15 --> B1[验证JWT Token /verify]
-        B1 --> B2{Token有效?}
-        B2 -->|有效| B3[获取用户信息 /info]
-        B2 -->|过期| B4[重新登录]
-        B3 --> B5[设置密码 /set-password]
-        B3 --> B6[验证密码 /verify-password]
-        B3 --> B7[检查手机号 /check-phone]
+        A15 --> B1[⚙️ 验证JWT Token /verify]:::portSystem
+        B1 --> B2{⚙️ Token有效?}:::portSystem
+        B2 -->|有效| B3[📱 获取用户信息 /info]:::portMiniApp
+        B2 -->|过期| B4[📱 重新登录]:::portMiniApp
+        B3 --> B5[📱 设置密码 /set-password]:::portMiniApp
+        B3 --> B6[📱 验证密码 /verify-password]:::portMiniApp
+        B3 --> B7[📱 检查手机号 /check-phone]:::portMiniApp
     end
 
     subgraph 角色切换
-        B3 --> C1{当前角色}
-        C1 -->|家长| C2[切换到孩子视图 /switch-role]
-        C1 -->|孩子| C3[切换回家长 /switch-back-to-parent]
-        C1 -->|带密码校验| C4[密码校验切换 /switch-back-verify]
-        C2 --> C5[获取用户角色列表 /roles]
+        B3 --> C1{📱 当前角色}:::portMiniApp
+        C1 -->|家长| C2[📱 切换到孩子视图 /switch-role]:::portMiniApp
+        C1 -->|孩子| C3[📱 切换回家长 /switch-back-to-parent]:::portMiniApp
+        C1 -->|带密码校验| C4[📱 密码校验切换 /switch-back-verify]:::portMiniApp
+        C2 --> C5[📱 获取用户角色列表 /roles]:::portMiniApp
         C3 --> C5
     end
 
@@ -62,25 +68,25 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 方法 | 说明 |
+| 端点 | 说明 | 端口 |
 |------|------|------|
-| `/api/auth/send-code` | POST | 发送短信验证码 |
-| `/api/auth/phone-login` | POST | 手机号+验证码登录 |
-| `/api/auth/wechat-phone-login` | POST | 微信手机号登录 |
-| `/api/auth/silent-login` | POST | 微信静默登录 |
-| `/api/auth/auto-login` | POST | openid自动登录 |
-| `/api/auth/register-with-idcard` | POST | 手机号+身份证注册登录 |
-| `/api/auth/wechat-login` | POST | 微信code登录 |
-| `/api/auth/info` | POST | 获取当前用户信息 |
-| `/api/auth/set-password` | POST | 设置密码 |
-| `/api/auth/verify` | POST | 验证JWT Token有效性 |
-| `/api/auth/verify-password` | POST | 验证密码 |
-| `/api/auth/check-phone` | POST | 检查手机号是否已注册 |
-| `/api/auth/direct-register` | POST | 直接注册用户 |
-| `/api/auth/register-with-invite` | POST | 使用邀请码注册 |
-| `/api/auth/switch-role` | POST | 切换角色 |
-| `/api/user/info` | POST | 获取用户信息 |
-| `/api/user/update` | POST | 更新用户信息 |
-| `/api/user/children/list` | POST | 获取子女列表 |
-| `/api/user/family-members` | POST | 获取家庭成员列表 |
-| `/api/user/action-stats` | POST | 获取用户行动统计 |
+| `/api/auth/send-code` | 发送短信验证码 | ⚙️系统自动 |
+| `/api/auth/phone-login` | 手机号+验证码登录 | 📱小程序 |
+| `/api/auth/wechat-phone-login` | 微信手机号登录 | 📱小程序 |
+| `/api/auth/silent-login` | 微信静默登录 | 📱小程序 |
+| `/api/auth/auto-login` | openid自动登录 | 📱小程序 |
+| `/api/auth/register-with-idcard` | 手机号+身份证注册登录 | 📱小程序 |
+| `/api/auth/wechat-login` | 微信code登录 | 📱小程序 |
+| `/api/auth/info` | 获取当前用户信息 | 📱小程序 |
+| `/api/auth/set-password` | 设置密码 | 📱小程序 |
+| `/api/auth/verify` | 验证JWT Token有效性 | ⚙️系统自动 |
+| `/api/auth/verify-password` | 验证密码 | 📱小程序 |
+| `/api/auth/check-phone` | 检查手机号是否已注册 | 📱小程序 |
+| `/api/auth/direct-register` | 直接注册用户 | 📱小程序 |
+| `/api/auth/register-with-invite` | 使用邀请码注册 | 📱小程序 |
+| `/api/auth/switch-role` | 切换角色 | 📱小程序 |
+| `/api/user/info` | 获取用户信息 | 📱小程序 |
+| `/api/user/update` | 更新用户信息 | 📱小程序 |
+| `/api/user/children/list` | 获取子女列表 | 📱小程序 |
+| `/api/user/family-members` | 获取家庭成员列表 | 📱小程序 |
+| `/api/user/action-stats` | 获取用户行动统计 | 📱小程序 |

docs/flows/vendor-butler-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 管家与商家入驻
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,24 +11,30 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 管家服务
-        A1(("用户")) --> A2[申请管家 /apply]
-        A2 --> A3[获取管家资料 /profile]
-        A3 --> A4[更新资料 /update-profile]
-        A4 --> A5[获取家庭成员 /members]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 申请管家 /apply]:::portMiniApp
+        A2 --> A3[📱 获取管家资料 /profile]:::portMiniApp
+        A3 --> A4[📱 更新资料 /update-profile]:::portMiniApp
+        A4 --> A5[📱 获取家庭成员 /members]:::portMiniApp
+        A5 --> A6[📱 服务记录 /service-records]:::portMiniApp
+        A6 --> A7[📱 佣金查询 /commissions]:::portMiniApp
     end
 
     subgraph 商家入驻
-        A1 --> B1[申请入驻 /vendor/apply]
-        B1 --> B2[获取入驻状态 /vendor/status]
-        B2 --> B3[获取商家信息 /vendor/info]
+        A1 --> B1[📱 申请入驻 /vendor/apply]:::portMiniApp
+        B1 --> B2[📱 获取入驻状态 /vendor/status]:::portMiniApp
+        B2 --> B3[📱 获取商家信息 /vendor/info]:::portMiniApp
     end
 
     subgraph 商家管理
-        B3 --> C1[商家商品列表]
-        C1 --> C2[处理订单]
-        C2 --> C3[发货管理]
+        B3 --> C1[🖥 商家商品列表]:::portAdmin
+        C1 --> C2[🖥 处理订单]:::portAdmin
+        C2 --> C3[🖥 发货管理]:::portAdmin
     end
 
     R1(("👤 用户")):::actor
@@ -38,12 +46,14 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/butler/apply` | 申请管家 |
-| `/api/butler/profile` | 管家资料 |
-| `/api/butler/update-profile` | 更新资料 |
-| `/api/butler/members` | 家庭成员 |
-| `/api/vendor/apply` | 申请入驻 |
-| `/api/vendor/status` | 入驻状态 |
-| `/api/vendor/info` | 商家信息 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/butler/apply` | 申请管家 | 📱小程序 |
+| `/api/butler/profile` | 管家资料 | 📱小程序 |
+| `/api/butler/update-profile` | 更新资料 | 📱小程序 |
+| `/api/butler/members` | 家庭成员 | 📱小程序 |
+| `/api/butler/service-records` | 服务记录 | 📱小程序 |
+| `/api/butler/commissions` | 佣金查询 | 📱小程序 |
+| `/api/vendor/apply` | 申请入驻 | 📱小程序 |
+| `/api/vendor/status` | 入驻状态 | 📱小程序 |
+| `/api/vendor/info` | 商家信息 | 📱小程序 |

docs/flows/wealth-insurance-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 财富与保险
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,24 +11,40 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 财商打卡
-        A1(("用户")) --> A2[获取打卡列表 /wealth/checkin/list]
-        A2 --> A3[获取打卡统计 /wealth/checkin/stats]
-        A3 --> A4[创建打卡 /wealth/checkin/create]
-        A4 --> A5[删除打卡 /wealth/checkin/delete]
+        A1(("👤 用户")):::portMiniApp --> A2[📱 获取打卡列表 /wealth/checkin/list]:::portMiniApp
+        A2 --> A3[📱 获取打卡统计 /wealth/checkin/stats]:::portMiniApp
+        A3 --> A4[📱 创建打卡 /wealth/checkin/create]:::portMiniApp
+        A4 --> A5[📱 删除打卡 /wealth/checkin/delete]:::portMiniApp
     end
 
     subgraph 保险规划
-        A5 --> B1[获取保险规划报告 /insurance/planning]
+        A5 --> B1[📱 获取保险规划报告 /insurance/planning]:::portMiniApp
     end
 
     subgraph 保单管理
-        B1 --> C1[获取保单列表 /wealth/insurance/list]
-        C1 --> C2[获取保单详情 /wealth/insurance/detail]
-        C2 --> C3[创建保单 /wealth/insurance/create]
-        C3 --> C4[更新保单 /wealth/insurance/update]
-        C4 --> C5[删除保单 /wealth/insurance/delete]
+        B1 --> C1[📱 获取保单列表 /wealth/insurance/list]:::portMiniApp
+        C1 --> C2[📱 获取保单详情 /wealth/insurance/detail]:::portMiniApp
+        C2 --> C3[📱 创建保单 /wealth/insurance/create]:::portMiniApp
+        C3 --> C4[📱 更新保单 /wealth/insurance/update]:::portMiniApp
+        C4 --> C5[📱 删除保单 /wealth/insurance/delete]:::portMiniApp
+    end
+
+    subgraph 家庭收益
+        C5 --> D1[📱 收益概览 /earnings/family/summary]:::portMiniApp
+        D1 --> D2[📱 收益明细 /earnings/family/records]:::portMiniApp
+        D2 --> D3[📱 成员收益 /earnings/family/members]:::portMiniApp
+    end
+
+    subgraph 收益管理(管理员)
+        D3 --> E1[🖥 收益分配 /earnings/admin/distribute]:::portAdmin
+        E1 --> E2[🖥 成员开关 /earnings/admin/toggle-member]:::portAdmin
+        E2 --> E3[🖥 提现管理 /earnings/admin/withdraw]:::portAdmin
     end
 
     R1(("👤 用户")):::actor
@@ -38,15 +56,21 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/wealth/checkin/list` | 财商打卡列表 |
-| `/api/wealth/checkin/stats` | 打卡统计 |
-| `/api/wealth/checkin/create` | 创建打卡 |
-| `/api/wealth/checkin/delete` | 删除打卡 |
-| `/api/insurance/planning` | 保险规划报告 |
-| `/api/wealth/insurance/list` | 保单列表 |
-| `/api/wealth/insurance/detail` | 保单详情 |
-| `/api/wealth/insurance/create` | 创建保单 |
-| `/api/wealth/insurance/update` | 更新保单 |
-| `/api/wealth/insurance/delete` | 删除保单 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/wealth/checkin/list` | 财商打卡列表 | 📱小程序 |
+| `/api/wealth/checkin/stats` | 打卡统计 | 📱小程序 |
+| `/api/wealth/checkin/create` | 创建打卡 | 📱小程序 |
+| `/api/wealth/checkin/delete` | 删除打卡 | 📱小程序 |
+| `/api/insurance/planning` | 保险规划报告 | 📱小程序 |
+| `/api/wealth/insurance/list` | 保单列表 | 📱小程序 |
+| `/api/wealth/insurance/detail` | 保单详情 | 📱小程序 |
+| `/api/wealth/insurance/create` | 创建保单 | 📱小程序 |
+| `/api/wealth/insurance/update` | 更新保单 | 📱小程序 |
+| `/api/wealth/insurance/delete` | 删除保单 | 📱小程序 |
+| `/api/earnings/family/summary` | 收益概览 | 📱小程序 |
+| `/api/earnings/family/records` | 收益明细 | 📱小程序 |
+| `/api/earnings/family/members` | 成员收益 | 📱小程序 |
+| `/api/earnings/admin/distribute` | 收益分配 | 🖥管理后台 |
+| `/api/earnings/admin/toggle-member` | 成员开关 | 🖥管理后台 |
+| `/api/earnings/admin/withdraw` | 提现管理 | 🖥管理后台 |

docs/flows/wish-management-flow.md

@@ -1,5 +1,7 @@
 # 用户使用流程图 — 心愿管理
 
+> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动
+
 ```mermaid
 flowchart TD
     %% ============ 颜色定义 ============
@@ -9,40 +11,44 @@ flowchart TD
     classDef decision fill:#fce4ec,stroke:#d32f2f,stroke-width:1px
     classDef role fill:#f3e5f5,stroke:#7b1fa2,stroke-width:1px
     classDef endpoint fill:#f5f5f5,stroke:#616161,stroke-width:1px
+    classDef portMiniApp fill:#e3f2fd,stroke:#1565c0,stroke-width:1px,stroke-dasharray:3 2
+    classDef portAdmin fill:#fce4ec,stroke:#c62828,stroke-width:1px,stroke-dasharray:3 2
+    classDef portGuide fill:#fff8e1,stroke:#f57f17,stroke-width:1px,stroke-dasharray:3 2
+    classDef portSystem fill:#f3e5f5,stroke:#6a1b9a,stroke-width:1px,stroke-dasharray:3 2
 
     subgraph 心愿创建
-        A1(("孩子")) --> A2[创建心愿 /create]
-        A2 --> A3{家长审批}
-        A3 -->|通过| A4[家长定价 /{id}/set-price]
-        A3 -->|拒绝| A5[家长拒绝 /{id}/reject]
-        A4 --> A6[心愿上架 显示积分价格]
-        A5 --> A7[心愿关闭]
+        A1(("👶 孩子")):::portMiniApp --> A2[📱 创建心愿 /create]:::portMiniApp
+        A2 --> A3{📱 家长审批}:::portMiniApp
+        A3 -->|通过| A4[📱 家长定价 /{id}/set-price]:::portMiniApp
+        A3 -->|拒绝| A5[📱 家长拒绝 /{id}/reject]:::portMiniApp
+        A4 --> A6[📱 心愿上架 显示积分价格]:::portMiniApp
+        A5 --> A7[📱 心愿关闭]:::portMiniApp
     end
 
     subgraph 心愿兑换
-        A6 --> B1[孩子申请兑换 /{id}/exchange]
-        B1 --> B2[系统检查积分余额]
-        B2 --> B3{积分充足?}
-        B3 -->|是| B4[家长审批兑换 /{id}/approve-exchange]
-        B3 -->|否| B5[积分不足 提示赚积分]
-        B4 --> B6{家长审批}
-        B6 -->|通过| B7[家长标记已购买 /{id}/fulfill]
-        B6 -->|拒绝| B8[兑换驳回]
+        A6 --> B1[📱 孩子申请兑换 /{id}/exchange]:::portMiniApp
+        B1 --> B2[⚙️ 系统检查积分余额]:::portSystem
+        B2 --> B3{⚙️ 积分充足?}:::portSystem
+        B3 -->|是| B4[📱 家长审批兑换 /{id}/approve-exchange]:::portMiniApp
+        B3 -->|否| B5[📱 积分不足 提示赚积分]:::portMiniApp
+        B4 --> B6{📱 家长审批}:::portMiniApp
+        B6 -->|通过| B7[📱 家长标记已购买 /{id}/fulfill]:::portMiniApp
+        B6 -->|拒绝| B8[📱 兑换驳回]:::portMiniApp
     end
 
     subgraph 收货完成
-        B7 --> C1[家长购买商品]
-        C1 --> C2[孩子确认收货 /{id}/confirm]
-        C2 --> C3[心愿完成 扣除积分]
+        B7 --> C1[📱 家长购买商品]:::portMiniApp
+        C1 --> C2[📱 孩子确认收货 /{id}/confirm]:::portMiniApp
+        C2 --> C3[⚙️ 心愿完成 扣除积分]:::portSystem
     end
 
     subgraph 查询管理
-        A6 --> D1[获取心愿列表 /list]
-        D1 --> D2[获取待处理列表 /pending]
-        D2 --> D3[获取心愿详情 /{id}]
+        A6 --> D1[📱 获取心愿列表 /list]:::portMiniApp
+        D1 --> D2[📱 获取待处理列表 /pending]:::portMiniApp
+        D2 --> D3[📱 获取心愿详情 /{id}]:::portMiniApp
         A7 --> D3
         C3 --> D1
-        D3 --> E1[取消心愿 /{id}/cancel]
+        D3 --> E1[📱 取消心愿 /{id}/cancel]:::portMiniApp
     end
 
     R1(("👶 孩子")):::actor
@@ -56,16 +62,16 @@ flowchart TD
 
 ## 端点明细
 
-| 端点 | 说明 |
-|------|------|
-| `/api/wishes/create` | 创建心愿 |
-| `/api/wishes/{id}/set-price` | 家长定价 |
-| `/api/wishes/{id}/reject` | 家长拒绝心愿 |
-| `/api/wishes/{id}/exchange` | 孩子申请兑换 |
-| `/api/wishes/{id}/approve-exchange` | 家长审批兑换 |
-| `/api/wishes/{id}/fulfill` | 家长标记已购买 |
-| `/api/wishes/{id}/confirm` | 孩子确认收货 |
-| `/api/wishes/{id}/cancel` | 取消心愿 |
-| `/api/wishes/list` | 获取心愿列表 |
-| `/api/wishes/pending` | 获取待处理列表 |
-| `/api/wishes/{id}` | 获取心愿详情 |
+| 端点 | 说明 | 端口 |
+|------|------|------|
+| `/api/wishes/create` | 创建心愿 | 📱小程序 |
+| `/api/wishes/{id}/set-price` | 家长定价 | 📱小程序 |
+| `/api/wishes/{id}/reject` | 家长拒绝心愿 | 📱小程序 |
+| `/api/wishes/{id}/exchange` | 孩子申请兑换 | 📱小程序 |
+| `/api/wishes/{id}/approve-exchange` | 家长审批兑换 | 📱小程序 |
+| `/api/wishes/{id}/fulfill` | 家长标记已购买 | 📱小程序 |
+| `/api/wishes/{id}/confirm` | 孩子确认收货 | 📱小程序 |
+| `/api/wishes/{id}/cancel` | 取消心愿 | 📱小程序 |
+| `/api/wishes/list` | 获取心愿列表 | 📱小程序 |
+| `/api/wishes/pending` | 获取待处理列表 | 📱小程序 |
+| `/api/wishes/{id}` | 获取心愿详情 | 📱小程序 |