# HOMEVISTA C端 周边地图页 PRD

**版本：** v0.2

## 修订记录

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

## 1. 文档目的与范围

独立回答“项目周边有什么、与项目位置是什么关系”。参考现有 VISTA 的「周辺マップ」按类别浏览、点位说明与路线信息的认知结构，但首版只展示已核验资产，不做实时导航、路线承诺、用户收藏或第三方地图账号。

## 2. 使用场景与用例

顾客从 Landing、资料或分享进入→切换关注类别→选择点位→查看点位说明和与项目的关系→打开关联资料、预约或返回。

| 异常/边界 | 处理 |
|---|---|
| 项目位置或可用地图主体缺失 | 不可发布 |
| 单个类别无点位 | 隐藏类别，不显示 0 个空筛选 |
| 路线资料缺失 | 不显示路线操作，不推算时间 |
| 受限风险/规划资料 | 先身份验证；未授权不在地图上暴露 |

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

| 角色 | 模块 | 数据引用 | 规则 |
|---|---|---|---|
| 主承载 | M-20 周边地图 | 项目位置、周边点位、分类、点位说明、来源、免责声明 | 只显示已公开且有定位/说明的点位 |
| 辅助 | M-21 资料集文件夹、M-23 单文件夹引用 | 官方地图/防灾/用途地域资料、摘要、适用对象 | 作为点位或图层的补充，不混入实时地图 |
| 转化 | M-26 | 预约说明 | 保持次级，不覆盖地图主体 |
| 固定组件 | 项目联系页脚（`06`） | 项目公共联系信息 | 位于地图内容之后；不覆盖地图主体 |
| 系统 | 身份验证、导航与返回 | 内容权限、来源路径 | 每页访问先判定；受限图层单独判权 |

## 4. 功能需求

| ID | 功能 | 要求 |
|---|---|---|
| F01 | 项目锚点与地图画布 | 项目位置固定为理解基点；初始视野由配置决定，不以客户定位为前提。 |
| F02 | 分类筛选 | 交通、商业、医疗、公园/文化等仅在有公开点位时出现；可重置为初始集合。切换类别时清除前一类别的选中点位并重置详情面板。 |
| F03 | 点位详情 | 显示名称、类别、说明、必要来源/注意事项与关联资料入口；不把内部校验字段公开。 |
| F04 | 资料图层 | 风险/用途地域等仅在项目明确启用且资料来源、日期、说明完整时显示。 |
| F05 | 登录/权限验证 | 页面或受限图层按策略调用身份验证；失败后保留可公开地图，不泄露图层信息。 |
| F06 | 下一步 | 返回来源、预约、打开公开资料三者至少一个可用。 |
| F07 | 加载与错误 | 地图主体加载失败显示可重试及返回；点位/图层局部失败不影响项目锚点和其他类别。 |

## 5. 交互与验收

PC 使用右侧/底部轻量点位面板，地图保持主体；移动端用底部抽屉，点位详情可上滑展开。分类切换不重置当前缩放，返回来源恢复筛选与视野。

| AC | 验收 |
|---|---|
| AC-01 | 顾客可定位项目、切换可用类别、查看点位而不离开主体地图。 |
| AC-02 | 无数据类别、未公开点位、缺来源风险资料均不展示。 |
| AC-03 | 需要验证的图层在验证前后严格切换，失败有可返回状态。 |
| AC-04 | 小屏以抽屉承载信息，不遮挡项目锚点和主要地图区域。 |
| AC-05 | 类别切换后不会保留已隐藏类别的点位详情；地图/点位加载失败均有可理解的恢复动作。 |

## 6. 待确认问题

1. 周边类别与默认排序是否按项目配置；首版采用项目配置顺序。
2. 是否启用外部地图跳转；若启用需确认隐私提示与跳转目标。

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

不得用未核验距离/时长、客户定位或第三方路线结果补齐地图内容；不把 M-20 的底层分类规则改为页面私有规则。