project-auto-wizard 0.1.5

package/payload/workflows/flutter/PROJECT-FLUTTER-SUH-LAB-APP-BUILD-TRIGGER.yaml

@@ -0,0 +1,500 @@
+# ===================================================================
+# Flutter 테스트 앱 빌드 트리거 워크플로우 (SUH-LAB)
+# ===================================================================
+#
+# 이 워크플로우는 PR 또는 이슈에 댓글로 빌드 명령어를 작성하면
+# Android와 iOS 테스트 앱 빌드를 자동으로 트리거합니다.
+#
+# 주요 특징:
+# - PR/이슈 댓글 감지: "@suh-lab app build / apk build / ios build" 키워드 감지 (어순 무관: build app 도 동작)
+# - repository_dispatch 이벤트로 빌드 워크플로우 트리거
+# - PR/이슈 번호 + 빌드 횟수로 고유한 빌드 번호 생성 (예: 38700, 38701...)
+# - 브랜치명에서 이슈 번호 자동 추출 (YYYYMMDD_#이슈번호_내용 형식)
+# - 테스트 버전은 version.yml에서 동적으로 읽어 사용 (빌드 번호로 운영/테스트 구분)
+#
+# 사용 방법:
+# - PR에 댓글 작성: "@suh-lab app build" (Android + iOS 모두 빌드)
+# - PR에 댓글 작성: "@suh-lab apk build" (Android만 빌드)
+# - PR에 댓글 작성: "@suh-lab ios build" (iOS만 빌드)
+# - 이슈에 댓글 작성: 위 명령어 동일 (Guide by SUH-LAB 댓글 필요)
+# - 어순은 무관: "build app" / "build apk" / "build ios"로 적어도 동일하게 동작
+# - 특정 브랜치 지정: "@suh-lab app build <브랜치명>" (명령어 뒤에 브랜치명을 적으면 해당 브랜치를 빌드)
+#   예: "@suh-lab apk build 20260609_#349_feature" → 해당 브랜치로 Android 빌드
+#   브랜치명을 생략하면 PR head 또는 이슈의 Guide by SUH-LAB 댓글 브랜치를 사용
+#
+# 트리거되는 워크플로우:
+# - PROJECT-FLUTTER-ANDROID-TEST-APK.yaml (event_type: build-android-app)
+# - PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT.yaml (event_type: build-ios-app)
+#
+# ===================================================================
+
+name: PROJECT-Flutter-SUH-LAB-App-Build-Trigger
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  contents: write
+  pull-requests: write
+  issues: write
+
+jobs:
+  trigger-builds:
+    name: 빌드 워크플로우 트리거
+    # @suh-lab app build / @suh-lab apk build / @suh-lab ios build 키워드 감지 (어순 무관)
+    if: |
+      contains(github.event.comment.body, '@suh-lab') &&
+      (
+        (contains(github.event.comment.body, 'build') && contains(github.event.comment.body, 'app')) ||
+        (contains(github.event.comment.body, 'apk') && contains(github.event.comment.body, 'build')) ||
+        (contains(github.event.comment.body, 'ios') && contains(github.event.comment.body, 'build'))
+      )
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 댓글에 👀 리액션 추가
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const commentId = context.payload.comment.id;
+
+            await github.rest.reactions.createForIssueComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: commentId,
+              content: 'eyes'
+            });
+
+            console.log('👀 댓글에 확인 리액션 추가 완료');
+
+      - name: 빌드 타입 판별
+        id: build_type
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            // 키워드 판별은 소문자로(대소문자 무관 인식), 브랜치명 캡처는 원본 본문에서(대소문자 보존)
+            const comment = context.payload.comment.body.toLowerCase();
+            const rawComment = context.payload.comment.body;
+
+            let buildAndroid = false;
+            let buildIos = false;
+            let buildType = '';
+            let customBranch = '';
+            let m;
+
+            // 명령어 키워드 뒤의 같은 줄 토큰을 옵셔널 브랜치 인자로 캡처
+            // (줄바꿈 너머 단어가 브랜치로 오인되지 않도록 [^\S\r\n]+ 로 같은 줄 공백만 허용)
+            // 브랜치명은 rawComment에서 i 플래그로 다시 추출 → Feature/MyBranch 같은 대문자 브랜치 보존
+            //
+            // 어순은 양방향 지원: "{타입} build"(app/apk/ios build)와 "build {타입}"(build app 등) 모두 허용.
+            // apk가 app으로 오인되지 않도록 app 토큰은 \b 단어경계로 정확히 끊는다(apk·application 제외).
+            // apk/ios를 app보다 먼저 검사해, "apk build"가 app 분기로 새지 않게 한다.
+            if (comment.match(/@suh-lab[^\S\r\n]+apk[^\S\r\n]+build/) || comment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+apk/)) {
+              // @suh-lab apk build [브랜치] (또는 build apk) → Android만
+              buildAndroid = true;
+              buildType = 'apk';
+              m = rawComment.match(/@suh-lab[^\S\r\n]+apk[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
+                || rawComment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+apk(?:[^\S\r\n]+(\S+))?/i);
+              customBranch = (m && m[1]) || '';
+            } else if (comment.match(/@suh-lab[^\S\r\n]+ios[^\S\r\n]+build/) || comment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+ios/)) {
+              // @suh-lab ios build [브랜치] (또는 build ios) → iOS만
+              buildIos = true;
+              buildType = 'ios';
+              m = rawComment.match(/@suh-lab[^\S\r\n]+ios[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
+                || rawComment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+ios(?:[^\S\r\n]+(\S+))?/i);
+              customBranch = (m && m[1]) || '';
+            } else if (comment.match(/@suh-lab[^\S\r\n]+app\b[^\S\r\n]+build/) || comment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+app\b/)) {
+              // @suh-lab app build [브랜치] (또는 build app) → Android + iOS 모두
+              buildAndroid = true;
+              buildIos = true;
+              buildType = 'app';
+              m = rawComment.match(/@suh-lab[^\S\r\n]+app\b[^\S\r\n]+build(?:[^\S\r\n]+(\S+))?/i)
+                || rawComment.match(/@suh-lab[^\S\r\n]+build[^\S\r\n]+app\b(?:[^\S\r\n]+(\S+))?/i);
+              customBranch = (m && m[1]) || '';
+            }
+
+            core.setOutput('buildAndroid', buildAndroid.toString());
+            core.setOutput('buildIos', buildIos.toString());
+            core.setOutput('buildType', buildType);
+            core.setOutput('customBranch', customBranch);
+
+            console.log(`📱 빌드 타입: ${buildType} (Android=${buildAndroid}, iOS=${buildIos})`);
+            if (customBranch) {
+              console.log(`🌿 댓글에서 지정된 브랜치: ${customBranch}`);
+            }
+
+      - name: PR/이슈 정보 확인 및 추출
+        id: source_info
+        uses: actions/github-script@v7
+        env:
+          CUSTOM_BRANCH: ${{ steps.build_type.outputs.customBranch }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const customBranch = (process.env.CUSTOM_BRANCH || '').trim();
+            const issueNumber = context.payload.issue.number;
+            let sourceType = '';
+            let sourceNumber = '';
+            let branchName = '';
+            let headSha = '';
+            let relatedIssueNumber = '';
+
+            // 1. 먼저 PR인지 확인
+            try {
+              const pr = await github.rest.pulls.get({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                pull_number: issueNumber
+              });
+
+              sourceType = 'PR';
+              sourceNumber = pr.data.number.toString();
+              branchName = customBranch || pr.data.head.ref;
+              headSha = pr.data.head.sha;
+
+              if (customBranch) {
+                console.log(`🌿 댓글 지정 브랜치 우선 적용: ${customBranch} (PR head=${pr.data.head.ref})`);
+              }
+
+              console.log(`✅ PR 확인: #${sourceNumber}`);
+              console.log(`🌿 브랜치명: ${branchName}`);
+              console.log(`📝 커밋 해시: ${headSha}`);
+
+              // 브랜치명에서 이슈 번호 추출 (#280 형식)
+              const issueMatch = branchName.match(/#(\d+)/);
+              relatedIssueNumber = issueMatch ? issueMatch[1] : '';
+
+              if (relatedIssueNumber) {
+                console.log(`📌 추출된 이슈 번호: #${relatedIssueNumber}`);
+              }
+
+            } catch (error) {
+              console.log('ℹ️ PR이 아닙니다. 이슈에서 브랜치 정보를 찾습니다...');
+
+              // 2. PR이 아니면 이슈에서 "Guide by SUH-LAB" 댓글 찾기
+              sourceType = 'ISSUE';
+              sourceNumber = issueNumber.toString();
+              relatedIssueNumber = issueNumber.toString();
+
+              // 댓글에서 브랜치를 직접 지정한 경우 Guide 댓글 탐색을 건너뛴다
+              if (customBranch) {
+                branchName = customBranch;
+                console.log(`🌿 댓글 지정 브랜치 사용 (Guide 댓글 건너뜀): ${branchName}`);
+                console.log(`📌 관련 이슈 번호: #${relatedIssueNumber}`);
+
+                core.setOutput('found', 'true');
+                core.setOutput('sourceType', sourceType);
+                core.setOutput('sourceNumber', sourceNumber);
+                core.setOutput('branchName', branchName);
+                core.setOutput('headSha', headSha);
+                core.setOutput('relatedIssueNumber', relatedIssueNumber);
+                return;
+              }
+
+              try {
+                const comments = await github.rest.issues.listComments({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: issueNumber,
+                  per_page: 100
+                });
+
+                // "Guide by SUH-LAB" 댓글 찾기
+                const guideComment = comments.data.find(c =>
+                  c.body.includes('Guide by SUH-LAB')
+                );
+
+                if (!guideComment) {
+                  console.log('❌ "Guide by SUH-LAB" 댓글을 찾을 수 없습니다.');
+                  core.setOutput('found', 'false');
+                  core.setOutput('errorMessage', '이슈에서 "Guide by SUH-LAB" 댓글을 찾을 수 없습니다. 브랜치 정보가 포함된 댓글이 필요합니다.');
+                  return;
+                }
+
+                console.log('✅ "Guide by SUH-LAB" 댓글 발견');
+
+                // 브랜치명 추출 (### 브랜치 다음 ``` 블록 내용)
+                const branchMatch = guideComment.body.match(/### 브랜치\s*```\s*([\s\S]*?)\s*```/);
+
+                if (!branchMatch) {
+                  console.log('❌ 브랜치 정보를 파싱할 수 없습니다.');
+                  core.setOutput('found', 'false');
+                  core.setOutput('errorMessage', '"Guide by SUH-LAB" 댓글에서 브랜치 정보를 파싱할 수 없습니다. 댓글 형식을 확인해주세요.');
+                  return;
+                }
+
+                branchName = branchMatch[1].trim();
+                console.log(`🌿 추출된 브랜치명: ${branchName}`);
+                console.log(`✅ 이슈 #${sourceNumber}에서 빌드 정보 추출 완료`);
+
+              } catch (commentError) {
+                console.log('❌ 이슈 댓글 조회 중 오류 발생:', commentError.message);
+                core.setOutput('found', 'false');
+                core.setOutput('errorMessage', `이슈 댓글 조회 중 오류가 발생했습니다: ${commentError.message}`);
+                return;
+              }
+            }
+
+            // 결과 출력
+            core.setOutput('found', 'true');
+            core.setOutput('sourceType', sourceType);
+            core.setOutput('sourceNumber', sourceNumber);
+            core.setOutput('branchName', branchName);
+            core.setOutput('headSha', headSha);
+            core.setOutput('relatedIssueNumber', relatedIssueNumber);
+
+      - name: 브랜치 정보를 찾을 수 없는 경우 에러 댓글 작성
+        if: steps.source_info.outputs.found != 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issueNumber = context.payload.issue.number;
+            const errorMessage = '${{ steps.source_info.outputs.errorMessage }}';
+
+            const body = `❌ **앱 빌드 트리거 실패**
+
+            ${errorMessage}
+
+            **해결 방법:**
+            - PR에서 빌드하는 경우: PR 페이지에서 댓글을 작성해주세요.
+            - 이슈에서 빌드하는 경우: "Guide by SUH-LAB" 댓글이 있어야 합니다.
+              - 댓글에 \`### 브랜치\` 섹션과 브랜치명이 포함되어 있어야 합니다.
+            - 또는 댓글에 브랜치명을 직접 지정할 수 있습니다: \`@suh-lab app build <브랜치명>\``;
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              body: body
+            });
+
+            core.setFailed(errorMessage);
+
+      - name: 브랜치 존재 여부 확인
+        id: check_branch
+        if: steps.source_info.outputs.found == 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const branchName = '${{ steps.source_info.outputs.branchName }}';
+            const runId = '${{ github.run_id }}';
+            const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
+
+            console.log(`🔍 브랜치 존재 여부 확인: ${branchName}`);
+
+            try {
+              await github.rest.repos.getBranch({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                branch: branchName
+              });
+              console.log(`✅ 브랜치 존재 확인됨: ${branchName}`);
+              core.setOutput('exists', 'true');
+            } catch (error) {
+              if (error.status === 404) {
+                console.log(`❌ 브랜치를 찾을 수 없음: ${branchName}`);
+                core.setOutput('exists', 'false');
+                core.setOutput('errorMessage', `브랜치 \`${branchName}\`를 찾을 수 없습니다.`);
+              } else {
+                console.log(`❌ 브랜치 확인 중 오류: ${error.message}`);
+                core.setOutput('exists', 'false');
+                core.setOutput('errorMessage', `브랜치 확인 중 오류가 발생했습니다: ${error.message}`);
+              }
+            }
+
+      - name: 브랜치가 존재하지 않는 경우 에러 댓글 작성
+        if: steps.source_info.outputs.found == 'true' && steps.check_branch.outputs.exists == 'false'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const issueNumber = context.payload.issue.number;
+            const branchName = '${{ steps.source_info.outputs.branchName }}';
+            const runId = '${{ github.run_id }}';
+            const runUrl = `https://github.com/${context.repo.owner}/${context.repo.repo}/actions/runs/${runId}`;
+
+            const body = [
+              '❌ **앱 빌드 트리거 실패 - 브랜치를 찾을 수 없습니다**',
+              '',
+              '| 항목 | 값 |',
+              '|------|-----|',
+              `| **요청된 브랜치** | \`${branchName}\` |`,
+              `| **이슈/PR** | #${issueNumber} |`,
+              '',
+              '### 💡 확인 사항',
+              '1. 브랜치가 원격 저장소에 push되었는지 확인하세요',
+              '2. "Guide by SUH-LAB" 댓글의 브랜치명이 올바른지 확인하세요',
+              '3. 브랜치명에 오타가 없는지 확인하세요',
+              '',
+              `🔗 [워크플로우 로그](${runUrl})`
+            ].join('\n');
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              body: body
+            });
+
+            core.setFailed(`브랜치를 찾을 수 없습니다: ${branchName}`);
+
+      - name: 빌드 횟수 조회 및 빌드 번호 생성
+        id: build_number_calc
+        if: steps.source_info.outputs.found == 'true' && steps.check_branch.outputs.exists == 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const sourceNumber = parseInt('${{ steps.source_info.outputs.sourceNumber }}');
+            const sourceType = '${{ steps.source_info.outputs.sourceType }}';
+            const buildType = '${{ steps.build_type.outputs.buildType }}';
+
+            console.log(`📊 ${sourceType} #${sourceNumber}의 빌드 횟수 조회 중...`);
+            console.log(`📱 빌드 타입: ${buildType}`);
+
+            // PR/이슈의 모든 댓글 조회
+            const comments = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: sourceNumber,
+              per_page: 100
+            });
+
+            // 빌드 타입에 따라 해당 플랫폼의 빌드 횟수 카운트
+            // 어순 무관 카운트: includes('build') && includes('{타입}') 로 "ios build"·"build ios" 모두 잡는다.
+            // iOS:  ios 빌드 + app(공용) 빌드 통합 (App Store Connect는 앱 전체에서 빌드 번호 unique)
+            // Android: apk 빌드 + app(공용) 빌드 통합 (Play Store도 동일)
+            // App: 모든 빌드 명령어 통합 카운트
+            let buildCount = 0;
+
+            if (buildType === 'ios') {
+              // iOS 빌드: ios 빌드 + app 공용 빌드 둘 다 카운트 (어순 무관)
+              buildCount = comments.data.filter(c => {
+                const body = c.body.toLowerCase();
+                return body.includes('@suh-lab') && body.includes('build') && (
+                  body.includes('ios') || body.includes('app')
+                );
+              }).length;
+              console.log(`📊 iOS 빌드 카운트: ios + app(공용) 통합`);
+
+            } else if (buildType === 'apk') {
+              // Android 빌드: apk 빌드 + app 공용 빌드 둘 다 카운트 (어순 무관)
+              buildCount = comments.data.filter(c => {
+                const body = c.body.toLowerCase();
+                return body.includes('@suh-lab') && body.includes('build') && (
+                  body.includes('apk') || body.includes('app')
+                );
+              }).length;
+              console.log(`📊 Android 빌드 카운트: apk + app(공용) 통합`);
+
+            } else if (buildType === 'app') {
+              // 전체 앱 빌드: 모든 빌드 명령어 카운트 (어순 무관)
+              buildCount = comments.data.filter(c => {
+                const body = c.body.toLowerCase();
+                return body.includes('@suh-lab') && body.includes('build') && (
+                  body.includes('ios') ||
+                  body.includes('apk') ||
+                  body.includes('app')
+                );
+              }).length;
+              console.log(`📊 전체 앱 빌드 카운트: 모든 빌드 명령어 통합`);
+            }
+
+            // 빌드 번호: 소스번호 + 2자리 카운트 (38800, 38801, 38802...)
+            const buildNumber = `${sourceNumber}${String(buildCount).padStart(2, '0')}`;
+
+            console.log(`📊 ${sourceType} #${sourceNumber}: ${buildType} ${buildCount}번째 빌드`);
+            console.log(`📦 생성된 빌드 번호: ${buildNumber}`);
+
+            core.setOutput('buildCount', buildCount.toString());
+            core.setOutput('buildNumber', buildNumber);
+
+      - name: Android 빌드 워크플로우 트리거
+        if: |
+          steps.source_info.outputs.found == 'true' &&
+          steps.check_branch.outputs.exists == 'true' &&
+          steps.build_type.outputs.buildAndroid == 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const sourceType = '${{ steps.source_info.outputs.sourceType }}';
+            const sourceNumber = '${{ steps.source_info.outputs.sourceNumber }}';
+            const branchName = '${{ steps.source_info.outputs.branchName }}';
+            const relatedIssueNumber = '${{ steps.source_info.outputs.relatedIssueNumber }}';
+            const buildNumber = '${{ steps.build_number_calc.outputs.buildNumber }}';
+
+            console.log(`🚀 Android 빌드 워크플로우 트리거 시작...`);
+            console.log(`   ${sourceType} 번호: #${sourceNumber}`);
+            console.log(`   빌드 번호: ${buildNumber}`);
+            console.log(`   브랜치: ${branchName}`);
+            console.log(`   관련 이슈 번호: ${relatedIssueNumber || '없음'}`);
+
+            await github.rest.repos.createDispatchEvent({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              event_type: 'build-android-app',
+              client_payload: {
+                pr_number: sourceNumber,
+                build_number: buildNumber,
+                branch_name: branchName,
+                issue_number: relatedIssueNumber || '',
+                triggered_by: `${sourceType.toLowerCase()}-comment`,
+                comment_id: context.payload.comment.id.toString(),
+                source_type: sourceType
+              }
+            });
+
+            console.log('✅ Android 빌드 워크플로우 트리거 완료');
+
+      - name: iOS 빌드 워크플로우 트리거
+        if: |
+          steps.source_info.outputs.found == 'true' &&
+          steps.check_branch.outputs.exists == 'true' &&
+          steps.build_type.outputs.buildIos == 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const sourceType = '${{ steps.source_info.outputs.sourceType }}';
+            const sourceNumber = '${{ steps.source_info.outputs.sourceNumber }}';
+            const branchName = '${{ steps.source_info.outputs.branchName }}';
+            const relatedIssueNumber = '${{ steps.source_info.outputs.relatedIssueNumber }}';
+            const buildNumber = '${{ steps.build_number_calc.outputs.buildNumber }}';
+
+            console.log(`🚀 iOS 빌드 워크플로우 트리거 시작...`);
+            console.log(`   ${sourceType} 번호: #${sourceNumber}`);
+            console.log(`   빌드 번호: ${buildNumber}`);
+            console.log(`   브랜치: ${branchName}`);
+            console.log(`   관련 이슈 번호: ${relatedIssueNumber || '없음'}`);
+
+            await github.rest.repos.createDispatchEvent({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              event_type: 'build-ios-app',
+              client_payload: {
+                pr_number: sourceNumber,
+                build_number: buildNumber,
+                branch_name: branchName,
+                issue_number: relatedIssueNumber || '',
+                triggered_by: `${sourceType.toLowerCase()}-comment`,
+                comment_id: context.payload.comment.id.toString(),
+                source_type: sourceType
+              }
+            });
+
+            console.log('✅ iOS 빌드 워크플로우 트리거 완료');
+
+      # 트리거 완료 댓글은 제거됨 - Android/iOS 각각의 진행상황 댓글이 이 역할을 대체
+      - name: 트리거 완료 로그
+        if: steps.source_info.outputs.found == 'true' && steps.check_branch.outputs.exists == 'true'
+        run: |
+          echo "✅ Android 및 iOS 빌드 워크플로우 트리거 완료"
+          echo "📦 빌드 번호: ${{ steps.build_number_calc.outputs.buildNumber }}"
+          echo "🌿 브랜치: ${{ steps.source_info.outputs.branchName }}"
+          echo "📋 각 플랫폼별 진행상황 댓글이 자동으로 생성됩니다."

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

