project-auto-wizard 0.13.2 → 0.14.0

package/payload/workflows/flutter/PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT.yaml

@@ -1,41 +1,41 @@
 # project-auto-wizard:managed-workflow
-# Flutter iOS 테스트용 TestFlight 배포 워크플로우
+# Flutter iOS test TestFlight deploy workflow
 #
-# 이 워크플로우는 기능 브랜치에서 수동으로 실행하여
-# 테스트용 iOS 빌드를 TestFlight에 배포합니다.
+# Run this workflow manually from a feature branch
+# to deploy a test iOS build to TestFlight.
 #
-# 설정 파일(ios/fastlane/Fastfile, ios/ExportOptions.plist)은 project-auto-wizard가
-# 없을 때만 설치하며, 이미 있으면 덮어쓰지 않습니다.
+# The config files (ios/fastlane/Fastfile, ios/ExportOptions.plist) are installed by
+# project-auto-wizard only when missing; existing files are never overwritten.
 #
-# 주요 특징:
-# - workflow_dispatch로 수동 실행 또는 repository_dispatch로 트리거
-# - 버전은 version.yml에서 동적으로 읽어 사용 (운영 버전과 동일, 빌드 번호로 구분)
-# - 빌드 번호는 PR번호 + 카운트 또는 GITHUB_RUN_NUMBER 사용
-# - 브랜치명에서 이슈 번호 자동 추출 (YYYYMMDD_#이슈번호_내용 형식)
-# - GitHub API로 이슈 정보 가져와서 릴리즈 노트에 포함
+# Highlights:
+# - Runs manually via workflow_dispatch or is triggered by repository_dispatch
+# - The version is read dynamically from version.yml (same as production; builds are told apart by build number)
+# - The build number is PR number + count, or GITHUB_RUN_NUMBER
+# - Extracts the issue number from the branch name automatically (YYYYMMDD_#issue-number_title format)
+# - Fetches the issue through the GitHub API and includes it in the release notes
 #
-# 빌드 파이프라인:
-#   1. flutter build ios --no-codesign (Flutter 빌드)
-#   2. xcodebuild archive (Xcode 아카이브 생성)
-#   3. xcodebuild -exportArchive (IPA 생성, ExportOptions.plist 사용)
-#   4. fastlane upload_testflight (ios/fastlane/Fastfile 사용)
+# Build pipeline:
+#   1. flutter build ios --no-codesign (Flutter build)
+#   2. xcodebuild archive (create the Xcode archive)
+#   3. xcodebuild -exportArchive (create the IPA using ExportOptions.plist)
+#   4. fastlane upload_testflight (uses ios/fastlane/Fastfile)
 #
-# 필수 GitHub Secrets
+# Required GitHub Secrets
 #
-# Apple 인증서 & 프로비저닝 프로파일:
-# APPLE_CERTIFICATE_BASE64: .p12 인증서 (base64 인코딩)
-# APPLE_CERTIFICATE_PASSWORD: .p12 인증서 비밀번호
-# APPLE_PROVISIONING_PROFILE_BASE64: .mobileprovision 파일 (base64 인코딩)
-# IOS_PROVISIONING_PROFILE_NAME: 프로비저닝 프로파일 이름
+# Apple certificate & provisioning profile:
+# APPLE_CERTIFICATE_BASE64: .p12 certificate (base64 encoded)
+# APPLE_CERTIFICATE_PASSWORD: .p12 certificate password
+# APPLE_PROVISIONING_PROFILE_BASE64: .mobileprovision file (base64 encoded)
+# IOS_PROVISIONING_PROFILE_NAME: provisioning profile name
 #
 # App Store Connect API:
-# APP_STORE_CONNECT_API_KEY_ID: API Key ID (10자리)
-# APP_STORE_CONNECT_ISSUER_ID: Issuer ID (UUID 형식)
-# APP_STORE_CONNECT_API_KEY_BASE64: AuthKey_XXXXXX.p8 파일 (base64 인코딩)
+# APP_STORE_CONNECT_API_KEY_ID: API Key ID (10 characters)
+# APP_STORE_CONNECT_ISSUER_ID: Issuer ID (UUID format)
+# APP_STORE_CONNECT_API_KEY_BASE64: AuthKey_XXXXXX.p8 file (base64 encoded)
 #
-# 환경 설정 (선택):
-# ENV_FILE (선택): .env 파일 내용
-# SECRETS_XCCONFIG (선택): ios/Flutter/Secrets.xcconfig 내용
+# Environment settings (optional):
+# ENV_FILE (optional): contents of the .env file
+# SECRETS_XCCONFIG (optional): contents of ios/Flutter/Secrets.xcconfig
 
 name: PROJECT-Flutter-iOS-Test-TestFlight
 
@@ -48,30 +48,30 @@ on:
   repository_dispatch:
     types: [build-ios-app]
 
-# 레포 기본 권한이 read여도 빌드 진행 댓글을 달 수 있게 필요한 권한을 직접 선언한다
+# Declare the needed permissions explicitly so progress comments work even when the repository default is read-only
 permissions:
   contents: read
   issues: write
   pull-requests: write
 
-# 프로젝트별 설정 (아래 값들을 수정하세요)
+# Project settings (edit the values below)
 env:
-  # Flutter SDK 버전 — 비워 두면 stable 채널 최신을 쓴다(최신 flutter create 프로젝트의 SDK 제약과 맞음).
-  # 특정 버전에 고정하려면 "3.38.9"처럼 적는다. pubspec.yaml의 environment.sdk 범위를 만족해야 한다.
+  # Flutter SDK version — leave empty to use the latest stable channel (matches the SDK constraint of a fresh flutter create project).
+  # To pin a version, write it like "3.38.9". It must satisfy environment.sdk in pubspec.yaml.
   FLUTTER_VERSION: ""
   XCODE_VERSION: "26.0"
   PROJECT_TYPE: "flutter"
-  # Flutter 루트 경로(레포 루트 기준). 단일레포면 ".", 모노레포면 "app" 등 — 설치 시 자동 설정
+  # Flutter root path (relative to the repo root). "." for a single repo, "app" etc. for a monorepo — set automatically at install
   FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
-  # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
+  # How env vars are passed (dart-define | dotenv) — set automatically from the value chosen at install
   ENV_MODE: "dart-define"  # @wizard auto:flutter-env-mode
-  # dotenv 모드에서 .env 파일을 만들 경로 (Flutter 루트 기준)
+  # Where to create the .env file in dotenv mode (relative to the Flutter root)
   ENV_FILE_PATH: ".env"
 
 jobs:
