#86 [chore] GitHub Actions 배포 워크플로우 작성

# [chore] GitHub Actions 배포 워크플로우 작성

## 📝 변경 내용
<!-- 이 PR에서 무엇을 변경했는지 간단히 설명해주세요 -->
배포 관련 스크립트 작성

## 🔗 관련 이슈
<!-- 관련된 이슈가 있다면 링크해주세요 -->
- Closes #85 

## 🎯 변경 사항
- [ ] 새로운 기능 추가
- [ ] 버그 수정
- [ ] UI/UX 개선
- [x] 리팩토링
- [ ] 문서 업데이트

## 📱 테스트
- [x] 브라우저에서 정상 동작 확인
- [x] 기존 기능에 영향 없음 확인

## 📋 체크리스트
- [x] 코드가 정상적으로 동작합니다
- [x] 새로운 에러나 경고가 없습니다
- [x] 필요시 문서를 업데이트했습니다
- [x] 코드 포맷팅을 실행했습니다 (`npm run format`)
- [x] ESLint 검사를 통과했습니다 (`npm run lint:fix`)

## 💻 코드 품질 확인
PR 제출 전에 다음 명령어를 실행하여 코드 품질을 확인해주세요:

```bash
# ESLint 자동 수정
npm run lint:fix

# Prettier 포맷팅
npm run format
```

Author: dohy-eon

.github/workflows/sync-upstream.yml

@@ -0,0 +1,49 @@
+name: Sync main branch to personal fork
+
+on:
+  # 원본 레포(main)에 커밋/머지될 때마다 자동 실행
+  push:
+    branches:
+      - main
+
+  # 필요할 때 수동으로도 실행 가능
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  sync-to-fork:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout organization repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Configure Git user
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Push main to personal fork
+        env:
+          # 👉 여기 시크릿은 조직 레포의 Settings > Secrets and variables > Actions 에서
+          #    개인 계정 PAT( repo 권한 )으로 만들어야 합니다. 예: PERSONAL_FORK_TOKEN
+          PERSONAL_FORK_TOKEN: ${{ secrets.PERSONAL_FORK_TOKEN }}
+        run: |
+          if [ -z "$PERSONAL_FORK_TOKEN" ]; then
+            echo "❌ PERSONAL_FORK_TOKEN 시크릿이 설정되어 있지 않습니다."
+            exit 1
+          fi
+
+          FORK_REPO_OWNER="dohy-eon"
+          FORK_REPO_NAME="Valuedi_Web"
+
+          git remote add fork "https://x-access-token:${PERSONAL_FORK_TOKEN}@github.com/${FORK_REPO_OWNER}/${FORK_REPO_NAME}.git"
+
+          # 최신 main 기준으로 포크의 main을 덮어쓰기 (히스토리 유지하면서 fast-forward 또는 force-with-lease 가능)
+          git push fork main:main
+
+

package.json

