# 住户展示页 PRD

版本：v0.9

优先级：P0

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-04 | v0.1 | 初始创建 / 重大新增 | 新增以指定住户为主对象、可由B端向指定顾客分享的 C端独立页面。 |
| 2026-08-04 | v0.2 | 状态与返回规则补充 | 补充主内容加载状态及从独立费用试算页返回后的页面状态恢复。 |
| 2026-08-04 | v0.3 | 重大：收紧导航与费用展示边界 | 删除页面导航；费用试算只提供计算功能，不在住户页或计算页展示价格、费用明细。 |
| 2026-08-04 | v0.4 | 重大：无计算数据时保留试算入口 | 指定住户没有价格或费用计算数据时，仍可进入独立计算器完成纯贷款试算。 |
| 2026-08-04 | v0.5 | 重大：优先级与原型范围调整 | 将住户展示页纳入 P0 和首批浅色线框原型；首批不制作 P2 费用试算页面，计算器不可用时按既有条件隐藏入口。 |
| 2026-08-04 | v0.6 | 重大：1208 空间体验入口收敛 | WALK / VR 统一由空间体验 Widget 的单个 iframe 实例承载；1208 只配置一个入口，首批默认为 WALK。 |
| 2026-08-06 | v0.7 | 重大：恢复 WALK / VR Widget 边界 | WALK、VR 分别作为可关联的业务 Widget；1208 仍只配置一个 WALK Widget，并复用统一 iframe 承载组件。 |
| 2026-08-11 | v0.8 | 重大：WALK / VR 内容组件化 | WALK、VR 改为住户关联内容类型，由沉浸内容承载与控制组件启动。 |
| 2026-08-11 | v0.9 | 命名同步 | 将“住户比较页”统一改称“住户表页”，不改变本页仅展示一个指定住户的边界。 |

## 1. 目标与用户用例

销售人员在 B端选择已发布的住户展示页面实例并分享给指定顾客。顾客从独立链接进入，完成页面授权后，连续了解一个具体住户及其已公开关联内容，并可进入样板间体验或费用试算。

用户用例：打开分享链接 → 完成认证及当前页面授权 → 阅读指定住户资料 → 查看关联图纸、外景或一个已配置类型的样板间体验 → 进入独立费用试算或结束浏览。

## 2. 页面内容与边界

| 层级 | 承载内容 | 页面规则 |
| --- | --- | --- |
| 页面框架 | 项目识别、状态反馈 | 仅在当前页面访问许可后显示；本页不挂载页面导航。 |
| 主内容 | 住户展示 Widget | 当前页面实例配置一个指定住户；Widget 负责该住户关联内容、局部加载和局部降级。 |
| 页尾 | 项目联系组件、退出登录 | 位于主要内容之后；受限会话可按通用权限规则退出。 |

- 本页只承载一个住户展示 Widget，不再挂载住户表、户型列表、样板间列表或费用计算器等重复业务 Widget。
- 费用试算是从 Widget 启动的独立页面；只提供计算功能，不在本页或费用试算页展示住户价格、费用项目或费用明细；退出或返回时回到本页。
- 页面实例是唯一可分享对象。B端可将该实例分享给指定顾客，但不分享住户、户型图、外景、空间体验或费用资料本身。
- 当前住户可关联一个 WALK 或 VR 内容。页面不提供类型切换；进入后由共用的沉浸内容承载与控制组件展示 iframe。1208 首批只关联一个 WALK 内容，并只显示一个启动入口。
- 本页不是住户表页，不挂载页面导航，也不提供其他住户的入口、推荐或信息泄露。

## 3. 核心流程、状态与响应式

1. 顾客打开住户展示页独立链接。
2. 页面按《C端权限与访问控制规则》判断页面存在与发布状态；公开页直接进入，受限页完成顾客认证并取得当前页面实例的明确授权。
3. 访问通过后挂载住户展示 Widget；Widget 展示当前指定住户的有效关联内容。
4. 顾客可打开媒体、进入当前住户关联的 WALK 或 VR 内容，或进入费用试算；关闭、退出或返回后回到原住户页面的安全上下文。

| 状态 | 页面处理 |
| --- | --- |
| 未登录的受限访问 | 调用顾客登录组件，不展示任何住户摘要或媒体。 |
| 已登录但无权 | 进入统一 403，不展示住户、价格、媒体或关联内容。 |
| 页面不存在、未发布或已下线 | 进入统一 404，不展示旧发布内容。 |
| 主内容加载中 | 保留页面框架的安全加载状态，不展示旧住户、历史价格或其他住户内容。 |
| 指定住户或必需户型失效 | 主区域显示“该住户资料暂未发布”；不转为其他住户或户型。 |
| 条件内容局部失效 | 由住户展示 Widget 隐藏对应区块或局部降级，不影响其余有效内容。 |

功能与状态参考 **VISTA C**：以住户资料和媒体为内容主体，使用系统顶栏、住户卡片、图片栏与沉浸内容承载和控制。关联的 WALK、VR 内容通过共用组件打开 iframe。首批原型仅以白底或浅色底的中性线框表达，不制作液态玻璃、品牌配色或正式视觉。移动端保证纵向阅读、媒体放大和退出动作，PAD/PC 仅调整信息与媒体的并列关系。住户位置标记、正式区块布局和动效为 **待设计系统补充**。

## 4. 验收

| 验收编号 | 验收条件 |
| --- | --- |
| AC-UNIT-PAGE-01 | 顾客可通过已发布住户展示页的独立链接直接进入，无需先访问项目概览或住户表页。 |
| AC-UNIT-PAGE-02 | 受限页只有在认证且 B端明确允许当前页面实例时展示内容；认证或同项目其他页面授权均不替代当前页授权。 |
| AC-UNIT-PAGE-03 | 页面通过授权后，只展示页面实例配置的一个住户及其有效关联内容。 |
| AC-UNIT-PAGE-04 | 费用试算在独立页面完成，返回后恢复原住户页面上下文；本页不出现计算表单或结果。 |
| AC-UNIT-PAGE-05 | 指定住户失效时不展示其他住户替代内容；局部素材失效不升级为 403 或 404。 |
| AC-UNIT-PAGE-06 | 在 320px 至 1440px 下，顾客能阅读住户信息、查看媒体、启动和退出可用体验，并回到本页。 |
| AC-UNIT-PAGE-07 | 从独立费用试算页返回时，恢复住户展示页原阅读位置与安全局部状态；当前住户计算数据在期间失效时，费用试算仍保留纯贷款试算，不展示历史计算数据或失效结果。 |
| AC-UNIT-PAGE-08 | 顾客访问住户展示页时，页面不显示页面导航入口、其他住户入口、住户价格或费用明细。 |
| AC-UNIT-PAGE-09 | 1208 只显示一个 WALK 内容入口；进入后使用共用 iframe 组件承载，页面中不存在 VR 入口或类型切换。 |

## 5. 明确不做

- 不做住户表、其他住户浏览、顾客侧住户切换、页面导航、价格或费用展示、价格编辑、分享操作或页面内费用计算。
- 不将页面模板、住户资源或 Widget 本身作为可分享链接。
- 不在页面层重复定义住户关联、媒体失败、样板间可达性或费用计算规则；以住户展示 Widget 和费用试算 Widget PRD 为准。