# HOMEVISTA C端 眺望集页 PRD

**版本：** v0.2

## 修订记录

| 版本 | 日期 | 变更类型 | 变更摘要 | 修改人 / 来源 |
| --- | --- | --- | --- | --- |
| v0.1 | 2026-07-28 | 历史版本基线补记 | 将既有页面内容纳入修订记录；原始创建日期未追溯。 | 文档治理 |
| v0.2 | 2026-07-28 | **重大模块边界调整** | `M-02 项目联系方式`改为固定项目联系页脚通用组件，不再作为眺望页可装配的转化 Widget。 | 产品确认 / Codex |

## 1. 文档目的与范围

独立呈现不同楼层、方向和拍摄位置的眺望差异，帮助顾客理解与住户的空间关系。参考既有 VISTA 的楼层选择、雷达方向与底部媒体栏：视觉为主体，控制项不得覆盖全景。首版不做自动生成眺望、实时影像、天气、景观交付保证。

## 2. 使用场景与用例

顾客从住户/户型/分享链接进入→选择楼栋（如有）和楼层→选择方向或素材→查看全屏图片/全景与拍摄说明→打开关联住户或预约。缺少关联住户不阻止眺望浏览。

## 3. 模块组合与数据引用

| 角色 | 模块 | 数据引用 | 页面级规则 |
|---|---|---|---|
| 主承载 | M-19 眺望集 | 眺望素材、楼栋、楼层、朝向、拍摄位置、遮挡说明、免责声明 | 没有至少一条可公开素材则不可发布 |
| 辅助 | M-06 楼层信息、M-13 住户表 | 楼层图、关联住户及位置 | 仅在关联真实存在且可访问时显示 |
| 转化 | M-26 | 预约说明 | 作为浏览后的行动，不浮盖素材 |
| 固定组件 | 项目联系页脚（`06`） | 项目公共联系信息 | 位于素材浏览之后，不浮盖素材 |
| 系统 | 身份验证、导航与返回 | 素材/住户可见性、来源页 | 每个受限素材/对象单独消费权限 |

## 4. 功能需求与状态

| ID | 功能 | 规则 |
|---|---|---|
| F01 | 楼栋/楼层选择 | 有多楼栋时先选择楼栋；选择器只显示存在素材的楼层。 |
| F02 | 方向与媒体浏览 | 雷达/方向控制与缩略图共同定位当前素材；图片可全屏、缩放和平移，退出后恢复选中项。 |
| F03 | 关系说明 | 明确展示素材对应楼层、方向、拍摄位置及必要遮挡/效果说明；不得推断“某户必然拥有此视野”。 |
| F04 | 关联对象 | 可进入关联住户/户型；无关联时不生成空入口。 |
| F05 | 登录/权限验证 | 页面、素材或关联对象受限时均先验证；验证失败不泄露缩略图、方向或对象名称。 |
| F06 | 加载失败与返回 | 单一媒体加载失败显示可重试状态，不影响楼层/方向切换；从关联页、验证层或全屏媒体返回时恢复当前楼栋、楼层、方向和滚动位置。 |

状态：无主素材不可发布；单素材失效从选择器移除；楼层筛选无结果提示“該当する眺望はありません”并提供重置；加载中只显示页面加载，不把媒体加载误报为实际景观缺失。

## 5. 验收标准

| AC | 验收 |
|---|---|
| AC-01 | 能按可用楼层与方向切换，当前素材、雷达和说明一致。 |
| AC-02 | 全屏媒体模式不会丢失当前楼层、方向和返回路径。 |
| AC-03 | 未配置或无权限素材不留在可选项中。 |
| AC-04 | 素材始终携带必要说明，不构成实景或交付保证。 |
| AC-05 | 媒体加载失败时不会被误判为无眺望，顾客可切换其他可用素材或重试。 |

## 6. 待确认问题

1. 多素材同方向时的默认排序；默认按项目配置顺序。
2. 是否允许从眺望直接带入关联住户的比较候选；首版仅跳转，不自动加入比较。

## 7. 供 Codex 使用的执行说明

使用 VISTA C 的图片栏、楼层选择器、雷达图；不得将该页扩展为 VR/WALK 或对景观作销售承诺。