# HOMEVISTA C端 推荐住户展示页 PRD

**版本：** v0.2

## 修订记录

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

## 1. 文档目的与范围

用一套或多套公开推荐住户，组织“具体位置—户型—样板间—眺望—费用理解—预约/比较”的决策链路。它展示顾客可理解的推荐理由，不暴露内部库存、销售分配、成交状态、优惠或 C 端自改推荐结果。

## 2. 使用场景与用例

顾客从销售分享、渠道页或户型页进入→阅读推荐理由→查看住户所在楼栋/楼层/房号与户型图→体验关联样板间、眺望→按权限查看费用/贷款参考→比较候选或预约。

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

| 角色 | 模块 | 数据引用 | 规则 |
|---|---|---|---|
| 主承载 | M-13 住户表、M-12 户型及住户卡片 | 房号、楼栋、楼层、公开说明、关联户型/图纸、推荐理由 | 至少一套可公开推荐住户及其关联户型可用才发布 |
| 辅助 | M-06 楼层信息、M-11/M-08/M-09 样板间体验、M-19 眺望集 | 楼层图、样板间、眺望、说明 | 住户位置和眺望均只引用真实关联 |
| 辅助 | M-17 费用计算器 | 住户价格/费用、可选费用、说明 | 不完整/受限时隐藏而非猜测 |
| 转化 | 对象对比、M-26 | 比较字段、预约说明 | 多住户支持对比；预约需验证与同意 |
| 固定组件 | 项目联系页脚（`06`） | 项目公共联系信息 | 位于页面底部，不随推荐住户变化 |
| 系统 | 身份验证、导航与返回 | 指定客户/字段/来源策略 | 必须先判定访问和字段可见性 |

## 4. 功能需求

| ID | 功能 | 强约束 |
|---|---|---|
| F01 | 推荐住户列表 | 明确“おすすめ住戸”及推荐理由；单套可做焦点详情，多套以候选列表组织。 |
| F02 | 住户定位 | 展示楼栋、楼层、房号及楼层图位置；绝不由户型反推出真实房号。 |
| F03 | 户型与样板间 | 显示关联户型图及可用样板间/WALK/VR，缺失时局部隐藏。 |
| F04 | 眺望 | 显示关联素材的楼层、方向、必要说明；不把示意素材当承诺。 |
| F05 | 费用/贷款 | 使用 M-17 的价格与费用和参考试算；若权限或说明未满足则整体隐藏。 |
| F06 | 多住户对比 | 2–3 套手动比较，以位置、户型、面积、朝向、可见费用等共同字段呈现；不可比字段显示未公开而非补值。 |
| F07 | 登录/权限验证与预约 | 指定客户页、价格/费用、预约按策略验证；未同意隐私不能提交。 |
| F08 | 返回与状态恢复 | 从户型、眺望、费用验证或预约返回时恢复推荐住户、滚动和比较候选；候选仅在当前浏览会话有效。 |

## 5. 状态与验收

| 状态 | 处理 |
|---|---|
| 无有效推荐住户/关联户型 | 不可发布 |
| 单套住户失效 | 从列表与比较候选移除，保留其余可用项 |
| 无可比较住户 | 隐藏比较 CTA，保留预约/联系 |
| 验证失败/过期 | 保留公开推荐说明，不显示受限字段，并提供重试/返回 |

| AC | 验收 |
|---|---|
| AC-01 | 每套推荐住户可识别其位置、关联户型与推荐理由。 |
| AC-02 | 多套时能比较已配置、已授权共同字段，且移动端切换为上下比较。 |
| AC-03 | 眺望、样板间、费用缺失不产生无效入口或伪造数值。 |
| AC-04 | 从任一关联页返回，保留住户选择和比较候选。 |
| AC-05 | 所有关联样板间或眺望素材均不可用时，对应区块和入口整体移除，不显示空白面板。 |

## 6. 待确认问题

1. 单页推荐住户数量与排序来源；默认最多 3 套、按项目配置顺序。
2. 指定客户的推荐组合是否需要与身份绑定；该结论决定进入页前还是点击受限字段时验证。

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

不得把推荐住户页改造成内部库存表、报价单或销售任务工具；对比为本页调用的通用能力，不新建比较模板。