# C端通用组件开发清单

版本：v0.7
状态：当前组件定义目录

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 / 重大结构整理 | 从 24 个 C端 Widget 的共性界面与交互中抽取可复用组件，建立独立组件需求目录。 |
| 2026-08-03 | v0.2 | 合并旧 PRD / 重大结构整理 | 合并五份既有 MVP 组件 PRD；新增顾客登录组件，旧文件迁入历史归档，当前目录成为唯一正式组件需求入口。 |
| 2026-08-04 | v0.3 | 重大：沉浸承载边界补充 | 将沉浸内容控制条扩展为统一 iframe 承载与控制组件；WALK / VR 类型仍由空间体验 Widget 决定。 |
| 2026-08-06 | v0.4 | 重大：WALK / VR 组件化 | 删除空间体验 Widget；WALK / VR 作为内容对象内的沉浸组件配置。 |
| 2026-08-06 | v0.5 | 重大：Widget 与组件边界恢复 | WALK、VR 分别作为业务 Widget；本目录只定义二者共用的 iframe 承载与控制组件。 |
| 2026-08-09 | v0.6 | 重大：组件内容来源收敛 | 明确组件仅呈现调用方已定义的内容与正式共享文案；通用内容槽位不得成为页面、Widget、设计或 AI 新增字段的依据。 |
| 2026-08-11 | v0.7 | 重大：WALK / VR 内容组件化 | WALK、VR 不再作为独立 Widget；沉浸内容承载与控制组件直接承载调用方传入的对应内容。 |

组件不独立承担顾客业务任务，必须由 Widget 或页面调用。以下清单不记录任何页面引用关系。

所有组件共同遵循以下内容规则：

- 组件只呈现调用方 PRD 已定义并传入的字段，以及本组件或正式共享规则已固定的状态与操作文案；不得自行生成标题、摘要、标签、说明、事实、营销文案或下一步动作。
- 组件 PRD 中的“可选”只表示组件能够承载该槽位，不代表任何调用方天然拥有该内容。调用方若未定义内容名称、来源和显示条件，该槽位必须隐藏。
- 原型中的示例值只能映射已有字段；`Widget`、`iframe`、优先级、原型说明、实现限制和评审备注不得显示在顾客界面中。
- 内容缺失或无效时按调用方规则隐藏或显示已定义状态，不得用 AI、演示内容、其他项目或旧页面资料补位。

| 组件 | 唯一标识 | 核心职责 |
| --- | --- | --- |
| 项目识别 | `project-identity` | 显示项目 Logo、名称和必要身份信息。 |
| 页面导航 | `page-navigation` | 在已允许访问的范围内提供导航与返回。 |
| 项目联系 | `project-contact` | 提供项目公共联系出口。 |
| 媒体查看器 | `media-viewer` | 查看图片、视频、PDF 等单项资料。 |
| 筛选与结果摘要 | `filter-result-controls` | 选择条件、显示结果数量、清除条件。 |
| 内容对象卡片 | `content-object-card` | 以统一层级展示对象封面、标题、摘要与操作。 |
| 选择器与时间轴 | `context-selector` | 楼层、日期、方案、角度等上下文选择。 |
| 详情面板 | `detail-panel` | 在当前内容上展开对象详情与下一步动作。 |
| 沉浸内容承载与控制 | `immersive-embed-controls` | 承载调用方传入的 WALK、VR 内容，并提供加载、失败、重试、帮助、复位与退出；组件不改变内容类型。 |
| 状态反馈 | `content-state-feedback` | 加载、空、局部失败、整体不可用及重试。 |
| 分享与语言切换 | `share-language-actions` | 共享链接与已发布语言之间的显式切换。 |
| 同意与表单校验 | `consent-form-validation` | 表单必填/格式反馈和隐私同意确认。 |
| 顾客登录 | `customer-login` | 在受限页面内容展示前完成顾客身份验证，并交回上层执行页面授权判断。 |
| 外部内容承载 | `external-content-host` | 承载已批准的外部服务，并提供来源说明、加载失败、重试、退出和返回 C端。 |

精确视觉规格遵循 VISTA C 设计系统；缺失规格须标注“待设计系统补充”，不得由组件 PRD 虚构为既定规范。