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

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

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

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

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

    subgraph 推广素材
        C7 --> D1[📱 获取素材列表 /list]:::portMiniApp
        D1 --> D2[📱 获取素材详情 /detail]:::portMiniApp
        D2 --> D3[📱 按场景获取 /by-scenario]:::portMiniApp
        D3 --> D4[📱 创建素材 /create]:::portMiniApp
        D4 --> D5[📱 更新素材 /update]:::portMiniApp
        D5 --> D6[📱 删除素材 /delete]:::portMiniApp
    end

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

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

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

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

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

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/promotion/bind` | 绑定推广关系 | 📱小程序 |
| `/api/promotion/commission/list` | 佣金列表 | 📱小程序 |
| `/api/promotion/bindings/list` | 绑定列表 | 📱小程序 |
| `/api/promotion/commission/record` | 记录佣金 | 📱小程序 |
| `/api/promotion/commission/family-total` | 家庭佣金汇总 | 📱小程序 |
| `/api/promotion/material/list` | 素材列表 | 📱小程序 |
| `/api/promotion/material/detail` | 素材详情 | 📱小程序 |
| `/api/promotion/material/by-scenario` | 按场景获取 | 📱小程序 |
| `/api/promotion/material/create` | 创建素材 | 📱小程序 |
| `/api/promotion/material/update` | 更新素材 | 📱小程序 |
| `/api/promotion/material/delete` | 删除素材 | 📱小程序 |
| `/api/commission/summary` | 佣金汇总 | 📱小程序 |
| `/api/commission/list` | 佣金明细 | 📱小程序 |
| `/api/commission/team` | 团队佣金 | 📱小程序 |
| `/api/commission/stats` | 佣金统计 | 📱小程序 |
| `/api/commission/balance` | 余额 | 📱小程序 |
| `/api/commission/team/list` | 团队列表 | 📱小程序 |
| `/api/commission/funnel` | 转化漏斗 | 📱小程序 |
| `/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` | 领取里程碑 | 📱小程序 |