# 项目概览页 PRD

版本：v0.13
状态：第一阶段 MVP 页面内容与通用组件范围已确认；响应式原型为设计参考，待视觉定稿与开发

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-07-28 | v0.1 | 初始创建 | 按“页面可分可合”原则创建项目概览页 PRD。 |
| 2026-07-28 | v0.2 | 重大：内容与移动端重写 | 删除重复的页面体系说明，改为以页面 Widget、内容顺序、移动端布局和核心用户用例为主体；现有 VISTA C 首页截图仅作功能证据，不继承其桌面布局。 |
| 2026-07-28 | v0.3 | 重大：导航退出 MVP | 确认本页 MVP 仅通过独立链接交付，不显示导航入口或其他页面入口；未来导航作为通用组件以入口按钮打开全屏内容。 |
| 2026-07-28 | v0.4 | 重大：分享退出 MVP | 确认分享属于未来通用组件；本页 MVP 仅保留独立访问 URL，不显示分享入口，也不验收复制链接、渠道选择、分享预览或追踪。 |
| 2026-07-28 | v0.5 | 重大：国际化退出 MVP | 确认本页 MVP 不显示语言切换入口，仅使用页面实例确定的发布语言；项目名称和介绍不得自动回退到其他语言。 |
| 2026-07-28 | v0.6 | 重大：项目联系组件定稿 | 将原联系页脚改为页尾联系入口；点击后弹窗展示官网、邮箱、电话中的有效项，至少一项有效是本页发布前置。 |
| 2026-07-29 | v0.7 | 重大：单封面范围定稿 | 确认 M-01 在本页只展示一张项目主封面，不提供多图、轮播或画廊。 |
| 2026-07-29 | v0.8 | 重大：封面交互定稿 | 确认封面不可点击，不打开大图或其他页面。 |
| 2026-07-29 | v0.9 | 重大：项目身份字段定稿 | 项目名称、项目标识和开发主体按已发布接口数据展示；项目名称必需，另外两项有值显示、无值隐藏。 |
| 2026-07-29 | v0.10 | 重大：顾客登录与权限进入 MVP | 本页支持公开访问和顾客登录后访问；受限访问先调用登录组件，登录后无本页授权进入 403，页面无效进入 404。 |
| 2026-07-29 | v0.10 | 非重大：原型交付同步 | 已按移动端优先完成本页响应式原型，并覆盖单封面、项目信息、完整介绍和页尾联系入口。 |
| 2026-07-29 | v0.11 | 重大：项目概览内容调整 | 删除项目标识和无业务来源装饰文案；开发主体改称开发商名称；项目 Logo 从 M-01 移出，由页面通用组件单独承载。 |
| 2026-07-29 | v0.12 | 重大：封面与长文本规则调整 | 封面改为保持整图完整显示，失败时使用系统默认底图；项目介绍限定纯文本，溢出时支持可中断、可手动接管的自动滚屏。 |
| 2026-07-29 | v0.13 | 重大：页面 Logo 与导航进入 MVP | 三个 MVP 页面增加独立项目 Logo 组件和“入口按钮＋全屏展开”的导航组件；两者暂不复用，待设计定稿后再评估合并。 |

## 1. 页面目标与范围

项目概览页用于让顾客通过封面图和项目介绍快速理解“这是什么项目、项目给人的核心印象是什么”。MVP 通过本页独立 URL 访问。

本页只有一个业务 Widget：**M-01 项目概览 Widget**。项目 Logo、页面导航和项目联系属于页面通用组件；顾客登录组件属于页面展示前的访问通用组件。它们都不是 Widget，不进入 M-01 内容配置。

项目 Logo 与导航入口在 MVP 中保持为两个独立组件。即使设计稿可能采用接近现有 VISTA 的组合外观，也不得在设计定稿前把点击 Logo 等同于打开导航。

## 2. 页面 Widget 与内容顺序

进入本节内容前先按 [`../05-权限与访问控制规则.md`](../05-权限与访问控制规则.md) 完成访问判断。公开页面匿名直达；受限页面尚未有效登录时调用 [`../03-通用组件体系/13-顾客登录组件PRD.md`](../03-通用组件体系/13-顾客登录组件PRD.md)，登录且确认可以访问本页后才渲染 M-01。

