# HOMEVISTA C端 资料浏览页 PRD

**版本：** v0.2

## 修订记录

| 版本 | 日期 | 变更类型 | 变更摘要 | 修改人 / 来源 |
| --- | --- | --- | --- | --- |
| v0.1 | 2026-07-28 | 历史版本基线补记 | 将既有页面内容纳入修订记录；原始创建日期未追溯。 | 文档治理 |
| v0.2 | 2026-07-28 | **重大模块边界调整** | `M-02 项目联系方式`改为固定项目联系页脚通用组件，不再作为资料页可装配的转化 Widget。 | 产品确认 / Codex |

## 1. 文档目的与范围

让顾客按资料集完成“发现、理解、打开”的独立任务。参考既有 VISTA 的资料架/文件夹、列表-图标切换、预览与 PDF 在线查看；不把户型图、价格表或内部文件误作普通资料集，也不默认承诺下载、水印和统计。

## 2. 使用场景与用例

顾客由 Landing、地图、销售分享进入→浏览文件夹/检索公开资料→在打开前确认标题、类型、摘要、适用对象→预览或进入 PDF 浏览→返回原集合/预约。

## 3. 模块组合与数据引用

| 角色 | 模块 | 数据引用 | 规则 |
|---|---|---|---|
| 主承载 | M-21 资料集文件夹 | 文件夹、资料名称、类型、封面、摘要、适用对象、可公开状态 | 无公开资料不发布 |
| 辅助 | M-22 PDF 在线解析、M-23 单文件夹引用 | PDF/关联文件、文件可用状态 | PDF 仅在可解析时站内打开，否则按配置外跳或隐藏 |
| 转化 | M-26 | 预约说明 | 次级、不可遮盖资料浏览 |
| 固定组件 | 项目联系页脚（`06`） | 项目公共联系信息 | 位于资料浏览之后，不遮盖资料内容 |
| 系统 | 身份验证、导航与返回、搜索 | 文件权限、来源路径 | 受限资料先验权；搜索仅检索当前可访问集合 |

## 4. 功能需求与状态

| ID | 功能 | 规则 |
|---|---|---|
| F01 | 集合浏览 | 文件夹树与当前列表同步；桌面端内容区展示可返回任一层级的当前位置路径，移动端以当前路径与返回上级动作替代固定树；支持卡片/列表，移动端优先列表。 |
| F02 | 搜索与筛选 | 仅按已配置的名称、类型、标签搜索；不能检索无权限或内部资料。 |
| F03 | 资料卡片 | 打开前展示类型徽标、标题、摘要、更新时间（有配置时），不承诺下载。 |
| F04 | 打开资料 | 图片/视频/PDF按其模块能力预览；不可用文件显示明确状态，不能打开空白页。 |
| F05 | 登录/权限验证 | 受限资料卡可显示为受限入口但不暴露摘要；验证成功后回到同一文件夹和检索条件。 |
| F06 | 加载与错误 | 文件夹/列表加载失败显示重试与返回；单文件失效显示不可用，不跳转空白预览。 |

## 5. 验收标准

| AC | 验收 |
|---|---|
| AC-01 | 顾客能够从集合找到并识别至少一种可用公开资料。 |
| AC-02 | 未公开、失效、无权限资料不会以正常可打开卡片出现。 |
| AC-03 | PDF 解析失败提供配置的替代路径或不可用提示。 |
| AC-04 | 返回后保留文件夹、视图和搜索条件。 |
| AC-05 | 当前路径可识别且可回退；受限、失效、解析失败三种资料状态均不能打开空白页。 |

## 6. 待确认问题

1. 浏览/下载的许可与验证触发规则；未确认前只定义浏览入口。
2. 资料分类和更新时间是否由项目自行维护；默认消费资产配置。

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

使用 VISTA C 搜索、图片栏和资料卡片模式；不得把资料权限、下载或统计实现写入本页。