MENU

ユースケースで失敗しやすいポイント|よくある間違いと改善策

ユースケースは、システムや業務に関わる利用者(アクター)の視点から、「誰が」「どんな目的で」「システムとどうやり取りし」「何を達成するのか」を整理するための手法です。

ただし実務では、機能一覧になってしまう、アクターが曖昧、基本フローだけで終わる、詳細仕様を書き込みすぎる、代替フローと例外フローを混同する、事前条件・事後条件がない、粒度が不適切、関係者レビューをしない、といった失敗が起こりやすくなります。

この記事では、ユースケースでありがちな失敗を、具体的な失敗場面、原因、改善策、改善前後、改善後の状態までセットで解説します。最後に、自分のユースケース運用を点検できるチェックポイントもまとめます。

目次

失敗1:機能一覧になってしまう

具体的な失敗場面

要件定義で「検索する」「登録する」「一覧表示する」「CSV出力する」といった機能名だけを並べ、ユースケースとして整理したつもりになるケースです。

原因

利用者の目的ではなく、画面や機能を出発点にしています。

改善策

  • 誰が使うかを特定する
  • どんな場面で何を達成したいかを確認する
  • ユースケース名を「利用者の目的達成単位」で付ける
  • 機能は後から必要要件として抽出する

改善前後

改善前:「顧客検索機能」

改善後:「営業担当者が訪問準備のために顧客の最新情報を確認する」

改善後の状態

検索だけでなく、必要な表示項目、履歴、権限まで、目的達成に必要な要件を考えられるようになります。

失敗2:アクターが曖昧になる

具体的な失敗場面

アクターを「利用者」「社員」とだけ書き、申請者・承認者・管理者の違いを分けないケースです。

原因

役割ごとの目的・権限・責任を整理していません。

改善策

  • 人名ではなく役割で定義する
  • 目的や権限が異なる場合は別アクターにする
  • 外部サービスも必要なら副アクターとして扱う

改善前後

改善前:「社員が申請システムを使う」

改善後:「申請者が申請を提出する」「承認者が申請を承認する」「管理者が承認経路を設定する」

改善後の状態

役割ごとの権限とユースケースを分けて整理でき、誰に何を許可するかが明確になります。

失敗3:基本フローだけで終わる

具体的な失敗場面

「申請を入力→提出→承認→完了」だけを書き、入力不備、権限不足、承認経路未設定、通知失敗を考えないケースです。

原因

正常系だけで仕様を決め、実運用で起きる分岐・失敗を後回しにしています。

改善策

  • 通常の基本フローを先に書く
  • 正常に目的達成する別ルートは代替フローに分ける
  • 異常終了やエラーは例外フローに分ける
  • 失敗後の状態や再試行方針まで確認する

改善前後

改善前:「申請提出→承認」だけ。

改善後:10万円超は追加承認という代替フロー、入力不備・承認経路未設定・通知失敗を例外フローとして明示。

改善後の状態

正常時だけでなく、運用上の分岐や障害時の処理まで含めて要件化できます。

失敗4:詳細仕様を書き込みすぎる

具体的な失敗場面

企画段階のユースケースに、ボタン名、画面レイアウト、DB項目、APIパラメータまで細かく書き込み、目的と業務フローが見えなくなるケースです。

原因

ユースケースと画面設計・詳細設計の役割を分けていません。

改善策

  • まずアクター・目的・流れ・終了状態を整理する
  • 画面や項目の詳細は後工程へ分ける
  • 要件として必要な業務ルールだけは残す

改善前後

改善前:「右上の青い提出ボタンを押す」「request_statusを1に更新する」と記載。

改善後:「申請者が提出を指示し、システムが申請状態を申請中へ更新する」と目的・振る舞いで記載。

改善後の状態

業務担当者と開発担当者が同じ内容を読みやすくなり、要件と設計の境界も明確になります。

失敗5:代替フローと例外フローを混同する

具体的な失敗場面

10万円超で追加承認が必要なケースと、必須項目不足で提出できないケースを、どちらも「例外」としてまとめるケースです。

原因

「正常に目的達成する別ルート」と「異常により通常どおり完了しないルート」を区別していません。

改善策

  • 目的を正常に達成する分岐は代替フロー
  • 目的を達成できない、または障害対応が必要な場合は例外フロー
  • フローごとに終了状態を確認する

改善前後

改善前:追加承認・入力不備・通知障害をすべて「例外」と記載。

改善後:追加承認は代替、入力不備・通知障害は例外として分離。

改善後の状態

正常な業務分岐と障害対応を分けて設計でき、状態管理やテスト条件を整理しやすくなります。

失敗6:事前条件・事後条件がない

具体的な失敗場面

「申請を提出する」と書いてあるものの、開始時にログイン済みなのか、対象申請は下書きなのか、終了後にどの状態になるのかが書かれていないケースです。

原因

操作の順番だけに注目し、ユースケース開始前・終了後の状態を定義していません。

改善策

  • 開始時点で成立しているべき条件を事前条件として分ける
  • 正常終了・異常終了後の状態を事後条件として書く
  • 状態遷移を確認する

