# 项目联系组件 PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 建立项目公共联系出口定义。 |
| 2026-08-03 | v0.2 | 合并旧 PRD / 重大范围确认 | 合并原“项目联系组件”规则；确认仅使用官网、邮箱、电话，至少一项有效为公开页面发布前置，不替代预约。 |
| 2026-08-04 | v0.3 | 重大：页尾展示规则调整 | 确认所有正常 C端业务页面在页尾直接显示有效联系方式，不再要求顾客先打开联系弹窗。 |

## 1. 定义与目标

唯一标识：`project-contact`。为顾客提供当前项目已公开的公共官网、邮箱和电话；不收集预约字段、不替代来场预约流程，也不承载销售线索或 CRM。

组件位于所有正常 C端业务页面的页尾。顾客浏览到页面末尾后可直接查看和使用当前项目的有效联系渠道，无需先打开联系弹窗。

## 2. 内容、配置与边界

| 联系渠道 | 展示条件 | 点击结果 |
| --- | --- | --- |
| 电话 | 当前项目有有效公开电话 | 调用设备拨号能力，不自动拨出。 |
| 邮箱 | 当前项目有有效公开邮箱 | 调用邮件能力并带入收件地址，不预填营销正文。 |
| 官网 | 当前项目有有效公开网址 | 打开对应官网，不自动改写或搜索网址。 |

- 电话、邮箱、官网至少一项有效是页面公开发布的前置；字段格式无效不计入有效项。
- 只显示有效项，顺序固定为电话、邮箱、官网；不使用其他项目数据补位。
- 不在本组件中加入地址、营业时间、展示密度或渠道排序配置；这些是不同业务范围，需另行确认。
- 组件固定挂载于所有正常 C端业务页面，不作为 Widget，也不开放页面级显隐或排序。

## 3. 核心流程与状态

1. 顾客浏览到页面主要内容末尾，在页尾查看当前项目的有效联系方式。
2. 顾客点击电话、邮箱或官网后，系统调用对应设备能力或打开目标官网。
3. 使用外部设备能力或官网后，顾客可安全返回原页面；原页面的滚动、筛选、地图、卡片等临时状态保持不变。

| 状态 | 处理 |
| --- | --- |
| 默认 | 页尾直接显示当前项目全部有效渠道。 |
| 单项 / 多项有效 | 只展示有效渠道，按固定顺序排列。 |
| 单项运行时失效 | 隐藏该项，其他有效项继续使用。 |
| 全部运行时失效 | 页尾显示联系方式暂不可用的局部提示；页面主体继续可用。 |

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

采用 **VISTA C** 页面页尾语义。联系方式不悬浮、不覆盖封面、地图、筛选、卡片或媒体查看器；本期原型只规定内容和响应式结构，不规定液态玻璃、颜色或动效。页尾的精确间距、视觉层级与移动端样式为 **待设计系统补充**。320px 至 1440px 下联系方式均须可发现、可读、可操作。

## 5. 验收

| AC | Given | When | Then |
| --- | --- | --- | --- |
| AC-CONTACT-01 | 页面正常发布且有有效渠道 | 顾客浏览至主体内容后 | 页尾直接显示当前项目的有效联系方式。 |
| AC-CONTACT-02 | 至少一项有效渠道 | 页尾渲染 | 只展示有效项，并按电话、邮箱、官网的固定顺序排列。 |
| AC-CONTACT-03 | 仅电话、邮箱或官网其中一项有效 | 顾客使用该项 | 调用对应设备能力，不虚构其他渠道。 |
| AC-CONTACT-04 | 三项均缺失或无效 | 运营尝试公开发布页面 | 发布被阻止，并提示补充至少一项有效联系方式。 |
| AC-CONTACT-05 | 顾客从设备能力或官网返回 | 原页面恢复 | 保留原页面滚动位置与临时状态。 |

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

- 不做地址、营业时间、个人销售联系、预约/咨询表单、客服、分享、二维码、CRM 或埋点。
- 页尾精确视觉与移动端规格待设计系统补充。