# 共有部列表 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义公共空间对象的列表浏览与已关联资料入口。 |
| 2026-08-03 | v0.2 | 展示与筛选规则补充 | 根据 DeepSeek PM 评审补齐列表模式和清除筛选后的明确呈现。 |
| 2026-08-04 | v0.3 | 重大：空间体验关联规则调整 | WALK / VR 入口统一改为关联空间体验 Widget 实例；入口类型由实例决定。 |
| 2026-08-06 | v0.4 | 重大：恢复 WALK / VR Widget 关联 | 共有部列表可分别关联 WALK 或 VR Widget；二者共用沉浸承载组件但保持独立业务边界。 |
| 2026-08-11 | v0.5 | 重大：WALK / VR 内容组件化 | WALK、VR 改为共有部的关联内容类型，由沉浸内容承载与控制组件直接调用。 |
| 2026-08-11 | v0.6 | 多建筑分组与交互范围调整 | 多建筑项目按建筑分组同时展示共有部；移除 C端类别筛选功能。 |
| 2026-08-11 | v0.7 | 内容字段收敛 | 删除未经确认的位置、类别、用途摘要、使用说明等字段，仅保留名称、代表图、建筑分组、图集与有效体验入口。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 共有部列表 |
| 唯一标识 | `common-facility-list` |
| 分类 | 建筑与空间 |
| 一句话介绍 | 以公共空间卡片帮助顾客浏览共有部，并进入已关联的资料或体验。 |
| 封面图 | 公共空间场景类型图。 |
| 设计图 | 设施列表与详情抽屉设计示意。 |

## 2. 目标与场景

面向希望评估公共空间品质和使用条件的顾客。顾客浏览设施，并进入已关联资料或 WALK / VR 体验，完成对公共配套的了解。

## 3. 内容与数据

每个共有部必需有名称和代表图；多建筑项目还必须有所属建筑。图集、WALK 内容入口、VR 内容入口可选。仅纳入至少有必需信息的已发布共有部；多建筑项目按所属建筑分组，同时展示各建筑的有效共有部。关联内容只有在已发布、iframe 可用且顾客可访问时出现。WALK 与 VR 分别判断，不因一类不可用而自动改用另一类。

## 4. 使用与配置

配置共有部集合、建筑分组顺序和展示密度（列表/卡片）。多建筑项目按配置顺序显示建筑分组；单建筑项目不显示无意义的分组标题。C端不提供筛选条件。无有效共有部显示空状态；单项素材失效显示媒体占位，不移除其他有效内容。

## 5. C端 UI 与交互

卡片模式按建筑分组显示共有部卡片；列表模式按建筑分组以紧凑行展示代表图、名称与可用详情动作，两种模式均由实例配置决定，顾客不在 C端切换模式。顾客可打开共有部详情、查看大图并进入有效体验入口；C端不提供筛选或“清除条件”操作。移动端卡片模式单列、列表模式为纵向行，建筑分组按配置顺序连续展示，详情为底部面板；采用 VISTA C 卡片与媒体查看器。

## 6. 用户用例与验收

**UC-01**：顾客按建筑分组浏览公共空间。
**UC-02**：顾客查看某设施详情并进入已关联的 WALK 或 VR 内容。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 卡片仅展示有效已发布设施。 |
| AC-02 | 多建筑项目按建筑分组同时展示有效设施；单建筑项目不显示无意义的分组标题，且 C端不出现筛选控件。 |
| AC-03 | 体验入口只在目标有效时显示。 |
| AC-04 | 媒体失败不隐藏有效文字与其他设施。 |