@@ -16,7 +16,9 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
-    "postinstall": "playwright install chromium"
+    "postinstall": "playwright install chromium",
+    "setup:fork": "./scripts/setup-fork.sh",
+    "sync:upstream": "./scripts/sync-from-upstream.sh"
   },
   "dependencies": {
     "@tanstack/react-query": "^5.90.12",

scripts/setup-fork.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+
+# Organization 저장소를 개인 포크로 설정하는 스크립트
+
+set -e
+
+echo "🔧 개인 포크 설정을 시작합니다..."
+
+# GitHub CLI 인증 확인
+if ! gh auth status &>/dev/null; then
+    echo "❌ GitHub CLI에 로그인되어 있지 않습니다."
+    echo "다음 명령어로 로그인하세요:"
+    echo "  gh auth login"
+    exit 1
+fi
+
+# 현재 사용자 정보 가져오기
+GITHUB_USER=$(gh api user -q .login)
+echo "👤 GitHub 사용자: $GITHUB_USER"
+
+# Organization 저장소 정보
+ORG_REPO="Valuedi/Valuedi_Web"
+FORK_REPO="$GITHUB_USER/Valuedi_Web"
+
+echo "📦 Organization 저장소: $ORG_REPO"
+echo "🍴 포크할 저장소: $FORK_REPO"
+
+# 포크가 이미 존재하는지 확인
+if gh repo view "$FORK_REPO" &>/dev/null; then
+    echo "✅ 포크가 이미 존재합니다: $FORK_REPO"
+else
+    echo "🍴 포크 생성 중..."
+    gh repo fork "$ORG_REPO" --clone=false
+    echo "✅ 포크 생성 완료!"
+fi
+
+# 현재 origin 확인
+CURRENT_ORIGIN=$(git remote get-url origin 2>/dev/null || echo "")
+if [[ "$CURRENT_ORIGIN" == *"Valuedi/Valuedi_Web"* ]]; then
+    echo "🔄 origin을 개인 포크로 변경 중..."
+    git remote set-url origin "https://github.com/$FORK_REPO.git"
+    echo "✅ origin이 개인 포크로 변경되었습니다"
+fi
+
+# upstream이 없으면 추가
+if ! git remote | grep -q "^upstream$"; then
+    echo "➕ upstream remote 추가 중..."
+    git remote add upstream "https://github.com/$ORG_REPO.git"
+    echo "✅ upstream이 추가되었습니다"
+else
+    echo "✅ upstream이 이미 설정되어 있습니다"
+fi
+
+# 원격 저장소 확인
+echo ""
+echo "📋 현재 원격 저장소 설정:"
+git remote -v
+
+echo ""
+echo "✅ 설정 완료!"
+echo ""
+echo "이제 다음 명령어로 동기화할 수 있습니다:"
+echo "  ./scripts/sync-from-upstream.sh"
+echo ""
+echo "또는 package.json의 스크립트를 사용하세요:"
+echo "  npm run sync:upstream"

scripts/sync-from-upstream.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+
+# Organization 저장소의 최신 변경사항을 개인 포크로 동기화하는 스크립트
+
+set -e
+
+echo "🔄 Organization 저장소에서 최신 변경사항 가져오는 중..."
+
+# upstream이 설정되어 있는지 확인
+if ! git remote | grep -q "^upstream$"; then
+    echo "❌ upstream remote가 설정되어 있지 않습니다."
+    echo "다음 명령어로 설정하세요:"
+    echo "  git remote add upstream https://github.com/Valuedi/Valuedi_Web.git"
+    exit 1
+fi
+
+# 현재 브랜치 저장
+CURRENT_BRANCH=$(git branch --show-current)
+echo "📍 현재 브랜치: $CURRENT_BRANCH"
+
+# upstream에서 최신 변경사항 가져오기
+echo "📥 upstream에서 fetch 중..."
+git fetch upstream
+
+# main 브랜치로 전환
+echo "🔄 main 브랜치로 전환 중..."
+git checkout main
+
+# upstream/main을 main에 병합
+echo "🔀 upstream/main을 main에 병합 중..."
+git merge upstream/main --no-edit
+
+# 개인 포크에 푸시
+echo "📤 개인 포크(origin)에 푸시 중..."
+git push origin main
+
+# 원래 브랜치로 돌아가기
+if [ "$CURRENT_BRANCH" != "main" ]; then
+    echo "🔄 원래 브랜치($CURRENT_BRANCH)로 돌아가는 중..."
+    git checkout "$CURRENT_BRANCH"
+fi
+
+echo "✅ 동기화 완료!"

vercel.json

@@ -0,0 +1,21 @@
+{
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist",
+  "rewrites": [
+    {
+      "source": "/(.*)",
+      "destination": "/index.html"
+    }
+  ],
+  "headers": [
+    {
+      "source": "/assets/(.*)",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "public, max-age=31536000, immutable"
+        }
+      ]
+    }
+  ]
+}