# 完整 Widget 清单与属性概要

版本：v0.1  
状态：全量能力目录（非 MVP 范围、非页面装配清单）

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-07-29 | v0.1 | 初始创建 / 目录补全 | 基于历史归档的《02-最小功能模块PRD》提取 25 个仍属于 Widget 的能力，建立仅含清单与属性概要的全量目录；明确本文件不定义 MVP、页面引用关系或开发承诺。 |

## 1. 文档目的与使用边界

本文件补充新 C 端需求中的全量 Widget 能力目录，供后续阶段评估、需求检索和 Widget PRD 新建时使用。它回答“有哪些可复用的业务 Widget，以及各自依赖什么类型的输入”，不回答“当前页面引用哪个 Widget”。

- MVP 页面与引用关系只以 [`00-MVP-Widget清单与页面引用关系.md`](00-MVP-Widget清单与页面引用关系.md) 为准；本文件不得扩大 MVP 范围。
- 本文件不定义页面组合、路由、页面级权限、视觉样式、接口或 API URL；页面引用关系由页面 PRD 和 MVP 清单维护。
- 清单来源为历史归档 [`历史归档/2026-07-28-终局页面导向重构前/02-最小功能模块PRD.md`](../历史归档/2026-07-28-终局页面导向重构前/02-最小功能模块PRD.md)。归档内容仅作为能力目录输入，不构成后续阶段的已批准开发范围。
- 后续将某项纳入阶段范围时，必须先在阶段路线图中确认，再新增或更新对应 Widget PRD，并补齐内容、配置、状态、权限边界和验收标准。

### 1.1 编目口径

| 字段 | 说明 |
| --- | --- |
| 编号 | 历史目录中的稳定 Widget 引用 ID；仅用于检索与关联，不代表开发优先级。 |
| 核心任务 | 顾客可完成的最小业务任务，不等同于页面名称或视觉卡片。 |
| 能力来源 | `内容资产驱动`、`配置流程驱动`或`外部承载驱动`；说明 Widget 成立所主要依赖的输入。 |
| 必要输入概览 | 仅概括启动核心任务所需的内容资产或配置，不等同于接口字段或 A 端表单设计。 |
| 承载提示 | 可采用的常见承载方式提示，不建立页面引用关系，也不规定具体页面如何组合。 |

### 1.2 不计入本清单的对象

| 对象 | 处理口径 | 原因 |
| --- | --- | --- |
| M-02 项目联系方式 | 通用组件 | 已在归档稿中退出 Widget 清单；项目级公共联系资料由项目联系组件统一消费，不支持逐页作为 Widget 装配。 |
| 顾客登录、页面导航、项目 Logo、项目联系、筛选器、卡片、图片查看器 | 通用组件或共享规则 | 它们服务多个 Widget 或页面，不独立承担本目录定义的业务 Widget 任务。 |
| 分享、语言切换、埋点、页面权限、CAVE / 大屏定制演示 | 非本清单对象 | 分别属于后续通用组件、数据追踪、权限规则或定制场景，不应借全量目录混入 Widget。 |

## 2. 完整 Widget 清单

### 2.1 项目基础

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-01 | 项目概览 | 了解项目身份、基础介绍和核心价值。 | 内容资产驱动 | 项目基础资料、完整封面图、项目介绍；开发商名称可选。 | 页面主内容或介绍区块。 |

### 2.2 建筑与空间

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-03 | 360 转大楼 | 环视查看项目整体建筑形象。 | 内容资产驱动 | 建筑外观 360° 环视图及必要说明。 | 页面主承载或全屏查看。 |
| M-04 | 3D 大楼 | 查看建筑外观、楼栋及其空间关系。 | 内容资产驱动 | 可交互 3D 大楼内容、楼栋关联资料及必要说明。 | 独立页面主承载。 |
| M-05 | 断面图 / 立面图 | 理解建筑高度、立面、楼层垂直关系和空间层次。 | 内容资产驱动 | 断面图或立面图、图例/说明及楼层关联信息。 | 页面主内容或图纸查看区块。 |
| M-06 | 楼层信息 | 浏览楼层平面，并理解其与户型、住户、样板间、眺望的关系。 | 内容资产驱动 | 楼层资料、楼层平面图及已配置的对象关联。 | 页面主内容或楼层选择区块。 |
| M-07 | 共有部列表 | 浏览公共空间并进入其资料或空间体验。 | 内容资产驱动 | 至少一个共有部对象及基础资料；关联素材可选。 | 列表区块或独立列表页。 |

### 2.3 空间体验

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-08 | 空间体验 - WALK | 沉浸式查看共有部或样板间。 | 内容资产驱动 | 已配置的 WALK 内容、适用空间对象及必要说明。 | 独立页面主承载。 |
| M-09 | 空间体验 - VR | 通过 VR 内容体验共有部或样板间。 | 内容资产驱动 | 已配置的 VR 内容、适用空间对象及必要说明。 | 独立页面主承载。 |

