# 住户展示 Widget PRD

版本：v0.8

优先级：P0

状态：已进入首批线框原型范围，待原型与实现验收

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-04 | v0.1 | 初始创建 / 重大新增 | 建立以一个指定住户为主对象的销售分享展示能力；费用试算作为独立 Widget 调用。 |
| 2026-08-04 | v0.2 | 状态与返回规则补充 | 补充内容分区加载、失败重试，以及从独立体验和费用试算返回后的状态恢复口径。 |
| 2026-08-04 | v0.3 | 重大：费用展示边界收紧 | 费用试算入口改为仅调用独立计算器；不展示住户价格、费用项目或费用明细。 |
| 2026-08-04 | v0.4 | 重大：无计算数据时保留试算入口 | 当前住户无价格或费用计算数据时，仍进入独立计算器完成纯贷款试算。 |
| 2026-08-04 | v0.5 | 重大：优先级调整 | 将住户展示 Widget 从 P1 调整为 P0，纳入首批浅色线框原型与 Widget 自由组合验证。 |
| 2026-08-04 | v0.6 | 重大：空间体验入口收敛 | WALK / VR 合并为统一空间体验 Widget；当前住户只显示一个已配置类型的 iframe 体验入口，1208 默认为 WALK。 |
| 2026-08-06 | v0.7 | 重大：恢复 WALK / VR Widget 边界 | WALK、VR 分别作为可关联 Widget；当前住户最多关联其中一个，1208 只关联 WALK。 |
| 2026-08-11 | v0.8 | 重大：WALK / VR 内容组件化 | WALK、VR 改为住户直接关联的内容类型；由沉浸内容承载与控制组件启动，不再配置为独立 Widget。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 住户展示 |
| 唯一标识 | `unit-showcase` |
| 分类 | 住户产品 |
| 一句话介绍 | 让顾客连续了解一个指定住户的户型、楼层位置、外景及可用样板间体验。 |
| 封面图 | 该住户关联户型图或经确认可代表该住户的空间图；不是页面目录封面。 |
| 设计图 | 住户信息、楼层定位、外景、样板间和体验入口的页面内展示示意。 |

## 2. 目标与边界

用于销售人员将一个具体住户对应的已发布页面分享给顾客后，顾客无需进入户型浏览或住户表页，即可完成一次针对该住户的理解与体验。

本 Widget 的主对象始终是 **一个具体住户**。户型、楼层、外景、样板间和空间体验均只能作为该住户的关联内容展示；不得切换、筛选、比较或跳转至其他住户。它不替代“户型卡片”或“住户表”：前者仅展示户型摘要，后者用于按建筑切换和筛选多个住户，并进入可售住户详情或共有部体验。

费用计算不在本 Widget 内计算。独立计算器可用时，显示进入“购置费用与贷款试算”页面的入口，并将当前住户作为试算对象带入；当前住户有可用计算数据时供计算器使用，无可用数据时仍进入纯贷款试算。本 Widget 不展示住户价格、费用项目、费用明细或计算结果。

## 3. 内容与关联规则

| 内容区 | 展示条件 | 规则 |
| --- | --- | --- |
| 住户识别与户型信息 | 必需 | 当前住户具有顾客可读名称/房号，且已关联一个有效、可公开的户型；展示户型图、名称、面积、LDK/格局及已公开摘要。 |
| 楼层与位置 | 条件可选 | 当前住户已关联有效楼层平面及可识别位置时，展示所在楼层、平面图和唯一位置标记；不展示其他住户的状态、价格或入口。 |
| 外景信息 | 条件可选 | 外景素材必须与当前住户直接关联，或同时精确匹配其楼层和朝向；不得以相邻楼层、相近朝向或其他住户素材替代。 |
| 样板间与 WALK / VR 体验 | 条件可选 | 仅展示与当前住户直接关联的样板间及最多一个有效 WALK 或 VR 内容。若只与其户型关联而非直接关联，允许展示但必须标为“参考样板间”。1208 首批只关联 WALK。 |
| 费用试算入口 | 条件可选 | 独立计算器可用时显示；当前住户有可用计算数据则带入计算，无数据则进入纯贷款试算；不在本 Widget 中展示价格、费用项目、计算表单或结果。 |

住户、户型或其关联关系失效时，Widget 不启用，页面主区域显示“该住户资料暂未发布”。各条件内容区单独加载；加载中显示当前内容区的骨架或加载提示，不展示旧住户或历史金额。内容区临时请求失败时显示局部不可用提示和重试动作，其他有效内容继续展示；确认无关联内容时隐藏该区。所有内容使用当前页面已发布语言；不得跨语言、跨项目或跨住户补位。

## 4. 使用与配置

