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

```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,shape:box

    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]
    end

    subgraph 家庭成员管理
        A9 --> B1[添加家庭成员 /add]
        B1 --> B2[获取家庭成员列表 /list]
        B2 --> B3[更新成员信息 /update]
        B3 --> B4[切换到成员视图 /switch]
        B4 --> B5[检查成员可编辑性 /editable]
        B5 --> B6[踢出成员 /kick]
        B6 --> B7[成员变更日志 /logs]
    end

    subgraph 家庭设置
        B7 --> C1[转让家庭管理员 /transfer-admin]
        C1 --> C2[查询家庭状态 /check-family]
        C2 --> C3[吊销邀请链接 /revoke]
    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]
    end

    subgraph 家长绑定指导师
        C3 --> E1[确认绑定指导师 /accept]
        E1 --> E2[获取绑定指导师列表 /guides]
        E2 --> E3[解除绑定 /unbind]
    end

    R1(("👤 家长")):::actor
    R2(("👶 孩子")):::role
    R3(("👨‍🏫 规划师")):::role

    B2 -.- R2
    E2 -.- R3
```

## 端点明细

| 端点 | 控制器 | 说明 |
|------|--------|------|
| `/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 | 审批通过 |