# A端项目演示方案配置 PRD

版本：v0.1  
日期：2026-09-15  
状态：已确认核心业务规则；技术接入与C端专项未决见第11节  
适用对象：产品、运营、设计、开发、测试；配置界面采用VISTA B

## 修订记录

| 日期 | 版本 | 类型 | 摘要 |
| --- | --- | --- | --- |
| 2026-09-15 | v0.1 | 初始创建 | 新增项目内自由访问页面必填、演示方案选填，以及A端页面一对一引用、名称目录复用、添加移除排序与保存生效规则。 |
| 2026-09-15 | v0.1 | 重大：员工访问与页面状态 | 员工按登录、项目权限与有效期访问，不依赖顾客固定链接；停用隐藏保留关联、恢复原排序、删除不恢复，移除不改变页面和顾客链接。 |
| 2026-09-15 | v0.1 | 重大：快速切换方案 | C端可快速切换包括自由访问在内的方案；切换目标页面及对应交互模式，撤回同一方案仅切自由／演示模式的口径，不强制返回选择页。 |

## 1. 目的、背景与目标

项目往往制作多份页面，用于不同销售讲解场景。运营需要从已制作页面中选出现场使用的方案，销售根据接待需要选择和快速切换，避免把所有页面都当成演示方案。

每个项目有一份必填的自由访问页面，以及零个或多个可选演示方案。自由访问用于自主浏览，演示方案用于按准备的内容顺序讲解。

本需求是项目内部配置，原《06-A端演示列表管理PRD》撤回的项目清单、企业绑定、项目独占与项目清单上下线不恢复。

## 2. 范围与不做

本期：项目内配置入口、指定自由访问页面、添加/移除/排序演示方案、读取名称及目录、保存、失效提示和前台快速切换规则。

不做：在本模块创建或编辑页面内容；B端创建页面加入本列表；重新配置目录、多语名称或方案封面；自动加入所有页面；按顾客裁剪现场方案；顾客链接管理；列表发布快照及历史版本；恢复已删除页面。

原型交付范围为A端配置及“销售选择联动预览”，验证实际选择目标、模式及目录。不替代真实C端Widget播放器、员工登录接入、顾客分享系统或全部P02视觉与动效实现。

关联：现有[03-A端项目页面管理PRD](03-A端项目页面管理PRD.md)管理页面制作与状态；C端[对象模型](../c-reconstruction/01-C端对象模型与页面配置规则.md)、[模式规则](../c-reconstruction/02-C端演示与自由模式全局规则.md)、[P02](../c-reconstruction/页面需求/P02-项目演示方案选择页.md)、[C04](../c-reconstruction/组件需求/C04-演示控制与Widget切换转场.md)消费本配置。

## 3. 用户与核心用例

| 用例 | 目标、前提与操作 | 结果和边界 |
| --- | --- | --- |
| UC01 配置基本访问 | A端有当前项目页面管理权限；进入演示方案配置，指定一份已启用A端页面作为自由访问页面，保存 | 可以不添加演示方案；未指定有效自由页面不能保存 |
| UC02 编排讲解方案 | 同项目已有多份页面；添加适合讲解的页面、调整顺序，保存 | 仅选中的页面进入演示列表；不修改源页面内容 |
| UC03 移除方案 | 编辑列表，移除一项，保存 | 只解除演示关联；源页面、自由访问引用及原顾客链接不因此变化 |
| UC04 页面不可用 | 已关联页面停用、恢复或删除 | 停用后前台隐藏，A端保留原因与位置；恢复原页后按原位置重现；删除页不可恢复 |
| UC05 现场快速切换 | 员工有项目权限；从演示方案A快速选择方案B或自由访问 | 当前目标页面、名称、目录及交互模式对应新选择，不需返回后台或强制回P02 |
| UC06 无权或保存失败 | 没有项目操作权限，或保存发生失败/冲突 | 无权不允许配置；失败不冒充成功、不覆盖原有效结果，当前编辑输入保留 |

## 4. 对象与功能矩阵

| 对象 | 产品含义 |
| --- | --- |
| 页面实例 | A端已制作并保存的独立页面，包含页面名称、多语言、Widget实例内容及顺序 |
| 演示方案 | 列表中的一项，一对一引用一个当前项目的A端页面实例；不复制内容 |
| 自由访问项 | 当前项目的一项固定用途配置，必填一个页面，进入后使用自由交互 |
| 快速切换 | 销售从当前项目的有效方案和自由访问项中选择另一个入口；不是把当前方案原地切模式 |

