# 样板间列表 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义样板间对象浏览及其体验/素材入口。 |
| 2026-08-03 | v0.2 | 数据条件统一 | 根据 DeepSeek PM 评审明确关联入口的可达条件，并统一基础资料的展示门槛。 |
| 2026-08-04 | v0.3 | 重大：空间体验关联规则调整 | 样板间入口统一关联空间体验 Widget 实例，WALK / VR 类型由实例决定。 |
| 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 | 内容字段收敛 | 删除未经确认的摘要、位置、设计主题、关联户型、图集与筛选；仅保留名称、代表图和有效 WALK/VR 入口。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 样板间列表 |
| 唯一标识 | `model-room-list` |
| 分类 | 住户产品 |
| 一句话介绍 | 让顾客浏览样板间，并进入可用体验入口。 |
| 封面图 | 样板间空间类型图。 |
| 设计图 | 样板间卡片与详情面板设计示意。 |

## 2. 目标与场景

面向需要从项目内容继续了解样板空间的顾客。顾客浏览样板间并进入有效 WALK / VR 体验，完成体验对象选择。

## 3. 内容与数据

样板间名称、代表图为必需；WALK 内容入口、VR 内容入口为可选。“可达”指关联内容已发布、iframe 有效、当前顾客可访问且具有明确进入动作；任一条件不满足即不显示该入口。入口明确显示 WALK 或 VR，不提供类型切换。至少一项同时具备名称、代表图的有效样板间才启用。

## 4. 使用与配置

配置样板间集合和排序。C端不提供筛选条件。无有效项目显示空状态；无有效体验入口的样板间只要仍具备名称、代表图，即可展示其基础资料。

## 5. C端 UI 与交互

默认显示样板间卡片列表；点击卡片打开详情，顾客可查看大图并进入可达体验。C端不提供筛选或“清除条件”操作。移动端使用单列卡片和底部详情面板，遵循 VISTA C 卡片、图片查看器与入口动作规则。

## 6. 用户用例与验收

**UC-01**：顾客浏览样板间并查看大图。
**UC-02**：顾客由样板间进入已关联的 WALK 或 VR 内容。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 只显示具备名称、图片的已发布样板间。 |
| AC-02 | 体验入口仅在关联有效时显示。 |
| AC-03 | 缺少体验内容不阻断样板间基础浏览。 |