# Draw.io 逻辑图创建 ## 概述以draw.io 的原生XML 格式创建专业的逻辑图。该技能可以生成可用于生产的“.drawio”文件，用于逻辑流程图、系统架构可视化以及使用通用形状和符号的抽象流程表示。 ## 何时使用在以下情况下使用此技能： * 创建显示系统组件之间数据流的逻辑流程图 * 设计逻辑架构图（抽象系统结构） * 为业务流程构建BPMN流程图 * 绘制UML图（类、序列、活动、状态） * 创建数据流程图（DFD）以进行系统分析 * 制作具有分支逻辑的决策流程图 * 可视化系统交互和序列 * 记录没有云细节的逻辑系统设计 **请勿用于：** * AWS/Azure/GCP 架构图（使用 `aws-drawio-architecture-diagrams`） * 基础设施特定图表 ## 说明 ### 创建逻辑图 1. **分析请求**：了解系统/流程以绘制图表 2. **选择图表类型**：流程图、架构、BPMN、UML、DFD等。 3. **识别元素**：确定参与者、流程、数据存储、连接器 4. **草稿 XML 结构**：使用适当的根单元创建 mxGraphModel 5. **添加形状**：创建具有适当样式的 mxCell 元素 6. **添加连接器**：将元素与边缘元素链接起来 7. **验证 XML** ：确保所有标签都是闭合的并且 ID 是唯一的 8. **输出**：为用户编写.drawio文件 ### 关键 XML 组件 * `mxfile`：带有主机和版本的根元素 * `diagram`: 包含图表定义 * `mxGraphModel`：画布设置（网格、页面大小） * `root`：所有单元格的容器（必须包含 id="0" 和 id="1"） * `mxCell`：单个形状（顶点）或连接器（边） ## Draw.io XML 结构每个“.drawio”文件都遵循以下 XML 结构： <根> **关键规则：** * ID“0”和“1”保留给根单元 * 使用从“2”开始的连续整数ID * 使用横向的架构图 * 所有坐标必须为正值并与网格对齐（10的倍数） ## 通用形状和样式 ### 基本形状类型形状|风格 ---|--- 矩形| `rounded=0;whiteSpace=wrap;html=1;` 圆角矩形| `rounded=1;whiteSpace=wrap;html=1;` 椭圆/圆 | `椭圆;whiteSpace=wrap;html=1;` 钻石 | `菱形;whiteSpace=wrap;html=1;` 气缸| `形状=圆柱体3;whiteSpace=wrap;html=1;boundedLbl=1;` 六角| `形状=六边形；周长=hexagonPerimeter2；whiteSpace=wrap；html=1；` 平行四边形| `形状=ext;双=1;圆角=0;whiteSpace=wrap;html=1;` ### 标准调色板元素类型 |填充颜色|边框颜色|用途 ---|---|---|--- 流程| `#dae8fc`（浅蓝色）| `#6c8ebf` |操作/行动决定| `#fff2cc`（浅黄色）| `#d6b656` |条件分支开始/结束 | `#d5e8d4`（浅绿色）| `#82b366` |终端状态数据/存储| `#e1f5fe`（浅青色）| `#0277bd` |数据库/文件实体| `#f3e5f5`（浅紫色）| `#7b1fa2` |外部系统错误/停止 | `#f8cecc`（浅红色）| `#b85450` |错误状态演员/用户| `#ffe0b2`（浅橙色）| `#f57c00` |用户/参与者集装箱| `#f5f5f5`（浅灰色）| `#666666` |分组区域 ### 连接器样式 **标准流量：** edgeStyle = orthogonalEdgeStyle;rounded = 0;orthogonalLoop = 1;jettySize = auto;html = 1;endArrow = classic;endFill = 1;中风颜色=#666666;中风宽度= 2; **虚线（替代/可选）：** edgeStyle=orthogonalEdgeStyle;虚线=1;dashPattern=5 5;行程颜色=#666666; **箭头样式：** * `endArrow=classic;endFill=1` \- 填充三角形 * `endArrow=open;endFill=0` \- 打开箭头 * `endArrow=blockThin;endFill=1` \- 块箭头 ## 图表类型 ### 1\.逻辑流程图显示通过系统组件的数据或进程的逻辑流： ┌──────────┐ ┌──────────┐ ┌──────────┐ │ 用户 │────▶│ 服务 │────▶│ 数据 │ └──────────┘ └──────────┘ └──────────┘ **关键要素：** * 演员/用户（橙色） * 服务/流程（蓝色） * 数据存储（青色） * 外部系统（紫色） * 数据流（实线箭头） ### 2\.逻辑架构图系统组件的抽象表示： ┌──────────────────────────────────────────┐ │ 表示层 │ │ ┌──────────────┐ ┐──────────────┐ │ │ │ 网页用户界面 │ │ 移动设备 │ │ └──────────────┘ └──────────────┘ │ └──────────────────────────────────────────┘ │ ┌──────────────────────────────────────────┐ │ 应用层 │ │ ┌──────────────┐ ┐──────────────┐ │ │ │ API │ │ 业务 │ │ │ │ 网关 │ │ 逻辑 │ │ │ └──────────────┘ └──────────────┘ │ └──────────────────────────────────────────┘ │ ┌──────────────────────────────────────────┐ │ 数据层 │ │ ┌──────────────┐ ┐──────────────┐ │ │ │ 数据库 │ │ 缓存 │ │ │ └──────────────┘ └──────────────┘ │ └──────────────────────────────────────────┘ ### 3\. BPMN 流程图业务流程建模：符号|含义 ---|--- 圈 |开始/结束事件圆角矩形|活动/任务钻石 |网关/决策箭头|顺序流程 ### 4\. UML序列图组件之间的交互： ┌──────────┐ ┌──────────┐ ┌──────────┐ │ 演员 │ │服务 A │ 服务 B │ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │──────────────▶│ │ │ │──────────────▶│ │ │◀──────────────│ │◀──────────────│ │ ### 5\.数据流程图 (DFD) 系统数据移动： * **外部实体**（方形）- 源/目的地 * **过程**（圆形/圆角）- 转换 * **数据存储**（空心矩形）- 存储 * **数据流**（箭头）- 数据移动 ## 形状示例 ### 简单处理盒 ### 决定钻石 ### 开始/结束椭圆形 ### 数据存储（圆柱体） ### 连接器/箭头 ### 连接器上的标签 ## 布局最佳实践 1. **流动方向** ：从左到右或从上到下一致 2. **间距**：元素之间40-60px，容器内20px 3. **网格对齐** ：所有坐标均为10的倍数 4. **标签放置**：水平箭头上方，垂直箭头右侧 5. **容器分组** ：使用圆角矩形进行逻辑分组 6. **平衡**：保持图表居中，避免极端空白 ## 参考文件有关详细模板和形状参考，请参阅： * [shape-styles.md]() \- 完整的形状和样式参考 * [diagram-templates.md]() \- 即用型模板 ## 示例 ### 示例 1：简单订单处理流程 **用户请求：**“创建一个显示订单处理的逻辑流程图：客户提交订单，系统验证，如果有效则处理付款并发货，如果无效则通知客户。” **生成的 XML：** <根> ** ** ### 示例 2：三层逻辑架构 **用户请求：**“为具有表示层、业务逻辑层和数据层的 Web 应用程序创建逻辑架构图。” **生成的 XML：** <根> ** ** ### 示例 3：微服务通信流程 **用户请求：**“创建一个逻辑图，显示具有 API 网关、多个服务和用于异步通信的消息队列的微服务架构。” **参考：** 请参阅 [diagram-templates.md]() 了解完整的微服务模板。 ## 限制和警告 ### 关键限制 1. **XML有效性**：始终正确关闭标签并转义特殊字符 2. **Unique IDs** : 所有单元格 ID 必须是唯一的（父单元“0”和“1”除外） 3. **有效引用**：源/目标必须引用现有的单元格 ID 4. **正坐标** ：所有 x、y 值必须 >= 0 ### 警告 * XML 文件必须格式正确，否则将无法在 draw.io 中打开 * 无效的父引用导致元素消失 * 负坐标将元素放置在可见画布之外 ## 最佳实践 ### 视觉指南 1. 每种元素类型使用一致的颜色 2. 保持箭头笔直，尽量减少弯曲 3. 将标签放置在距箭头线至少 20 像素的位置 4. 将相关元素分组到容器中 5.标签使用12-14px字体，注释使用10-11px字体 ### 辅助功能 1.使用高对比度的颜色 2.不要仅仅依靠颜色来传达意义 3. 包含所有形状的文本标签 4. 为复杂流程添加注释

绘制逻辑图

包含技能