| 顺序 | 页面对象 | 本页使用内容 | 用户动作 | 详细规则来源 |
| --- | --- | --- | --- | --- |
| 页面层 | 项目 Logo 组件 | 有效项目 Logo；缺失或加载失败时隐藏 | 只识别项目，不触发导航或其他动作 | [`../03-通用组件体系/01-项目识别组件PRD.md`](../03-通用组件体系/01-项目识别组件PRD.md) |
| 页面层 | 页面导航组件 | 导航入口按钮、当前页面集合中可访问页面的全屏导航 | 打开/关闭导航，切换到有权访问的同级页面 | [`../03-通用组件体系/02-页面导航组件PRD.md`](../03-通用组件体系/02-页面导航组件PRD.md) |
| 内容层 | 项目概览 Widget | 单张完整封面、项目名称、纯文本介绍；接口有值时显示开发商名称 | 浏览封面并阅读介绍；封面不可点击 | [`../02-Widget体系/Widget需求/01-项目概览Widget-PRD.md`](../02-Widget体系/Widget需求/01-项目概览Widget-PRD.md) |
| 页尾 | 项目联系组件 | 页尾联系入口；弹窗内展示有效的项目公共官网、邮箱、电话 | 打开/关闭弹窗，访问官网、发邮件或拨打电话 | [`../03-通用组件体系/03-项目联系组件PRD.md`](../03-通用组件体系/03-项目联系组件PRD.md) |

页面不得在 M-01 前后插入地图、户型、预约或其他业务 Widget。跨页切换只能由独立页面导航组件提供，不得写入 M-01。

## 3. 移动端优先布局

### 3.1 手机端 320px / 375px

1. 项目 Logo 与导航入口属于页面层组件，不成为封面图片的一部分，也不能遮挡项目名称和主要内容。
2. 封面图是第一业务内容区，优先展示项目视觉，不在图片上叠放长段介绍文字。
3. 封面保持原图宽高比并完整显示；不得为了填满手机屏幕而裁切，可根据图片比例调整内容区高度或留白。
4. 封面不显示大图入口、放大图标或其他可点击反馈。
5. 项目名称、可选开发商名称与纯文本介绍位于封面之后，按设计稿确定的移动端阅读顺序展示。
6. 项目介绍超出设计稿规定的可视区域时可自动滚屏；用户开始触摸、滚动或键盘阅读后立即暂停自动运动并允许手动接管。
7. 项目联系入口位于完整介绍之后；联系方式仅在点击后通过弹窗展示。

### 3.2 PAD / PC 响应式扩展

- 768px、1024px、1440px 的具体单列、并列、留白和组件位置由设计师决定，原型只用于确认信息和交互范围。
- 所有布局必须保持封面整图可见、纯文本可完整阅读、Logo 与导航彼此独立，并保留相同业务动作。
- 不复用现有 VISTA C 首页的全屏建筑图、左侧导航和浮动工具布局。

## 4. 核心用户用例

### UC-OV-01 通过移动端独立链接了解项目

**前置条件：** 页面已发布；M-01 必需内容完整；用户可访问。

**主流程：**

1. 用户在手机中打开项目概览页链接。
2. 看到页面级项目 Logo、导航入口，以及项目封面图和项目名称。
3. 向下滚动阅读项目介绍。
4. 需要联系时继续到页面底部，点击联系入口并在弹窗中选择可用联系方式。

**成功结果：** 用户在单页内完成项目识别和基础理解，不需要先进入其他页面。

### UC-OV-02 封面或部分介绍内容异常

1. 封面图片加载失败时，M-01 显示系统默认底图，项目名称和可用介绍仍可阅读。
2. 开发商名称等可选文字缺失时隐藏对应内容，不生成营销文案补位。
3. 项目身份和最小介绍均不成立时，页面不满足发布条件。

### UC-OV-03 登录后查看受限项目概览

1. 顾客打开不允许未登录访问的项目概览页。
2. 页面在 M-01 渲染前调用顾客登录组件。
3. 顾客登录成功后，C 端校验该顾客对当前页面实例的 B 端授权。
4. 有授权时进入原项目概览页；无授权时进入 403。
5. 页面不存在、未发布、已下线或链接无效时进入 404。

## 5. 页面状态

| 状态 | 页面处理 |
| --- | --- |
| 正常 | 展示 M-01 与页尾联系入口；点击后打开联系方式弹窗。 |
| M-01 局部内容缺失 | 由 M-01 隐藏或降级，不升级为全局错误页。 |
| 项目 Logo 缺失或加载失败 | 隐藏项目 Logo 组件，不以 HOMEVISTA 品牌或文字项目名冒充 Logo；不影响 M-01。 |
| 当前页面没有其他可访问页面 | 隐藏导航入口；本页仍按独立页面使用。 |
| M-01 不可启用 | 阻止页面发布，不显示空项目介绍页。 |
| 官网、邮箱、电话全部缺失或无效 | 不满足发布条件，阻止页面发布。 |
| 受限页面尚未有效登录 | 调用顾客登录组件；不渲染 M-01 或联系方式。 |
| 已登录但无本页授权 | 进入统一 403。 |
| 项目/页面不存在、未发布、已下线或链接失效 | 进入统一 404。 |

