EditorialDiagram
图表目录

软件工程

Editorial 时序图设计工具 — 无阴影,告别 Mermaid 杂乱

用有序消息、虚线生命线与正确编码的返回消息梳理结账过程。八个参与者分为授权与履约两段轨迹,段间交接明确标注。

免费体验示例
100%
示例预览
Checkout trace: authorization, then fulfillment.Eight actors share one time axis in two four-lifeline panels. The final response follows fulfillment.Checkout trace: authorization, then fulfillment.ILLUSTRATIVE SAMPLE / ENGINEER01 / AUTHORIZATION02 / FULFILLMENTEight actors share one time axis in two four-lifeline panels. The final response follows fulfillment.CHECKOUTVERIFY TOKENCHECK ACCESSALLOWEDVERIFIEDCREATE ORDERRESERVERESERVEDAUTHORIZEAUTHORIZEDACCEPTED EVENTACCEPTEDBrowserGatewayIdentityPolicyOrdersStockPaymentsEvents
正在检查几何布局…

导出图表

免费 PNG 包含 EditorialDiagram 角标。

细线、讲究的排版、不加阴影。

排版规则与常见反模式

该图表的四条排版规则

  1. 01

    参与者位于虚线生命线上方,时间从上到下推进,消息水平绘制,相邻消息层级至少间隔 24px。

  2. 02

    同步调用用实心箭头;返回消息用虚线与实心箭头;单向异步消息用虚线与空心箭头。

  3. 03

    每段最多五条生命线,整个示例最多十二条消息。更大的交互拆为有名称的总览与细节轨迹。

  4. 04

    激活条覆盖实际持有控制权的区间。分支使用标注 ALT、OPT 或 LOOP 的组合片段,不画悬空的 if/else 箭头簇。

应避免的三种错误

  • 向上的消息会逆转时间,使返回看起来像新的请求。
  • 返回使用空心箭头,或异步通知使用实心箭头,会改变协议含义。
  • 深层嵌套片段与跨越无关生命线的标签,会掩盖实际参与分支的角色。

Engineer 与 Executive 密度对比

两种渲染基于同一个说明性示例。Executive 模式有意合并细节;在技术评审中使用总览前,请先阅读图注。

Engineer / 源代码细节
Checkout trace: authorization, then fulfillment.Eight actors share one time axis in two four-lifeline panels. The final response follows fulfillment.Checkout trace: authorization, then fulfillment.ILLUSTRATIVE SAMPLE / ENGINEER01 / AUTHORIZATION02 / FULFILLMENTEight actors share one time axis in two four-lifeline panels. The final response follows fulfillment.CHECKOUTVERIFY TOKENCHECK ACCESSALLOWEDVERIFIEDCREATE ORDERRESERVERESERVEDAUTHORIZEAUTHORIZEDACCEPTED EVENTACCEPTEDBrowserGatewayIdentityPolicyOrdersStockPaymentsEvents

八个参与者身份与十二条消息保留在两段各四条生命线的轨迹中。

Executive / 决策总览
Checkout: four capabilities, one successful order.Protocol messages are grouped by business capability; use Engineer for the full trace.Checkout: four capabilities, one successful order.ILLUSTRATIVE SAMPLE / EXECUTIVEProtocol messages are grouped by business capability; use Engineer for the full trace.REQUESTVERIFIEDAUTHORIZEAPPROVEDCustomerAccessFulfillmentPayment

四个业务参与者概括成功结账,省去逐条协议交换。

关于该图表的常见问题

为何把八参与者结账示例拆成两段轨迹?

八个角色超出每段最多五条生命线的参考预算。示例将四个授权角色放在左侧,四个履约角色放在右侧,并标明网关向订单服务的交接。八个身份全部可见,每段的消息间距也能保持可读。

如何区分返回消息与异步通知?

两者都可能使用虚线,所以箭头形态很重要。同步调用的返回保持实心箭头;Orders 到 Events 的通知使用空心箭头,因为它是单向事件。线型不能替代从上到下的消息顺序。

Executive 模式会保留全部令牌与库存消息吗?

不会。它合并为 Customer、Access、Fulfillment 与 Payment 四个业务参与者,讲清成功结账的主线。令牌校验、库存预留、支付返回和订单接收事件应在 Engineer 模式中查看。

示例使用说明性数据。编辑后的新布局需要 AI 服务;缓存预览可立即查看。

缓存示例可免费试用。Starter Pack 为 US$9.9 一次性购买;Pro Pass 为每月 US$8.9。每次生成固定消耗 10 积分,包含一次自动几何修正。 价格