# HOMEVISTA C端页面模板索引与通用规则

## 修订记录

| 版本 | 日期 | 修改人 | 修改内容 |
|---|---|---|---|
| v0.1 | 2026-07-02 | 唐雷 | 建立页面模板文档大纲 |
| v0.2 | 2026-07-09 | Codex | 调整为页面模板索引与通用规则，页面完整需求拆分到 04-xx 独立页面 PRD |
| v0.3 | 2026-07-10 | Codex | 新增页面返回与状态恢复的通用交互标准 |
| v0.4 | 2026-07-12 | Codex | 收窄为当前阶段营销型页面模板索引，删除暂缓模板和页面 PRD 编写规则 |
| v0.5 | 2026-07-12 | Codex | 确认首批 8 个 P0 页面，统一使用“住户”命名，并按三类营销模板重建 04-xx 页面 PRD 清单 |
| v0.6 | 2026-07-12 | Codex | 合并文档定位、范围与分类原则，新增页面模板与模块组合规则 |
| v0.7 | 2026-07-12 | Codex | 修正组合规则边界，区分转化模块与页面下一步动作，并补充页面输入描述要求 |
| v0.8 | 2026-07-13 | Codex | 新增自有完整应用承载的 3D 大楼独立功能页 |
| v0.9 | 2026-07-15 | Codex | 将系统状态与错误页从本索引拆出，独立为 `05-系统状态与错误页PRD.md`；本文件恢复为营销页面模板与组合规则索引 |

## 一、文档定位、范围与分类原则

### 1.1 文档目的

本文档用于承接 `01-内容资产字典.md` 和 `02-最小功能模块PRD.md`，先定义当前阶段 HOMEVISTA C端需要优先展开的营销型页面模板分类。

本文档不展开单个页面的完整需求，也不定义页面视觉、具体交互细节、组件样式、埋点字段和权限规则。单个页面模板的完整需求进入对应 `04-xx` 页面 PRD。

当前阶段，页面模板索引只回答三个问题：

- 当前优先考虑哪几类营销型页面模板。
- 每类模板服务什么顾客需求和营销场景。
- 每类模板下首批 P0 级需要哪些页面。

### 1.2 当前模板范围

当前页面模板只围绕营销获客、房屋展示和独立功能包装展开，目标是区别于现有 VISTA 的通用演示模板和完整功能导航型页面。

当前范围内的页面模板必须满足：

- 面向顾客或外部访问者，而不是后台配置人员。
- 能被外部渠道、销售人员或项目方作为独立页面传播、分享或承接访问。
- 围绕一个明确营销目标或顾客需求组织内容。
- 能调用既有内容资产和功能模块，但不反向改变模块边界。

当前不纳入本文档的内容：

- 案场演示、桌面 / PAD 销售演示、自动导览、大屏、CAVE、VR 等演示型页面。
- 登录页及后台配置页、运营管理页、数据统计页。
- 页面视觉规范、组件规范、埋点规则和权限规则。

后续进入上述专项时，再单独建立对应 PRD 或规则文档。

### 1.3 模板分类原则

当前模板分类按“营销出发点 + 顾客需求场景”划分，不按旧系统菜单、前端路由、技术模块或页面视觉形态划分。

分类时优先判断：

- 这个页面是为了获客、展示户型与住户，还是包装一个独立功能？
- 顾客打开页面时最核心的问题是什么？
- 页面是否能在没有完整 VISTA 导航的情况下独立成立？
- 页面是否有清晰的下一步动作，例如继续查看、比较、联系或预约？

因此，“轻量组合”不作为当前一级页面模板分类。它更适合作为页面装配方式：渠道投放页可以组合多个模块，房屋展示页可以组合户型、样板间和预约，特定功能页也可以补充联系或资料入口。

## 二、页面模板与模块组合规则

本章只定义所有页面模板共用的模块组合约束。每个 `04-xx` 页面 PRD 只描述该页实际调用的模块、顺序和页面级结果，不重复定义模块本身。

### 2.1 页面与模块的边界

- 页面围绕一个明确顾客任务独立成立；页面可以组合模块，但不把模块改造成页面私有能力。
- 每个页面必须明确主承载模块。若一个任务必须由多个模块共同承载，`04-xx` 必须说明各自主次、调用条件和不可替代关系，不能笼统写“页面内容”。
- 页面可以定义模块调用条件、业务表达顺序、关联入口和页面级下一步动作；模块的对象边界、展示口径、模块级交互、启用条件和空数据规则仍以 `02-最小功能模块PRD.md` 为准。
- 页面不得仅因当前页面需要而新增模块、拆分模块或改变模块命名。确有新能力需求时，先回到 `02` 判断模块边界。

### 2.2 模块角色

