# HOMEVISTA 模块化展示产品方案：技术评估报告

## 一、评估目的

本报告不是开发排期，也不是详细技术设计，而是用于判断现有 HOMEVISTA 系统能否承接新的产品目标。

新的产品目标是：

```text
模块化、路径化、比较化、销售资讯资产化、AI 可读化。
```

根据当前 demo 情况，HOMEVISTA 已经具备较完整的前台展示、后台管理和客户行为分析基础。但现有结构是否支持“客户买什么就展示什么”“销售按客群选择讲解路径”“多个资产进入比较页面”“客户行为被记录”等能力，需要先评估。

## 二、第一版定义

第一版不应理解为从零开发，也不应简单理解为只做小改。

更准确的定义是：

**基于现有完整系统，评估并验证模块化、路径化、比较化的产品改造方式；如果现有结构无法承接，则允许局部重做或重新规划。**

也就是说，目标是确定的，实施方式不预设：

| 可能结果 | 处理方式 |
|---|---|
| 现有系统可以承接 | 以改造为主，复用现有前台、后台和分析系统 |
| 展示层限制较大 | 前台展示层局部重做，后台和数据尽量复用 |
| 后台配置不支持 | 调整或补充后台配置能力 |
| 数据结构不支持 | 重新规划资产、组合、路径和比较对象关系 |
| 分析系统不支持 | 扩展埋点和报表维度 |

## 三、技术需要理解的产品结构变化

过去系统更像：

```text
一个项目 = 一套固定页面 + 固定菜单
```

未来应理解为：

```text
一个项目 = 一组销售信息资产
展示链接 = 从资产中选择一部分形成的展示组合
讲解路径 = 对展示组合重新排序后的讲解顺序
比较页面 = 将多个资产并列展示，用于辅助客户决策
```

核心对象关系：

| 概念 | 含义 |
|---|---|
| 项目 | 一个楼盘或一个销售项目 |
| 销售信息资产 | 项目中可展示、可组合、可比较的内容，如户型、样板间、眺望、价格、房源状态 |
| 展示组合 | 面向某个客户或某类场景选择出来的一组资产 |
| 讲解路径 | 展示组合里的内容顺序，类似 PPT 的讲解顺序 |
| 比较页面 | 将多个户型、样板间、楼层或房源放在一起比较的页面 |
| 转化入口 | 预约、联系销售、资料下载、咨询等动作 |
| 行为数据 | 客户看了什么、停留在哪、比较了什么、是否预约 |
| AI 可读内容 | 项目资料、模块配置、讲解路径、比较逻辑和销售文案需要能被 AI / Codex 快速读取、理解和再次编辑 |

## 四、重点评估方向

### 1. 资产化

评估问题：

- 现有项目内容是否能被识别为独立资产？
- 3D 大楼、虚拟样板间、眺望集、户型图、住户表、资料集、预约等内容是否有清晰的数据边界？
- 单个资产能否独立展示？
- 未启用资产能否在客户入口中隐藏？

判断标准：

| 结果 | 判断 |
|---|---|
| 每类内容可独立识别和调用 | 可支持资产化改造 |
| 内容只存在于固定页面结构中 | 需要改造数据或页面组织方式 |
| 单模块无法独立成页 | 前台展示层需要调整 |

### 2. 模块化

评估问题：

- 项目创建或配置时，是否能选择启用哪些模块？
- 客户只购买一个模块时，是否能生成单模块展示链接？
- 客户购买多个模块时，是否能生成组合展示页？
- 页面菜单、首页入口、分享链接是否能随模块变化？

判断标准：

| 能力 | 第一版要求 |
|---|---|
| 模块启用 / 隐藏 | 必须支持 |
| 单模块完整展示 | 必须支持 |
| 多模块组合展示 | 必须支持 |
| 模块购买权限 | 至少支持人工配置 |
| 多语言模块标签 | 建议支持独立配置 |

### 3. 路径化

评估问题：

- 同一项目内容是否能按不同顺序组成讲解路径？
- 是否能保存至少 2 条不同演示方案？
- 路径内是否能支持上一步、下一步、当前进度？
- 路径结束后是否能进入预约、联系销售或资料下载？

第一版建议先支持人工配置，不急于做算法推荐。

```text
人工选择资产
→ 人工组成展示组合
→ 人工保存讲解路径
→ 销售选择路径开始讲解
```

判断标准：

| 能力 | 第一版要求 |
|---|---|
| 预设演示方案 | 至少 2 条 |
| 路径内节点 | 每条至少 3 个展示节点 |
| 上一步 / 下一步 | 必须支持 |
| 当前进度提示 | 必须支持 |
| 路径内跳转 | 建议支持 |
| 路径结束动作 | 必须支持 |

### 4. 比较化

评估问题：

- 是否能从同一项目中选择 2-3 个对象进行比较？
- 户型、样板间、眺望、房源是否有可比较字段？
- 销售是否可以添加推荐说明？
- 客户是否可以从比较页跳转到具体资产或预约页？
- 比较行为是否能被记录？

第一版不要求自动推荐，可以先做人工选择和人工说明。

