우아한 테크코스 오픈 미션 구현 사항

.github/DEPLOYMENT_SETUP.md

@@ -63,36 +63,60 @@ GitHub Release 생성
 
 ## 📦 배포 방법
 
-### 방법 1: 버전 업데이트 후 자동 배포 (권장)
+### 방법 1: 커밋 메시지로 자동 버전 증가 (권장) ⭐
+
+커밋 메시지에 버전 타입을 포함하면 자동으로 버전이 올라갑니다:
 
 ```bash
-# 1. 버전 업데이트
-npm version patch   # 1.5.7 → 1.5.8
-npm version minor   # 1.5.7 → 1.6.0
-npm version major   # 1.5.7 → 2.0.0
+# Patch 버전 증가 (1.5.7 → 1.5.8)
+git commit -m "fix: 버그 수정 [patch]"
+git push origin main
+
+# 또는
+git commit -m "fix: 버그 수정 release: patch"
+git push origin main
 
-# 2. main 브랜치에 push
+# Minor 버전 증가 (1.5.7 → 1.6.0)
+git commit -m "feat: 새 기능 추가 [minor]"
 git push origin main
 
-# ✅ 자동으로 npm에 배포됨
+# Major 버전 증가 (1.5.7 → 2.0.0)
+git commit -m "feat: breaking change [major]"
+git push origin main
 ```
 
-### 방법 2: 수동 버전 수정 후 배포
+**커밋 메시지 형식:**
+- `[patch]` 또는 `release: patch` → 1.5.7 → 1.5.8
+- `[minor]` 또는 `release: minor` → 1.5.7 → 1.6.0
+- `[major]` 또는 `release: major` → 1.5.7 → 2.0.0
 
-```bash
-# 1. package.json의 version 수동 수정
-# "version": "1.5.8"
+### 방법 2: GitHub Actions에서 수동 실행
 
-# 2. CHANGELOG.md 업데이트
+1. GitHub 저장소 → **Actions** 탭
+2. **Publish to npm** 워크플로우 선택
+3. **Run workflow** 클릭
+4. **Version bump type** 선택:
+   - 빈 값: 현재 버전 그대로 사용
+   - `patch`: 1.5.7 → 1.5.8
+   - `minor`: 1.5.7 → 1.6.0
+   - `major`: 1.5.7 → 2.0.0
+5. **Run workflow** 클릭
+
+### 방법 3: 버전 타입 없이 커밋 (자동 patch 증가)
+
+버전 타입을 지정하지 않으면 **자동으로 patch 버전이 증가**합니다:
 
-# 3. commit & push
+```bash
+# 버전 타입 없이 커밋하면 자동으로 patch 증가 (1.5.7 → 1.5.8)
 git add .
-git commit -m "Release v1.5.8"
+git commit -m "fix: 버그 수정"
 git push origin main
 
