# MRD：HOMEVISTA PWA 与客户触达能力分阶段建设

## 1. 项目机会与方案定位

日本销售团队反馈，近期客户在沟通中提到了竞品 APLIKA。客户关注的核心卖点并不是单一页面功能，而是 APLIKA 能够将项目入口放到客户手机上，并在客户注册后持续进行消息提醒，从而提升客户回访、项目关注和后续转化机会。

这一反馈说明，日本市场客户已经开始关注“项目页面是否能长期留在客户手机中”“系统是否能主动提醒已注册客户”这类能力。对 HOMEVISTA 来说，PWA 与 Push 通知可以作为回应这一诉求的产品方案，让 C 端客户/访客用户把 HOMEVISTA 添加到手机桌面，并在有重要项目消息时收到提醒，从而让 HOMEVISTA 不再只是一次性访问的网页，而是可以持续触达客户的项目入口。

结合产品技术分析，HOMEVISTA 不适合将“添加到桌面”和“Push 通知”一次性混在同一阶段完成。两者的复杂度不同，适合先拆分为两个阶段推进：

| 阶段 | 定位 | 说明 |
|---|---|---|
| 第一阶段：C 端添加到桌面 | 先建立客户手机上的项目入口 | 支持客户将 HOMEVISTA C 端添加到手机桌面，让项目页面像 App 一样更容易再次打开 |
| 第二阶段：简单项目 Push 通知 | 再建立基础客户提醒能力 | 支持客户开启通知、接收项目基础通知，并支持项目方发送和查看基础通知状态 |

本 MRD 重点说明 HOMEVISTA PWA 与客户触达能力的近期分阶段建设路径。第一阶段先解决“客户手机上是否有 HOMEVISTA 入口”，第二阶段解决“项目方是否可以向客户发送简单提醒”。

## 2. 需求背景

HOMEVISTA 是面向房地产项目展示、客户访问和销售跟进场景的系统。对客户/访客来说，他们可能需要及时看到项目公告、预约提醒、资料更新、房源状态变化等信息。

目前如果客户只通过浏览器访问 HOMEVISTA C 端，可能出现以下问题：

| 场景 | 当前问题 | 期望改善 |
|---|---|---|
| 客户经常查看项目资料 | 每次都要从浏览器输入或收藏夹进入 | 可像 App 一样从手机桌面打开 |
| 项目有公告或资料更新 | 客户不一定会主动回到页面查看 | 手机收到提醒后可回到 HOMEVISTA 查看 |
| 客户有预约相关事项 | 需要人工提醒或客户自己记住时间 | 系统可以通过 Push 做基础提醒 |
| 房源或项目状态有变化 | 客户可能无法及时感知 | 通过通知提醒客户关注变化 |

因此，PWA 的价值不是单纯“把网页变成 App 样式”，而是让 HOMEVISTA C 端更接近客户日常使用入口，并为后续客户持续触达打下基础。

## 3. 分阶段目标

### 3.1 第一阶段：C 端添加到桌面

第一阶段目标是让客户可以将 HOMEVISTA C 端保存到手机桌面，形成更稳定、更容易再次打开的项目入口。

| 目标 | 说明 |
|---|---|
| 可安装 | 客户可以将 HOMEVISTA C 端添加到手机桌面或桌面浏览器应用 |
| 可打开 | 客户从桌面图标打开 HOMEVISTA C 端，体验接近 App |
| 可引导 | Android、iOS、桌面浏览器分别提供合适的添加或安装引导 |
| 可识别 | 系统可以识别客户是否处于可安装、已安装或不支持安装的状态 |

### 3.2 第二阶段：简单项目 Push 通知

第二阶段目标是在 C 端桌面入口基础上，支持客户接收简单项目通知，并支持项目方完成基础通知发送与状态查看。

| 目标 | 说明 |
|---|---|
| 可授权 | 客户可以开启浏览器通知权限 |
| 可接收 | 系统可以向客户设备发送基础项目 Push 通知 |
| 可跳转 | 客户点击通知后，可以打开 HOMEVISTA C 端 |
| 可管理 | 客户可以知道当前设备通知是否开启，并可关闭通知 |
| 可发送 | 项目方可以发送测试通知、项目公告、简易业务提醒 |
| 可验证 | 项目方可以通过测试通知确认通道是否正常 |
| 可追踪 | 项目方可以查看客户是否已订阅通知、是否已开启通知，以及通知是否被查看 |

## 4. 分阶段典型使用场景

### 4.1 第一阶段场景：客户把 HOMEVISTA 添加到手机桌面

