布局与数据的关联：画一次，终身自动更新

编辑器把 3D 坐标写进 wms_location_3d；3D 页面把它和实时库存 JOIN 算占用率。换货架改布局只需重新发布，历史数据不受影响。

很多人担心："重画布局，是不是库存数据要重新录一遍？"不用。3D 布局和业务数据是两张独立的表，只靠库位编码（location_id）关联。画一次，画面终身自动更新。

编辑器到底写了什么#

• 3D 坐标表（wms_location_3d）：一行一个库位——位置（x/y/z，米）、尺寸、朝向、货架组、楼层，盖上布局版本号的章。
• 它绝不碰库存：库存数量、客户、批次效期都在库存表里。3D 页面渲染时按 location_id 把两张表 JOIN 起来。
• 占用率是拿实时库存余额算出来的（有货库位数 ÷ 总库位数）——所以颜色会自己变，不用任何人重画。

双保险让画面永远新鲜#

• 实时订阅：顶栏切到实时模式，收货/上架/拣货/盘点发生后几秒内库位颜色就变。
• 5 分钟快照：默认模式读的是服务端每 5 分钟算好的聚合，首屏快，日常查看够用。

仓库改造？重新发布就行#

1. 货架挪了/加了/拆了：在编辑器里改草稿布局（拖、转、删货架组），然后发布。
2. 发布自动归档旧版，3D 页面立刻切换。库存、拣货任务、历史一概不动——它们按编码引用库位，不按坐标。
3. 发错了？版本管理里回滚到任意归档版本。