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

```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

    subgraph 心愿创建
        A1(("孩子")) --> A2[创建心愿 /create]
        A2 --> A3{家长审批}
        A3 -->|通过| A4[家长定价 /{id}/set-price]
        A3 -->|拒绝| A5[家长拒绝 /{id}/reject]
        A4 --> A6[心愿上架 显示积分价格]
        A5 --> A7[心愿关闭]
    end

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

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

    subgraph 查询管理
        A6 --> D1[获取心愿列表 /list]
        D1 --> D2[获取待处理列表 /pending]
        D2 --> D3[获取心愿详情 /{id}]
        A7 --> D3
        C3 --> D1
        D3 --> E1[取消心愿 /{id}/cancel]
    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}` | 获取心愿详情 |