# 户型浏览页 PRD

版本：v0.2  
状态：当前正式需求

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 以户型卡片列表为主承载建立户型发现页。 |
| 2026-08-03 | v0.2 | 合并旧 PRD / 重大范围确认 | 合并旧户型列表页的独立访问、页面装配、状态、响应式与验收；保留条件性样板间入口规则。 |

## 1. 目标与用户用例

顾客独立进入后按面积、LDK、类型等已提供条件浏览和筛选户型，查看户型图大图；仅当该户型已关联且可访问样板间时，继续进入对应体验。用户用例：筛选 → 查看图纸 → 返回筛选或进入已关联样板间。

## 2. 页面内容与边界

| 层级 | 承载内容 | 页面规则 |
| --- | --- | --- |
| 页面框架 | 项目识别、页面导航、状态反馈 | 仅在访问许可后显示；导航不改变筛选结果。 |
| 主内容 | 户型卡片列表 Widget | 承担筛选、列表/卡片展示、户型条件与样板间关联判断。 |
| 查看层 | 媒体查看器 | 打开单张户型图，缩放、平移、恢复适配、关闭后回到调用位置。 |
| 页尾 | 项目联系组件 | 位于主要内容之后。 |

- 本页不再将户型图片查看、筛选条件或样板间可达性复制定义到页面层；以 Widget 与媒体查看器 PRD 为准。
- 样板间入口不是所有户型的必有内容；只在该户型已装配、已发布且当前顾客可访问的样板间时显示。
- 不做单户型详情页、户型比较、下载/分享图纸或页面内预约。

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

1. 完成全页面通用访问判断后，读取本页可公开的户型集合和筛选条件。
2. 顾客更新条件、查看结果摘要、打开某户型图或清除条件继续浏览。
3. 无结果时保留当前条件与清除动作；单张图或查看器失败仅局部提示并允许关闭。
4. 关闭查看器或导航后恢复筛选、展示模式、当前卡片与滚动位置。

| 状态 | 页面处理 |
| --- | --- |
| 无结果 / 运行时空数据 | 保留筛选上下文并提供回到默认结果的动作；不升级为整页错误。 |
| 媒体查看中 | 由媒体查看器在当前页面上方承载；背景列表不可误操作，关闭后返回调用上下文，不形成单户型详情页。 |
| 单图 / 查看器失败 | 局部失败，可关闭，列表继续可用。 |
| 列表主数据不可用 | 主区域显示页面级不可用说明；访问控制仍遵循统一 403/404。 |

采用 **VISTA C 卡片页面、住户卡片、筛选弹窗和图片栏**：移动端优先保障筛选、卡片和大图操作，PAD/PC 仅扩展卡片并列与留白。精确筛选抽屉与媒体控件规格为 **待设计系统补充**。

## 4. 验收

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-FP-01 | 本页已发布且有可用户型 | 顾客通过本页链接进入 | 无需进入其他页面即可筛选与查看户型。 |
| AC-FP-02 | 顾客更新筛选 | 结果刷新 | 结果与条件一致；无结果保留条件并可清除。 |
| AC-FP-03 | 户型图有效 | 顾客打开、缩放、平移并关闭 | 图纸可读，关闭后恢复原筛选、卡片和滚动上下文。 |
| AC-FP-04 | 某户型关联可访问样板间 / 未关联或不可访问 | 顾客查看卡片 | 前者显示对应入口；后者不显示虚假或禁用入口。 |
| AC-FP-05 | 单图或媒体查看失败 | 顾客继续浏览 | 仅局部提示，列表与页面其他内容继续可用。 |
| AC-FP-06 | 媒体加载中、无效或不支持 | 顾客打开户型图 | 查看层保持可关闭，不形成独立详情页或整页错误。 |

## 5. 明确不做

- 不做单户型详情、比较、下载/分享/编辑图纸、固定样板间入口或页面内预约。
- 不在页面层重新定义 Widget 的筛选字段、卡片字段与样板间装配规则。