### 2.4 住户产品

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-10 | 户型卡片列表 | 筛选、浏览户型方案并查看户型图。 | 内容资产驱动 | 至少一个可展示户型；户型图、名称/类型、LDK、面积。 | 列表区块或独立列表页。 |
| M-11 | 样板间列表 | 浏览样板间并进入相关空间体验或素材。 | 内容资产驱动 | 至少一个样板间及基础资料；体验或素材关联可选。 | 列表区块或独立列表页。 |
| M-12 | 户型及住户卡片 | 查看户型摘要，并在绑定住户时理解房号、销售状态和住户入口。 | 内容资产驱动 | 户型资料为必需；住户资料、销售状态和关联入口可选。 | 卡片区块或对象详情辅助区。 |
| M-13 | 住户表 | 比较具体住户，并查看其关联的空间、户型、眺望和价格费用资料。 | 内容资产驱动 | 至少一个可展示住户及户型关联；价格、费用、眺望等依配置可选。 | 独立列表页或比较区块。 |
| M-14 | 平面色彩切换 | 在平面 CG 图上比较不同装修色彩方案。 | 内容资产驱动 | 至少两套可比较的平面色彩方案及切换素材。 | 独立页面主承载。 |
| M-15 | 3D 色彩切换 | 在样板间全景中比较不同装修风格。 | 内容资产驱动 | 已配置的样板间全景内容及多套可切换风格素材。 | 独立页面主承载。 |
| M-16 | 平面家具摆放 | 在户型图上查看或模拟家具摆放方案。 | 内容资产驱动 | 户型平面图及已配置的家具摆放方案/素材。 | 独立页面主承载。 |
| M-17 | 费用计算器 | 汇总住户价格、项目费用和顾客选择的可选费用，理解预估成本。 | 内容资产驱动 | 可公开的住户价格/费用资料、可选费用配置；价格控制开启为前提。 | 独立计算页或对象详情辅助区。 |

### 2.5 周边环境

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-18 | 日影 | 查看项目整体日照和周边遮挡关系。 | 内容资产驱动 | 日影资料及必要的时间、方位或说明信息。 | 页面主内容或分析区块。 |
| M-19 | 眺望集 | 浏览不同楼层、朝向和拍摄位置的眺望素材。 | 内容资产驱动 | 眺望素材集合及楼层、朝向、拍摄位置等关联信息。 | 图集区块或独立图集页。 |
| M-20 | 周边地图 | 通过项目锚点、分类和 POI 理解周边关系。 | 内容资产驱动 | 项目位置、至少一个公开 POI、POI 分类、地图服务配置；注意事项可选。 | 页面主内容或地图区块。 |

### 2.6 资料内容

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-21 | 资料集文件夹 | 按文件夹分类浏览项目资料。 | 内容资产驱动 | 已配置资料文件夹及其中至少一项可浏览资料。 | 资料区块或独立资料页。 |
| M-22 | PDF 在线解析 | 在线查看 PDF 类资料。 | 内容资产驱动 | 可访问的 PDF 文件及必要的查看权限/说明。 | 文档查看页或查看器承载。 |
| M-23 | 单文件夹引用展示 | 在指定场景中浏览一个被引用的资料文件夹。 | 内容资产驱动 | 一个已配置且含可浏览资料的文件夹；可独立于 M-21 存在。 | 页面资料区块、图集/视频页或场景内弹层。 |
| M-24 | 活动日历 | 查看项目、案场或关联周边的重要活动。 | 内容资产驱动 | 活动日历、活动名称/时间/地点/状态；联系资料和关联素材可选。 | 活动列表区块或活动详情页。 |
| M-25 | 外部页面嵌入 | 在 C 端访问路径中打开企业自有或第三方独立页面。 | 外部承载驱动 | 外部对象名称、访问地址、提供方/责任主体、启用场景和不可访问处理规则。 | 固定为全屏独立页面承载。 |

### 2.7 转化流程

| 编号 | Widget | 核心任务 | 能力来源 | 必要输入概览 | 承载提示 |
| --- | --- | --- | --- | --- | --- |
| M-26 | 来场预约 | 提交来场意向并获得“已提交、待工作人员确认”的反馈。 | 配置流程驱动 | 表单配置、隐私/同意说明、提交后处理规则；身份验证按规则调用。 | 表单页、弹层表单或转化流程页。 |

## 3. 使用规则

- 目录中任何 Widget 默认均为后续候选能力，不能因为出现在本清单中就被页面引用、在 A 端开放配置或进入开发排期。
- 某个 Widget 进入具体阶段前，应先确认其用户任务、必需输入、可启用/降级/不可用状态和权限归属；清单中的“必要输入概览”不能替代这些详细规则。
- 新增、合并、废弃或改变编号所代表的能力边界时，必须更新本文件并新增重大修订记录；仅补充属性表述可在当前版本合并记录。
- 若页面需要承载某个 Widget，页面 PRD 只记录实例、顺序、入口/返回和页面级状态；Widget 的内部交互、内容与局部异常应归对应 Widget PRD。

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

- 检索后续能力时，先以本清单定位候选 Widget，再核对历史归档的详细边界；不得把归档中的页面组合、旧技术假设或已迁出的组件直接带回新 C 端。
- 不得为方便实现而把通用组件重新编号为 Widget，或把独立页面承载形态误解为“独立应用”产品分类。
- 对尚未有独立 Widget PRD 的条目，任何产品规则、A 端配置、接口、权限、异常状态和验收均应标为待定义；不得从本表推导为已确认。