# 住户表 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义多住户筛选、比较和关联内容入口。 |
| 2026-08-03 | v0.2 | 显示与比较规则统一 | 根据 DeepSeek PM 评审消除字段缺失与展示门槛的冲突，并明确最多比较数量。 |
| 2026-08-11 | v0.3 | 重大：住户表规则回写 | 改为按单栋建筑展示住户与共有部；支持楼栋切换、住户筛选、可售住户详情弹窗及共有部 WALK/VR 入口，移除比较功能。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 住户表 |
| 唯一标识 | `unit-table` |
| 分类 | 住户产品 |
| 一句话介绍 | 以表格方式展示当前建筑的住户与共有部信息，并提供各自适用的查看入口。 |
| 封面图 | 住户/楼层表类型图。 |
| 设计图 | 列表、筛选、住户详情弹窗和共有部体验入口设计示意。 |

## 2. 目标与场景

面向需要了解具体住户分布与可售状态的顾客。顾客选择一栋建筑、筛选当前建筑住户，查看可售住户详情或进入共有部的 WALK/VR 体验。

## 3. 内容与数据

每个住户必需有房号、所属建筑、楼层/位置、户型代号、LDK/格局、面积和可售/不可售状态。仅纳入已发布且允许公开的住户。共有部作为与住户不同的展示对象，可显示在所属建筑及楼层的相应位置；共有部不显示可售状态或住户详情入口，仅在存在有效关联时显示 WALK/VR 入口。关联内容仅在已发布、顾客可访问且可正常打开时显示。

## 4. 使用与配置

内容自动带入当前项目已发布、允许公开的住户与共有部。可配置默认建筑、楼层展示顺序及启用的筛选维度（户型类型、面积等）；多建筑项目通过楼栋切换选择当前建筑，一次只显示一栋建筑，不同时混排多栋内容。默认建筑失效时取第一栋有效建筑。无有效住户和共有部时显示空状态；不以其他建筑、其他楼层或历史内容补位。

## 5. C端 UI 与交互

默认显示当前建筑的切换入口、筛选、结果数和按楼层/位置组织的住户表。顾客可切换建筑、按已启用条件筛选当前建筑住户；可售住户可点击打开详情弹窗，不可售住户不进入详情。共有部不打开住户详情，在存在有效关联时进入 WALK/VR。切换建筑后同步更新筛选项、住户、共有部和结果数。窄屏转为按楼层/位置组织的住户卡片或紧凑列表，不要求用户横向滚动整页；筛选无结果可清除，局部关联失败不移除有效住户或共有部。

## 6. 用户用例与验收

**UC-01**：顾客切换建筑，并按条件筛选当前建筑的住户。
**UC-02**：顾客打开可售住户的详情弹窗。
**UC-03**：顾客从共有部进入有效 WALK/VR 体验。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 住户只显示当前建筑内已发布、允许公开且具备必需字段的对象；每行准确对应房号、楼层/位置、户型代号、LDK/格局、面积和可售状态。 |
| AC-02 | 多建筑项目一次只显示一栋建筑；切换建筑后住户、共有部、筛选项和结果数同步更新。 |
| AC-03 | 可售住户可打开详情弹窗；不可售住户不显示或触发该入口。 |
| AC-04 | 共有部不进入住户详情；仅在 WALK/VR 有效时显示并打开对应入口。 |
| AC-05 | 筛选仅作用于当前建筑的住户；无结果可清除，不展示其他建筑或历史内容。 |
| AC-06 | 手机端可完成建筑切换、筛选、住户详情查看和共有部体验进入，无需横向滚动整页。 |