# 订单V2 API 文档

本文档描述订单V2管理相关接口规范。

## 1. 全局响应结构

所有接口返回值均由统一响应结构包装，格式如下：

```json
{
  "code": 200,
  "message": "success",
  "success": true,
  "data": {},
  "timestamp": 1709628736123
}
```

---

## 2. 订单V2列表查询

*   **URL**: `/v2/ai/order/v2/list`
*   **Method**: `GET`
*   **描述**: 分页查询订单V2列表，并关联返回风格信息（风格名称、封面、标准定价积分）。

### 请求参数

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `page` | integer | 否 | 页码，默认 1 |
| `size` | integer | 否 | 每页大小，默认 10 |
| `id` | string | 否 | 订单ID（精确匹配） |
| `userId` | integer | 否 | 用户ID |
| `status` | integer | 否 | 订单状态（1:待支付 2:已支付 0:已退款） |
| `taskStatus` | integer | 否 | 任务状态（0异常失败，1任务执行中，2执行完成，3执行失败） |
| `taskId` | string | 否 | 任务ID（精确匹配） |
| `orderLang` | string | 否 | 订单语言 |
| `startTime` | string | 否 | 开始时间（yyyy-MM-dd HH:mm:ss） |
| `endTime` | string | 否 | 结束时间（yyyy-MM-dd HH:mm:ss） |

### 响应参数（`data` 字段）

返回 Mybatis-Plus 分页对象，包含 `records`、`total`、`size`、`current`、`pages` 等字段。

`records` 中每条数据（`AiOrderV2VO`）结构如下：

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `id` | string | 订单ID |
| `userId` | integer | 用户ID |
| `title` | string | 商品标题 |
| `status` | integer | 订单状态（1:待支付 2:已支付 0:已退款） |
| `payPoints` | long | 支付积分 |
| `payTime` | string | 支付时间 |
| `albumId` | integer | 相册ID |
| `styleId` | integer | 模版ID |
| `taskId` | string | 任务ID |
| `taskStatus` | integer | 任务状态（0异常失败，1任务执行中，2执行完成，3执行失败） |
| `orderLang` | string | 订单语言 |
| `errorMessage` | string | 错误信息 |
| `result` | string | 结果数据 |
| `region` | string | 地区 |
| `language` | string | 语言 |
| `appVersion` | string | app版本 |
| `phoneModel` | string | 手机型号 |
| `phoneOsVersion` | string | 手机系统版本 |
| `createTime` | string | 创建时间 |
| `styleName` | string | 风格名称 |
| `styleCoverImg` | string | 风格封面图 |
| `standardPlanPoints` | long | 风格标准定价积分 |

### 示例请求

```http
GET /v2/ai/order/v2/list?page=1&size=10&userId=10001&status=2
```

### 示例响应

```json
{
  "code": 200,
  "message": "success",
  "success": true,
  "data": {
    "records": [
      {
        "id": "ORD_202603090001",
        "userId": 10001,
        "title": "写真生成套餐",
        "status": 2,
        "payPoints": 1990,
        "payTime": "2026-03-09 10:08:30",
        "albumId": 12,
        "styleId": 301,
        "taskId": "TASK_998877",
        "taskStatus": 2,
        "orderLang": "zh-CN",
        "errorMessage": null,
        "result": "{\"images\":[\"https://cdn.example.com/a.jpg\"]}",
        "region": "CN",
        "language": "zh-CN",
        "appVersion": "1.2.0",
        "phoneModel": "iPhone 15 Pro",
        "phoneOsVersion": "iOS 18.3",
        "createTime": "2026-03-09 10:05:00",
        "styleName": "春日写真",
        "styleCoverImg": "https://cdn.example.com/style-cover.jpg",
        "standardPlanPoints": 1990
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1,
    "pages": 1
  },
  "timestamp": 1773033000000
}
```

---

## 3. 订单V2详情查询

*   **URL**: `/v2/ai/order/v2/get/{id}`
*   **Method**: `GET`
*   **描述**: 根据订单ID获取订单V2详情。

### 请求参数

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `id` | string | 是 | 订单ID |

### 响应参数（`data` 字段）

返回 `TAiOrderV2` 对象，字段如下：

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `id` | string | 订单ID |
| `userId` | integer | 用户ID |
| `title` | string | 商品标题 |
| `status` | integer | 订单状态（1:待支付 2:已支付 0:已退款） |
| `payPoints` | long | 支付积分 |
| `payTime` | string | 支付时间 |
| `albumId` | integer | 相册ID |
| `styleId` | integer | 模版ID |
| `taskId` | string | 任务ID |
| `taskStatus` | integer | 任务状态（0异常失败，1任务执行中，2执行完成，3执行失败） |
| `orderLang` | string | 订单语言 |
| `errorMessage` | string | 错误信息 |
| `result` | string | 结果数据 |
| `region` | string | 地区 |
| `language` | string | 语言 |
| `appVersion` | string | app版本 |
| `phoneModel` | string | 手机型号 |
| `phoneOsVersion` | string | 手机系统版本 |
| `createTime` | string | 创建时间 |

### 示例请求

```http
GET /v2/ai/order/v2/get/ORD_202603090001
```

### 示例响应

```json
{
  "code": 200,
  "message": "success",
  "success": true,
  "data": {
    "id": "ORD_202603090001",
    "userId": 10001,
    "title": "写真生成套餐",
    "status": 2,
    "payPoints": 1990,
    "payTime": "2026-03-09 10:08:30",
    "albumId": 12,
    "styleId": 301,
    "taskId": "TASK_998877",
    "taskStatus": 2,
    "orderLang": "zh-CN",
    "errorMessage": null,
    "result": "{\"images\":[\"https://cdn.example.com/a.jpg\"]}",
    "region": "CN",
    "language": "zh-CN",
    "appVersion": "1.2.0",
    "phoneModel": "iPhone 15 Pro",
    "phoneOsVersion": "iOS 18.3",
    "createTime": "2026-03-09 10:05:00"
  },
  "timestamp": 1773033000000
}
```