-  # 즉시 댓글 생성 (ubuntu-latest로 빠르게 실행)
+  # Create the comment right away (runs quickly on ubuntu-latest)
   notify-start:
-    name: 진행 상황 알림
+    name: Progress notification
     runs-on: ubuntu-latest
     if: github.event_name == 'repository_dispatch'
 
@@ -81,18 +81,40 @@ jobs:
       branch_valid: ${{ steps.verify_branch.outputs.valid }}
 
     steps:
-      - name: 브랜치 존재 여부 사전 확인
+      # Fetch the message catalog from the triggering ref first — the feature branch being built may predate it
+      - name: Checkout messages
+        uses: actions/checkout@v7
+        with:
+          path: .paw-msg
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
+      - name: Load messages
+        working-directory: ${{ github.workspace }}
+        run: |
+          cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
+          LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
+          rm -rf .paw-msg
+          echo "PROJECT_AUTO_WIZARD_LANG=$LANG_CODE" >> "$GITHUB_ENV"
+          echo "PAW_MESSAGES_PY=$RUNNER_TEMP/paw_messages.py" >> "$GITHUB_ENV"
+          echo "PAW_MSG=$(PROJECT_AUTO_WIZARD_LANG=$LANG_CODE python3 "$RUNNER_TEMP/paw_messages.py" dump ios_test_tf.)" >> "$GITHUB_ENV"
+
+      - name: Verify the branch exists up front
         id: verify_branch
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
             const branchName = '${{ github.event.client_payload.branch_name }}';
             const prNumber = '${{ github.event.client_payload.pr_number }}';
             const runId = '${{ github.run_id }}';
             const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
 
-            console.log(`🔍 브랜치 존재 여부 확인: ${branchName}`);
+            console.log(msg('ios_test_tf.branch_check_log', { branch: branchName }));
 
             try {
               await github.rest.repos.getBranch({
@@ -100,26 +122,26 @@ jobs:
                 repo: context.repo.repo,
                 branch: branchName
               });
-              console.log(`✅ 브랜치 존재 확인됨: ${branchName}`);
+              console.log(msg('ios_test_tf.branch_exists_log', { branch: branchName }));
               core.setOutput('valid', 'true');
             } catch (error) {
               if (error.status === 404) {
-                console.log(`❌ 브랜치를 찾을 수 없음: ${branchName}`);
+                console.log(msg('ios_test_tf.branch_not_found_log', { branch: branchName }));
 
                 const body = [
-                  '🍎 ❌ **iOS TestFlight 빌드 실패 - 브랜치를 찾을 수 없습니다**',
+                  msg('ios_test_tf.branch_missing_title'),
                   '',
-                  '| 항목 | 값 |',
+                  msg('ios_test_tf.kv_head'),
                   '|------|-----|',
-                  `| **요청된 브랜치** | \`${branchName}\` |`,
-                  `| **이슈/PR** | #${prNumber} |`,
+                  msg('ios_test_tf.row_requested_branch', { branch: branchName }),
+                  msg('ios_test_tf.row_issue_pr', { number: prNumber }),
                   '',
-                  '### 💡 확인 사항',
-                  '1. 브랜치가 원격 저장소에 push되었는지 확인하세요',
-                  '2. "Issue Helper" 댓글의 브랜치명이 올바른지 확인하세요',
-                  '3. 브랜치명에 오타가 없는지 확인하세요',
+                  msg('ios_test_tf.hint_title'),
+                  msg('ios_test_tf.hint_pushed'),
+                  msg('ios_test_tf.hint_helper_branch'),
+                  msg('ios_test_tf.hint_typo'),
                   '',
-                  `🔗 [워크플로우 로그](${runUrl})`
+                  msg('ios_test_tf.workflow_log_link', { url: runUrl })
                 ].join('\n');
 
                 await github.rest.issues.createComment({
@@ -129,13 +151,13 @@ jobs:
                   body: body
                 });
 
-                core.setFailed(`브랜치를 찾을 수 없습니다: ${branchName}`);
+                core.setFailed(msg('ios_test_tf.branch_not_found_fail', { branch: branchName }));
               } else {
-                core.setFailed(`브랜치 확인 중 오류: ${error.message}`);
+                core.setFailed(msg('ios_test_tf.branch_check_error_fail', { error: error.message }));
               }
             }
 
-      - name: 진행 상황 댓글 생성
+      - name: Create the progress comment
         id: progress
         if: github.event.client_payload.pr_number != ''
         continue-on-error: true
@@ -143,6 +165,9 @@ jobs:
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const prNumber = parseInt('${{ github.event.client_payload.pr_number }}');
             const branchName = '${{ github.event.client_payload.branch_name }}';
             const buildNumber = '${{ github.event.client_payload.build_number }}';