| 功能 | 用例 | 优先级 | 规则 |
| --- | --- | --- | --- |
| F01 自由访问页面 | UC01 | 本期必需 | R01、R02 |
| F02 方案编排 | UC02、UC03 | 本期必需 | R03、R04 |
| F03 目录与名称 | UC02、UC05 | 本期必需 | R05 |
| F04 保存与状态 | UC04、UC06 | 本期必需 | R06、R07、R10 |
| F05 销售进入与快速切换 | UC05 | 本期必需 | R08、R09 |

## 5. 功能与业务规则

### R01 项目与配置入口

从A端项目管理的目标项目行进入“演示方案配置”，显示当前项目名称、VISTA URL及VISTA ID。每个项目只维护一份配置，包含自由访问页面和有序演示方案列表。候选、已选及保存结果均限定当前项目。

配置操作沿用当前项目页面管理权限，不新建角色。未选项目先返回项目管理；无操作权限不允许读取受限内容或提交变更。切换项目不能沿用前一项目未保存配置。

### R02 必填自由访问页面

必须指定且只能指定一个当前项目已启用的A端页面作为自由访问页面。不能保存未选择、已停用、已删除或跨项目的自由访问目标；没有可选页面时提示先在页面管理中制作并启用页面。

“默认配置”指项目必须具备这一用途的页面，不代表首次进入自动跳过P02或自动选中自由项。自由访问项固定在演示方案之后，不参加演示列表排序。自由访问页面可以同时被演示方案引用，两种入口仍分别识别，不能因引用同一页面而合并入口。

### R03 选填演示方案

演示方案可为零个或多个；通过添加页面选择器，从当前项目、A端来源、已启用且尚未加入列表的页面中选择。页面默认不自动加入；同一页面在演示方案列表内只能出现一次。B端来源页面即使A端可代处理，也不在候选范围内。

选择器显示页面名称、页面编号及模块数量，支持按名称或编号搜索和多选；取消选择不改变列表，确认后按选择器中的原顺序追加到末尾，可再排序。没有匹配结果时提示调整搜索，没有候选时提示没有可添加页面。

### R04 排序与移除

列表显示序号、页面名称、页面编号、页面状态和操作；通过上移/下移调整相邻顺序，首项上移、末项下移不可操作。保存后的顺序用于前台展示，不按名称、创建时间或项目列表顺序重排。

移除仅从本次编辑列表中解除关联，保存后生效，不停用、不删除源页面，不修改自由访问引用或顾客链接。页面仍有效时可重新添加，作为末项；这不是恢复历史版本。

### R05 名称、目录与内容同步

方案名称读取页面的当前多语言名称，不设独立别名。左侧目录按该页面保存的Widget实例顺序读取各实例展示名称；同类型重复实例保留为不同条目，不按类型合并。方案名称、目录和进入目标必须一致。

页面内容不复制到列表。源页面保存成功后，列表和进入内容在下次读取时使用最新保存结果；尚未保存的编辑不得展示为有效内容。同名页面按页面身份区分，不合并；A端显示编号辅助识别。

自由项在选择入口标为“自由访问”，其引用页面名称在A端展示；不允许用名字中含“自由”判断模式。进入自由项后的内容取指定页面，不拼接所有演示方案，不以第一套方案兜底。

### R06 保存

列表及自由页面的修改需点击“保存配置”才生效；页面制作本身继续由页面管理单独保存。保存前检查R01—R03的项目、来源、权限、必填及重复条件；新添加演示页若在保存前失效，提示移除或重新选择。原已保存列表中的失效引用可保留，以满足R07恢复位置规则。

保存成功后后续读取使用同一份新配置，不出现新自由目标配旧列表的部分保存结果。没有修改时不重复保存。保存失败保留当前输入，旧有效配置不变化；多人保存冲突不得覆盖较新结果，提示重新载入后确认，未保存输入仍保留于当前编辑会话。离开有未保存修改的配置页时，确认放弃或继续编辑。

### R07 引用页面失效

演示页被停用：从销售可选列表隐藏，后台保留关联、原排序和已停用提示；原页重新启用后恢复原位置。页面被删除：销售不可进入，后台显示已删除引用并允许移除，不展示已删除内容，不因同名新页面恢复关联。

自由页面必填是配置保存门槛，不阻止已有页面管理执行停用/删除。已保存的自由页面之后失效时，后台提示需更换有效页面；前台自由项保留不可进入提示，不自动替换为其他页面。若演示方案仍有效可照常选择；全部入口不可用时显示“暂无可用演示内容”，不展示其他项目内容。

页面状态仍在进入目标时核对，不因入口列表尚未刷新而允许进入失效页。已经加载在浏览器中的内容如何即时中断由技术接入及C端状态专项确定，本需求不承诺远程清屏。

### R08 员工访问

