仓储首页看板口径.md 2.2 KB
仓储首页看板口径
依据 2026-10-22 的 V2.3/V2.4 变更记录实施；随附文档虽然标为 V2.2，正文中旧版的六卡、库位地图和五类动态说明不再适用。
- 首页为四格单行待办、五张 KPI（编号 01、02、03、04、06）、近 30 天出入库柱状与净趋势、分类横条，以及库龄环图、预警 TOP5、四类最近作业动态。
- 仓库筛选只用已授权仓库；默认显示全部基本单位，但数量混合单位时显示“—”并提示用户选择单位，不默认套用列表第一单位。库存数量、分类、库龄均扣锁。
- 库存总量、库存金额及库存分类分布的“查看台账”和图表点击均打开现有 /warehouseManagement/stockLedger 列表；首页不再提供自建台账明细视图，分类点击不预选台账树节点。
- 呆滞占比按批次数，不按金额；库存周转按数量快照计算并剔除调拨出库。C2 没有核实的移动加权不含税成本源时显示“—”，切勿把入库价估值当成账面金额。
- 库存总量卡片的「较上周」＝本期数量 − 7 天前日末同刻快照（后端
weekOverWeekQuantity／weekOverWeekUnit／comparisonBaseAt），仅单一基本单位且两侧快照齐全时才有值；缺基准、跨单位或后端未上线该字段时显示comparisonReason（缺省“暂无上周同时点可比快照”），差值不得以 0 代替。 - 多基本单位只在卡片内按单位平铺小计（如“个 12,000 · kg 3,400”），不跨基本单位加总；单位数超过 3 个折叠为前 3 个并注明其余单位数；
units缺省或只有 1 个单位时不渲染小计行。 - 锁定数量单列展示：单一时显示“其中锁定 X 个”，多单位时逐个单位附锁定数；
lockedQuantity为 0 是真实零按“0”显示，为 null 表示口径缺失显示“—”。 - 文档中 B2 计数指向出库单，但下钻指定 V14 入总库申请，两类单据数据源不同。代码暂按文档保留“待出库单”计数与 V14 跳转；待业务确认后再统一口径。
当前只做 Vue 模板/脚本、MyBatis XML 与差异静态校验；实际数据对账和浏览器布局仍需在有授权数据的环境核验。