-# ✅ 자동으로 npm에 배포됨
+# ✅ 자동으로 patch 버전 증가 후 npm에 배포됨
 ```
 
+**주의**: 코드 변경이 있으면 항상 새 버전으로 배포되어 사용자 혼동을 방지합니다.
+
 ## 🔍 배포 확인
 
 ### GitHub Actions에서 확인

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+

.github/workflows/npm-publish.yml

@@ -9,6 +9,17 @@ on:
       - "docs/**"
       - "test-*.tsx"
       - "src/test-*.tsx"
+  workflow_dispatch:
+    inputs:
+      version_type:
+        description: 'Version bump type (leave empty to use current version)'
+        required: false
+        type: choice
+        options:
+          - ''
+          - patch
+          - minor
+          - major
 
 jobs:
   publish:
@@ -22,16 +33,86 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20"
           registry-url: "https://registry.npmjs.org"
 
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Determine version bump type
+        id: version-bump
+        run: |
+          if [ "${{ github.event_name }}" == "workflow_dispatch" ] && [ -n "${{ github.event.inputs.version_type }}" ]; then
+            echo "type=${{ github.event.inputs.version_type }}" >> $GITHUB_OUTPUT
+            echo "should_bump=true" >> $GITHUB_OUTPUT
+          else
+            # 커밋 메시지에서 버전 타입 추출
+            COMMIT_MSG="${{ github.event.head_commit.message }}"
+            if echo "$COMMIT_MSG" | grep -qiE "release:\s*(major|minor|patch)"; then
+              TYPE=$(echo "$COMMIT_MSG" | grep -oiE "release:\s*(major|minor|patch)" | awk '{print $2}' | tr '[:upper:]' '[:lower:]')
+              echo "type=$TYPE" >> $GITHUB_OUTPUT
+              echo "should_bump=true" >> $GITHUB_OUTPUT
+            elif echo "$COMMIT_MSG" | grep -qiE "\[major\]|\[minor\]|\[patch\]"; then
+              TYPE=$(echo "$COMMIT_MSG" | grep -oiE "\[(major|minor|patch)\]" | tr -d '[]' | tr '[:upper:]' '[:lower:]')
+              echo "type=$TYPE" >> $GITHUB_OUTPUT
+              echo "should_bump=true" >> $GITHUB_OUTPUT
+            else
+              # 버전 타입이 없으면 기본값으로 patch 사용 (사용자 혼동 방지)
+              echo "type=patch" >> $GITHUB_OUTPUT
+              echo "should_bump=true" >> $GITHUB_OUTPUT
+              echo "⚠️  No version type specified in commit message, defaulting to patch"
+            fi
+          fi
+          if [ "$(cat $GITHUB_OUTPUT | grep '^should_bump=' | cut -d'=' -f2)" == "true" ]; then
+            echo "Version bump type: $(cat $GITHUB_OUTPUT | grep '^type=' | cut -d'=' -f2)"
+          else
+            echo "No version bump needed, using current version"
+          fi
+
+      - name: Get current version
+        id: current-version
+        run: |
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "Current version: $CURRENT_VERSION"
+
+      - name: Bump version
+        if: steps.version-bump.outputs.should_bump == 'true'
+        id: new-version
+        run: |
+          BUMP_TYPE="${{ steps.version-bump.outputs.type }}"
+          CURRENT_VERSION="${{ steps.current-version.outputs.version }}"
+
+          # 버전 증가
+          npm version $BUMP_TYPE --no-git-tag-version
+
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "New version: $NEW_VERSION (bumped from $CURRENT_VERSION)"
+
+      - name: Commit version bump
+        if: steps.version-bump.outputs.should_bump == 'true'
+        run: |
+          git add package.json
+          git commit -m "chore: 버전 ${{ steps.new-version.outputs.version }}으로 업데이트 [skip ci]"
+          git push origin main
+
       - name: Get package version
         id: package-version
-        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
+        run: |
+          if [ "${{ steps.version-bump.outputs.should_bump }}" == "true" ]; then
+            echo "version=${{ steps.new-version.outputs.version }}" >> $GITHUB_OUTPUT
+          else
+            echo "version=${{ steps.current-version.outputs.version }}" >> $GITHUB_OUTPUT
+          fi
+          echo "Using version: $(cat $GITHUB_OUTPUT | grep '^version=' | cut -d'=' -f2)"
 
       - name: Check if version exists on npm
         id: check-version
@@ -53,10 +134,9 @@ jobs:
         if: steps.check-version.outputs.exists != 'true'
         run: npm run build
 
-      - name: Run tests (if available)
+      - name: Run tests
         if: steps.check-version.outputs.exists != 'true'
-        run: npm test --if-present
-        continue-on-error: true
+        run: npm test
 
       - name: Publish to npm
         if: steps.check-version.outputs.exists != 'true'

.gitignore

@@ -43,3 +43,10 @@ RUST_*.md
 SENTRY_PERFORMANCE_GUIDE.md
 DEPLOYMENT_NOTES.md
 MIGRATION_SEPARATION_COMPLETE.md
+
+# Learning guides (개인 학습 자료는 배포 제외)
+docs/learning/
+scripts/t-wrapper-rust/STEP_*_LEARNINGS.md
+
+# Planning documents (기획 문서)
+ignore/