refactor(WEB): API 유틸 분리, 불필요 코드 정리 및 프로젝트 규칙 업데이트

- executePaginatedAction, buildApiUrl 유틸 모듈 분리
- QuoteCalculationReport, demoStore, export.ts 불필요 코드 삭제
- CLAUDE.md에 Zod 스키마 검증 및 Server Action 공통 유틸 규칙 추가
- package.json 의존성 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

claudedocs/[PLAN-2025-02-10] frontend-improvement-roadmap.md

@@ -53,6 +53,7 @@
 | 항목 | 상태 | 날짜 |
 |------|------|------|
 | Phase 1: 공통 훅 추출 (executeServerAction 등) | ✅ 완료 | 이전 세션 |
+| 중복 코드 공통화 (buildApiUrl + executePaginatedAction) | ✅ 완료 | 2026-02-11 |
 | Phase 3: 공용 유틸 추출 (PaginatedApiResponse 등) | ✅ 완료 | 이전 세션 |
 | Phase 4: SearchableSelectionModal 공통화 | ✅ 완료 | 이전 세션 |
 | Phase 5: any 21건 + memo 3개 정리 | ✅ 완료 | 이전 세션 |

claudedocs/_index.md

@@ -149,6 +149,44 @@ export const remove = service.remove;
 
 **미전환 사유**: 84개 중 전환 가능 15~20개, 작업 2~4시간 대비 기능 변화 없음. 시간 대비 효율 낮음
 
+### Server Action 공통 유틸리티 — 신규 코드 적용 규칙 (2026-02-11)
+
+**결정**: 기존 actions.ts 마이그레이션 없음. **신규 actions.ts에만 `buildApiUrl` + `executePaginatedAction` 적용**
+
+**배경**:
+- 89개 actions.ts 중 43개에서 동일한 URLSearchParams 조건부 `.set()` 패턴 반복 (326+ 건)
+- 50+ 파일에서 `current_page → currentPage` 수동 변환 반복
+- `toPaginationMeta`가 `src/lib/api/types.ts`에 존재하나 import 0건
+
+**생성된 유틸리티**:
+1. `src/lib/api/query-params.ts` — `buildQueryParams()`, `buildApiUrl()`: URLSearchParams 보일러플레이트 제거
+2. `src/lib/api/execute-paginated-action.ts` — `executePaginatedAction()`: 페이지네이션 조회 패턴 통합 (내부에서 `toPaginationMeta` 사용)
+
+**효과**:
+- 페이지네이션 조회 코드: ~20줄 → ~5줄
+- `DEFAULT_PAGINATION` 중앙화 (`execute-paginated-action.ts` 내부)
+- `toPaginationMeta` 자동 활용 (직접 import 불필요)
+
+**미적용 사유**: 기존 89개 actions.ts는 정상 동작 중. 전면 전환 비용 >> 이득
+
+### Zod 스키마 검증 — 신규 폼 적용 규칙 (2026-02-11)
+
+**결정**: 기존 폼은 건드리지 않음. **신규 폼에만 Zod + zodResolver 적용**
+
+**설치 상태**: `zod@^4.1.12`, `@hookform/resolvers@^5.2.2` — 이미 설치됨
+
+**효과**:
+1. 스키마 하나로 **타입 추론 + 런타임 검증** 동시 해결 (`z.infer<typeof schema>`)
+2. 별도 `interface` 중복 정의 불필요
+3. 신규 코드에서 `as` 캐스트 자연 감소 (D-2 개선 효과)
+
+**규칙**:
+- 신규 폼 → `zodResolver(schema)` 사용 필수 (CLAUDE.md에 패턴 명시)
+- 기존 `rules={{ required: true }}` 패턴 폼 → 마이그레이션 불필요
+- 단순 1~2 필드 인라인 폼 → Zod 불필요 (오버엔지니어링)
+
+**미적용 사유**: 기존 폼 수십 개를 전면 전환하는 비용 >> 이득. 신규 코드에서 점진적 확산
+
 ---
 
 ## 폴더 구조