# 项目 Logo 组件 PRD

版本：v0.1
状态：第一阶段 MVP 范围已确认；视觉位置与规格待设计定稿
组件标识：C-COM-04

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-07-29 | v0.1 | 初始创建 / 重大范围确认 | 将项目 Logo 从 M-01 项目概览 Widget 中拆出，定义为三个 MVP 页面复用的页面通用组件；确认与导航入口暂时分离，缺失或加载失败时隐藏。 |

## 1. 文档目的与适用对象

本文档用于产品、设计、开发、测试及 Codex 统一实现 C 端项目 Logo 的页面级复用规则。

适用页面：

- 项目概览页
- 周边地图页
- 户型列表页

项目 Logo 是页面通用组件，不是 Widget，不进入 A 端 Widget 注册、排序或 M-01 内容配置。

## 2. 产品目标与对象边界

项目 Logo 用于让顾客快速识别当前房地产项目。它表达项目身份，不表达 HOMEVISTA 平台品牌，也不承担页面导航。

MVP 边界：

1. 项目 Logo 与导航入口是两个独立组件。
2. 项目 Logo 默认不可点击，不打开导航、官网、大图或其他页面。
3. 设计定稿后可再次评估是否让 Logo 与导航入口形成组合外观或复用入口，但在正式变更前不得实现。
4. M-01 不重复显示 Logo，也不在封面图内部叠加 Logo。

## 3. MVP 范围

### 3.1 包含

- 读取当前项目已发布的项目 Logo 素材。
- 在三个 MVP 页面以一致规则显示。
- 保持 Logo 原始宽高比。
- 为图片提供以项目名称为基础的可访问名称。
- 素材缺失、失效或运行时加载失败时隐藏组件。
- 响应手机、PAD、PC，但具体位置、尺寸和明暗版本由设计稿确定。

### 3.2 明确不做

- 点击 Logo 打开导航。
- 点击 Logo 跳转项目概览页或固定首页。
- 使用 HOMEVISTA Logo 代替项目 Logo。
- 使用项目名称文字临时绘制或伪造 Logo。
- 在 A 端 Widget 列表中启停、排序或重复添加。
- Logo 上传、裁切和版本管理界面。
- Logo 动画、埋点、分享和外链。

## 4. 用户用例

### UC-LOGO-01 识别当前项目

1. 顾客通过任一 MVP 页面链接进入页面。
2. 页面权限通过后读取当前项目 Logo。
3. Logo 有效时按设计稿显示，顾客可识别当前项目。
4. 顾客点击或轻触 Logo时不发生跳转或弹窗。

### UC-LOGO-02 Logo 不可用

1. 项目未配置 Logo，或素材无效、未发布、加载失败。
2. 页面隐藏 Logo 组件，不保留破图、空框或不可点击占位。
3. 页面 Widget、导航和联系组件继续正常使用。
4. 页面不得使用 HOMEVISTA 品牌或文字项目名冒充项目 Logo。

## 5. 内容与显示规则

| 内容 | 必需性 | 来源 | 规则 |
| --- | --- | --- | --- |
| 项目 Logo 素材 | 可选 | `project.identity.logo_asset_id` | 只使用当前项目已发布的 `project_logo` 素材；不跨项目回退。 |
| 项目名称 | 必需上下文 | `project.identity.name` | 仅用于可访问名称和当前项目校验，不由组件显示成文字 Logo。 |
| 明暗版本 | 待设计/素材规则补充 | 项目素材与页面背景 | MVP 不由前端自动改色 SVG；具体选择规则待设计定稿。 |

VISTA C 设计系统目前规定导航中存在品牌 Logo，但没有给出“同级独立页面中的项目 Logo 组件”完整位置、尺寸和明暗切换规则，相关视觉规格标记为 **待设计系统补充**。原型仅验证组件独立存在和响应式不遮挡内容。

## 6. 状态

| 状态 | 触发 | 处理 |
| --- | --- | --- |
| 正常 | Logo 素材有效且加载成功 | 保持宽高比显示，不可点击。 |
| 未配置 | `logo_asset_id` 为空 | 隐藏组件。 |
| 素材无效 | 跨项目、未发布、格式不支持 | 发布校验提示；C 端不显示。 |
| 运行时失败 | 图片请求失败 | 隐藏组件，不显示破图或替代品牌。 |

## 7. 验收标准

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-LOGO-01 | 当前项目有有效 Logo | 打开任一 MVP 页面 | Logo 由 C-COM-04 独立显示，M-01 内不重复显示。 |
| AC-LOGO-02 | Logo 正常显示 | 用户点击、轻触或键盘聚焦 | 不打开导航、不跳转、不显示可点击反馈。 |
| AC-LOGO-03 | Logo 缺失或加载失败 | 页面继续渲染 | 组件隐藏；Widget、导航和联系组件仍可用。 |
| AC-LOGO-04 | 检查 Logo 来源 | 页面渲染 | 不使用 HOMEVISTA Logo、其他项目 Logo 或文字项目名补位。 |
| AC-LOGO-05 | 320px、375px、768px、1024px、1440px | 页面打开 | Logo 不遮挡主要内容和导航入口，保持原始宽高比。 |

## 8. 待确认事项

- 项目 Logo 在不同页面和视口中的位置、最大尺寸、安全边距及明暗版本选择，待设计稿确定。
- 设计定稿后是否将 Logo 与导航入口组合或复用，需另行作为重大需求变更确认。

## 9. 供 Codex 使用的执行说明

- 不得把项目 Logo 重新放进 M-01。
- 不得因现有 VISTA 把品牌与菜单放在同一容器，就擅自合并本组件与导航组件。
- 原型中的文字或临时图形只可作为组件位置占位，不得当作正式项目 Logo 素材。