| 配置项 | 规则 |
| --- | --- |
| 指定住户 | 必选且只能选择一个当前项目已发布、允许公开的住户。保存后本 Widget 不提供顾客侧切换。 |
| 展示区顺序 | 固定为住户与户型 → 楼层位置 → 外景 → 样板间与体验 → 费用试算入口；不可用区块跳过。 |
| 楼层位置 | 可开启；没有有效平面或位置标记时自动隐藏。 |
| 外景 | 可开启；仅使用满足精确关联条件的素材。 |
| 样板间与体验 | 可开启；最多关联一个 WALK 或 VR 内容，按直接关联优先、参考样板间其次选择体验对象。1208 首批只关联 WALK。 |
| 费用试算入口 | 默认开启；仅在独立计算器不可用时自动隐藏。 |

本 Widget 由页面实例配置一个指定住户，B端分享的是该已发布页面实例，不是住户资源或 Widget 本身。顾客通过受限页面认证后，C端仍只按当前页面实例授权；认证成功不等于可以读取其他住户内容。

## 5. C端 UI 与交互

功能与状态参考 **VISTA C** 的系统顶栏、住户卡片、楼层选择器、图片栏、详情面板和沉浸内容承载与控制组件；首批原型仅以白底或浅色底的中性线框表达，不制作液态玻璃、品牌配色或正式视觉。内容优先，控件不覆盖户型图、外景或沉浸场景。户型图和外景打开通用媒体查看器；关联的 WALK、VR 内容在独立沉浸层复用同一组件启动 iframe，退出或失败后回到本 Widget 的原区块，不提供类型切换。费用试算在独立页面打开，返回时恢复本页滚动位置、当前内容区及已选外景素材等安全局部状态；首批原型不制作 P2 费用试算页面，因此仅在后续计算器可用的配置中显示该入口。已退出的体验不恢复 iframe 内移动位置或临时相机状态，下次启动从该体验的配置默认状态进入。

移动端按内容区纵向阅读，楼层平面和外景优先保证可放大查看；PAD/PC 可并列摘要与媒体，但不改变内容区顺序或允许顾客侧切换住户。精确布局、定位标记样式、区块转场和沉浸入口视觉为 **待设计系统补充**。

## 6. 用户用例与验收

**UC-01｜了解指定住户**：顾客从分享页面进入，阅读该住户的户型资料，查看其所在楼层和位置，并浏览匹配外景。

**UC-02｜体验关联样板间**：顾客打开直接关联或明确标注为参考的样板间，并启动当前住户关联的 WALK 或 VR 内容；退出后回到原住户页面。

**UC-03｜进入费用试算**：顾客进入独立试算页；有当前住户计算数据时将其带入，无数据时自行输入本金完成纯贷款试算；不查看价格或费用明细。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 页面模块只配置一个住户；顾客侧不存在住户切换、筛选、比较或其他住户跳转。 |
| AC-02 | 户型、楼层位置、外景、样板间和体验内容均可追溯至当前住户的有效关联；不使用其他住户、相邻楼层或跨项目内容补位。 |
| AC-03 | 无有效楼层位置、外景、样板间或体验时，仅对应区块隐藏或局部降级，其他资料继续可用。 |
| AC-04 | 户型图、外景可在媒体查看器中打开并关闭；关闭后恢复原阅读位置。 |
| AC-05 | 参考样板间与直接关联样板间在文案上明确区分；没有有效 WALK 或 VR 内容时不显示虚假启动入口。 |
| AC-06 | 独立计算器可用时显示费用试算入口；进入后只带入当前住户，有计算数据则用于计算、无数据则保留纯贷款试算，并可返回原页；本 Widget 不展示价格或费用明细。 |
| AC-07 | 受限页面未完成认证或未获当前页面授权时，不预先展示住户名称、户型图、价格、外景或样板间摘要。 |
| AC-08 | 任一条件内容区加载中、暂时失败或确认无关联内容时，分别显示局部加载、可重试提示或隐藏该区；不展示旧住户、历史价格或其他住户内容。 |
| AC-09 | 顾客退出空间体验 iframe 或从费用试算页返回时，回到原住户页的调用区块；恢复安全阅读状态，不恢复已退出 iframe 的相机或移动状态。 |
| AC-10 | 在 320px 至 1440px 的目标页面宽度内，当前住户最多显示一个 WALK 或 VR 内容入口；1208 首批只显示 WALK，不出现 VR 入口、类型切换或横向溢出。 |

## 7. 明确不做与待确认

- 不做多住户住户表、筛选、排序、比较、收藏、跨住户推荐或顾客侧切换。
- 不在本 Widget 内实现费用计算、贷款输入、预约、价格编辑、销售状态编辑、B端分享操作或顾客授权。
- 不将同户型样板间自动视为当前住户直接对应的样板间。
- 住户位置标记的精确视觉和“直接关联”的运营录入方式为待设计系统/产品运营补充；不影响本期的关联判断原则。