فهرست منبع

fix:仓储管理看板对应的库龄结构和安全库存预警跟随筛选仓库联动跟新

mlchen 5 روز پیش
والد
کامیت
5d2a7ee79d

+ 10 - 2
docs/仓储首页看板口径.md

@@ -40,11 +40,19 @@
 
 本节固化安全库存预警改造后的唯一口径。后端实现在 `WmsHomeMapper.xml` 的 `alertRows` 片段;前端只做归一、配色兜底与文案,**不复算任何阈值**。回归守卫见 `scripts/check-warehouse-dashboard.cjs` 的 F1 断言块。
 
+### 行集(选定仓库 = 只查该仓,2026-11-13 起)
+
+- **未选仓库(全部授权仓库汇总)**:行集=`t_main_category` 物料主数据全量,一行一个物料;没配安全库存的物料也出现(标「未配置」),行内 `warehouseId`/`warehouseName` 为空。
+- **选定了仓库**:只保留「该仓有正库存批次(`av.quantity>0`)」或「该仓有 `is_warn=1` 阈值配置(`cfg.warehouseConfigCount>0`)」的物料。否则别的仓库的物料会以「可用量 0 + 借用阈值」的形态挤进缺料 TOP5,看起来像没跟随仓库切换。
+- 两个判据**复用已算好的 av/cfg 聚合**,不得再写一遍库存子查询:逐行 `EXISTS` 版本实测把单仓查询从 0.12s 拖到 12s。
+- 阈值第三级「唯一仓级配置兜底」**只在未选仓库视图生效**:选定单仓后不借用别的仓库阈值,该物料按「未配置」处理(`pick='none'`)。
+- 断言:F1-(5) 校验收窄条件必须在 `q.warehouseId != null` 分支内、`'fallback'` 必须被 `q.warehouseId == null` 包住。
+
 ### 触发条件与短路顺序
 
-`alertRows` 对每个「(仓库,物料)」行按下列顺序判定,命中即停:
+`alertRows` 对每个物料行按下列顺序判定,命中即停:
 
-1. `unknown`(待核实):没有唯一的有效阈值配置(缺精确仓库配置、同仓同物料存在多条、阈值或基本单位不可核实),或可用量为负(锁定量超过余额)。
+1. `unknown`(待核实):没有唯一的有效阈值配置(同仓同物料存在多条、阈值不可核实),或可用量为负(锁定量超过余额)。
 2. `critical`(缺料):可用量 < 安全库存 `secure_inventory`。
 3. `warning`(偏低):安全库存 ≤ 可用量 < 安全库存 × K1。
 4. `excess`(超储):可用量 > COALESCE(最大库存, 安全库存 × K2)。

+ 23 - 2
scripts/check-warehouse-dashboard.cjs

