# 用户使用流程图 — 家庭管理

> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动

```mermaid
flowchart TD
    %% ============ 颜色定义 ============
    classDef actor fill:#e1f5fe,stroke:#0288d1,stroke-width:2px
    classDef action fill:#fff3e0,stroke:#f57c00,stroke-width:1px
    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:#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(("👤 家长")):::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 家庭成员管理
        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 家庭设置
        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 互动记录
        F5 --> G1[📱 互动类型 /interaction/types]:::portMiniApp
        G1 --> G2[📱 添加互动 /interaction/add]:::portMiniApp
        G2 --> G3[📱 互动列表 /interaction/list]:::portMiniApp
    end

    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

    %% 角色标注
    RP(("👤 家长")):::actor
    RC(("👶 孩子")):::role
    RT(("📋 规划师")):::role

    B6 -.- RC
    H5 -.- RT
```

## 端点明细

### 家庭创建与加入
| 端点 | 说明 | 端口 |
|------|------|------|
| `/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` | 规划师绑定 | 📋规划师端 |