Chore/code style commit convention

.github/workflows/frontend-ci.yml

@@ -6,15 +6,15 @@ on:
     branches: [main]
     types: [opened, reopened, synchronize, ready_for_review]
 
-  # 빠른 피드백: 기능/작업 브랜치에 push될 때 CI 실행
+  # 빠른 피드백: 작업 브랜치에 push될 때 CI 실행 (⚠️ 대문자 네이밍만 허용)
   push:
     branches:
-      - "Feature/*"
-      - "Fix/*"
-      - "Chore/*"
-      - "Docs/*"
-      - "Test/*"
-      - "Refactor/*"
+      - "Feature/**"
+      - "Fix/**"
+      - "Chore/**"
+      - "Docs/**"
+      - "Test/**"
+      - "Refactor/**"
 
   # (선택) Actions 탭에서 수동 실행 버튼
   workflow_dispatch: {}
@@ -23,34 +23,51 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+permissions:
+  contents: read
+
 env:
   NODE_VERSION: "20.19.2"
+  CI: "true"
 
 jobs:
   lint:
+    name: Style & Lint
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
+
       - uses: pnpm/action-setup@v4
         with:
           run_install: false
+
       - name: Get pnpm store directory
         id: pnpm-cache
         run: echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
+
       - uses: actions/cache@v4
         with:
           path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
           key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
           restore-keys: ${{ runner.os }}-pnpm-
+
       - run: pnpm install --frozen-lockfile
-      - run: pnpm run --if-present lint
+
+      - name: Prettier check
+        run: pnpm run --if-present format:check
+
+      - name: ESLint
+        run: pnpm run --if-present lint
 
   test:
     runs-on: ubuntu-latest
     needs: lint
+    timeout-minutes: 15
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -73,6 +90,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     needs: test
+    timeout-minutes: 15
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -90,4 +108,13 @@ jobs:
           key: ${{ runner.os }}-pnpm-${{ hashFiles('pnpm-lock.yaml') }}
           restore-keys: ${{ runner.os }}-pnpm-
       - run: pnpm install --frozen-lockfile
+
+      # (선택) Next.js 빌드 캐시
+      # - uses: actions/cache@v4
+      #   with:
+      #     path: |
+      #       .next/cache
+      #     key: ${{ runner.os }}-next-${{ hashFiles('pnpm-lock.yaml', 'next.config.*', '**/*.{ts,tsx,js,jsx,css,scss,md,mdx}') }}
+      #     restore-keys: ${{ runner.os }}-next-
+
       - run: pnpm run build

.husky/commit-msg

@@ -0,0 +1,10 @@
+#!/bin/sh
+
+pnpm commitlint --edit "$1" || {
+  echo
+  echo "❌ 커밋 메시지 규칙 위반!"
+  echo "   형식: CDP-숫자 type이모지(scope): subject"
+  echo "   예시: CDP-31 fix🐛(ci): CI error resolution"
+  echo "   허용: feat✨, fix🐛, refactor🔨, style🎨, chore⚙️, docs📝, test🧪"
+  exit 1
+}

.husky/pre-commit

@@ -0,0 +1,63 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+echo "🔎 pre-commit: lint-staged 실행 및 최종 점검 시작"
+
+# 0) 커밋에 포함된 파일 목록 (추가/복사/수정)
+STAGED_FILES="$(git diff --name-only --cached --diff-filter=ACMR)"
+if [ -z "$STAGED_FILES" ]; then
+  echo "ℹ️  스테이징된 파일이 없습니다. 건너뜁니다."
+  exit 0
+fi
+
+# 1) 변경 파일만 자동 수정 (eslint --fix, prettier --write)
+if ! pnpm lint-staged; then
+  echo
+  echo "❌ lint-staged 단계에서 오류가 발생했습니다."
+  echo "   - 자동수정 불가한 린트 에러가 있을 수 있어요."
+  echo "   - 로컬에서 'pnpm lint'로 에러를 확인하고 수정한 뒤 다시 커밋하세요."
+  exit 1
+fi
+
+# 2) 최종 점검: 스테이징된 파일만 대상으로 검사(수정 없이 실패만 감지)
+PRETTIER_FAIL=0
+ESLINT_FAIL=0
+
+# 개행만 구분자로 사용 (공백 포함 파일명 안전)
+IFS="$(printf '\n')"
+for f in $STAGED_FILES; do
+  case "$f" in
+    *.js|*.jsx|*.ts|*.tsx|*.json|*.css|*.md)
+      # Prettier 포맷 준수 확인 (수정 없이 검사)
+      pnpm -s prettier --check "$f" || PRETTIER_FAIL=1
+      ;;
+  esac
+done
+
+for f in $STAGED_FILES; do
+  case "$f" in
+    *.js|*.jsx|*.ts|*.tsx)
+      # ESLint 최종 확인 (수정 없이 검사)
+      pnpm -s eslint --max-warnings=0 "$f" || ESLINT_FAIL=1
+      ;;
+  esac
+done
+unset IFS
+
+if [ "$PRETTIER_FAIL" -ne 0 ]; then
+  echo
+  echo "❌ Prettier 포맷 위반이 남아 있습니다."
+  echo "   - 'pnpm format' 후 다시 커밋하세요."
+  exit 1
+fi
+
+if [ "$ESLINT_FAIL" -ne 0 ]; then
+  echo
+  echo "❌ ESLint 위반이 남아 있습니다."
+  echo "   - 'pnpm lint:fix' 또는 수동 수정 후 다시 커밋하세요."
+  exit 1
+fi
+
+COUNT="$(printf '%s\n' "$STAGED_FILES" | wc -l | tr -d ' ')"
+echo "✅ pre-commit 통과: ${COUNT}개 파일 점검 완료"
+exit 0

