🚀 Deploy 20260704-v0.0.190

.github/config/breaking-changes.json

@@ -25,5 +25,17 @@
     "severity": "critical",
     "title": "Skills 배포 방식 변경 - 마켓플레이스 전용 전환",
     "message": "Skills(IDE 명령어)가 template_integrator 복사 방식에서 Claude Code 플러그인 마켓플레이스 전용으로 변경되었습니다. 기존 .claude/skills/, .claude/scripts/ 경로가 루트 skills/, scripts/로 이동했습니다. Claude Code 사용자는 'claude plugin marketplace add Cassiiopeia/SUH-DEVOPS-TEMPLATE && claude plugin install cassiiopeia@cassiiopeia-marketplace --scope user' 명령어로 설치하세요. Cursor 사용자는 통합 시 자동으로 .cursor 폴더 복사 여부를 물어봅니다. 기존 .claude/skills/, .claude/scripts/ 폴더는 더 이상 업데이트되지 않습니다."
+  },
+
+  "3.0.133": {
+    "severity": "warning",
+    "title": "Spring 배포 워크플로우 SSH 인증 방식(password/key) 추가",
+    "message": "Spring 배포 워크플로우(SYNOLOGY-SIMPLE-CICD, SYNOLOGY-NONSTOP-NGINX-CICD)에 SSH_AUTH_METHOD 환경변수가 추가되어 Synology(password) 외에 AWS EC2 등 .pem 키(key) 인증 서버에도 배포할 수 있습니다. 기존 Synology 배포는 SSH_AUTH_METHOD 기본값이 password라 영향이 없습니다. 워크플로우를 새로 받으면 env의 SSH_AUTH_METHOD 값을 확인하고, key 인증을 쓰는 경우 GitHub Secret에 SSH_KEY(.pem 내용)를 등록하세요. 자세한 설정은 docs/SYNOLOGY-DEPLOYMENT-GUIDE.md의 'SSH 인증 방식과 다른 서버(AWS EC2 등) 배포' 섹션을 참고하세요."
+  },
+
+  "3.0.137": {
+    "severity": "warning",
+    "title": "배포 워크플로우 synology 폴더/옵션 제거 — SSH+Docker 엔진으로 통일",
+    "message": "배포 워크플로우의 synology/ 폴더 구분이 완전히 제거되었습니다. Spring 배포(SIMPLE-CICD, NONSTOP-NGINX-CICD, NONSTOP-TRAEFIK-CICD, PR-PREVIEW)와 Python 배포(SIMPLE-CICD, PR-PREVIEW)는 각 타입 루트로 이동해 기본 포함되고, Flutter Synology APK 배포는 PROJECT-FLUTTER-ANDROID-SELFHOSTED-CICD로 개명되었습니다. Nexus는 spring/nexus/, Secret 백업은 common/secret-backup/(PROJECT-COMMON-SECRET-FILE-UPLOAD로 개명)으로 분리되어 통합 마법사에서 --nexus / --secret-backup 옵션(.ps1은 -Nexus / -SecretBackup)으로 선택합니다. version.yml의 옵션 키가 options.synology에서 options.nexus / options.secret_backup으로 변경되었습니다 — 기존 synology 키는 더 이상 사용되지 않으니 통합 마법사를 다시 실행해 새 옵션을 설정하세요. 다른 서버(AWS EC2 등) 배포는 SSH_AUTH_METHOD=key + SSH_KEY secret으로 설정하세요. 자세한 내용은 docs/SSH-DOCKER-DEPLOYMENT-GUIDE.md를 참고하세요."
   }
 }

.github/config/wizard-prompts.yml