```text
从同一项目中选择 2 到 3 个对象
把关键字段并列展示
允许销售添加推荐说明
允许客户从比较页跳转到具体展示页或预约页
```

判断标准：

| 能力 | 第一版要求 |
|---|---|
| 2-3 个对象并列比较 | 必须支持 |
| 关键字段表格化 | 必须支持 |
| 视觉内容展示 | 建议支持 |
| 推荐理由 | 必须支持人工填写 |
| 比较页跳转 | 必须支持 |
| 自动推荐 | 第一版暂不要求 |

### 5. 权限化

评估问题：

- 客户购买内容与页面显示内容是否能绑定？
- 未购买内容是否可以隐藏，而不是显示灰色入口或无效菜单？
- 同一项目是否能生成不同展示链接？
- 销售入口和客户入口是否可以区分？

判断标准：

| 能力 | 第一版要求 |
|---|---|
| 已购买内容显示 | 必须支持 |
| 未购买内容隐藏 | 必须支持 |
| 不同组合生成不同链接 | 建议支持 |
| 销售入口 / 客户入口区分 | 建议支持 |

### 6. 数据化

评估问题：

- 现有分析系统是否只记录页面访问？
- 是否能记录客户进入了哪条路径？
- 是否能记录客户比较过哪些对象？
- 是否能记录客户从比较页进入预约或联系销售？
- 是否能给销售或销售经理查看客户关注点？

第一版至少应记录：

| 数据 | 用途 |
|---|---|
| 进入项目链接 | 判断客户是否访问 |
| 进入哪条讲解路径 | 判断客户当前关注阶段 |
| 查看哪些资产 | 判断客户关注内容 |
| 查看哪些比较页 | 判断客户在比较什么 |
| 是否进入预约或联系销售 | 判断转化动作 |

### 7. AI 可读化与 Codex 再编辑

评估问题：

- 项目资料是否有结构化字段，而不是只存在于页面文案中？
- 模块、页面、路径、比较对象是否有稳定 ID、名称、说明和关联关系？
- 讲解路径是否能导出为可读格式，例如 Markdown、JSON 或表格？
- 比较页面的比较字段、推荐理由和下一步动作是否能被机器读取？
- Codex 修改后的文案、路径说明或推荐理由是否可以人工确认后回写？
- 是否能保留修改记录，知道某段内容由谁、何时、基于什么版本修改？

第一版不要求内嵌复杂 AI 智能体，也不要求 AI 自动推荐或自动发布。技术侧只需要围绕四件事建立基础能力：资料结构化、导出给 Codex、Codex 辅助编辑、人工确认后回写。

技术设计上应采用“两版开发、一版预留”的方式：

- 第一版开发基础闭环。
- 第二版开发快速检查、客户行为摘要、销售跟进建议、自动生成新路径等智能辅助能力。
- 第一版的数据结构必须提前预留第二版所需字段，避免后续返工。

```text
结构化整理项目 / 模块 / 户型 / 房源 / 眺望 / 路径 / 比较页
→ 导出为 Markdown / 表格 / JSON 给 Codex 读取
→ Codex 生成文案、路径、推荐理由或多语言版本修改建议
→ 销售 / 产品 / 配置人员确认
→ 回写到系统
→ 保留版本记录
```

判断标准：

| 第一版事项 | 技术要求 |
|---|---|
| 资料结构化 | 项目、模块、户型、房源、眺望、讲解路径、比较页有稳定字段和标识 |
| 可导出给 Codex 读取 | 项目资料、路径、比较页可导出为 Markdown、表格或 JSON |
| Codex 辅助编辑 | 系统支持接收 Codex 修改后的文案、路径说明、推荐理由和多语言内容 |
| 人工确认后回写 | AI 输出不能直接发布，必须经过销售、产品或配置人员确认后回写 |
| 版本记录 | 记录修改前后版本、时间、修改人和来源 |
| 自动推荐 / 自动发布 | 第一版暂不要求 |

第二版字段预留建议：

| 预留对象 | 需要预留的字段或关系 | 对应第二版能力 |
|---|---|---|
| 资产 | 资产类型、标签、适用客户、适用阶段、关联页面 | 快速检查、自动生成路径 |
| 讲解路径 | 目标客户、客户决策阶段、路径目标、页面顺序、结束动作 | 自动生成新路径草稿、路径合理性检查 |
| 比较页面 | 比较对象、比较字段、推荐理由、下一步动作 | 比较说明检查、推荐理由生成 |
| 客户行为 | 访问路径、查看页面、比较对象、停留时间、预约动作 | 客户行为摘要、销售跟进建议 |
| AI 修改记录 | 修改前版本、修改后版本、来源、修改人、确认人、确认时间 | 版本追踪、质量复盘 |

## 五、页面与系统能力对应

