furniture-3d-system-Wu/furniture-3d-system/docs/架构设计/BOM成本预估产品口径.md

BOM 成本预估产品口径

本文是 BOM 成本功能的产品口径裁决入口。代码、界面、测试或历史文档与本文冲突时，应先按本文区分“成本预估”与旧链路内部一致性检查，再决定是否修改实现。

产品承诺

• 本功能提供带区间、置信度和待确认项的成本预估，不提供报价级精确核算。
• 预估结果允许与实际采购价、旧规则结果或其他参考信号存在明显差异；差异本身不构成失败。
• 缺少依据的单价可以为空，未解决行应进入待确认项，不得为了提高覆盖率编造价格。
• Agent 决定查看什么资料、调用什么工具以及引用什么证据；总额、损耗、开料、分位数和行小计由确定性代码计算。
• 正式 Agent 引擎以公司历史 BOM 镜像、材质目录和损耗经验为主要价格依据；临时交付阶段按下节的整件九折方案展示单一预估结果。

临时整件九折方案

• 正式 Agent 引擎完善前，相似度合格的实时同款报价取中位数并固定乘以 0.90，作为前端唯一整件预估价。
• 没有可用同款、图片不可用或服务失败时，沿用结构预估，页面仍只显示一套结果。
• 原始报价、候选商品、九折过程和原结构价只保留在后台审计字段；普通接口和前端不得出现来源名称、商品链接、供应商或采购系数。
• 临时整件价生效时，前端不得同时显示结构分类金额、行小计、贡献占比或旧规则价格；BOM 部件、材质、尺寸和数量仍可在详情中查看。
• 正式 Agent 引擎通过产品验收后，在保持同一前端单结果契约的前提下替换临时价格来源。

验收口径

Agent 旁路试验主要验证：

1. 能否稳定完成工具调用并返回符合契约的结果。
2. 区间、置信度、证据和待确认项是否完整且容易理解。
3. 单价是否来自工具结果，总额是否由代码汇总。
4. 未定价行是否明确保留，而不是被虚构金额掩盖。
5. 前端是否保持来源中性，不泄露供应商、店铺、商品链接或实时市场来源。

Agent 与旧引擎、实际采购价或市场信号的差异仅作为观察数据，不设全局固定百分比通过门槛。按品类统计差异可以帮助理解结果分布，但不能自动判定预估失败。

旧 10% 门槛的边界

backtest:bom-cost-reference 中的 10% 只用于验证同一历史参考镜像内“已存总额”和“逐行确定性重建”是否一致，属于数据与重建逻辑检查。它不评价页面成本预估或 Agent 预估准确度，不得显示为产品目标，也不得复用于 Agent 灰度验收。

数据库中的 targetErrorPercent 暂时保留用于旧数据和接口兼容；新界面不得展示为成本预估承诺。后续清理旧模型时再通过正式 migration 移除。

术语

• 用户可见名称统一使用“BOM 成本预估”“预估结果”“重新预估”。
• bom-costing 等技术目录、路由和历史模型名暂时保留，避免为改名引入无关迁移。
• “核算”仅可用于描述已经确认的历史采购/生产成本，不能描述本功能输出。