🚀 Deploy 20260406-v1.6.1

.github/workflows/PROJECT-COMMON-QA-ISSUE-CREATION-BOT.yaml

@@ -1,10 +1,12 @@
 # ===================================================================
+# PROJECT-COMMON-QA-ISSUE-CREATION-BOT.yaml
 # 자동 QA 이슈 생성 워크플로우
 # ===================================================================
 #
 # 이 워크플로우는 GitHub 이슈/PR 댓글에서 @suh-lab 멘션을 감지하여
 # QA(시험요청) 이슈를 자동으로 생성합니다.
 #
+# ===================================================================
 # 작동 방식:
 # 1. 이슈 또는 PR 댓글에서 "@suh-lab" + "create" + "qa" 감지 (순서 무관)
 # 2. 댓글에 👀 리액션 추가 (확인 표시)
@@ -31,7 +33,6 @@
 #
 # 트리거 방법:
 # 이슈/PR 댓글에 "@suh-lab create qa" 또는 "@suh-lab qa create" 입력
-#
 # ===================================================================
 
 name: PROJECT-CREATE-QA-ISSUE
@@ -47,7 +48,7 @@ env:
   # QA 이슈 기본 담당자 설정
   # - 'default': 댓글 작성자가 담당자로 지정됨
   # - GitHub ID (예: 'Cassiiopeia'): 해당 사용자가 담당자로 지정됨
-  DEFAULT_QA_ASSIGNEE: 'Cassiiopeia'
+  DEFAULT_QA_ASSIGNEE: 'Chuseok22'
 
 jobs:
   create-qa:
@@ -199,7 +200,7 @@ jobs:
                 repo: context.repo.repo,
                 title: qaTitle,
                 body: qaBody,
-                labels: ['작업 전'],
+                labels: ['작업전'],
                 assignees: [assignee]
               });
 
@@ -253,4 +254,4 @@ jobs:
                 issue_number: issueOrPrNumber,
                 body: `❌ QA 이슈 생성 중 오류가 발생했습니다.\n\n\`\`\`\n${error.message}\n\`\`\``
               });
-            }
+            }

.github/workflows/PROJECT-COMMON-SYNC-ISSUE-LABELS.yaml

@@ -28,7 +28,7 @@ jobs:
   label-sync:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Sync labels from config
         uses: crazy-max/ghaction-github-labeler@v5
         with:

.github/workflows/PROJECT-README-VERSION-UPDATE.yaml

@@ -1,10 +1,12 @@
 # ===================================================================
+# PROJECT-COMMON-README-VERSION-UPDATE.yaml
 # README 파일 버전 자동 업데이트 워크플로우
 # ===================================================================
 #
 # 이 워크플로우는 deploy 브랜치로 푸시가 발생할 때 README.md 파일의
 # 버전 정보를 version_manager.sh를 통해 가져와 자동으로 업데이트합니다.
 #
+# ===================================================================
 # 작동 방식:
 # 1. deploy 브랜치 푸시 시 트리거
 # 2. version_manager.sh를 통해 최신 버전 정보 추출
@@ -24,13 +26,17 @@
 # - 대소문자 구분 없음
 # - 콜론(:) 앞뒤 공백 자유롭게 허용
 # - "version", "버전", "최신", "current", "recent" 등의 키워드 포함 시 자동 인식
-# - 주석 <!-- 수정하지마세요 자동으로 동기화 됩니다 -->는 자동으로 추가됩니다.
+# - 주석 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->가 자동으로 추가됩니다.
+#
+# ❌ 지원되지 않는 형식 (에러 발생):
+# - ## 최신 버전: v1.0.0** (마크다운 볼드 문자 사용 금지)
+# - ## 최신 버전 v1.0.0 (콜론 누락)
+# - 정규표현식 특수문자(*, [, ], ^, $) 포함된 버전 표기
 #
 # 🔧 환경변수 설정:
 # - SHOW_DATE: 버전에 날짜 표시 여부 (true/false, 기본값: true)
 #   * true: v1.0.0 (2025-08-16) 형식
 #   * false: v1.0.0 형식
-#
 # ===================================================================
 
 name: README VERSION UPDATE
@@ -54,11 +60,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 저장소 체크아웃
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           fetch-depth: 0
-          ref: main
+          ref: ${{ github.event.repository.default_branch || 'main' }}
 
       - name: Git 설정
         run: |
@@ -86,7 +92,44 @@ jobs:
           LATEST_VERSION="${{ steps.version_info.outputs.latest_version }}"
           RELEASE_DATE="${{ steps.version_info.outputs.release_date }}"
           SHOW_DATE="${{ env.SHOW_DATE }}"
