# 2026-08-03 产品确认结论与 PRD 补充任务（A 端 / B 端 / C 端）

## 文档说明

- **确认日期**：2026-08-03
- **确认范围**：开发提出的 8 个最外层问题
- **原始问题**：[2026-07-31 产品确认清单（A 端 / B 端 / C 端）](./2026-07-31-产品确认清单-A-B-C端.md)
- **当前 B 端 PRD**：[VISTA Link 产品需求文档](../VISTA_Link_产品需求文档.md)
- **本文用途**：记录已经确认的产品结论，并列出 A、B、C 端 PRD 需要补充的任务

本文不替代正式 PRD。正式规则需要分别写入对应端的 PRD。涉及 A 端或 C 端的规则，不能只在 B 端 PRD 中说明。

---

## 一、确认结果总表

| 编号 | 主题 | 已确认结论 | PRD 处理 |
|---|---|---|---|
| 1 | B 端登录 | 当前版本使用已绑定邮箱登录；沿用已确认的登录校验行为和异常处理；旧 B 端账号兼容以后正式上线时另行处理 | B 端 PRD 已补充；旧账号兼容不属于当前 B 端 MVP |
| 2 | 客户、链接、页面关系 | 保持当前 B 端 PRD 已定义的关系不变 | 当前 B 端 PRD 已有明确规则，不补充 |
| 3 | 素材定义与 Widget 选材 | Widget 先按允许素材类型及自身限制生成候选素材，用户再按名称、分类或标签缩小范围；类型只供系统判断，不在界面展示或筛选；分类和类型由素材目录提供方准备；B 端显示素材更新和下线状态 | B 端 PRD 已补充；素材目录提供方式由技术团队确定；C 端另需补充读取最新素材和更新提示 |
| 4 | A、B 端页面管理关系 | 页面只有一个对象，以创建来源区分 A 端创建和 B 端创建；A 端创建的页面可供 B 端使用但不能直接编辑；B 端创建的页面可以由 A 端代为处理 | B 端 PRD 已补充处理结果；A 端 PRD 需要补充具体功能 |
| 5 | 链接与客户绑定 | 保持当前绑定时机和统计含义不变 | 当前 B 端 PRD 已有明确规则，不补充 |
| 6 | 页面封面 | A 端创建的页面必须提供页面封面并传给 B 端 | A 端 PRD 需要补充；检查 B 端现有规则即可 |
| 7 | Widget 与页面实例 | A、B 两端只能选择当前可用的 Widget；页面保存和复制 Widget 实例；Widget 停用后不能再选择，但不影响已经保存的页面 | A、B、C 端 PRD 都需要补充 |
| 8 | 项目主题 | A 端设置项目主题；B 端页面自动使用当前项目主题；B 端预览与 C 端显示使用同一主题 | A、B、C 端 PRD 都需要补充 |

---

## 二、已确认的产品结论

### 1. B 端登录

- 当前 B 端 MVP 使用已绑定邮箱和密码登录，新用户只通过邮箱邀请。
- 登录采用已经确认的校验行为和错误处理，不要求 PRD 指定服务是新建还是改造。
- 密码算法、Token 格式和接口实现方式由技术设计说明，不写入 PRD，除非会改变用户操作或错误提示。
- 项目选择仍按 B 端 PRD 的项目选择规则处理；不得因为沿用登录校验而把项目选择规则改回旧 B 端现状。
- 旧 B 端账号兼容以后正式上线时另行处理，不属于当前 B 端 MVP；当前版本不读取旧 B 端手机号、密码、登录状态、项目成员关系或角色权限。

### 2. 客户、链接、页面关系

