# 用户使用流程图 — 任务模板市场

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

```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[📱 获取公开模板列表 /packages]:::portMiniApp
        A2 --> A3[📱 获取模板详情 /packages/:id]:::portMiniApp
        A3 --> A4[📱 获取任务项 /packages/:id/items]:::portMiniApp
        A4 --> A5[📱 通过分享码获取 /share/:code]:::portMiniApp
    end

    subgraph 购买流程
        A5 --> B1[📱 获取模板价格 /price]:::portMiniApp
        B1 --> B2[📱 获取可用指导师 /available-guides]:::portMiniApp
        B2 --> B3[📱 创建订单 /order/create]:::portMiniApp
        B3 --> B4[⚙️ 获取微信支付参数 /wechat params]:::portSystem
        B4 --> B5[⚙️ 微信支付回调 /notify]:::portSystem
        B5 --> B6[⚙️ 支付成功后应用 /apply]:::portSystem
        B6 --> B7[📱 购买并应用模板 /packages/:id/purchase]:::portMiniApp
    end

    subgraph 我的计划
        B7 --> C1[📱 获取我的计划 /plans]:::portMiniApp
        C1 --> C2[📱 获取计划详情 /plans/:id]:::portMiniApp
        C2 --> C3[📱 获取计划任务项 /plans/:id/items]:::portMiniApp
        C3 --> C4[📱 取消计划 /plans/:id/cancel]:::portMiniApp
    end

    subgraph 模板创建(管理员/规划师)
        A2 --> D1[🖥 创建模板 /create]:::portAdmin
        D1 --> D2[🖥 更新模板 /:id/update]:::portAdmin
        D2 --> D3[🖥 添加任务项 /:id/items]:::portAdmin
        D3 --> D4[🖥 提交审核 /:id/submit]:::portAdmin
        D4 --> D5[🖥 审核通过后发布 /:id/publish]:::portAdmin
    end

    R1(("👤 家长")):::actor
    R2(("📋 规划师/管理员")):::role
    R3(("💳 微信支付")):::system

    A1 -.- R1
    D1 -.- R2
    B5 -.- R3
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/market/packages` | 获取公开模板列表 | 📱小程序 |
| `/api/market/packages/{id}` | 获取模板详情 | 📱小程序 |
| `/api/market/packages/{id}/items` | 获取任务项 | 📱小程序 |
| `/api/market/share/{code}` | 通过分享码获取 | 📱小程序 |
| `/api/market/packages/{id}/purchase` | 购买并应用 | 📱小程序 |
| `/api/market/plans` | 获取我的计划 | 📱小程序 |
| `/api/market/plans/{id}` | 计划详情 | 📱小程序 |
| `/api/market/plans/{id}/items` | 计划任务项 | 📱小程序 |
| `/api/market/plans/{id}/cancel` | 取消计划 | 📱小程序 |
| `/api/package/price` | 模板价格 | 📱小程序 |
| `/api/package/available-guides` | 可用指导师 | 📱小程序 |
| `/api/package/order/create` | 创建订单 | 📱小程序 |
| `/api/package/order/{orderNo}` | 订单详情 | 📱小程序 |
| `/api/payment/create` | 创建支付订单 | 📱小程序 |
| `/api/payment/wechat params` | 微信支付参数 | ⚙️系统自动 |
| `/api/payment/notify` | 支付回调 | ⚙️系统自动 |
| `/api/payment/apply` | 应用模板 | ⚙️系统自动 |
| `/api/packages/create` | 创建模板 | 🖥管理后台 |
| `/api/packages/{id}/update` | 更新模板 | 🖥管理后台 |
| `/api/packages/{id}/submit` | 提交审核 | 🖥管理后台 |
| `/api/packages/{id}/publish` | 发布/下架 | 🖥管理后台 |