# 项目概览页 PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 以项目概览为主承载建立项目认知页面。 |
| 2026-08-03 | v0.2 | 入口与不可用状态补充 | 补充页面进入/离开结果及项目概览不可用时的页面保留内容。 |
| 2026-08-03 | v0.3 | 合并旧 PRD / 重大范围确认 | 合并旧项目概览页的独立访问、内容顺序、页面状态与验收；取消未确认的固定跨页入口，跨页切换统一由页面导航承担。 |
| 2026-08-09 | v0.4 | 重大：页面内容来源收敛 | 将主内容限定为项目概览 Widget 已定义字段，禁止页面增加营销标题、英文栏目名、章节编号和项目补充事实。 |
| 2026-08-11 | v0.5 | 重大：项目概览字段同步 | 主内容限定为封面图、项目简介、项目地址和开发商名称；移除项目名称、区域、卖点及固定后续入口。 |

## 1. 目标与用户用例

顾客通过独立分享链接进入后，阅读项目封面、简介、项目地址和开发商名称；如需切换其他已发布页面，可通过页面导航进入。用户用例：独立进入 → 阅读项目内容 → 打开页面导航或结束浏览。

本页不以“首页”身份要求顾客从此进入，也不把户型、周边、预约等其他页面入口固定写入本页内容。

## 2. 页面内容与边界

| 层级 | 承载内容 | 页面规则 |
| --- | --- | --- |
| 页面框架 | 项目识别、页面导航、状态反馈 | 仅在访问许可后显示；导航只列出同级可访问页面。 |
| 主内容 | 项目概览 Widget | 仅按其 PRD 展示封面图、项目简介、项目地址和开发商名称；不重复或扩展 Widget 字段、数据或局部降级。 |
| 页尾 | 项目联系组件 | 位于主要内容之后，提供有效公共联系方式。 |

- 本页只有项目概览 Widget 作为业务主承载；不内嵌地图、户型列表、预约表单或其他业务 Widget。
- 页面不得在 Widget 外增加营销口号、第二层项目标题、英文栏目名、章节编号、楼盘用途、户数、交付时间等未定义内容。
- 项目概览 Widget 缺少必需内容或未发布时，主区域显示“项目介绍暂未发布”；不显示其他项目或残缺介绍。
- 封面承载需兼容铺满画面与完整显示两种设计方案；具体取舍由设计确定。封面或部分介绍内容异常由项目概览 Widget 局部降级，页面框架与联系组件在适用时继续可用。

## 3. 核心流程、状态与响应式

1. 页面按全页面通用访问规则完成公开访问或顾客登录、授权判断。
2. 通过后显示项目识别、项目概览内容和联系出口；页面集合存在其他可访问页面时显示导航入口。
3. 顾客打开导航、关闭导航或继续本页阅读；关闭后保留本页滚动位置和安全临时状态。

| 状态 | 页面处理 |
| --- | --- |
| 未登录受限访问 | 调用顾客登录组件，不显示项目摘要。 |
| 已登录但无权 / 页面无效 | 分别进入统一 403 / 404。 |
| 概览主内容不可用 | 保留可显示的页面框架，主区域给出明确不可用说明。 |
| Widget 局部异常 | 由 Widget 局部处理，不替换为整页错误。 |

采用 **VISTA C**：项目内容优先于控件；移动端先确定阅读顺序和联系入口可发现性，PAD/PC 可扩大阅读宽度，不改变内容顺序与交互结果。精确版式、动效与封面承载规格为 **待设计系统补充**。

## 4. 验收

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-OV-01 | 项目概览页已发布 | 顾客通过本页链接访问 | 无需经过其他页面即可理解本页项目内容。 |
| AC-OV-02 | 页面集合有其他可访问页面 | 顾客打开导航 | 仅显示可访问同级页面；本页不固定业务跨页入口。 |
| AC-OV-03 | 项目概览必需内容未发布或不可用 | 页面已通过访问判断 | 显示明确主内容不可用说明，不显示其他项目内容。 |
| AC-OV-04 | 封面或部分介绍内容局部失败 | 顾客继续阅读 | 局部降级，不进入 403、404 或整页错误。 |
| AC-OV-05 | 320px 至 1440px | 顾客阅读与打开/关闭导航 | 内容可读、核心动作可用，关闭导航后恢复本页滚动位置和安全临时状态。 |

## 5. 明确不做

- 不做固定首页、跨页业务入口、预约表单、地图/户型内容嵌入、分享或语言切换。
- 不在页面层重复定义项目概览 Widget 的字段、数据来源或交互细节。