@@ -151,23 +176,23 @@ jobs:
             const startTime = Date.now();
 
             const body = [
-              '## 🍎 iOS TestFlight 빌드 진행 중...',
+              msg('ios_test_tf.title_running'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              '| 🔧 준비 | ⏳ 진행 중... | - |',
-              '| 🔨 IPA 빌드 | ⏸️ 대기 | - |',
-              '| 📤 TestFlight 배포 | ⏸️ 대기 | - |',
+              row('prepare', 'running'),
+              row('build', 'waiting'),
+              row('deploy', 'waiting'),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **빌드 번호** | \`${buildNumber}\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
+              msg('ios_test_tf.row_build_number', { build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
               '',
-              `**[📋 실시간 로그 보기](${runUrl})**`,
+              msg('ios_test_tf.live_log_link', { url: runUrl }),
               '',
               '---',
-              '*🤖 이 댓글은 자동으로 업데이트됩니다.*'
+              msg('ios_test_tf.auto_update_note')
             ].join('\n');
 
             const { data: comment } = await github.rest.issues.createComment({
@@ -177,13 +202,13 @@ jobs:
               body: body
             });
 
-            console.log(`✅ 진행 상황 댓글 생성 완료: #${comment.id}`);
+            console.log(msg('ios_test_tf.log_progress_created', { id: comment.id }));
             core.setOutput('comment_id', comment.id);
             core.setOutput('start_time', startTime);
 
-  # 테스트 빌드 준비 (macOS 환경 설정)
+  # Prepare the test build (macOS environment setup)
   prepare-test-build:
-    name: 테스트 빌드 준비
+    name: Prepare test build
     runs-on: macos-26
     defaults:
       run:
@@ -204,6 +229,26 @@ jobs:
       commit_hash: ${{ steps.release_notes.outputs.commit_hash }}
 
     steps:
+      # Fetch the message catalog from the triggering ref first — the feature branch being built may predate it
+      - name: Checkout messages
+        uses: actions/checkout@v7
+        with:
+          path: .paw-msg
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
+      - name: Load messages
+        working-directory: ${{ github.workspace }}
+        run: |
+          cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
+          LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
+          rm -rf .paw-msg
+          echo "PROJECT_AUTO_WIZARD_LANG=$LANG_CODE" >> "$GITHUB_ENV"
+          echo "PAW_MESSAGES_PY=$RUNNER_TEMP/paw_messages.py" >> "$GITHUB_ENV"
+          echo "PAW_MSG=$(PROJECT_AUTO_WIZARD_LANG=$LANG_CODE python3 "$RUNNER_TEMP/paw_messages.py" dump ios_test_tf.)" >> "$GITHUB_ENV"
+
       - name: Checkout repository
         uses: actions/checkout@v7
         with:
@@ -213,8 +258,8 @@ jobs:
       - name: Pull latest changes
         run: git pull origin ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}
 
-      # 인증서 import·빌드 전에 설정 누락을 한 번에 알려 준다 — 없으면 macOS 러너에서 한참 빌드한 뒤에야 엉뚱한 단계에서 실패한다
-      - name: 배포 설정 사전 검증
+      # Report every missing setting up front, before importing certificates or building — otherwise the macOS runner builds for a long time and fails at an unrelated step
+      - name: Validate deploy settings
         env:
           APPLE_CERTIFICATE_BASE64: ${{ secrets.APPLE_CERTIFICATE_BASE64 }}
           APPLE_PROVISIONING_PROFILE_BASE64: ${{ secrets.APPLE_PROVISIONING_PROFILE_BASE64 }}
@@ -223,6 +268,7 @@ jobs:
           APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}
           APP_STORE_CONNECT_API_KEY_BASE64: ${{ secrets.APP_STORE_CONNECT_API_KEY_BASE64 }}
         run: |
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           FAILED=0
           MISSING=""
           for name in APPLE_CERTIFICATE_BASE64 APPLE_PROVISIONING_PROFILE_BASE64 IOS_PROVISIONING_PROFILE_NAME \
@@ -230,23 +276,23 @@ jobs:
             [ -n "${!name}" ] || MISSING="$MISSING $name"
           done
           if [ -n "$MISSING" ]; then
-            echo "::error::필수 GitHub Secret이 비어 있습니다:$MISSING (워크플로우 상단 주석 참고)"
+            echo "::error::$(m ios_test_tf.secrets_missing missing="$MISSING")"
             FAILED=1
           fi
           if [ ! -f ios/ExportOptions.plist ]; then
-            echo "::error::ios/ExportOptions.plist가 없습니다 — 저장소에 추가(커밋)하세요."
+            echo "::error::$(m ios_test_tf.export_options_missing)"
             FAILED=1
           elif grep -Eq '__[A-Z][A-Z0-9_]*__' ios/ExportOptions.plist; then
-            echo "::error::ios/ExportOptions.plist에 채워지지 않은 플레이스홀더가 남아 있습니다 — 팀 ID·번들 ID·프로비저닝 프로파일 이름으로 바꿔 커밋하세요."
+            echo "::error::$(m ios_test_tf.export_options_placeholders)"
             grep -En '__[A-Z][A-Z0-9_]*__' ios/ExportOptions.plist
             FAILED=1
           fi
           if [ ! -f ios/fastlane/Fastfile ]; then
-            echo "::error::ios/fastlane/Fastfile이 없습니다 — 저장소에 추가(커밋)하세요."
+            echo "::error::$(m ios_test_tf.fastfile_missing_error)"
             FAILED=1
           fi
           [ "$FAILED" -eq 0 ] || exit 1
-          echo "✅ 배포 설정 확인 완료"
+          m ios_test_tf.preflight_ok
 
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
@@ -264,81 +310,85 @@ jobs:
             echo "ℹ️ Empty Secrets.xcconfig created (no secrets provided)"
           fi
 
-      - name: 테스트 빌드 버전 설정
+      - name: Set test build version
         id: test_version
-        working-directory: ${{ github.workspace }}   # version_manager.py가 레포 루트 version.yml을 읽어야 함
+        working-directory: ${{ github.workspace }}   # version_manager.py must read version.yml at the repo root
         run: |
-          # version_manager.py로 버전 가져오기 (프로덕션 워크플로우와 동일한 방식)
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          # Get the version through version_manager.py (same approach as the production workflow)
           VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
           echo "version=$VERSION" >> $GITHUB_OUTPUT
 
-          # repository_dispatch 이벤트인 경우 PR 번호를 빌드 번호로 사용
+          # For repository_dispatch events, use the PR number as the build number
           if [ "${{ github.event_name }}" == "repository_dispatch" ]; then
             BUILD_NUMBER="${{ github.event.client_payload.build_number }}"
             PR_NUMBER="${{ github.event.client_payload.pr_number }}"
-            echo "📋 repository_dispatch 이벤트 감지"
-            echo "  PR 번호: #$PR_NUMBER"
-            echo "  빌드 번호: $BUILD_NUMBER (PR 번호 사용)"
+            m ios_test_tf.event_dispatch
+            m ios_test_tf.event_pr_number pr="$PR_NUMBER"
+            m ios_test_tf.event_build_number_pr build="$BUILD_NUMBER"
           else
             BUILD_NUMBER="${{ github.run_number }}"
             PR_NUMBER=""
-            echo "📋 workflow_dispatch 이벤트 감지"
-            echo "  빌드 번호: $BUILD_NUMBER (기본값)"
+            m ios_test_tf.event_workflow_dispatch
+            m ios_test_tf.event_build_number_default build="$BUILD_NUMBER"
           fi
 
           echo "build_number=$BUILD_NUMBER" >> $GITHUB_OUTPUT
           echo "pr_number=$PR_NUMBER" >> $GITHUB_OUTPUT
-          echo "📋 테스트 빌드: 버전=$VERSION, 빌드번호=$BUILD_NUMBER"
+          m ios_test_tf.test_build_log version="$VERSION" build="$BUILD_NUMBER"
 
-      - name: 브랜치명에서 이슈 정보 추출
+      - name: Extract issue info from the branch name
         id: issue_info
         run: |
-          # repository_dispatch인 경우 client_payload에서 브랜치명 가져오기
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          # For repository_dispatch, take the branch name from client_payload
           if [ "${{ github.event_name }}" == "repository_dispatch" ]; then
             BRANCH_NAME="${{ github.event.client_payload.branch_name }}"
             ISSUE_NUMBER="${{ github.event.client_payload.issue_number }}"
           else
             BRANCH_NAME="${{ github.ref_name }}"
