project-auto-wizard 0.1.5

package/payload/workflows/react/PROJECT-REACT-CICD.yaml

@@ -0,0 +1,255 @@
+# ===================================================================
+# React CI/CD 배포
+# ===================================================================
+#
+# {{MAIN_BRANCH}} 브랜치 푸시 시 Docker 이미지를 빌드하고 배포합니다.
+#
+# ===================================================================
+# 🔑 필수 GitHub Secrets
+# ===================================================================
+# ENV_FILE: .env 파일 내용
+# DOCKERHUB_USERNAME: DockerHub 사용자명
+# DOCKERHUB_TOKEN: DockerHub 액세스 토큰
+# SERVER_HOST: 배포 서버 주소
+# SERVER_USER: SSH 사용자명
+# SERVER_PASSWORD: SSH 비밀번호
+# PROJECT_DEPLOY_PORT (선택): 배포 포트 (기본: 3000)
+# ===================================================================
+
+name: PROJECT-REACT-CICD
+
+on:
+  push:
+    branches:
+      - "{{MAIN_BRANCH}}"
+    # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
+  workflow_dispatch:
+
+env:
+  PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
+  DOCKER_IMAGE_PREFIX: "front-container"
+  NODE_VERSION: "20.15.0"
+  ENV_FILE_NAME: ".env"
+
+jobs:
+  build:
+    name: React/Next.js 애플리케이션 빌드
+    runs-on: ubuntu-latest
+
+    steps:
+      # 1. 소스코드 체크아웃
+      - name: 코드 체크아웃
+        uses: actions/checkout@v5
+
+      # 2. Node.js 개발 환경 설정
+      - name: Node.js 설정
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # 3. 환경변수 파일 생성
+      - name: 환경변수 파일 생성 (${{ env.ENV_FILE_NAME }})
+        run: |
+          cat << 'EOF' > ./${{ env.ENV_FILE_NAME }}
+          ${{ secrets.ENV_FILE || secrets.ENV }}
+          EOF
+          echo "✅ ${{ env.ENV_FILE_NAME }} 파일 생성 완료"
+
+      # 4. npm 의존성 캐싱
+      - name: npm 의존성 캐싱
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-
+
+      # 5. node_modules 캐싱
+      - name: node_modules 캐싱
+        id: node-modules-cache
+        uses: actions/cache@v4
+        with:
+          path: "**/node_modules"
+          key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-modules-
+
+      # 6. 의존성 설치
+      - name: 의존성 설치
+        if: steps.node-modules-cache.outputs.cache-hit != 'true'
+        run: npm ci
+
+      # 7. Next.js 빌드 캐싱
+      - name: Next.js 빌드 캐싱
+        uses: actions/cache@v4
+        with:
+          path: .next/cache
+          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**.[jt]s', '**.[jt]sx') }}
+          restore-keys: |
+            ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-
+            ${{ runner.os }}-nextjs-
+
+      # 8. 프로젝트 빌드
+      - name: Build with npm
+        run: npm run build
+
+      # 9. Docker 빌드 환경 설정
+      - name: Docker 빌드환경 설정
+        uses: docker/setup-buildx-action@v3
+
+      # 10. DockerHub 로그인
+      - name: DockerHub 로그인
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      # 11. Docker 레이어 캐싱
+      - name: Cache Docker layers
+        uses: actions/cache@v4
+        with:
+          path: /tmp/.buildx-cache
+          key: ${{ runner.os }}-buildx-${{ hashFiles('Dockerfile') }}-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-buildx-
+
+      # 12. Docker 이미지 빌드 및 푸시
+      - name: Docker 이미지 빌드 및 푸시
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          tags: ${{ secrets.DOCKERHUB_USERNAME }}/${{ env.PROJECT_NAME }}-${{ env.DOCKER_IMAGE_PREFIX }}:${{ github.ref_name }}
+          cache-from: type=local,src=/tmp/.buildx-cache
+          cache-to: type=local,dest=/tmp/.buildx-cache-new,mode=max
+
+      # 13. Docker 캐시 정리
+      - name: Move Docker cache
+        run: |
+          rm -rf /tmp/.buildx-cache
+          mv /tmp/.buildx-cache-new /tmp/.buildx-cache
+
+  deploy:
+    name: 원격 서버 배포
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Deploy
+        uses: appleboy/ssh-action@v1.0.3
+        with:
+          host: ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USER }}
+          password: ${{ secrets.SERVER_PASSWORD }}
+          port: 2022
+          script: |
+            set -e
+
+            # ============================================================
+            # 배포 환경 변수 설정
+            # ============================================================
+            echo "🔧 환경변수 설정.."
+            export PATH=$PATH:/usr/local/bin
+            export PW=${{ secrets.SERVER_PASSWORD }}
+
+            # GitHub에서 전달받은 브랜치명
+            BRANCH=${{ github.ref_name }}
+
+            # 프로젝트 설정
+            PROJECT_NAME="${{ env.PROJECT_NAME }}"
+
+            # ============================================================
+            # 브랜치별 포트 및 컨테이너명 설정
+            # ============================================================
+            # 기본값 설정
+            PORT=3000
+            CONTAINER_NAME="${PROJECT_NAME}-front"
+
+            # 브랜치에 따른 환경별 설정
+            if [ "$BRANCH" == "{{MAIN_BRANCH}}" ]; then
+              # 🚀 배포 환경 ({{MAIN_BRANCH}} 브랜치)
+              # GitHub Secrets의 PROJECT_DEPLOY_PORT 환경변수 사용
+              # 설정되어 있지 않으면 기본값 3000 사용
+              PORT=${{ secrets.PROJECT_DEPLOY_PORT || '3000' }}
+              CONTAINER_NAME="${PROJECT_NAME}-front-deploy"
+              echo "🚀 배포 환경으로 배포합니다 (브랜치: $BRANCH)"
+
+            else
+              # ⚠️ 기타 브랜치 (예상치 못한 브랜치)
+              echo "⚠️ 지원하지 않는 브랜치입니다: $BRANCH"
+              echo "이 워크플로우는 {{MAIN_BRANCH}} 브랜치만 지원합니다."
+              echo "on.push.branches에서 지원할 브랜치를 설정하세요."
+              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}"
+
+            # ============================================================
+            # Docker 이미지 풀 (Pull)
+            # ============================================================
+            echo "⬇️ Docker 이미지 풀: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}"
+            echo $PW | sudo -S docker pull ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
+
+            # ============================================================
+            # 기존 컨테이너 정리
+            # ============================================================
+            echo "🧹 컨테이너 $CONTAINER_NAME 존재 여부 확인 중..."
+
+            # 동일한 이름의 컨테이너가 존재하는지 확인
+            if sudo docker ps -a --format '{{.Names}}' | grep -Eq "^${CONTAINER_NAME}\$"; then
+              echo "⚠️ 컨테이너 $CONTAINER_NAME 이(가) 존재합니다. 중지 및 삭제 중..."
+              echo $PW | sudo -S docker rm -f $CONTAINER_NAME
+              echo "✅ 컨테이너 $CONTAINER_NAME 이(가) 삭제되었습니다."
+            else
+              echo "ℹ️ 존재하는 컨테이너 $CONTAINER_NAME 이(가) 없습니다."
+            fi
+
+            # ============================================================
+            # 새 컨테이너 실행
+            # ============================================================
+            echo "🚀 새로운 컨테이너 $CONTAINER_NAME 실행 중..."
+
+            echo $PW | sudo -S docker run -d \
+              -p ${PORT}:3000 \
+              --name $CONTAINER_NAME \
+              -e TZ=Asia/Seoul \
+              -v /etc/localtime:/etc/localtime:ro \
+              ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}-${{ env.DOCKER_IMAGE_PREFIX }}:${BRANCH}
+
+            # ============================================================
+            # 배포 완료 확인
+            # ============================================================
+            echo "✅ 배포가 성공적으로 완료되었습니다!"
+            echo ""
+            echo "📋 배포 결과 요약:"
+            echo "  🎯 프로젝트: $PROJECT_NAME"
+            echo "  🌿 브랜치: $BRANCH"
+            echo "  🐳 컨테이너: $CONTAINER_NAME"
+            echo "  🌐 포트: $PORT"
+            echo "  ⏰ 배포 시간: $(date '+%Y-%m-%d %H:%M:%S')"
+            echo ""
+            echo "🔗 접속 URL: http://${{ secrets.SERVER_HOST }}:${PORT}"
+
+# ===================================================================
+# 사용 예시 - {{MAIN_BRANCH}} 브랜치 사용
+# ===================================================================
+#
+# 현재 설정: {{MAIN_BRANCH}} 브랜치에 push할 때 자동 배포
+#
+# 브랜치별 포트:
+# - main: 3000 (PROJECT_DEPLOY_PORT secret으로 변경 가능)
+#
+# 필요한 Secrets:
+# - REACT_ENV_FILE, DOCKERHUB_*, SERVER_* (필수)
+# - PROJECT_DEPLOY_PORT (선택, 기본값: 3000)
+#
+# ===================================================================
+

