# 眺望集 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义按楼层、朝向和拍摄位置浏览眺望素材。 |
| 2026-08-11 | v0.2 | 辅助文字说明补充 | 辅助性文字说明纳入关键信息；有内容时固定显示在页面左上角。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 眺望集 |
| 唯一标识 | `view-collection` |
| 分类 | 周边环境 |
| 一句话介绍 | 让顾客按楼层、朝向或拍摄位置浏览已发布的眺望素材并理解取景条件。 |
| 封面图 | 眺望场景类型图。 |
| 设计图 | 图集、筛选与大图信息设计示意。 |

## 2. 目标与场景

面向需要评估视野方向和空间感受的顾客。顾客选择条件、查看眺望图/全景及其拍摄说明，完成对不同视点的比较。

## 3. 内容与数据

每条眺望必需有素材、拍摄楼层或相对高度、朝向或拍摄位置中的至少一项，以及顾客可读标签；拍摄日期、关联住户为可选。辅助性文字说明为该 Widget 的可选内容，有内容时在页面左上角显示，不随全屏查看或筛选而消失。无有效素材不启用。内容反映已提供的拍摄条件，不补推实际未来景观。

## 4. 使用与配置

配置眺望集合、默认素材和可启用筛选维度（楼层、朝向、位置）。维度项不足两个时隐藏。素材可按推荐顺序展示；默认项失效时取首个有效项。

## 5. C端 UI 与交互

默认显示主素材、条件标签、辅助性文字说明和筛选；辅助性文字说明固定在页面左上角。顾客可切换条件、打开全屏查看器、浏览相邻有效素材；无结果可清除筛选。单个素材加载失败时跳过该项并提示，全部失效显示空状态。移动端主图优先，辅助性文字说明仍保留在主图左上角；其他信息通过可展开面板呈现。

## 6. 用户用例与验收

**UC-01**：顾客选择楼层和朝向浏览相符眺望。  
**UC-02**：顾客全屏查看并读取拍摄条件。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 显示条件与当前素材元信息一致。 |
| AC-02 | 无匹配素材可清除条件，不显示空白媒体。 |
| AC-03 | 失效单项不阻断其他有效眺望。 |