# HOMEVISTA C端第一阶段 MVP Widget 范围与开发顺序

**版本：** v0.1
**状态：** 已确认范围，待完成各 Widget 开发规格
**适用对象：** 产品、设计、开发、测试、A端配置人员、Codex

## 修订记录

| 版本 | 日期 | 变更类型 | 变更摘要 | 备注 |
| --- | --- | --- | --- | --- |
| v0.1 | 2026-07-28 | 初始创建 / 重大范围确认 | 锁定第一阶段仅交付 M-01 项目概览、M-20 周边地图、M-10 户型卡片列表三个 Widget；项目联系页脚为固定通用组件，来场预约及其他扩展能力不进入本阶段。 | 产品确认 |

## 1. 文档目的

锁定 C端第一阶段 MVP 的 Widget 范围、开发顺序、共同交付门槛和明确不做，作为后续三份 Widget 开发规格以及重新构建 C端原型的上游依据。

本文件不定义 API、数据库字段、Google Key、数据适配器实现或页面视觉稿；这些事项必须在不突破本文件范围的前提下，分别进入技术设计、设计系统和 Widget 开发规格。

## 2. 第一阶段目标与成功标准

第一阶段验证顾客能否完成三个连续判断：识别项目、理解项目周边、初步筛选户型。它验证的是“项目内容可被 A端装配并稳定呈现”的最小闭环，不验证线索收集、预约受理、库存销售或沉浸式空间体验。

第一阶段完成时，必须同时满足：

1. 三个 Widget 可分别按项目内容和必要配置判断启用、隐藏或降级，不出现空模块、空入口或用未配置数据补位。
2. 顾客可从项目概览进入已启用的周边地图和户型列表；返回后保留来源页面上下文的具体方式由后续页面 PRD 定义。
3. 所有具有 C端页面壳层的 MVP 页面均使用 `06-通用组件说明.md` 的项目联系页脚；页脚不作为 Widget、不承担预约表单，也不出现在 A端 Widget 台账或模板区块中。
4. 新 C端原型只验证本文件列出的能力，不以当前九页原型、预约演示或旧模拟数据作为实现前提。

## 3. 本期范围

| 顺序 | Widget | 顾客任务 | 第一阶段必须验证 | 本期不包含 |
| --- | --- | --- | --- | --- |
| 1 | M-01 项目概览 | 识别当前项目，理解其基础价值并选择下一步内容。 | 项目身份、项目基础介绍、一项可核验核心卖点及证据/说明、进入已启用地图或户型内容的入口。 | 页面视觉方案、项目完整官网、实时库存/价格、预约、个人销售归属、项目私有表单。 |
| 2 | M-20 周边地图 | 以项目为锚点理解已核验的周边配套。 | Google 地图服务的项目级可用配置、项目锚点、A端已配置 POI、POI 分类切换、点位摘要与主地图不可用反馈。 | Google 自动搜索、顾客定位、路线规划、距离/时间承诺、政府风险/用途地域图层、外部地图跳转。 |
| 3 | M-10 户型卡片列表 | 用项目可公开户型完成初步筛选，并查看户型图。 | 户型集合、户型名称/图纸/面积/格局的基础表达、由已配置字段驱动的筛选或分组、户型图预览与放大查看。 | 住户房号、销售状态、价格/费用、户型比较、样板间/WALK/VR、推荐算法、户型详情页的完整购买判断链路。 |

### 3.1 固定通用组件

| 组件 | 定位 | 本期规则 |
| --- | --- | --- |
| 项目联系页脚 | `06` 的固定页面通用组件 | 读取项目级公共联系资料；至少一项可执行资料存在时显示，全部缺失时隐藏；不按页面/渠道差异化，不包含预约按钮。 |

### 3.2 明确不做

下列能力即使在旧 C端原型或既有页面 PRD 中已出现，也不进入第一阶段开发或验收：

- M-26 来场预约及其身份验证、隐私同意、表单提交、受理和后续处理。
- M-11 样板间列表、M-08/09 WALK/VR、M-12 户型及住户卡片、M-13 住户表、M-17 费用计算器及任何住户级销售信息。
- M-20 的路线、距离/时间、政府公开图层、顾客定位和外部地图跳转。
- 跨户型比较、账户收藏、智能推荐、CRM、销售分配、分享人追踪、广告归因和实时库存。
- 从当前九页 C端原型复用页面结构、预约模拟流程或旧模拟数据。

## 4. 开发顺序与前置门槛

```text
项目级数据与页面壳层
  → M-01 项目概览
    → M-20 周边地图
      → M-10 户型卡片列表
        → 三条顾客路径的全量验收
```

