# 用户使用流程图 — 心愿管理

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

```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[📱 创建心愿 /create]:::portMiniApp
        A2 --> A3{📱 家长审批}:::portMiniApp
        A3 -->|通过| A4[📱 家长定价 /:id/set-price]:::portMiniApp
        A3 -->|拒绝| A5[📱 家长拒绝 /:id/reject]:::portMiniApp
        A4 --> A6[📱 心愿上架 显示积分价格]:::portMiniApp
        A5 --> A7[📱 心愿关闭]:::portMiniApp
    end

    subgraph 心愿兑换
        A6 --> B1[📱 孩子申请兑换 /:id/exchange]:::portMiniApp
        B1 --> B2[⚙️ 系统检查积分余额]:::portSystem
        B2 --> B3{⚙️ 积分充足?}:::portSystem
        B3 -->|是| B4[📱 家长审批兑换 /:id/approve-exchange]:::portMiniApp
        B3 -->|否| B5[📱 积分不足 提示赚积分]:::portMiniApp
        B4 --> B6{📱 家长审批}:::portMiniApp
        B6 -->|通过| B7[📱 家长标记已购买 /:id/fulfill]:::portMiniApp
        B6 -->|拒绝| B8[📱 兑换驳回]:::portMiniApp
    end

    subgraph 收货完成
        B7 --> C1[📱 家长购买商品]:::portMiniApp
        C1 --> C2[📱 孩子确认收货 /:id/confirm]:::portMiniApp
        C2 --> C3[⚙️ 心愿完成 扣除积分]:::portSystem
    end

    subgraph 查询管理
        A6 --> D1[📱 获取心愿列表 /list]:::portMiniApp
        D1 --> D2[📱 获取待处理列表 /pending]:::portMiniApp
        D2 --> D3[📱 获取心愿详情 /:id]:::portMiniApp
        A7 --> D3
        C3 --> D1
        D3 --> E1[📱 取消心愿 /:id/cancel]:::portMiniApp
    end

    R1(("👶 孩子")):::actor
    R2(("👤 家长")):::role
    R3(("💎 积分系统")):::system

    A1 -.- R1
    A3 -.- R2
    B3 -.- R3
```

## 端点明细

| 端点 | 说明 | 端口 |
|------|------|------|
| `/api/wishes/create` | 创建心愿 | 📱小程序 |
| `/api/wishes/{id}/set-price` | 家长定价 | 📱小程序 |
| `/api/wishes/{id}/reject` | 家长拒绝心愿 | 📱小程序 |
| `/api/wishes/{id}/exchange` | 孩子申请兑换 | 📱小程序 |
| `/api/wishes/{id}/approve-exchange` | 家长审批兑换 | 📱小程序 |
| `/api/wishes/{id}/fulfill` | 家长标记已购买 | 📱小程序 |
| `/api/wishes/{id}/confirm` | 孩子确认收货 | 📱小程序 |
| `/api/wishes/{id}/cancel` | 取消心愿 | 📱小程序 |
| `/api/wishes/list` | 获取心愿列表 | 📱小程序 |
| `/api/wishes/pending` | 获取待处理列表 | 📱小程序 |
| `/api/wishes/{id}` | 获取心愿详情 | 📱小程序 |