@@ -0,0 +1,62 @@
+# @wizard ask 마커의 사용자 질문 문구.
+# 형식 1 (구형, 지원 유지): KEY: "라벨"
+# 형식 2 (신규 블록): KEY 아래 label/help/example 들여쓰기 2칸
+# 형식 3 (타입 오버라이드): "{type}.KEY" 키로 타입별 문구 분리
+# 조회 우선순위: {type}.KEY -> KEY -> 구형 -> 폴백(KEY명)
+# 기본값/resolver는 여기 두지 않는다(@wizard 마커 소관).
+
+PROJECT_NAME:
+  label: "서비스 식별자 (영문 슬러그)"
+  help: "Docker 컨테이너명·이미지명·배포 도메인 prefix에 그대로 사용됩니다. 소문자-하이픈 권장."
+  example: "my-service"
+
+flutter.APP_ARTIFACT_NAME:
+  label: "앱 산출물 이름 (영문)"
+  help: "빌드된 APK 파일명·아티팩트명·빌드 히스토리 파일명에 사용됩니다."
+  example: "my-app"
+
+SERVICE_DOMAIN:
+  label: "서비스 도메인"
+  help: "배포 후 외부에서 접속할 운영 도메인입니다. 실제 보유한 도메인으로 바꿔야 합니다."
+  example: "api.example.com"
+
+JAVA_VERSION:
+  label: "빌드 JDK 버전"
+  help: "GitHub Actions 빌드 러너의 JDK 버전입니다. Spring은 보통 21, Flutter Android는 17."
+  example: "21"
+
+DEPLOY_PORT:
+  label: "외부 노출 포트"
+  help: "호스트(서버)에서 컨테이너로 연결할 포트입니다. 다른 서비스와 겹치지 않게 정하세요."
+  example: "8080"
+
+VOLUME_HOST_PATH:
+  label: "호스트(NAS) 볼륨 경로"
+  help: "서버에 데이터를 영구 저장할 실제 디렉토리 경로입니다."
+  example: "/volume1/projects/my-service"
+
+VOLUME_CONTAINER_PATH:
+  label: "컨테이너 내부 마운트 경로"
+  help: "컨테이너 안에서 위 볼륨이 보일 위치입니다."
+  example: "/mnt/my-service"
+
+SSH_AUTH_METHOD:
+  label: "SSH 인증 방식"
+  help: "배포 서버 접속 방식입니다. 둘 중 하나를 그대로 입력하세요."
+  example: "password 또는 key"
+
+# workflow filename (partial match) -> human readable short name
+# wizard uses this to build "[usage]" in env questions.
+_workflow_names:
+  NONSTOP-NGINX: "무중단배포(Nginx)"
+  NONSTOP-TRAEFIK: "무중단배포(Traefik)"
+  PR-PREVIEW: "PR 프리뷰"
+  SIMPLE-CICD: "단일 서버 배포"
+  REACT-CICD: "프론트 배포"
+  REACT-CI: "프론트 빌드"
+  NEXT-CICD: "프론트 배포"
+  NEXT-CI: "프론트 빌드"
+  PYTHON-CI: "빌드 검증"
+  FLUTTER-ANDROID-SELFHOSTED: "안드로이드 자체배포"
+  FLUTTER-ANDROID-PLAYSTORE: "플레이스토어 배포"
+  FLUTTER-ANDROID-FIREBASE: "Firebase 배포"

.github/util/flutter/playstore-wizard/playstore-wizard-setup.ps1

@@ -777,6 +777,13 @@ function Show-Summary {
     Write-Host ""
     Write-Host "  3. Push to deploy branch to test build"
     Write-Host ""
+    Write-Host "🎛️  배포 모드 설정 (선택):"
+    Write-Host "   GitHub repo Variables에 ANDROID_DEPLOY_MODE 를 설정하면 기본 배포 범위를 정할 수 있습니다."
+    Write-Host "     store_only    : 내부 테스트(internal) 업로드까지만 (기본)"
+    Write-Host "     store_prepare : production draft 승급 (콘솔에서 '출시 시작' 대기)"
+    Write-Host "     store_submit  : production 심사 자동 등록 (정식 출시 1회 수동 이후부터 가능)"
+    Write-Host "   워크플로우 수동 실행 시 deploy_mode 입력이 이 변수보다 우선합니다."
+    Write-Host ""
     Write-Host "================================================================" -ForegroundColor Cyan
 }
 

.github/util/flutter/playstore-wizard/playstore-wizard-setup.sh

