UML(Unified Modeling Language)は、システムや業務の構造・振る舞いを図で表現し、業務担当者・企画担当者・開発担当者の認識をそろえるためのモデリング手法です。
具体例を見るときに重要なのは、「ユースケース図を描いた」「クラス図を使った」という図の種類だけを見ることではありません。どのような背景と課題があり、なぜUMLを使い、どの図を選び、図同士をどうつなぎ、どんな要件・設計判断につなげたかまでを見ることです。
この記事では、申請管理システム、営業案件管理システム、外部API連携を伴う注文処理の3ケースを、背景→課題→なぜUMLか→実際の適用→判断→結果→学びの流れで解説します。
ケース1:申請管理システムで利用者と機能範囲を整理する
背景
社内の経費・稟議申請をExcelとメールで運用しており、新しい申請管理システムを企画することになりました。申請者、承認者、管理者が関わりますが、部門ごとに運用が少しずつ異なっていました。
課題
企画会議では「申請を登録できる」「承認できる」といった機能名は出るものの、誰がどの機能を使うのか、どこまでをシステム化するのか、承認権限はどう分けるのかが曖昧でした。
なぜUMLを使うのか
利用者と機能の関係を整理するユースケース図、申請から承認までの流れを整理するアクティビティ図、状態変化を整理するステートマシン図を組み合わせることで、機能範囲と業務ルールを別々の視点から確認できるためです。
実際の適用
まずユースケース図で、主なアクターと機能を整理しました。
- 申請者:申請作成、申請提出、差し戻し修正、進捗確認
- 承認者:申請確認、承認、差し戻し
- 管理者:承認経路設定、申請種別設定、利用者管理
次に、アクティビティ図で「申請作成→必須項目確認→提出→承認者確認→承認/差し戻し→完了」という流れを描きました。差し戻し時は申請者へ戻るループを明示しました。
さらにステートマシン図で、申請状態を「下書き→申請中→承認済み」「申請中→差し戻し→下書き」と整理しました。
判断
図を照合した結果、「承認者は自部門の申請だけを承認できる」「差し戻し後は同じ申請IDで再提出する」「承認済み申請は申請者が編集できない」という権限・状態ルールを要件として確定しました。
結果
誰が何をできるか、申請がどの状態を遷移するかが明確になり、画面一覧だけでは見落としていた権限条件や差し戻しルールまで要件として整理できました。
学び
利用者と機能だけならユースケース図、業務の流れならアクティビティ図、状態変化ならステートマシン図と、確認したい論点ごとに図を分けることで、要件の抜けを減らせます。
ケース2:営業案件管理システムで業務フローとデータ構造をつなぐ
背景
営業部では案件情報をExcel、メール、個人メモで管理していました。案件の進捗、承認状況、顧客との活動履歴が分散し、マネージャーが最新状況を把握しにくい状態でした。
課題
「案件を登録する」「進捗を更新する」といった機能だけを並べても、承認前後で何が起こるか、どのデータを保存すべきか、差し戻し理由や活動履歴をどう持つかが決まりませんでした。
なぜUMLを使うのか
ユースケース図で機能範囲を決め、アクティビティ図で業務の流れを整理し、シーケンス図で処理順序を確認し、クラス図で必要なデータ構造を定義することで、機能・処理・データを一貫した要件として確認できるためです。
実際の適用
ユースケース図では、営業担当、上長、管理者をアクターとして、案件登録、進捗更新、承認依頼、承認、レポート確認を整理しました。
アクティビティ図では、案件登録から承認までを次のように整理しました。
- 営業担当が案件を登録
- 必須項目を確認
- 承認依頼を送信
- 上長が内容を確認
- 承認または差し戻し
- 承認なら状態を「承認済み」へ更新
- 差し戻しなら理由を記録して営業担当へ戻す
シーケンス図では、「営業担当→Web画面→案件サービス→承認サービス→通知サービス」という処理順序を整理し、承認依頼時に案件状態を「申請中」へ更新し、上長へ通知する必要があることを確認しました。
クラス図では、顧客、案件、担当者、活動履歴、承認履歴を主要クラスとして整理しました。
| クラス | 主な属性 | 主な関係 |
|---|---|---|
| 顧客 | 顧客ID、顧客名 | 顧客1:案件0..* |
| 案件 | 案件ID、案件名、金額、状態 | 案件1:活動履歴0..*、承認履歴0..* |
| 担当者 | 担当者ID、氏名、部門 | 担当者1:案件0..* |
| 承認履歴 | 承認日時、結果、差し戻し理由 | 案件1:承認履歴0..* |
判断
図同士を照合したところ、アクティビティ図には「差し戻し」があるのに、初期クラス図には差し戻し理由を保存する場所がありませんでした。そのため、承認履歴へ「結果」「差し戻し理由」を追加しました。
また、ユースケース図の「承認」は、シーケンス図上では承認サービスを経由し、クラス図上では承認履歴として記録されるように対応関係をそろえました。
結果
利用者・機能・業務フロー・処理順序・データ構造を相互に確認でき、画面一覧だけでは見つけにくかった差し戻し理由の保存要件まで発見できました。
学び
複数のUML図は別々の成果物ではなく、同じ要件を異なる視点で確認するためのものです。図同士を照合すると、機能はあるのにデータがない、処理はあるのに権限がない、といった要件漏れを発見しやすくなります。
ケース3:注文処理の外部API連携で処理責任と例外を整理する
背景
ECシステムで注文確定後に、在庫サービス、決済サービス、配送サービスと連携する機能を追加することになりました。
課題
正常系だけを見ると「注文→在庫確認→決済→配送」の流れですが、在庫不足、決済失敗、配送登録失敗が起きたときに、どこで処理を止め、何を戻し、どの状態を保存するかが曖昧でした。
なぜUMLを使うのか
シーケンス図でシステム間のメッセージ順序と責任を整理し、ステートマシン図で注文状態を整理することで、正常系だけでなく失敗時の挙動を明確にできるためです。
実際の適用
シーケンス図では、次の順序を整理しました。
- 利用者→ECシステム:注文確定
- ECシステム→在庫サービス:在庫確保
- 在庫サービス→ECシステム:確保結果
- ECシステム→決済サービス:決済実行
- 決済サービス→ECシステム:決済結果
- ECシステム→配送サービス:配送登録
- 配送サービス→ECシステム:登録結果
正常系に加えて、次の例外も分岐として書きました。
- 在庫不足:決済せず注文を「在庫不足」で終了
- 決済失敗:確保済み在庫を解放し、注文を「決済失敗」へ
- 配送登録失敗:注文を「配送連携エラー」とし、再実行対象へ
ステートマシン図では、注文状態を「受付→在庫確保済み→決済済み→配送登録済み」とし、各失敗状態への遷移も定義しました。
判断
特に重要だったのは、「どこまで成功したら何を戻すか」です。決済失敗時は在庫を解放する、配送登録失敗時は決済を取り消さず再実行対象にする、といった補償処理を要件として明確にしました。
結果
外部APIごとの責任、正常系・例外系の処理順序、注文状態の更新ルールが明確になり、障害時の再実行・監視設計まで具体化できました。
学び
外部連携では、シーケンス図で「誰が誰に何を送るか」、ステートマシン図で「その結果、状態がどう変わるか」を組み合わせると、例外処理の抜けを減らせます。
3つのケースから分かるUMLの使い分け
- 利用者と機能範囲を決めたい:ユースケース図
- 業務フローや分岐を整理したい:アクティビティ図
- 処理順序や外部連携を確認したい:シーケンス図
- データやオブジェクト構造を整理したい:クラス図
- 状態変化やライフサイクルを整理したい:ステートマシン図
自分の業務にUMLを適用する手順
- 対象業務・システムと、確認したいことを1文で決める
- 利用者、機能、処理、データ、状態、外部システムを洗い出す
- 確認したい論点に合うUML図を選ぶ
- まず全体像を描き、必要な部分だけ詳細図へ展開する
- 正常系だけでなく、分岐・例外・差し戻しも入れる
- 複数図を使う場合は、名称・機能・データ・状態の対応を照合する
- 業務担当者と開発担当者でレビューし、要件漏れを修正する
具体例を見るときの判断ポイント
背景と課題が具体的か
「UMLで整理した」だけでなく、何が曖昧だったのか、どの認識差を解消したかったのかを確認します。
なぜそのUML図を選んだか説明できるか
ユースケース図、アクティビティ図、シーケンス図、クラス図、ステートマシン図を、確認したい論点に合わせて選んでいるかを見ます。
図同士がつながっているか
ユースケースにある機能がシーケンス図で実現され、必要なデータがクラス図にあり、状態変化がステートマシン図と一致しているかを確認します。
例外や差し戻しがあるか
正常系だけでは、実務で必要な要件を見落としやすくなります。差し戻し、エラー、再実行まで必要に応じて確認します。
結果が要件・設計判断につながっているか
図を作った結果、権限、保存データ、状態遷移、外部連携責任などが具体的に決まっているかを見ます。
まとめ
UMLの具体例では、図そのものよりも、背景、課題、なぜその図を使ったか、実際に何を整理したか、どの要件・設計判断につながったかまで一連で見ることが重要です。
申請管理では利用者・機能・状態、営業案件管理では機能・業務フロー・処理順序・データ構造、注文処理では外部API連携と例外時の状態遷移を整理しました。
自分の業務へ適用するときも、まず「何を確認したいか」を明確にし、その論点に合ったUML図を選び、必要なら複数図をつないでください。UMLは、設計図を作るためだけではなく、業務要求をシステム要件へ変換し、関係者の認識をそろえる実務ツールとして使うことで価値が出ます。