# VISTA Scene 1.3.0 产品需求文档

**版本**：1.3.0

**创建日期**：2026-07-31

## 修订记录

| 修订日期 | 版本 | 修订内容 |
|---|---|---|
| 2026-07-31 | 1.3.0 | 创建 VISTA Scene 1.3.0 产品需求文档。 |
| 2026-08-04 | 1.3.0 | 增加图片拖拽排序、上传期间禁用「确定」按钮，明确创建图片检查项时图片不是必填内容，并将单张图片的大小上限定为 30 MB。 |
| 2026-08-24 | 1.3.0 | 明确后续 UP 沿用上一轮图片：已有图片通过替换提交修改结果，额外上传的图片显示 `NEW` 标识；从 2UP 开始，图片不能改名、删除或调整顺序；问题显示和状态变化沿用 VR、WALK，当前 UP 显示的问题继续对应替换后的图片。 |

VISTA Scene 1.3.0 增加图片素材的交付与检查功能。本文未写明的产品规则继续沿用 VISTA Scene 1.2.4 及之前版本。

## REQ-001 静态图交付与检查

### 背景

图片原本通过群聊发送并反馈问题。一个图片检查项可能包含多张图片。进入后续 UP 时，制作人员需要对上一轮有问题的图片提交修改结果，也可能增加新的图片。

图片需要进入 VISTA Scene 的 UP、CB 检查过程，同时保留多图查看、位置标注和历史问题追踪能力。系统需要区分「修改上一轮图片」和「当前 UP 新增图片」，保证当前 UP 显示的问题能够对应正确的图片。

### 需求范围

本需求适用于「图片」素材类型，创建入口显示为「新增图片检查」。

本需求支持同一个 UP 上传多张图片，不限制每个 UP 的图片数量。视频素材不在本需求范围内。

图片素材沿用现有 UP、CB、确认可渲染和纳品规则。素材条目的创建、UP 上传、UP 发布、问题标注和问题状态修改权限不变。

图片检查在界面中使用 `icon-file-image.svg` 图标。

### 图片检查项创建

1. 创建图片检查项时，图片不是必填内容。
2. 其他必填内容填写完整后，未上传图片也可以点击「确定」创建图片检查项。
3. 图片检查项创建后，可以在后续编辑时上传图片。

### 图片上传、替换与排序

1. 首次 UP 没有历史图片，图片素材支持一次选择并上传多张图片。1UP 发布前，制作人员可以添加、替换、删除、修改图片名称和拖拽调整图片顺序。
2. 进入后续 UP 时，系统自动带入上一轮 UP 的图片、图片名称和排列顺序。
3. 后续 UP 中的每张已有图片都显示「替换」操作。制作人员提交该图片的修改结果时，必须在原图片上执行「替换」，不得将修改后的图片作为新图片另行上传。
4. 从 2UP 开始，上一轮带入的已有图片保持原图片名称和排列位置，不显示改名、删除和拖拽排序操作，只显示「替换」。替换图片后仍使用原图片名称和排列位置。
5. 点击「添加图片」并上传的图片视为当前 UP 的新增图片，追加在已有图片之后。新增图片在当前 UP 显示 `NEW` 标识，不对应上一轮 UP 的任何图片或问题。进入再下一轮 UP 后，该图片作为已有图片处理，不再显示 `NEW` 标识。
6. 从 2UP 开始，当前 UP 新增的图片也不能改名、删除或拖拽调整顺序。新增图片上传错误时，通过该图片的「替换」操作改正；替换后仍显示 `NEW` 标识。
7. 任意图片正在上传或替换时，「确定」按钮禁用，不能提交表单。
8. 新增或替换失败时，系统说明失败原因。替换失败时保留替换前的图片。
9. 全部图片结束上传或替换后，其他必填内容填写完整时，「确定」按钮可以点击。
10. 只有 1UP 发布前可以拖拽调整图片顺序。系统保存调整后的图片顺序，缩略图区域和主画面按该顺序显示图片。
11. 点击「发布 UP」后，本轮图片、图片名称和图片顺序不得修改。

### 图片名称

1. 1UP 处于「制作中」时，有上传 UP 权限的角色可以修改图片在系统内显示的名称。
2. 从 2UP 开始，系统沿用 1UP 确定的图片名称，不提供图片改名操作。
3. 点击「发布 UP」后，本轮图片名称不得修改。

### 文件限制

1. 支持 JPG、JPEG 和 PNG。
2. 不支持 GIF、WebP、TIFF 及其他图片格式。
3. 单张图片的大小上限为 30 MB。
4. 上传区域必须显示支持格式和单张图片大小上限。
5. 文件格式或大小不符合要求时，系统拒绝上传并说明原因。

### 图片查看与标注

图片素材沿用 VISTA Scene 1.2.0 已有的图片查看与标注方式，本需求不改变查看区布局和标注工具。

