[chore] Node 24 실행 환경 통일

.github/workflows/CI.yml

@@ -23,7 +23,7 @@ jobs:
       - name: Set up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '22.12.0'
+          node-version-file: '.node-version'
 
       - name: Install Dependencies
         run: npm ci

.github/workflows/deploy-development.yml

@@ -13,13 +13,13 @@ jobs:
     environment: DEPLOY_DEV
 
     steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
       - name: Setup NodeJS
         uses: actions/setup-node@v4
         with:
-          node-version: '22.12.0'
-
-      - name: Checkout Code
-        uses: actions/checkout@v4
+          node-version-file: '.node-version'
 
       - name: Setup .env
         run: |

.github/workflows/deploy-preview.yml

@@ -18,13 +18,13 @@ jobs:
       contents: read
 
     steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
       - name: Setup NodeJS
         uses: actions/setup-node@v4
         with:
-          node-version: '22.12.0'
-
-      - name: Checkout Code
-        uses: actions/checkout@v4
+          node-version-file: '.node-version'
 
       - name: Setup .env
         run: |

.github/workflows/deploy-production.yml

@@ -13,13 +13,13 @@ jobs:
     environment: DEPLOY_PROD
 
     steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
       - name: Setup NodeJS
         uses: actions/setup-node@v4
         with:
-          node-version: '22.12.0'
-
-      - name: Checkout Code
-        uses: actions/checkout@v4
+          node-version-file: '.node-version'
 
       - name: Setup .env
         run: |

.github/workflows/deploy-storybook.yml

@@ -10,16 +10,16 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Setup NodeJS
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22.12.0'
-
       - name: Checkout Code
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
+      - name: Setup NodeJS
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.node-version'
+
       - name: Setup .env
         run: |
           echo "AVATAR_URL=${{ secrets.DISCORD_AVATAR_URL }}" >> $GITHUB_ENV

.node-version

@@ -0,0 +1 @@
+24.21.0

docs/README.md

@@ -44,6 +44,16 @@ main.tsx → Router → page → 기능 전용 UI·hooks → 공용 UI·hooks
 `src/util/`에 있음. API 요청·응답 계약은 `src/apis/`의 전용 위치에 둠. 정확한
 책임과 예외는 각 상세 문서가 소유함.
 
+### 실행 환경 설정
+
+CI·배포의 Node 버전은 공용 파일 [`.node-version`](../.node-version)의 값을
+참조함. 로컬 실행 범위는 [`package.json`](../package.json)의 `engines.node`가
+소유함. npm 버전은 명시하거나 강제하지 않음.
+
+CI·개발·미리보기·생산·Storybook의 Node 설정은
+[workflow](../.github/workflows/)에서 checkout 이후, `npm ci` 이전에 수행함.
+환경·의존성 변경 시 위 설정을 대조함.
+
 ## 3. 아키텍처 상세 계약
 
 | 문서                                                 | 읽을 때                                                           |
@@ -85,11 +95,12 @@ main.tsx → Router → page → 기능 전용 UI·hooks → 공용 UI·hooks
 | 오류 UI·Sentry                     | 오류와 관측, React·UI, 테스트·Storybook       | 오류와 관측                             |
 | 테스트·Story                       | 테스트·Storybook, 대상 기능의 아키텍처·컨벤션 | 테스트·Storybook 또는 대상 문서         |
 | 문서·템플릿                        | 문서 작성, 이 문서, 관련 상세 문서            | 원칙 변경은 헌법, 계약 변경은 소유 문서 |
+| 실행 환경·의존성·workflow         | 실행 환경 설정, 테스트·Storybook, 문서 작성   | 실행 환경 설정                         |
 | 코드 리뷰·리뷰 보고서              | 코드 리뷰, 변경 영역의 상세 문서              | 코드 리뷰 또는 해당 상세 문서           |
 | 일반 PR 준비·생성                  | 일반 PR 생성, 코드 리뷰, 문서 작성            | 일반 PR 생성 또는 코드 리뷰             |
 
-표의 문서 이름은 3~5절의 링크를 가리킴. 정확히 일치하는 행이 없으면 변경 대상과
-소비자를 기준으로 관련 문서를 선택함. 경로·기술·작업 분류가 바뀌면 이 문서의
+표의 항목은 2~5절의 설정 설명과 문서 링크를 가리킴. 정확히 일치하는 행이 없으면
+변경 대상과 소비자를 기준으로 관련 문서를 선택함. 경로·기술·작업 분류가 바뀌면 이 문서의
 지도와 읽기 표를 갱신함.
 
 ## 7. 현재 코드와 목표 규칙

package.json

@@ -3,6 +3,9 @@
   "private": true,
   "version": "0.0.0",
   "type": "module",
+  "engines": {
+    "node": ">=24.12.0 <25"
+  },
   "scripts": {
     "dev": "vite",
     "dev-mock": "vite --mode dev-mock",
@@ -63,7 +66,7 @@
     "@types/babel__traverse": "^7.28.0",
     "@types/glob": "^8.1.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.2.0",
+    "@types/node": "^24.19.2",
     "@types/pako": "^2.0.3",
     "@types/react": "^18.3.27",
     "@types/react-dom": "^18.3.7",