# 项目概览 Widget PRD

版本：v0.4
优先级：P0  
状态：已完成产品定义，待原型与实现验收

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 / 重大重构 | 按 C端 Widget 产品需求定义规范重写项目概览；明确其为项目身份与价值信息的独立内容对象，不记录页面引用关系。 |
| 2026-08-03 | v0.2 | 验收补充 | 根据 DeepSeek PM 评审，将移动端完成核心阅读与后续动作纳入明确验收项。 |
| 2026-08-09 | v0.3 | 重大：补充信息字段收敛 | 将“开发主体/竣工等补充信息”收敛为可选开发商名称；明确不得增加其他项目事实或装饰性展示文案。 |
| 2026-08-11 | v0.4 | 重大：项目概览字段调整 | 顾客可见内容调整为封面图、项目简介、项目地址和开发商名称；不展示项目名称、区域摘要、卖点或后续内容入口。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 项目概览 |
| 唯一标识 | `project-overview` |
| 分类 | 项目基础 |
| 一句话介绍 | 以项目封面、简介、地址和开发商名称，帮助首次到访顾客快速了解项目。 |
| 封面图 | 项目主视觉或建筑外观；须为已发布素材。客户要求完整显示时必须支持不裁切。 |
| 设计图 | 可附界面设计示意，示例数据须标注“设计示意”。 |

## 2. 目标与场景

目标顾客为首次了解项目、或从分享链接再次确认项目基本信息的潜在购房顾客。

适用于需要先建立项目认知的 C 端内容区域或项目入口。顾客的核心任务是阅读项目封面、项目简介、项目地址和开发商名称。完成结果是顾客获得这些基础信息；本 Widget 不提供后续内容跳转或转化动作。

## 3. 内容与数据

| 内容 | 必需性 | 内容来源与选择 | 有效条件 |
| --- | --- | --- | --- |
| 项目主视觉 | 必需 | 项目已发布媒体库中选择一项 | 素材可访问且满足最小清晰度。 |
| 核心介绍 | 必需 | 项目介绍文案 | 当前语言有完整正文。 |
| 项目地址 | 可选 | 项目位置资料中的公开地址 | 当前语言有顾客可读地址；缺失时隐藏字段名称、分隔符和留白。 |
| 开发商名称 | 可选 | 项目基础资料中的开发商名称 | 当前语言已发布；缺失时隐藏字段名称、分隔符和留白。 |

内容只消费当前项目、当前语言下已公开的资料；字段缺失不得以其他项目、其他语言或演示文案补齐。

以上表格是顾客可见内容白名单。Widget 不展示项目名称、区域摘要、卖点、楼盘用途、户数、交付时间等其他项目事实，也不增加营销口号、第二层标题、英文栏目名、章节编号、实现说明或评审说明。通用内容卡片和页面容器提供的可选槽位不能扩大本表。

## 4. 使用与配置

| 配置项 | 规则 |
| --- | --- |
| 内容选择 | 主视觉与介绍可选择；项目地址和开发商名称固定取项目已发布基础资料。 |
| 展示形式 | 支持“完整介绍”与“摘要介绍”两种形式；缺失或非法值时默认完整介绍。 |
| 无效内容 | 必需内容不完整时，Widget 整体不启用；可选内容失效仅隐藏对应内容。 |

## 5. C端 UI 与交互

内容层级为：主视觉 → 核心介绍 → 项目地址与开发商名称。摘要介绍在移动端仅折叠过长正文，并提供“展开/收起”。封面可采用铺满展示；客户要求完整显示时，设计方案必须支持不裁切，具体布局、留白和适配方式由设计确定。

顾客可展开或收起介绍。图片加载失败时保留文字内容并显示通用媒体占位；地址或开发商名称失效时隐藏单项；封面或介绍不可用时以 Widget 级空状态提示“项目介绍暂未发布”。窄屏为单列；使用 VISTA C 的内容卡片与媒体查看规则，精确动效规格待设计系统补充。

## 6. 用户用例与验收

**UC-01 初次了解项目**：顾客进入承载该 Widget 的 C 端内容，读取主视觉、介绍、项目地址与开发商名称。

**UC-02 阅读完整介绍**：顾客展开介绍；地址或开发商名称缺失时，仍能完成对项目介绍的理解。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 已发布的主视觉和介绍均可见，且来自同一项目及当前语言；地址和开发商名称仅在有效时显示。 |
| AC-02 | 摘要介绍可完整展开/收起；无截断后无法获取的正文。 |
| AC-03 | 项目地址或开发商名称失效不导致其余有效内容消失，且缺失项不保留标签、分隔符或空白。 |
| AC-04 | 必需内容不完整时不显示残缺卡片，呈现明确的 Widget 级暂不可用状态。 |
| AC-05 | 客户要求完整显示封面图时，封面可不裁切地展示。 |
| AC-06 | 移动端可完成项目基础信息阅读和介绍展开/收起，无需横向滚动页面。 |
| AC-07 | 顾客界面只出现本 PRD 白名单内的内容及已定义操作，不出现无来源的营销、装饰、实现或评审文案。 |