@@ -0,0 +1,185 @@
+# ===================================================================
+# Next.js CI (코드 분석 및 빌드 검증)
+# ===================================================================
+#
+# {{MAIN_BRANCH}} 브랜치 푸시 시 Next.js 애플리케이션의 빌드를 검증합니다.
+#
+# 주요 특징:
+# - npm ci로 의존성 설치
+# - npm run build로 빌드 검증
+# - Next.js 증분 빌드 캐싱 (.next/cache)
+# - node_modules 캐싱 지원
+#
+# ===================================================================
+# 🔑 필수 GitHub Secrets
+# ===================================================================
+# ENV_FILE (선택): .env 파일 내용
+#
+# ※ CI는 빌드 검증 목적이므로 배포 관련 Secrets 불필요
+# ===================================================================
+#
+# 🔧 프로젝트별 설정 (env 섹션)
+# ===================================================================
+# PROJECT_NAME : 프로젝트 이름
+# NODE_VERSION : Node.js 버전 (기본: 20.15.0)
+# ENV_FILE     : 환경변수 파일명 (기본: .env)
+# ===================================================================
+
+name: PROJECT-NEXT-CI
+
+on:
+  push:
+    branches: ["{{DEVELOP_BRANCH}}"]
+  workflow_dispatch:
+
+env:
+  PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
+  NODE_VERSION: "20.15.0"
+  ENV_FILE: ".env"
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
+jobs:
+  build:
+    name: Next.js 애플리케이션 빌드
+    runs-on: ubuntu-latest
+
+    steps:
+      # 1. 소스코드 체크아웃
+      - name: 코드 체크아웃
+        uses: actions/checkout@v5
+
+      # 2. 환경변수 파일 생성
+      - name: 환경변수 파일 생성 (${{ env.ENV_FILE }})
+        run: |
+          echo -e "${{ secrets.ENV_FILE || secrets.ENV }}" > ${{ env.ENV_FILE }}
+          echo "✅ ${{ env.ENV_FILE }} 파일 생성 완료"
+
+      # 3. Node.js 설정
+      - name: Node.js 설정
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: "npm"
+
+      # 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: |
+          echo "📦 의존성 설치 중..."
+          npm ci
+          echo "✅ 의존성 설치 완료"
+
+      # 7. Next.js 빌드 캐싱 (.next/cache)
+      # 증분 빌드를 위해 .next/cache 폴더를 캐싱합니다
+      - 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. 프로젝트 빌드 (SSR/SSG)
+      - name: 프로젝트 빌드
+        id: build
+        run: |
+          echo "🔨 Next.js 빌드 시작..."
+          echo "프로젝트: ${{ env.PROJECT_NAME }}"
+          echo "Node.js: ${{ env.NODE_VERSION }}"
+          echo ""
+
+          # 빌드 실행 및 로그 저장
+          npm run build > build_log.txt 2>&1 || {
+            echo "build_failed=true" >> $GITHUB_OUTPUT
+            echo "status=failed" >> $GITHUB_OUTPUT
+            echo ""
+            echo "❌ 빌드 실패"
+            exit 0
+          }
+
+          echo "build_failed=false" >> $GITHUB_OUTPUT
+          echo "status=success" >> $GITHUB_OUTPUT
+          echo "✅ 빌드 완료"
+
+          # 빌드 결과 확인
+          if [ -d ".next" ]; then
+            echo ""
+            echo "📁 빌드 결과물:"
+            echo "  - .next/ 폴더 생성됨"
+            du -sh .next/ || true
+          fi
+
+      # 9. 빌드 실패 시 에러 로그 출력
+      - name: 빌드 에러 로그 출력
+        if: steps.build.outputs.build_failed == 'true'
+        run: |
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "❌ 빌드 실패 - 에러 로그"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo ""
+
+          if [ -f "build_log.txt" ]; then
+            tail -n 50 build_log.txt
+          else
+            echo "에러 로그 파일을 찾을 수 없습니다."
+          fi
+
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          exit 1
+
+      # 10. 빌드 로그 아티팩트 업로드
+      - name: 빌드 로그 업로드
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-log
+          path: build_log.txt
+          retention-days: 7
+
+      # 11. 빌드 결과 요약
+      - name: 빌드 결과 요약
+        if: always()
+        run: |
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          if [ "${{ steps.build.outputs.status }}" = "success" ]; then
+            echo "🎉 Next.js 빌드 완료!"
+          else
+            echo "❌ Next.js 빌드 실패"
+          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')"
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"