# HOMEVISTA C端当前九页原型的 02 模块内容定义修订交接任务

**版本：** v0.2
**状态：** 待执行
**修订对象：** `C端需求/02-最小功能模块PRD.md`
**下游使用方：** `03-页面模板索引与通用规则.md`、`04-01` 至 `04-09` 页面 PRD、下一轮 C端原型重制

## 修订记录

| 版本 | 日期 | 变更类型 | 变更摘要 | 修改人 / 来源 |
| --- | --- | --- | --- | --- |
| v0.1 | 2026-07-15 | 初始创建 | 确定先为当前九个 C端页面实际调用的模块补齐内容定义；不提前扩展未进入本期页面的模块。 | 产品确认 / Codex |
| v0.1 | 2026-07-28 | 文档目录调整 | C端正式需求目录由 `输出稿/` 更名为 `C端需求/`，同步修订对象路径；不改变模块修订范围和优先级。 | 产品目录调整 |
| v0.2 | 2026-07-28 | **重大模块范围调整** | `M-02 项目联系方式`退出 Widget 清单，固定项目联系入口改由 `06` 的项目联系页脚组件承接；本任务不再为 M-02 编写模块内容契约，改为核对组件数据与状态边界。 | 产品确认 / Codex |

## 1. 任务结论

当前原型重制不能直接从页面视觉或现有旧原型开始。`02` 已具备模块边界、资产依赖和基本状态口径，但对“模块在顾客面前究竟呈现什么内容、顾客做什么判断和动作”的定义仍不足。

本轮只修订支撑 `04-01` 至 `04-09` 的模块；未被当前九页实际调用的模块不做预定义。完成本任务后，`03` 再补页面内容编排，`04-xx` 再落各页的实际取值、顺序与例外，最后才从零重制原型。

本任务不是将 `02` 改成页面设计稿、UI 规范或接口文档。`02` 只补足模块内容契约；页面首屏、内容顺序、CTA 权重与页面级降级仍属于 `03` / `04-xx`。

## 2. 本次要解决的问题

当前模块说明通常能说明“调用什么资产”，但不能稳定回答以下问题，导致原型容易退化为泛化卡片、占位文案和无业务语义按钮：

1. 顾客进入模块后首先要完成什么判断，而不是只“浏览信息”。
2. 模块面对顾客的内容对象、最小字段、字段分组、媒体类型和证据类型是什么。
3. 哪些字段或素材是模块成立的前提，哪些只是可选补充；缺失时具体保留、隐藏还是降级什么。
4. 顾客可执行哪些动作；动作的目标对象、前置条件、成功结果和失败反馈是什么。
5. 同一模块被多个页面调用时，哪些内容和行为必须一致，哪些由页面决定。

## 3. 修订边界与先后关系

### 3.1 本任务做什么

- 在 `02` 的现有模块详细说明中，为本文件第 4 节列出的模块补齐内容契约。
- 允许纠正模块名称、对象归属或模块之间的重复边界；若发生此类变更，必须在 `02` 的修订记录中单列重大变更。
- 明确本期九页需要的模块级状态和可行动作，但不重写权限、导航、埋点和系统状态的公共规则。
- 对 `04-02` 的渠道专属内容进行归属判断：优先复用 `M-24 活动日历`；若其无法承载“渠道承诺、有效期、限定内容与去向一致”的最小闭环，必须明确新增模块或扩展 M-24 的理由，不能用页面私有内容含混处理。

### 3.2 本任务不做什么

- 不补全当前九页未调用的 360 转大楼、断面图 / 立面图、共有部、WALK、VR、平面/3D 色彩切换、家具摆放、日影等模块。
- 不定义组件视觉、色彩、间距、具体卡片样式、技术接口、数据库字段或后台配置界面。
- 不把身份验证、导航、对象比较、通用错误状态重新变成 `02` 的功能模块；它们仍分别引用 `05`、`06`、`07` 的规则。
- 不因为当前没有真实项目资产而编造字段值、效果承诺、价格、住户状态或活动权益。

### 3.3 后续依赖顺序

```text
02：模块内容契约
  -> 03：页面内容编排与模块-区块映射
    -> 04-01 ~ 04-09：每页实际内容、顺序、例外与验收
      -> 从零制作 C端原型
```

## 4. 当前九页优先模块清单

