# VISTA Scene 1.3.1 产品需求文档

**版本**：1.3.1

**创建日期**：2026-08-28

## 修订记录

| 修订日期 | 版本 | 修订内容 |
|---|---|---|
| 2026-08-28 | 1.3.1 | 创建 VISTA Scene 1.3.1 产品需求文档。 |

VISTA Scene 1.3.1 改善无权限页面访问、WALK 与 VR 查看、CB 图片关闭、素材检查画面、项目打开方式和附件预览。本文未写明的产品规则继续沿用 VISTA Scene 1.3.0 及之前版本。

## REQ-001 无权限页面访问

**优先级**：P0

**类型**：问题修正

### 背景

用户可能通过收藏、浏览器历史记录、已保存的标签页或他人发送的地址，直接打开项目或素材页面。用户没有目标页面的访问权限时，现有页面可能继续进入目标地址，并错误显示“没有上传素材”等与实际原因无关的内容。

### 访问规则

1. 打开项目页、素材页等具体页面时，系统检查当前用户的访问权限。
2. 用户未登录时，完成登录后再检查访问权限。
3. 用户没有访问权限时，直接返回 VISTA Scene 首页，不显示“没有上传素材”。

### 验收条件

1. 有权限的用户通过完整地址打开项目页或素材页时，正常进入目标页面。
2. 无权限的用户打开具体页面时，直接返回首页，不显示“没有上传素材”。
3. 未登录用户完成登录后，系统按照以上规则处理。

## REQ-002 WALK 视点切换方向

**优先级**：P0

**类型**：查看体验优化

### 背景

用户在一个 WALK 视点中旋转画面后切换到其他视点，其他视点可能继承上一视点的查看方向，导致主画面方向与底部缩略图不一致。

### 视点切换规则

1. 点击底部 WALK 视点缩略图时，主画面切换到对应视点，并显示该视点的初始方向。
2. 主画面方向与目标视点的缩略图一致。
3. 在同一视点内旋转画面时，保留用户当前的查看方向。

### 验收条件

1. 在视点 A 中旋转画面后点击视点 B，视点 B 按自身初始方向显示，并与缩略图一致。
2. 在同一视点内连续拖动画面时，页面保留当前查看方向。

## REQ-003 VR 初始视角与交付页面一致

**优先级**：P0

**类型**：问题修正

### 背景

同一 VR 在 VISTA Scene 中打开时，初始视角可能与最终交付页面不同。检查人员需要以最终交付给客户的画面为准，不能通过固定旋转角度推测正确方向。

### 初始视角规则

1. VISTA Scene 中的 VR 初始视角与该 VR 最终交付页面的初始视角一致。
2. 系统读取每个 VR 视点自身设置的初始视角偏移量。

### 验收条件

1. 打开同一个 VR 的 VISTA Scene 检查页面和最终交付页面时，两边初始视角一致。
2. 切换 VR 视点时，每个视点使用自身设置的初始视角偏移量。

## REQ-004 CB 图片预览关闭

**优先级**：P1

**类型**：查看体验优化

### 背景

用户在 WALK 检查页面放大查看 CB 图片后，需要移动到右上角较小的关闭按钮才能返回 WALK，连续检查图片时操作不便。

### 关闭操作

1. CB 图片放大预览时，支持按 `Esc` 键关闭预览并返回原 WALK 画面。
2. 保留关闭按钮，并使其在图片背景上清楚可见。
3. 页面显示 `Esc` 关闭提示。
4. 关闭后保留打开图片前的 WALK 视点和查看方向。

### 验收条件

1. 按 `Esc` 键或点击关闭按钮时，图片预览关闭并返回原 WALK 画面。
2. 关闭按钮和 `Esc` 提示清楚可见。
3. 返回后保留打开图片前的视点和查看方向。

## REQ-005 WALK 与 VR 拖动手感

**优先级**：P1

**类型**：查看体验优化

### 背景

VISTA Scene 中拖动 WALK 或 VR 画面时，阻力和移动速度可能与最终交付页面不同。检查人员会在两个页面之间反复查看，拖动方式不一致会影响检查。

### 拖动规则

1. VISTA Scene 中 WALK 的鼠标拖动速度、阻力和惯性与正式 WALK 交付页面一致。
2. VISTA Scene 中 VR 的鼠标拖动速度、阻力和惯性与正式 VR 交付页面一致。

### 验收条件

1. 使用同一 WALK 分别在 VISTA Scene 和正式交付页面拖动时，两边的移动速度、阻力和停止方式一致。
2. 使用同一 VR 分别在 VISTA Scene 和正式交付页面拖动时，两边的移动速度、阻力和停止方式一致。

## REQ-006 素材检查画面参照 C 端显示

**优先级**：P1

**类型**：查看体验优化

### 背景

素材检查页面的主画面没有占满可用区域，底部可能出现多余白边，能够看到的素材范围小于 C 端页面。

### 显示规则

1. 素材检查页面的主画面占满可用区域。
2. 工具区的显示和收起方式参照同类素材的 C 端页面。
3. 工具区收起后，主画面自动扩大。

### 验收条件

1. 打开素材检查页面时，主画面占满可用区域，不显示多余白边。
2. 用户可以按照 C 端页面的方式收起工具区，收起后主画面自动扩大。

## REQ-007 项目支持在新标签页打开

**优先级**：P1

**类型**：查看体验优化

### 背景

用户检查多个项目时，需要保留项目列表或同时打开不同项目。项目入口需要支持浏览器常用的页面打开方式。

### 打开规则

1. 普通点击项目时，在当前页面打开项目。
2. 使用 `Command/Ctrl + 点击`项目时，在新标签页打开项目。
3. 右键点击项目时，可以通过浏览器菜单在新标签页打开。

### 验收条件

1. 普通点击项目后，当前标签页进入所选项目。
2. 使用 `Command/Ctrl + 点击`或浏览器右键菜单时，所选项目在新标签页打开。

## REQ-008 附件当前页预览

**优先级**：P1

**类型**：查看体验优化

### 背景

查看问题附件时，页面会打开新的浏览器标签页。连续查看多个附件后，用户难以判断附件来自哪一条问题，也需要反复关闭标签页并返回原问题。

### 预览规则

1. 图片、PDF 等可预览附件在当前页面弹出查看。
2. 附件预览关闭后，页面停留在打开附件前的问题和查看位置。
3. 压缩包等不能预览的附件直接下载。

### 验收条件

1. 点击图片或 PDF 附件时，附件在当前页面弹出显示。
2. 关闭预览后，页面停留在打开附件前的问题和查看位置。
3. 点击不能预览的附件时，系统直接下载文件。