1. 当前 UP 的图片显示在素材主画面和缩略图区域，用户通过缩略图切换图片。
2. 位置标注绑定创建问题时的 UP 和具体图片，并保留标注位置和标注截图。
3. 新增标注问题的角色、状态和操作规则沿用现有规则。只有拥有标注权限的角色，且素材处于「待 CB」或「CB 中」时，才可以新增标注问题。
4. 点击当前 UP 问题列表中的问题时，主画面切换到该问题对应的图片，并显示标注点。

### 后续 UP 的图片处理

图片问题在后续 UP 中的显示范围、状态变化和历史查看方式沿用 VR、WALK 的现有规则。本节只规定图片在不同 UP 之间的对应关系，以及图片替换后的问题定位方式。

1. 进入下一轮 UP 时，系统沿用上一轮 UP 的图片，已有图片在不同 UP 之间保持对应关系。图片名称不作为判断对应关系的依据。
2. 未替换的已有图片继续显示上一轮的内容。
3. 已有图片被替换后，当前 UP 显示替换后的内容，历史 UP 仍显示当时发布的图片，不被新图片覆盖。
4. 按照现有 VR、WALK 规则显示在当前 UP 的问题，继续对应原来的图片。
5. 问题始终保留提出时的 UP、图片名称、原图和标注截图，不因图片被替换而改变。
6. 对应图片被替换后，当前 UP 显示的问题标注点按原相对位置显示在替换后的图片上。检查人员根据替换后的图片判断问题是否已修改。
7. 对应图片未替换时，当前 UP 显示的问题标注点显示在沿用的上一轮图片上。

### 图片替换示例

1. 1UP 包含 A、B、C 三张图片，A 和 C 存在需要修改的问题。
2. 进入 2UP 时，系统自动带入 A、B、C 及原来的排列顺序。
3. 制作人员分别在 A 和 C 上执行「替换」，上传修改后的图片。A 和 C 仍是原来的图片，不显示 `NEW` 标识，也不显示其他替换状态标识。
4. B 没有替换时，2UP 继续显示 1UP 中的 B。
5. 制作人员通过「添加图片」上传 D，D 追加在 C 之后并显示 `NEW` 标识。D 不能改名、删除或拖拽调整顺序，上传错误时通过「替换」改正。
6. 按照现有 VR、WALK 规则显示在 2UP 的 A、C 问题，继续对应 A、C。点击问题时，主画面分别切换到替换后的 A 或 C，并显示原标注点。

### 验收条件

1. 创建图片检查项时，页面显示「新增图片检查」，创建后的素材类型为「图片」。
2. 创建图片检查项时，未上传图片也可以完成创建；创建后可以在后续编辑时上传图片。
3. 图片检查在素材类型和相关入口中显示 `icon-file-image.svg` 图标。
4. 一个 UP 可以上传多张 JPG、JPEG 或 PNG 图片，系统不限制图片数量。
5. 单张图片不超过 30 MB 时可以上传；超过 30 MB 时，系统拒绝上传并说明原因。
6. 任意图片正在上传或替换时，「确定」按钮禁用；全部图片结束上传或替换，且其他必填内容填写完整后，「确定」按钮可以点击。
7. 1UP 处于「制作中」时，有上传 UP 权限的角色可以添加、替换、删除、修改图片名称和拖拽调整图片顺序。
8. 1UP 调整图片顺序并提交表单后，重新打开页面时保持调整后的顺序；缩略图区域和主画面按该顺序显示。
9. 点击「发布 UP」后，本轮图片、图片名称和图片顺序不能修改。
10. 当前 UP 的全部图片显示在缩略图区域，用户可以通过缩略图切换图片。
11. 标注问题保存后，问题与创建时的 UP 和图片正确关联，并保留标注位置和标注截图。
12. 进入下一轮 UP 时，系统沿用上一轮 UP 的图片、图片名称和排列顺序。
13. 从 2UP 开始，上一轮带入的已有图片不显示改名、删除和拖拽排序操作，只显示「替换」。替换后继续作为同一张已有图片显示，不显示 `NEW` 或其他替换状态标识，图片名称和排列位置不变。
14. 通过「添加图片」额外上传的图片追加在已有图片之后，在当前 UP 显示 `NEW` 标识；进入再下一轮 UP 后不再显示该标识。
15. 从 2UP 开始，当前 UP 新增的图片也不显示改名、删除和拖拽排序操作。新增图片上传错误时可以替换，替换后仍显示 `NEW` 标识。
16. 图片问题在后续 UP 中的显示范围和状态变化与 VR、WALK 相同，不增加图片专用的问题筛选规则。
17. 按照现有规则显示在当前 UP 的问题继续对应原来的图片，并保留提出问题时的 UP、原图、原图片名称和标注截图。
18. 对应图片被替换后，当前 UP 显示的问题标注点按原相对位置显示在替换后的图片上；点击问题时，主画面切换到对应图片并显示标注点。
19. 替换图片失败时，页面说明失败原因，并继续显示替换前的图片。
20. 查看历史 UP 时，页面显示该 UP 发布时的图片，不显示后续 UP 的替换结果。