方案选择、快速切换及目标内容仅向有有效B端员工登录、当前项目管理权、项目未过期的员工开放；不另限销售岗位。直达入口也须核对上述条件、页面启用状态以及目标仍属于该项目配置。不能通过自填页面编号或模式获得额外访问范围。

员工演示和自由访问不依赖顾客固定链接的公开、认证或启停状态。顾客链接停用不阻断具备上述条件的员工访问；源页面停用仍阻断。顾客无项目方案列表及快速切换入口，不能通过修改入口信息获得员工能力。现有项目有效期的具体边界与缺值问题仍由P01待确认项收口，不在此重定义。

### R09 进入与快速切换

从演示方案入口进入该方案引用页面，使用演示交互；从自由访问入口进入指定自由页面，使用自由交互。演示交互按当前页面Widget顺序讲解，自由交互通过导航选择该页面内容。

进入内容后，员工仍可快速选择当前项目的其他有效演示方案或自由访问项，不必返回后台，也不强制返回P02。切换后目标页面、名称、目录和交互模式作为同一个结果更新；不能显示B方案标题却播放A内容。

不提供“保持当前演示方案页面，只把它改成自由模式”的独立操作。即使两个入口恰好引用同一页面，也按不同入口处理。快速切换不修改任何页面或列表配置，不新建页面，不将两份页面内容合并。重新进入某方案的浏览进度、筛选和Widget内部状态恢复不在本需求内承诺。

### R10 预览与异常表达

A端提供已保存配置的“销售选择联动预览”，用于核对入口、名称、目录、目标页面和模式。未保存修改不能冒充已保存结果；界面明确预览使用已保存配置。预览提供名称语言选择，可快速选择方案与自由项，展示目标页面对应语言的目录和只读交互说明，不模拟真实Widget播放器或前后翻页。

预览保留不可用自由入口，隐藏停用演示项；已删除内容不展示。只有自由页时可单独预览，不要求至少一套演示方案。加载失败与没有配置分开提示；发生请求失败时采用短暂提示，权限失败不能表现为正常空列表。真实权限、网络及并发校验属于接入验证，静态预览不能证明这些能力通过。

## 6. 页面结构与交互状态

配置页面依次为：项目标题和返回项目管理、当前项目识别信息、必填自由访问选择区、选填演示方案表格、保存结果及操作区。

自由区显示所选页面名称、编号、状态和查看目录；替换通过单选已有页面完成。方案表格提供添加、目录、上移、下移、移除。目录只读，不提供局部改名和排序。添加选择器与目录查看使用对话框，复用现有后台组件。

| 状态 | 表现及操作 |
| --- | --- |
| 未配置 | 自由目标为空，显示必填提示；演示列表空；不能保存 |
| 仅自由页 | 可保存并预览，自由入口有效，不补造演示项 |
| 有演示方案 | 可排序移除、查看目录；计数区分已配置与前台可用数量 |
| 引用停用/删除 | A端显示状态与原因，按R07处理；不伪装正常 |
| 未保存 | 明示未保存修改，预览仍读取已保存配置 |
| 保存成功/失败 | 成功提示并更新保存时间；失败保留输入，按R06处理 |

设计系统：A端使用VISTA B的Table、Select、Checkbox、Dialog、Button、Tag与Empty语义。项目现有原型采用React封装，复用现有组件，不引入Vue/Element Plus重构。正式实现按设计系统采用对应组件。新增空态复用设计系统空态素材。

联动预览为A端核对工具，使用VISTA B对话框；不把它当作VISTA C最终画面。C端快速方案切换控件最终位置、触摸布局及转场为“待设计系统补充”，本次不虚构Figma已覆盖这些状态。

## 7. 验收标准

