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
    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	领取里程碑	📱小程序