# 楼层信息 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义按楼层浏览平面资料及已配置关联对象的规则。 |
| 2026-08-03 | v0.2 | 内容有效性补充 | 根据 DeepSeek PM 评审补充无任何有效平面图时的整体空状态。 |
| 2026-08-11 | v0.3 | 楼层住户与外景入口补充 | 明确显示当前楼层住户信息，并在有效关联存在时提供外景查看入口。 |
| 2026-08-11 | v0.4 | 多建筑展示规则补充 | 多建筑项目提供建筑切换入口；每次仅展示一栋建筑的楼层、住户及关联内容。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 楼层信息 |
| 唯一标识 | `floor-information` |
| 分类 | 建筑与空间 |
| 一句话介绍 | 让顾客选择楼层并阅读对应平面图、说明及已公开的空间/户型关联。 |
| 封面图 | 楼层平面图类型图。 |
| 设计图 | 楼层选择器与平面查看设计示意。 |

## 2. 目标与场景

面向希望了解特定楼层布局和可达内容的顾客。顾客选择楼层、查看平面和已关联对象，完成对“这一层有什么、可进一步了解什么”的判断。

## 3. 内容与数据

所属建筑、楼层名称/序号和至少一张楼层平面图为必需内容；单建筑项目可不单独显示建筑名称。楼层说明、对象标记、当前楼层住户信息，以及户型、样板间、眺望入口为可选内容。住户信息仅展示当前楼层已发布且允许公开的住户；外景入口仅消费与当前楼层有效关联、已发布且可达的眺望内容。只有至少一栋建筑的一个楼层同时具备有效名称/序号与平面图时才启用；没有任何有效平面图时显示 Widget 级“楼层资料暂未发布”状态，而非显示空选择器。

## 4. 使用与配置

可选择建筑与其楼层集合、设定建筑及楼层展示顺序、默认建筑和默认楼层；默认项失效时取第一个有效建筑及其第一个有效楼层。多建筑项目仅在有两栋及以上有效建筑时显示建筑切换入口；一次只展示当前建筑的楼层集合。可开启对象标记和关联入口；关闭后仍可浏览图纸。无有效楼层显示暂不可用。

## 5. C端 UI 与交互

界面层级为建筑切换 → 楼层选择 → 平面图 → 说明与住户信息 → 关联标记/外景入口。多建筑项目中，顾客先选择建筑，再选择该建筑的楼层；切换建筑后同步替换楼层选择器、图纸、住户和信息，不同时混排多栋建筑内容。选择楼层后同步替换图纸、住户和信息；点击标记或外景入口只进入当前可达目标。图纸失败显示局部占位，其他楼层仍可选；移动端建筑与楼层选择为横向选择器或抽屉，图纸可全屏查看。

## 6. 用户用例与验收

**UC-01**：顾客在多建筑项目中切换建筑和楼层，并查看对应平面。
**UC-02**：顾客查看当前楼层住户，并从有效外景入口进入关联眺望。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 楼层选择、图纸和说明始终对应同一楼层。 |
| AC-02 | 默认楼层不可用时自动落到第一有效楼层。 |
| AC-03 | 失效关联不显示，图纸失败不阻断其他楼层。 |
| AC-04 | 手机端可完成选择、阅读和返回。 |
| AC-05 | 当前楼层仅显示已发布且允许公开的住户；无有效眺望关联时不显示外景入口。 |
| AC-06 | 多建筑项目一次只显示当前建筑的楼层、住户和关联内容；切换建筑后所有对应内容同步更新。 |