-            # 브랜치명에서 이슈 번호 추출 (#387 형식)
+            # Extract the issue number from the branch name (`<date>_#<number>_...` format)
             ISSUE_NUMBER=$(echo "$BRANCH_NAME" | sed -n 's/.*#\([0-9]*\).*/\1/p')
           fi
 
-          echo "🌿 브랜치명: $BRANCH_NAME"
+          m ios_test_tf.branch_name_log branch="$BRANCH_NAME"
           echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT
 
           if [ -z "$ISSUE_NUMBER" ]; then
-            echo "⚠️ 브랜치명에서 이슈 번호를 찾을 수 없습니다."
+            m ios_test_tf.issue_number_missing
             echo "issue_url=" >> $GITHUB_OUTPUT
             echo "issue_title=" >> $GITHUB_OUTPUT
             echo "issue_number=" >> $GITHUB_OUTPUT
           else
-            echo "✅ 추출된 이슈 번호: #$ISSUE_NUMBER"
+            m ios_test_tf.issue_number_extracted number="$ISSUE_NUMBER"
             ISSUE_URL="https://github.com/${{ github.repository }}/issues/$ISSUE_NUMBER"
             echo "issue_url=$ISSUE_URL" >> $GITHUB_OUTPUT
             echo "issue_number=$ISSUE_NUMBER" >> $GITHUB_OUTPUT
 
-            # GitHub API로 이슈 정보 가져오기
-            echo "🔍 GitHub API로 이슈 정보 조회 중..."
+            # Fetch the issue info through the GitHub API
+            m ios_test_tf.issue_fetching
             ISSUE_RESPONSE=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
               "https://api.github.com/repos/${{ github.repository }}/issues/$ISSUE_NUMBER")
 
-            ISSUE_TITLE=$(echo "$ISSUE_RESPONSE" | jq -r '.title // "이슈 정보 없음"')
+            NO_ISSUE_INFO="$(m ios_test_tf.issue_title_default)"
+            ISSUE_TITLE=$(echo "$ISSUE_RESPONSE" | jq -r --arg d "$NO_ISSUE_INFO" '.title // $d')
             ISSUE_STATE=$(echo "$ISSUE_RESPONSE" | jq -r '.state // "unknown"')
 
-            if [ "$ISSUE_TITLE" = "null" ] || [ "$ISSUE_TITLE" = "이슈 정보 없음" ]; then
-              echo "⚠️ 이슈 #$ISSUE_NUMBER를 찾을 수 없습니다."
+            if [ "$ISSUE_TITLE" = "null" ] || [ "$ISSUE_TITLE" = "$NO_ISSUE_INFO" ]; then
+              m ios_test_tf.issue_not_found number="$ISSUE_NUMBER"
               echo "issue_title=" >> $GITHUB_OUTPUT
             else
-              echo "📋 이슈 제목: $ISSUE_TITLE"
-              echo "📌 이슈 상태: $ISSUE_STATE"
+              m ios_test_tf.issue_title_log title="$ISSUE_TITLE"
+              m ios_test_tf.issue_state_log state="$ISSUE_STATE"
               echo "issue_title=$ISSUE_TITLE" >> $GITHUB_OUTPUT
             fi
           fi
 
-      - name: 릴리즈 노트 생성
+      - name: Generate release notes
         id: release_notes
-        working-directory: ${{ github.workspace }}   # final_release_notes.txt(upload 짝)는 레포 루트 기준
+        working-directory: ${{ github.workspace }}   # final_release_notes.txt (paired with the upload step) is relative to the repo root
         run: |
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           BUILD_NUMBER="${{ steps.test_version.outputs.build_number }}"
           BRANCH_NAME="${{ steps.issue_info.outputs.branch_name }}"
           COMMIT_SHA="${{ github.sha }}"
@@ -347,30 +397,30 @@ jobs:
 
           echo "commit_hash=$COMMIT_SHORT" >> $GITHUB_OUTPUT
 
-          cat > final_release_notes.txt << EOF
-          테스트 빌드 #$BUILD_NUMBER
-
-          브랜치: $BRANCH_NAME
-          커밋: $COMMIT_SHORT
-          날짜: $BUILD_DATE
-
-          EOF
-
-          # 이슈 정보가 있으면 추가
+          {
+            m ios_test_tf.notes_build build="$BUILD_NUMBER"
+            echo
+            m ios_test_tf.notes_branch branch="$BRANCH_NAME"
+            m ios_test_tf.notes_commit commit="$COMMIT_SHORT"
+            m ios_test_tf.notes_date date="$BUILD_DATE"
+            echo
+          } > final_release_notes.txt
+
+          # Add the issue info when available
           if [ -n "${{ steps.issue_info.outputs.issue_number }}" ]; then
             ISSUE_NUMBER="${{ steps.issue_info.outputs.issue_number }}"
             ISSUE_TITLE="${{ steps.issue_info.outputs.issue_title }}"
             ISSUE_URL="${{ steps.issue_info.outputs.issue_url }}"
 
-            cat >> final_release_notes.txt << EOF
-          관련 이슈:
-          - #$ISSUE_NUMBER: $ISSUE_TITLE
-          - URL: $ISSUE_URL
-
-          EOF
+            {
+              m ios_test_tf.notes_issue_header
+              echo "- #$ISSUE_NUMBER: $ISSUE_TITLE"
+              echo "- URL: $ISSUE_URL"
+              echo
+            } >> final_release_notes.txt
           fi
 
-          echo "📋 생성된 릴리즈 노트:"
+          m ios_test_tf.notes_generated
           echo "----------------------------------------"
           cat final_release_notes.txt
           echo "----------------------------------------"
@@ -393,12 +443,15 @@ jobs:
             ${{ env.FLUTTER_PROJECT_DIR }}/assets/
           retention-days: 1
 
-      - name: 진행 상황 업데이트 - 준비 실패
+      - name: Progress update - prepare failed
         if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
             const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
             const branchName = '${{ github.event.client_payload.branch_name }}';
@@ -410,25 +463,25 @@ jobs:
             const elapsed = now - startTime;
             const minutes = Math.floor(elapsed / 60000);
             const seconds = Math.floor((elapsed % 60000) / 1000);
