cfc/docs/flows/promotion-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[绑定推广关系 /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	领取里程碑