運航調整機能 処理の流れ詳細 調整開始の受信 デモ向け版
デモ向け版(forDemo)の「調整開始の受信」API実行時の処理の流れを示す。
1. 参照資料
Section titled “1. 参照資料”- 業務ロジック仕様
- docs/coordination/BusinessLogicSpecifications.md
2. 処理の流れ
Section titled “2. 処理の流れ”デモ向け版(forDemo)では、簡素化のため、下記の処理・判定は対象外とする。
- 期限切れ判定 TODO(#334)
- 自分側と相手側の相互での調整開始や調整依頼の同時実行パターン TODO(#335)
- 最初にどちらか片方側が、調整開始 + 1回目の調整依頼 までを行うまでの間、もう片方側は調整開始、調整依頼を行わない前提とする
- また、1回目の調整依頼のターンが否認で完了した後、2回目以降の調整依頼を同じコンテキストIDで行う際も、調整依頼を相互に同時実行はしない前提とする
- 本パターン対象外により、コンテキストオーナー変更のケースが発生しない
APIで指定された値のうち、調整対象者の飛行計画ID(responder_flight_plan_id)は、以降の処理で、自分の飛行計画ID(self_flight_plan_id)として使う。 また、依頼者の飛行計画ID(requester_flight_plan_id)は、以降の処理で、相手の飛行計画ID(opponent_flight_plan_id)として使う。
-
- 調整対象者の飛行計画ID(responder_flight_plan_id)と依頼者の飛行計画ID(requester_flight_plan_id)を指定して、DBから重複情報を取得 (self_flight_plan_id と responder_flight_plan_id、opponent_flight_plan_id と requester_flight_plan_id が一致するレコードを取得) (対象とするレコードは「重複通知の受信」の「2.2. 複数の重複情報が存在する場合の参照規則」を参照)
- 1-1. 重複情報が存在しない場合は、以降の処理を中止し、404エラーを返す
-
- 重複解消済判定を実行
- 2-1. 重複解消済の場合(重複状態フラグがfalse)は、以降の処理を中止し、406エラーを返す (reasonにCONFLICT_RESOLVEDを設定)
-
- forDemo対象外 (現在時刻とコンテキスト期限を比較し、期限切れ判定を実行)
- 3-1. 期限切れの場合は、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
-
- 自分の飛行計画IDと相手の飛行計画IDを指定して、DBから運航調整情報を取得
- 4-1. 情報が存在する場合は、下記の判定処理を実行
- 4-1-A. 情報が1件のみ存在する場合
- 4-1-A-1. コンテキスト状態が下記に該当する場合は、以降の処理を中止し、以下のreasonをセットし、406エラーを返す
- 調整依頼済の場合(コンテキスト状態が
ProposedorProposalReceivedorBlockedorNegotiable) : CONTEXT_EXISTS - 調整開始受信済の場合(コンテキスト状態が
PreparedReceived) : CONTEXT_EXISTS
- 調整依頼済の場合(コンテキスト状態が
- 4-1-A-2. コンテキスト状態が下記に該当する場合は、下記の理由で、5.以降の処理を行う
- 存在する情報が終了済の運航調整情報の場合(コンテキスト状態が
CoordinatedorNotCoordinated)は、新たな重複が発生したとみなし、5.以降の処理を行うことで、新たな重複に対する運航調整情報を開始する - 調整依頼未実施、かつ調整開始送信済の場合(コンテキスト状態が
Prepared)は、自分側と相手側どちらのコンテキストを使って運航調整を行うかは調整依頼時に確定するため、5.以降の処理を行うことで、相手側のコンテキストも作成する - コンテキストオーナー変更の場合(コンテキスト状態が
ContextOwnerChanged)は、仕様上あり得ない(必ず他に利用することになったコンテキストが存在するはず)ため、条件分岐記載なしとする (エラーにはせず、5.以降の処理を行う)
- 存在する情報が終了済の運航調整情報の場合(コンテキスト状態が
- 4-1-A-1. コンテキスト状態が下記に該当する場合は、以降の処理を中止し、以下のreasonをセットし、406エラーを返す
- 4-1-B. 情報が複数件存在する場合
- 4-1-B-1. 複数件のうち、1件でもコンテキスト状態が下記に該当するものがある場合は、以降の処理を中止し、以下のreasonをセットし、406エラーを返す
- 調整依頼済の場合(コンテキスト状態が
ProposedorProposalReceivedorBlockedorNegotiable) : CONTEXT_EXISTS - 調整開始受信済の場合(コンテキスト状態が
PreparedReceived) : CONTEXT_EXISTS
- 調整依頼済の場合(コンテキスト状態が
- 4-1-B-2. 上記以外の場合は、下記の理由で、5.以降の処理を行う
- 存在する情報が終了済の運航調整情報の場合(コンテキスト状態が
CoordinatedorNotCoordinated)は、新たな重複が発生したとみなすため、その他の情報が 4-1-B-1. の条件に該当しなかった場合は、5.以降の処理を行うことで、新たな重複に対する運航調整情報を開始する - 調整依頼未実施、かつ調整開始送信済の場合(コンテキスト状態が
Prepared)は、自分側と相手側どちらのコンテキストを使って運航調整を行うかは調整依頼時に確定するため、その他の情報が 4-1-B-1. の条件に該当しなかった場合は、5.以降の処理を行うことで、相手側のコンテキストも作成する - コンテキストオーナー変更の場合(コンテキスト状態が
ContextOwnerChanged)は、もう片方の利用することに確定したコンテキストの状態に従うため、もう片方が 4-1-B-1. の条件に該当しなかった場合は、5.以降の処理を行う
- 存在する情報が終了済の運航調整情報の場合(コンテキスト状態が
- 4-1-B-1. 複数件のうち、1件でもコンテキスト状態が下記に該当するものがある場合は、以降の処理を中止し、以下のreasonをセットし、406エラーを返す
- 4-1-A. 情報が1件のみ存在する場合
-
- 以下の処理を実行
- 5-1. DBに運航調整情報を登録
- 5-1-1. コンテキスト状態は
PreparedReceivedで登録 - 5-1-2. コンテキスト期限は、APIで指定されたコンテキスト期限の値を登録
- 5-1-1. コンテキスト状態は
-
- 「調整開始の受信」APIのレスポンスとして、202を返す