# 04-01 项目卖点 Landing 页：A端模板与实例样例

> 文档版本：v0.21
>
> 用途：验证 Widget 登记、模板编排与项目实例生成的 MVP 闭环

## 修订记录

| 版本 | 日期 | 变更类型 | 变更摘要 | 修改人 / 来源 |
|---|---|---|---|---|
| v0.1-v0.9 | 2026-07-16 至 2026-07-20 | 历史修订汇总 | 收口登记、实例快照、测试项目、长期有效和模板不可切换规则。 | 产品讨论 / Codex |
| v0.10 | 2026-07-20 | **重大样例变更** | 样例改为三类 Widget 内容模型；模板由 A端按 Widget 清单编排并可重复使用户型 Widget；实例按区块配置内容。 | 销售沟通 / 产品确认 / Codex |
| v0.11 | 2026-07-20 | 样例用语统一 | 样例统一使用“项目页面、内容输入规则、展示方式”等业务用语，技术标识只在需要核对唯一对象时保留。 | 产品评审 / Codex |
| v0.12 | 2026-07-20 | **重大样例变更：Widget 注册先行** | 样例改为先注册并取得 Widget 标识，再由开发实现、验证和启用；三类内容改为“自动带入、选择项目内容、自定义内容”，并合并为一段内容说明。 | 产品评审 / Codex |
| v0.13 | 2026-07-20 | **重大样例变更：展示方案** | 每种展示方式补充文字说明和支持尺寸；模板区块改为选择“展示方式＋尺寸”，并采用小半宽、中通栏、大全屏的响应式规则。 | 产品确认 / Codex |
| v0.14 | 2026-07-20 | **重大样例变更：确认上线** | 删除待开发步骤；Widget 注册后直接待验证，MVP 由操作人员确认开发部署完成后上线，不执行自动验证。 | 产品确认 / Codex |
| v0.15 | 2026-07-20 | **重大样例变更：展示规则极简化** | 删除列表式、卡片滑动式等 A端展示方式登记；Widget 只选择支持的小、中、大规格，模板区块只选择一个允许规格。 | 产品确认 / Codex |
| v0.16 | 2026-07-20 | Widget 区块样例澄清 | 明确每次引用 Widget 都形成独立 Widget 区块，展示规格按区块作为引用参数保存；重复 Widget 可采用相同或不同规格。 | 产品确认 / Codex |
| v0.17 | 2026-07-20 | **重大样例变更：模板开发与确认上线** | 04-01 模板改为先注册取得稳定标识、登记动态 Widget 区块，再由开发实现模板代码并人工确认上线；补充通用组件和固定非区块内容边界。 | 产品确认 / Codex |
| v0.18 | 2026-07-21 | **重大样例变更：项目主题引用** | 项目页面不再单独选择或固化主题，统一读取项目当前有效主题；主题更新后影响该项目全部页面且无需逐页重新发布。 | 产品确认 / Codex |
| v0.19 | 2026-07-28 | **重大样例变更：Widget 数据来源** | Widget 样例增加单选数据来源；项目页面选择内容时按数据来源展示候选数据，“其它”表示无需选择项目数据。 | 产品确认 / Codex |
| v0.20 | 2026-07-28 | **重大样例变更：Widget 分类与 C端资产统一** | Widget 样例新增 C端功能模块分类；数据来源使用 C端资产对象名称，并将技术播放器样例改为业务模块“单文件夹引用展示”。 | 产品确认 / Codex |
| v0.21 | 2026-07-28 | **重大样例范围收敛** | 删除业务任务和内容边界尚未明确的“自定义图文”Widget 样例；后续需求明确后再按正式注册流程增加。 | 产品确认 / Codex |

## 一、样例目标

本样例不追求模拟真实项目视觉，而是验证：

1. Widget 能先注册取得唯一标识，其内容配置方式和支持的展示规格能被登记并理解；
2. 模板能先注册取得唯一标识，开发使用该标识实现代码，确认上线后才可创建项目页面；
3. 模板能重复使用同一 Widget，并与模板代码中的通用组件、固定非区块内容明确分工；
4. 项目页面配置能明确区分自动带入、选择项目内容和自定义内容；
5. 展示规格在模板确定，项目页面不能修改；
6. 模板不可直接访问，只有项目页面可上线和分享。

## 二、首批 Widget 样例