| 项目 | 内容 |
|---|---|
| 使用人 | C 端客户/访客用户 |
| 场景 | 客户经常查看 HOMEVISTA 项目页面，希望像打开 App 一样快速进入 |
| 用户操作 | 打开 HOMEVISTA C 端 -> 按提示添加到手机桌面 -> 桌面出现 HOMEVISTA 图标 |
| 使用结果 | 客户后续可以直接从桌面图标打开 HOMEVISTA C 端 |
| 客户价值 | 降低访问成本，提升客户回访和查看项目资料的便利性 |

### 4.2 第二阶段场景：客户开启通知权限

| 项目 | 内容 |
|---|---|
| 使用人 | 需要接收项目提醒的 C 端客户 |
| 场景 | 客户希望 HOMEVISTA 有重要项目消息时主动提醒自己 |
| 用户操作 | 进入 HOMEVISTA C 端 -> 查看通知引导 -> 点击开启通知 -> 浏览器弹出授权 -> 客户允许 |
| 使用结果 | 当前设备可以接收 HOMEVISTA Push 通知 |
| 客户价值 | 客户不需要一直主动刷新页面，也能收到提醒 |

### 4.3 第二阶段场景：系统发送测试通知

| 项目 | 内容 |
|---|---|
| 使用人 | C 端测试用户、内部验收人员 |
| 场景 | 项目方需要确认 C 端用户设备是否可以正常接收通知 |
| 用户操作 | C 端用户完成通知授权后，系统发送一条测试通知 |
| 使用结果 | C 端用户设备收到 HOMEVISTA 测试通知 |
| 客户价值 | 交付验收时可以直观看到 Push 通道已经打通 |

### 4.4 第二阶段场景：项目方发送简单项目通知

| 项目 | 内容 |
|---|---|
| 使用人 | 项目方运营人员 |
| 场景 | 项目有公告、资料更新、预约提醒、房源状态变化等需要提醒客户关注的事项 |
| 用户操作 | 项目方进入通知发送管理窗口 -> 选择通知类型 -> 填写通知内容 -> 选择发送对象 -> 发送通知 |
| 使用结果 | 已开启通知的 C 端客户收到 HOMEVISTA 项目通知 |
| 客户价值 | 项目方可以主动提醒客户回到项目页面，提高客户回访率 |

第二阶段优先支持相对简单、容易验收的通知类型：

| 通知类型 | 说明 |
|---|---|
| 测试通知 | 用于确认设备是否能收到通知 |
| 系统通知 | 用于提示客户 HOMEVISTA 相关系统消息 |
| 项目公告通知 | 用于向 C 端客户发送基础项目公告 |
| 简易业务提醒 | 可用于资料更新、预约提醒、房源状态变化等客户侧提醒，具体触发范围以第二阶段详细需求为准 |

### 4.5 第二阶段场景：客户点击通知后打开 HOMEVISTA

| 项目 | 内容 |
|---|---|
| 使用人 | 收到通知的 C 端客户 |
| 场景 | 客户看到通知后，希望回到 HOMEVISTA 查看详情 |
| 用户操作 | 点击手机或桌面上的通知 |
| 使用结果 | 系统打开 HOMEVISTA C 端；如客户未登录，则先登录再进入页面 |
| 客户价值 | 通知不只是提醒，还能把客户带回项目页面 |

### 4.6 第二阶段场景：客户关闭当前设备通知

| 项目 | 内容 |
|---|---|
| 使用人 | 不希望继续接收当前设备提醒的 C 端客户 |
| 场景 | 客户更换设备，或临时不想继续接收 HOMEVISTA 通知 |
| 用户操作 | 进入通知设置 -> 关闭当前设备通知 |
| 使用结果 | 当前设备不再接收 HOMEVISTA Push 通知 |
| 客户价值 | 尊重客户选择，减少打扰 |

## 5. 分阶段需求范围