| 角色 | 在页面中的作用 | 页面级规则 |
|---|---|---|
| 主承载模块 | 承担页面核心顾客任务与主要内容理解 | 必须明确；不可用时页面默认不得发布，除非对应 `04-xx` 明确了可替代的主承载方案 |
| 辅助模块 | 补充背景、关联对象或理解信息 | 可按页面需要调用；不可用时隐藏或降级，不得阻断主任务 |
| 转化模块 | 提供联系、预约、登记等明确转化动作 | 是否调用由页面任务决定；具体能力和提交规则仍以对应模块规则为准 |
| 系统能力 / 通用组件 | 提供身份认证、导航、比较等跨页面能力 | 仅作为被调用能力；不得因此重新定义一级页面模板或新增页面私有规则 |

### 2.3 组合与状态规则

- 模块是否可在页面中使用，以其在 `02` 中的启用、权限、内容完整性和降级规则为前提；页面 PRD 不重复改写这些通用规则。
- 页面只额外判断“该模块不可用后，本页是否仍可访问、是否仍可发布、向顾客如何表达”。主承载模块、辅助模块和转化模块应分别写明该页面级结果。
- 每个页面必须有可用的下一步动作或明确结束路径。继续浏览、资料查看和返回可由导航、资料等能力提供，不因此被定义为转化模块。
- 比较、预约、导航和身份认证等能力可以被不同页面调用；它们不因被多页使用而成为新的页面模板，也不应在各页面重复定义其底层规则。
- `05-系统状态与错误页PRD.md` 定义整页不可访问或主任务无法完成时的统一状态页；`06-通用组件说明.md` 定义跨模块复用组件，`07-权限与访问控制规则.md` 定义访问控制，`08-埋点与统计规则.md` 定义统计口径；`04-xx` 仅引用与该页相关的页面级要求。

### 2.4 04-xx 的组合描述要求

每份 `04-xx` 至少应以表格说明：页面任务、页面输入（内容资产 / 配置 / 来源条件）、主承载模块、辅助模块、转化模块、系统能力 / 通用组件、模块不可用时的页面级处理，以及本页不调用的相关能力。具体交互与验收仍在单页 PRD 中定义。

## 三、当前页面模板索引

| 模板编号 | 页面模板分类 | 核心场景 | 核心顾客任务 |
|---|---|---|---|
| T-01 | 渠道投放模板 | 外部宣传渠道、广告投放、二维码、活动或渠道专属链接承接 | 快速理解项目或活动卖点，并产生咨询、预约或继续浏览意向 |
| T-02 | 特定功能模板 | 将可独立访问或独立分享的功能包装成页面 | 围绕单个功能完成查看、体验、理解或辅助决策 |
| T-03 | 房屋展示模板 | 围绕一个或多个户型、住户进行展示、推荐或比较 | 判断具体住户是否适合自己，并继续查看、比较、联系或预约 |

其中，渠道投放模板和特定功能模板优先用于补足当前 VISTA 在外部获客承接、单功能独立访问和分享上的缺口。房屋展示模板承接当前 VISTA 已具备但尚未拆分成独立营销页面的房屋、户型、住户展示能力。

## 四、首批 P0 级页面清单

| 页面模板分类 | 首批 P0 级页面 | 页面目的 | 备注 |
|---|---|---|---|
| 渠道投放模板 | `04-01-项目卖点Landing页PRD.md` | 承接外部流量，建立项目卖点认知并引导下一步动作 | 不等同于完整项目首页 |
| 渠道投放模板 | `04-02-活动与渠道专属转化页PRD.md` | 针对特定广告、媒体、代理渠道或二维码入口承接访问 | 与项目卖点 Landing 页独立设计，复用共同投放规则 |
| 特定功能模板 | `04-03-周边地图页PRD.md` | 独立展示项目区位、生活配套、交通和生活半径 | P0，单独设计 |
| 特定功能模板 | `04-04-眺望集页PRD.md` | 独立展示楼层视野、方向、景观或眺望差异 | P0，单独设计 |
| 特定功能模板 | `04-05-资料浏览页PRD.md` | 承接项目资料、图册、PDF 或外部资料浏览 | P0，单独设计；下载、权限和统计另按专项规则实现 |
| 特定功能模板 | `04-09-3D大楼独立功能页PRD.md` | 以全屏承载方式引用 HOMEVISTA 自有的完整 3D 大楼应用，展示建筑整体、楼栋与楼层关系 | P0；主业务 Widget 为 3D 大楼，应用内部交互不在本页面重复定义 |
| 房屋展示模板 | `04-06-单户型展示页PRD.md` | 聚焦一个户型，帮助顾客理解面积、格局、卖点、样板间或关联住户 | 原“单户型详情页”收口到此类 |
| 房屋展示模板 | `04-07-多户型与户型选择页PRD.md` | 展示多个户型，帮助顾客初步筛选适合自己的户型 | P0，单独设计 |
| 房屋展示模板 | `04-08-推荐住户展示页PRD.md` | 展示销售推荐的一套或多套住户 | P0，比较能力按页面任务作为辅助能力调用 |