# C端全量 Widget 需求评审台账

版本：v0.1  
状态：评审中；已完成第一轮正式文档核对，待产品确认

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-13 | v0.1 | 初始创建 / 重大：评审范围重启 | 以当前正式的 22 个 Widget 为唯一范围，重新启动全量需求评审；不继承已失效的 24 项、WALK/VR 独立 Widget、住户比较等历史口径。 |

## 1. 评审信息

| 项目 | 内容 |
| --- | --- |
| 被评审文档 | `02-Widget体系/02-全部Widget清单.md`、`01-Widget开发清单与优先级.md`、`Widget需求/` 下 22 份当前 PRD，以及必要的页面、组件、权限和内容来源规则。 |
| 评审日期 | 2026-08-13 |
| 评审节点 | 方案评审；本轮只核对需求定义，不代表原型、实现或人工验收通过。 |
| 评审范围 | 22 个 Widget：P0 4 项、P1 10 项、P2 8 项。 |
| 明确不评审 | 历史归档、旧 Demo 的功能结论、外部内容内部能力、正式视觉、生产性能与技术实现。 |
| 评审方法 | Codex 逐项核对总清单、单项 PRD、页面/组件/数据规则；尝试调用 DeepSeek PM 作独立复核，但两次请求均未返回可使用的书面内容，因此未将其作为任何结论依据。 |
| 当前状态 | 待产品确认：存在影响业务规则或跨 Widget 衔接的未决项。 |

## 2. 当前范围与已确认边界

- 当前范围固定为 22 个 Widget；WALK、VR 是由业务对象关联、并由“沉浸内容承载与控制组件”打开的内容类型，不是独立 Widget。
- 页面负责访问、承载和组合；导航、登录、媒体查看、加载/错误、分享与语言切换均不是 Widget。
- 顾客可见内容只可来自单项 PRD 明确列出的内容；Demo、原型装饰文字、通用组件可选槽位不得扩展需求。
- P0/P1/P2 是当前开发优先级，不是人工评审结论；本台账中的“已核对”不等于“人工通过”。

## 3. 全量审查覆盖

| 优先级 | 已核对 Widget | 审查结果 |
| --- | --- | --- |
| P0 | 项目概览、户型卡片列表、周边地图、住户展示 | 单项范围与总清单一致；未发现需要立即改写范围的冲突。住户展示与费用试算、样板间入口的跨 Widget 规则纳入本台账待确认项。 |
| P1 | 断面图与立面图、楼层信息、共有部列表、3D大楼、样板间列表、户型卡片、住户表、眺望集、资料集、单个文件夹展示 | 单项对象边界总体成立。住户表详情范围、眺望说明归属及 P1 内容来源可交付性需要收口。 |
| P2 | 360转大楼、日影、活动日历、来场预约、平面色彩切换、3D色彩切换、平面家具摆放、购置费用与贷款试算 | 独立页面定位总体成立。活动报名到预约、预约提交不确定结果、P2 内容合同是本轮主要待确认项。 |

## 4. 评审问题与处理台账

