# 3D大楼 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义可组合的 3D 建筑查看、楼栋选择及关联入口。 |
| 2026-08-03 | v0.2 | 用例补充 | 根据 DeepSeek PM 评审补齐热点标签可读性及内容不可用/加载失败的用户用例。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 3D大楼 |
| 唯一标识 | `building-3d` |
| 分类 | 建筑与空间 |
| 一句话介绍 | 通过可交互的建筑三维视图，帮助顾客理解楼栋、朝向与已公开的关联空间。 |
| 封面图 | 建筑三维视图类型图。 |
| 设计图 | 3D 画布、选择提示与信息面板设计示意。 |

## 2. 目标与场景

面向需要建立整体空间认知的顾客。顾客旋转、缩放、选择楼栋或已配置热点，获得建筑布局理解并可继续访问关联内容。

## 3. 内容与数据

必需为可公开的 3D 建筑内容和项目名称；可选为楼栋名称、热点、说明、楼层/户型/眺望关联。热点均须有顾客可读标签，关联目标须已发布可达。无可用 3D 内容时 Widget 不启用。

## 4. 使用与配置

可选择一个 3D 内容、启用楼栋选择/热点/默认视角，配置热点顺序与标签。默认视角无效时使用内容初始视角。可关闭关联入口，不关闭 3D 浏览本身。

## 5. C端 UI 与交互

默认展示 3D 画布、帮助提示和可选楼栋/热点面板。顾客可拖拽旋转、缩放、复位视角，点击热点查看说明或进入目标。加载显示画布内进度；内容失败显示不可用并保留文字摘要/替代静态封面（如已配置）。移动端提供触控操作、复位和不遮挡画布的底部面板。

## 6. 用户用例与验收

**UC-01**：顾客旋转和缩放建筑，恢复默认视角。  
**UC-02**：顾客选择可用热点并进入关联内容。
**UC-03**：顾客阅读热点的顾客可读标签，再决定是否进入其关联目标。  
**UC-04**：顾客遇到内容未发布或加载失败，阅读不可用提示并查看替代封面（如有）或离开当前 Widget。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 有效 3D 内容可加载并完成旋转、缩放、复位。 |
| AC-02 | 热点标签与关联目标对应，失效目标不显示热点入口。 |
| AC-03 | 加载或失败状态清晰且不伪造可交互内容。 |
| AC-04 | 移动触控能完成同一核心浏览任务。 |