| 阶段 | 模块 | 需求内容 |
|---|---|---|
| 第一阶段 | PWA 安装 | 支持 C 端客户将 HOMEVISTA 添加到手机桌面；桌面浏览器支持安装为应用 |
| 第一阶段 | iOS 引导 | iPhone / iPad 客户无法自动弹出安装时，提供“添加到主屏幕”的操作引导 |
| 第一阶段 | Android 安装 | Android Chrome 客户可按浏览器能力添加到桌面 |
| 第一阶段 | 桌面端安装 | Chrome / Edge 桌面浏览器可安装 HOMEVISTA |
| 第一阶段 | 安装状态识别 | 系统可识别当前浏览器是否支持安装、是否已安装、是否需要展示引导 |
| 第二阶段 | 通知授权 | C 端客户可以开启或拒绝通知权限 |
| 第二阶段 | 设备绑定 | C 端客户授权后，系统记录当前设备可接收通知 |
| 第二阶段 | 测试通知 | 支持发送测试通知，确认设备和通道可用 |
| 第二阶段 | 通知发送管理 | 项目方可通过管理窗口创建并发送测试通知、项目公告、简易业务提醒 |
| 第二阶段 | 简易通知发送 | 支持向 C 端客户发送基础 Push 通知，例如系统通知、项目公告、简易业务提醒 |
| 第二阶段 | 通知点击 | C 端客户点击 Push 通知后打开 HOMEVISTA C 端 |
| 第二阶段 | 通知关闭 | C 端客户可以关闭当前设备通知 |
| 第二阶段 | 基础记录 | 记录通知是否发送、是否失败、客户是否查看通知，便于排查问题 |
| 第二阶段 | 订阅状态查看 | 项目方可查看 C 端客户是否已订阅通知、当前通知权限状态 |

## 6. 分阶段技术开发规划

技术分析显示，C 端添加到桌面与 Push 通知的复杂度不同，应拆开推进。第一阶段以 PWA 安装体验为主，第二阶段再接入 Push 链路和基础通知管理。

| 阶段 | 开发模块 | 开发内容 | 交付结果 |
|---|---|---|---|
| 第一阶段 | 范围确认与安装样例 | 确认 Android、iOS、桌面浏览器的安装入口、引导文案、图标和验收设备范围 | 第一阶段范围清单和安装引导样例确认 |
| 第一阶段 | C 端 PWA 安装 | 支持 C 端添加到手机桌面；支持桌面浏览器安装；提供 iOS 添加到主屏幕引导 | 客户可从手机桌面或桌面应用打开 HOMEVISTA C 端 |
| 第一阶段 | 安装状态与兼容提示 | 根据不同浏览器和设备状态展示安装、已安装、不支持等提示 | 客户可获得清晰的添加到桌面引导 |
| 第二阶段 | 通知授权与设备绑定 | 支持客户开启 / 拒绝通知权限；记录当前设备通知状态 | 系统可识别客户设备是否具备接收通知条件 |
| 第二阶段 | 通知发送管理 | 提供项目方发送通知的管理窗口，支持测试通知、项目公告、简易业务提醒的创建和发送 | 项目方可选择通知类型、通知内容、发送对象并发起发送 |
| 第二阶段 | Push 投递与点击跳转 | 支持向客户设备发送 Push；客户点击通知后打开 HOMEVISTA C 端 | 客户可收到通知，并从通知回到 C 端页面 |
| 第二阶段 | 状态追踪与基础记录 | 记录客户订阅状态、通知权限状态、发送结果、失败结果、通知查看状态 | 项目方可查看客户是否订阅通知、是否开启通知、通知是否被查看 |
| 第二阶段 | 多终端适配与验收 | 验证 Android、iOS、桌面 Chrome / Edge 的授权、接收、跳转流程 | 完成第二阶段基础验收 |

## 7. 分阶段验收标准

| 阶段 | 验收项 | 验收标准 |
|---|---|---|
| 第一阶段 | 添加到桌面 | C 端客户可以将 HOMEVISTA 添加到手机桌面或桌面浏览器应用 |
| 第一阶段 | 桌面启动 | C 端客户点击桌面图标后，可以打开 HOMEVISTA C 端 |
| 第一阶段 | 安装引导 | Android、iOS、桌面浏览器均能展示符合平台特点的安装或添加引导 |
| 第一阶段 | 异常提示 | 浏览器或系统不支持安装时，用户能看到明确提示 |
| 第二阶段 | 通知授权 | C 端客户可以开启或拒绝通知权限，系统能正确显示当前状态 |
| 第二阶段 | 测试通知 | 授权成功的 C 端客户设备可以收到 HOMEVISTA 测试通知 |
| 第二阶段 | 简易通知 | 系统可以向指定 C 端客户发送基础项目 Push 通知 |
| 第二阶段 | 通知点击 | C 端客户点击通知后，可以打开 HOMEVISTA C 端 |
| 第二阶段 | 通知关闭 | C 端客户关闭通知后，当前设备不再接收 Push 通知 |
| 第二阶段 | 状态追踪 | 项目方可以查看客户是否订阅通知、是否开启通知，以及通知是否被查看 |
| 第二阶段 | 多端兼容 | Android、iOS、桌面 Chrome / Edge 完成基础可用性验证 |