# 用户使用流程图 — 会员与订阅

```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,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 | 更新层级 |