-            const duration = minutes > 0 ? `${minutes}분 ${seconds}초` : `${seconds}초`;
+            const duration = minutes > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: minutes, s: seconds }) : msg('ios_test_tf.elapsed_sec', { s: seconds });
 
             const body = [
-              '## 🍎 ❌ iOS TestFlight 빌드 실패',
+              msg('ios_test_tf.title_prepare_failed'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              `| 🔧 준비 | ❌ 실패 | ${duration} |`,
-              '| 🔨 IPA 빌드 | ⏸️ 취소됨 | - |',
-              '| 📤 TestFlight 배포 | ⏸️ 취소됨 | - |',
+              row('prepare', 'failed', duration),
+              row('build', 'canceled'),
+              row('deploy', 'canceled'),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **빌드 번호** | \`${buildNumber}\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
+              msg('ios_test_tf.row_build_number', { build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
               '',
-              '❌ **환경 준비 중 오류가 발생했습니다.**',
+              msg('ios_test_tf.prepare_error'),
               '',
-              `🔗 [워크플로우 실행 로그 확인](${runUrl})`
+              msg('ios_test_tf.run_log_check_link', { url: runUrl })
             ].join('\n');
 
             await github.rest.issues.updateComment({
@@ -438,11 +491,11 @@ jobs:
               body: body
             });
 
-            console.log(`❌ 진행 상황 업데이트 완료: 준비 실패`);
+            console.log(msg('ios_test_tf.log_prepare_failed'));
 
-  # iOS 빌드 (xcodebuild 직접 사용)
+  # iOS build (uses xcodebuild directly)
   build-ios-test:
-    name: iOS 테스트 빌드
+    name: iOS test build
     runs-on: macos-26
     defaults:
       run:
@@ -459,14 +512,37 @@ jobs:
       step2_end_time: ${{ steps.progress_step2.outputs.end_time }}
 
     steps:
-      # 진행 상황 업데이트 - 준비 완료 (build job 시작 시점에 업데이트해야 준비 시간이 정확히 표시됨)
-      - name: 진행 상황 업데이트 - 준비 완료
+      # Fetch the message catalog from the triggering ref first — the feature branch being built may predate it
+      - name: Checkout messages
+        uses: actions/checkout@v7
+        with:
+          path: .paw-msg
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
+      - name: Load messages
+        working-directory: ${{ github.workspace }}
+        run: |
+          cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
+          LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
+          rm -rf .paw-msg
+          echo "PROJECT_AUTO_WIZARD_LANG=$LANG_CODE" >> "$GITHUB_ENV"
+          echo "PAW_MESSAGES_PY=$RUNNER_TEMP/paw_messages.py" >> "$GITHUB_ENV"
+          echo "PAW_MSG=$(PROJECT_AUTO_WIZARD_LANG=$LANG_CODE python3 "$RUNNER_TEMP/paw_messages.py" dump ios_test_tf.)" >> "$GITHUB_ENV"
+
+      # Progress update - prepare done (must be updated when the build job starts so the prepare time is shown accurately)
+      - name: Progress update - prepare done
         id: progress_step1
         if: github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
             const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
             const branchName = '${{ github.event.client_payload.branch_name }}';
@@ -479,26 +555,26 @@ jobs:
             const elapsed = Math.round((now - startTime) / 1000);
             const minutes = Math.floor(elapsed / 60);
             const seconds = elapsed % 60;
-            const elapsedStr = minutes > 0 ? `${minutes}분 ${seconds}초` : `${seconds}초`;
+            const elapsedStr = minutes > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: minutes, s: seconds }) : msg('ios_test_tf.elapsed_sec', { s: seconds });
 
             const body = [
-              '## 🍎 iOS TestFlight 빌드 진행 중...',
+              msg('ios_test_tf.title_running'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              `| 🔧 준비 | ✅ 완료 | ${elapsedStr} |`,
-              '| 🔨 IPA 빌드 | ⏳ 진행 중... | - |',
-              '| 📤 TestFlight 배포 | ⏸️ 대기 | - |',
+              row('prepare', 'done', elapsedStr),
+              row('build', 'running'),
+              row('deploy', 'waiting'),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **앱 버전** | \`${version}(${buildNumber})\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
+              msg('ios_test_tf.row_app_version', { version, build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
               '',
-              `**[📋 실시간 로그 보기](${runUrl})**`,
+              msg('ios_test_tf.live_log_link', { url: runUrl }),
               '',
               '---',
-              '*🤖 이 댓글은 자동으로 업데이트됩니다.*'
+              msg('ios_test_tf.auto_update_note')
             ].join('\n');
 
             await github.rest.issues.updateComment({
@@ -508,7 +584,7 @@ jobs:
               body: body
             });
 
-            console.log(`✅ 진행 상황 업데이트 완료: 준비 완료 (${elapsedStr})`);
+            console.log(msg('ios_test_tf.log_prepare_done', { elapsed: elapsedStr }));
             core.setOutput('elapsed', elapsedStr);
             core.setOutput('end_time', now.toString());
 
@@ -526,7 +602,7 @@ jobs:
 
       - name: Install iOS device platform
         env:
-          # xcode-select만으로는 서브프로세스에 전파되지 않아 명시적으로 지정
+          # xcode-select alone does not propagate to subprocesses, so set it explicitly
           DEVELOPER_DIR: /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
         run: |
           echo "=== iPhoneOS.platform check ==="
@@ -590,12 +666,13 @@ jobs:
 
       - name: Install CocoaPods
         run: |
-          # 플러그인이 없는 기본 프로젝트는 Podfile이 없다 — 플러그인이 생기면 flutter build가 Podfile을 만든다
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          # A default project without plugins has no Podfile — flutter build creates one once a plugin is added
           if [ -f ios/Podfile ]; then
             gem install cocoapods
             (cd ios && pod install)
           else
-            echo "ℹ️ ios/Podfile이 없어 pod install을 건너뜁니다 (CocoaPods 플러그인 없음)"
+            m ios_test_tf.podfile_skip
           fi
 
       - name: Import Code-Signing Certificates
@@ -616,17 +693,18 @@ jobs:
 
       - name: Verify ExportOptions.plist
         run: |
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           cd ios
           if [ ! -f "ExportOptions.plist" ]; then
-            echo "❌ ios/ExportOptions.plist가 없습니다!"
-            echo "ios/ExportOptions.plist를 저장소에 추가(커밋)하세요. 필요한 Secrets는 워크플로우 상단 주석을 참고하세요."
+            m ios_test_tf.plist_missing
+            m ios_test_tf.plist_missing_hint
             exit 1
           fi
-          echo "✅ ExportOptions.plist 확인됨"
+          m ios_test_tf.plist_ok
 
       - name: Flutter build (no codesign)
         env:
-          # xcode-select만으로는 서브프로세스에 전파되지 않아 명시적으로 지정
+          # xcode-select alone does not propagate to subprocesses, so set it explicitly
           DEVELOPER_DIR: /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
         run: |
           flutter build ios --release --no-codesign \
@@ -637,7 +715,7 @@ jobs:
       - name: Create Archive
         env:
           IOS_PROVISIONING_PROFILE_NAME: ${{ secrets.IOS_PROVISIONING_PROFILE_NAME }}
-          # xcode-select만으로는 서브프로세스에 전파되지 않아 명시적으로 지정
+          # xcode-select alone does not propagate to subprocesses, so set it explicitly
           DEVELOPER_DIR: /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
         run: |
           cd ios
@@ -679,13 +757,16 @@ jobs:
             ${{ env.FLUTTER_PROJECT_DIR }}/build-metadata.json
           retention-days: 1
 
-      - name: 진행 상황 업데이트 - IPA 빌드 완료
+      - name: Progress update - IPA build done
         id: progress_step2
         if: success() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
             const step1EndTime = parseInt('${{ steps.progress_step1.outputs.end_time }}');
             const step1Elapsed = '${{ steps.progress_step1.outputs.elapsed }}';
@@ -697,30 +778,30 @@ jobs:
 
             const now = Date.now();
 
-            // 빌드 단계 소요 시간 (step1 종료 ~ 현재)
+            // Build step duration (step1 end to now)
             const elapsed = Math.round((now - step1EndTime) / 1000);
             const buildMin = Math.floor(elapsed / 60);
             const buildSec = elapsed % 60;
-            const elapsedStr = buildMin > 0 ? `${buildMin}분 ${buildSec}초` : `${buildSec}초`;
+            const elapsedStr = buildMin > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: buildMin, s: buildSec }) : msg('ios_test_tf.elapsed_sec', { s: buildSec });
 
             const body = [
-              '## 🍎 ✅ iOS 빌드 완료',
+              msg('ios_test_tf.title_ipa_done'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              `| 🔧 준비 | ✅ 완료 | ${step1Elapsed || '-'} |`,
-              `| 🔨 IPA 빌드 | ✅ 완료 | ${elapsedStr} |`,
-              '| 📤 TestFlight 배포 | ⏳ 진행 중... | - |',
+              row('prepare', 'done', step1Elapsed || '-'),
+              row('build', 'done', elapsedStr),
+              row('deploy', 'running'),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **앱 버전** | \`${version}(${buildNumber})\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
+              msg('ios_test_tf.row_app_version', { version, build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
               '',
-              `**[📋 실시간 로그 보기](${runUrl})**`,
+              msg('ios_test_tf.live_log_link', { url: runUrl }),
               '',
               '---',
-              '*🤖 이 댓글은 자동으로 업데이트됩니다.*'
+              msg('ios_test_tf.auto_update_note')
             ].join('\n');
 
             await github.rest.issues.updateComment({
@@ -730,16 +811,19 @@ jobs:
               body: body
             });
 
-            console.log(`✅ 진행 상황 업데이트 완료: IPA 빌드 완료 (${elapsedStr})`);
+            console.log(msg('ios_test_tf.log_ipa_done', { elapsed: elapsedStr }));
             core.setOutput('elapsed', elapsedStr);
             core.setOutput('end_time', now.toString());
 
-      - name: 빌드 실패 시 progress 댓글 업데이트
+      - name: Update the progress comment on build failure
         if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
             const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
             const step1EndTime = parseInt('${{ steps.progress_step1.outputs.end_time }}') || 0;
@@ -753,33 +837,33 @@ jobs:
 
             const now = Date.now();
 
-            // 빌드 단계 소요 시간 (step1 종료 ~ 현재)
+            // Build step duration (step1 end to now)
             let step2ElapsedStr = '-';
             if (step1EndTime > 0) {
               const step2_s = Math.round((now - step1EndTime) / 1000);
               const s2Min = Math.floor(step2_s / 60);
               const s2Sec = step2_s % 60;
-              step2ElapsedStr = s2Min > 0 ? `${s2Min}분 ${s2Sec}초` : `${s2Sec}초`;
+              step2ElapsedStr = s2Min > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: s2Min, s: s2Sec }) : msg('ios_test_tf.elapsed_sec', { s: s2Sec });
             }
 
             const body = [
-              '## 🍎 ❌ iOS TestFlight 빌드 실패',
+              msg('ios_test_tf.title_ipa_failed'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              `| 🔧 준비 | ✅ 완료 | ${step1Elapsed || '-'} |`,
-              `| 🔨 IPA 빌드 | ❌ 실패 | ${step2ElapsedStr} |`,
-              '| 📤 TestFlight 배포 | ⏸️ 취소됨 | - |',
+              row('prepare', 'done', step1Elapsed || '-'),
+              row('build', 'failed', step2ElapsedStr),
+              row('deploy', 'canceled'),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **앱 버전** | \`${version}(${buildNumber})\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
-              `| **커밋** | \`${commitHash}\` |`,
+              msg('ios_test_tf.row_app_version', { version, build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
+              msg('ios_test_tf.row_commit', { commit: commitHash }),
               '',
-              '❌ **IPA 빌드 중 오류가 발생했습니다.**',
+              msg('ios_test_tf.ipa_error'),
               '',
-              `🔗 [워크플로우 실행 로그 확인](${runUrl})`
+              msg('ios_test_tf.run_log_check_link', { url: runUrl })
             ].join('\n');
 
             await github.rest.issues.updateComment({
@@ -789,11 +873,11 @@ jobs:
               body: body
             });
 
-            console.log(`❌ 진행 상황 업데이트 완료: IPA 빌드 실패`);
+            console.log(msg('ios_test_tf.log_ipa_failed'));
 
-  # TestFlight 배포 (ios/fastlane/Fastfile 사용)
+  # TestFlight deploy (uses ios/fastlane/Fastfile)
   deploy-testflight-test:
-    name: TestFlight 테스트 배포
+    name: TestFlight test deploy
     runs-on: macos-26
     defaults:
       run:
@@ -804,6 +888,26 @@ jobs:
       needs.build-ios-test.result == 'success'
 
     steps:
+      # Fetch the message catalog from the triggering ref first — the feature branch being built may predate it
+      - name: Checkout messages
+        uses: actions/checkout@v7
+        with:
+          path: .paw-msg
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
+      - name: Load messages
+        working-directory: ${{ github.workspace }}
+        run: |
+          cp .paw-msg/.github/scripts/messages.py "$RUNNER_TEMP/paw_messages.py"
+          LANG_CODE=$(cd .paw-msg && python3 "$RUNNER_TEMP/paw_messages.py" lang)
+          rm -rf .paw-msg
+          echo "PROJECT_AUTO_WIZARD_LANG=$LANG_CODE" >> "$GITHUB_ENV"
+          echo "PAW_MESSAGES_PY=$RUNNER_TEMP/paw_messages.py" >> "$GITHUB_ENV"
+          echo "PAW_MSG=$(PROJECT_AUTO_WIZARD_LANG=$LANG_CODE python3 "$RUNNER_TEMP/paw_messages.py" dump ios_test_tf.)" >> "$GITHUB_ENV"
+
       - name: Checkout repository
         uses: actions/checkout@v7
         with:
@@ -832,21 +936,23 @@ jobs:
 
       - name: Verify Fastfile exists
         run: |
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
           if [ ! -f "ios/fastlane/Fastfile" ]; then
-            echo "❌ ios/fastlane/Fastfile이 없습니다!"
-            echo "ios/fastlane/Fastfile을 저장소에 추가(커밋)하세요. 필요한 Secrets는 워크플로우 상단 주석을 참고하세요."
+            m ios_test_tf.fastfile_missing
+            m ios_test_tf.fastfile_missing_hint
             exit 1
           fi
-          echo "✅ Fastfile 확인됨: ios/fastlane/Fastfile"
+          m ios_test_tf.fastfile_ok
 
       - name: Install Fastlane
         working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/ios
         run: |
-          # 저장소의 Gemfile에 fastlane이 있으면 그대로 쓴다 (Gemfile.lock 커밋 권장). 없으면 생성한다.
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          # Use the repository's Gemfile as-is if it lists fastlane (committing Gemfile.lock is recommended). Otherwise generate one.
           if [ -f Gemfile ] && grep -Eq "['\"]fastlane['\"]" Gemfile; then
-            echo "ℹ️ 저장소의 Gemfile을 사용합니다"
+            m ios_test_tf.gemfile_repo
           else
-            # multi_json: google-apis transitive 의존성이 선언 누락한 upstream 버그 회피 (gemspec 미선언 → Gem::LoadError)
+            # multi_json: works around an upstream bug where a google-apis transitive dependency omits it from its gemspec (Gem::LoadError)
             printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
           fi
           bundle install
@@ -857,27 +963,28 @@ jobs:
           APP_STORE_CONNECT_API_KEY_ID: ${{ secrets.APP_STORE_CONNECT_API_KEY_ID }}
           APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}
         run: |
-          # IPA 파일 찾기
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          # Find the IPA file
           IPA_PATH=$(find "$GITHUB_WORKSPACE/${FLUTTER_PROJECT_DIR}/ios/build/ipa" -name "*.ipa" | head -1)
           echo "📦 Found IPA at: $IPA_PATH"
 
           if [ ! -f "$IPA_PATH" ]; then
-            echo "❌ IPA 파일을 찾을 수 없습니다!"
+            m ios_test_tf.ipa_missing
             ls -la ios/build/ipa/
             exit 1
           fi
 
-          # Release notes 준비 (final_release_notes.txt는 레포 루트 기준 — working-directory가 FLUTTER_PROJECT_DIR이므로 절대경로 사용)
+          # Prepare release notes (final_release_notes.txt is relative to the repo root — use an absolute path since working-directory is FLUTTER_PROJECT_DIR)
           if [ -f "$GITHUB_WORKSPACE/final_release_notes.txt" ]; then
             RELEASE_NOTES=$(cat "$GITHUB_WORKSPACE/final_release_notes.txt")
             echo "📝 Release Notes:"
             echo "$RELEASE_NOTES"
           else
-            RELEASE_NOTES="테스트 빌드 #${{ needs.prepare-test-build.outputs.build_number }}"
-            echo "📝 기본 Release Notes: $RELEASE_NOTES"
+            RELEASE_NOTES="$(m ios_test_tf.notes_build build="${{ needs.prepare-test-build.outputs.build_number }}")"
+            m ios_test_tf.default_notes_echo notes="$RELEASE_NOTES"
           fi
 
-          # 환경변수 설정 (Fastfile에서 사용)
+          # Set the environment variables (used by the Fastfile)
           export API_KEY_PATH="$HOME/.appstoreconnect/private_keys/AuthKey_${APP_STORE_CONNECT_API_KEY_ID}.p8"
           export IPA_PATH="$IPA_PATH"
           export RELEASE_NOTES="$RELEASE_NOTES"
@@ -886,37 +993,42 @@ jobs:
           echo "🔧 IPA_PATH: $IPA_PATH"
           echo "🔧 API_KEY_PATH: $API_KEY_PATH"
 
-          # Fastlane 실행 (ios/fastlane/Fastfile 사용)
+          # Run Fastlane (uses ios/fastlane/Fastfile)
           cd ios
           bundle exec fastlane upload_testflight
 
       - name: Notify TestFlight Upload Success
         if: success()
         run: |
-          echo "✅ TestFlight 테스트 빌드 업로드 성공!"
-          echo "버전: ${{ needs.prepare-test-build.outputs.version }}"
-          echo "빌드 번호: ${{ needs.prepare-test-build.outputs.build_number }}"
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          m ios_test_tf.upload_ok
+          m ios_test_tf.upload_version version="${{ needs.prepare-test-build.outputs.version }}"
+          m ios_test_tf.upload_build build="${{ needs.prepare-test-build.outputs.build_number }}"
           if [ -n "${{ needs.prepare-test-build.outputs.pr_number }}" ]; then
-            echo "PR 번호: ${{ needs.prepare-test-build.outputs.pr_number }}"
+            m ios_test_tf.upload_pr pr="${{ needs.prepare-test-build.outputs.pr_number }}"
           fi
-          echo "브랜치: ${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
-          echo "커밋: ${{ github.sha }}"
+          m ios_test_tf.upload_branch branch="${{ github.event_name == 'repository_dispatch' && github.event.client_payload.branch_name || github.ref_name }}"
+          m ios_test_tf.upload_commit sha="${{ github.sha }}"
           if [ -n "${{ needs.prepare-test-build.outputs.issue_url }}" ]; then
-            echo "관련 이슈: ${{ needs.prepare-test-build.outputs.issue_url }}"
+            m ios_test_tf.upload_issue url="${{ needs.prepare-test-build.outputs.issue_url }}"
           fi
 
       - name: Notify on Failure
         if: failure()
         run: |
-          echo "❌ TestFlight 테스트 빌드 업로드 실패!"
-          echo "로그를 확인해주세요."
+          m() { python3 "$PAW_MESSAGES_PY" get "$@"; }
+          m ios_test_tf.upload_failed
+          m ios_test_tf.check_logs
 
-      - name: 진행 상황 최종 업데이트 - 성공
+      - name: Final progress update - success
         if: success() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
             const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
             const step2EndTime = parseInt('${{ needs.build-ios-test.outputs.step2_end_time }}');
@@ -931,37 +1043,37 @@ jobs:
 
             const now = Date.now();
 
-            // 배포 단계 소요 시간 (step2 종료 ~ 현재)
+            // Deploy step duration (step2 end to now)
             const step3_s = Math.round((now - step2EndTime) / 1000);
             const s3Min = Math.floor(step3_s / 60);
             const s3Sec = step3_s % 60;
-            const step3Elapsed = s3Min > 0 ? `${s3Min}분 ${s3Sec}초` : `${s3Sec}초`;
+            const step3Elapsed = s3Min > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: s3Min, s: s3Sec }) : msg('ios_test_tf.elapsed_sec', { s: s3Sec });
 
