cfc/docs/flows/circle-contact-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[获取我的圈子 /my-circles]
        A2 --> A3[发现圈子 /discover]
        A3 --> A4[加入圈子 /join]
        A4 --> A5[退出圈子 /leave]
        A5 --> A6[创建圈子 /create]
    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]
    end

    subgraph 圈子挑战
        B5 --> C1[挑战列表 /health/circle/challenge/list]
        C1 --> C2[挑战历史 /health/circle/challenge/history]
    end

    subgraph 家庭挑战
        C2 --> D1[家庭挑战列表 /health/challenge/list]
        D1 --> D2[挑战历史 /health/challenge/history]
        D2 --> D3[挑战进度 /health/challenge/progress]
    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]
    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]
    end

    R1(("👤 用户")):::actor
    R2(("🤝 社交系统")):::system

    A1 -.- R1
    E1 -.- R2

端点明细

端点	说明
/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	已匹配