AI開発

状態遷移表の作り方と確認手順

株式会社Atsumell|9分で読めます
状態遷移表の作り方と確認手順を紹介するサムネイル

はじめに

「注文を受けたら発送する」。一見単純な業務でも、発送前にキャンセルされたらどうするのか、入金と発送の順序が前後したら何を確認するのか、と尋ねると判断が分かれることがあります。状態遷移表は、対象の現在の状態と、操作や通知などのきっかけを組み合わせ、そのときの扱いを整理する表です。

この記事では、システム開発を発注する業務担当者に向け、注文1件を例に表を作る手順を説明します。例は理解のための仮ルールであり、特定のサービスやすべての業務に共通する仕様ではありません。実際の権限、決済、返品などは自社の運用に合わせて関係者と決めてください。

状態遷移表とは

状態は「受注済み」「出荷済み」のように、対象がいまどの段階にあるかを表します。イベントは「注文を確定する」「出荷を登録する」のように、変化を引き起こす操作や通知です。条件は、そのイベントを受け付けてよいかを判断する基準です。

IPAの設計に関する資料は、状態遷移図で全体の動きを確認し、表に変換して抜けを確認する併用を紹介しています。図は流れをつかみやすく、表は状態とイベントの組み合わせを一つずつ確認しやすい点が特徴です。画面の移動を示す画面遷移図や、人の作業順を示す業務フロー図とは、見ている対象が違います。

状態遷移図の書き方では図の基本要素を扱っています。ここでは一歩進め、表の空欄をどう判断し、業務担当者が開発側へ何を渡すかに焦点を当てます。

状態遷移表を作る5手順

1. 表にする対象と範囲を決める

最初に「何の状態か」を一つに固定します。ここでは注文1件を対象とし、注文確定から出荷または取消までを扱います。注文後の返品や返金は、この例の表の対象外です。対象外だから起こらないわけではなく、別途ルールが必要であることも記録します。

同じ注文に関係していても、注文の進行、決済の完了、配送の進捗は別の情報です。例えば注文が取り消された表示だけでは、決済の取消まで終わったとは限りません。ecforceの公式FAQでも、対応状況の変更だけで決済が取り消されるわけではないと説明しています。これは同サービスの例であり、他の製品でも同じ動きになるとは限りません。

範囲を決めるときは、対象の単位、開始と終了、表に含めない業務、参照する既存資料を記録しましょう。対象を「受注業務全体」と広げすぎるより、注文1件の振る舞いから始めた方が確認しやすくなります。

2. 状態とイベントを別々に洗い出す

例では、注文の状態を「受付済み」「出荷準備中」「出荷済み」「取消済み」の4つとします。受付済みは注文を受けたが出荷準備を始めていない状態、出荷準備中は担当者が準備を開始した状態です。出荷済みと取消済みは、この表の範囲では終了状態とします。

続いてイベントを「準備開始」「出荷登録」「取消依頼」の3つに分けます。状態は一定期間続く状況、イベントは変化のきっかけです。「出荷する」は操作なので、状態名ではなくイベントとして扱います。通知の受信や期限到来も、業務によってはイベントに含めます。

名称だけでは部署ごとの解釈が割れがちです。たとえば「出荷済み」が伝票作成時なのか、倉庫から実際に引き渡した時点なのかを確認します。現場と開発担当者が同じ注文を見て判定できる定義にしましょう。後から例外を追加する余地を残し、最初の一覧を完成版と決めつけないことも大切です。

3. 状態とイベントの交点を埋める

状態を行、イベントを列に置き、交点に次の状態または扱いを書きます。次は説明用の仮ルールです。「拒否」は依頼を受け付けず注文状態を維持するという意味で、利用者への表示方法は別途決めます。

現在の注文状態準備開始出荷登録取消依頼
受付済み出荷準備中へ拒否取消済みへ
出荷準備中拒否出荷済みへ条件付きで取消済みへ
出荷済み拒否拒否対象外:返品手続きへ確認
取消済み拒否拒否拒否

