3D 仓库可视化总览：一眼看透整个仓库

货架、通道、暂存区全部画进 3D，按占用率着色——绿色表示还能收，红色表示快满了。点任意位置看里面有什么；快照或实时两种模式。

3D 仓库可视化把 WMS 里的库存数据变成一个看得见的仓库：货架、通道、收货/发货暂存区，直接在浏览器里 3D 呈现，不用装插件。颜色告诉您哪里空、哪里满；点任意货架或库位，看里面放着什么货。

入口在哪#

• 打开 WMS App → 左侧菜单"3D 可视化"，就在"库存查询"下面。页面默认只读。
• 看菜单需要"查看"权限（wms.visualization.view）。改布局是另外一个权限，见布局编辑器那篇。
• 手机上是简化只读版；桌面端是完整版。

四种库位颜色的含义#

• 绿色——空库位：没有库存（数量=0）且已启用，可以往这排入库。
• 黄色——半满：有库存，数量在本层有货库位的中位数或以下。
• 红色——满：有库存，数量超过本层有货库位的中位数。
• 灰色——停用：该库位已被停用。

每个库位的颜色都来自实时 WMS 库存（wms_inventory_balance）：库存变，颜色就变，没有写死的演示颜色。

"占用率"到底怎么算的#

占用率算的是"个数"不是"体积"：货架里有货的库位数 ÷ 总库位数。库位里只要有货就算占，哪怕托盘只放了一半。左下角的图例常驻这一口径说明，免得有人把它当成立方米的精确数字。

快照模式 vs 实时模式#

• 快照模式（默认）：看的是服务端每 5 分钟算好的聚合数据，首屏 < 2 秒。日常查看、截汇报图用它。
• 实时模式：订阅库存变更，几秒内重新着色。右上角出现绿色"● LIVE"呼吸灯。盘点、大促盯库时用；超大仓库建议只看当前楼层。
• 顶栏一个开关，一键切换。

点进去看里面有什么#

• 鼠标悬停货架/库位：高亮描边 + 浮动小标签（编码+占用率）。
• 单击货架：右侧抽屉滑出，显示货架汇总（占用率、托盘数、Top 5 SKU）。
• 单击库位（先放大）：抽屉列出该库位全部库存行——SKU/品名、在手/已分配/可用数量、客户、放了多少天、批次/效期。
• 每个 SKU 都有"查看库存详情"，新 Tab 跳到 WMS 库存页面。