@@ -1019,12 +1019,16 @@ assert.match(alertDefinition, /最大库存(允许为空/, '口径条必须写
 assert.match(alertDefinition, /缺料[\s\S]{0,40}偏低[\s\S]{0,40}超储/, '口径条必须写明短路顺序 缺料→偏低→超储');
 assert.match(alertDefinition, /待核实单列且不计入/, '口径条必须写明待核实单列且不计入预警条数');
 // 新口径:一行一个物料、全部授权仓库合计、阈值来源三级优先级、未配置单列不计入。
-assert.match(alertDefinition, /一行一个物料/, '口径条必须写明「一行一个物料」(清单按物料主数据全量出行,不是一条阈值配置一行)');
+assert.match(alertDefinition, /一行一个物料/, '口径条必须写明「一行一个物料」(清单按物料出行,不是一条阈值配置一行)');
+// 2026-11-13 单仓视图收窄:选定仓库后只列该仓有库存或该仓有 is_warn=1 阈值配置的物料(只查对应仓库的信息)。
+assert.match(alertDefinition, /选定仓库后只列「该仓有库存」或「该仓有 is_warn=1 阈值配置」的物料/, '口径条必须写明选定仓库后的行集收窄规则(该仓有库存 或 该仓有 is_warn=1 阈值配置)');
+assert.match(alertDefinition, /未选仓库=物料主数据全量/, '口径条必须写明未选仓库时仍是物料主数据全量(不能把收窄规则说成全量)');
 assert.match(alertDefinition, /全部授权仓库合计/, '口径条必须写明可用量按全部授权仓库合计(含待检/未放行)');
 assert.match(alertDefinition, /选择仓库时按该仓/, '口径条必须写明选了仓库时按该仓聚合');
 assert.match(alertDefinition, /is_warn=1/, '阈值来源优先级第一级必须是该仓 is_warn=1 配置');
 assert.match(alertDefinition, /物料全局配置/, '阈值来源优先级第二级必须是物料全局配置');
-assert.match(alertDefinition, /唯一仓级配置兜底/, '阈值来源优先级第三级必须是唯一仓级配置兜底');
+assert.match(alertDefinition, /唯一仓级配置兜底(仅「全部授权仓库」视图/, '第三级兜底必须限定在全部授权仓库视图(选定单仓后不得借用别的仓库阈值)');
+assert.match(alertDefinition, /选定仓库后不再借用其它仓库的阈值/, '口径条必须写明选定单仓后不借用其它仓库阈值');
 assert.match(alertDefinition, /完全没有阈值配置=「未配置」(不计入预警条数)/, '口径条必须写明完全没有阈值配置=未配置且不计入预警条数');
 assert.match(alertDefinition, /阈值非法或多份冲突=「待核实」/, '口径条必须写明阈值非法/多份冲突=待核实');
 assert.match(alertDefinition, /未配置/, '口径条必须出现「未配置」');
@@ -1081,6 +1085,19 @@ if (!fs.existsSync(alertMapperPath)) {
   // 阈值落库:max_inventory 允许留空 → jdbcType=DECIMAL 无条件写,留空写 NULL。
   assert.match(alertMapperXml, /max_inventory=#\{q\.maxInventory,jdbcType=DECIMAL\}/, '阈值 insert 必须显式 jdbcType=DECIMAL(max_inventory 允许留空写 NULL)');
   assert.match(alertMapperXml, /max_inventory=#\{q\.maxInventory,jdbcType=DECIMAL\},update_user_id/, '阈值 update 必须显式 jdbcType=DECIMAL(留空写 NULL,不能要求必填)');
+  // —— 2026-11-13 单仓视图收窄(用户口径「只查询对应仓库的信息」)——
+  // ① 行集:选定仓库时只保留「该仓有库存(av.quantity>0)或该仓有 is_warn=1 阈值配置(cfg.warehouseConfigCount>0)」;
+  //    判据必须复用 av/cfg 两个已算好的聚合,禁止再写一遍库存子查询(逐行 EXISTS 实测 13s → 0.1s)。
+  const warehouseRowSetBlock = /<if test="q\.warehouseId != null">\s*AND \(COALESCE\(av\.quantity,0\)>0 OR COALESCE\(cfg\.warehouseConfigCount,0\)>0\)\s*<\/if>/;
+  assert.match(alertFragment, warehouseRowSetBlock, '选定仓库时必须按「该仓有库存 或 该仓有阈值配置」收窄行集,且复用 av/cfg 聚合');
+  assert.match(alertFragment, /SUM\(CASE WHEN v\.warehouseId=#\{q\.warehouseId,jdbcType=BIGINT\} THEN 1 ELSE 0 END\) AS whConfigCount/, 'whConfigCount 必须由 pick 聚合按该仓配置计数派生(不要新增子查询)');
+  // ② 第三级兜底(别的仓库那条配置)只能在「未选仓库」视图出现:它必须包在 q.warehouseId == null 的 if 里。
+  const pickIfStart = alertFragment.indexOf('<if test="q.warehouseId == null">');
+  assert.ok(pickIfStart > 0, '第三级兜底必须由 <if test="q.warehouseId == null"> 把关');
+  const pickIfEnd = alertFragment.indexOf('</if>', pickIfStart);
+  const pickIfBlock = alertFragment.slice(pickIfStart, pickIfEnd);
+  assert.match(pickIfBlock, /'fallback'/, "选定单仓后不得再出 'fallback'(借用别的仓库阈值)");
+  assert.match(pickIfBlock, /'ambiguous'/, '选定单仓后多份仓级配置也不得判为 ambiguous 而应落 none');
   console.log('F1-(5) 后端 SQL 静态守卫实际执行通过(未 SKIP):critical 只由 secureInventory 判、无 minInventory、K1/K2 走参数、gapAmount DESC 排序、batchRows 护栏、av 子查询 Σ 口径、缺价 NULL、workOrderCount 仅 critical、business_id CAST CHAR、max_inventory jdbcType=DECIMAL');
 }
 
@@ -1350,6 +1367,10 @@ assert.equal(warehouseState.summary.inventoryBatchCount, undefined, '切仓不
 assert.equal(warehouseState.optionsLoaded, false, '切仓重新查询筛选项');
 assert.equal(warehouseState.updatedAt, '');
 assert.equal(page.methods.defaultUnit, undefined, '默认单位链路必须整条删除:defaultUnit 不再存在');
+// 切仓后每个指标请求(含 E1 库龄结构、F1 安全库存预警)都必须带上当前仓库:参数只由 parameters() 生成,
+// 它一旦不再透传 warehouseId,后端就只能按全部授权仓库汇总——卡片看起来「不跟随仓库」。
+assert.equal(page.methods.parameters.call(warehouseState).warehouseId, 'B', '切仓后指标请求参数必须带当前仓库(E1/F1 同源)');
+assert.equal(page.methods.parameters.call(warehouseState).dashboardView, undefined, '指标请求不得混入 dashboardView(那是路由视图参数)');
 assert.equal(page.methods.applyDefaultUnit, undefined, '默认单位链路必须整条删除:applyDefaultUnit 不再存在');
 warehouseState.$route.query = { dashboardView: 'home' };
 page.methods.readRoute.call(warehouseState);

تفاوت فایلی نمایش داده نمی شود زیرا این فایل بسیار بزرگ است
+ 4 - 2
src/views/warehouseManagement/index/dashboard-screens.js


برخی فایل ها در این مقایسه diff نمایش داده نمی شوند زیرا تعداد فایل ها بسیار زیاد است