コンテンツにスキップ

運航調整機能 処理の流れ詳細 調整依頼の受信

「調整依頼の受信」API実行時の処理の流れを示す。

  • 業務ロジック仕様
    • docs/coordination/BusinessLogicSpecifications.md
    1. APIで指定されたコンテキストIDを指定して、DBから運航調整情報を取得
    • 1-1. 運航調整情報が存在しない場合は、以降の処理を中止し、404エラーを返す
    1. 取得した運航調整情報から自分の飛行計画ID(self_flight_plan_id)と相手の飛行計画ID(opponent_flight_plan_id)を取得
    1. 自分の飛行計画IDと相手の飛行計画IDを指定して、DBから重複情報を取得 (対象とするレコードは「重複通知の受信」の「2.2. 複数の重複情報が存在する場合の参照規則」を参照)
    • 3-1. 重複情報が存在しない場合は、以降の処理を中止し、404エラーを返す
    1. 重複解消済判定を実行
    • 4-1. 重複解消済の場合(重複状態フラグがfalse)は、以降の処理を中止し、406エラーを返す (reasonにCONFLICT_RESOLVEDを設定)
    1. コンテキスト状態がPreparedReceivedで、かつ、該当重複情報に対応する運航調整情報が既に存在する場合は、コンテキストオーナー変更判定を以下の手順で行う
    • 5-1. 自分の飛行計画IDと相手の飛行計画IDを指定して、DBから運航調整情報を取得
      • 5-1-1. APIで指定されたコンテキストID以外の運航調整情報で、ターン状態がProposedの情報がある場合、以下を実行
        • 5-1-1-1. 該当重複情報の自分の運航者識別子(self_operator_id)と相手の運航者識別子(opponent_operator_id)を比較
          • 5-1-1-1-A. 自分の運航者識別子の方が大きい場合、相手から受信したコンテキストの方を優先し、以下の処理を行う
            • 5-1-1-1-A-1. 該当運航調整情報(ターン状態がProposedの情報)を下記のように更新
              • コンテキスト状態をContextOwnerChanged、セッション状態をNotCoordinated、ターン状態をDisagreedに更新
            • 5-1-1-1-A-2. 継続して、6.以降の処理を行う。以降の処理は、APIで指定されたコンテキストIDに対応する運航調整情報に対して行う
          • 5-1-1-1-B. 自分の運航者識別子の方が小さい場合、相手から受信したコンテキストを拒否するため、以下の処理を行う
            • 5-1-1-1-B-1. APIで指定されたコンテキストIDに対応する運航調整情報を下記のように更新
              • コンテキスト状態をContextOwnerChanged、セッション状態をNotCoordinated、ターン状態をDisagreedに更新
            • 5-1-1-1-B-2. 該当運航調整情報(ターン状態がProposedの情報)のコンテキストIDを取得
            • 5-1-1-1-B-3. 以降の処理を中止し、406エラーを返す (reasonにREQUEST_DISCARDEDを設定、優先する自分側のコンテキストIDの値もセットする)
    1. 状態による調整依頼受信可否判定を実行
    • 6-1. コンテキスト状態が以下のいずれかの状態の場合、以降の処理を中止し、406エラーを返す
      • NotCoordinated: 期限切れなどの理由で不整合で運航調整終了済 (reasonにCONTEXT_STATE_NOT_COORDINATEDを設定)
      • Coordinated: 整合で運航調整終了済 (reasonにCONTEXT_STATE_COORDINATEDを設定)
      • Prepared: 自分側が調整開始したコンテキストのため依頼受信不可 (reasonにSTATE_CANNOT_RECEIVEDを設定)
      • ContextOwnerChanged: コンテキストオーナー変更により本コンテキストは使用不可 (reasonにSTATE_CANNOT_RECEIVEDを設定)
    • 6-2. APIで指定されたコンテキストID、セッションIDのセッションが存在する場合、かつ、セッション状態が以下のいずれかの状態の場合、以降の処理を中止し、406エラーを返す (reasonにSTATE_CANNOT_RECEIVEDを設定)
      • AgreedResponseReceived: 合意回答受信済
      • AgreedResponseSent: 合意回答送信済
      • ConflictResolving: 合意回答送信済(重複未解消継続)
    • 6-3. APIで指定されたコンテキストID、セッションID、ターンIDのターンが存在する場合、かつ、ターン状態がProposedの場合、以降の処理を中止し、406エラーを返す (reasonにTURN_EXISTSを設定)
    1. 期限切れ判定を実行
    • 7-1. 現在時刻とコンテキスト期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
      • 7-1-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
        • ターンが存在する場合、ターン状態をExpiredに更新
        • セッションが存在する場合、セッション状態をCanceledに更新
        • コンテキスト状態をNotCoordinatedに更新
    • 7-2. セッションが存在する場合、現在時刻とセッション期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
      • 7-2-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
        • ターンが存在する場合、ターン状態をExpiredに更新
        • セッション状態をCanceledに更新
        • コンテキスト状態をBlockedに更新
        • インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
    • 7-3. ターンが存在する場合、現在時刻とターン期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTIMEOUT_EXPIREDを設定)
      • 7-3-A. 運航調整プロトコルタイプがシングルターンの場合、以下の処理を実行
        • 7-3-A-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
          • ターン状態をExpiredに更新
          • セッション状態をCanceledに更新
          • コンテキスト状態をBlockedに更新
          • インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
      • 7-3-B. 運航調整プロトコルタイプがマルチターン(Continuous)の場合、以下の処理を実行
        • 7-3-B-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
          • ターン状態をExpiredに更新
          • セッション状態をNegotiableに更新
      • 7-3-C. 運航調整プロトコルタイプがマルチターン(Alternating)の場合、以下の処理を実行
        • 7-3-C-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
          • ターン状態をExpiredに更新
          • セッション状態がProposedの場合は、セッション状態をBlockedに更新
          • セッション状態がProposalReceivedの場合は、セッション状態をNegotiableに更新
    1. 以下の処理を実行
    • 8-1. セッション期限の設定
    • 8-2. ターン期限の設定
    1. APIで指定されたコンテキストIDを指定して、DBの該当運航調整情報を更新 (調整条件も登録)
    • 9-1. ターン状態をProposedに更新
    • 9-2. セッション状態をProposalReceivedに更新
    • 9-3. コンテキスト状態をProposalReceivedに更新
    1. 対応する重複情報に、APIで指定されたコンテキストIDを紐付け登録
    • 10-1. 対応する重複情報の運航調整コンテキスト期限の値が、コンテキストIDに対応する運航調整情報のコンテキスト期限と異なる場合は、重複情報側のコンテキスト期限を運航調整情報側の値で更新
    1. 「調整依頼の受信」APIのレスポンスとして、202を返す

セッション期限は、業務ロジック仕様の「6.1.2. セッション期限」に記載された仕様で設定する。

ターン期限は、業務ロジック仕様の「6.1.3. ターン期限」に記載された仕様で設定する。