「注文する」機能を作るとき、開発者は画面の流れと内部のオブジェクト呼び出しを1つの図に混ぜて説明してしまいがちです。
一方、企画担当者が知りたいのは「顧客が何を入力すると、システムが何をするのか」です。
この2つの問いを分けて答えるための道具が
システムシーケンス図
(system sequence diagram, SSD)です。
UMLシーケンス図がオブジェクトどうしの呼び出しを示すのに対し、SSDはシステムの外にいるアクターとシステム全体との間のやり取りだけを示します。
SSDは、
アクター
(actor)とシステムの間で行き来する
システムイベント
(system event)だけを表します。
ここでシステムはブラックボックスです。
内部にどのオブジェクトがあり、どのメソッドが呼ばれるかは描きません。
そのため、要求分析の段階で機能の範囲と入出力を確認するのに適しています。
ユースケースの基本フローを1行ずつ読み、アクターがシステムに要求する行動を探します。
「注文する」ユースケースの基本フローが次のとおりだとします。
- 顧客が商品番号と数量を入力して、商品をカートに入れます。
- 顧客が注文を確定します。
- 顧客が支払い情報を入力します。
- システムが注文番号を表示します。
1から3までは顧客がシステムに送るイベントで、4はシステムが返す応答です。
イベントの名前は、利用者の意図が伝わるように付けます。

顧客アクターがカート追加、注文確定、支払いのイベントをシステムの箱に送り、システムが注文番号を返すシステムシーケンス図
SSDもUMLシーケンス図もメッセージの順序を描くため、似て見えます。
しかし、描くものが異なります。
| 区分 | システムシーケンス図 | UMLシーケンス図 |
|---|
| 描く対象 | アクターとシステム全体 | システム内部のオブジェクト |
|---|
| メッセージの性質 | 利用者がシステムに送るイベント | オブジェクト間のメソッド呼び出し |
|---|
| 主に使う段階 | 要求分析 | 設計 |
|---|
| 確認する内容 | 機能の範囲と入出力 | オブジェクトの協調の仕方 |
|---|
この区別を守らないと、「決済承認APIを呼び出す」や「注文を保存する」といった内部の呼び出しがSSDに入り込みやすくなります。
すると機能の範囲があいまいになり、設計の判断が要求文書に混ざってしまいます。
👍
SSDに内部の呼び出しを入れると、要求のレビューで企画担当者が判断できない技術用語が増えてしまいます。
イベントは必ず
アクターの立場
から書いてください。
完成したSSDは、次の基準で確認します。
- イベントが、システムの外にいるアクターの行動として書かれているか
- 同じ機能のイベントが、複数のユースケースで別の名前になっていないか
- 各イベントの引数が、必要な情報だけを含んでいるか
たとえば「カートに追加」の引数には商品番号と数量は必要ですが、商品の価格や在庫数は必要ありません。
価格と在庫はシステムが判断すべき情報なので、イベントから外すのが自然です。
👨💻
同じイベントが複数のユースケースに登場する場合は、最初から名前を統一しておいてください。
イベントの名前が揺れると、後の段階で同じ機能を2回実装してしまいやすくなります。
システムシーケンス図は、アクターがシステムに送る
システムイベント
だけを示す道具です。
ユースケースの基本フローからイベントを見つけ、内部の呼び出しと区別して描けば、企画担当者も読める図で機能の範囲を確認できます。