コンテンツにスキップ

運航調整機能 メッセージ一覧(英語化対応)

本書は、運航調整機能(com.intent_exchange.utm.*)のソースコード中にハードコードされている 日本語メッセージを洗い出し、英語化対応(Sprint2)における置き換え内容を記載したものである。

将来的な多言語対応(言語切替)は本対応の対象外であり、Sprint2では暫定的に英語のみへの 置き換えを行う。GlobalExceptionHandler.javaのコメント、および 運航調整機能のSprint1レビュー記録(リポジトリ外)で追跡されていた対応。

TODO(#343)

  • 対象はsrc/main/java/com/intent_exchange/utm/配下(generated/除く)の日本語ハードコード文字列のうち、 HTTPレスポンス(ProblemDetailのtitle/detail等)に実際に、または将来のハンドリング変更により 返る可能性がある文字列。
  • ログにのみ出力される文字列(コメント含む)は対象外。
  • ドメイン値オブジェクトのIllegalArgumentException(バリデーション)は現状 GlobalExceptionHandler.handleUnexpectedに吸収され固定の英文detailに置換されるためレスポンス本文には 現れないが、ログ出力・将来のハンドリング変更に備えて英語化する。
  • APIリクエストパラメータの文字列をそのままDBに格納し別APIのレスポンスで返す値(free_text等)は、 英語でリクエストされる前提とし本書の対象外とする。

「英語(修正案)」列に修正が必要な場合は、このファイルを直接編集してください。 問題なければ本書の内容のまま実装(Step3)に進みます。

1. ドメイン値オブジェクトのバリデーション例外(IllegalArgumentException)

Section titled “1. ドメイン値オブジェクトのバリデーション例外(IllegalArgumentException)”
ファイル:行日本語(現状)英語(修正案)
domain/model/DipsFlightPlanId.java:8飛行計画IDは空にできませんFlight plan ID must not be blank
domain/model/DipsFlightPlanId.java:11飛行計画IDは2000文字以内にしてくださいFlight plan ID must be at most 2000 characters
domain/model/OperatorId.java:8運航者識別子は空にできませんOperator ID must not be blank
domain/model/OperatorId.java:11運航者識別子は2000文字以内にしてくださいOperator ID must be at most 2000 characters
domain/model/MailAddress.java:8メールアドレスは空にできませんMail address must not be blank
domain/model/MailAddress.java:11メールアドレスは254文字以内にしてくださいMail address must be at most 254 characters
domain/model/SessionId.java:9セッションIDは0以上にしてくださいSession ID must be zero or greater
domain/model/TurnId.java:9ターンIDは0以上にしてくださいTurn ID must be zero or greater
domain/model/ContextId.java:10コンテキストIDは必須ですContext ID is required
domain/model/CoordinationId.java:10運航調整情報IDは必須ですCoordination ID is required
domain/model/ConflictionId.java:10重複情報IDは必須ですConfliction ID is required
domain/model/UtmEndpointUrl.java:12UTMエンドポイントURLは必須ですUTM endpoint URL is required
domain/model/CoordinationBody.java:15運航調整プロトコルの送受信内容は必須ですCoordination body is required
domain/model/CoordinationCondition.java:17調整条件は必須ですCoordination condition is required
domain/model/Confliction.java:28重複情報IDは必須ですConfliction ID is required
domain/model/Confliction.java:31自分/相手の飛行計画IDは必須ですSelf/opponent flight plan ID is required
domain/model/Confliction.java:34コンテキスト期限は必須ですContext deadline is required
domain/model/Coordination.java:141運航調整情報ID・コンテキストIDは必須ですCoordination ID and context ID are required
domain/model/Coordination.java:217運航調整情報ID・コンテキストIDは必須ですCoordination ID and context ID are required

2. 状態不整合の例外(IllegalStateException)

Section titled “2. 状態不整合の例外(IllegalStateException)”
ファイル:行日本語(現状)英語(修正案)
handler/AstmCoordinationHandler.java:87ターン開始後のCoordinationが期待されますExpected a Coordination after turn start
handler/AstmCoordinationHandler.java:107ターン開始後のCoordinationが期待されますExpected a Coordination after turn start
handler/response/CoordinationResponseMapper.java:35ターン開始後のCoordinationのみ変換可能ですOnly a Coordination after turn start can be converted

3. Not Found系(404レスポンスに実際に返る)

Section titled “3. Not Found系(404レスポンスに実際に返る)”
ファイル:行日本語(現状)英語(修正案)
handler/GlobalExceptionHandler.java:62対象が見つかりません(title)Resource not found
handler/GlobalExceptionHandler.java:69対象が見つかりません(title)Resource not found
infrastructure/persistence/postgres/CoordinationRepositoryImpl.java:113運航調整情報が見つかりません。id: <id>Coordination not found. id: <id>
infrastructure/persistence/postgres/ConflictionRepositoryImpl.java:104重複情報が見つかりません。id: <id>Confliction not found. id: <id>
usecase/StartCoordinationUseCase.java:81、ExecuteCoordinationRequestUseCase.java:97、ReceiveConflictResolutionUseCase.java:59、ReceiveInitiationUseCase.java:63、ReceiveRequestUseCase.java:84重複情報が見つかりません。self_flight_plan_id: <id>, opponent_flight_plan_id: <id>Confliction not found. self_flight_plan_id: <id>, opponent_flight_plan_id: <id>
usecase/ExecuteCoordinationResponseUseCase.java:103、ReceiveResponseUseCase.java:68重複情報が見つかりません。self_flight_plan_id: <id>, opponent_flight_plan_id: <id>, context_id: <id>Confliction not found. self_flight_plan_id: <id>, opponent_flight_plan_id: <id>, context_id: <id>
usecase/ExecuteCoordinationRequestUseCase.java:107、ReceiveRequestUseCase.java:77運航調整情報が見つかりません。context_id: <id>Coordination not found. context_id: <id>
usecase/ExecuteCoordinationResponseUseCase.java:91、ReceiveResponseUseCase.java:55運航調整情報が見つかりません。context_id: <id>, session_id: <id>Coordination not found. context_id: <id>, session_id: <id>

4. 調整要求受理不可(406レスポンスに実際に返る)

Section titled “4. 調整要求受理不可(406レスポンスに実際に返る)”
ファイル:行日本語(現状)英語(修正案)
handler/GlobalExceptionHandler.java:81調整要求を受理できません(title)Coordination request not acceptable
domain/exception/CoordinationNotAcceptableException.java:18調整要求を受理できません。理由: <reason>Coordination request not acceptable. reason: <reason>

5. 対向UTM通信エラー系(502/503/504、通常はUseCase層で406へ変換されるフォールバック経路)

Section titled “5. 対向UTM通信エラー系(502/503/504、通常はUseCase層で406へ変換されるフォールバック経路)”
ファイル:行日本語(現状)英語(修正案)
handler/GlobalExceptionHandler.java:98対向UTMとの通信エラー(title)Error communicating with opponent UTM
domain/exception/ExternalUtmInvalidResponseException.java:6対向UTMから無効なレスポンスを受け取りました。理由: <reason>Received an invalid response from opponent UTM. reason: <reason>
infrastructure/client/opponent/OpponentUtmClientImpl.java:168予期しないステータスコード: <statusCode>Unexpected status code: <statusCode>
infrastructure/client/opponent/OpponentUtmClientImpl.java:194406レスポンスのボディを解析できませんでしたFailed to parse the 406 response body
handler/GlobalExceptionHandler.java:110対向UTMが利用できません(title)Opponent UTM unavailable
domain/exception/ExternalUtmUnavailableException.java:6対向UTMが一時的に利用できません。エンドポイント: <endpoint>Opponent UTM is temporarily unavailable. endpoint: <endpoint>
handler/GlobalExceptionHandler.java:122対向UTMとの通信がタイムアウトしました(title)Communication with opponent UTM timed out
domain/exception/ExternalUtmTimeoutException.java:6対向UTMへの通信がタイムアウトしました。エンドポイント: <endpoint>Communication with opponent UTM timed out. endpoint: <endpoint>

6. 対向UTMからの406/内部エラー変換用(UseCase層で捕捉されクライアントへは非到達だが、ログには出力される)

Section titled “6. 対向UTMからの406/内部エラー変換用(UseCase層で捕捉されクライアントへは非到達だが、ログには出力される)”
ファイル:行日本語(現状)英語(修正案)
domain/exception/ExternalUtmNotAcceptableException.java:11対向UTMが内部状態不一致(406)を返しました。対向側reason: <reason>Opponent UTM returned an internal state mismatch (406). opponent reason: <reason>
domain/exception/ExternalUtmInternalErrorException.java:7対向UTMで内部エラーが発生しました。エンドポイント: <endpoint>An internal error occurred in opponent UTM. endpoint: <endpoint>

対象外(確認済み・変更不要)

Section titled “対象外(確認済み・変更不要)”
  • messages.properties:既に英語のみ(コメント行に日本語1件あるが本文には影響しない)
  • OpenAPI定義yaml(openapi_astm.yaml等):enum値は全て英語。日本語はdescription/summary/example (Swagger文書用メタデータであり実際のレスポンスJSONには出力されない)のみのため対象外
  • docs/openapi/frontend/*.yaml由来のgenerated/api/*:どのControllerからも実装されておらず、 本バックエンドの実エンドポイントとして未使用(デッドコード)のため対象外