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,shape:box

    subgraph 会员查看
        A1(("家长")) --> A2[获取会员等级列表 /levels]
        A2 --> A3[获取我的会员信息 /my]
        A3 --> A4[获取当前会员等级 /level]
        A4 --> A5[获取会员等级详情 /current]
        A5 --> A6[获取升级记录 /records]
    end

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

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

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

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

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

    A1 -.- R1
    B4 -.- R2

端点明细

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