コンテンツにスキップ

運航調整機能 処理の流れ詳細 調整依頼の開始

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

  • 業務ロジック仕様
    • docs/coordination/BusinessLogicSpecifications.md
    1. 自分の飛行計画IDと相手の飛行計画IDを指定して、DBから重複情報を取得 (対象とするレコードは「重複通知の受信」の「2.2. 複数の重複情報が存在する場合の参照規則」を参照)
    • 1.1. 重複情報が存在しない場合は、以降の処理を中止し、404エラーを返す
    1. 重複解消済判定を実行
    • 2-1. 重複解消済の場合(重複状態フラグがfalse)は、以降の処理を中止し、406エラーを返す (reasonにCONFLICT_RESOLVEDを設定)
    1. 相手のUTM利用タイプによる運航調整可否判定を実行
    • 3-1. 運航調整非対応のUTM(COORDINATION_INCAPABLE_UTM)の場合は、以降の処理を中止し、406エラーを返す (reasonにCOORDINATION_INCAPABLE_UTMを設定)
    1. 現在時刻とコンテキスト期限を比較し、期限切れ判定を実行
    • 4-1. 期限切れの場合は、以降の処理を中止し、406エラーを返す (reasonにCONTEXT_TIMEOUTを設定)
    1. 自分の飛行計画IDと相手の飛行計画IDを指定して、DBから運航調整情報を取得
    • 5-1. 情報が存在する場合は、既に調整依頼済(相手が依頼者のケース含む)判定を実行
      • 5-1-A. 情報が1件のみ存在する場合
        • 5-1-A-1. コンテキスト状態が下記に該当する場合は、以降の処理を中止し、以下のreasonをセットし、406エラーを返す
          • 調整依頼済(相手側が依頼者)の場合(コンテキスト状態がProposalReceived) : REQUEST_ALREADY_RECEIVED
          • 調整依頼済(自分側が依頼者)の場合(コンテキスト状態がProposed) : REQUEST_ALREADY_SENT
          • 調整開始済かつ、調整依頼未実行の場合(コンテキスト状態がPrepared) : CONTEXT_ALREADY_EXIST
          • 未終了の運航調整情報の場合(コンテキスト状態がBlocked or Negotiable) : CONTEXT_ALREADY_EXIST
        • 5-1-A-2. コンテキスト状態が下記に該当する場合は、下記の理由で、6.以降の処理を行う
          • 存在する情報が終了済の運航調整情報の場合(コンテキスト状態がCoordinated or NotCoordinated)は、新たな重複が発生したとみなし、6.以降の処理を行うことで、新たな重複に対する運航調整情報を開始する
          • 調整開始受信済かつ、調整依頼未受信の場合(コンテキスト状態がPreparedReceived)は、自分側と相手側どちらのコンテキストを使うかはまだ未確定のため、6.以降の処理を行うことで、自分側のコンテキストも作成し、相手に通知する
          • コンテキストオーナー変更の場合(コンテキスト状態がContextOwnerChanged)は、仕様上あり得ない(必ず他に利用することになったコンテキストが存在するはず)ため、条件分岐記載なしとする (エラーにはせず、6.以降の処理を行う)
      • 5-1-B. 情報が複数件存在する場合
        • 5-1-B-1. 複数件のうち、1件でもコンテキスト状態が下記に該当するものがある場合は、以降の処理を中止し、以下のreasonをセットし、406エラーを返す
          • 調整依頼済(相手側が依頼者)の場合(コンテキスト状態がProposalReceived) : REQUEST_ALREADY_RECEIVED
          • 調整依頼済(自分側が依頼者)の場合(コンテキスト状態がProposed) : REQUEST_ALREADY_SENT
          • 調整開始済かつ、調整依頼未実行の場合(コンテキスト状態がPrepared) : CONTEXT_ALREADY_EXIST
          • 未終了の運航調整情報の場合(コンテキスト状態がBlocked or Negotiable) : CONTEXT_ALREADY_EXIST
        • 5-1-B-2. 上記以外の場合は、下記の理由で、6.以降の処理を行う
          • 存在する情報が終了済の運航調整情報の場合(コンテキスト状態がCoordinated or NotCoordinated)は、新たな重複が発生したとみなすため、その他の情報が 5-1-B-1. の条件に該当しなかった場合は、6.以降の処理を行うことで、新たな重複に対する運航調整情報を開始する
          • 調整開始受信済かつ、調整依頼未受信の場合(コンテキスト状態がPreparedReceived)は、自分側と相手側どちらのコンテキストを使うかはまだ未確定のため、その他の情報が 5-1-B-1. の条件に該当しなかった場合は、6.以降の処理を行うことで、自分側のコンテキストも作成し、相手に通知する
          • コンテキストオーナー変更の場合(コンテキスト状態がContextOwnerChanged)は、もう片方の利用することに確定したコンテキストの状態に従うため、もう片方が 5-1-B-1. の条件に該当しなかった場合は、6.以降の処理を行う
    1. 以下の処理を実行
    • 6-1. コンテキストIDの採番
    • 6-2. DBに運航調整情報を登録
      • 6-2-1. コンテキスト状態はPreparedで登録
      • 6-2-2. コンテキスト期限は、1. で取得した重複情報に含まれる運航調整コンテキスト期限の値を登録
    1. 自分の飛行計画IDと相手の飛行計画IDとコンテキストIDを指定して、相手側のUTMへ「調整開始通知」APIを実行
    • 7-1. 「調整開始通知」APIのレスポンスでエラーが返ってきた場合は、以下の処理を実行
      • 7-1-1. 406エラーが返ってきた場合は、依頼前に登録した運航調整情報を下記のように更新
        • 7-1-1. 期限切れ(reasonがTIMEOUT_EXPIRED)の場合、コンテキスト状態をNotCoordinatedに更新
        • 7-1-2. 重複解消済(reasonがCONFLICT_RESOLVED)の場合、コンテキスト状態をCoordinatedに更新
        • 7-1-3. 調整依頼済(reasonがCONTEXT_EXISTS)の場合、本APIの処理で更新した内容をロールバックする
      • 7-1-2. 406以外のエラーが返ってきた場合は、以下の処理を実行
        • 本APIの処理で更新した内容をロールバックする
      • 7-1-3. 以降の処理を中止し、返ってきたエラーの内容毎に、「調整依頼の開始」APIのレスポンスとして、以下のreasonをセットし、406エラーを返す
        • Internal Server Error (500エラー) : INTERNAL_SERVER_ERROR_IN_OPPOSITE_SERVER (対向サーバからInternal Server Errorが返ってきた)
        • Bad Gateway Error (502エラー) : BAD_GATEWAY_IN_OPPOSITE_SERVER (対向サーバからBad Gateway Errorが返ってきた)
        • Service Unavailable Error (503エラー) : SERVICE_UNAVAILABLE_IN_OPPOSITE_SERVER (対向サーバからService Unavailable Errorが返ってきた)
        • Gateway Timeout Error (504エラー) : GATEWAY_TIMEOUT_IN_OPPOSITE_SERVER (対向サーバからGateway Timeout Errorが返ってきた)
        • 406エラー
          • 期限切れ(reasonがTIMEOUT_EXPIRED) : CONTEXT_TIMEOUT (既に調整期限を経過している (context_timeout))
          • 重複解消済(reasonがCONFLICT_RESOLVED) : CONFLICT_RESOLVED (指定された飛行計画間の重複が既に解消されている)
          • 調整依頼済(reasonがCONTEXT_EXISTS) : CONTEXT_ALREADY_EXIST (既に調整依頼済 または、調整開始済)
    1. 「調整依頼の開始」APIのレスポンスとして、201を返す。また、レスポンスボディで採番したコンテキストIDを返す