- 一个分享页面只有一个固定链接。
- 一个客户可以关联多个链接，一个链接可以关联多个客户。
- 选择客户时，只在固定链接上增加客户识别参数，不生成新的分享链接。
- 不选择客户时，固定链接仍然可以打开。公开链接可以直接查看内容；非公开链接需要完成客户认证后才能查看内容。
- 客户被删除后，只让该客户对应的识别参数失效，不让固定链接失效。
- 客户识别用于记录访问身份，不表示只有该客户可以访问。
- 二维码只是无参数固定链接的另一种形式；公开链接扫码无需认证，非公开链接仍按无参数固定链接规则识别或认证客户。
- 手动创建、CSV 导入和链接访问认证自动创建的客户，都由系统生成内部唯一标识；客户列表不展示该标识。

### 3. 素材定义与 Widget 选材

- 每条素材必须有明确且唯一的分类和类型。
- Widget 先按“允许的素材类型”和其他自身限制生成候选素材，允许类型与素材目录中的素材类型准确匹配。
- 用户再在候选素材列表中按名称搜索，或按分类和标签筛选；这些条件只能缩小 Widget 候选范围。
- 分类不参与 Widget 第一层候选判断；类型只用于 Widget 允许类型判断，不在普通素材列表或 Widget 候选素材列表中展示或筛选。
- 资料集中的 PDF、图片和视频作为文件类型展示，但第一版不提供文件类型或其他结构化信息筛选。
- “大楼 WALK”和“室内 WALK”是不同类型。
- 通过地址打开的 WALK、VR、3D 大楼等素材，应使用真实业务类型，不能全部记为“链接”。
- 分类和类型由素材目录提供方在素材进入 B 端前准备；可以由装配后台直接提供，也可以由独立处理程序生成，具体技术方案由技术团队确定。
- C 端不使用素材分类和类型；A 端当前也不管理 B 端素材分类清单。
- B 端当前分类包括大楼外观、室内空间、户型、眺望集和资料集；各分类下的类型、素材单位和结构化信息以 B 端 PRD §4.2 为准。
- 同一素材内容更新且素材标识不变时，素材库直接展示最新内容，同时提示「内容已更新」，不保留旧内容供用户选择，也不生成另一条素材。
- 使用更新素材的 B 端页面提示「页面素材有更新」，页面详情、编辑和预览读取最新素材内容。
- 已下线或已删除素材不在 B 端素材库和候选列表中展示；已经使用该素材的页面显示对应状态，B 端预览中的已下线素材显示「内容已经下线」。
- C 端读取最新素材并向客户提示页面发生更新，客户确认后提示消失；该规则需要写入 C 端 PRD，不写入 B 端正式 PRD。

### 4. A、B 端页面管理关系

- 页面只有一个对象，以创建来源区分 A 端创建和 B 端创建，不再使用“平台页面”“销售页面”等名称定义不同页面类型。
- B 端可以使用、预览、分享和复制 A 端创建的页面，但不能直接编辑或删除。
- B 端复制 A 端创建的页面后，产生独立的 B 端创建页面。
- A 端可以查看、编辑和删除 B 端创建的页面，也可以停用和重新启用页面的固定链接。
- 原则上 A 端日常只查看；编辑、删除、停用和重新启用用于 B 端请求平台代为处理问题的情况。
- A 端编辑 B 端创建的页面后，页面的创建来源和创建人不变，固定链接地址不变，B 端读取最新内容。
- A 端停用、重新启用或删除后，B 端分别按现有固定链接状态和页面删除规则显示结果。
- A 端的角色权限、操作入口、确认步骤和操作日志要求由 A 端 PRD 定义。

### 5. 链接与客户绑定

- 销售选择客户并复制带客户参数的地址时，立即建立客户与链接的关系，不等待客户访问。
- 没有选择客户时，非公开链接在客户完成邮箱认证后建立关系。
- 公开链接允许匿名访问，不建立客户关系。
- “关联客户”表示链接曾经发给该客户，不代表客户已经访问。
- 实际访问客户、访问次数和访问行为单独统计。

### 6. 页面封面