### P0：必须先完成，直接决定页面核心内容或主行动

| 模块 | 当前页面 | 本轮必须补清的内容定义 | 不应在本模块决定的内容 |
| --- | --- | --- | --- |
| M-01 项目概览 | 04-01、04-02，辅助 04-03/05/06/07/08/09 | 项目身份与核心承诺的最小字段；事实信息、卖点、证据、媒体与必要说明的分组；哪些内容可作为首屏信息，哪些只能作为后续入口；内容完整度规则。 | Landing 首屏的具体排版、页面区块顺序、渠道文案。 |
| 项目联系页脚（`06` 通用组件） | 04-01、04-02，辅助 04-03/05/06/08 | 项目级公共联系资料的最小集合、各入口动作、全缺失隐藏、与 M-26 的替代关系；不由 A端作为 Widget 配置。 | 页面中 CTA 的主次、个人销售归属、CRM 分配、预约表单。 |
| M-10 户型卡片列表 | 04-07，辅助 04-01/06 | 顾客初筛所需的最小字段、可筛选字段来源、可比较字段范围、排序依据、缩略图/文字降级规则、从户型到下一步的对象传递。 | 具体筛选栏布局、推荐算法、住户级价格判断。 |
| M-12 户型及住户卡片 | 04-06、04-08，辅助 04-07 | 户型态与住户态的内容层级；单对象页所需字段；推荐理由、关联眺望、资料、样板间、费用入口的出现条件；对象切换与返回应保留的上下文。 | 多对象列表的页面排序、完整住户表。 |
| M-13 住户表 | 04-08，辅助 04-06/07 | 推荐住户与筛选住户的对象集合边界；最小比较字段、不可比较情形、住户状态/价格/费用缺失时的表达；选择后进入什么对象页。 | 销售状态枚举、价格控制后台逻辑、销售分配。 |
| M-19 眺望集 | 04-04，辅助 04-06/08 | 素材类型、真实性/CG/增强标识、楼栋/楼层/朝向关联、默认素材选择、切换条件、遮挡说明、单素材失败与全部缺失的区别。 | 具体全屏播放器技术、实际交付景观承诺。 |
| M-20 周边地图 | 04-03，辅助 04-01/02 | 页面可展示的 POI 分类、点位卡最小字段、路线/时间资料来源、图层的公开与验证边界、项目锚点、局部与主地图失败的处理。 | 地图 API 实现、政府数据同步机制、页面版式。 |
| M-21 资料集文件夹 | 04-05，辅助 04-01/02 | 文件夹与资料的内容结构、资料卡最小字段、公开/受限/失效/不可解析的区别、检索范围、资料打开后的目标与返回上下文。 | 文件存储、下载权限策略、PDF 阅读器技术实现。 |
| M-22 PDF 在线解析 | 04-05 | PDF 在线阅读的最小可用内容、页码/目录/检索的能力前提、加载与解析失败的区别、返回资料集的规则。 | OCR、全文检索引擎、批注编辑。 |
| M-23 单文件夹引用展示 | 04-01/02/03/06/08 的辅助内容 | 引用文件夹的适用场景、媒体集合的最小字段、与 M-21 的职责差异、首个可浏览媒体、素材失败及返回规则。 | 把具体项目素材泛化为资料目录、复杂画廊技术。 |
| M-25 外部页面嵌入 | 04-09 | 进入前要展示的来源与责任信息、全屏承载的最小外壳、加载中/可检测失败/不可检测内部错误的边界、安全退出与来源恢复规则。 | 3D 应用内部信息架构、模型交互、权限和错误。 |
| M-26 来场预约 | 04-01、04-02，辅助 04-06/08 | 页面可调用的预约前置条件、表单最小字段和同意规则、活动上下文如何传入、提交中的不可重复提交、成功仅为申请提交、失败后的联系替代路径。 | 页面私有预约表单、CRM、人工确认、资源锁定。 |

### P1：与 P0 同批审查；仅在对应关系成立时补齐