-
+
+          # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+          # 에러 메시지 출력 함수
+          # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+          print_error_message() {
+            local error_type="$1"
+            local version_line="$2"
+            local header_part="$3"
+            local version_text="$4"
+
+            echo ""
+            echo "❌ README.md 버전 업데이트 실패"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            echo ""
+            echo "🔍 에러 유형: $error_type"
+            echo ""
+            echo "📋 진단 정보:"
+            echo "   • 현재 버전 라인: $version_line"
+            echo "   • 추출된 헤더: $header_part"
+            echo "   • 새 버전 텍스트: $version_text"
+            echo ""
+            echo "💡 해결 방법:"
+            echo "   README.md의 버전 표기가 아래 형식 중 하나와 일치하는지 확인하세요:"
+            echo ""
+            echo "   ✅ 지원되는 형식 예시:"
+            echo "      • ## 최신 버전 : v1.0.0 (2025-08-15)"
+            echo "      • ## 최신버전 : v1.0.0"
+            echo "      • ## Version : v1.0.0"
+            echo "      • ## Current Version : v1.0.0 (2025-08-15)"
+            echo ""
+            echo "   ⚠️ 주의사항:"
+            echo "      • 마크다운 볼드(**) 문자 사용 금지"
+            echo "      • 정규표현식 특수문자(*, [, ], ^, $) 사용 금지"
+            echo "      • 콜론(:) 뒤에 버전 정보가 바로 와야 합니다"
+            echo ""
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          }
+
           # 날짜 표시 여부에 따라 버전 형식 결정
           if [ "$SHOW_DATE" = "true" ]; then
             VERSION_TEXT="v${LATEST_VERSION} (${RELEASE_DATE})"
@@ -95,7 +138,7 @@ jobs:
             VERSION_TEXT="v${LATEST_VERSION}"
             echo "📋 버전만 표시 형식: $VERSION_TEXT"
           fi
-          
+
           # 다양한 버전 표기 패턴을 찾기 위한 정규표현식
           # 대소문자 무시, 공백 유연하게 처리
           VERSION_PATTERNS=(
@@ -107,11 +150,11 @@ jobs:
             "^##[[:space:]]*버전[[:space:]]*:"
             "^##[[:space:]]*[Ll]atest[[:space:]]*[Vv]ersion[[:space:]]*:"
           )
-          
+
           # 버전 라인 찾기
           VERSION_LINE=""
           PATTERN_FOUND=""
-          
+
           for pattern in "${VERSION_PATTERNS[@]}"; do
             if grep -qi "$pattern" README.md; then
               VERSION_LINE=$(grep -i "$pattern" README.md | head -n 1)
@@ -120,63 +163,129 @@ jobs:
               break
             fi
           done
-          
+
           # 버전 라인이 없으면 기본 형식으로 추가
           if [ -z "$VERSION_LINE" ]; then
             echo "📝 버전 정보가 없어 새로 추가합니다"
-          
+
             # 파일 맨 앞에 제목이 있는지 확인 후 그 다음에 추가
             if grep -q "^# " README.md; then
               # 첫 번째 제목 다음에 추가
-              sed -i '/^# /a\\n<!-- 수정하지마세요 자동으로 동기화 됩니다 -->\n## 최신 버전 : '"$VERSION_TEXT" README.md
+              sed -i '/^# /a\\n<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## 최신 버전 : '"$VERSION_TEXT" README.md
             else
               # 파일 맨 앞에 추가
-              sed -i '1i\<!-- 수정하지마세요 자동으로 동기화 됩니다 -->\n## 최신 버전 : '"$VERSION_TEXT"'\n' README.md
+              sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n## 최신 버전 : '"$VERSION_TEXT"'\n' README.md
             fi
             echo "✅ 기본 버전 정보 추가 완료: $VERSION_TEXT"
           else
             # 기존 버전 라인 업데이트
-
+
+            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            # 버전 라인 형식 검증 및 경고
+            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            if [[ "$VERSION_LINE" =~ \*\* ]]; then
+              echo ""
+              echo "⚠️ 경고: 버전 라인에 마크다운 볼드(**) 문자가 포함되어 있습니다"
+              echo "   현재 버전 라인: $VERSION_LINE"
+              echo "   이로 인해 버전 업데이트가 실패할 수 있습니다"
+              echo ""
+            fi
+
             # HTML 주석이 해당 라인 위에 있는지 확인
             LINE_NUMBER=$(grep -n -i "$PATTERN_FOUND" README.md | head -n 1 | cut -d: -f1)
             PREV_LINE_NUMBER=$((LINE_NUMBER - 1))
-          
+
             if [ $PREV_LINE_NUMBER -gt 0 ]; then
               PREV_LINE=$(sed -n "${PREV_LINE_NUMBER}p" README.md)
-              if [[ "$PREV_LINE" != *"수정하지마세요 자동으로 동기화 됩니다"* ]]; then
+              if [[ "$PREV_LINE" != *"AUTO-VERSION-SECTION"* ]]; then
                 # 주석이 없으면 버전 라인 위에 추가
