project-auto-wizard 0.13.3 → 0.15.0

package/payload/workflows/next/PROJECT-NEXT-CI.yaml

@@ -1,14 +1,14 @@
 # project-auto-wizard:managed-workflow
-# Next.js CI (빌드 검증)
-# {{DEVELOP_BRANCH}} 브랜치 push·PR 시 npm ci, npm test(test 스크립트가 있을 때), npm run build로 검증합니다. node_modules와 .next/cache를 캐싱합니다.
+# Next.js CI (build verification)
+# On push/PR to the {{DEVELOP_BRANCH}} branch, verifies with npm ci, npm test (when a test script exists) and npm run build. Caches node_modules and .next/cache.
 #
 # GitHub Secrets
-#   ENV_FILE (선택): .env 파일 내용. CI는 빌드 검증 목적이므로 배포 관련 Secrets는 불필요
+#   ENV_FILE (optional): contents of the .env file. CI only verifies the build, so no deploy-related Secrets are needed
 #
-# 프로젝트별 설정 (env 섹션)
-#   PROJECT_NAME : 프로젝트 이름
-#   NODE_VERSION : Node.js 버전 (기본: 20.15.0)
-#   ENV_FILE     : 환경변수 파일명 (기본: .env)
+# Project settings (env section)
+#   PROJECT_NAME : project name
+#   NODE_VERSION : Node.js version (default: 20.15.0)
+#   ENV_FILE     : environment file name (default: .env)
 
 name: PROJECT-NEXT-CI
 
@@ -23,7 +23,7 @@ env:
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
   NODE_VERSION: "20.15.0"
   ENV_FILE: ".env"
-  # 모노레포에서 이 프로젝트가 있는 하위 경로 ('.'이면 항상 검증)
+  # Subdirectory of this project in a monorepo ('.' means always verify)
   PROJECT_PATH: "."  # @wizard auto:project-path
 
 permissions:
@@ -32,9 +32,9 @@ permissions:
   issues: write
 
 jobs:
-  # Job: 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
+  # Job: change detection (in a monorepo, checks whether this project's path changed)
   changes:
-    name: 변경 감지
+    name: Detect changes
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -45,45 +45,46 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v7
 
-      - name: 프로젝트 경로 변경 여부 판별
+      - name: Check whether the project path changed
         id: filter
         if: ${{ github.event_name != 'workflow_dispatch' }}
         uses: dorny/paths-filter@v4
         with:
