# VISTA Insights 产品讨论纪要

| 项目 | 内容 |
|---|---|
| 文档用途 | 记录产品讨论中已确认的结论，作为 PRD 更新的输入 |
| 最后更新 | 2026-06-24 |
| 讨论方式 | 从销售人员的实际工作场景出发，逐层推论 |

> **2026-06-24 更新：** 后续讨论决定将 VISTA Data Management 合并回 VISTA Insights，标签管理纳入 Insights 内部（管理后台 + 销售使用中沉淀）。本纪要中关于 Data Management 的早期讨论已过时，以 PRD 最新版本为准。

---

## 1. 核心架构决策

### 1.1 三系统分工

经过讨论，整个产品体系由三个系统构成：

| 系统 | 职责 | 使用者 |
|---|---|---|
| **VISTA ADMIN** | 装配内容——把项目资料变成可上线的展示模块（样板间、户型、比较页等） | 交付/配置人员 |
| **VISTA Data Management** | 给内容打标签、定义业务含义映射、预置素材组合模板 | HOMEVISTA 平台方 / 代理销售方 |
| **VISTA Insights** | 消费标签和数据，服务销售人员——匹配素材、生成链接、追踪行为、输出结论 | 销售人员 |

**关键约束：** VISTA Data Management 必须能预览内容（内嵌或跳转），否则打标签的人看不到内容就无法判断标签。

### 1.2 VISTA Insights 的产品定位

**不是「销售人员使用的 Web 应用」，而是「一组可被外部 Agent 调用的能力基座」。**

- 主入口：外部 Agent（Codex 等），通过 API/MCP/CLI/Skill 方式调用
- 辅入口：Insights 自带的轻量 UI
- 两者共享同一套底层能力

### 1.3 开放能力供给

两个方向对外供给：

**素材侧：**
- 素材列表 + 标签 + 结构化属性，通过 API 暴露
- 外部 Agent 根据销售的自然语言需求，自动匹配素材 → 组合 → 生成追踪链接

**行为数据侧：**
- 客户浏览行为数据通过 API 暴露
- 外部 Agent 读取行为数据 → 生成自然语言结论（客户意向 + 下一步建议）

---

## 2. 销售人员完整工作流（本次讨论确认版）

### 2.1 正向链路（发送侧）

```text
销售用自然语言说需求（在 Agent 或 Insights UI 中）
→ Agent 调用 Insights API，获取素材目录（标签 + 结构化属性）
→ Agent 匹配素材 → 组装为素材组合
→ Insights API 生成一条追踪链接（可选同时触发创建客户记录 → 绑定客户）
→ 链接返回给销售
→ 销售复制链接，通过 LINE/邮件/WhatsApp 等外部渠道发给客户
```

### 2.2 反向链路（追踪侧）

```text
客户打开链接 → 浏览展示内容（在 HOMEVISTA 展示端，客户无感知）
→ 行为数据落回 VISTA Insights
→ 行为数据通过 API 暴露（带业务含义）
→ 外部 Agent/AI 读取 → 生成自然语言结论
→ 销售看到：客户名 / 最近访问时间 / 一句话总结 / 下一步建议动作
```

### 2.3 核心价值区间

VISTA Insights 不负责获客（属于 CRM/广告范围），核心价值集中在：

> **"发送前：帮销售快速匹配适合这个客户的材料"**
> **"发送后：让销售知道客户看了没有、看了什么"**
> **"跟进时：给出结论和建议——这个客户值不值得跟、下一步发什么"**

---

## 3. 关键设计决策

### 3.1 链接

- **一条统一链接。** 素材组合打包为一条链接发给客户。客户点开是完整的浏览体验，后台追踪各模块的浏览行为。
- **链接与客户松耦合。** 生成时可选绑定客户，也可以后绑定，也可以始终不绑定。
- **客户绑定方式：** 销售在生成链接时触发创建客户记录操作，结果放入客户列表。不自动创建。
- **行为归属：** 链接绑定客户后，该链接下所有访问归该客户。不需要区分"张先生还是张太太"——跟进的基本单位是客户（户），不是浏览者。

### 3.2 客户信息

- VISTA Insights 维护自己的轻量客户列表
- 提供对外同步接口，可对接外部 CRM
- 不替代完整 CRM，是最小够用的客户名册

### 3.3 素材匹配

- **混合模型：** 标签（离散分类维度）+ 结构化属性（连续数值维度）
- 标签示例：户型类型、风格、场景、朝向、视野类型
- 结构化属性示例：价格区间、面积、楼层、房间数
- 标签和结构化属性在 VISTA Data Management 维护，Insights 消费

### 3.4 业务含义映射

- 技术埋点事件需要翻译为销售能懂的业务含义
- 映射定义在 VISTA Data Management，不在 Insights 范围
- 映射粒度：优先在「模块类型」层级做一次性定义（样板间进入 = 客户浏览了样板间），「具体内容内细粒度行为」（厨房区域停留）留待后续
- AI 本身可以做翻译，不一定需要人工维护全量映射表

### 3.5 发送渠道

- 系统只生成链接并返回给销售，不直接发送给客户
- 销售自行通过 LINE/邮件/WhatsApp 等外部渠道转发
- 无需集成外部发送渠道

### 3.6 入口形态

- 外部 Agent 为主入口
- Insights 自带轻量 UI 为辅入口
- 两者共享底层 API 能力
- 形态参考：销售在 Agent 中输入自然语言，Agent 调用 Insights API，销售也可以在 Insights 网页中完成同等操作

---

## 4. 待讨论 / 待确认

| # | 议题 | 状态 |
|---|---|---|
| 1 | VISTA Data Management 的详细设计（标签体系、映射规则、模板管理） | 不在 Insights PRD 范围 |
| 2 | 多项目支持——销售在 Agent 中如何指定项目上下文 | 🔲 待讨论 |
| 3 | 销售经理和开发商管理层的需求 | 🔲 待讨论 |
| 4 | 渠道链接（代理、广告、活动）的具体需求 | 🔲 待讨论 |
| 5 | AI 总结的数据粒度——"一句话总结"底层需要什么程度的行为数据 | 🔲 待讨论 |
| 6 | 销售跟进备注的权限（销售私有 vs 经理可见） | 🔲 待讨论 |
| 7 | 管理层是否可下钻查看单个客户行为 | 🔲 待讨论 |
| 8 | 预约入口归属（HOMEVISTA 展示端 vs VISTA Insights） | 🔲 待讨论 |

---

## 5. 与当前 PRD 的主要差异

| 维度 | 当前 PRD（v0.2） | 本次讨论确认 |
|---|---|---|
| 产品形态 | 以 Web 应用为主 | API 基座 + Agent 为主入口，轻量 UI 为辅 |
| 素材组合 | 销售人员在 UI 中手动选择内容拼装 | Agent 根据自然语言自动匹配 + 组装 |
| AI 定位 | P2 辅助能力 | 核心链路的一部分（匹配素材、生成结论） |
| 客户记录 | 生成链接时填写客户标识 | 生成链接时可选触发创建客户操作 |
| 标签体系 | Insights 读取 VISTA ADMIN 标签 | 独立的 VISTA Data Management 维护 |
| 业务含义映射 | 在 Insights 内维护映射表 | 在 VISTA Data Management 维护 |
| 初始模板 | 无明确来源 | VISTA Data Management 预置 |