# 资料集 Widget PRD

版本：v0.2  
优先级：P1  
状态：待原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义按资料文件夹发现并进入项目公开资料的任务。 |
| 2026-08-03 | v0.2 | 查看与失败状态补充 | 根据 DeepSeek PM 评审明确资料查看动作及单项无法打开时的局部反馈。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 资料集 |
| 唯一标识 | `document-folder-collection` |
| 分类 | 资料内容 |
| 一句话介绍 | 让顾客按文件夹分类找到并查看项目已公开的图册、图纸、视频或文件资料。 |
| 封面图 | 资料集类型图。 |
| 设计图 | 文件夹网格与资料查看设计示意。 |

## 2. 目标与场景

面向需要自主查找项目资料的顾客。顾客浏览文件夹、识别其中资料类型并进入阅读/播放，完成资料发现与获取。

## 3. 内容与数据

每个文件夹必需有名称、至少一项可浏览资料和代表图或资料类型标识；说明、标签、资料数量可选。每项资料须有名称、类型和可用查看动作：图片进入图片查看器、视频进入视频播放查看器、PDF 进入 PDF 查看器，其他已支持类型进入对应通用查看器；未支持类型不提供打开动作。访问条件由资料自身公开状态决定。

## 4. 使用与配置

配置文件夹集合、顺序和展示密度；可开启资料类型筛选。空文件夹不显示；配置集合全部无效时显示 Widget 级空状态。默认采用项目资料默认顺序。

## 5. C端 UI 与交互

默认显示文件夹卡片；顾客打开文件夹查看资料列表或网格，按资料类型进入图片、视频或 PDF 查看器，并可返回文件夹集合。资料无法打开时保留列表，在当前资料行显示“暂时无法打开”及重试动作；文件夹失效从集合移除。移动端以单列/横滑卡片和全屏资料查看器完成任务。

## 6. 用户用例与验收

**UC-01**：顾客在资料分类中找到目标文件夹。  
**UC-02**：顾客打开文件夹内的一项资料并返回继续浏览。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 仅显示至少含一项有效资料的公开文件夹。 |
| AC-02 | 资料按其类型调用正确的通用查看器。 |
| AC-03 | 单项失败不影响同文件夹其他资料。 |
| AC-04 | 单项无法打开时，该资料行显示局部失败和重试，文件夹列表与其他资料仍可继续使用。 |