| 模块 | 对应页面 | 触发条件 | 本轮补充重点 |
| --- | --- | --- | --- |
| M-06 楼层信息 | 04-04、04-06、04-08 | 眺望或住户需要从楼层进入/返回 | 楼栋—楼层—眺望/户型/住户的关联表达，以及缺图降级。 |
| M-24 活动日历 | 04-02 | 渠道页使用真实活动对象或活动内容 | 活动对象、有效期、取消/结束、限定内容、联系/预约关联；并完成其是否足以承载渠道专属页的判断。 |
| M-17 费用计算器 | 04-06、04-08 | 费用计算而非仅展示已配置价格/费用时 | 输入项、可选费用、参考结果、前置权限/说明、失败及不作承诺的口径。 |

## 5. 每个优先模块必须补齐的内容契约

以下内容应直接写回 `02` 对应模块，不能只在本交接文档中讨论：

| 说明项 | 必须达到的粒度 |
| --- | --- |
| 顾客任务与判断 | 使用“顾客需要判断 / 选择 / 完成什么”表述；避免只有“浏览、展示”。 |
| 内容对象与关系 | 明确主对象、关联对象及其关系，例如“户型—住户”“楼层—朝向—眺望素材”“文件夹—资料文件”。 |
| 最小展示内容 | 列出顾客可见字段，区分事实字段、营销解释、状态、证据和必要说明；不写成笼统的“相关信息”。 |
| 媒体与证据 | 明确图片、视频、PDF、地图、CG、实拍、全景等类型；标示不可混淆的真实性或来源口径。 |
| 动作与结果 | 每个动作写清触发对象、前提、目标、成功后的可见结果和失败反馈。 |
| 启用与降级 | 区分不可启用、隐藏字段/入口、可降级浏览、可重试的运行时失败；不得用一个“空状态”覆盖全部情形。 |
| 跨页不变项 | 写清被不同页面调用时必须保持一致的对象、字段与行为。 |
| 页面保留项 | 写清仍由 03 / 04-xx 决定的内容顺序、主次、传播场景、页面级 CTA 和视觉表达。 |
| 验收 | 用真实内容对象和状态验证模块，而不是仅验证页面能显示一张卡片。 |

## 6. 模块级验收标准

本轮 `02` 修订完成，至少应满足：

- 当前九页在不借助旧原型、不编造页面私有内容的前提下，能够列出每个内容区块要呈现的对象、字段、媒体、动作和状态。
- 同一模块在不同页面中不会出现字段含义、对象层级、启用条件或失败处理互相矛盾的情况。
- 每个 P0 模块都能区分：不可发布、隐藏/降级、运行时失败、受限访问和正常可用。
- `04-02` 的渠道专属内容已明确归属；如果需要新增或实质扩展模块，已在 `02` 中记录重大变更及对其他页面的影响。
- P1 模块均已完成“本期需要 / 不需要”的判定；不需要的模块不得为凑完整度而扩写。
- `02` 的修订记录已按重大变更与普通补充分别维护，版本号继续使用 `v0.xx`。

## 7. 交接给下一进程的执行步骤

1. 阅读本文件、`01-内容资产字典.md`、`02-最小功能模块PRD.md`、`03-页面模板索引与通用规则.md` 与所有 `04-01` 至 `04-09` PRD。
2. 先为第 4 节 P0 模块建立“当前定义缺口 → 建议补充内容”的逐模块清单；不要直接复制页面文案或开始制作原型。
3. 逐个修订 `02`；如发现模块边界冲突，先写明冲突、影响页面和候选方案，再决定是否变更模块边界。
4. 完成 P0 后审查 P1 的实际需要性，并补齐必要项。
5. 对照第 6 节验收；输出“已定义模块 / 待确认模块 / 不需要模块 / 需要新增或拆分的模块”清单。
6. 未完成上述验收前，不修改 `03`、不开始新原型代码；`03` 的页面内容编排应在 `02` 内容契约稳定后另行交接。

## 8. 仍需产品确认的边界

1. 新原型是针对一个真实项目的可演示成品，还是面向多个项目的可配置 C端产品基线；这会影响模块示例数据与内容模板的颗粒度，但不改变模块边界。
2. 04-02 的“活动与渠道专属内容”是否以活动对象为核心，还是存在不依赖活动日历的渠道承诺对象；后者可能需要新增配置流程或内容模块。
3. 04-06 / 04-08 是否在本期展示真实费用计算，还是仅展示已配置价格/费用摘要；这决定 M-17 是否进入当前必做范围。
4. 真实项目资产、VISTA C 设计系统、身份验证、M-26 与 3D 应用的可用性仍不应被模拟原型替代为已确认事实。