用途:当业务流程、工作流、生命周期或系统间交互难以用文字表达时,用该技能绘制示意图。流程图、状态机、消息交互等分支、并发与状态内容适合交给图;三四个步骤的线性流程应用编号列表,数据图表与实现结构不在范围内。
主要能力:按读者问题选择图种——跨组织流程用 ArchiMate 业务流程图;执行顺序与决策用活动图;状态与迁移用状态机;谁与谁按序交换消息用序列图;领域对象及关系用概念图。遵循“记法阶梯”:业务层用 ArchiMate,系统层用 PlantUML 行为图,代码层不画图。一图回答一个问题,回答两个问题应拆分。
使用方式:图源码作为文本提交到仓库,使用仓库既有工具链;未确定时默认 PlantUML(标准库含 ArchiMate),选择开放时询问负责人。一个源文件一张图,按流程命名,集中放在文档旁的 diagrams 目录。渲染由仓库自有的脚本、make 目标或构建步骤完成,由负责人搭建;缺失时告知负责人,不要改用托管平台的内联渲染。每次改动同步更新图源,并删除过期的渲染产物。
限制:参与者为系统、角色、模块与业务对象,类与方法留在代码中;边写领域语言的事件或条件,不写回调名。标题只命名流程。需要画出错误路径与异常分支,以及无法退出的状态等特殊分支。超过五张图应建索引文档,含覆盖表、模块锚点与渲染命令。图与文字各司其职,不互相复述。作者在绘制前对照代码核实每个框、箭头与守卫;推论需标注。评审看源码而非图片。