この表は状態4種類とイベント3種類の組み合わせを検討するためのたたき台です。空欄を一律に「禁止」とみなさず、未決定、操作が対象外、明示的に拒否、のどれなのかを分けます。対象外の場合も、利用者や担当者にどの手続きへ案内するかが必要です。

仮に出荷済み後の取消依頼を返品手続きへ回すなら、注文自体の状態をその場で変えるのか、別の受付記録を作るのかは別途決めます。表を埋めたことと、その判断が社内で承認されたことは同じではありません。

4. 条件・担当者・処理を追記する

セルに「条件付き」と書いたら、その条件を別の一覧に展開します。たとえば出荷準備中の取消では、倉庫への出荷指示が確定する前なら担当者が受け付けられる、というルールを仮に置けます。ただし、実際には倉庫の作業停止方法や責任者との合意が必要です。

現在状態とイベント確認する条件許可時の処理満たさない場合
出荷準備中・取消依頼担当権限があり、倉庫への指示確定前取消を記録し、必要な後続処理へ引き継ぐ注文状態を変えず、担当者へ確認
出荷準備中・出荷登録出荷情報がそろっている出荷済みと日時を記録不足項目を確認し、状態を維持

担当者、条件、記録、通知、連携先、失敗時の扱いを一緒に確認します。たとえば取消記録の保存には成功したが、外部決済への連携に失敗した場合、何を未完了として表示し、誰が再確認するのか。注文状態の更新と外部処理の完了を混同しない設計が必要です。

条件が複数あるときは、どの組み合わせで何を許すかも明確にします。条件だけを並べて「適切に処理」と書くと、人によって適切の意味が変わります。未決定の項目には担当者と決定予定を付け、仮置きと合意済みを区別しましょう。

5. 例外と確認方法を合意する

表ができたら、正常な操作だけでなく、禁止や連続操作も確認します。受付済みから直接出荷登録した場合、取消済みの注文に再び取消依頼が届いた場合、出荷登録と取消依頼がほぼ同時に届いた場合などです。後者の結果は設計次第なので、片方が必ず成功すると先に決めず、状態・履歴・表示の期待結果を確認します。

確認用のケースには、開始状態、操作する人、操作、期待する状態、記録や通知の確認方法を書きます。例えば「受付済みの注文に権限のある担当者が準備開始を行うと、出荷準備中になり、担当者と時刻が記録される」といった形です。許可されない操作では、拒否表示だけでなく、状態や履歴がどうなるべきかも決めます。

ISTQBのシラバス解説も、イベントや条件に応じた状態の変化をテストする考え方を示しています。テストを実行する範囲と、通知障害や同時操作など未確認の範囲は分けて残してください。より詳しいケース化は状態遷移テストの進め方も参考になります。

運用に渡すときの確認ポイント

完成した表は、画面の説明資料として置くだけでなく、業務フロー、要件、受け入れテストと対応付けます。仕様変更で「出荷準備中でも一定条件なら取消可能」になれば、対象セルだけでなく、倉庫への連絡、決済、通知、権限、テストケースにも影響するかもしれません。

まず確認したいのは、表の版、対象範囲、各状態の定義、未決定事項の担当者です。変更後は関係者が見る正本を更新し、古い表と混在しないようにします。表から分かるのは記載した範囲内の組み合わせであり、表に載せなかった状態やイベントまで漏れなく見つかる保証はありません。現場の例外や過去の問い合わせと照らし直すことが重要です。

Kakusillは、散在する仕様書や業務の暗黙知を整理し、要件定義から仕様管理までを支えるワークスペースです。既存の議事録や業務資料を持ち寄り、状態や未決定事項を関係者で整理する際の相談先として検討できます。

まとめ

状態遷移表は、対象を一つ定め、状態とイベントを分け、その交点に次の状態や扱いを書くところから始めます。空欄を放置せず、拒否・対象外・未決定を区別し、条件、担当、処理、確認方法を添えることで、開発側へ渡せる判断が増えます。

まずは一つの注文や申請について、現在使っている状態名と操作を並べてください。その後、業務担当者と開発担当者で、例外時に何が起き、何がまだ終わっていないかを確認しましょう。

#状態遷移表#要件定義#業務設計#システム開発#テスト