### 4.1 共同前置条件

- 项目基本信息、公共联系资料、户型和 POI 的业务定义以 `01-内容资产字典.md` 为准；后续重构时将其调整为“项目内容数据与素材字典”，但不在本文件中重新定义对象。
- 页面组合和入口顺序尚未在本文件锁定，后续由 `03` 和相关页面 PRD 收口；任何页面不得借 MVP 名义加入第四个 Widget。
- VISTA C 页面优先展示项目内容、后展示控制项。户型卡片、图片查看器、筛选控件、地图点位卡和项目联系页脚均属于通用组件或其组合，不因交互复杂而登记为 Widget。

### 4.2 各 Widget 开始条件

| Widget | 开始开发前必须确认 | 未满足时的处理 |
| --- | --- | --- |
| M-01 | 项目正式名称、项目主体、基础介绍和至少一项可核验核心卖点的可用来源。 | 不开始页面主承载实现；不得用示例卖点替代项目事实。 |
| M-20 | 项目锚点、至少一类已配置 POI，以及 Google 地图服务的项目级配置与不可用处理方案。 | 不实现地图主体；不得用 Google 自动搜索结果或未核验 POI 填充。 |
| M-10 | 至少一个可公开户型，以及名称、图纸、面积、格局的可用来源；户型图放大查看的通用组件边界。 | 不实现户型列表；不得以住户、价格或样板间资料替代户型核心信息。 |

## 5. 文档责任边界

| 文档 | 对第一阶段负责什么 | 不负责什么 |
| --- | --- | --- |
| `01-内容资产字典.md` | 共享项目内容数据与素材对象、关联和基础可用口径。 | Widget 必需字段、展示顺序、API 或数据库实现。 |
| `02-最小功能模块PRD.md` | 全量 Widget 编号、共通边界与非 MVP 能力目录。 | 单个 MVP Widget 的开发细节。 |
| 本目录后续 Widget 开发规格 | Widget 的数据来源与使用规则、A端配置、状态、交互、组件引用和验收。 | 页面级版式、全站导航和技术接口。 |
| `03` / `04-xx` | 页面模板、模块组合、页面顺序、入口和页面例外。 | 重复定义 Widget 内部规则。 |
| `06` / `07` / `08` | 分别定义通用组件、权限访问和埋点统计。 | 替代 Widget 的业务范围说明。 |

## 6. 验收与退出条件

第一阶段不以“完成三个页面截图”为验收，而以以下条件共同验收：

1. 每个 Widget 都有独立开发规格，写明数据来源与使用规则、A端配置、正常/空数据/局部失败状态和验收标准。
2. 三个 Widget 的最小数据不重复定义；共享对象以 `01` 为准，Widget 只声明自己需要哪些数据及缺失处理。
3. M-20 的 Google 地图不可用、POI 缺失和单个点位资料缺失均有明确顾客侧表现。
4. M-10 的图纸放大查看不拆成新 Widget，也不出现尚未进入本期的样板间、住户、价格、预约或比较入口。
5. 新原型以项目概览、周边地图、户型列表和项目联系页脚构成可验证路径；任何旧预约流程都不作为本期成功标准。

## 7. 待确认事项

| 编号 | 待确认事项 | 影响范围 | 当前处理 |
| --- | --- | --- | --- |
| MVP-01 | Google 地图服务的项目级配置由哪个系统维护，以及不可用时使用何种页面反馈。 | M-20 开发规格、A端配置、原型验证。 | 不影响范围确认；未确认前不得把真实服务可用性写成已达成。 |
| MVP-02 | M-10 首版支持哪些项目已配置字段作为筛选或分组条件。 | M-10 开发规格、A端配置。 | 仅允许已解释字段；具体字段在 M-10 开发规格确认。 |
| MVP-03 | 首个重新构建的 C端原型采用一个项目概览页承接地图和户型入口，还是使用独立入口页。 | `03`、页面 PRD、原型信息架构。 | 本文件只要求三条能力可到达，不预设页面版式。 |

## 8. Codex 执行说明

- 创建三份 Widget 开发规格前，先引用本文件的范围和明确不做；不得将旧原型可见能力自动加入。
- 每份规格必须使用“数据来源与使用规则”，不得使用 API、表名、字段名或接口地址替代产品规则。
- 涉及 VISTA C 页面、组件或原型时，优先使用已记录的 VISTA C 设计系统组件；项目联系页脚的专门视觉规格仍为“待设计系统补充”。
- 本阶段文档完成不等于可以删除旧 C端原型；只有在原型重建计划、历史快照和新原型验收范围确认后，才处理旧原型的废弃与替换。