- A 端创建的页面必须有页面封面。
- A 端创建页面时自动使用一张平台默认封面，之后可以更换默认封面或上传图片。
- 页面封面使用 16:9 比例，并传给 B 端作为页面库缩略图。
- B 端复制 A 端创建的页面时，一并复制当时的页面封面。
- A 端之后更换原页面封面，不改变已经复制出的 B 端创建页面封面。
- 页面封面只用于页面库展示，不是 C 端页面内容中的“项目封面图”。

### 7. Widget 与页面实例

- B 端只管理页面和页面中的 Widget 实例，不展示或管理 Widget 定义和版本。
- A、B 两端新建或编辑页面时，只能从当前可选的 Widget 列表中添加。
- 每次添加 Widget 都会在页面中产生一个独立实例；同一个 Widget 可以按页面使用规则添加多次，各实例互不影响。
- 复制页面时复制页面中的 Widget 实例；复制出的实例保留原实例的素材、内容、显示方式和顺序，但与原页面实例相互独立。
- Widget 被 A 端停用后，不再出现在 A、B 两端的可选列表中，不能新增。
- Widget 停用不影响已经保存的页面实例；页面预览、固定链接和客户访问继续显示已保存内容。
- 再次编辑或复制包含已停用 Widget 的页面时，A、B 两端提示该 Widget 已停用并要求更换；完成更换前不能保存，原页面继续正常访问。
- 页头和页脚也属于 Widget，在每个页面中各固定一个并且不能删除。

### 8. 项目主题

- 每个项目同时只有一套正在使用的主题。
- 项目没有自定义主题时，使用 VISTA 默认主题。
- A 端负责设置项目主题。
- B 端创建的页面自动使用所属项目的当前主题，销售不能单独修改主题。
- B 端预览和 C 端实际显示使用同一套主题。
- A 端修改主题后，A 端创建和 B 端创建的页面都使用新主题，不要求重新发布页面，原分享链接不变。
- 页面封面是独立图片，不随主题改变。
- 已经打开的页面不要求立即变化；下次打开或刷新时使用最新主题。

---

## 三、PRD 补充任务

### 3.1 B 端 PRD

目标文档：`documents/VISTA_Link_产品需求文档.md`

#### B-PRD-01 登录校验和异常处理

**状态：已写入 B 端 PRD V0.202，并在 V0.213 修正当前范围（2026-08-04）**

- 邮箱作为主要登录账号，新用户只通过邮箱邀请。
- 当前版本只使用已绑定邮箱登录；旧 B 端账号兼容以后正式上线时另行处理，不属于当前 B 端 MVP。
- 登录成功后进入项目选择页；即使只有一个可访问项目也不自动进入。
- 已补充账号和 IP 失败限制、人机验证、陌生设备验证、初始密码修改、项目 IP 检查和登录异常处理规则。

#### B-PRD-02 素材类型和 Widget 选材

**状态：已写入 B 端 PRD V0.203–V0.214（2026-08-04）**

- 已在 §4.2 补充素材目录输入要求、分类、类型、素材单位、结构化信息、更新识别、列表展示和筛选规则。
- 已在 §4.3.4 补充两层选材顺序：Widget 先按允许素材类型及其他自身限制生成候选素材，用户再在候选列表中继续筛选。
- 已明确第一版只提供名称搜索、分类筛选和标签筛选；素材类型不在界面展示或筛选，资料集文件只展示文件类型。
- 已区分 VISTA Building WALK 与室内 WALK，并按真实业务类型处理使用地址打开的素材。
- 已明确分类和类型由素材目录提供方准备，具体技术方案由技术团队确定。
- 已明确同一素材更新后素材库直接展示最新内容并显示更新提示；使用该素材的页面显示「页面素材有更新」。
- 已明确下线或删除素材不在素材库和候选列表中展示；已使用该素材的页面显示对应状态，B 端预览中的已下线内容显示「内容已经下线」。

#### B-PRD-03 页面创建来源与跨端权限

**状态：已写入 B 端 PRD V0.210（2026-08-03）**