package/payload/workflows/spring/PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH.yml

@@ -0,0 +1,84 @@
+# ===================================================================
+# Spring GitHub Packages 라이브러리 배포 워크플로우
+# ===================================================================
+#
+# Java 라이브러리 모듈을 GitHub Packages(Maven repo)에 자동 배포합니다.
+# Nexus 없이 GitHub만으로 의존성 호스팅이 가능합니다.
+#
+# ⚠️ Java 라이브러리 모듈 배포 전용 CICD입니다.
+#    Spring Boot 애플리케이션 배포가 아닙니다.
+#
+# ===================================================================
+# 🛠️ build.gradle 요구사항
+# ===================================================================
+# publishing.repositories.maven 블록에 GitHub Packages 항목 추가:
+#
+#   maven {
+#     name = "GitHubPackages"
+#     url = uri("https://maven.pkg.github.com/${System.getenv('GITHUB_REPOSITORY')}")
+#     credentials {
+#       username = System.getenv("GITHUB_ACTOR")
+#       password = System.getenv("GITHUB_TOKEN")
+#     }
+#   }
+#
+# 💡 Free 계정 제한 (Private repo 기준):
+#   - 월 500MB 저장 + 1GB 전송 무료
+#   - Public repo는 무제한 무료
+# ===================================================================
+
+name: PROJECT-SPRING-GITHUB-PACKAGES-PUBLISH
+
+on:
+  push:
+    branches: ["{{MAIN_BRANCH}}"]
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+concurrency:
+  group: github-packages-publish-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Get version
+        id: get_version
+        run: |
+          if [[ "${{ github.ref }}" == refs/tags/* ]]; then
+            TAG_NAME=${GITHUB_REF#refs/tags/}
+            VERSION=${TAG_NAME#v}
+            echo "🏷️ 태그에서 버전 추출: $VERSION"
+          else
+            VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
+            echo "📄 version.yml에서 버전 추출: $VERSION"
+          fi
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Publishing version $VERSION"
+
+      - name: Publish to GitHub Packages
+        env:
+          GITHUB_ACTOR: ${{ github.actor }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+        run: |
+          VERSION="${{ steps.get_version.outputs.version }}"
+          echo "🚀 Publishing version $VERSION to GitHub Packages"
+          ./gradlew publishMavenPublicationToGitHubPackagesRepository -Pversion=$VERSION

package/payload/workflows/spring/nexus/PROJECT-SPRING-NEXUS-CI.yml

@@ -0,0 +1,316 @@
+# ===================================================================
+# Spring Nexus CI 워크플로우
+# ===================================================================
+#
+# 🔑 필수 GitHub Secrets
+# ===================================================================
+# GRADLE_PROPERTIES: gradle.properties 파일 내용 (Nexus 인증 정보 포함)
+# ===================================================================
+
+name: PROJECT-SPRING-NEXUS-CI
+
+on:
+  pull_request:
+    branches: ["{{DEVELOP_BRANCH}}"]
+    types: [opened, synchronize, reopened]
+  push:
+    branches: ["{{DEVELOP_BRANCH}}"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+  checks: write
+
+jobs:
+  build-check:
+    name: Build Verification
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout Repository
+      uses: actions/checkout@v5
+      with:
+        fetch-depth: 0
+
+    - name: Setup JDK 17
+      uses: actions/setup-java@v4
+      with:
+        java-version: '17'
+        distribution: 'temurin'
+
+    - name: Validate Gradle Wrapper
+      uses: gradle/wrapper-validation-action@v2
+      continue-on-error: true
+
+    - name: Create gradle.properties from secret
+      run: |
+        echo -e "${{ secrets.GRADLE_PROPERTIES }}" > gradle.properties
+
+    - name: Setup Gradle
+      uses: gradle/actions/setup-gradle@v4
+      with:
+        gradle-version: wrapper
+
+    - name: Clean Build Directory
+      run: ./gradlew clean
+
+    - name: Compile Sources
+      id: compile
+      run: |
+        set +e
+        ./gradlew compileJava compileTestJava 2>&1 | tee compile_output.txt
+        echo "compile_exit_code=$?" >> $GITHUB_OUTPUT
+        set -e
+      continue-on-error: true
+
+    - name: Run Tests
+      id: test
+      run: |
+        set +e
+        ./gradlew test 2>&1 | tee test_output.txt
+        echo "test_exit_code=$?" >> $GITHUB_OUTPUT
+        set -e
+      continue-on-error: true
+
+    - name: Build JAR
+      id: build
+      run: |
+        set +e
+        ./gradlew build -x test 2>&1 | tee build_output.txt
+        echo "build_exit_code=$?" >> $GITHUB_OUTPUT
+        set -e
+      continue-on-error: true
+
+    - name: Generate Build Report
+      id: report
+      if: always()
+      run: |
+        # 빌드 상태 확인 (exit code 기반)
+        COMPILE_STATUS="✅ 성공"
+        TEST_STATUS="✅ 성공"
+        BUILD_STATUS="✅ 성공"
+        
+        # 컴파일 상태 확인
+        COMPILE_EXIT_CODE="${{ steps.compile.outputs.compile_exit_code }}"
+        if [ "$COMPILE_EXIT_CODE" != "0" ] && [ "$COMPILE_EXIT_CODE" != "" ]; then
+          COMPILE_STATUS="❌ 실패"
+        fi
+        
+        # 테스트 상태 확인  
+        TEST_EXIT_CODE="${{ steps.test.outputs.test_exit_code }}"
+        if [ "$TEST_EXIT_CODE" != "0" ] && [ "$TEST_EXIT_CODE" != "" ]; then
+          TEST_STATUS="❌ 실패"
+        fi
+        
+        # 빌드 상태 확인
+        BUILD_EXIT_CODE="${{ steps.build.outputs.build_exit_code }}"
+        if [ "$BUILD_EXIT_CODE" != "0" ] && [ "$BUILD_EXIT_CODE" != "" ]; then
+          BUILD_STATUS="❌ 실패"
+        fi
+        
+        # 전체 빌드 상태
+        OVERALL_STATUS="✅ 성공"
+        if [ "$COMPILE_EXIT_CODE" != "0" ] || [ "$TEST_EXIT_CODE" != "0" ] || [ "$BUILD_EXIT_CODE" != "0" ]; then
+          OVERALL_STATUS="❌ 실패"
+        fi
+        
+        echo "compile_status=$COMPILE_STATUS" >> $GITHUB_OUTPUT
+        echo "test_status=$TEST_STATUS" >> $GITHUB_OUTPUT
+        echo "build_status=$BUILD_STATUS" >> $GITHUB_OUTPUT
+        echo "overall_status=$OVERALL_STATUS" >> $GITHUB_OUTPUT
+
+    - name: Extract Error Details
+      id: errors
+      if: always()
+      run: |
+        # 컴파일 에러 추출
+        if [ -f compile_output.txt ] && [ "${{ steps.compile.outputs.compile_exit_code }}" != "0" ]; then
+          echo "compile_errors<<EOF" >> $GITHUB_OUTPUT
+          echo "## 🚨 컴파일 에러" >> $GITHUB_OUTPUT
+          echo "" >> $GITHUB_OUTPUT
+          echo '```' >> $GITHUB_OUTPUT
+          grep -A 15 -B 15 "error\|Error\|ERROR\|FAILED\|Failed\|failed" compile_output.txt | head -60 >> $GITHUB_OUTPUT || echo "에러 로그를 찾을 수 없습니다." >> $GITHUB_OUTPUT
+          echo '```' >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+        fi
+        
+        # 테스트 에러 추출
+        if [ -f test_output.txt ] && [ "${{ steps.test.outputs.test_exit_code }}" != "0" ]; then
+          echo "test_errors<<EOF" >> $GITHUB_OUTPUT
+          echo "## 🧪 테스트 실패" >> $GITHUB_OUTPUT
+          echo "" >> $GITHUB_OUTPUT
+          echo '```' >> $GITHUB_OUTPUT
+          grep -A 15 -B 15 "FAILED\|Failed\|failed\|error\|Error\|ERROR" test_output.txt | head -60 >> $GITHUB_OUTPUT || echo "테스트 에러 로그를 찾을 수 없습니다." >> $GITHUB_OUTPUT
+          echo '```' >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+        fi
+        
+        # 빌드 에러 추출
+        if [ -f build_output.txt ] && [ "${{ steps.build.outputs.build_exit_code }}" != "0" ]; then
+          echo "build_errors<<EOF" >> $GITHUB_OUTPUT
+          echo "## 📦 빌드 에러" >> $GITHUB_OUTPUT
+          echo "" >> $GITHUB_OUTPUT
+          echo '```' >> $GITHUB_OUTPUT
+          grep -A 15 -B 15 "FAILED\|Failed\|failed\|error\|Error\|ERROR" build_output.txt | head -60 >> $GITHUB_OUTPUT || echo "빌드 에러 로그를 찾을 수 없습니다." >> $GITHUB_OUTPUT
+          echo '```' >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Comment on PR (Success)
+      if: github.event_name == 'pull_request' && steps.report.outputs.overall_status == '✅ 성공'
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ secrets.GITHUB_TOKEN }}
+        script: |
+          const { data: comments } = await github.rest.issues.listComments({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            issue_number: context.issue.number,
+          });
+          
+          // 기존 봇 댓글 찾기
+          const botComment = comments.find(comment => 
+            comment.user.type === 'Bot' && 
+            comment.body.includes('🔧 CI Build Check')
+          );
+          
+          const successMessage = `## 🔧 CI Build Check 결과
+          
+          ### ✅ 빌드 성공!
+          
+          | 단계 | 상태 |
+          |------|------|
+          | 컴파일 | ${{ steps.report.outputs.compile_status }} |
+          | 테스트 | ${{ steps.report.outputs.test_status }} |
+          | 빌드 | ${{ steps.report.outputs.build_status }} |
+          
+          **전체 상태**: ${{ steps.report.outputs.overall_status }}
+          
+          ---
+          *🤖 GitHub Actions에 의해 자동 생성됨 - ${new Date().toLocaleString('ko-KR', { timeZone: 'Asia/Seoul' })}*`;
+          
+          if (botComment) {
+            await github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: botComment.id,
+              body: successMessage
+            });
+          } else {
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: successMessage
+            });
+          }
+
+    - name: Comment on PR (Failure)
+      if: github.event_name == 'pull_request' && steps.report.outputs.overall_status == '❌ 실패'
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ secrets.GITHUB_TOKEN }}
+        script: |
+          const { data: comments } = await github.rest.issues.listComments({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            issue_number: context.issue.number,
+          });
+          
+          // 기존 봇 댓글 찾기
+          const botComment = comments.find(comment => 
+            comment.user.type === 'Bot' && 
+            comment.body.includes('🔧 CI Build Check')
+          );
+          
+          let errorDetails = '';
+          
+          // 컴파일 에러 추가
+          if ('${{ steps.errors.outputs.compile_errors }}') {
+            errorDetails += '${{ steps.errors.outputs.compile_errors }}\n\n';
+          }
+          
+          // 테스트 에러 추가  
+          if ('${{ steps.errors.outputs.test_errors }}') {
+            errorDetails += '${{ steps.errors.outputs.test_errors }}\n\n';
+          }
+          
+          // 빌드 에러 추가
+          if ('${{ steps.errors.outputs.build_errors }}') {
+            errorDetails += '${{ steps.errors.outputs.build_errors }}\n\n';
+          }
+          
+          const failureMessage = `## 🔧 CI Build Check 결과
+          
+          ### ❌ 빌드 실패!
+          
+          | 단계 | 상태 |
+          |------|------|
+          | 컴파일 | ${{ steps.report.outputs.compile_status }} |
+          | 테스트 | ${{ steps.report.outputs.test_status }} |
+          | 빌드 | ${{ steps.report.outputs.build_status }} |
+          
+          **전체 상태**: ${{ steps.report.outputs.overall_status }}
+          
+          ### 📋 에러 상세 정보
+          
+          ${errorDetails}
+          
+          ### 🔧 해결 방법
+          - 로컬에서 \`./gradlew clean build\` 명령어로 빌드를 확인해보세요
+          - 에러 메시지를 참고하여 코드를 수정해주세요
+          - 테스트가 실패한 경우 \`./gradlew test\` 명령어로 테스트를 실행해보세요
+          
+          ---
+          *🤖 GitHub Actions에 의해 자동 생성됨 - ${new Date().toLocaleString('ko-KR', { timeZone: 'Asia/Seoul' })}*`;
+          
+          if (botComment) {
+            await github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: botComment.id,
+              body: failureMessage
+            });
+          } else {
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: failureMessage
+            });
+          }
+
+    - name: Create Check Run
+      if: always()
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ secrets.GITHUB_TOKEN }}
+        script: |
+          const conclusion = '${{ steps.report.outputs.overall_status }}' === '✅ 성공' ? 'success' : 'failure';
+          const summary = `빌드 검증이 ${conclusion === 'success' ? '성공' : '실패'}했습니다.`;
+          
+          await github.rest.checks.create({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            name: 'Build Verification',
+            head_sha: context.sha,
+            status: 'completed',
+            conclusion: conclusion,
+            output: {
+              title: '🔧 CI Build Check',
+              summary: summary,
+              text: `
+              컴파일: ${{ steps.report.outputs.compile_status }}
+              테스트: ${{ steps.report.outputs.test_status }}  
+              빌드: ${{ steps.report.outputs.build_status }}
+              `
+            }
+          });
+
+    - name: Fail Job on Build Failure
+      if: steps.report.outputs.overall_status == '❌ 실패'
+      run: |
+        echo "❌ 빌드가 실패했습니다. 위의 에러 메시지를 확인해주세요."
+        exit 1