# 住户表页 PRD

版本：v0.3
状态：待原型与实现验收

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 以住户表和条件性户型卡片建立具体住户比较页。 |
| 2026-08-03 | v0.2 | 内容边界与费用状态补充 | 根据评审明确辅助卡片范围及无公开费用时的展示。 |
| 2026-08-11 | v0.3 | 重大：住户表页面重构 | 删除住户比较、户型卡片和费用入口；改为按建筑切换、筛选当前建筑住户、查看可售住户详情及共有部体验。 |

## 目标与用户用例

顾客在当前建筑内筛选和查看每个具体住户的公开信息；多建筑项目一次只显示一栋建筑，并通过建筑切换查看其他建筑。可售住户可打开详情弹窗；共有部不进入住户详情，而是在关联体验有效时进入 WALK 或 VR。

用户用例：选择建筑 → 筛选当前建筑住户 → 查看可售住户详情，或进入共有部体验。

## 页面内容与交互

主承载住户表，使用建筑切换、筛选和住户详情弹窗。

- 每次只显示当前一栋建筑的住户和共有部；切换建筑后，筛选项、结果数和列表内容同步刷新。
- 住户表展示房号、建筑、楼层/位置、户型名称、LDK/格局、面积和可售/不可售状态。
- 可售住户可打开详情弹窗查看其已发布的详情；不可售住户仅显示状态，不提供详情入口。
- 共有部与住户分开表达，不进入住户详情；只在关联 WALK 或 VR 已发布且可访问时显示体验入口。
- 页面不提供住户比较、户型卡片、费用入口或跨建筑同时展示。

无当前建筑的有效内容时显示明确空状态。单个住户详情或体验内容失效时局部处理，不替换为其他住户、共有部或整页错误。

## 验收

| AC | 验收条件 |
| --- | --- |
| AC-RES-01 | 多建筑项目一次只显示一栋建筑，切换后只展示目标建筑的住户和共有部。 |
| AC-RES-02 | 筛选只作用于当前建筑；切换建筑后筛选项、结果数和内容同步更新。 |
| AC-RES-03 | 可售住户可打开已发布详情弹窗；不可售住户不出现详情入口。 |
| AC-RES-04 | 共有部不进入住户详情，仅在有效关联存在时显示 WALK 或 VR 体验入口。 |
| AC-RES-05 | 顾客侧不出现住户比较、户型卡片、费用入口或跨建筑同时展示。 |
| AC-RES-06 | 在 320px 至 1440px 下可完成建筑切换、筛选、查看住户详情和进入共有部体验，无需横向滚动整页。 |

## 明确不做

- 不做住户比较、多个住户对照、户型卡片、费用展示或费用试算入口。
- 不在页面层重复定义住户详情、筛选条件、体验内容可用性或沉浸承载规则；以住户表 Widget 和相关通用组件 PRD 为准。