YMS 堆场布局编辑器：生成与编辑堆场布局

一键自动生成堆场布局，或用四步向导自己画：外形、功能区、车位与 Dock 门，再 3D 预览、保存草稿并发布。

布局就是告诉 Docklify 您的堆场实际长什么样：围栏边界在哪、哪些区域是集装箱箱区、底盘停放区或冷藏插电区、每个车位和 Dock 门在什么位置。3D 堆场视图画的就是这份布局。布局编辑器（YMS → 3D 堆场视图 → 布局编辑器，/yms/visualization/layout-editor）有两种做法：快速模式一键生成草稿，复杂模式用四步向导自己画。编辑操作建议用桌面端，手机端适合查看。

开始前：选堆场、给布局起个名字#

• 在顶部选择器里选堆场。堆场来自 YMS → 堆场；切换堆场会载入该堆场已保存的草稿，还没有草稿时就是一份空白草稿。
• 在旁边给布局起个名字（例如「3 号堆场布局 v2」），以后不同版本容易区分。
• 「保存草稿」和「发布」按钮一直在顶栏——随时可以先存下来，之后再继续编辑。

快速模式：一键生成草稿#

1. 打开「快速模式」页签。
2. 确认选对了堆场，点「一键生成草稿」。
3. 草稿按堆场数据的箱位编号规律自动生成——和 3D 页面上的自动生成完全一致。堆场同事发布后，3D 视图即可查看。

快速模式是拿到一份可用布局的最快办法。堆场形状不规整，或者您需要精确控制功能区、车位和 Dock 门的位置时，用复杂模式。

复杂模式第一步：画堆场外形#

1. 选一个画图工具：矩形（按住拖拽画出）、L 形（先拖出外接矩形，再从某个角向内拖拽切掉缺角）、多边形（点击打点，双击或点回起点闭合；Esc 取消）。
2. 可以上传一张平面图做底图，照着描边；画完可以把底图移除。
3. 要微调时，切到「选择/编辑」，拖拽外形的顶点调整形状。选中一个顶点后按删除键可以去掉该顶点。
4. 外形至少要有 3 个点才能往下走——没有外形时，后面的步骤是锁定状态。

复杂模式第二步：标功能区#

1. 点「新增功能区」，选好类型、起个名字（例如「箱区 A」），然后在堆场外形内画出该区域的形状——点击打点，双击闭合。画到外形外面的功能区会被拦下。
2. 选中一个功能区可以改名、改类型或颜色，也可以拖拽它的顶点调整形状，或者删除它。

• 功能区有十种类型，每种有默认颜色：集装箱箱区、底盘停放区、冷藏插电区、危险品隔离区、闸口区、维修区、办公区、暂存区、停车区、其他。

复杂模式第三步：标车位和 Dock#

1. 选一个功能区，设置排数和列数，选车位尺寸（20 尺或 40 尺）和编号前缀，点「批量生成车位」。车位按前缀编号（如 A-01、A-02……），只有落在该功能区内的车位会被保留。
2. 要标 Dock 门，打开「标 Dock 门」后在堆场边缘点击：一个 Dock 门（D-01、D-02……）会放在那里，并自动关联最近的功能区。按 Esc 退出 Dock 工具。
3. 任何车位或 Dock 门都可以拖拽微调位置；选中后按 Delete 键删除。

复杂模式第四步：3D 预览、保存草稿、发布#

1. 最后一步会按当前草稿生成 3D 预览——空箱位、还没有集装箱——下方显示功能区、车位和 Dock 的数量。转一圈看看堆场画得对不对。
2. 点顶栏的「保存草稿」。如果外形少于 3 个点，编辑器会先把您送回第一步。
3. 点「发布」，这份布局就成为 3D 页面使用的布局。草稿从未保存过时，编辑器会先提示保存。

本文用到的 Docklify 功能#

• 布局编辑器（选堆场 + 布局名称）——YMS → 3D 堆场视图 → 布局编辑器（/yms/visualization/layout-editor）
• 快速模式一键生成草稿——布局编辑器 → 快速模式 → 一键生成草稿
• 外形绘制工具（矩形 / L 形 / 多边形、平面图底图）——布局编辑器 → 复杂模式 → 第一步
• 功能区标注（十种功能区类型）——布局编辑器 → 复杂模式 → 第二步
• 批量生成车位与标 Dock 门——布局编辑器 → 复杂模式 → 第三步
• 3D 预览、保存草稿与发布——布局编辑器 → 复杂模式 → 第四步，以及顶栏的保存草稿 / 发布按钮