# VISTA Scene 1.5.0 产品需求文档（暂不实施）

**版本**：1.5.0

**创建日期**：2026-11-03

**更新日期**：2026-11-05

**实施决定**：暂不实施。当前没有必要的使用场景，暂不投入开发成本。需求和原型保留供参考。

## 1. 背景与目标

客户通过 PDF 提供 CB 意见。Refive 将 PDF 交给制作团队，只有追加意见录入 VISTA Scene。制作和复查需要同时查阅 PDF 与系统，将已有意见逐条重新抄录也不现实。

本版本增加 PDF 检查，支持上传多个 PDF、逐页查看和标注。文件中的客户意见经用户核对并点击“加入问题”后，才进入问题列表。

## 2. 适用规则

PDF 检查复用图片检查的页面、操作及权限，差异以本文件为准。

1. 创建检查项和管理上传文件的界面参照 [1.3.0 图片检查需求](https://alidocs.dingtalk.com/i/nodes/qnYMoO1rWxvv479zSjl3RdA4J47Z3je9)的“图片检查项创建”“图片上传、替换与排序”，查看和标注参照“图片查看与标注”。上传区操作的对象是整份 PDF 文件，素材详情中查看和标注的对象是文件解析后的页面。文件排序、删除的权限和阶段限制沿用图片检查。
2. UP／CB 流程、问题状态、编辑、删除、翻译、评论、附件及确认操作，沿用 [1.2.1 产品需求](https://alidocs.dingtalk.com/i/nodes/oP0MALyR8k66rgBKTKK3ZRGlJ3bzYmDO)第 6～8、10 节。PDF 上传、批注提取和识别不代替 CB 提交或客户确认。
3. 素材邀请、访问范围及作者名称显示，沿用 [1.4.0 产品需求](https://alidocs.dingtalk.com/i/nodes/NZQYprEoWo669kYDTQolL0Rj81waOeDk)REQ-001、REQ-002、REQ-004。查看或下载 PDF 时也不得返回用户无权访问的素材内容。
4. “自动识别”、修改识别文字和“加入问题”仅限运营和管理员，且只能在有权访问素材的当前 UP 尚未结束时操作。每次操作均检查权限及轮次。手动新增问题和其他问题操作仍沿用上述原有规则。
5. 素材表单中的版本名为选填，留空不影响保存。系统 UP 轮次由业务流程确定，不由版本名字段决定。

## 3. 需求与验收条件

### REQ-001 PDF 上传与逐页检查

**优先级**：P0

#### 文件上传与管理

1. 一个 PDF 检查项支持上传多个 PDF，也可创建后补充文件。
2. 上传区沿用图片检查的横向文件排列和操作方式，每个条目代表一份 PDF。用户可以在允许操作的阶段对整份 PDF 排序或删除。
3. 上传区不展示解析后的页面，也不提供对单页的排序、删除操作。
4. 用户上传成功后，按原有表单流程保存。后台解析不增加操作步骤，不作为额外的保存条件。

#### 后台解析

1. 文件上传完成后，系统在后台解析该文件。上传和解析是两个处理步骤，不增加单独的解析页面或“开始解析”操作。
2. 系统保留每份 PDF 的全部页面及原页序，包括无批注页。原文件和解析后的页面分别保存，并保持关联。
3. 上传失败的文件不进入解析；其他已上传文件和已有问题保持不变。
4. 文件无法读取或部分页面解析失败时，保留已上传的原文件，在素材详情中显示失败的文件及原因，不误报全部解析成功。

#### 素材详情查看与标注

1. 用户进入素材详情后，才查看 PDF 解析后的页面。文件尚未解析完成时，详情显示该文件正在处理；解析完成后显示对应页面。
2. 多个 PDF 的页面按上传区保存的 PDF 文件顺序排列；每份 PDF 内部保持原页序，不按解析完成的先后顺序排列。
3. 例如，文件顺序为 A、B，A 有 3 页，B 有 2 页，则页面顺序为 A 第 1～3 页、B 第 1～2 页。文件顺序改为 B、A 后，页面顺序相应变为 B 第 1～2 页、A 第 1～3 页，各文件内的页序不变。
4. 文件名在顶部显示；多个文件通过文件下拉菜单切换，不再重复显示同一文件名。原页码显示在底部缩略图中，完整文件名、原页码和总页数可在缩略图提示中查看。页面切换和标注沿用图片检查。
5. 问题记录创建时的项目、素材、UP、PDF 文件、原页码、标注位置和截图。调整 PDF 文件顺序不改变问题的来源和定位。点击问题可返回对应页面；无坐标时显示来源页面及原始内容，不生成猜测的标注点。
6. 后续 UP 不覆盖历史 UP 的文件、文件顺序、页面和问题来源。新 PDF 的相同页码不自动表示同一页面。

#### 验收条件

1. 上传区支持多个 PDF，文件条目按图片检查的方式横向排列；排序和删除作用于整份文件，上传区没有解析页面的列表或单页编辑操作。
2. 上传成功后可以按原流程保存，后台自动解析，无额外解析页面或操作按钮；上传失败的文件不进入解析。
3. A、B 两份文件即使 B 先解析完成，详情仍按保存的 A、B 顺序展示页面；调整文件顺序后，页面组顺序相应变化，组内页序保持不变。
4. 每份 PDF 的页面完整、原页序正确，文件名和原页码可区分，无批注页不丢失。
5. 文件处理中或解析失败时，详情显示对应处理结果；原文件保留，不误报全部解析成功。
6. 有权检查的用户可以查看和标注，从问题列表返回原文件和页面位置；无权或本轮已结束时不能新增问题。
7. 查看历史 UP 时，显示当时保存的文件、顺序和页面，不显示后续 UP 的替换结果。

### REQ-002 PDF 已有批注提取

**优先级**：P0

#### 功能规则

1. 后台解析 PDF 时，系统读取已有批注的正文、关联图形和位置，并保留文件、原页码及原始内容。普通正文、图名、尺寸等不作为客户意见。
2. 批注文字与对应图形保持关联。只有图形时保留原标注，不猜测文字；没有坐标时保留来源页面和内容，不生成猜测的标记点。
3. 已有批注与图片、扫描页和手写意见共用 REQ-003 的页面标记、文字核对及“加入问题”操作，不增加单独的提取入口。
4. 系统分别保留原始内容、用户修改后的文字、实际加入问题的操作人和时间。原提出人和时间只在来源明确时记录，PDF 作者信息不自动对应系统账号。

#### 验收条件

1. 已有批注保留正文、图形及原始来源；普通正文不成为意见，图形批注不出现编造的说明或位置。
2. 修改后的文字与原始内容分别保留，原 PDF 不变；实际操作人与原作者可区分。

### REQ-003 自动识别与加入问题

**优先级**：P0

#### 功能规则

1. 用户在素材详情的当前页点击“自动识别”，系统只处理该页，将 REQ-002 的已有批注和图片、扫描页、手写意见的识别结果标在对应位置。上传、打开或翻页不触发手写识别。
2. 同一处批注及其手写文字属于同一条意见时，共用一个标记，并保留原始来源；不同意见不自动合并，不因文字相同而丢失。
3. 点击标记可查看、修改文字，不另开核对列表。字迹不清时保留原画面，不补写猜测的客户要求。
4. 识别和改字不自动新增问题。用户逐项点击“加入问题”后，系统才新增对应问题，保留文件、原页码、位置、原始内容和最终文字；原位置显示问题编号。没有文字的结果不能加入问题。
5. 再次识别或翻页返回不覆盖已修改的文字，不重复生成同一标记或问题。加入后的问题沿用原有编辑方式。
6. 制作中加入问题不改变制作状态，不代替发布 UP、提交 CB 或客户确认。
7. 无结果或识别失败时说明处理结果，保留原文件、已有问题和已修改的文字；权限取消或本轮结束后，不能继续识别、改字或加入问题。

#### 验收条件

1. 点击“自动识别”后，只有当前页出现识别标记；上传、打开或翻页不自动执行手写识别。
2. 点击标记可查看和改字，问题数保持不变；点击“加入问题”后才增加一条问题，并在原位置显示问题编号。
3. 同一处批注与对应手写文字不重复成点；不同来源的同文意见分别保留。重复识别和翻页不丢失修改，也不重复建问题。
4. 空文字不能加入问题；无结果或识别失败时，原文件、已有问题和已修改的文字保持不变。
5. 运营和管理员可在第 2 节规定的范围内操作；其他角色、历史 UP 和已结束轮次没有相应操作权限。
6. 制作中加入问题后仍为制作中，原有 UP／CB 流程不变。

## 4. PDF 上传与检查流程

### 4.1 PDF 上传与后台解析

上传区管理整份 PDF 文件，后台解析不改变表单流程。

```mermaid
flowchart TB
  A["在上传区选择、排序或删除整份 PDF"]
  B["上传文件"]
  C["上传成功"]
  D["按原有表单流程保存"]
  E["进入素材详情"]
  P["后台逐文件解析"]
  R["保存页面及原文件关联"]
  S["读取各文件的解析结果"]
  T["详情显示文件正在处理"]
  F["按文件顺序及各文件原页序查看、标注"]
  U["上传失败，不解析该文件"]
  X["详情显示解析失败，保留原文件"]
  A --> B
  B -->|成功| C
  B -->|失败| U
  C --> D
  D --> E
  C -->|后台执行| P
  P -->|成功| R
  P -->|失败| X
  E --> S
  R --> S
  S -->|未完成| T
  S -->|完成| F
  S -->|失败| X
```

### 4.2 自动识别、修改文字与加入问题

<!-- mermaid:id=pdf-recognition-and-add-issue -->
```mermaid
flowchart TB
  A["运营或管理员选择当前 PDF 页"]
  B["点击自动识别"]
  C{"识别结果"}
  D["在当前页显示识别标记"]
  E["说明无结果或失败，不新增问题"]
  F["点击标记，查看并按需修改文字"]
  G["点击加入问题"]
  H{"有权限、当前 UP 未结束且文字非空？"}
  I["新增一条问题，原位置显示问题编号"]
  J["不新增问题，保留识别内容"]
  A --> B
  B --> C
  C -->|有结果| D
  C -->|无结果或失败| E
  D --> F
  F -->|暂不加入，保留修改| D
  F -->|确认加入| G
  G --> H
  H -->|是| I
  H -->|否| J
```

## 5. 需求来源

[Refive 访谈与 SOP 客户使用准备（铃木整理·中文译文）](https://alidocs.dingtalk.com/i/nodes/NZQYprEoWo669kYDTXjxpzXD81waOeDk)第 2-1、5-2 节：PDF 与系统重复查阅、重新抄录困难，以及上传 PDF、加页和直接填写 CB 的需要。

2026-11-05 用户确认：上传区管理整份 PDF，后台解析后在详情查看页面；已有批注和手写意见共用“自动识别”，通过页面标记改字、逐项加入问题；相关操作仅限运营和管理员。