project-auto-wizard 0.10.0 → 0.12.0

package/payload/workflows/flutter/PROJECT-FLUTTER-CI.yaml

@@ -32,7 +32,10 @@
 # FLUTTER_VERSION : Flutter SDK 버전
 # JAVA_VERSION    : Java 버전 (Android 빌드용)
 # XCODE_VERSION   : Xcode 버전 (iOS 빌드용)
-# ENV_FILE_PATH   : .env 파일 경로 (기본값: 루트의 .env)
+# ENV_FILE_PATH   : dotenv 모드에서 .env를 만들 경로 (Flutter 루트 기준, 기본값: .env)
+# ENV_MODE        : 환경변수 전달 방식 — dart-define(--dart-define-from-file) | dotenv(.env 파일)
+# FLUTTER_PROJECT_DIR : Flutter 루트 경로 (설치 시 자동 설정, 모노레포는 app 등)
+# PROJECT_PATH    : 변경 감지 기준 경로 (설치 시 자동 설정, "."이면 항상 실행)
 #
 # ==========================================================================================
 # 🔑 필수 GitHub Secrets
@@ -40,6 +43,8 @@
 # ENV_FILE (선택): .env 파일 내용
 #
 # ※ CI는 빌드 검증 목적이므로 서명/배포 관련 Secrets 불필요
+# ※ 모노레포에서 이 CI를 required check로 쓰려면 개별 job이 아니라 `ci-gate` 하나만 등록하세요.
+#    (경로가 바뀌지 않아 건너뛴 job은 Success로 집계되고, ci-gate가 최종 결과를 판정합니다)
 # ==========================================================================================
 
 name: PROJECT-Flutter-CI
@@ -73,6 +78,13 @@ permissions:
 # 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
 # ==========================================================================================
 env:
+  # 🎯 모노레포 변경 감지 경로 (설치 시 자동 설정, 단일 레포는 ".")
+  PROJECT_PATH: "."  # @wizard auto:project-path
+  # Flutter 루트 경로(레포 루트 기준). 단일레포면 ".", 모노레포면 "app" 등 — 설치 시 자동 설정
+  FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
+  # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
+  ENV_MODE: "dart-define"  # @wizard auto:flutter-env-mode
+
   # 🎯 CI 모드 설정
   ANALYZE_ONLY: "false"     # true: analyze만 실행 (빌드 스킵), false: analyze + 빌드
 
@@ -84,18 +96,44 @@ env:
   FLUTTER_VERSION: "3.35.5"
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:17
   XCODE_VERSION: "26.0"
-  ENV_FILE_PATH: ".env"     # 환경변수 파일 경로 (커스터마이징 가능)
+  ENV_FILE_PATH: ".env"     # dotenv 모드에서 .env를 만들 경로 (Flutter 루트 기준, 커스터마이징 가능)
 
 concurrency:
   group: flutter-ci-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
