feat: fetchWrapper 마이그레이션 및 토큰 리프레시 캐싱 구현

- 40+ actions.ts 파일을 fetchWrapper 패턴으로 마이그레이션
- 토큰 리프레시 캐싱 로직 추가 (refresh-token.ts)
- ApiErrorContext 추가로 전역 에러 처리 개선
- HR EmployeeForm 컴포넌트 개선
- 참조함(ReferenceBox) 기능 수정
- juil 테스트 URL 페이지 추가
- claudedocs 문서 업데이트

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

src/components/quotes/actions.ts

@@ -19,7 +19,7 @@
 
 'use server';
 
-import { cookies } from 'next/headers';
+import { serverFetch } from '@/lib/api/fetch-wrapper';
 import type {
   Quote,
   QuoteApiData,
@@ -30,19 +30,6 @@ import type {
 } from './types';
 import { transformApiToFrontend, transformFrontendToApi } from './types';
 
-// ===== API 헤더 생성 =====
-async function getApiHeaders(): Promise<HeadersInit> {
-  const cookieStore = await cookies();
-  const token = cookieStore.get('access_token')?.value;
-
-  return {
-    'Accept': 'application/json',
-    'Content-Type': 'application/json',
-    'Authorization': token ? `Bearer ${token}` : '',
-    'X-API-KEY': process.env.API_KEY || '',
-  };
-}
-
 // ===== 페이지네이션 타입 =====
 export interface PaginationMeta {
   currentPage: number;
@@ -57,9 +44,9 @@ export async function getQuotes(params?: QuoteListParams): Promise<{
   data: Quote[];
   pagination: PaginationMeta;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
     const searchParams = new URLSearchParams();
 
     if (params?.page) searchParams.set('page', String(params.page));
@@ -78,12 +65,29 @@ export async function getQuotes(params?: QuoteListParams): Promise<{
 
     console.log('[QuoteActions] GET quotes:', url);
 
-    const response = await fetch(url, {
+    const { response, error } = await serverFetch(url, {
       method: 'GET',
-      headers,
-      cache: 'no-store',
     });
 
+    if (error) {
+      return {
+        success: false,
+        data: [],
+        pagination: { currentPage: 1, lastPage: 1, perPage: 20, total: 0 },
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        data: [],
+        pagination: { currentPage: 1, lastPage: 1, perPage: 20, total: 0 },
+        error: '견적 목록 조회에 실패했습니다.',
+      };
+    }
+
     if (!response.ok) {
       console.warn('[QuoteActions] GET quotes error:', response.status);
       return {
@@ -142,18 +146,29 @@ export async function getQuoteById(id: string): Promise<{
   success: boolean;
   data?: Quote;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'GET',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 조회에 실패했습니다.',
+      };
+    }
 
     if (!response.ok) {
       console.error('[QuoteActions] GET quote error:', response.status);
@@ -188,21 +203,33 @@ export async function getQuoteById(id: string): Promise<{
 // ===== 견적 등록 =====
 export async function createQuote(
   data: Partial<Quote>
-): Promise<{ success: boolean; data?: Quote; error?: string }> {
+): Promise<{ success: boolean; data?: Quote; error?: string; __authError?: boolean }> {
   try {
-    const headers = await getApiHeaders();
     const apiData = transformFrontendToApi(data);
 
     console.log('[QuoteActions] POST quote request:', apiData);
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(apiData),
-      }
-    );
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes`;
+
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+      body: JSON.stringify(apiData),
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 등록에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] POST quote response:', result);
@@ -231,21 +258,33 @@ export async function createQuote(
 export async function updateQuote(
   id: string,
   data: Partial<Quote>
-): Promise<{ success: boolean; data?: Quote; error?: string }> {
+): Promise<{ success: boolean; data?: Quote; error?: string; __authError?: boolean }> {
   try {
-    const headers = await getApiHeaders();
     const apiData = transformFrontendToApi(data);
 
     console.log('[QuoteActions] PUT quote request:', apiData);
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}`,
-      {
-        method: 'PUT',
-        headers,
-        body: JSON.stringify(apiData),
-      }
-    );
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}`;
+
+    const { response, error } = await serverFetch(url, {
+      method: 'PUT',
+      body: JSON.stringify(apiData),
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 수정에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] PUT quote response:', result);
@@ -271,17 +310,28 @@ export async function updateQuote(
 }
 
 // ===== 견적 삭제 =====
-export async function deleteQuote(id: string): Promise<{ success: boolean; error?: string }> {
+export async function deleteQuote(id: string): Promise<{ success: boolean; error?: string; __authError?: boolean }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}`,
-      {
-        method: 'DELETE',
-        headers,
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'DELETE',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 삭제에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] DELETE quote response:', result);
@@ -304,18 +354,29 @@ export async function deleteQuote(id: string): Promise<{ success: boolean; error
 }
 
 // ===== 견적 일괄 삭제 =====
-export async function bulkDeleteQuotes(ids: string[]): Promise<{ success: boolean; error?: string }> {
+export async function bulkDeleteQuotes(ids: string[]): Promise<{ success: boolean; error?: string; __authError?: boolean }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/bulk`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/bulk`,
-      {
-        method: 'DELETE',
-        headers,
-        body: JSON.stringify({ ids: ids.map(id => parseInt(id, 10)) }),
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'DELETE',
+      body: JSON.stringify({ ids: ids.map(id => parseInt(id, 10)) }),
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 일괄 삭제에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] BULK DELETE quotes response:', result);
@@ -342,17 +403,29 @@ export async function finalizeQuote(id: string): Promise<{
   success: boolean;
   data?: Quote;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/finalize`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/finalize`,
-      {
-        method: 'POST',
-        headers,
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 확정에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] POST finalize response:', result);
@@ -382,17 +455,29 @@ export async function cancelFinalizeQuote(id: string): Promise<{
   success: boolean;
   data?: Quote;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/cancel-finalize`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/cancel-finalize`,
-      {
-        method: 'POST',
-        headers,
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적 확정 취소에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] POST cancel-finalize response:', result);
@@ -423,17 +508,29 @@ export async function convertQuoteToOrder(id: string): Promise<{
   data?: Quote;
   orderId?: string;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/convert`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/convert`,
-      {
-        method: 'POST',
-        headers,
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '수주 전환에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] POST convert response:', result);
@@ -464,18 +561,29 @@ export async function getQuoteNumberPreview(): Promise<{
   success: boolean;
   data?: string;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/number/preview`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/number/preview`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'GET',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '견적번호 미리보기에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
 
@@ -504,17 +612,29 @@ export async function generateQuotePdf(id: string): Promise<{
   success: boolean;
   data?: Blob;
   error?: string;
+  __authError?: boolean;
 }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/pdf`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/pdf`,
-      {
-        method: 'POST',
-        headers,
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: 'PDF 생성에 실패했습니다.',
+      };
+    }
 
     if (!response.ok) {
       const result = await response.json().catch(() => ({}));
@@ -542,18 +662,29 @@ export async function generateQuotePdf(id: string): Promise<{
 export async function sendQuoteEmail(
   id: string,
   emailData: { email: string; subject?: string; message?: string }
-): Promise<{ success: boolean; error?: string }> {
+): Promise<{ success: boolean; error?: string; __authError?: boolean }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/send/email`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/send/email`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(emailData),
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+      body: JSON.stringify(emailData),
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '이메일 발송에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] POST send email response:', result);
@@ -579,18 +710,29 @@ export async function sendQuoteEmail(
 export async function sendQuoteKakao(
   id: string,
   kakaoData: { phone: string; templateId?: string }
-): Promise<{ success: boolean; error?: string }> {
+): Promise<{ success: boolean; error?: string; __authError?: boolean }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/send/kakao`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/quotes/${id}/send/kakao`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(kakaoData),
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+      body: JSON.stringify(kakaoData),
+    });
+
+    if (error) {
+      return {
+        success: false,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        error: '카카오 발송에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
     console.log('[QuoteActions] POST send kakao response:', result);
@@ -630,6 +772,7 @@ export async function getQuotesSummary(params?: {
     conversionRate: number;
   };
   error?: string;
+  __authError?: boolean;
 }> {
   try {
     // 목록 조회를 통해 통계 계산 (별도 API 없는 경우)
@@ -643,6 +786,7 @@ export async function getQuotesSummary(params?: {
       return {
         success: false,
         error: listResult.error,
+        __authError: listResult.__authError,
       };
     }