chore: DX 도구 도입 및 CI 강화

.github/workflows/deploy.yml

@@ -36,10 +36,20 @@ jobs:
           yarn -v || true
           (YARN_ENABLE_IMMUTABLE_INSTALLS=1 yarn install --immutable) || yarn install --frozen-lockfile
 
-      - name: Lint & Build
+      - name: GraphQL codegen
+        run: yarn graphql:codegen
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Lint
+        run: yarn lint
+
+      - name: Test
+        run: yarn test
+
+      - name: Build
         run: |
-          yarn lint
-          yarn graphql:codegen
           yarn graphql:docs
           yarn build
 

.github/workflows/pr-check.yml

@@ -0,0 +1,94 @@
+name: PR Check
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pr-check-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js (24.x) & Yarn cache
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24.x"
+          cache: "yarn"
+
+      - name: Install dependencies
+        run: |
+          corepack enable
+          yarn install --immutable
+
+      - name: GraphQL codegen
+        run: yarn graphql:codegen
+
+      - name: Type check
+        run: npx tsc --noEmit
+
+      - name: Lint
+        run: yarn lint
+
+      - name: Test with coverage
+        run: yarn test:cov
+
+      - name: Build
+        run: |
+          yarn graphql:docs
+          yarn build
+
+  coverage-report:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      pull-requests: write
+      checks: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js (24.x) & Yarn cache
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24.x"
+          cache: "yarn"
+
+      - name: Install dependencies
+        run: |
+          corepack enable
+          yarn install --immutable
+
+      - name: Coverage Report
+        uses: ArtiomTr/jest-coverage-report-action@v2
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          test-script: yarn jest --coverage --ci
+          skip-step: install
+
+  pr-title:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    steps:
+      - name: Validate PR title
+        uses: amannn/action-semantic-pull-request@v5
+        with:
+          subjectPattern: ^.+$
+          subjectPatternError: |
+            PR 제목이 Conventional Commits 형식이 아닙니다.
+            예: "feat: 새 기능 추가", "fix: 버그 수정"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.husky/commit-msg

@@ -0,0 +1 @@
+yarn commitlint --edit $1

.husky/pre-commit

@@ -0,0 +1 @@
+yarn lint-staged

commitlint.config.mjs

@@ -0,0 +1,11 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    // 한국어 커밋 메시지를 허용하기 위해 subject 대소문자 규칙 비활성화
+    'subject-case': [0],
+    // 본문 최대 줄 길이 완화 (Co-Authored-By 등 긴 줄 허용)
+    'body-max-line-length': [0],
+    // footer 최대 줄 길이 완화
+    'footer-max-line-length': [0],
+  },
+};

package.json

@@ -24,7 +24,8 @@
     "prisma:migrate:deploy": "prisma migrate deploy",
     "prisma:studio": "prisma studio",
     "graphql:codegen": "graphql-codegen --config codegen.yml",
-    "graphql:docs": "spectaql -c spectaql.yml"
+    "graphql:docs": "spectaql -c spectaql.yml",
+    "prepare": "husky"
   },
   "dependencies": {
     "@apollo/server": "^5.2.0",
@@ -57,6 +58,8 @@
     "winston": "^3.19.0"
   },
   "devDependencies": {
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
     "@eslint/eslintrc": "^3.2.0",
     "@eslint/js": "^9.18.0",
     "@graphql-codegen/cli": "^6.1.1",
@@ -79,8 +82,10 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.2.2",
     "globals": "^16.0.0",
+    "husky": "^9.1.7",
     "jest": "^29",
     "langsmith": "^0.5.7",
+    "lint-staged": "^16.4.0",
     "openai": "^6.27.0",
     "prettier": "^3.4.2",
     "prisma": "^6.2.0",
@@ -107,13 +112,33 @@
       "^.+\\.(t|j)s$": "ts-jest"
     },
     "collectCoverageFrom": [
-      "**/*.(t|j)s"
+      "**/*.(t|j)s",
+      "!**/index.ts",
+      "!**/main.ts",
+      "!**/*.module.ts",
+      "!**/*.d.ts",
+      "!**/graphql/graphql.types.ts",
+      "!**/config/**"
     ],
+    "coverageThreshold": {
+      "global": {
+        "statements": 43,
+        "branches": 33,
+        "functions": 30,
+        "lines": 43
+      }
+    },
     "coverageDirectory": "../coverage",
     "testEnvironment": "node",
     "moduleNameMapper": {
       "^@/(.*)$": "<rootDir>/$1"
     }
   },
+  "lint-staged": {
+    "*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  },
   "packageManager": "yarn@4.9.4"
 }

src/features/seller/services/seller-conversation.service.spec.ts

@@ -111,7 +111,9 @@ describe('SellerConversationService', () => {
 
       expect(result.id).toBe('77');
       expect(result.bodyText).toBe('테스트 메시지');
-      expect(conversationRepo.createSellerConversationMessage).toHaveBeenCalled();
+      expect(
+        conversationRepo.createSellerConversationMessage,
+      ).toHaveBeenCalled();
       expect(repo.createAuditLog).toHaveBeenCalled();
     });
 

src/global/graphql/scalars/date-time.scalar.ts

@@ -7,11 +7,14 @@
  * ISO DateTime 스칼라
  */
 @Scalar('DateTime', () => Date)
 export class DateTimeScalar implements CustomScalar<string, Date> {
   /**
    * 클라이언트 입력 값을 Date로 변환한다.
    */
-  parseValue(value: string): Date {
+  parseValue(value: unknown): Date {
+    if (typeof value !== 'string') {
+      throw new TypeError('Invalid DateTime value.');
+    }
     const date = new Date(value);
     if (Number.isNaN(date.getTime())) {
       throw new TypeError('Invalid DateTime value.');

tsconfig.json

@@ -19,10 +19,8 @@
     "types": ["node", "jest"],
     "incremental": true,
     "skipLibCheck": true,
-    "strictNullChecks": true,
+    "strict": true,
     "forceConsistentCasingInFileNames": true,
-    "noImplicitAny": false,
-    "strictBindCallApply": false,
-    "noFallthroughCasesInSwitch": false
+    "noFallthroughCasesInSwitch": true
   }
 }