cfc/docs/flows/membership-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[📱 获取会员等级列表 /levels]:::portMiniApp
        A2 --> A3[📱 获取我的会员信息 /my]:::portMiniApp
        A3 --> A4[📱 获取当前会员等级 /level]:::portMiniApp
        A4 --> A5[📱 获取会员等级详情 /current]:::portMiniApp
        A5 --> A6[📱 获取升级记录 /records]:::portMiniApp
    end

    subgraph 会员升级
        A6 --> B1[📱 创建会员升级订单 /upgrade]:::portMiniApp
        B1 --> B2[📱 创建订单 /orders]:::portMiniApp
        B2 --> B3{📱 是否需要支付?}:::portMiniApp
        B3 -->|是| B4[⚙️ 支付回调 /notify]:::portSystem
        B3 -->|否| B5[📱 直接升级]:::portMiniApp
        B4 --> B5
    end

    subgraph 会员权益
        B5 --> C1[📱 检查功能权限 /can-use]:::portMiniApp
        C1 --> C2[📱 应用会员折扣 /discount]:::portMiniApp
        C2 --> C3[📱 获取任务模板价格 /plans]:::portMiniApp
    end

    subgraph 会员试用
        A6 --> D1[📱 激活试用会员 /trial]:::portMiniApp
        D1 --> D2[📱 试用期体验]:::portMiniApp
    end

    subgraph 订阅管理
        A3 --> E1[📱 获取订阅状态 /status]:::portMiniApp
        E1 --> E2[📱 获取订阅计划 /plans]:::portMiniApp
        E2 --> E3[📱 创建订阅 /create]:::portMiniApp
        E3 --> E4[📱 确认订阅 /subscribe]:::portMiniApp
        E4 --> E5[📱 取消订阅 /cancel]:::portMiniApp
        E5 --> E6[📱 自动续费设置 /auto-renew]:::portMiniApp
        E6 --> E7[📱 获取我的权益 /benefits/my]:::portMiniApp
        E7 --> E8[📱 检查权益 /benefit/check]:::portMiniApp
        E8 --> E9[📱 获取当前订阅层级 /tier]:::portMiniApp
        E9 --> E10[📱 更新订阅层级 /tier/update]:::portMiniApp
    end

    R1(("👤 家长")):::actor
    R2(("💳 微信支付")):::system

    A1 -.- R1
    B4 -.- R2

端点明细

端点	说明	端口
/api/membership/levels	会员等级列表	📱小程序
/api/membership/my	我的会员信息	📱小程序
/api/membership/level	当前等级	📱小程序
/api/membership/current	等级详情	📱小程序
/api/membership/records	升级记录	📱小程序
/api/membership/upgrade	创建升级订单	📱小程序
/api/membership/trial	激活试用	📱小程序
/api/membership/orders	创建订单	📱小程序
/api/membership/plans	任务模板价格	📱小程序
/api/membership/can-use	功能权限检查	📱小程序
/api/membership/discount	应用折扣	📱小程序
/api/membership/notify	支付回调	⚙️系统自动
/api/subscription/status	订阅状态	📱小程序
/api/subscription/plans	订阅计划	📱小程序
/api/subscription/create	创建订阅	📱小程序
/api/subscription/subscribe	确认订阅	📱小程序
/api/subscription/cancel	取消订阅	📱小程序
/api/subscription/auto-renew	自动续费	📱小程序
/api/subscription/benefits/my	我的权益	📱小程序
/api/subscription/benefit/check	检查权益	📱小程序
/api/subscription/tier	订阅层级	📱小程序
/api/subscription/tier/update	更新层级	📱小程序