## 6. 验收标准

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-OV-01 | 页面在 320px、375px 打开 | 用户首次浏览 | 项目 Logo、导航入口、封面、名称和介绍均不依赖横向页面滚动；封面完整可见。 |
| AC-OV-02 | 介绍文字较长且超出可视区域 | 自动滚屏启动或用户手动阅读 | 全文可达；用户操作会暂停自动滚屏，减少动态效果偏好下不自动运动。 |
| AC-OV-03 | 当前页面集合包含其他已发布且顾客有权访问的页面 | 用户点击导航入口 | 全屏导航打开，只展示可访问的同级页面；关闭后恢复当前页面状态。 |
| AC-OV-04 | 封面加载失败 | 文字内容可用 | 显示系统默认底图；用户仍可识别项目并阅读介绍，页面不跳 404。 |
| AC-OV-05 | PAD/PC 打开 | 宽度增加 | 由设计稿调整布局；封面不裁切，内容和动作不增加设备专属差异。 |
| AC-OV-06 | 用户查看 M-01 内容区 | 完成浏览 | M-01 内不出现地图、户型、预约或价格入口；跨页切换仅存在于独立页面导航组件。 |
| AC-OV-07 | 页面实例指定一种发布语言 | 用户浏览项目内容 | 项目名称、介绍和组件文案使用同一语言，不自动混入其他语言。 |
| AC-OV-08 | 页面正常发布且联系方式有效 | 用户点击页尾联系入口 | 弹窗打开并只展示有效的官网、邮箱、电话项。 |
| AC-OV-09 | M-01 已选择主封面 | 用户浏览或点击封面 | 只显示一张封面；点击无动作且不出现可点击反馈。 |
| AC-OV-10 | 接口返回或缺失开发商名称 | 页面渲染 | 项目名称正常显示；开发商名称有值显示、无值隐藏；不显示项目标识字段。 |
| AC-OV-11 | 本页允许未登录访问 | 匿名顾客打开 | 直接进入 M-01，不出现登录组件。 |
| AC-OV-12 | 本页不允许未登录访问且顾客尚未登录 | 打开链接 | 先显示登录组件，项目名称、封面、介绍和联系方式均不泄露。 |
| AC-OV-13 | 顾客登录成功 | 完成当前页面授权校验 | 有授权进入原页面；无授权进入 403。 |
| AC-OV-14 | 项目 Logo 有效 | 页面正常渲染 | Logo 由页面通用组件独立显示，点击无动作，不覆盖在 M-01 封面内部。 |
| AC-OV-15 | 项目 Logo 缺失或加载失败 | 页面正常渲染 | Logo 组件隐藏，不使用 HOMEVISTA 标识代替，M-01 与导航仍可用。 |
| AC-OV-16 | 当前页面没有其他可访问页面 | 页面正常渲染 | 导航入口隐藏，页面仍可独立完成项目认知任务。 |

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

**明确不做：** 项目标识字段、Logo 与导航入口复用、把项目概览定义为固定首页、多图、轮播、画廊、封面裁切、封面大图查看、分享入口、语言切换入口、自动翻译、复制链接、渠道面板、预约 CTA、在 M-01 内嵌户型/地图内容、视频背景、顾客注册/找回密码、401 及 5xx 状态页、照搬旧 VISTA 首页桌面布局和数据埋点。

**待确认：**

- 导航所使用的页面集合由哪个既有 B 端发布对象提供，需在技术方案中映射，但不得改变本 PRD 的页面同级与权限过滤规则。
- 项目 Logo 的最终位置、尺寸、明暗版本，以及自动滚屏的可视高度、速度和提示方式待设计稿确定。

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

- 页面结构以本 PRD 为准；M-01 的内容、功能和局部状态以对应 Widget PRD 为准。
- 不得把现有 `01-首页-主界面.jpg` 的桌面导航和全屏构图当作新页面布局。
- 页面必须分别挂载项目 Logo 组件和导航组件；设计定稿前不得把 Logo 点击行为绑定为导航入口。
- 导航只切换同一页面集合中的同级页面，不得生成首页/二级页关系，也不得展示顾客无权访问的页面。
- MVP 原型不显示分享占位；未来只允许挂载通用分享组件，不改变 M-01。
- MVP 原型不显示语言切换占位；M-01 只消费页面传入的一种发布语言。
- 受限页面不得先渲染 M-01 再以半透明登录弹窗遮挡；登录和授权通过前不输出项目内容。
- 原型必须先完成 320px、375px，再扩展至 768px、1024px、1440px。