改善前後

改善前:「提出する」で終わる。

改善後:事前条件=ログイン済み・下書き状態。正常事後条件=申請中として保存。異常事後条件=下書きを維持。

改善後の状態

テストや状態管理の基準が明確になり、関係者間で「完了」の意味をそろえられます。

失敗7:ユースケースの粒度が大きすぎる・細かすぎる

具体的な失敗場面

「受注業務を行う」のように大きすぎる場合と、「ボタンを押す」「一覧を開く」のように細かすぎる場合があります。

原因

アクターにとって意味のある目的単位で区切っていません。

改善策

  • 1つのユースケースで1つの主要目的を扱う
  • 画面操作ではなく利用者の目的で分ける
  • 基本フローと事後条件を書ける大きさにする

改善前後

改善前:「申請業務を行う」

改善後:「申請を作成する」「申請を提出する」「申請状況を確認する」「申請を承認する」へ分割。

改善後の状態

要件、権限、例外、テスト条件をユースケースごとに扱いやすくなります。

失敗8:関係者レビューをしない

具体的な失敗場面

企画担当や開発担当だけでユースケースを完成扱いし、現場担当者が後から「実際は経理確認が入る」「差し戻し時は理由必須」と指摘するケースです。

原因

ユースケースを作成者個人の成果物として扱い、業務実態との照合をしていません。

改善策

  • 業務担当者・企画担当者・開発担当者でレビューする
  • 権限・例外・状態・通知・保存データを確認する
  • 未決事項を別管理し、確定事項と混ぜない

改善前後

改善前:開発担当だけで「申請提出」を確定。

改善後:申請者・承認者・経理・開発担当でレビューし、経理確認、差し戻し理由、通知再送条件を追加。

改善後の状態

現場運用とシステム仕様のずれを早い段階で修正できます。

通し例:申請管理システムのユースケースを失敗状態から立て直す

改善前

  • 「申請管理機能」とだけ記載
  • アクターは「社員」
  • 基本フローは「入力→提出→承認」だけ
  • 追加承認も入力不備も同じ例外扱い
  • 事前条件・事後条件なし
  • 画面項目を細かく書きすぎる
  • 現場レビューなし

この状態では、誰の何を支援するのか、どの分岐を正常と扱うのか、失敗後にどの状態へ戻るのかが分かりません。

改善後

ユースケースを「申請者が申請を提出する」に絞り、主アクターを申請者、副アクターを承認者・通知サービスとしました。

事前条件:申請者がログイン済みで、対象申請が下書き状態、提出権限を持つ。

基本フロー

  1. 申請者が下書き申請を開く
  2. システムが申請内容を表示する
  3. 申請者が提出を指示する
  4. システムが必須項目を検証する
  5. システムが承認経路を特定する
  6. システムが状態を「申請中」に更新する
  7. システムが承認者へ通知する
  8. システムが提出完了を表示する

代替フロー

10万円超の場合、通常の上長承認に部長承認を追加して処理を継続する。

例外フロー

  • 必須項目不足:提出せず下書きを維持
  • 承認経路未設定:提出を止め、管理者設定が必要と表示
  • 通知失敗:申請中は維持し、通知だけ再送対象にする

事後条件:正常終了時は申請中として保存され、承認者が確認可能。入力不備・承認経路未設定時は下書きを維持する。

改善判断

この整理から、提出ボタンだけでなく、必須項目チェック、承認経路判定、状態管理、権限制御、通知、通知再送管理が要件として必要だと分かりました。

改善後の状態

正常系・分岐・異常系・終了状態が分かれ、業務担当者と開発担当者が同じ基準で仕様とテスト条件を確認できる状態になりました。

ユースケースの失敗を防ぐチェックポイント

  • 機能一覧ではなく利用者の目的から書いているか
  • アクターが役割単位で具体的か
  • 基本フローだけでなく代替・例外フローを確認したか
  • 代替と例外を混同していないか
  • 事前条件と事後条件があるか
  • ユースケースの粒度が適切か
  • 詳細設計を書き込みすぎていないか
  • 権限・状態・通知・保存データを要件へつなげたか
  • 業務担当者と開発担当者でレビューしたか
  • 未決事項を確定事項として扱っていないか

まとめ

ユースケースで失敗しやすいのは、機能一覧になる、アクターが曖昧、基本フローだけで終わる、詳細仕様を書き込みすぎる、代替フローと例外フローを混同する、事前条件・事後条件がない、粒度が不適切、関係者レビューをしないといったケースです。

失敗を避けるには、「誰が何を達成したいのか」を起点にし、正常系・正常な分岐・異常系・開始前条件・終了後状態を分けて整理し、そこから必要な機能・権限・データ・通知・状態管理を要件へ落とすことが重要です。

ユースケースは、機能一覧や操作マニュアルを作るためのものではありません。利用者の目的とシステムの振る舞いを整理し、関係者の認識をそろえる実務ツールとして使うことで効果を発揮します。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
目次