| 页面 / 能力 | 前台要求 | 后台要求 | 数据要求 |
|---|---|---|---|
| 项目入口页 | 展示已启用资产和推荐入口 | 配置项目启用资产 | 记录访问 |
| 单资产展示页 | 单模块完整展示 | 配置单资产展示内容 | 记录资产访问 |
| 组合展示页 | 展示多个已启用资产 | 配置展示组合 | 记录组合访问 |
| 演示方案选择页 | 销售选择客户类型和阶段 | 配置预设演示方案 | 记录路径选择 |
| 路径演示页 | 上一步、下一步、进度、结束动作 | 配置路径顺序 | 记录路径节点访问 |
| 户型比较页 | 并列展示 2-3 个户型 | 选择比较对象和字段 | 记录比较行为 |
| 眺望比较页 | 并列展示楼层和视野 | 选择楼层、朝向、眺望图 | 记录比较行为 |
| 房源综合比较页 | 比较具体房源并展示推荐理由 | 选择房源和推荐说明 | 记录推荐和跳转 |
| 预约转化页 | 表单、联系销售、资料下载 | 配置预约和资料入口 | 记录转化动作 |
| AI / Codex 编辑流程 | 前台不一定展示给客户 | 导出、编辑、确认、回写项目资料和路径内容 | 记录版本和修改来源 |

## 六、第一版建议验证范围

第一版建议重点验证以下能力：

| 范围 | 说明 |
|---|---|
| 现有资产重新组织 | 将 demo 中已有的 3D 大楼、虚拟样板间、眺望集、户型、住户表、资料、预约等内容重新定义为销售信息资产 |
| 模块化展示入口 | 支持按客户购买内容或展示目的，只显示相关资产，不再默认进入完整大菜单 |
| 演示方案选择 | 在完整系统基础上增加“客户类型 + 客户决策阶段 + 推荐讲解路径”的演示方案入口 |
| 路径演示体验 | 路径内支持上一步、下一步、当前进度和路径结束动作 |
| 比较页面增强 | 在户型、虚拟样板间、眺望、房源之间增加比较页面 |
| 房源综合比较 | 支持 2-3 个房源并列展示，并允许销售说明推荐理由 |
| 预约转化衔接 | 路径或比较页最后可以进入预约、联系销售或资料下载 |
| 行为分析承接 | 分析系统能识别客户看过哪条路径、比较过哪些对象、是否进入预约 |
| AI 可读与再编辑 | 围绕资料结构化、导出给 Codex、辅助编辑、人工确认回写四件事完成第一版验证 |

## 七、第一版不建议立即追求

第一版不建议一开始就追求：

- 所有比较页面都自动生成。
- 所有演示方案都完全自由编辑。
- 自动根据客户行为生成推荐房源。
- 所有资产类型一次性完成路径化和比较化。
- 后台、前台、分析系统一次性全面重构。
- 完全自动由 AI 改写并直接发布，不经过人工确认。

更稳妥的方式是先验证：

```text
现有完整系统能否被重新组织成多套面向客群的演示方案？
客户能否按演示方案看懂项目？
销售能否按客群和阶段讲清楚项目？
比较页能否帮助客户做选择？
演示方案和比较行为能否被现有分析系统记录？
演示方案最后能否自然进入预约或联系销售？
项目资料和讲解路径能否被 Codex 快速读懂并再次编辑？
```

## 八、技术评估结论模板

技术部评估后，建议按以下格式输出结论：

| 评估项 | 是否可承接 | 需要改造内容 | 风险等级 |
|---|---|---|---|
| 资产化 | 待评估 | 例如内容数据是否可独立调用 | 高 / 中 / 低 |
| 模块化 | 待评估 | 例如启用、隐藏、单模块链接 | 高 / 中 / 低 |
| 路径化 | 待评估 | 例如路径配置、路径播放、进度提示 | 高 / 中 / 低 |
| 比较化 | 待评估 | 例如比较对象、字段、推荐说明 | 高 / 中 / 低 |
| 权限化 | 待评估 | 例如购买内容与展示入口绑定 | 高 / 中 / 低 |
| 数据化 | 待评估 | 例如路径、比较、预约埋点 | 高 / 中 / 低 |
| AI 可读化 | 待评估 | 例如资料结构化、导出、回写、版本记录 | 高 / 中 / 低 |

## 九、第一版验收标准

| 验收项 | 标准 |
|---|---|
| 现有资产梳理 | demo 中已有内容可以被归类为销售信息资产 |
| 单资产体验 | 只启用一个资产时，页面仍然完整，不出现无关菜单 |
| 演示方案入口 | 销售可以按客户类型和客户决策阶段选择至少 2 条不同演示方案 |
| 路径演示 | 讲解路径支持上一步、下一步和当前进度提示 |
| 路径内容 | 每条路径至少包含 3 个展示节点 |
| 比较页面 | 可以同时比较 2-3 个对象 |
| 比较跳转 | 客户可以从比较页进入具体户型、样板间或预约页 |
| 转化动作 | 路径结束或比较结束后，有明确联系销售或预约动作 |
| 未购买内容隐藏 | 未启用或未购买的资产不出现在客户展示入口中 |
| 分析记录 | 至少能记录客户进入了哪条路径、查看了哪些比较页面、是否进入预约 |
| UI 清晰度 | 客户能知道当前在看什么、为什么比较、下一步做什么 |
| AI / Codex 再编辑 | 项目资料、路径、比较说明和销售话术可以被导出、修改、人工确认后回写 |