# 举报 / 反馈流程

本文档说明举报弹窗的提交流程及接口调用顺序。字段映射详见 **petsHeroAI_client_guide.md**。

---

## 一、前置校验

点击 Submit 时需校验：

| 校验项 | 要求 | 不满足时 |
|--------|------|----------|
| 文字输入 | 必填 | 提示用户填写描述 |
| 图片选择 | 必选 | 提示用户上传图片 |

---

## 二、接口调用顺序

### 2.1 获取上传 URL

| 接口 | 方法 | 说明 |
|------|------|------|
| `/v1/feedback/upload-presigned-url` | POST | 获取图片上传地址 |

**请求体（映射后）**：
- `layer` (fileName)：文件名

**响应 data（映射后）**：
- `shed` (uploadUrl)：上传 URL，用于 PUT 请求
- `hunt` (filePath)：文件路径，用于 submit 的 fileUrls

---

### 2.2 上传图片

使用 **PUT** 方式将所选图片上传到上一步返回的 `uploadUrl`。

- 不经过代理，直接请求返回的 URL
- 请求体为图片二进制数据
- Content-Type 按 HTTP 规范填写（如 `image/jpeg`）

---

### 2.3 提交反馈

| 接口 | 方法 | 说明 |
|------|------|------|
| `/v1/feedback/submit` | POST | 提交举报内容 |

**请求体（映射后）**：
- `inventory` (fileUrls)：文件路径列表，填入 2.1 返回的 `filePath`
- `cloak` (content)：用户输入的文字描述
- `pauldron` (contentType)：内容类型，按 HTTP 格式填写（如 `text/plain`）

---

## 三、流程概览

```
用户填写描述 + 选择图片
        │
        ▼
  校验：文字 + 图片均必填
        │
        ▼
  POST /v1/feedback/upload-presigned-url
  body: { layer: fileName }
        │
        ▼
  获取 uploadUrl、filePath
        │
        ▼
  PUT 图片到 uploadUrl
        │
        ▼
  POST /v1/feedback/submit
  body: { inventory: [filePath], cloak: content, pauldron: contentType }
        │
        ▼
  提交成功，关闭弹窗
```