- 已在 §4.3.1 明确页面只有一个对象，并以创建来源区分 A 端创建和 B 端创建。
- 已明确 A 端创建的页面在 B 端可使用、预览、分享和复制，但不能直接编辑或删除。
- 已明确复制后生成独立的 B 端创建页面。
- 已写入 B 端对 A 端管理权限的理解，并规定 B 端如何处理 A 端编辑、停用、重新启用和删除产生的结果。
- A 端具体功能仍由 A 端 PRD 补充。

#### B-PRD-04 页面中的 Widget 实例

**状态：已写入 B 端 PRD V0.211（2026-08-03）**

- 已在术语、§4.3.4、§4.3.5 和 §5 明确 B 端只管理页面和页面中的 Widget 实例，不展示或管理 Widget 定义和版本。
- 已明确同一个 Widget 可以按页面使用规则添加多次，每次形成互不影响的实例。
- 已明确复制页面时复制其中的 Widget 实例，复制出的实例与原页面实例相互独立。
- 已明确 Widget 停用后不能再选择，但不影响已经保存的页面实例继续显示。
- 已明确再次编辑或复制包含已停用 Widget 的页面时必须提示并完成更换，否则不能保存；原页面继续正常访问。
- 已明确页头、页脚在每个页面中各固定一个并且不能删除。

#### B-PRD-05 项目主题

**状态：已写入 B 端 PRD V0.212（2026-08-03）**

- 已在术语、§4.3.2、§4.3.4、§4.3.5、§5 和 §7.1 补充项目主题规则。
- 已明确页面不保存独立主题，B 端不提供主题设置、主题选择或页面单独修改主题的入口。
- 已明确 B 端新建、复制、编辑和预览页面时自动使用当前项目主题。
- 已明确项目没有自定义主题时使用 VISTA 默认主题，B 端预览与 C 端客户页面使用同一主题。
- 已明确主题变化不要求重新保存或发布页面，也不改变固定链接和页面封面。

#### B-PRD-06 通读修正

**状态：已写入 B 端 PRD V0.213（2026-08-04）**

- 已明确二维码与无参数固定链接使用相同访问规则，公开链接扫码无需认证。
- 已明确所有客户创建方式均生成内部唯一标识，但客户列表不展示。
- 已删除将客户标签作为 Widget 选材条件的旧规则。
- 已将“系统页面”等旧称呼改为“A 端创建的页面”。
- 已将资料集中的 PDF、图片和视频拆成三种独立素材类型。
- 已补全系统边界和外部依赖中的项目主题、可选 Widget、A 端创建页面和素材目录来源。
- 已将 AI 内容制作和 AI 智能体历史章节移至归档文件，正式 PRD 只保留范围说明和归档链接。

### 3.2 A 端 PRD

正式修改前，需要先找到 A 端当前有效的 PRD，并核对版本。

#### A-PRD-01 素材目录（条件任务）

- A 端当前不管理 B 端素材分类和类型，不要求保存与 B 端相同的分类清单。
- 如果技术方案选择由 A 端承担素材目录提供方，需要另行补充素材标识、分类、类型、状态、来源、更新时间或版本、结构化信息及预览或打开信息。
- 如果由装配后台或独立处理程序承担，该要求不写入 A 端 PRD。

#### A-PRD-02 页面管理权限

- 明确页面保存创建来源：A 端创建或 B 端创建，不增加“平台页面”“销售页面”等页面类型。
- 明确 A 端创建的页面可供 B 端使用、预览、分享和复制，B 端不能直接编辑或删除。
- 明确 A 端可以查看、编辑和删除 B 端创建的页面，也可以停用和重新启用页面的固定链接。
- 原则上 A 端日常只查看；编辑、删除、停用和重新启用用于 B 端请求平台代为处理问题的情况。
- 补充可执行这些操作的 A 端角色、操作入口、确认步骤和操作日志要求。
- 操作结果需要符合 B 端 PRD §4.3.1：编辑不改变页面创建来源、创建人和固定链接地址；停用、重新启用和删除由 B 端按当前状态显示。

#### A-PRD-03 页面封面