.prettierignore

@@ -0,0 +1,7 @@
+node_modules
+.next
+out
+dist
+coverage
+.turbo
+public/generated

.prettierrc.json

@@ -0,0 +1,12 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "proseWrap": "preserve"
+}

README.md

@@ -73,7 +73,6 @@ develop에 머지된 기능이 잘 작동하는지 점검한 이후에 main 브
 ### 2. 협업 과정
 
 1. **Feature 브랜치 생성 및 개발**
-
    - 로컬에서 `develop` 브랜치를 기준으로 Feature 브랜치를 생성합니다.
 
    ```bash
@@ -83,7 +82,6 @@ develop에 머지된 기능이 잘 작동하는지 점검한 이후에 main 브
    - 기능 개발이 끝났다면 반드시 커밋을 완료합니다. (아래 [커밋 컨벤션](#6-커밋-컨벤션)을 꼭 확인해 주세요!)
 
 2. **푸쉬 & PR 생성 (기능 개발 점검용)**
-
    - 기능 개발이 끝난 Feature 브랜치를 원격 저장소에 푸쉬합니다.
 
    ```bash
@@ -111,12 +109,10 @@ develop에 머지된 기능이 잘 작동하는지 점검한 이후에 main 브
 ```
 
 3. **Squash Merge**
-
    - PR을 본인이 직접 **Squash Merge** 합니다.
    - 머지된 Feature 브랜치는 자동 삭제됩니다.
 
 4. **develop 점검 → main 배포 (배포 점검용)**
-
    - `develop`에 머지된 기능이 정상 동작하는지 점검합니다.
    - 문제가 없다면 `main` 브랜치로 머지하여 배포합니다.
    - 이때 PR을 생성하고 아래 템플릿을 채워주세요.
@@ -136,7 +132,6 @@ develop에 머지된 기능이 잘 작동하는지 점검한 이후에 main 브
 ```
 
 5. **배포 후 로컬 최신화 & 브랜치 정리**
-
    - 배포 점검이 완료되면 로컬 `develop`을 최신화합니다.
 
    ```bash
@@ -193,7 +188,6 @@ Refactor/dashboard-layout
 
 - **jira-key**: 해당 작업 이슈 키 (예: CDP-1)
 - **type** (모두 소문자):
-
   - feat ✨: 새로운 기능 추가
   - fix 🐛: 버그 수정
   - refactor 🔨: 코드 리팩토링 (기능 변화 없음)

commitlint.config.cjs

@@ -0,0 +1,22 @@
+/** commitlint.config.cjs */
+module.exports = {
+  extends: ["@commitlint/config-conventional"],
+  parserPreset: {
+    parserOpts: {
+      // CDP-123 chore⚙️(scope): subject
+      headerPattern:
+        /^(CDP-\d+)\s(feat✨|fix🐛|refactor🔨|style🎨|chore⚙️|docs📝|test🧪)\(([^)]+)\):\s(.+)$/,
+      headerCorrespondence: ["ticket", "type", "scope", "subject"],
+    },
+  },
+  rules: {
+    "type-enum": [
+      2,
+      "always",
+      ["feat✨", "fix🐛", "refactor🔨", "style🎨", "chore⚙️", "docs📝", "test🧪"],
+    ],
+    "scope-empty": [2, "never"],
+    "subject-empty": [2, "never"],
+    "header-max-length": [2, "always", 120],
+  },
+};

eslint.config.mjs

@@ -1,25 +1,21 @@
+// eslint.config.mjs
+import { FlatCompat } from "@eslint/eslintrc";
 import { dirname } from "path";
 import { fileURLToPath } from "url";
-import { FlatCompat } from "@eslint/eslintrc";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-const compat = new FlatCompat({
-  baseDirectory: __dirname,
-});
+const compat = new FlatCompat({ baseDirectory: __dirname });
+
+const config = [
+  // Next 권장 + TS + Prettier 추천(FlatCompat로 레거시 확장 변환)
+  ...compat.extends("next/core-web-vitals", "next/typescript", "plugin:prettier/recommended"),
 
-const eslintConfig = [
-  ...compat.extends("next/core-web-vitals", "next/typescript"),
+  // 무시 목록
   {
-    ignores: [
-      "node_modules/**",
-      ".next/**",
-      "out/**",
-      "build/**",
-      "next-env.d.ts",
-    ],
+    ignores: ["node_modules/**", ".next/**", "out/**", "build/**", "next-env.d.ts"],
   },
 ];
 
-export default eslintConfig;
+export default config;

package.json

@@ -7,7 +7,20 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "eslint"
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx --max-warnings=0",
+    "lint:fix": "pnpm lint --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,css,md}": [
+      "prettier --write"
+    ]
   },
   "dependencies": {
     "@fontsource/pretendard": "^5.2.5",
@@ -16,13 +29,21 @@
     "react-dom": "19.1.0"
   },
   "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
     "@eslint/eslintrc": "^3",
     "@tailwindcss/postcss": "^4",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
     "eslint-config-next": "15.5.3",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-tailwindcss": "^0.6.14",
     "tailwindcss": "^4",
     "typescript": "^5"
   }