KCGL/app at 91672214c8a8975963fdbf0afb0c290f8ca3abbc - KCGL

Files

yueli 91672214c8 feat(audit): 操作对象补全改为按特征全局解析，摘要联动物料名

此前补全只覆盖「入库/采购」，报废、退回、BOM 仍只显示光秃秃的 SKU 或 bom_no。
根因是解析走的是「快照 base_id / target_id 命中股票表」两条硬路径，
而这几类记录的可用线索完全不同（报废快照有 sku 无 base_id、BOM 只有
parent_id、UPDATE 行两样都没有）。

改为**按特征五级解析，不看 module 名单**（同一 module 内不同记录的线索
本来就不一样，按 module 判断必然覆盖不全）：

  1. 快照 base_id            —— 库存行的权威线索
  2. 快照 sku → SKU 索引     —— 报废/退回/借还（单据表有 sku、无 base_id）
  3. target_name 是 SKU      —— 库存/退回/报废 的 UPDATE 行（无快照）
  4. 快照 parent_id          —— BOM 关系行
  5. target_id 唯一命中股票表 —— target_name 为 'stock_buy ID:N' 的入库行

★ 「按 SKU 匹配」不能直接查 material_base —— 那张表**没有 sku 列**，
  SKU 在 7 张流水/库存表上（stock_buy/semi/product、stock_adjustment、
  stock_service、trans_defective_goods、trans_repair）。故建 SKU→base_id
  索引：把这些表 UNION 后要求一个 SKU 只对应一个物料。
  实测并集 2178 个 SKU、0 歧义；审计里 432/438 个 SKU 型 target_name 可解。
  表名从 information_schema 动态枚举并缓存，**不硬编** —— 硬编清单在加表时
  会静默漏掉（本项目反复踩过的漂移）。

★ SKU 形状护栏 ^\d{10}$：实测库里 2178 个 SKU **全部**是 10 位纯数字，
  而字母开头的 target_name（bom_no/单号/角色码）与 SKU 集合命中数为 0 ——
  护栏既不误伤也不漏，挡掉了"拿单号当 SKU 查"的误配风险。

★ 第 4 条取 parent_id 而非 child_id：BOM 行的 bom_no（操作对象）属于父件，
  实测同一 bom_no 的所有子行 parent_id 一致（'IH-L2V1J' → parent 44）。
  用子件会显示成只在 BOM 里出现一次的小零件名。

★ 编码段优先用库里的 target_name：单号（BOR-…）、bom_no（IH-L2V1J）本身
  就是业务标识，比 SKU 更能定位记录 —— 把「BOR-…」换成 SKU 是**换掉**了
  有用信息。只有 target_name 是内部兜底形态（'stock_buy ID:1667'）时才用 SKU。

★ 批量查询：先扫一遍收集线索再批量查，全程恒为 5 次查询（SKU 索引 1 +
  股票表 3 + material_base 1），与页大小无关。实测 20 条与 200 条都是 5 次。

效果（真实数据）：
  OUT-20260915-0909-0001 - SIF金属箱门包边 (061工)
  BOR-20260922-0001 - 防水余弦接收器 (FOV0008/FOV0008)
  IH-L2V1J - 穹顶光源V1J (IH-L2V1J/类A)
  0000001180 - 华为路由AX3 wifi6路由器3000M (Det0001/Det0001)
覆盖率 972/4000 → 2985/4000，与快照 base_id **零冲突**。

摘要联动：CREATE/DELETE 摘要的「物料」段取自解析结果（快照里只有 sku，
名称在 material_base 上），形如
  「新增（报废管理）：华为路由AX3 wifi6路由器3000M、数量 1 件」。
物料名排在数量/位置之前；短名如「防水余弦接收器」不加截断。

验证：24 + 16 项断言全过（五级路径逐条覆盖、错误率为 0、业务单号保留为
编码段、查询次数恒定、导出口径与列表一致、权限 401/403/200、字典零遗漏）；
vue-tsc --noEmit 与 vite build 均 exit=0。
日报回归：三天附件 490.5K / 193.4K / 10.3K，6 列结构未变。

2026-09-28 10:25:55 +08:00