-                sed -i "${PREV_LINE_NUMBER}a\\<!-- 수정하지마세요 자동으로 동기화 됩니다 -->" README.md
+                sed -i "${PREV_LINE_NUMBER}a\\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->" README.md
                 echo "✅ 자동 업데이트 주석 추가 완료"
+                # 주석 추가로 라인 번호가 변경됨
+                LINE_NUMBER=$((LINE_NUMBER + 1))
               fi
             else
               # 첫 번째 라인이면 그 위에 추가
-              sed -i '1i\<!-- 수정하지마세요 자동으로 동기화 됩니다 -->' README.md
+              sed -i '1i\<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->' README.md
               echo "✅ 자동 업데이트 주석 추가 완료"
+              # 주석 추가로 라인 번호가 변경됨
+              LINE_NUMBER=$((LINE_NUMBER + 1))
             fi
-
-            # 원래 패턴의 형식을 유지하면서 버전 정보만 업데이트
-            # 기존 라인에서 헤더 부분(## ... :)을 추출하고 새 버전 정보로 교체
-            HEADER_PART=$(echo "$VERSION_LINE" | sed 's/v[0-9].*//' | sed 's/[0-9].*//')
-
-            # 기존 라인을 새 버전 정보로 교체
-            sed -i "s|^${VERSION_LINE}.*|${HEADER_PART}${VERSION_TEXT}|" README.md
+
+            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            # 헤더 부분 추출 (콜론까지만 추출하여 안전하게 처리)
+            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            HEADER_PART=$(echo "$VERSION_LINE" | sed 's/\(.*:\).*/\1 /')
+
+            # 헤더 추출 실패 검증
+            if [ -z "$HEADER_PART" ] || [[ "$HEADER_PART" == "$VERSION_LINE" ]]; then
+              print_error_message "헤더 추출 실패 - 콜론(:)을 찾을 수 없습니다" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
+              exit 1
+            fi
+
+            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            # 라인 번호 기반으로 직접 교체 (정규표현식 특수문자 문제 회피)
+            # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+            NEW_LINE="${HEADER_PART}${VERSION_TEXT}"
+
+            if ! sed -i "${LINE_NUMBER}s|.*|${NEW_LINE}|" README.md 2>/tmp/sed_error.log; then
+              SED_ERROR=$(cat /tmp/sed_error.log 2>/dev/null || echo "알 수 없는 sed 오류")
+              print_error_message "sed 명령어 실행 실패 - $SED_ERROR" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
+              exit 1
+            fi
+
+            # 변경 결과 검증
+            UPDATED_LINE=$(sed -n "${LINE_NUMBER}p" README.md)
+            if [[ "$UPDATED_LINE" != *"$VERSION_TEXT"* ]]; then
+              print_error_message "버전 정보 교체 검증 실패" "$VERSION_LINE" "$HEADER_PART" "$VERSION_TEXT"
+              echo "   • 업데이트된 라인: $UPDATED_LINE"
+              exit 1
+            fi
+
             echo "✅ 버전 정보 업데이트 완료: $VERSION_TEXT"
           fi
 
       - name: 변경사항 커밋 및 푸시
         run: |
+          DEFAULT_BRANCH="${{ github.event.repository.default_branch || 'main' }}"
           git add README.md
-          
+
           if git diff --staged --quiet; then
             echo "📝 README.md에 변경사항이 없습니다"
           else
             REPO_NAME=$(basename "${{ github.repository }}")
             VERSION="${{ steps.version_info.outputs.latest_version }}"
-          
+
             git commit -m "$REPO_NAME 버전 관리 : docs : v$VERSION README 버전 정보 업데이트 [skip ci]"
-
-            # main 브랜치로만 푸시
-            git push origin HEAD:main
-
-            echo "✅ README.md 버전 정보 업데이트 완료"
+
+            # Race Condition 방지: pull-rebase 후 push (최대 3회 재시도)
+            MAX_RETRIES=3
+            RETRY_COUNT=0
+            PUSH_SUCCESS=false
+
+            while [ $RETRY_COUNT -lt $MAX_RETRIES ]; do
+              RETRY_COUNT=$((RETRY_COUNT + 1))
+              echo "🔄 Push 시도 $RETRY_COUNT/$MAX_RETRIES..."
+
+              if git push origin HEAD:$DEFAULT_BRANCH; then
+                PUSH_SUCCESS=true
+                echo "✅ README.md 버전 정보 업데이트 완료"
+                break
+              else
+                echo "⚠️ Push 실패, remote 변경사항 동기화 중..."
+
+                if git pull --rebase origin $DEFAULT_BRANCH; then
+                  echo "✅ Rebase 성공, 다시 push 시도..."
+                else
+                  echo "❌ Rebase 실패, 충돌 해결 필요"
+                  git rebase --abort 2>/dev/null || true
+                  exit 1
+                fi
+              fi
+            done
+
+            if [ "$PUSH_SUCCESS" = false ]; then
+              echo "❌ $MAX_RETRIES회 시도 후에도 push 실패"
+              exit 1
+            fi
           fi