3D自動配置：新規ロケーションは自動で3Dに配置される

倉庫設定で自動配置をONにすると、標準コードの新規ロケーションはコードから3D位置が自動計算され、手動配置は不要です。非標準コードはブロックされず、修正対象としてフラグ付けされます。

3D座標のないロケーションは3D倉庫に表示されません。自動配置以前は、新規ロケーションを一つずつ手動で配置する必要がありました——デモ倉庫の9,000超の手動配置ロケーションと同じ苦労です。自動配置はこの作業を不要にします。システムがロケーションコードを読み、通路／列／ベイ／段を解釈して3D位置を計算し、レコードを書き込みます。コードが倉庫標準に沿わない場合は、推測せず明確に示します。

動作の流れ#

2つのトリガー#

• ロケーション作成——POST /api/wms/locations 成功後、そのロケーションに3D座標がなく自動配置がONなら、システムがバックグラウンドで位置を生成。失敗しても作成はブロックされません。
• 一括配置——POST /api/wms/locations/auto-layout に倉庫IDを渡すと、座標のない全ロケーションを一括配置。レスポンスは配置数（laid_out）とスキップ一覧（skipped_non_standard、skipped_virtual）を返します。

倉庫設定での設定方法#

倉庫設定に「3D自動配置」カードがあります。マスタースイッチはありません——コード正規表現を空欄のままにすると自動配置は無効、入力すれば下のフィールドを設定します。ライブプレビュー欄に任意のコードを入力すると解析結果が即座に表示されます——標準かどうか、どの通路／列／ベイ／段に解釈されたか。保存前に正規表現を検証できます。

• コード正規表現（名前付きグループ aisle / row / bay / level）——ゾーンはコードではなくロケーションのzone列から。デフォルトは A(通路)-R(列)-B(ベイ)-L(段) 形式に一致します（例：STORAGE-A001-R1-B001-L1）。
• ベイ幅（メートル、デフォルト2.7）、段高（1.8）、通路ピッチ（6.0、棚奥行き含む）、原点オフセット X/Y/Z（0）。
• 位置の計算：x = 原点x + 通路 × 通路ピッチ + ベイ × ベイ幅；y = 原点y + 列 × 1.2m；z = 原点z + (段 − 1) × 段高；サイズ = ベイ幅 × 1.2 × 段高。

非標準コード：フラグ付けのみ、ブロックしない#

自動配置はコード標準チェックも担います。倉庫の正規表現に一致しないコードは CODE_NOT_STANDARD を返し、座標は書き込まれません。ロケーション一覧の「3Dステータス」列に表示され、倉庫全体の非標準一覧をCSVでエクスポートして倉庫チームが修正できます。非標準コードでロケーションの作成がブロックされることはありません。

自動配置が触れないもの#

• 手動配置の座標が最優先——自動配置は座標のないロケーションのみ埋め、上書きはしません。
• レイアウトエディタや建物シェル取り込みは不変。自動配置は同じ座標レコードを書き込むだけです。
• カバレッジ監視：GET /api/wms/locations/layout-status?warehouse_id=… で各ステータスの件数（座標あり／未配置／非標準／仮想）を返し、カバレッジの改善を追えます。