@@ -593,15 +593,25 @@ patch_build_gradle() {
         exit 1
     fi
 
-    # Python 3 설치 확인
-    if ! command -v python3 &> /dev/null; then
-        print_error "Python 3가 설치되어 있지 않습니다"
-        print_warning "Python 3를 설치한 후 다시 시도하세요"
+    # Python 설치 확인.
+    # ⚠️ Windows는 python3가 "WindowsApps/python3" 스텁(실행 시 안내문만 출력하고 종료)을 가리키는 경우가 흔하다.
+    #    command -v 만으로는 스텁도 "있음"으로 잡혀 폴백이 안 된다 → 실제 실행(-c)까지 검증해 진짜 Python을 고른다.
+    local PYTHON _py _path
+    PYTHON=""
+    for _py in python3 python; do
+        _path=$(command -v "$_py" 2>/dev/null) || continue
+        "$_path" -c "import sys; sys.exit(0)" 2>/dev/null && { PYTHON="$_path"; break; }
+    done
+    if [ -z "$PYTHON" ]; then
+        print_error "실행 가능한 Python을 찾을 수 없습니다 (python3/python 모두 없음 또는 스텁)"
+        print_warning "Python 3를 설치한 후 다시 시도하세요 (Windows는 Microsoft Store 스텁이 아닌 정식 설치본 필요)"
         exit 1
     fi
 
-    # Python 스크립트 실행
-    python3 "$patch_script" "$gradle_file"
+    # Python 스크립트 실행.
+    # ⚠️ PYTHONIOENCODING=utf-8 필수: 한국어 Windows 콘솔 기본 인코딩(cp949)은 패치 스크립트가
+    #    출력하는 이모지(✅/⚠️/❌)를 인코딩하지 못해 UnicodeEncodeError로 죽는다.
+    PYTHONIOENCODING=utf-8 "$PYTHON" "$patch_script" "$gradle_file"
 
     if [ $? -ne 0 ]; then
         print_error "build.gradle.kts 패치 실패!"
@@ -764,6 +774,12 @@ print_completion() {
     echo ""
     echo "  3. deploy 브랜치로 푸시하여 빌드 테스트"
     echo ""
+    echo "🎛️  배포 모드 설정 (선택):"
+    echo "   GitHub repo Variables에 ANDROID_DEPLOY_MODE 를 설정하면 기본 배포 범위를 정할 수 있습니다."
+    echo "     store_only    : 내부 테스트(internal) 업로드까지만 (기본)"
+    echo "     store_prepare : production draft 승급 (콘솔에서 '출시 시작' 대기)"
+    echo "     store_submit  : production 심사 자동 등록 (정식 출시 1회 수동 이후부터 가능)"
+    echo "   워크플로우 수동 실행 시 deploy_mode 입력이 이 변수보다 우선합니다."
 
 }
 

.github/util/flutter/playstore-wizard/playstore-wizard.html

@@ -1846,6 +1846,17 @@ <h4 class="text-sm font-semibold text-slate-300 mb-2 flex items-center gap-2">
                 </ol>
             </div>
 
+            <div class="deploy-mode-card" style="margin-top:16px;padding:14px;border:1px solid #d0d7de;border-radius:8px;background:#f6f8fa;">
+              <h4 style="margin:0 0 8px;">🎛️ 배포 모드 &amp; 출시 로드맵 (Android)</h4>
+              <p style="margin:0 0 8px;">GitHub repo <b>Variables → ANDROID_DEPLOY_MODE</b> 로 기본 배포 범위를 정합니다. 워크플로우 수동 실행 시 <code>deploy_mode</code> 입력이 우선합니다.</p>
+              <ul style="margin:0;padding-left:18px;">
+                <li><b>store_only</b> — 내부 테스트(internal) 업로드까지만 (기본)</li>
+                <li><b>store_prepare</b> — production draft 승급 (콘솔에서 '출시 시작' 대기)</li>
+                <li><b>store_submit</b> — production 심사 자동 등록</li>
+              </ul>
+              <p style="margin:8px 0 0;color:#57606a;">⚠️ 신규 앱은 최초 1회 Play Console에서 수동 출시가 필요하고, 이후 업데이트부터 store_submit으로 자동화됩니다.</p>
+            </div>
+
             <div class="flex justify-between mt-8">
                 <button class="px-6 py-2.5 bg-slate-700 hover:bg-slate-600 rounded-lg font-medium transition" onclick="prevStep()">← 이전</button>
                 <button class="px-6 py-2.5 bg-gradient-to-r from-green-500 to-blue-500 hover:from-green-600 hover:to-blue-600 rounded-lg font-medium transition" onclick="resetWizard()">🔄 처음부터 다시 시작</button>