コンテンツにスキップ

運航調整機能 処理の流れ詳細 調整依頼の実行 デモ向け版

デモ向け版(forDemo)の「調整依頼の実行」API実行時の処理の流れを示す。

  • 業務ロジック仕様
    • docs/coordination/BusinessLogicSpecifications.md

デモ向け版(forDemo)では、簡素化のため、下記の処理・判定は対象外とする。

  • 期限切れ判定 TODO(#334)

  • 自分側と相手側の相互での調整開始や調整依頼の同時実行パターン TODO(#335)

    • 最初にどちらか片方側が、調整開始 + 1回目の調整依頼 までを行うまでの間、もう片方側は調整開始、調整依頼を行わない前提とする
    • また、1回目の調整依頼のターンが否認で完了した後、2回目以降の調整依頼を同じコンテキストIDで行う際も、調整依頼を相互に同時実行はしない前提とする
    • 本パターン対象外により、コンテキストオーナー変更のケースが発生しない
    1. 自分の飛行計画IDと相手の飛行計画IDを指定して、DBから重複情報を取得 (対象とするレコードは「重複通知の受信」の「2.2. 複数の重複情報が存在する場合の参照規則」を参照)
    • 1-1. 重複情報が存在しない場合は、以降の処理を中止し、404エラーを返す
    1. 重複解消済判定を実行
    • 2-1. 重複解消済の場合(重複状態フラグがfalse)は、以降の処理を中止し、406エラーを返す (reasonにCONFLICT_RESOLVEDを設定)
    1. コンテキストIDを指定して、DBから運航調整情報を取得
    • 3-1. 運航調整情報が存在しない場合は、以降の処理を中止し、404エラーを返す
    1. コンテキスト状態がBlocked状態の場合、インターバル解除判定を実行
    • 4-1. 現在時刻がインターバル解除時刻以降の場合、コンテキスト状態をNegotiableと読み替えて以降の判定を行う
      • このタイミングでのDB更新は行わない (調整依頼実行成立時、コンテキスト状態はProposedになるため)
      • 以降の処理で期限切れと判定された場合、期限切れの方の更新内容を優先する
    1. 状態による調整依頼実行可否判定を実行
    • 5-1. コンテキスト状態が以下のいずれかの状態の場合、以降の処理を中止し、406エラーを返す
      • Blocked: インターバル期間などの理由で調整依頼実行不可状態 (reasonにREQUEST_BLOCKED_BY_TIMEを設定)
      • NotCoordinated: 期限切れなどの理由で不整合で運航調整終了済 (reasonにCONTEXT_STATE_NOT_COORDINATEDを設定)
      • Coordinated: 整合で運航調整終了済 (reasonにCONTEXT_STATE_COORDINATEDを設定)
      • PreparedReceived: 相手側が調整開始したコンテキストのため依頼実行不可 (reasonにCANNOT_PROPOSED_CONTEXTを設定)
      • ContextOwnerChanged: コンテキストオーナー変更により本コンテキストは使用不可 (reasonにCANNOT_PROPOSED_CONTEXTを設定)
    • 5-2. セッションが存在する場合、かつ、セッション状態が以下のいずれかの状態の場合、以降の処理を中止し、406エラーを返す
      • Blocked: 調整依頼実行不可状態 (reasonにREQUEST_BLOCKED_BY_ALTERNATINGを設定)
      • Proposed: 調整依頼済(自分側が依頼者) (reasonにREQUEST_ALREADY_SENTを設定)
      • ProposalReceived: 調整依頼済(相手側が依頼者) (reasonにREQUEST_ALREADY_RECEIVEDを設定)
      • AgreedResponseReceived: 合意回答受信済 (reasonにAGREED_RESPONSE_ALREADY_RECEIVEDを設定)
      • AgreedResponseSent: 合意回答送信済 (reasonにAGREED_RESPONSE_ALREADY_SENTを設定)
      • ConflictResolving: 合意回答送信済(重複未解消継続) (reasonにAGREED_RESPONSE_ALREADY_SENTを設定)
    1. forDemo対象外 (期限切れ判定を実行)
    • 6-1. 現在時刻とコンテキスト期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにCONTEXT_TIMEOUTを設定)
      • 6-1-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
        • ターンが存在する場合、ターン状態をExpiredに更新
        • セッションが存在する場合、セッション状態をCanceledに更新
        • コンテキスト状態をNotCoordinatedに更新
    • 6-2. セッションが存在する場合、現在時刻とセッション期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにSESSION_TIMEOUTを設定)
      • 6-2-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
        • ターンが存在する場合、ターン状態をExpiredに更新
        • セッション状態をCanceledに更新
        • コンテキスト状態をBlockedに更新
        • インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
    • 6-3. ターンが存在する場合、現在時刻とターン期限を比較し、期限切れの場合は、以下の処理を実行後、以降の処理を中止し、406エラーを返す (reasonにTURN_TIMEOUTを設定)
      • 6-3-A. 運航調整プロトコルタイプがシングルターンの場合、以下の処理を実行
        • 6-3-A-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
          • ターン状態をExpiredに更新
          • セッション状態をCanceledに更新
          • コンテキスト状態をBlockedに更新
          • インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
      • 6-3-B. 運航調整プロトコルタイプがマルチターン(Continuous)の場合、以下の処理を実行
        • 6-3-B-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
          • ターン状態をExpiredに更新
          • セッション状態をNegotiableに更新
      • 6-3-C. 運航調整プロトコルタイプがマルチターン(Alternating)の場合、以下の処理を実行
        • 6-3-C-1. コンテキストIDを指定して、DBの該当運航調整情報を下記のように更新
          • ターン状態をExpiredに更新
          • セッション状態がProposedの場合は、セッション状態をBlockedに更新
          • セッション状態がProposalReceivedの場合は、セッション状態をNegotiableに更新
    1. 以下の処理を実行
    • 7-1. セッションIDの採番
    • 7-2. ターンIDの採番
    • 7-3. セッション期限の設定
    • 7-4. ターン期限の設定
    1. コンテキストIDを指定して、DBの該当運航調整情報を更新 (調整条件も登録)
    • 8-1. ターン状態をProposedに更新
    • 8-2. セッション状態をProposedに更新
    • 8-3. コンテキスト状態をProposedに更新
    1. 自分の飛行計画IDと相手の飛行計画IDとコンテキストID、セッションID、ターンID、調整条件を指定して、相手側のUTMへ「調整依頼通知」APIを実行
    • 9-1. 「調整依頼通知」APIのレスポンスで406エラーが返ってきた場合は、以下の処理を実行
      • 9-1-1. 依頼前に更新した運航調整情報を下記のように更新
        • 重複解消済(reasonがCONFLICT_RESOLVED)、または調整整合で完了済(reasonがCONTEXT_STATE_COORDINATED)の場合、コンテキスト状態をCoordinated、セッション状態をCoordinated、ターン状態をAgreedに更新
        • 調整不整合で完了済(reasonがCONTEXT_STATE_NOT_COORDINATED)の場合、コンテキスト状態をNotCoordinated、セッション状態をCanceled、ターン状態をDisagreedに更新
        • forDemo対象外 (コンテキストオーナー変更(reasonがREQUEST_DISCARDED)の場合、コンテキスト状態をContextOwnerChanged、セッション状態をCanceled、ターン状態をDisagreedに更新)
        • 運航調整状態による受信不可の状態(reasonがSTATE_CANNOT_RECEIVED)の場合、本APIの処理で更新した内容をロールバックする
        • 調整依頼済(reasonがTURN_EXISTS)の場合、本APIの処理で更新した内容をロールバックする
        • forDemo対象外 (期限切れ(reasonがTIMEOUT_EXPIRED)の場合、以下の処理を実行)
          • ターン状態をExpiredに更新
          • コンテキスト期限による期限切れ(現在時刻がコンテキスト期限以降)の場合は、コンテキスト状態をNotCoordinated、セッション状態をCanceledに更新
          • セッション期限による期限切れ(現在時刻がセッション期限以降)の場合は、以下の処理を実行
            • セッション状態をCanceledに更新
            • コンテキスト状態をBlockedに更新
            • インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
          • ターン期限による期限切れ(現在時刻がターン期限以降)の場合は、以下の処理を実行
            • 運航調整プロトコルタイプがシングルターンの場合、以下の処理を実行
              • ターン状態をExpiredに更新
              • セッション状態をCanceledに更新
              • コンテキスト状態をBlockedに更新
              • インターバル解除時刻を、「現在時刻 + セッション間のインターバル」 で計算した時刻に更新
            • 運航調整プロトコルタイプがマルチターン(Continuous)の場合、以下の処理を実行
              • ターン状態をExpiredに更新
              • セッション状態をNegotiableに更新
            • 運航調整プロトコルタイプがマルチターン(Alternating)の場合、以下の処理を実行
              • ターン状態をExpiredに更新
              • セッション状態がProposedの場合は、セッション状態をBlockedに更新
              • セッション状態がProposalReceivedの場合は、セッション状態をNegotiableに更新
      • 9-1-2. コンテキストオーナー変更以外のエラーの場合は、以降の処理を中止し、「調整依頼の実行」APIのレスポンスとして、以下のreasonをセットし、406エラーを返す
        • コンテキスト期限による期限切れ(現在時刻がコンテキスト期限以降) : CONTEXT_TIMEOUT (既に調整期限を経過している (context_timeout))
        • セッション期限による期限切れ(現在時刻がセッション期限以降) : SESSION_TIMEOUT (既に調整期限を経過している (session_timeout))
        • ターン期限による期限切れ(現在時刻がターン期限以降) : TURN_TIMEOUT (既に調整期限を経過している (turn_timeout))
        • 重複解消済(reasonがCONFLICT_RESOLVED) : CONFLICT_RESOLVED (指定された飛行計画間の重複が既に解消されている)
        • 調整整合で完了済(reasonがCONTEXT_STATE_COORDINATED) : CONTEXT_STATE_COORDINATED (調整整合で完了済)
        • 調整不整合で完了済(reasonがCONTEXT_STATE_NOT_COORDINATED) : CONTEXT_STATE_NOT_COORDINATED (調整不整合で完了済)
        • 運航調整状態による受信不可の状態(reasonがSTATE_CANNOT_RECEIVED) : STATE_CANNOT_RECEIVED_ERROR_IN_OPPOSITE_SERVER (対向サーバから運航調整状態による受信不可状態エラーが返ってきた)
        • 調整依頼済(reasonがTURN_EXISTS) : TURN_EXISTS_ERROR_IN_OPPOSITE_SERVER (対向サーバから調整依頼済エラーが返ってきた)
      • 9-1-3. forDemo対象外 (コンテキストオーナー変更のエラーの場合は、以下の処理を実行)
        • 9-1-3-1.「調整依頼通知」APIのレスポンスに含まれる、相手側指定のコンテキストIDを取得
        • 9-1-3-2. 対応する重複情報に、相手側指定のコンテキストIDを紐付け登録
          • 9-1-3-2-1. 対応する重複情報の運航調整コンテキスト期限の値が、相手側指定のコンテキストIDに対応する運航調整情報のコンテキスト期限と異なる場合は、重複情報側のコンテキスト期限を運航調整情報側の値で更新
        • 9-1-3-3. 以降の処理を中止し、「調整依頼の実行」APIのレスポンスとして、以下のreasonをセットし、406エラーを返す
          • CONTEXT_OWNER_CHANGED (相手側から調整依頼を受信し、相手側の調整依頼に回答する立場となった)
    • 9-2. 「調整依頼通知」APIのレスポンスで406以外のエラーが返ってきた場合は、以下の処理を実行
      • 本APIの処理で更新した内容をロールバックする
      • 以降の処理を中止し、返ってきたエラーの内容毎に、「調整依頼の実行」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が返ってきた)
    • 9-3. 「調整依頼通知」APIのレスポンスがエラー以外の場合は、以下の処理を実行
      • 9-3-1. 対応する重複情報に、コンテキストIDを紐付け登録
        • 9-3-1-1. 対応する重複情報の運航調整コンテキスト期限の値が、コンテキストIDに対応する運航調整情報のコンテキスト期限と異なる場合は、重複情報側のコンテキスト期限を運航調整情報側の値で更新
    1. 「調整依頼の実行」APIのレスポンスとして、201を返す。レスポンスボディに採番したセッションIDとターンIDを含める。

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

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

運航調整情報は、ターンごとに履歴レコードを保持するため、該当運航調整情報を更新時に、新しいターン(セッション)のレコードが1件作成される。