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,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	审批通过