# 用户使用流程图 — 圈子与联系人

```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[获取我的圈子 /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` | 已匹配 |