# 项目识别组件 PRD

版本：v0.3
状态：当前正式需求

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 建立全量组件目录中的项目识别对象。 |
| 2026-08-03 | v0.2 | 合并旧 PRD / 重大范围确认 | 合并原“项目 Logo 组件”已确认规则；明确本期为项目 Logo 识别，不以文字、跳转或平台品牌补位。 |
| 2026-08-04 | v0.3 | 重大：页面框架规则确认 | 确认所有正常 C端业务页面在页头显示项目 Logo；住户展示页同样保留 Logo，但不因此增加页面导航。 |

## 1. 定义与目标

唯一标识：`project-identity`。用于识别当前项目，当前范围仅承载已发布的项目 Logo；不承担项目介绍、导航、权限判断或跳转。

顾客通过任一 C端页面进入时，可快速确认当前项目；Logo 缺失或失效不应阻断页面业务内容。

## 2. 内容与调用边界

| 内容 | 必需性 | 规则 |
| --- | --- | --- |
| 项目 Logo 素材 | 可选 | 仅使用当前项目已发布的 `project_logo` 素材，保持原始宽高比。 |
| 项目名称 | 必需上下文 | 仅作为 Logo 的可访问名称和当前项目校验；不显示为文字 Logo。 |
| 位置 | 固定 | 所有正常 C端业务页面均在页头显示；住户展示页不因保留 Logo 而增加页面导航。 |
| 尺寸、明暗版本 | 待设计 | 由 VISTA C 页面框架和已发布素材决定，不由组件自行改色。 |

- 仅在页面已通过访问判断后读取和显示；未授权页面不预先显示项目身份。
- 本期 Logo 不可点击，不打开导航、项目概览、官网或大图。
- 不使用 HOMEVISTA Logo、其他项目 Logo 或项目名称文字作为缺失补位。
- 组件不是 Widget，不进入 Widget 注册、排序或内容配置。

## 3. 核心流程与状态

1. 页面确认当前项目和访问权限后，读取项目 Logo 素材。
2. 素材有效且加载成功时显示 Logo；用户操作 Logo 不触发动作。
3. 未配置、未发布、跨项目、格式不支持或运行时加载失败时隐藏组件，不显示破图或空框。
4. 组件隐藏不影响导航、Widget 和项目联系等其他内容继续使用。

| 状态 | 处理 |
| --- | --- |
| 正常 | 保持原始比例显示，提供以项目名称为基础的可访问名称。 |
| 未配置 / 无效 | 隐藏组件；发布侧提示由既有内容校验处理。 |
| 加载失败 | 隐藏组件，不回退为其他品牌或文字。 |

Logo 隐藏时仅移除 Logo 本身；页面头部仍按该页面原有结构保留，不得因运行时加载失败造成内容跳动，也不得连带隐藏页面导航或其他合法控件。

## 4. UI、响应式与设计系统

采用 **VISTA C** 表面。Logo 位于页面头部，项目内容优先于控件；Logo 不遮挡页面主要内容和导航。独立 Logo 的精确尺寸、安全边距和明暗选择尚无完整规格，统一标记为 **待设计系统补充**。

320px、375px、768px、1024px、1440px 下均须保持比例、可识别且不遮挡主要内容；不得因桌面端而新增点击行为。

## 5. 验收

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-IDENTITY-01 | 当前项目有有效 Logo 且页面已获访问许可 | 页面打开 | 仅显示当前项目 Logo，不与 Widget 内容重复。 |
| AC-IDENTITY-02 | Logo 正常显示 | 用户点击、轻触或键盘聚焦 | 不跳转、不打开导航、不呈现可点击反馈。 |
| AC-IDENTITY-03 | Logo 缺失、无效或加载失败 | 页面继续渲染 | 组件隐藏，无破图、项目名称文字或平台品牌补位。 |
| AC-IDENTITY-04 | 任一目标视口 | 页面打开 | Logo 不遮挡主要内容或导航，并保持原始比例。 |
| AC-IDENTITY-05 | 任一正常 C端业务页面已获访问许可 | 页面打开 | 页头显示当前项目 Logo；住户展示页不附加页面导航。 |
| AC-IDENTITY-06 | Logo 在运行时失效 | 页面已完成首屏布局 | 只隐藏 Logo，页头和其他合法控件保持稳定，不出现明显布局跳动。 |

## 6. 明确不做与待确认

- 不做文字名称、区域、项目类型的可配置展示；如未来确需“项目身份信息块”，应新建或扩展组件，不改变本 Logo 组件的降级规则。
- 不做点击 Logo 进入任何项目入口。
- 精确视觉规格待设计系统补充。