| AC | 前提与操作 | 预期结果 | 正文依据 |
| --- | --- | --- | --- |
| S-AC01 | 在某项目进入配置 | 显示该项目识别信息；不混入其他项目页面 | R01 |
| S-AC02 | 未选择或选择失效自由页后保存 | 阻止保存并提示有效自由页面必填 | R02、R06 |
| S-AC03 | 只指定有效自由页、演示列表为空后保存 | 保存成功；前台只有有效自由入口 | R02、R03、R10 |
| S-AC04 | 打开添加选择器 | 只显示当前项目A端已启用且未加入页面；不含B端、跨项目及失效页面 | R03 |
| S-AC05 | 搜索、选择多页并确认/取消 | 搜索按名称编号匹配；确认追加末尾，取消不改列表；不能重复加入 | R03 |
| S-AC06 | 上移/下移并保存 | 顺序保持；首项上移及末项下移不可用 | R04 |
| S-AC07 | 移除某演示项并保存 | 只解除该关联，不改变源页面、自由引用及顾客链接；可重新添加有效页面 | R04 |
| S-AC08 | 查看名称与含重复Widget类型的目录 | 名称沿用页面多语；目录使用各实例名称和原顺序，不合并 | R05 |
| S-AC09 | 分别保存源页面内容或保留源页面未保存编辑后重新读取 | 已保存更新可见，源页面未保存内容不进入有效方案；目标、名称和目录一致 | R05 |
| S-AC10 | 停用并重新启用已关联演示页 | 停用时销售隐藏、A端保留位置；恢复后原位置重现 | R07 |
| S-AC11 | 删除关联页面，再建同名页面 | 旧引用不可进入、不可恢复；A端可移除且不展示已删除内容 | R07 |
| S-AC12 | 已保存自由页后续失效 | 提示更换；自由项不可进入、不替代；其他有效演示可选；自由页及全部演示页均不可用时提示暂无内容 | R07 |
| S-AC13 | 配置修改尚未保存时预览 | 读取已保存配置，明确显示预览口径 | R06、R10 |
| S-AC14 | 保存失败或提交冲突 | 不覆盖旧有效/较新结果；保留输入并提示处理 | R06 |
| S-AC15 | 合法员工且顾客链接停用，访问有效已配置页面 | 员工仍可进入；页面自身停用后不可进入 | R08 |
| S-AC16 | 顾客、无项目权限者或篡改目标直达 | 不取得受限方案或内容，直达仍执行访问校验 | R01、R08 |
| S-AC17 | 从演示项/自由项分别进入 | 打开各自指定页面和对应交互模式；自由目标不取方案并集或首项 | R05、R09 |
| S-AC18 | 已进入后快速从A切B再切自由项 | 不要求回P02；目标、名称、目录、交互共同切换；不改源配置、不新增页面 | R09 |
| S-AC19 | 自由项和演示项引用同一页 | 两入口仍独立识别；各按入口交互，不提供原地模式开关 | R02、R09 |
| S-AC20 | 添加选择器无候选或无搜索匹配 | 分别提示没有可添加页面或调整搜索 | R03 |
| S-AC21 | 离开有未保存修改的配置页 | 可放弃离开或继续编辑，不静默丢弃 | R06 |
| S-AC22 | 联动预览请求加载失败 | 短暂提示失败，不冒充没有配置 | R10 |

这些AC是需求核对项；静态原型只验证可演示部分，真实权限、并发和网络失败需研发接入后验证，不能宣布线上验收完成。

## 8. 实现参考信息（非业务规则来源）

建议只保存“项目、自由页引用、有序演示页引用、最近修改信息”。不在列表保存页面副本、多语副本或目录副本。保存时对目标范围和编辑冲突做统一校验。

运行时由已授权配置解析“入口类型＋目标页面”：自由入口解析为自由页和自由交互；演示入口解析为列表中对应页和演示交互。模式取已校验入口，不相信任意传入的模式字段。即使页面相同，入口身份也不同。

快速切换应准备完整目标上下文后共同更新标题、内容和控制；防止较早请求返回后覆盖较新选择。页面刷新应能恢复并重新校验入口身份，而不是仅凭页面编号猜模式。具体路由、并发处理、状态保存以及与Widget加载器的对接，由研发技术方案落实；不得改变R08访问边界。

## 9. 示例与原型执行说明

使用独立标记为“方案配置 DEMO”的模拟项目及模拟页面，验证全量自由页、两套不同目录演示页、停用页、B端页和未入选页。示例内容、数量、排序不是生产默认配置。原型数据仅保存在浏览器，不写远端项目。

联动预览选择的是方案，不模拟Widget内部操作；不以预览的排版定义C端最终UI，不承诺方案切换后的播放起点或进度恢复。不得将此页面命名为“切换模式”。

## 10. 交付与评审

先记录正文和AC，再执行DeepSeek pm交付评审；Codex核对每条依据及建议取舍。完成A端原型后双向核对文档与可见行为，执行pnpm build、产物及UTF-8检查、浏览器交互与视觉检查。

原型生成不等于正式产品上线，不自动部署。

## 11. 依赖与未决边界

- C端快速切换后是否恢复各方案浏览进度、控件最终位置、Widget内部状态、请求失败后的恢复方式，仍由P02/C04及设计专项收口；本A端配置与联动预览不实施这些未决行为。
- 员工登录、项目有效期边界及内容入口真实权限由研发接入验证；本次不重写P01有效期未决规则。
- 源自由页后续失效可保存其他变更前必须重新指定有效页；不新增阻止源页面删除的业务锁定。
- 已确认范围包括快速切换方案能力，不包括完整C端播放器实现。交付原型只证明配置和目标联动；必须在评审记录列出未实测AC，不能当作全量产品验收通过。