# 购置费用与贷款试算 Widget PRD

版本：v0.5
优先级：P2  
状态：待独立页面原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 / 范围合并 | 将购置/持有费用理解与房屋贷款试算统一为同一顾客决策闭环，明确项目事实费用与顾客融资假设分层。 |
| 2026-08-04 | v0.2 | 重大：指定住户试算入口 | 支持从住户展示页带入一个指定住户及其已公开费用资料；计算器保持独立功能页。 |
| 2026-08-04 | v0.3 | 重大：收紧为纯计算功能 | 不展示住户价格、费用项目或费用明细；仅使用当前住户的计算数据生成参考结果。 |
| 2026-08-04 | v0.4 | 重大：无计算数据时保留试算 | 当前住户没有价格或费用计算数据时，仍保留独立计算器并允许顾客自行输入本金完成纯贷款试算。 |
| 2026-08-11 | v0.5 | 重大：新增购房费用计算器模式 | 增加基于购房费用数据的购房费用计算器；与贷款试算并列为可启用的计算模式。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 购置费用与贷款试算 |
| 唯一标识 | `purchase-cost-mortgage-calculator` |
| 分类 | 住户产品 |
| 一句话介绍 | 提供贷款试算与购房费用计算器，帮助顾客获得购房资金准备的参考。 |
| 封面图 | 购置决策/费用结构类型图。 |
| 设计图 | 费用分层、输入区和试算结果设计示意。 |

## 2. 目标与场景

面向正在评估资金准备和月度负担的顾客。顾客可使用贷款试算，或在已配置购房费用数据时使用购房费用计算器，获得相应参考结果并进一步咨询；不构成金融报价、授信或合同承诺。具体费用计算项、计算规则和可编辑范围以购房费用数据定义为准，不在本 Widget 中自行补推。

## 3. 内容与数据

| 内容 | 必需性 | 来源与有效条件 |
| --- | --- | --- |
| 购房费用数据 | 购房费用计算器模式条件必需 | 由“购房费用”内容来源提供；具体费用项、规则和可编辑范围以该数据定义为准。 |
| 当前住户计算数据 | 条件必需 | 从住户展示页带入对象时，只能使用当前住户当前有效的计算数据；不得使用其他住户或历史数据补位。 |
| 顾客融资输入 | 贷款试算模式必需 | 顾客当次输入：贷款金额/首付比例、年利率、期限等。 |
| 计算结果 | 条件必需 | 仅在当前模式所有必需输入与数据有效后生成。 |
| 结果说明与咨询入口 | 必需 | 明确为试算参考；咨询入口需可达。 |

贷款试算与购房费用计算器的输入、结果分别呈现，不混用或叠加结果。购房费用计算器仅显示购房费用数据已定义、允许顾客查看的计算结果；未定义的费用项、规则或明细不自行补充。

## 4. 使用与配置

配置可启用的计算模式、适用对象选择方式、默认试算值、允许输入范围、结果展示项和咨询入口。贷款试算可独立启用；购房费用计算器仅在购房费用数据有效时可启用。两个模式均启用时，顾客可在 C端切换；仅启用一个模式时不显示模式切换。没有可用住户计算数据时可保留仅贷款假设试算（以顾客输入本金为基础）；缺少当前模式的计算必要输入或数据时不显示结果。配置的默认值必须标明可修改。

当顾客从住户展示页进入时，调用方可带入一个住户作为本次试算对象。计算器只使用该住户当前有效的计算数据；不得改用同户型均价、其他住户数据或历史数据补位。该住户没有可用计算数据时，仍进入同一独立计算器，由顾客自行输入本金完成纯贷款参考试算；购房费用计算器是否可用仍取决于购房费用数据是否有效。完成、取消或关闭后返回原住户展示页并保留其安全浏览上下文。

## 5. C端 UI 与交互

流程为选择/确认对象（如有） → 选择已启用的计算模式 → 输入当前模式所需内容 → 查看结果。顾客修改任一输入后结果即时更新或明确触发“重新试算”；无效数值标出原因，结果区不显示过期值。结果显示当前模式的计算结果、顾客输入摘要、试算参考说明和咨询动作；不要求顾客保存个人财务资料。移动端采用分段输入与可固定结果摘要。

从住户展示页带入对象时，跳过重新选择对象，改为展示只读的当前住户摘要；如带入对象在打开前已下线、无效或不再具备可用计算数据，不展示历史数据或结果，提示返回原页或改用不带对象的贷款试算。

## 6. 用户用例与验收

**UC-01**：顾客输入本金、利率和期限，获取可追溯到输入值的月供/总额参考。
**UC-02**：顾客使用购房费用计算器，查看基于已配置购房费用数据的计算结果。
**UC-03**：顾客确认计算结果为参考，并从结果进入咨询。
**UC-04**：没有可用住户计算数据时，顾客仍可按自己输入的本金完成纯贷款试算。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 购房费用计算器仅使用已配置的购房费用数据，且只展示该数据定义为顾客可见的计算结果；不自行补充费用项、规则或明细。 |
| AC-02 | 缺失/非法必要输入时不显示误导性结果，并说明需修正字段。 |
| AC-03 | 任一有效输入变化后，结果及其输入摘要同步更新。 |
| AC-04 | 当前住户无可用计算数据时，仍可进入计算器并以顾客本金输入为基础完成纯贷款试算；购房费用计算器按购房费用数据有效性独立判断。 |
| AC-05 | 所有结果都标示为参考并提供可达咨询入口。 |
| AC-06 | 顾客从住户展示页进入时，仅使用该住户当前有效的计算数据；结果摘要明确当前住户，且不混入同户型或其他住户资料。 |
| AC-07 | 带入住户已无可用计算数据时，不显示历史数据或失效结果；顾客可返回原页或使用不带对象的纯贷款试算。 |
| AC-08 | 两种模式均启用时可切换且结果不混用；仅启用一种模式时不显示切换控件。 |