cfc/docs/flows/family-management-flow.md

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

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

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	规划师绑定	📋规划师端