# HOMEVISTA C端 单户型展示页 PRD

**版本：** v0.2

## 修订记录

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

## 1. 文档目的与范围

围绕一个户型组织“户型图—样板间—可选住户—位置/眺望—费用理解—预约”的购买判断链路。它不是项目宣传页，也不是单一图片画廊；不做实时库存、价格承诺、税费/合同计算、自动推荐或 C 端编辑户型。

## 2. 使用场景与用例

顾客由多户型页、推荐住户或分享链接进入→看户型图和面积/朝向→查看样板间→筛选可公开关联住户，理解住户位置和眺望→按权限查看费用并试算→预约或加入比较。

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

| 角色 | 模块 | 数据引用 | 页面级规则 |
|---|---|---|---|
| 主承载 | M-12 户型及住户卡片 | 户型名称、户型图、面积、格局、朝向、卖点、免责声明 | 户型图和识别信息缺失不可发布 |
| 辅助 | M-11 样板间列表、M-08/09 WALK/VR | 关联样板间、媒体、说明 | 无样板间时隐藏整个体验段 |
| 辅助 | M-13 住户表、M-19 眺望集、M-06 楼层信息 | 住户房号/楼栋/楼层、关联眺望、楼层图 | 只呈现可公开且真实关联的住户 |
| 辅助 | M-17 费用计算器 | 价格与费用、适用对象、说明 | 可见性、数据完整性或同意说明不足时隐藏 |
| 转化 | M-26、对象对比组件 | 预约与可比较字段 | 比较调用通用组件，不新增比较页 |
| 固定组件 | 项目联系页脚（`06`） | 项目公共联系信息 | 位于页面底部，不作为户型对象的关联入口 |
| 系统 | 身份验证、导航与返回 | 字段/住户/费用权限、来源 | 每页和每个受限入口均消费 `06` |

## 4. 功能需求

| ID | 功能 | 强约束 |
|---|---|---|
| F01 | 户型主体与图纸 | 主图可全屏放大；面积口径、朝向和卖点必须有必要说明，禁止把图片资料改为普通宣传媒体。 |
| F02 | 样板间 | 按关联呈现卡片，可进入 WALK/VR；体验缺失不影响户型主任务。 |
| F03 | 关联住户与位置 | 使用住户表+楼层关系展示“在哪一栋/层/房号”，不得用户型推断真实库存。 |
| F04 | 眺望 | 只链接关联且可访问的眺望，展示其楼层/方向说明，不承诺实际交付视野。 |
| F05 | 费用与贷款试算 | M-17 汇总已配置价格、一次/月度费用和可选费；贷款计算器仅做可配置的参考估算，须显示免责声明，不计算税费、资格、合同或审批结果。 |
| F06 | 比较与预约 | 可将当前户型加入候选；预约调用 M-26。未经验证/同意不得提交个人信息。 |
| F07 | 登录/权限验证 | 受限字段、住户、费用、资料或预约依策略触发验证；失败后保留公开户型信息与返回路径。 |
| F08 | 状态恢复与局部失败 | 从样板间、眺望、费用验证或预约返回时恢复当前户型、滚动和比较候选；关联媒体加载失败可重试，所有关联内容无可用项时移除该区块及入口。 |

## 5. 交互与状态规则

主信息与户型图优先，次序为图纸→样板间→关联住户/位置→眺望→费用→行动。PC 住户表/费用可用侧栏或抽屉，移动端为连续内容和底部抽屉；全屏图纸退出后恢复滚动与候选状态。

| 状态 | 处理 |
|---|---|
| 户型主体不可公开/缺图 | 不可访问或不可发布 |
| 无关联住户/样板间/眺望 | 隐藏对应段，不能用模拟数据填充 |
| 费用数据或说明不完整 | 隐藏计算器和费用 CTA，不阻断主体浏览 |
| 比较候选达到上限 | 说明上限并进入比较或替换选择，不自动删除已选项 |

## 6. 验收标准

| AC | 验收 |
|---|---|
| AC-01 | 顾客能识别单一户型并放大查看户型图。 |
| AC-02 | 有关联住户时能看清真实位置与可用眺望入口；无关联时不显示假入口。 |
| AC-03 | 费用/贷款只在权限、资产与说明完整时展示，并明确为参考。 |
| AC-04 | 验证后回到触发的受限内容，失败和取消不丢公开浏览状态。 |
| AC-05 | 关联体验或眺望全不可用时，页面不保留空面板或无效导航入口。 |

## 7. 待确认问题

1. 贷款估算的输入项、利率来源与免责声明统一口径；未确认前原型使用参考提示，不输出计算结论。
2. 户型可比较上限与跨页面候选保存时长；默认最多 3 个。

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

使用 VISTA C 的画廊/卡片、住户卡片、筛选弹窗、比较组件；不得将价格、销售状态或贷款试算理解为实时交易能力。