Files
dxdesigner-part-replacement/docs/testing/2026-11-06-nonblocking-bom-values.md

8.2 KiB
Raw Permalink Blame History

T4:BOM 部分导入、目标库与实际 Value 证据

工作目录:.worktrees/codex-nonblocking-items。验证全部使用临时 Excel、真实 SQLite、COM 形状假对象和 Windows cscript.exe 执行生产 VBS 例程;未打开真实 CAD、PCB、Library Manager 或 AI。

行为与边界

  • R19:默认整批校验仍为原子操作,Excel 前置错误不会启动采集。显式勾选“允许部分导入通过工程”后只核验没有前置错误的工程;返回报告不会自动暂存部分计划,必须在“选择通过工程…”中主动勾选。多来源的公式(包括未映射额外列中的公式)、数值 PN、非法 Value mode 保留为各自工程的失败行,不阻止其他完整通过工程;默认模式仍在任何采集前拒绝。只接收完整通过工程,失败/未检查行、原工作簿和行号保留。部分接收保存时要求原预览行完全一致,重新验证所有原工作簿 SHA-256、source-map SHA-256、工程成员和原库存;任何不符均拒绝。临时归一化工作簿删除后,绑定的是原工作簿。损坏工作簿、错误表头、相对工程路径或无法唯一归属的来源仍拒绝进入部分采集。
  • R20:首次 BOM 采集同时请求源、目标 PN;普通源 PN 计划可复用已保存库存,但任何启用的“已到目标”跳过判定必须再次经过只读发现,不能把数据库里的旧读数当作当前证据。发现缓存仅可凭当前源内容指纹复用。ComponentTarget 增加可选实际 Part Label / Cell;官方 FLAT 生效报告解析其有效值,CAD 只读采集输出扩展 9 列,旧 7 列仍按未知接收。缺少所需证据时失效发现缓存并重新只读采集一次,仍不支持则明确报问题。实际 PN 已为目标时,四种 Value 策略及指定 Cell 都按实际读数判定,匹配生成禁用跳过行,不符拒绝,绝不使用计划 Cell 冒充实际 Cell。SQLite 可空列迁移保留未知状态,未知到已知的补证保留用户编辑和原 UID/ref/PN/Value 基线,已知证据冲突拒绝并记为工程失败行。真实 QPCaptureAndSelect 同样识别精确 UID 已到目标,实际 Value/Cell 符合时返回 no_match / already_target;不符或属性歧义直接拒绝。冻结旧分组中混有源和目标器件时明确要求逐器件处理,不声称整组完成。
  • R21:preflight_command_target 调用现有物理库克隆、只读隔离读取和清理证明链;即使没有指定 Cell 也读取目标 PN,指定 Cell 必须属于该目标。源库内容/依赖指纹绑定缓存证据。缺件、歧义或关联错误在证明资源释放后转为 target_cell_catalog;没有正面桌面/Job 释放证据则保留 batch_resources_pending,不当作可继续的业务失败。主流程已接在 journal claim 后、原生启动/修改前,安全目标错误记独立失败回执。
  • R23:原生保存重开核验、人工恢复核验和只读恢复核验后,写每 job 的 v2 value-readback-<job>.tsv。绑定 task/job/终态、完整 PN/Value/NC/Cell/UID 选择、当前快照原文;记录实际 PN、Value 存在性、实际 Value 和 Cell。启动前清除同 job 旧观测;Python 依据当前终态、精确 UID 集和当前快照验证,再原子保存 JSON。后续读取复核命令、终态、原始报告与快照哈希;旧/外国/不完整报告返回 rejected,缺报告返回 unavailable,不填计划值。显示表增加原 Value / 实际 Value 列,缺证据明确提示。
  • R24:所有枚举属性按 UID 和 ordinal 保留原始 Attr.Value / Attr.InstanceValue,包括相同名称、相同文本的两个观察。层级固定记录 unknown,不把任一属性 API 等同于 Block 或 Symbol。选中器件写前和恢复事务前检查同名属性;歧义原始观察写入 sidecar 后拒绝修改。原有单一组件属性 InstanceValue 行为保留;未证明 Block/Symbol 所有权,也未新增任何推测性的层级写入功能。

验证记录

