運航調整機能 処理の流れ詳細 調整依頼回答の受信 デモ向け版
デモ向け版(forDemo)の「調整依頼回答の受信」API実行時の処理の流れを示す。
1. 参照資料
Section titled “1. 参照資料”- 業務ロジック仕様
- docs/coordination/BusinessLogicSpecifications.md
2. 処理の流れ
Section titled “2. 処理の流れ”デモ向け版(forDemo)では、簡素化のため、下記の処理・判定は対象外とする。
-
期限切れ判定 TODO(#334)
-
運航調整プロトコルタイプはシングルターンのみ対象 TODO(#333)
-
- APIで指定されたコンテキストID、セッションID、ターンIDを指定して、DBから運航調整情報を取得
- 1-1. 運航調整情報が存在しない場合は、以降の処理を中止し、404エラーを返す
-
- 取得した運航調整情報から自分の飛行計画ID(self_flight_plan_id)と相手の飛行計画ID(opponent_flight_plan_id)を取得
-
- 自分の飛行計画IDと相手の飛行計画ID、APIで指定されたコンテキストIDを指定して、DBから重複情報を取得 (対象とするレコードは「重複通知の受信」の「2.2. 複数の重複情報が存在する場合の参照規則」を参照)
- 3-1. 重複情報が存在しない場合は、以降の処理を中止し、404エラーを返す
-
- 重複解消済判定を実行
- 4-1. 重複解消済の場合(重複状態フラグがfalse)は、以降の処理を中止し、406エラーを返す (reasonにCONFLICT_RESOLVEDを設定)
-
- 状態による調整依頼回答受信可否判定を実行
- 5-1. ターン状態が
Proposedでない場合、以降の処理を中止し、406エラーを返す (reasonにTURN_STATE_IS_NOT_PROPOSEDを設定) - 5-2. セッション状態が
ProposalReceived(調整依頼受信済)の場合、以降の処理を中止し、406エラーを返す (reasonにSTATE_CANNOT_RECEIVEDを設定)
-
- forDemo対象外 (期限切れ判定を実行)
- 6-1. 現在時刻とコンテキスト期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
- 6-1-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- ターンが存在する場合、ターン状態を
Expiredに更新 - セッションが存在する場合、セッション状態を
Canceledに更新 - コンテキスト状態を
NotCoordinatedに更新
- ターンが存在する場合、ターン状態を
- 6-1-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- 6-2. 現在時刻とセッション期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
- 6-2-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- ターン状態を
Expiredに更新 - セッション状態を
Canceledに更新 - コンテキスト状態を
Blockedに更新 - インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
- ターン状態を
- 6-2-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- 6-3. 現在時刻とターン期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
- 6-3-A. 運航調整プロトコルタイプがシングルターンの場合、以下の処理を実行
- 6-3-A-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- ターン状態を
Expiredに更新 - セッション状態を
Canceledに更新 - コンテキスト状態を
Blockedに更新 - インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
- ターン状態を
- 6-3-A-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- 6-3-B. 運航調整プロトコルタイプがマルチターン(Continuous)の場合、以下の処理を実行
- 6-3-B-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- ターン状態を
Expiredに更新 - セッション状態を
Negotiableに更新
- ターン状態を
- 6-3-B-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- 6-3-C. 運航調整プロトコルタイプがマルチターン(Alternating)の場合、以下の処理を実行
- 6-3-C-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- ターン状態を
Expiredに更新 - セッション状態が
Proposedの場合は、セッション状態をBlockedに更新 - セッション状態が
ProposalReceivedの場合は、セッション状態をNegotiableに更新
- ターン状態を
- 6-3-C-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
- 6-3-A. 運航調整プロトコルタイプがシングルターンの場合、以下の処理を実行
-
- APIで指定されたコンテキストID、セッションID、ターンIDを指定して、DBの該当運航調整情報を更新
- 7-1. APIで指定された調整結果(合意 or 否認)を登録
- 7-2. ターン状態を下記のように更新
- 合意の場合、
Agreedに更新 - 否認の場合、
Disagreedに更新
- 合意の場合、
- 7-3. セッション状態を下記のように更新
- 合意の場合、
AgreedResponseReceivedに更新 - 否認の場合、下記のように更新
- 運航調整プロトコルタイプがシングルターンの場合、
Canceledに更新 - forDemo対象外 (運航調整プロトコルタイプがマルチターン(Continuous)の場合、
Negotiableに更新) - forDemo対象外 (運航調整プロトコルタイプがマルチターン(Alternating)の場合、
Blockedに更新)
- 運航調整プロトコルタイプがシングルターンの場合、
- 合意の場合、
- 7-4. コンテキスト状態を下記のように更新
- 合意の場合、更新しない
- 否認の場合、下記のように更新
- 運航調整プロトコルタイプがシングルターンの場合、
Blockedに更新 - forDemo対象外 (運航調整プロトコルタイプがマルチターン(Continuous or Alternating)の場合、更新しない)
- 運航調整プロトコルタイプがシングルターンの場合、
- 7-5. 否認かつ、運航調整プロトコルタイプがシングルターンの場合、以下の処理を実行
- インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
-
- 「調整依頼回答の受信」APIのレスポンスとして、200を返す