| ID | 评审维度 | 问题、影响与本地证据 | 处理结论 | 是否需产品确认 | 影响对象 | 当前状态 |
| --- | --- | --- | --- | --- | --- | --- |
| W-01 | 内容与数据 | 当前《项目内容数据与素材字典》只覆盖 MVP 的项目概览、地图、户型和通用资料；P1/P2 中的建筑、楼层、共有部、样板间、住户、眺望、活动、预约、色彩、家具和购房费用仅在各 Widget 内以业务描述出现，尚无可共同核对的发布/语言/关联最小口径。继续直接开发会让不同 Widget 各自解释“已发布、可达、当前语言、有效关联”。 | 待确认 | 是 | P1/P2 相关 Widget、内容运营规则、后续开发验收 | 待决定是否新增“非 MVP 内容对象最小合同”，或明确这些对象由既有业务系统规则承接。 |
| W-02 | 对象边界 | 住户表允许“可售住户打开详情弹窗”，但未定义弹窗可展示的字段、是否只能阅读、是否可进入住户展示页，且住户展示 Widget 已承担单个住户的完整销售介绍。若不收口，住户表详情可能重新长成第二个住户展示页，或泄露未授权字段。证据：`12-住户表Widget-PRD.md` 第 3、5、6 节与 `25-住户展示Widget-PRD.md` 第 2、3 节。 | 待确认 | 是 | 住户表 Widget、住户展示 Widget、住户表页、权限规则 | 待明确“详情弹窗最小只读字段”和是否允许进入已授权的住户展示页。 |
| W-03 | 跨 Widget 流程 | 活动日历可显示预约入口，但没有定义进入来场预约后如何带入活动、提交结果是否关联该活动，以及活动已满/取消与预约页再次打开时的处理。若预约是活动报名而非泛咨询，当前链路会丢失顾客意图；若只是外部入口，也需明确不由来场预约 Widget 承接。证据：`18-活动日历Widget-PRD.md` 第 3、5 节与 `19-来场预约Widget-PRD.md` 第 3、4 节。 | 待确认 | 是 | 活动日历、来场预约、活动日历页、来场预约页 | 待决定活动预约的承接对象、活动上下文传递和失效回退。 |
| W-04 | 流程状态 | 来场预约规定“提交中防重复”和“失败可重试”，但没有顾客可理解的规则来处理“提交后超时/结果未知”：此时直接重试可能重复提交，直接失败也可能掩盖已受理。该规则影响顾客收到的状态与后续联系口径。证据：`19-来场预约Widget-PRD.md` 第 5、6 节。 | 待确认 | 是 | 来场预约 Widget、状态反馈组件、来场预约页、测试用例 | 待明确结果未知时显示的状态、可执行动作和运营跟进出口。 |
| W-05 | 内容语义 | 眺望集要求“辅助性文字说明”在左上角固定显示，且不随筛选或全屏消失，但未说明它是整个 Widget 的固定说明，还是随当前眺望素材变化的说明。后者在切换素材后可能展示错误解释；前者应明确其为集合级说明。证据：`13-眺望集Widget-PRD.md` 第 3、5 节。 | 待确认 | 是 | 眺望集 Widget、眺望页、内容运营 | 待确认说明归属；建议默认按集合级固定说明处理，单素材说明另行定义并随素材切换。 |
| W-06 | 文档治理 | `Widget需求/README.md` 顶部版本仍为 v0.5，但修订记录已经写入 v0.6；旧 P1 人工评审记录仍写“6 个 P1 页面”“住户比较”“WALK/VR 实例类型”，与当前 22 项范围和页面规则不一致。若继续使用旧记录，会把历史范围带回本轮。 | 采纳 | 否 | `Widget需求/README.md`、`2026-08-05-C端P1人工评审总记录.md` | 本台账已作为本轮唯一评审入口；待在确认本轮评审流程后同步修正文档治理信息。 |

## 5. 本轮结论

### 可继续保持的结论

- 22 个 Widget 的目录、优先级分布（P0 4 / P1 10 / P2 8）与单项 PRD 文件集合一致。
- WALK/VR 退出 Widget 范围后的主边界已在总清单、开发优先级和相关业务 Widget 中基本同步。
- 项目概览、户型卡片列表、周边地图和住户展示的 P0 业务边界没有发现新的范围冲突；但仍须按原 P0 人工评审记录完成实际页面与原型复验。

### 当前不能宣布通过的原因

- W-01 至 W-05 会改变或决定内容数据口径、单住户边界、跨 Widget 流程、顾客状态和验收标准，必须由产品负责人确认后才能写入正式 PRD。
- W-06 说明旧的分阶段评审记录不再适合作为本轮入口；本台账仅记录需求核对，不能代替人工评审通过。

## 6. 建议的评审顺序

1. 先确认 W-02、W-03、W-04：它们直接决定顾客是否会进入错误的单住户详情、丢失活动报名意图或重复提交预约。
2. 再确认 W-01 与 W-05：明确 P1/P2 内容最小合同，以及眺望说明归属。
3. 确认后一次性更新受影响 PRD、页面 PRD、修订记录与原型；再按 P0 → P1 → P2 做人工可运行评审，不将本台账标为通过。

## 7. 关闭条件

- [ ] W-01 至 W-05 均已由产品负责人确认、拒绝或调整后确认。
- [ ] 被采纳的重大变化已同步到单项 Widget PRD、页面/组件规则和修订记录。
- [ ] W-06 的文档治理差异已修正，旧评审记录明确其历史适用范围。
- [ ] P0、P1、P2 分别完成对应原型/实现的人工评审；需求核对、构建通过和人工评审结论保持区分。
- [ ] 本台账中的每项均已记录处理依据、影响对象和验证结果。