- 给 A 端创建的页面新增必填的页面封面字段。
- 补充默认封面、更换默认封面、上传图片、16:9 比例和向 B 端提供封面的规则。
- 明确页面封面与 C 端“项目封面图”是两个对象。

#### A-PRD-04 Widget 登记规则

- 扩充 Widget 登记字段，覆盖 B、C 两端实际需要的规则。
- 补充素材类型、素材数量、同类实例数量、必需规则、删除规则、可编辑内容、显示方式、校验规则、动作和版本。
- 明确不兼容修改需要创建新版本。
- 明确规则缺失时不能把 Widget 设为可用。
- A 端页面编辑器和 B 端一样，只能选择当前可用的 Widget。
- Widget 停用后从 A、B 两端的可选列表中移除，但不影响已经保存的页面实例。
- 再次编辑或复制包含已停用 Widget 的页面时，提示更换并在完成更换前禁止保存；原页面继续正常访问。

#### A-PRD-05 项目主题

- 保留“每个项目同时只有一套正在使用的主题”。
- 项目没有自定义主题时提供 VISTA 默认主题。
- 明确项目主题同时作用于 A 端创建和 B 端创建的页面。
- 向 B、C 两端提供当前项目主题，并保证两端使用相同主题显示页面。
- 明确主题修改不要求页面重新保存或发布，且不改变分享链接和页面封面。

### 3.3 C 端 PRD

正式修改前，需要先找到 C 端当前有效的页面、Widget 和主题 PRD，并核对版本。

#### C-PRD-01 素材分类和类型

- C 端不使用 B 端素材分类和类型，不需要保存相同的分类和类型清单。
- C 端按页面中已经选定的素材和 Widget 规则显示内容。

#### C-PRD-02 页面中的 Widget 实例

- 按页面中已经保存的 Widget 实例显示页面。
- Widget 停用不影响已经保存的页面实例，C 端继续显示原页面内容。
- C 端显示需要与 A、B 两端对同一页面的预览一致。

#### C-PRD-03 项目主题

- 页面不保存独立主题；打开或刷新时读取所属项目的当前主题。
- 项目没有自定义主题时使用 VISTA 默认主题。
- C 端显示必须与 B 端预览一致。
- 主题更新不改变分享链接，也不要求页面重新发布。

#### C-PRD-04 素材更新提示

- C 端每次展示页面时读取页面引用素材的最新内容。
- 页面使用的素材发生更新后，C 端向购房客户提示页面有更新。
- 购房客户确认后，本次更新提示消失。
- 提示出现的判断方式、确认状态保存范围和已下线素材的 C 端显示方式，由 C 端 PRD 继续写清楚。

---

## 四、无需补充的主题

以下两项已经在当前 B 端 PRD 中写清楚。本次只保留确认记录，不重复修改正式 PRD：

1. 客户、链接、页面三者关系。
2. 链接与客户建立关系的时机，以及“关联客户”和“访问客户”的区别。

---

## 五、本次没有继续确认的细节

本次只确认 8 个最外层问题。以下细节不能自行推断，需要在修改正式 PRD 时单独列出：

1. 素材分类和类型的技术代码；用户可见名称和分类对应关系已经写入 B 端 PRD。
2. A 端需要确定哪些角色可以代 B 端处理页面，以及相应的操作入口、确认步骤和操作日志要求。
3. C 端需要确定素材更新提示的判断方式、确认状态保存范围，以及已下线素材在客户页面中的显示方式。
4. A、C 端当前有效 PRD 的文件和版本。

---

## 六、执行顺序

1. 找到并确认 A、C 端当前有效的 PRD 文件和版本。
2. 按本文任务修改 A、B、C 端 PRD。
3. 检查素材目录输入、页面来源、可选 Widget、页面实例和项目主题规则是否互相矛盾。
4. PRD 修改确认后，再按各项目的用例编写规则修改用例。
5. PRD 和用例一致后，才能修改原型。

本文没有指定负责人、完成日期或开发状态；这些内容尚未确认。