按失败用例先行验证了缺失的部分接收 API、严格原行/来源校验、目标库执行适配错误分类、已到目标的 BOM 匹配、实际 Value 报告、报告表格列和原生属性守卫,再最小实现。

  • 新增定向组:test_nonblocking_bom_values.py、test_value_readback.py、test_nonblocking_value_vbs.py,连同 BOM 状态机:34 passed。
  • BOM 既有行为、来源映射、迁移、每项 Value、原子确认:90 passed(加入最后两项定向来源/Cell 用例前的受影响组)。
  • 原生守卫、生成的原生只读脚本和目标库克隆证明:131 passed。
  • Value 可见报告与历史日志:13 passed。

在后续补齐实际 Part Label / Cell 前,完整受影响组合为 219 passed。补齐后:实际元数据、BOM、库存、原生解析/读取、服务/后端身份保护组合 140 passed;真实只读采集 VBS 入口、实际元数据、BOM 新例及完整 VBS 编译 36 passed。最终 BOM 来源/每项 Value 组合结果由本次末尾追加;不把重叠统计相加。测试使用独立 --basetemp,避免多个协作进程共享 pytest 临时目录保留清理。修正了旧 VBS 假环境缺失 QP_Fso 初始化及新增报告依赖桩;真实生产例程仍由 cscript 执行。

最终 BOM 组合:test_bom_batch、test_bom_import_report、test_bom_plan、test_bom_import_review、test_item_value_and_bom_sources、test_bom_actual_metadata、test_nonblocking_bom_values、test_value_readback:115 passed in 51.47s。git diff --check 无空白错误。

最后补测来源行隔离及空 Part Label:先观察公式/数值 PN/非法模式/额外列公式 4 个服务端到端用例失败,再接通显式部分来源读取;空 Part Label 必须拒绝,不能以空 Value 相等误报通过。最后 test_nonblocking_bom_values、test_bom_actual_metadata、test_bom_import_review:42 passed in 27.71s。库存合并可读性整理后的存储/扩展/报告小组:39 passed。新增源错误隔离后没有再次执行较早的 219 项完整组。

独立审查补修:数据库已有目标 PN 和完整 Label/Cell 仍可能过期。新增真实 SQLite/XLSX 用例,在数据库保持 NEW / LABEL / CELL 时修改实际源文件,读取器分别返回变化后的 Label、Cell、Value;4 项均先因读取次数为 0 而失败。修复后,所有已到目标判定都经过当前只读发现,源与已保存基线冲突时只产生失败报告、不生成禁用成功行、不修改数据库;当前源匹配时允许跳过。窄回归 test_bom_actual_metadata、既有普通源库存复用用例、test_bom_import_report、test_nonblocking_bom_values:61 passed in 34.51s,没有真实 CAD 调用或完整 VBS 重跑。

最终窄审补修:本轮已读取但 actual_part_label 或指定 actual_cell 返回 None 时,普通加法库存合并会保留旧已知值;该历史补值不能参与“已到目标”策略核验。匹配器现在独立接收本轮原始观察,按精确工程/图页/UID 核验启用目标的 Value/Label/Cell,库存合并继续保持原有语义。新增“历史已知、本轮未知 Label/Cell”2 项先失败,再修复为失败报告、无预览、无跳过,数据库原记录不变;当前观察匹配仍允许跳过。

最终精确回归选择当前源观察 6 项(匹配、Label/Cell/Value 改变、Label/Cell 未知)及普通库存扩展基线保护 2 项:8 passed, 27 deselected in 7.06s。普通源计划仍保留原 target_identity 异常语义;仅已到目标判定的基线冲突转为失败报告。未重跑广泛套件,git diff --check 无空白错误。

集成说明

主流程调用 clear_value_readback、capture_value_readback 和库预检;service 的来源标注调用 bind_source_report,保留原文件与 source-map 绑定。资源或异常退出包装器必须同时清除 preview / passed_preview。事件日志通过 value_readback_details(result) 读取已验证持久报告,不能从请求 Value 推导实际结果。

未进行真实工程回放。旧清单没有可选 Part Label / Cell 读数时会重新采集,仍未知则采用显式问题;实际有效属性证据不能视作已实现完整 Block/Symbol 语义。