AI開発

状態遷移図とシーケンス図|違いと使い分け

株式会社Atsumell|8分で読めます
状態遷移図とシーケンス図|違いと使い分け

はじめに

システム開発の打ち合わせで「状態遷移図もシーケンス図も必要です」と言われたとき、どちらも矢印で流れを描く図に見えて、違いが分からないことがあります。発注側が確認したいのは、記号を正確に暗記することより、図を使って何が決まり、何がまだ決まっていないかです。

結論から言うと、状態遷移図は一つの対象がどの状態からどの状態へ変わるか、シーケンス図はある場面で人やシステムがどの順にやり取りするかを確かめる図です。この記事では経費申請を例に、違いと使い分け、二つの図を照合する手順を整理します。

状態遷移図とシーケンス図の違い

状態遷移図は、申請書や注文といった対象の状態と、状態を変えるイベント・条件に注目します。例えば、申請書が「下書き」から「申請中」になり、その後「承認済み」または「差し戻し」になるという変化です。対象を一つに絞ると、どの状態で何ができるかを話し合いやすくなります。

一方、シーケンス図は、利用者、画面、申請サービス、通知サービスなどを並べ、メッセージの順序を示します。「承認者が承認する」場面で、画面が申請サービスに依頼し、結果を受け取って表示するまでを追う、といった使い方です。必ず全経路を一枚に詰め込む必要はなく、確認したい場面ごとに分けられます。

比較する点状態遷移図シーケンス図
主に見るもの対象の状態と変化の条件参加者間のやり取りの順序
経費申請での例申請中から承認済みへ変わる承認操作から結果表示までの依頼と応答
見つけたい問いいつ取消できるか、差し戻し後はどうなるかどこで失敗を検知し、誰に何を返すか
単独では見落としやすい点外部サービスとの細かな処理順序他の状態から実行できるか、未検討の場面

PlantUMLの状態遷移図とシーケンス図の公式資料でも、それぞれ状態の変化と参加者の間のメッセージを別の図として扱っています。同じ「承認」を見ていても、注目点が違います。

経費申請を例に、二つの図をつなぐ

例として、申請者が経費を申請し、承認者が承認する業務を考えます。会社ごとにルールは異なるため、以下は説明用の仮の設計です。

1. まず申請書の状態と遷移を決める

申請書の状態を「下書き」「申請中」「差し戻し」「承認済み」「取消済み」とします。申請者による申請で下書きから申請中へ移り、承認者による承認で承認済みへ移る、という関係です。

ここで重要なのは、矢印に操作名だけでなく条件を添えることです。例えば「承認者が、申請中の申請を承認した場合に限る」とします。差し戻し後に編集できる人、承認済みの取消を認めるか、同時に二人が承認した場合も、未決なら未決と記録します。

状態遷移図の書き方では、状態、イベント、条件、処理を分けて整理しています。状態名と「承認する」のような操作名を混ぜないことが、後の照合の出発点です。

2. 一つの操作を選び、やり取りを追う

次に「承認者が申請中の申請を承認する」という一場面を選びます。例えば次の順序です。

  1. 承認者が画面で承認を選ぶ。
  2. 画面が申請サービスに申請IDと承認操作を送る。
  3. 申請サービスが権限と現在の状態を確認する。
  4. 条件を満たせば申請を承認済みに更新し、画面へ結果を返す。
  5. 通知を依頼し、画面は承認結果を表示する。

この例では、通知の失敗を承認自体の失敗にするかどうかは決めていません。業務担当者と開発者が、更新後に通知が失敗した場合の扱いを別途決める必要があります。処理順序の具体化はシーケンス図の書き方も参考になります。

3. 失敗時に状態と表示が食い違わないか確認する

正常時だけでなく、承認依頼が届かなかった場合と、更新後に応答だけが届かなかった場合を分けて考えます。画面がタイムアウトしたことだけでは、申請が更新済みかどうか分かりません。利用者に再操作を案内する前に、現在の状態を確認できる方法が必要です。

例えば「処理結果を確認中」と表示し、再取得で承認済みなら完了を表示する案があります。ただし、確認できない場合の対応、二重処理の防止、担当者への引き継ぎは実際の仕組みに応じて決めます。自動再試行を入れるだけで安全になるとは限りません。

どちらを先に使う?判断の目安

「承認後も修正できるのか」「取消した申請を再開できるのか」が曖昧なら、まず状態遷移図で対象のライフサイクルを整理します。状態の定義と操作できる条件が固まると、必要な場面を選びやすくなります。

「画面、社内システム、外部サービスのどこで処理が止まるか」「結果を誰が受け取るか」が曖昧なら、先にシーケンス図で一場面の境界を描く方法もあります。図を作る順番に唯一の正解はありません。話し合いで見つかった状態や例外を、もう一方へ戻して更新することが大切です。

また、状態とイベントの組み合わせが多いときは、表にして抜けを確認できます。IPAの設計資料も、状態遷移図と表を併用し、図で全体像を把握しながら表で漏れを点検する方法を示しています。図を書けば漏れが自動的になくなるわけではありません。

発注側がレビューで確認したい5項目

  • 対象は明確か:状態を持つのは申請書なのか、承認作業なのか。複数の対象が混ざっていないか。
  • 操作と条件は一致するか:状態遷移図で「申請中のみ承認可」なら、シーケンス図にも権限・状態の確認があるか。
  • 失敗後の状態は分かるか:通信失敗、権限不足、通知失敗を同じエラーにせず、保存済みかどうかを確認できるか。
  • 判断者が決まっているか:取消や再試行など、業務ルールを誰が確定し、未決事項をどこに残すか。
  • テストにつながるか:開始状態、操作、期待する状態と表示を一組にして、受け入れ時に確認できるか。

例えば「申請中の申請を権限のない人が承認する」というケースなら、期待結果は「状態は申請中のまま、承認できなかったことが画面に表示される」と置けます。実際の権限ルールと文言は、利用部門と開発側で合意してください。さらに承認結果が返る前に画面を閉じた場合も考えます。次に画面を開いたときに何を表示するか、最新状態をどこから確認するかを決め、状態と画面表示を一緒にテストします。

まとめ:図の目的を分け、同じ仕様を見直す

状態遷移図は対象の状態と変化の条件、シーケンス図は一場面の参加者とやり取りの順序を確認します。どちらか一枚が万能なのではなく、同じ業務を異なる角度から見て、条件や例外の食い違いを減らすための道具です。

まずは重要な申請や注文を一つ選び、状態の一覧と一つの正常シナリオを並べてみましょう。未決事項は図の外にも記録し、担当者と期限を決めてレビューします。Kakusillでは、会議メモや既存資料から業務整理のたたき台を作り、要求から設計までを整理できます。図そのものを描く前後の論点整理にも役立ちます。

#状態遷移図#シーケンス図#UML#要件定義#仕様書