# VISTA Scene 1.2.3 产品需求文档

**版本**：1.2.3  
**创建日期**：2026-07-27

## REQ-001 成员管理页显示当前项目名称

### 背景

成员管理页用于查看和设置当前项目的成员及角色。

现有页面的面包屑显示为「项目列表 > 项目」。第二级固定显示「项目」，用户无法从页面主内容区确认当前正在设置哪个项目。左侧同时存在多个项目时，可能把成员添加到错误的项目，或误改其他项目的成员角色。

![成员管理页面包屑](./assets/operator-checkup/03-member-management-operator.png)

### 需求范围

调整项目成员管理页的面包屑，使其显示当前项目的真实名称。

本需求不改变成员列表、角色分类、添加成员和修改成员角色的功能。

### 页面显示

成员管理页面包屑显示为：

`项目列表 > {当前项目名称}`

「项目列表」保持为返回项目列表的链接。第二级显示当前项目的名称，不得使用固定文本「项目」。

项目名称必须与项目列表中显示的名称一致。进入其他项目的成员管理页时，面包屑中的项目名称随当前项目变化。

### 长名称显示

项目名称超出面包屑的可用宽度时，页面省略超出的部分，不得挤压成员管理区。鼠标停留在省略后的项目名称上时，显示完整名称。

### 验收条件

1. 从项目列表进入任一项目的成员管理页，面包屑第二级显示该项目的真实名称。
2. 分别进入两个名称不同的项目，面包屑显示对应的项目名称，不沿用上一个项目的名称。
3. 刷新成员管理页后，面包屑仍显示当前项目的正确名称。
4. 项目名称包含中文、日文、英文、数字或空格时，显示内容与项目列表一致。
5. 项目名称超出可用宽度时不挤压成员管理区，且用户能够查看完整名称。

## REQ-002 去除成员列表顶部的纵向滚动条

### 背景

成员列表顶部使用角色分类页签展示全部、运营、CG制作、服务商、主要客户、参与者和制作负责人。

当前页签区域的右侧出现了一条没有实际作用的纵向滚动条，影响页面显示。

![角色分类页签右侧的纵向滚动条](./assets/requirements/REQ-002/member-tabs-vertical-scrollbar.png)

### 需求范围

去除成员列表顶部角色分类页签区域的纵向滚动条。

本需求不改变页签的名称、数量、顺序、成员数量和筛选功能。

### 页面显示

角色分类页签区域不得显示纵向滚动条。页签文字、成员数量和当前选中状态保持完整、清晰，不得因去除滚动条而被裁切或遮挡。

### 验收条件

1. 进入项目成员列表页，角色分类页签区域右侧不显示纵向滚动条。
2. 全部角色分类页签均正常显示，文字和成员数量不被裁切或遮挡。
3. 点击任一角色分类页签，可以正常切换成员列表。
4. 当前选中的页签样式正常显示。

## REQ-003 完整显示运营上传的项目封面

### 背景

项目封面由运营上传，图片通常直接使用装配资料中的封面。图片本身可能包含项目名称、标志、建筑图和其他版面内容。

当前项目卡片会按固定区域裁切封面，导致图片边缘的文字、标志或建筑图显示不全。运营不负责处理图片，不能要求运营在上传前按系统显示比例重新裁剪封面。

![项目列表中的封面裁切情况](./assets/requirements/REQ-003/project-cover-cropped.jpg)

### 需求范围

项目列表中的项目卡片必须完整显示运营上传的封面图片。

本需求不改变封面图片的上传入口、支持格式和文件大小限制。

### 页面显示

封面图片必须铺满项目卡片的封面区域，图片内容完整显示，不得裁切或留白。

图片比例与封面区域不一致时，允许拉伸图片，使图片完整覆盖封面区域。

项目卡片的尺寸和排列方式保持一致，不因封面图片的宽高比例不同而改变。

### 验收条件

1. 运营上传的封面在项目卡片中完整显示，图片四周内容均未被裁切。
2. 封面中的项目名称、标志、建筑图和其他版面内容可以完整查看。
3. 横向、纵向以及不同宽高比例的封面均完整铺满封面区域。
4. 封面区域内不出现留白；图片比例不一致时允许拉伸。
5. 使用不同比例的封面时，项目卡片的尺寸和排列保持一致。
6. 封面显示方式改变后，项目名称、素材数量、问题数量和交付日期正常显示。

## REQ-004 素材时间线面包屑适应长名称

### 背景

素材时间线页面的面包屑依次显示项目列表、项目名称和素材名称。

当项目名称或素材名称较长时，面包屑可能超出页面可用范围，用户难以分辨当前所在的项目和素材。名称较短时，页面应保持现有的自然显示效果。

![长名称下的面包屑](./assets/requirements/REQ-004/material-timeline-breadcrumb-long-name.png)

![常规名称下的面包屑](./assets/requirements/REQ-004/material-timeline-breadcrumb-normal-name.png)

### 需求范围

调整素材时间线页面的面包屑，使项目名称和素材名称能够根据页面空间合理显示。

本需求不改变面包屑的顺序、返回方式和素材时间线的其他内容。

### 页面显示

素材时间线页面包屑显示为：

`项目列表 > {当前项目名称} > {当前素材名称}`

「项目列表」占用固定的显示位置，始终完整显示，不随项目名称或素材名称的长度变化。

页面空间充足时，项目名称和素材名称按照各自的实际长度显示，不增加多余空白。

页面空间不足时，项目名称和素材名称平均使用「项目列表」以外的剩余空间。任何一项均不得独占剩余空间，超出的文字以「...」省略。

鼠标停留在项目名称或素材名称上时，均显示对应的完整名称，无论页面是否已经省略文字。

素材时间线页面不显示其他操作按钮时，面包屑可以使用所在区域的全部可用空间，后方不保留无用途的空白位置。

### 验收条件

1. 进入任一素材时间线页面，面包屑依次显示「项目列表」、当前项目名称和当前素材名称。
2. 项目名称和素材名称较短时，按照实际长度显示，不出现多余空白。
3. 页面空间不足时，项目名称和素材名称平均使用剩余空间，超出的文字显示为「...」。
4. 项目名称或素材名称很长时，「项目列表」仍完整显示，且占用的位置保持不变。
5. 鼠标分别停留在项目名称和素材名称上时，可以查看对应的完整名称。
6. 素材时间线页面没有其他操作按钮时，面包屑后方不保留无用途的空白位置。
7. 项目名称和素材名称包含中文、日文、英文、数字或空格时，均按以上规则显示。