-            // 전체 소요 시간
+            // Total duration
             const total_s = Math.round((now - startTime) / 1000);
             const tMin = Math.floor(total_s / 60);
             const tSec = total_s % 60;
-            const totalElapsed = tMin > 0 ? `${tMin}분 ${tSec}초` : `${tSec}초`;
+            const totalElapsed = tMin > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: tMin, s: tSec }) : msg('ios_test_tf.elapsed_sec', { s: tSec });
 
             const body = [
-              '## 🍎 ✅ iOS TestFlight 배포 완료',
+              msg('ios_test_tf.title_deploy_done'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              `| 🔧 준비 | ✅ 완료 | ${step1Elapsed || '-'} |`,
-              `| 🔨 IPA 빌드 | ✅ 완료 | ${step2Elapsed || '-'} |`,
-              `| 📤 TestFlight 배포 | ✅ 완료 | ${step3Elapsed} |`,
+              row('prepare', 'done', step1Elapsed || '-'),
+              row('build', 'done', step2Elapsed || '-'),
+              row('deploy', 'done', step3Elapsed),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **앱 버전** | \`${version}(${buildNumber})\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
-              `| **커밋** | \`${commitHash}\` |`,
-              `| **총 소요 시간** | ${totalElapsed} |`,
+              msg('ios_test_tf.row_app_version', { version, build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
+              msg('ios_test_tf.row_commit', { commit: commitHash }),
+              msg('ios_test_tf.row_total', { elapsed: totalElapsed }),
               '',
-              '📱 **TestFlight에서 테스트 앱을 다운로드할 수 있습니다.**',
+              msg('ios_test_tf.download_hint'),
               '',
-              `🔗 [워크플로우 실행 로그](${runUrl})`
+              msg('ios_test_tf.run_log_link', { url: runUrl })
             ].join('\n');
 
             await github.rest.issues.updateComment({
@@ -971,14 +1083,17 @@ jobs:
               body: body
             });
 
-            console.log(`✅ 진행 상황 최종 업데이트 완료: 전체 성공 (${totalElapsed})`);
+            console.log(msg('ios_test_tf.log_all_done', { elapsed: totalElapsed }));
 
-      - name: 진행 상황 최종 업데이트 - 실패
+      - name: Final progress update - failure
         if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
+            const M = JSON.parse(process.env.PAW_MSG);
+            const msg = (k, p = {}) => M[k].replace(/\{(\w+)\}/g, (s, n) => (n in p ? p[n] : s));
+            const row = (name, status, elapsed = '-') => `| ${msg('ios_test_tf.step_' + name)} | ${msg('ios_test_tf.st_' + status)} | ${elapsed} |`;
             const commentId = parseInt('${{ needs.notify-start.outputs.comment_id }}');
             const startTime = parseInt('${{ needs.notify-start.outputs.start_time }}');
             const step2EndTime = parseInt('${{ needs.build-ios-test.outputs.step2_end_time }}') || 0;
@@ -993,33 +1108,33 @@ jobs:
 
             const now = Date.now();
 
-            // 배포 단계 소요 시간 (step2 종료 ~ 현재)
+            // Deploy step duration (step2 end to now)
             let step3Elapsed = '-';
             if (step2EndTime > 0) {
               const step3_s = Math.round((now - step2EndTime) / 1000);
               const s3Min = Math.floor(step3_s / 60);
               const s3Sec = step3_s % 60;
-              step3Elapsed = s3Min > 0 ? `${s3Min}분 ${s3Sec}초` : `${s3Sec}초`;
+              step3Elapsed = s3Min > 0 ? msg('ios_test_tf.elapsed_min_sec', { m: s3Min, s: s3Sec }) : msg('ios_test_tf.elapsed_sec', { s: s3Sec });
             }
 
             const body = [
-              '## 🍎 ❌ iOS TestFlight 배포 실패',
+              msg('ios_test_tf.title_deploy_failed'),
               '',
-              '| 단계 | 상태 | 소요 시간 |',
+              msg('ios_test_tf.table_header'),
               '|------|------|----------|',
-              `| 🔧 준비 | ✅ 완료 | ${step1Elapsed || '-'} |`,
-              `| 🔨 IPA 빌드 | ✅ 완료 | ${step2Elapsed || '-'} |`,
-              `| 📤 TestFlight 배포 | ❌ 실패 | ${step3Elapsed} |`,
+              row('prepare', 'done', step1Elapsed || '-'),
+              row('build', 'done', step2Elapsed || '-'),
+              row('deploy', 'failed', step3Elapsed),
               '',
-              '| 항목 | 값 |',
+              msg('ios_test_tf.kv_head'),
               '|------|-----|',
-              `| **앱 버전** | \`${version}(${buildNumber})\` |`,
-              `| **브랜치** | \`${branchName}\` |`,
-              `| **커밋** | \`${commitHash}\` |`,
+              msg('ios_test_tf.row_app_version', { version, build: buildNumber }),
+              msg('ios_test_tf.row_branch', { branch: branchName }),
+              msg('ios_test_tf.row_commit', { commit: commitHash }),
               '',
-              '❌ **TestFlight 배포 중 오류가 발생했습니다.**',
+              msg('ios_test_tf.deploy_error'),
               '',
-              `🔗 [워크플로우 실행 로그 확인](${runUrl})`
+              msg('ios_test_tf.run_log_check_link', { url: runUrl })
             ].join('\n');
 
             await github.rest.issues.updateComment({
@@ -1029,4 +1144,4 @@ jobs:
               body: body
             });
 
-            console.log(`❌ 진행 상황 최종 업데이트 완료: TestFlight 배포 실패`);
+            console.log(msg('ios_test_tf.log_deploy_failed'));