# 用户使用流程图 — 推广分销

```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[绑定推广关系 /bind]
        A2 --> A3[获取佣金列表 /commission/list]
        A3 --> A4[获取绑定列表 /bindings/list]
    end

    subgraph 销售邀请
        A1 --> B1[生成销售邀请码 /generate]
        B1 --> B2[校验邀请码 /validate]
        B2 --> B3[获取我的虚拟团队 /my-teams]
        B3 --> B4[获取团队位置 /my-position]
    end

    subgraph 佣金系统
        A3 --> C1[获取佣金汇总 /summary]
        C1 --> C2[获取佣金明细 /list]
        C2 --> C3[获取团队佣金 /team]
        C3 --> C4[获取佣金统计 /stats]
        C4 --> C5[获取佣金余额 /balance]
        C5 --> C6[团队列表 /team/list]
        C6 --> C7[获取转化漏斗 /funnel]
    end

    subgraph 推广素材
        C7 --> D1[获取素材列表 /list]
        D1 --> D2[获取素材详情 /detail]
        D2 --> D3[按场景获取 /by-scenario]
    end

    subgraph 佣金记录
        A3 --> E1[记录佣金 /record]
        E1 --> E2[家庭佣金汇总 /family-total]
    end

    subgraph 提现
        C5 --> F1[申请提现 /apply]
        F1 --> F2[提现记录 /history]
    end

    subgraph 推广排行榜
        E2 --> G1[获取排行榜 /top]
        G1 --> G2[获取我的排名 /my-rank]
    end

    R1(("👤 推广员")):::actor
    R2(("💰 佣金系统")):::system

    A1 -.- R1
    C1 -.- R2
```

## 端点明细

| 端点 | 说明 |
|------|------|
| `/api/promotion/bind` | 绑定推广关系 |
| `/api/promotion/commission/list` | 佣金列表 |
| `/api/promotion/bindings/list` | 绑定列表 |
| `/api/commission/summary` | 佣金汇总 |
| `/api/commission/list` | 佣金明细 |
| `/api/commission/team` | 团队佣金 |
| `/api/commission/stats` | 佣金统计 |
| `/api/commission/balance` | 余额 |
| `/api/commission/team/list` | 团队列表 |
| `/api/commission/funnel` | 转化漏斗 |
| `/api/promotion/commission/record` | 记录佣金 |
| `/api/promotion/commission/family-total` | 家庭佣金汇总 |
| `/api/promotion/material/list` | 素材列表 |
| `/api/promotion/material/detail` | 素材详情 |
| `/api/promotion/material/by-scenario` | 按场景获取 |
| `/api/distribution/invite/generate` | 生成邀请码 |
| `/api/distribution/invite/validate` | 校验邀请码 |
| `/api/distribution/invite/my-teams` | 我的团队 |
| `/api/distribution/invite/my-position` | 团队位置 |
| `/api/withdrawal/apply` | 申请提现 |
| `/api/withdrawal/history` | 提现记录 |
| `/api/leaderboard/top` | 排行榜 |
| `/api/leaderboard/my-rank` | 我的排名 |
| `/api/invite/milestone/list` | 里程碑列表 |
| `/api/invite/milestone/claim` | 领取里程碑 |