| Widget | Widget 分类 | 内容配置方式 | 数据来源 | 内容说明 | 支持的展示规格 | 创建项目页面时的配置 |
|---|---|---|---|---|---|---|
| 项目资料 `widget.project-profile` | 项目基础 | 自动带入 | 项目基本信息 | 自动读取当前项目名称、主图和基础介绍。 | 中、大 | 无需配置。 |
| 户型列表 `widget.floorplan-list` | 住户产品 | 选择项目内容 | 户型 | 从当前项目已有户型中选择一个或多个户型。 | 小、中、大 | 选择要展示的户型范围。 |
| 单文件夹引用展示 `widget.folder-reference` | 资料内容 | 选择项目内容 | 资料文件 | 从当前项目资料文件中选择一个已配置文件夹。 | 中、大 | 选择一个资料文件夹。 |

以上信息在开发前由产品或交付人员注册。系统生成 Widget 标识，注册记录直接进入待验证；开发人员必须使用该标识完成实现。MVP 由操作人员确认开发部署完成后上线，不执行自动验证；上线后才可加入模板。

首批样例不登记通用“自定义图文”Widget。该类 Widget 需要先明确顾客任务、允许输入的内容范围和使用场景，后续再按正式流程注册；这不影响其他明确业务 Widget 使用“自定义内容”配置方式。

## 三、模板注册与开发样例

模板名称：`户型推荐页`

模板 ID：`template.floorplan-recommendation`

顾客任务：按客户需求介绍项目并推荐户型。

注册与上线过程：A端先生成以上模板 ID 并登记下列动态 Widget 区块，模板进入待验证；开发人员使用该 ID 实现并部署页面代码，操作人员确认后模板进入已启用。MVP 不执行自动验证。

| 顺序 | 区块名称 | Widget | 内容配置方式 | 展示规格 |
|---|---|---|---|---|
| 1 | 项目资料 | 项目资料 | 自动带入 | 中 · 通栏 |
| 2 | A户型推荐 | 户型列表 | 选择项目内容 | 中 · 通栏 |
| 3 | 小户型推荐 | 户型列表 | 选择项目内容 | 小 · 半宽 |
| 4 | 项目介绍资料 | 单文件夹引用展示 | 选择项目内容 | 中 · 通栏 |

这里“户型列表”出现两次，代表两个独立 Widget 区块，不能因为使用同一个 Widget 而合并。两个区块的展示规格参数分别保存，可以相同，也可以不同；本样例分别采用“小 · 半宽”和“中 · 通栏”，用于验证同一 Widget 的不同引用互不影响。

上述清单不是 04-01 模板的完整页面代码。模板页头、导航、菜单、固定标题和装饰等无需按项目变化的内容由模板代码实现，不在 A端登记；任何需要按项目变化的业务内容都必须进入 Widget 区块，不能写死在模板代码中。

## 四、项目页面配置样例

项目：HOMEVISTA DEMO（原型暂用模拟项目名称和资产）

模板：户型推荐页（锁定）

项目当前主题：VISTA 默认主题（项目页面自动读取，不在当前页面单独选择）

允许未登录顾客查看：是

有效期：默认长期有效，不显示配置项。

| 区块 | 实例配置结果样例 |
|---|---|
| 项目资料 | 自动读取当前项目名称、项目图片和基础介绍。 |
| A户型推荐 | 选择 `A户型 · 70㎡ · 2LDK`。 |
| 小户型推荐 | 选择 `B户型 · 55㎡`、`C户型 · 48㎡`。 |
| 项目介绍资料 | 选择 `项目介绍资料文件夹`。 |

页面只读显示每个区块的展示规格。交付人员可以修改选择的户型或视频，但不能修改小中大规格，也不能在项目页面中添加新 Widget。各规格内具体采用列表、卡片或其他表现，由 Widget 代码决定。

如果后续为 HOMEVISTA DEMO 应用个性化主题，本页面及该项目其他页面统一读取新主题，包括已上线页面；不需要重新编辑或发布本页面。

## 五、发布验证

| 编号 | 验证结果 |
|---|---|
| EX-01 | 自动带入区块无需输入即可通过。 |
| EX-02 | 两个户型区块分别选择内容，互不覆盖。 |
| EX-03 | 资料区块未选择文件夹时可保存草稿，但不能上线。 |
| EX-04 | 项目页面配置页不提供展示规格修改入口。 |
| EX-05 | 预览后项目页面可上线；顾客打开的是项目页面链接，不是模板链接。 |
| EX-06 | 模板后来修改不改变该项目页面已经确定的区块结构和展示规格。 |
| EX-07 | 小规格在 PC端按半宽布局，在移动端自动变成全宽紧凑布局；中和大规格均独占一行。 |
| EX-08 | 项目页面不显示单页主题选择；项目主题更新后，本页面无需重新发布即可使用新主题。 |
| EX-09 | 户型列表只显示当前项目的户型候选；单文件夹引用展示按“资料文件”显示文件夹候选。 |
| EX-10 | 待验证模板不能创建项目页面；人工确认模板代码已使用正确模板标识完成部署后，模板才能启用。 |