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

> **端口说明**: 📱 小程序 | 🖥 管理后台 | 📋 规划师端 | ⚙️ 系统自动

```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
    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` | 更新层级 | 📱小程序 |