# HOMEVISTA C端 多户型与户型选择页 PRD

**版本：** v0.2

## 修订记录

| 版本 | 日期 | 变更类型 | 变更摘要 | 修改人 / 来源 |
| --- | --- | --- | --- | --- |
| v0.1 | 2026-07-28 | 历史版本基线补记 | 将既有页面内容纳入修订记录；原始创建日期未追溯。 | 文档治理 |
| v0.2 | 2026-07-28 | 固定组件补充 | 明确项目联系页脚作为页面底部通用组件；它不作为户型列表可装配的 Widget，也不随所选户型变化。 | 产品确认 / Codex |

## 1. 文档目的与范围

协助顾客从多个可公开户型筛出候选，并进入单户型详情或比较。重点是户型资料和图纸，不把项目介绍、实时价格筛选、个性化算法、收藏账户或住户销售管理做进本页。

## 2. 使用场景与用例

顾客进入→使用面积、格局、朝向等已配置且可解释条件→查看户型卡片/图纸→打开详情，或选择多个候选比较→返回后保留条件。

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

| 角色 | 模块 | 数据引用 | 规则 |
|---|---|---|---|
| 主承载 | M-10 户型卡片列表、M-12 户型及住户卡片 | 户型名、图纸、面积、格局、朝向、标签、可公开状态 | 至少一个可公开且图纸完整的户型才发布 |
| 辅助 | M-11 样板间、M-13 住户表、M-19 眺望集 | 关联样板间、住户位置、眺望 | 卡片只用真实关联的可用入口 |
| 系统 | 对象对比、身份验证、导航与返回 | 可比字段、字段权限、来源/状态 | 比较/受限字段分别判权 |
| 固定组件 | 项目联系页脚（`06`） | 项目公共联系信息 | 位于页面底部，不随筛选条件或所选户型变化 |

## 4. 功能需求

| ID | 功能 | 规则 |
|---|---|---|
| F01 | 户型集合 | 只列可公开户型；多楼栋项目可以楼栋为分组，不以旧系统菜单排序。 |
| F02 | 筛选与排序 | 仅使用面积、格局、朝向、标签等项目配置且顾客可理解维度；重置回默认集合。 |
| F03 | 卡片与图纸 | 卡片突出户型图、面积、格局、朝向与主要标签；图纸可预览/放大。 |
| F04 | 比较 | 顾客手动加入最多 3 个候选；比较只展示被授权且配置的共同字段，采用 VISTA C 可拖动分隔组件。 |
| F05 | 关联入口 | 可进入 04-06、关联样板间/眺望；不在列表页展开住户表或费用计算。 |
| F06 | 登录/权限验证 | 页面公开可浏览；受限字段/内容在点击时验证，验证结果返回同一筛选及候选状态。部分不可公开户型不显示灰色占位，也不计入数量。 |
| F07 | 导航与恢复 | 跳转 04-06 后返回，恢复筛选、楼栋分组、滚动与候选；比较候选仅在当前浏览会话保存，不承诺跨设备或长期保存。 |

## 5. 状态与验收

| 状态 | 处理 |
|---|---|
| 无公开户型 | 不可发布 |
| 筛选无结果 | 显示空状态、当前条件及重置动作，不推荐不存在户型 |
| 当前户型失效 | 从列表和候选移除，提示候选已更新 |
| 比较项不足/超限 | 少于 2 项不可进入比较；超限要求替换或取消选择 |

| AC | 验收 |
|---|---|
| AC-01 | 顾客能在不进入详情前用图纸和基础字段初步判断户型。 |
| AC-02 | 筛选只出现已配置可解释条件，返回详情后保持条件与滚动位置。 |
| AC-03 | 对比 2–3 个可用候选，字段权限和异常项处理一致。 |
| AC-04 | 移动端筛选和候选使用抽屉/底栏，不挤压图纸主体。 |
| AC-05 | 楼栋内部分户型不可公开时，列表只呈现可公开集合且不形成空白占位。 |

## 6. 待确认问题

1. 初始排序是否按项目推荐、面积或其他配置；默认项目配置顺序。
2. 是否允许跨户型携带费用计算输入；首版不携带，避免把不同适用费用混算。

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

不得新增价格实时筛选、推荐算法或客户收藏；比较能力以 `05/06` 为通用来源。