運航調整機能 メッセージ一覧(英語化対応)
本書は、運航調整機能(com.intent_exchange.utm.*)のソースコード中にハードコードされている
日本語メッセージを洗い出し、英語化対応(Sprint2)における置き換え内容を記載したものである。
将来的な多言語対応(言語切替)は本対応の対象外であり、Sprint2では暫定的に英語のみへの
置き換えを行う。GlobalExceptionHandler.javaのコメント、および
運航調整機能のSprint1レビュー記録(リポジトリ外)で追跡されていた対応。
TODO(#343)
前提・スコープ
Section titled “前提・スコープ”- 対象は
src/main/java/com/intent_exchange/utm/配下(generated/除く)の日本語ハードコード文字列のうち、 HTTPレスポンス(ProblemDetailのtitle/detail等)に実際に、または将来のハンドリング変更により 返る可能性がある文字列。 - ログにのみ出力される文字列(コメント含む)は対象外。
- ドメイン値オブジェクトの
IllegalArgumentException(バリデーション)は現状GlobalExceptionHandler.handleUnexpectedに吸収され固定の英文detailに置換されるためレスポンス本文には 現れないが、ログ出力・将来のハンドリング変更に備えて英語化する。 - APIリクエストパラメータの文字列をそのままDBに格納し別APIのレスポンスで返す値(
free_text等)は、 英語でリクエストされる前提とし本書の対象外とする。
レビュー方法
Section titled “レビュー方法”「英語(修正案)」列に修正が必要な場合は、このファイルを直接編集してください。 問題なければ本書の内容のまま実装(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:12 | UTMエンドポイント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:194 | 406レスポンスのボディを解析できませんでした | 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からも実装されておらず、 本バックエンドの実エンドポイントとして未使用(デッドコード)のため対象外