レイアウトとデータの関係：一度描けば、ずっと自動更新

エディタは3D座標をwms_location_3dに書き込み、3Dページはそれをリアルタイム在庫とJOINして占有率を算出。レイアウト変更は再公開だけ——履歴データには影響しません。

よくある心配：「レイアウトを描き直したら、在庫データを入れ直すの？」答えはノー。3Dレイアウトと業務データは別々のテーブルにあり、ロケーションコード（location_id）だけで紐づきます。一度描けば、画面はずっと自動更新。

エディタが実際に書き込むもの#

• 3D座標テーブル（wms_location_3d）：1行1ロケーション——位置（x/y/z・メートル）、サイズ、向き、棚グループ、フロア。レイアウトバージョンの印付き。
• 在庫には一切触れません：在庫数・顧客・ロット/有効期限は在庫テーブルに。3Dページは描画時にlocation_idで両者をJOINします。
• 占有率は在庫残高からリアルタイムに算出（有貨ロケーション数 ÷ 総数）——だから誰も描き直さなくても色が変わります。

鮮度を保つ二重の仕組み#

• リアルタイム購読：トップバーをライブモードにすると、入庫・格納・ピッキング・棚卸の数秒後に色が更新。
• 5分スナップショット：デフォルトはサーバーが5分ごとに事前計算した集計を読みます。初回表示が速く、日常確認に十分。

倉庫レイアウト変更？再公開するだけ#

1. 棚の移動・追加・撤去：エディタでドラフトを編集（ドラッグ・回転・グループ削除）して公開。
2. 公開すると旧版は自動アーカイブ、3Dページは即座に切替。在庫・ピッキングタスク・履歴は無傷——ロケーションはコードで参照され、座標では参照されません。
3. 間違えた？「バージョン」タブから任意のアーカイブ版へロールバック。