-          # push는 이번 push 범위(직전 커밋 before 대비)만 본다. 비워 두면 기본 브랜치 대비 누적 diff가 된다.
-          # 새 브랜치 첫 push(before가 0)와 PR은 빈 값 → 기본 동작(기본 브랜치·PR base 대비)
+          # A push only looks at this push's range (against the previous commit, 'before'). Left empty it would be the cumulative diff against the default branch.
+          # The first push of a new branch (before is 0) and PRs get an empty value -> default behavior (against the default branch / PR base)
           base: ${{ github.event_name == 'push' && github.event.before != '0000000000000000000000000000000000000000' && github.event.before || '' }}
           filters: |
             project:
               - '${{ env.PROJECT_PATH == '.' && '**' || format('{0}/**', env.PROJECT_PATH) }}'
 
   build:
-    name: Next.js 애플리케이션 빌드
+    name: Build Next.js application
     runs-on: ubuntu-latest
     needs: changes
     if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
-    # 모노레포(--paths)면 그 하위 폴더에서 빌드한다
+    # In a monorepo (--paths), build inside that subfolder
     defaults:
       run:
         working-directory: ${{ env.PROJECT_PATH }}
 
     steps:
-      - name: 코드 체크아웃
+      - name: Checkout repository
         uses: actions/checkout@v7
 
-      - name: 환경변수 파일 생성 (${{ env.ENV_FILE }})
+      - name: Create environment file (${{ env.ENV_FILE }})
         run: |
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
           echo -e "${{ secrets.ENV_FILE || secrets.ENV }}" > ${{ env.ENV_FILE }}
-          echo "✅ ${{ env.ENV_FILE }} 파일 생성 완료"
+          m cicd.env_file_created file="${{ env.ENV_FILE }}"
 
-      - name: Node.js 설정
+      - name: Set up Node.js
         uses: actions/setup-node@v7
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: "npm"
           cache-dependency-path: ${{ env.PROJECT_PATH }}/package-lock.json
 
-      - name: npm 의존성 캐싱
+      - name: Cache npm dependencies
         uses: actions/cache@v6
         with:
           path: ~/.npm
@@ -91,7 +92,7 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-npm-
 
-      - name: node_modules 캐싱
+      - name: Cache node_modules
         id: node-modules-cache
         uses: actions/cache@v6
         with:
@@ -100,16 +101,17 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-node-modules-
 
-      - name: 의존성 설치
+      - name: Install dependencies
         if: steps.node-modules-cache.outputs.cache-hit != 'true'
         run: |
-          echo "📦 의존성 설치 중..."
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
+          m cibuild.node_deps_installing
           npm ci
-          echo "✅ 의존성 설치 완료"
+          m cibuild.node_deps_done
 
-      # Next.js 빌드 캐싱 (.next/cache)
-      # 증분 빌드를 위해 .next/cache 폴더를 캐싱합니다
-      - name: Next.js 빌드 캐싱
+      # Cache the Next.js build (.next/cache)
+      # Caches the .next/cache folder for incremental builds
+      - name: Cache Next.js build
         uses: actions/cache@v6
         with:
           path: ${{ env.PROJECT_PATH }}/.next/cache
@@ -118,66 +120,69 @@ jobs:
             ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
             ${{ runner.os }}-nextjs-
 
-      # package.json에 test 스크립트가 있을 때만 실행한다 (npm init 기본값 "no test specified"는 없는 것으로 본다)
-      - name: 테스트 실행
+      # Runs only when package.json has a test script (the npm init default "no test specified" counts as none)
+      - name: Run tests
         run: |
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
           TEST_SCRIPT=$(node -p "(require('./package.json').scripts || {}).test || ''")
           if [ -z "$TEST_SCRIPT" ] || echo "$TEST_SCRIPT" | grep -q "no test specified"; then
-            echo "::notice::package.json에 test 스크립트가 없어 테스트를 건너뜁니다"
+            m cibuild.node_no_test_script
             exit 0
           fi
-          echo "🧪 npm test 실행: $TEST_SCRIPT"
-          # CI=true: watch 모드로 대기하는 테스트 러너(react-scripts 등)를 한 번만 실행
+          m cibuild.node_test_run script="$TEST_SCRIPT"
+          # CI=true: run watch-mode test runners (react-scripts, etc.) only once
           CI=true npm test
 
-      - name: 프로젝트 빌드
+      - name: Build project
         id: build
         run: |
-          echo "🔨 Next.js 빌드 시작..."
-          echo "프로젝트: ${{ env.PROJECT_NAME }}"
-          echo "Node.js: ${{ env.NODE_VERSION }}"
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
+          m cibuild.node_build_start_next
+          m cibuild.node_build_project project="${{ env.PROJECT_NAME }}"
+          m cibuild.node_build_node node="${{ env.NODE_VERSION }}"
           echo ""
 
-          # 빌드 실행 및 로그 저장
+          # Run the build and save the log
           npm run build > build_log.txt 2>&1 || {
             echo "build_failed=true" >> $GITHUB_OUTPUT
             echo "status=failed" >> $GITHUB_OUTPUT
             echo ""
-            echo "❌ 빌드 실패"
+            m cibuild.node_build_failed
             exit 0
           }
 
           echo "build_failed=false" >> $GITHUB_OUTPUT
           echo "status=success" >> $GITHUB_OUTPUT
-          echo "✅ 빌드 완료"
+          m cibuild.node_build_ok
 
-          # 빌드 결과 확인
+          # Check the build output
           if [ -d ".next" ]; then
             echo ""
-            echo "📁 빌드 결과물:"
-            echo "  - .next/ 폴더 생성됨"
+            m cibuild.node_build_output
+            m cibuild.node_build_next_dir
             du -sh .next/ || true
           fi
 
-      - name: 빌드 에러 로그 출력
+      - name: Print build error log
         if: steps.build.outputs.build_failed == 'true'
         run: |
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-          echo "❌ 빌드 실패 - 에러 로그"
+          m cibuild.node_errlog_title
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
           echo ""
 
           if [ -f "build_log.txt" ]; then
             tail -n 50 build_log.txt
           else
-            echo "에러 로그 파일을 찾을 수 없습니다."
+            m cibuild.node_errlog_missing
           fi
 
           echo ""
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
           exit 1
 
-      - name: 빌드 로그 업로드
+      - name: Upload build log
         if: always()
         uses: actions/upload-artifact@v7
         with:
@@ -185,41 +190,52 @@ jobs:
           path: ${{ env.PROJECT_PATH }}/build_log.txt
           retention-days: 7
 
-      - name: 빌드 결과 요약
+      - name: Build result summary
         if: always()
         run: |
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
           echo ""
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
           if [ "${{ steps.build.outputs.status }}" = "success" ]; then
-            echo "🎉 Next.js 빌드 완료!"
+            m cibuild.node_result_next_ok
           else
-            echo "❌ Next.js 빌드 실패"
+            m cibuild.node_result_next_fail
           fi
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
           echo ""
-          echo "📊 빌드 결과:"
-          echo "  📦 프로젝트: ${{ env.PROJECT_NAME }}"
-          echo "  📌 Node.js 버전: ${{ env.NODE_VERSION }}"
-          echo "  🆙 빌드 상태: ${{ steps.build.outputs.status }}"
-          echo "  🌿 브랜치: ${{ github.ref_name }}"
-          echo "  📝 커밋: ${{ github.sha }}"
-          echo "  🕐 시간: $(date '+%Y-%m-%d %H:%M:%S UTC')"
+          m cibuild.node_result_title
+          m cibuild.node_result_project project="${{ env.PROJECT_NAME }}"
+          m cibuild.node_result_node node="${{ env.NODE_VERSION }}"
+          m cibuild.node_result_status status="${{ steps.build.outputs.status }}"
+          m cibuild.node_result_branch branch="${{ github.ref_name }}"
+          m cibuild.node_result_commit sha="${{ github.sha }}"
+          m cibuild.node_result_time time="$(date '+%Y-%m-%d %H:%M:%S UTC')"
           echo ""
           echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-  # Job: CI Gate (required check로 등록할 단일 job)
+  # Job: CI Gate (the single job to register as a required check)
   ci-gate:
     name: CI Gate
     if: ${{ always() }}
     needs: [changes, build]
     runs-on: ubuntu-latest
     steps:
-      - name: 결과 집계
+      # Only the message catalog is needed here, so check out just that
+      - name: Checkout message catalog
+        uses: actions/checkout@v7
+        with:
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
+      - name: Aggregate results
         env:
           RESULTS: ${{ toJSON(needs.*.result) }}
         run: |
-          echo "needs 결과: $RESULTS"
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
+          m cibuild.gate_results results="$RESULTS"
           if echo "$RESULTS" | grep -Eq '"(failure|cancelled)"'; then
-            echo "실패하거나 취소된 job이 있습니다."
+            m cibuild.gate_failed
             exit 1
           fi

package/payload/workflows/next/PROJECT-NEXT-CICD.yaml

@@ -1,20 +1,20 @@
 # project-auto-wizard:managed-workflow
-# Next.js CI/CD 배포
-# {{MAIN_BRANCH}} 브랜치 푸시 시 Docker 이미지를 빌드하고 배포합니다. SSR 지원을 위해 Node.js 런타임 컨테이너로 배포됩니다.
+# Next.js CI/CD deployment
+# Builds a Docker image and deploys it when the {{MAIN_BRANCH}} branch is pushed. Deployed as a Node.js runtime container to support SSR.
 #
 # GitHub Secrets
-#   ENV_FILE: .env 파일 내용
-#   DOCKERHUB_USERNAME: DockerHub 사용자명
-#   DOCKERHUB_TOKEN: DockerHub 액세스 토큰
-#   SERVER_HOST: 배포 서버 주소
-#   SERVER_USER: SSH 사용자명
-#   SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
-#   SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-#   PROJECT_DEPLOY_PORT (선택): 배포 포트 (기본: 3000)
+#   ENV_FILE: contents of the .env file
+#   DOCKERHUB_USERNAME: DockerHub username
+#   DOCKERHUB_TOKEN: DockerHub access token
+#   SERVER_HOST: deploy server address
+#   SERVER_USER: SSH username
+#   SERVER_PASSWORD: SSH password (when SSH_AUTH_METHOD=password)
+#   SSH_KEY: contents of the SSH private key .pem (when SSH_AUTH_METHOD=key, e.g. AWS EC2)
+#   PROJECT_DEPLOY_PORT (optional): deploy port (default: 3000)
 #
-# 환경변수 (env 섹션에서 설정)
-#   SSH_AUTH_METHOD: SSH 인증 방식 password | key (기본: password)
-#   SSH_PORT (기본: 2022), SSH_COMMAND_TIMEOUT (기본: 600s), SSH_CONNECTION_TIMEOUT (기본: 60s)
+# Environment variables (set in the env section)
+#   SSH_AUTH_METHOD: SSH auth method password | key (default: password)
+#   SSH_PORT (default: 2022), SSH_COMMAND_TIMEOUT (default: 600s), SSH_CONNECTION_TIMEOUT (default: 60s)
 
 name: PROJECT-NEXT-CICD
 
@@ -22,41 +22,42 @@ on:
   push:
     branches:
       - "{{MAIN_BRANCH}}"
-    # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
+    # @wizard paths-anchor (for a monorepo the integrator injects the paths filter here)
   workflow_dispatch:
 
 env:
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
-  # 모노레포(--paths)에서 이 프로젝트가 있는 하위 경로. 빌드·Docker context의 기준 ('.'이면 레포 루트)
+  # Subdirectory of this project in a monorepo (--paths). Base for the build and Docker context ('.' means the repo root)
   PROJECT_PATH: "."  # @wizard auto:project-path
   DOCKER_IMAGE_PREFIX: "nextjs-container"
   NODE_VERSION: "20.15.0"
   ENV_FILE_NAME: ".env"
 
-  # SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
-  #   password → SERVER_PASSWORD secret 사용
-  #   key      → SSH_KEY secret 사용 (.pem 파일 전체 내용을 secret 값으로)
+  # SSH auth method: "password" (Synology, generic servers) | "key" (AWS EC2, .pem)
+  #   password -> uses the SERVER_PASSWORD secret
+  #   key      -> uses the SSH_KEY secret (the whole .pem file content as the secret value)
   SSH_AUTH_METHOD: "password"  # @wizard ask:password
 
   SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
-  SSH_COMMAND_TIMEOUT: "600s"  # SSH 명령 실행 타임아웃
-  SSH_CONNECTION_TIMEOUT: "60s"  # SSH 연결 타임아웃
+  SSH_COMMAND_TIMEOUT: "600s"  # SSH command execution timeout
+  SSH_CONNECTION_TIMEOUT: "60s"  # SSH connection timeout
 
 jobs:
   build:
-    name: Next.js 애플리케이션 빌드
+    name: Build Next.js application
     runs-on: ubuntu-latest
-    # 모노레포(--paths)면 그 하위 폴더에서 빌드한다
+    # In a monorepo (--paths), build inside that subfolder
     defaults:
       run:
         working-directory: ${{ env.PROJECT_PATH }}
 
     steps:
-      - name: 코드 체크아웃
+      - name: Checkout repository
         uses: actions/checkout@v7
 
-      # 필수 Secret·Dockerfile이 없으면 docker 로그인 같은 서드파티 오류 대신 빠진 항목을 알려 주고 멈춘다
-      - name: 배포 사전 점검 (Secret·Dockerfile)
+      # If a required Secret or the Dockerfile is missing, report the missing item and stop
+      # instead of failing later with a third-party error such as docker login
+      - name: Deploy pre-check (Secrets and Dockerfile)
         working-directory: ${{ env.PROJECT_PATH }}
         env:
           DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
@@ -67,11 +68,12 @@ jobs:
           SSH_KEY: ${{ secrets.SSH_KEY }}
           DOCKERFILE: Dockerfile
         run: |
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
           MISSING=""
           for NAME in DOCKERHUB_USERNAME DOCKERHUB_TOKEN SERVER_HOST SERVER_USER; do
             [ -n "${!NAME}" ] || MISSING="$MISSING $NAME"
           done
-          # SSH_AUTH_METHOD=key면 SSH_KEY, 아니면 SERVER_PASSWORD가 필요하다
+          # SSH_AUTH_METHOD=key needs SSH_KEY, otherwise SERVER_PASSWORD is required
           if [ "${SSH_AUTH_METHOD:-password}" = "key" ]; then
             [ -n "$SSH_KEY" ] || MISSING="$MISSING SSH_KEY"
           else
@@ -79,33 +81,34 @@ jobs:
           fi
           FAILED=false
           if [ -n "$MISSING" ]; then
-            echo "::error title=필수 Secret 누락::등록되지 않은 GitHub Secret:$MISSING — Settings → Secrets and variables → Actions에서 등록하세요"
+            echo "::error title=$(m cicd.precheck_secret_title)::$(m cicd.precheck_secret_body missing="$MISSING")"
             FAILED=true
           fi
           if [ ! -f "$DOCKERFILE" ]; then
-            echo "::error title=Dockerfile 없음::${PROJECT_PATH}/${DOCKERFILE#./} 파일이 없습니다. 이 워크플로우는 Docker 이미지로 배포하므로 Dockerfile이 필요합니다 (서버 배포를 하지 않는다면 이 워크플로우 파일을 삭제하세요)"
+            echo "::error title=$(m cicd.precheck_dockerfile_title)::$(m cicd.precheck_dockerfile_body path="${PROJECT_PATH}/${DOCKERFILE#./}")"
             FAILED=true
           fi
           if [ "$FAILED" = "true" ]; then
             exit 1
           fi
-          echo "✅ 사전 점검 통과: 필수 Secret과 Dockerfile이 모두 있습니다"
+          m cicd.precheck_ok
 
-      - name: Node.js 설정
+      - name: Set up Node.js
         uses: actions/setup-node@v7
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'npm'
           cache-dependency-path: ${{ env.PROJECT_PATH }}/package-lock.json
 
-      - name: 환경변수 파일 생성 (${{ env.ENV_FILE_NAME }})
+      - name: Create environment file (${{ env.ENV_FILE_NAME }})
         run: |
+          m() { (cd "$GITHUB_WORKSPACE" && python3 .github/scripts/messages.py get "$@"); }
           cat << 'EOF' > ./${{ env.ENV_FILE_NAME }}
           ${{ secrets.ENV_FILE || secrets.ENV }}
           EOF
-          echo "✅ ${{ env.ENV_FILE_NAME }} 파일 생성 완료"
+          m cicd.env_file_created file="${{ env.ENV_FILE_NAME }}"
 
-      - name: npm 의존성 캐싱
+      - name: Cache npm dependencies
         uses: actions/cache@v6
         with:
           path: ~/.npm
@@ -113,7 +116,7 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-npm-
 
-      - name: node_modules 캐싱
+      - name: Cache node_modules
         id: node-modules-cache
         uses: actions/cache@v6
         with:
@@ -122,11 +125,11 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-node-modules-
 
-      - name: 의존성 설치
+      - name: Install dependencies
         if: steps.node-modules-cache.outputs.cache-hit != 'true'
         run: npm ci
 
-      - name: Next.js 빌드 캐싱
+      - name: Cache Next.js build
         uses: actions/cache@v6
         with:
           path: ${{ env.PROJECT_PATH }}/.next/cache
@@ -138,10 +141,10 @@ jobs:
       - name: Build with npm
         run: npm run build
 
-      - name: Docker 빌드환경 설정
+      - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
-      - name: DockerHub 로그인
+      - name: Log in to DockerHub
         uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
@@ -155,7 +158,7 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-buildx-
 
-      - name: Docker 이미지 빌드 및 푸시
+      - name: Build and push Docker image
         uses: docker/build-push-action@v5
         with:
           context: ${{ env.PROJECT_PATH }}
@@ -171,11 +174,25 @@ jobs:
           mv /tmp/.buildx-cache-new /tmp/.buildx-cache
 
   deploy:
-    name: 원격 서버 배포
+    name: Deploy to remote server
     needs: build
     runs-on: ubuntu-latest
 
     steps:
+      # The deploy script runs on the remote server, so the messages are resolved here
+      # and handed to it through env vars (PAW_M_*)
+      - name: Checkout message catalog
+        uses: actions/checkout@v7
+        with:
+          sparse-checkout: |
+            .github/scripts/messages.py
+            version.yml
+          sparse-checkout-cone-mode: false
+
+      - name: Load messages
+        run: |
+          python3 .github/scripts/messages.py dump cicd. | PYTHONIOENCODING=utf-8 python3 -c 'import json,sys; [print("PAW_M_" + k.replace(".", "_") + "=" + v) for k, v in json.load(sys.stdin).items()]' >> "$GITHUB_ENV"
+
       - name: Deploy
         uses: appleboy/ssh-action@v1.0.3
         env:
@@ -192,65 +209,68 @@ jobs:
           script: |
             set -e
 
-            # 배포 환경 변수 설정
-            echo "🔧 환경변수 설정.."
+            # Fill the {name} placeholders of a message template (usage: m "template" name=value ...)
+            m() { local s="$1" kv; shift; for kv in "$@"; do s="${s//\{${kv%%=*}\}/${kv#*=}}"; done; printf '%s\n' "$s"; }
+
+            # Set deploy environment variables
+            m "${{ env.PAW_M_cicd_setup_env }}"
             export PATH=$PATH:/usr/local/bin
             export PW=${{ secrets.SERVER_PASSWORD }}
 
-            # SSH 인증 방식에 따른 sudo 추상화
-            #   password 모드: echo $PW | sudo -S  (Synology 등 sudo 비밀번호 필요 서버)
-            #   key 모드: sudo 직접  (AWS EC2 등 passwordless sudo 서버)
+            # sudo abstraction per SSH auth method
+            #   password mode: echo $PW | sudo -S  (servers that need a sudo password, e.g. Synology)
+            #   key mode: plain sudo  (passwordless-sudo servers, e.g. AWS EC2)
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
             if [ "${SSH_AUTH_METHOD}" = "key" ]; then
               SUDO() { sudo "$@"; }
             else
               SUDO() { echo "$PW" | sudo -S "$@"; }
             fi
-            echo "🔐 SSH 인증 방식: ${SSH_AUTH_METHOD}"
+            m "${{ env.PAW_M_cicd_ssh_auth }}" method="${SSH_AUTH_METHOD}"
 
             BRANCH=${{ github.ref_name }}
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
 
-            # 브랜치별 포트 및 컨테이너명 설정
+            # Per-branch port and container name
             PORT=3000
             CONTAINER_NAME="${PROJECT_NAME}-nextjs"
 
             if [ "$BRANCH" == "{{MAIN_BRANCH}}" ]; then
               PORT=${{ secrets.PROJECT_DEPLOY_PORT || '3000' }}
               CONTAINER_NAME="${PROJECT_NAME}-nextjs-deploy"
-              echo "🚀 배포 환경으로 배포합니다 (브랜치: $BRANCH)"
+              m "${{ env.PAW_M_cicd_deploy_start }}" branch="$BRANCH"
             else
-              echo "⚠️ 지원하지 않는 브랜치입니다: $BRANCH"
+              m "${{ env.PAW_M_cicd_branch_unsupported }}" branch="$BRANCH"
               exit 1
             fi
 
-            echo "📋 배포 설정 정보:"
-            echo "  - 브랜치: $BRANCH"
-            echo "  - 프로젝트: $PROJECT_NAME"
-            echo "  - 컨테이너 이름: $CONTAINER_NAME"
-            echo "  - 포트: $PORT"
-            echo "  - Docker 이미지: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}"
+            m "${{ env.PAW_M_cicd_config_title }}"
+            m "${{ env.PAW_M_cicd_config_branch }}" branch="$BRANCH"
+            m "${{ env.PAW_M_cicd_config_project }}" project="$PROJECT_NAME"
+            m "${{ env.PAW_M_cicd_config_container }}" container="$CONTAINER_NAME"
+            m "${{ env.PAW_M_cicd_config_port }}" port="$PORT"
+            m "${{ env.PAW_M_cicd_config_image }}" image="${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}"
 
-            # Docker 이미지 풀 (Pull)
-            echo "⬇️ Docker 이미지 풀..."
+            # Pull the Docker image
+            m "${{ env.PAW_M_cicd_pull_image_short }}"
             SUDO docker pull ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
 
-            # 기존 컨테이너 정리
-            echo "🧹 컨테이너 $CONTAINER_NAME 존재 여부 확인 중..."
+            # Clean up the existing container
+            m "${{ env.PAW_M_cicd_container_check }}" container="$CONTAINER_NAME"
 
             if SUDO docker ps -a --format '{{.Names}}' | grep -Eq "^${CONTAINER_NAME}\$"; then
-              echo "⚠️ 컨테이너 $CONTAINER_NAME 이(가) 존재합니다. 중지 및 삭제 중..."
+              m "${{ env.PAW_M_cicd_container_exists }}" container="$CONTAINER_NAME"
               SUDO docker rm -f $CONTAINER_NAME
-              echo "✅ 컨테이너 $CONTAINER_NAME 이(가) 삭제되었습니다."
+              m "${{ env.PAW_M_cicd_container_removed }}" container="$CONTAINER_NAME"
             else
-              echo "ℹ️ 존재하는 컨테이너 $CONTAINER_NAME 이(가) 없습니다."
+              m "${{ env.PAW_M_cicd_container_none }}" container="$CONTAINER_NAME"
             fi
 
-            # 새 컨테이너 실행
-            echo "🚀 새로운 컨테이너 $CONTAINER_NAME 실행 중..."
+            # Start the new container
+            m "${{ env.PAW_M_cicd_container_run }}" container="$CONTAINER_NAME"
 
-            # Next.js는 SSR을 위해 Node.js 서버가 필요합니다
-            # standalone 모드 사용 시 node server.js로 실행
+            # Next.js needs a Node.js server for SSR
+            # With standalone mode, run it with node server.js
             SUDO docker run -d \
               -p ${PORT}:3000 \
               --name $CONTAINER_NAME \
@@ -260,19 +280,19 @@ jobs:
               --restart unless-stopped \
               ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
 
-            # 배포 완료 확인
-            echo "✅ 배포가 성공적으로 완료되었습니다!"
+            # Confirm the deployment
+            m "${{ env.PAW_M_cicd_deploy_done }}"
             echo ""
-            echo "📋 배포 결과 요약:"
-            echo "  🎯 프로젝트: $PROJECT_NAME"
-            echo "  🌿 브랜치: $BRANCH"
-            echo "  🐳 컨테이너: $CONTAINER_NAME"
-            echo "  🌐 포트: $PORT"
-            echo "  ⏰ 배포 시간: $(date '+%Y-%m-%d %H:%M:%S')"
+            m "${{ env.PAW_M_cicd_summary_title }}"
+            m "${{ env.PAW_M_cicd_summary_project }}" project="$PROJECT_NAME"
+            m "${{ env.PAW_M_cicd_summary_branch }}" branch="$BRANCH"
+            m "${{ env.PAW_M_cicd_summary_container }}" container="$CONTAINER_NAME"
+            m "${{ env.PAW_M_cicd_summary_port }}" port="$PORT"
+            m "${{ env.PAW_M_cicd_summary_time }}" time="$(date '+%Y-%m-%d %H:%M:%S')"
             echo ""
-            echo "🔗 접속 URL: http://${{ secrets.SERVER_HOST }}:${PORT}"
+            m "${{ env.PAW_M_cicd_summary_url }}" url="http://${{ secrets.SERVER_HOST }}:${PORT}"
 
-# Next.js Dockerfile 예시 (standalone 모드)
+# Next.js Dockerfile example (standalone mode)
 #
 # # Stage 1: Dependencies
 # FROM node:20-alpine AS deps
@@ -304,7 +324,7 @@ jobs:
 # ENV PORT 3000
 # CMD ["node", "server.js"]
 #
-# next.config.js에 standalone 설정 추가:
+# Add the standalone setting to next.config.js:
 # module.exports = {
 #   output: 'standalone',
 # }