+  # ===================================================================
+  # Job 0: 변경 감지 (PROJECT_PATH 아래가 바뀌었을 때만 이후 job 실행)
+  # ===================================================================
+  changes:
+    name: 변경 감지
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      project: ${{ steps.filter.outputs.project }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: 프로젝트 경로 변경 여부 판별
+        id: filter
+        if: ${{ github.event_name != 'workflow_dispatch' }}
+        uses: dorny/paths-filter@v4
+        with:
+          filters: |
+            project:
+              - '${{ env.PROJECT_PATH == '.' && '**' || format('{0}/**', env.PROJECT_PATH) }}'
+
   # ===================================================================
   # Job 1: 준비 단계
   # ===================================================================
   prepare:
     name: CI 준비
+    needs: changes
+    if: ${{ (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') }}
     runs-on: ubuntu-latest
 
     outputs:
@@ -229,7 +267,11 @@ jobs:
   analyze:
     name: 코드 분석
     runs-on: ubuntu-latest
-    needs: prepare
+    needs: [changes, prepare]
+    if: ${{ (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') }}
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     outputs:
       status: ${{ steps.result.outputs.status }}
@@ -246,13 +288,20 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v7
 
-      # .env 파일 생성
-      - name: Create .env file
+      # 환경변수 준비 — ENV_MODE=dotenv면 .env 파일, dart-define이면 프로젝트 밖 임시 파일(--dart-define-from-file)
+      - name: Prepare env file
+        env:
+          ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
-          cat << 'EOF' > ${{ env.ENV_FILE_PATH }}
-          ${{ secrets.ENV_FILE || secrets.ENV }}
-          EOF
-          echo "✅ ${{ env.ENV_FILE_PATH }} file created"
+          if [ "$ENV_MODE" = "dotenv" ]; then
+            printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
+            echo "✅ $ENV_FILE_PATH file created"
+          elif [ -n "$ENV_CONTENT" ]; then
+            DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
+            printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
+            echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
+            echo "dart-define file prepared"
+          fi
 
       # Flutter 설정
       - name: Set up Flutter
@@ -271,7 +320,7 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ~/.pub-cache
-          key: ${{ runner.os }}-flutter-pub-${{ hashFiles('**/pubspec.lock') }}
+          key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       # 프로젝트 의존성 설치
@@ -317,10 +366,14 @@ jobs:
   build-android:
     name: Android 빌드
     if: |
+      (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') &&
       needs.prepare.outputs.analyze_only != 'true' &&
       needs.prepare.outputs.enable_android == 'true'
     runs-on: ubuntu-latest
-    needs: prepare
+    needs: [changes, prepare]
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     outputs:
       status: ${{ steps.result.outputs.status }}
@@ -337,13 +390,20 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v7
 
-      # .env 파일 생성
-      - name: Create .env file
+      # 환경변수 준비 — ENV_MODE=dotenv면 .env 파일, dart-define이면 프로젝트 밖 임시 파일(--dart-define-from-file)
+      - name: Prepare env file
+        env:
+          ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
-          cat << 'EOF' > ${{ env.ENV_FILE_PATH }}
-          ${{ secrets.ENV_FILE || secrets.ENV }}
-          EOF
-          echo "✅ ${{ env.ENV_FILE_PATH }} file created"
+          if [ "$ENV_MODE" = "dotenv" ]; then
+            printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
+            echo "✅ $ENV_FILE_PATH file created"
+          elif [ -n "$ENV_CONTENT" ]; then
+            DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
+            printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
+            echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
+            echo "dart-define file prepared"
+          fi
 
       # Flutter 설정
       - name: Set up Flutter
@@ -362,7 +422,7 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ~/.pub-cache
-          key: ${{ runner.os }}-flutter-pub-${{ hashFiles('**/pubspec.lock') }}
+          key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       # Gradle 캐시
@@ -372,7 +432,7 @@ jobs:
           path: |
             ~/.gradle/caches
             ~/.gradle/wrapper
-          key: ${{ runner.os }}-gradle-${{ hashFiles('**/build.gradle', '**/gradle-wrapper.properties') }}
+          key: ${{ runner.os }}-gradle-${{ hashFiles(format('{0}/android/**/build.gradle', env.FLUTTER_PROJECT_DIR), format('{0}/android/**/gradle-wrapper.properties', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: |
             ${{ runner.os }}-gradle-
 
@@ -399,7 +459,7 @@ jobs:
 
       # Gradle 셋업
       - name: Setup Gradle
-        working-directory: android
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/android
         run: |
           chmod +x gradlew
           echo "✅ Gradle wrapper permissions set"
@@ -409,7 +469,7 @@ jobs:
         id: build
         run: |
           echo "📦 Flutter APK 빌드 시작 (debug)..."
-          flutter build apk --debug
+          flutter build apk --debug ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
           echo "✅ APK 빌드 완료"
           ls -la ./build/app/outputs/flutter-apk/ || true
 
@@ -439,10 +499,14 @@ jobs:
   build-ios:
     name: iOS 빌드
     if: |
+      (github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true') &&
       needs.prepare.outputs.analyze_only != 'true' &&
       needs.prepare.outputs.enable_ios == 'true'
     runs-on: macos-26
-    needs: prepare
+    needs: [changes, prepare]
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
 
     outputs:
       status: ${{ steps.result.outputs.status }}
@@ -479,13 +543,20 @@ jobs:
           echo "=== Downloading iOS platform ==="
           xcodebuild -downloadPlatform iOS
 
-      # .env 파일 생성
-      - name: Create .env file
+      # 환경변수 준비 — ENV_MODE=dotenv면 .env 파일, dart-define이면 프로젝트 밖 임시 파일(--dart-define-from-file)
+      - name: Prepare env file
+        env:
+          ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
-          cat << 'EOF' > ${{ env.ENV_FILE_PATH }}
-          ${{ secrets.ENV_FILE || secrets.ENV }}
-          EOF
-          echo "✅ ${{ env.ENV_FILE_PATH }} file created"
+          if [ "$ENV_MODE" = "dotenv" ]; then
+            printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
+            echo "✅ $ENV_FILE_PATH file created"
+          elif [ -n "$ENV_CONTENT" ]; then
+            DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
+            printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
+            echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
+            echo "dart-define file prepared"
+          fi
 
       # Flutter 설정
       - name: Set up Flutter
@@ -504,7 +575,7 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ~/.pub-cache
-          key: ${{ runner.os }}-flutter-pub-${{ hashFiles('**/pubspec.lock') }}
+          key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       # 프로젝트 의존성 설치
@@ -534,7 +605,7 @@ jobs:
         id: build
         run: |
           echo "📦 Flutter iOS 빌드 시작..."
-          flutter build ios --release --no-codesign
+          flutter build ios --release --no-codesign ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
           echo "✅ iOS 빌드 완료"
 
       # 빌드 결과 기록
@@ -562,9 +633,9 @@ jobs:
   # ===================================================================
   report:
     name: 결과 보고
-    if: always() && github.event_name == 'pull_request'
+    if: always() && github.event_name == 'pull_request' && needs.changes.outputs.project == 'true'
     runs-on: ubuntu-latest
-    needs: [prepare, analyze, build-android, build-ios]
+    needs: [changes, prepare, analyze, build-android, build-ios]
 
     steps:
       - name: 최종 결과 댓글 업데이트
@@ -714,3 +785,23 @@ jobs:
             } else {
               console.log('⚠️ 댓글 ID가 없어 업데이트를 건너뜁니다.');
             }
+
+  # ===================================================================
+  # Job 6: CI Gate (required check로 등록할 단일 진입점)
+  # ===================================================================
+  # 건너뛴(skipped) job은 통과로 보고 failure/cancelled가 하나라도 있으면 실패한다.
+  ci-gate:
+    name: CI Gate
+    if: ${{ always() }}
+    needs: [changes, prepare, analyze, build-android, build-ios, report]
+    runs-on: ubuntu-latest
+    steps:
+      - name: 결과 집계
+        env:
+          RESULTS: ${{ toJSON(needs.*.result) }}
+        run: |
+          echo "needs 결과: $RESULTS"
+          if echo "$RESULTS" | grep -Eq '"(failure|cancelled)"'; then
+            echo "실패하거나 취소된 job이 있습니다."
+            exit 1
+          fi

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

@@ -6,10 +6,8 @@
 # 이 워크플로우는 기능 브랜치에서 수동으로 실행하여
 # 테스트용 iOS 빌드를 TestFlight에 배포합니다.
 #
-# ★ 마법사 우선 아키텍처 ★
-# - 빌드에 필요한 설정 파일들은 웹 마법사가 생성합니다
-# - 워크플로우는 마법사가 생성한 파일들을 그대로 사용합니다
-# - 마법사 경로: .github/util/flutter/ios-testflight-setup-wizard/index.html
+# 설정 파일(ios/fastlane/Fastfile, ios/ExportOptions.plist)은 project-auto-wizard가
+# 없을 때만 설치하며, 이미 있으면 덮어쓰지 않습니다.
 #
 # 주요 특징:
 # - workflow_dispatch로 수동 실행 또는 repository_dispatch로 트리거
@@ -22,7 +20,7 @@
 #   1. flutter build ios --no-codesign (Flutter 빌드)
 #   2. xcodebuild archive (Xcode 아카이브 생성)
 #   3. xcodebuild -exportArchive (IPA 생성, ExportOptions.plist 사용)
-#   4. fastlane upload_testflight (마법사 생성 Fastfile 사용)
+#   4. fastlane upload_testflight (ios/fastlane/Fastfile 사용)
 #
 # ===================================================================
 # 🔑 필수 GitHub Secrets
@@ -63,6 +61,11 @@ env:
   FLUTTER_VERSION: "3.35.5"
   XCODE_VERSION: "26.0"
   PROJECT_TYPE: "flutter"
+  # Flutter 루트 경로(레포 루트 기준). 단일레포면 ".", 모노레포면 "app" 등 — 설치 시 자동 설정
+  FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
+  # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
+  ENV_MODE: "dart-define"  # @wizard auto:flutter-env-mode
+  # dotenv 모드에서 .env 파일을 만들 경로 (Flutter 루트 기준)
   ENV_FILE_PATH: ".env"
 
 jobs:
@@ -186,6 +189,9 @@ jobs:
   prepare-test-build:
     name: 테스트 빌드 준비
     runs-on: macos-26
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     needs: notify-start
     if: |
       always() &&
@@ -214,13 +220,6 @@ jobs:
       - name: Select Xcode version
         run: sudo xcode-select -s /Applications/Xcode_${{ env.XCODE_VERSION }}.app/Contents/Developer
 
-      - name: Create .env file
-        env:
-          ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
-        run: |
-          printf '%s\n' "$ENV_CONTENT" > ${{ env.ENV_FILE_PATH }}
-          echo "✅ ${{ env.ENV_FILE_PATH }} file created"
-
       - name: Create Secrets.xcconfig file
         env:
           SECRETS_XCCONFIG_CONTENT: ${{ secrets.SECRETS_XCCONFIG }}
@@ -237,6 +236,7 @@ jobs:
       # 테스트 빌드 버전 설정 (version.yml에서 동적 읽기)
       - name: 테스트 빌드 버전 설정
         id: test_version
+        working-directory: ${{ github.workspace }}   # version_manager.py가 레포 루트 version.yml을 읽어야 함
         run: |
           # version_manager.py로 버전 가져오기 (프로덕션 워크플로우와 동일한 방식)
           VERSION=$(python3 .github/scripts/version_manager.py get | tail -n 1)
@@ -309,6 +309,7 @@ jobs:
       # 릴리즈 노트 생성
       - name: 릴리즈 노트 생성
         id: release_notes
+        working-directory: ${{ github.workspace }}   # final_release_notes.txt(upload 짝)는 레포 루트 기준
         run: |
           BUILD_NUMBER="${{ steps.test_version.outputs.build_number }}"
           BRANCH_NAME="${{ steps.issue_info.outputs.branch_name }}"
@@ -358,11 +359,10 @@ jobs:
         with:
           name: project-files
           path: |
-            ${{ env.ENV_FILE_PATH }}
-            ios/Flutter/Secrets.xcconfig
-            pubspec.yaml
-            lib/
-            assets/
+            ${{ env.FLUTTER_PROJECT_DIR }}/ios/Flutter/Secrets.xcconfig
+            ${{ env.FLUTTER_PROJECT_DIR }}/pubspec.yaml
+            ${{ env.FLUTTER_PROJECT_DIR }}/lib/
+            ${{ env.FLUTTER_PROJECT_DIR }}/assets/
           retention-days: 1
 
       # 진행 상황 업데이트 - 준비 실패
@@ -419,6 +419,9 @@ jobs:
   build-ios-test:
     name: iOS 테스트 빌드
     runs-on: macos-26
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     needs: [notify-start, prepare-test-build]
     if: |
       !cancelled() &&
@@ -517,15 +520,20 @@ jobs:
         uses: actions/download-artifact@v8
         with:
           name: project-files
-          path: .
+          path: ${{ env.FLUTTER_PROJECT_DIR }}
 
-      - name: Ensure .env file exists
+      - name: Prepare env file
         env:
           ENV_CONTENT: ${{ secrets.ENV_FILE || secrets.ENV }}
         run: |
-          if [ ! -f "${{ env.ENV_FILE_PATH }}" ]; then
-            printf '%s\n' "$ENV_CONTENT" > ${{ env.ENV_FILE_PATH }}
-            echo "✅ ${{ env.ENV_FILE_PATH }} file created (fallback)"
+          if [ "$ENV_MODE" = "dotenv" ]; then
+            printf '%s\n' "$ENV_CONTENT" > "$ENV_FILE_PATH"
+            echo "✅ $ENV_FILE_PATH file created"
+          elif [ -n "$ENV_CONTENT" ]; then
+            DART_DEFINE_FILE="$RUNNER_TEMP/dart-define.env"
+            printf '%s\n' "$ENV_CONTENT" > "$DART_DEFINE_FILE"
+            echo "DART_DEFINE_FILE=$DART_DEFINE_FILE" >> "$GITHUB_ENV"
+            echo "dart-define file prepared"
           fi
 
       - name: Set up Flutter
@@ -538,7 +546,7 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ~/.pub-cache
-          key: ${{ runner.os }}-flutter-pub-${{ hashFiles('**/pubspec.lock') }}
+          key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
       - name: Install dependencies
@@ -579,9 +587,8 @@ jobs:
         run: |
           cd ios
           if [ ! -f "ExportOptions.plist" ]; then
-            echo "❌ ios/ExportOptions.plist이 없습니다!"
-            echo "웹 마법사를 실행하여 설정 파일을 생성하세요:"
-            echo "  브라우저에서 .github/util/flutter/ios-testflight-setup-wizard/index.html 열기"
+            echo "❌ ios/ExportOptions.plist가 없습니다!"
+            echo "ios/ExportOptions.plist를 저장소에 추가(커밋)하세요. 필요한 Secrets는 워크플로우 상단 주석을 참고하세요."
             exit 1
           fi
           echo "✅ ExportOptions.plist 확인됨"
@@ -593,7 +600,8 @@ jobs:
         run: |
           flutter build ios --release --no-codesign \
             --build-name="${{ needs.prepare-test-build.outputs.version }}" \
-            --build-number="${{ needs.prepare-test-build.outputs.build_number }}"
+            --build-number="${{ needs.prepare-test-build.outputs.build_number }}" \
+            ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
 
       - name: Create Archive
         env:
@@ -636,8 +644,8 @@ jobs:
         with:
           name: ios-ipa
           path: |
-            ios/build/ipa/*.ipa
-            build-metadata.json
+            ${{ env.FLUTTER_PROJECT_DIR }}/ios/build/ipa/*.ipa
+            ${{ env.FLUTTER_PROJECT_DIR }}/build-metadata.json
           retention-days: 1
 
       # 진행 상황 업데이트 - IPA 빌드 완료
@@ -755,11 +763,14 @@ jobs:
             console.log(`❌ 진행 상황 업데이트 완료: IPA 빌드 실패`);
 
   # ===================================================================
-  # TestFlight 배포 (마법사 생성 Fastfile 사용)
+  # TestFlight 배포 (ios/fastlane/Fastfile 사용)
   # ===================================================================
   deploy-testflight-test:
     name: TestFlight 테스트 배포
     runs-on: macos-26
+    defaults:
+      run:
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}
     needs: [notify-start, prepare-test-build, build-ios-test]
     if: |
       !cancelled() &&
@@ -784,7 +795,7 @@ jobs:
         uses: actions/download-artifact@v8
         with:
           name: ios-ipa
-          path: ios/build/ipa/
+          path: ${{ env.FLUTTER_PROJECT_DIR }}/ios/build/ipa/
 
       - name: Download release notes
         uses: actions/download-artifact@v8
@@ -796,17 +807,21 @@ jobs:
         run: |
           if [ ! -f "ios/fastlane/Fastfile" ]; then
             echo "❌ ios/fastlane/Fastfile이 없습니다!"
-            echo "웹 마법사를 실행하여 설정 파일을 생성하세요:"
-            echo "  브라우저에서 .github/util/flutter/ios-testflight-setup-wizard/index.html 열기"
+            echo "ios/fastlane/Fastfile을 저장소에 추가(커밋)하세요. 필요한 Secrets는 워크플로우 상단 주석을 참고하세요."
             exit 1
           fi
           echo "✅ Fastfile 확인됨: ios/fastlane/Fastfile"
 
       - name: Install Fastlane
-        working-directory: ios
+        working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/ios
         run: |
-          # multi_json: google-apis transitive 의존성이 선언 누락한 upstream 버그 회피 (gemspec 미선언 → Gem::LoadError)
-          printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
+          # 저장소의 Gemfile에 fastlane이 있으면 그대로 쓴다 (Gemfile.lock 커밋 권장). 없으면 생성한다.
+          if [ -f Gemfile ] && grep -Eq "['\"]fastlane['\"]" Gemfile; then
+            echo "ℹ️ 저장소의 Gemfile을 사용합니다"
+          else
+            # multi_json: google-apis transitive 의존성이 선언 누락한 upstream 버그 회피 (gemspec 미선언 → Gem::LoadError)
+            printf 'source "https://rubygems.org"\ngem "fastlane"\ngem "multi_json"\n' > Gemfile
+          fi
           bundle install
           echo "✅ Fastlane installed (Bundler)"
 
@@ -816,7 +831,7 @@ jobs:
           APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}
         run: |
           # IPA 파일 찾기
-          IPA_PATH=$(find $GITHUB_WORKSPACE/ios/build/ipa -name "*.ipa" | head -1)
+          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
@@ -825,9 +840,9 @@ jobs:
             exit 1
           fi
 
-          # Release notes 준비
-          if [ -f "final_release_notes.txt" ]; then
-            RELEASE_NOTES=$(cat final_release_notes.txt)
+          # Release notes 준비 (final_release_notes.txt는 레포 루트 기준 — working-directory가 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
@@ -844,7 +859,7 @@ jobs:
           echo "🔧 IPA_PATH: $IPA_PATH"
           echo "🔧 API_KEY_PATH: $API_KEY_PATH"
 
-          # Fastlane 실행 (마법사가 생성한 Fastfile 사용)
+          # Fastlane 실행 (ios/fastlane/Fastfile 사용)
           cd ios
           bundle exec fastlane upload_testflight