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>
2025-12-30 17:00:18 +09:00
parent 0e5307f7a3
commit d38b1242d7
82 changed files with 7434 additions and 4775 deletions
--- a/src/components/material/ReceivingManagement/actions.ts
+++ b/src/components/material/ReceivingManagement/actions.ts
@@ -13,7 +13,7 @@

 'use server';

-import { cookies } from 'next/headers';
+import { serverFetch } from '@/lib/api/fetch-wrapper';
 import type {
  ReceivingItem,
  ReceivingDetail,
@@ -146,19 +146,6 @@ function transformProcessDataToApi(
  };
 }

-// ===== 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 || '',
-  };
-}
-
 // ===== 페이지네이션 타입 =====
 interface PaginationMeta {
  currentPage: number;
@@ -180,9 +167,9 @@ export async function getReceivings(params?: {
  data: ReceivingItem[];
  pagination: PaginationMeta;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
    const searchParams = new URLSearchParams();

    if (params?.page) searchParams.set('page', String(params.page));
@@ -197,27 +184,33 @@ export async function getReceivings(params?: {
    const queryString = searchParams.toString();
    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings${queryString ? `?${queryString}` : ''}`;

-    console.log('[ReceivingActions] GET receivings:', url);
-
-    const response = await fetch(url, {
+    const { response, error } = await serverFetch(url, {
      method: 'GET',
-      headers,
      cache: 'no-store',
    });

-    if (!response.ok) {
-      console.warn('[ReceivingActions] GET receivings error:', response.status);
+    if (error) {
      return {
        success: false,
        data: [],
        pagination: { currentPage: 1, lastPage: 1, perPage: 20, total: 0 },
-        error: `API 오류: ${response.status}`,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        data: [],
+        pagination: { currentPage: 1, lastPage: 1, perPage: 20, total: 0 },
+        error: '입고 목록 조회에 실패했습니다.',
      };
    }

    const result = await response.json();

-    if (!result.success) {
+    if (!response.ok || !result.success) {
      return {
        success: false,
        data: [],
@@ -262,46 +255,32 @@ export async function getReceivingStats(): Promise<{
  success: boolean;
  data?: ReceivingStats;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings/stats`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
+      { method: 'GET', cache: 'no-store' }
    );

-    if (!response.ok) {
-      console.warn('[ReceivingActions] GET stats error:', response.status);
-      return {
-        success: false,
-        error: `API 오류: ${response.status}`,
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
+    }
+
+    if (!response) {
+      return { success: false, error: '입고 통계 조회에 실패했습니다.' };
    }

    const result = await response.json();

-    if (!result.success || !result.data) {
-      return {
-        success: false,
-        error: result.message || '입고 통계 조회에 실패했습니다.',
-      };
+    if (!response.ok || !result.success || !result.data) {
+      return { success: false, error: result.message || '입고 통계 조회에 실패했습니다.' };
    }

-    return {
-      success: true,
-      data: transformApiToStats(result.data),
-    };
+    return { success: true, data: transformApiToStats(result.data) };
  } catch (error) {
    console.error('[ReceivingActions] getReceivingStats error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

@@ -310,88 +289,65 @@ export async function getReceivingById(id: string): Promise<{
  success: boolean;
  data?: ReceivingDetail;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings/${id}`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
+      { method: 'GET', cache: 'no-store' }
    );

-    if (!response.ok) {
-      console.error('[ReceivingActions] GET receiving error:', response.status);
-      return {
-        success: false,
-        error: `API 오류: ${response.status}`,
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
+    }
+
+    if (!response) {
+      return { success: false, error: '입고 조회에 실패했습니다.' };
    }

    const result = await response.json();

-    if (!result.success || !result.data) {
-      return {
-        success: false,
-        error: result.message || '입고 조회에 실패했습니다.',
-      };
+    if (!response.ok || !result.success || !result.data) {
+      return { success: false, error: result.message || '입고 조회에 실패했습니다.' };
    }

-    return {
-      success: true,
-      data: transformApiToDetail(result.data),
-    };
+    return { success: true, data: transformApiToDetail(result.data) };
  } catch (error) {
    console.error('[ReceivingActions] getReceivingById error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

 // ===== 입고 등록 =====
 export async function createReceiving(
  data: Partial<ReceivingDetail>
-): Promise<{ success: boolean; data?: ReceivingDetail; error?: string }> {
+): Promise<{ success: boolean; data?: ReceivingDetail; error?: string; __authError?: boolean }> {
  try {
-    const headers = await getApiHeaders();
    const apiData = transformFrontendToApi(data);

-    console.log('[ReceivingActions] POST receiving request:', apiData);
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(apiData),
-      }
+      { method: 'POST', body: JSON.stringify(apiData) }
    );

-    const result = await response.json();
-    console.log('[ReceivingActions] POST receiving response:', result);
-
-    if (!response.ok || !result.success) {
-      return {
-        success: false,
-        error: result.message || '입고 등록에 실패했습니다.',
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
    }

-    return {
-      success: true,
-      data: transformApiToDetail(result.data),
-    };
+    if (!response) {
+      return { success: false, error: '입고 등록에 실패했습니다.' };
+    }
+
+    const result = await response.json();
+
+    if (!response.ok || !result.success) {
+      return { success: false, error: result.message || '입고 등록에 실패했습니다.' };
+    }
+
+    return { success: true, data: transformApiToDetail(result.data) };
  } catch (error) {
    console.error('[ReceivingActions] createReceiving error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

@@ -399,77 +355,64 @@ export async function createReceiving(
 export async function updateReceiving(
  id: string,
  data: Partial<ReceivingDetail>
-): Promise<{ success: boolean; data?: ReceivingDetail; error?: string }> {
+): Promise<{ success: boolean; data?: ReceivingDetail; error?: string; __authError?: boolean }> {
  try {
-    const headers = await getApiHeaders();
    const apiData = transformFrontendToApi(data);

-    console.log('[ReceivingActions] PUT receiving request:', apiData);
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings/${id}`,
-      {
-        method: 'PUT',
-        headers,
-        body: JSON.stringify(apiData),
-      }
+      { method: 'PUT', body: JSON.stringify(apiData) }
    );

-    const result = await response.json();
-    console.log('[ReceivingActions] PUT receiving response:', result);
-
-    if (!response.ok || !result.success) {
-      return {
-        success: false,
-        error: result.message || '입고 수정에 실패했습니다.',
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
    }

-    return {
-      success: true,
-      data: transformApiToDetail(result.data),
-    };
+    if (!response) {
+      return { success: false, error: '입고 수정에 실패했습니다.' };
+    }
+
+    const result = await response.json();
+
+    if (!response.ok || !result.success) {
+      return { success: false, error: result.message || '입고 수정에 실패했습니다.' };
+    }
+
+    return { success: true, data: transformApiToDetail(result.data) };
  } catch (error) {
    console.error('[ReceivingActions] updateReceiving error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

 // ===== 입고 삭제 =====
 export async function deleteReceiving(
  id: string
-): Promise<{ success: boolean; error?: string }> {
+): Promise<{ success: boolean; error?: string; __authError?: boolean }> {
  try {
-    const headers = await getApiHeaders();
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings/${id}`,
-      {
-        method: 'DELETE',
-        headers,
-      }
+      { 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('[ReceivingActions] DELETE receiving response:', result);

    if (!response.ok || !result.success) {
-      return {
-        success: false,
-        error: result.message || '입고 삭제에 실패했습니다.',
-      };
+      return { success: false, error: result.message || '입고 삭제에 실패했습니다.' };
    }

    return { success: true };
  } catch (error) {
    console.error('[ReceivingActions] deleteReceiving error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

@@ -477,41 +420,32 @@ export async function deleteReceiving(
 export async function processReceiving(
  id: string,
  data: ReceivingProcessFormData
-): Promise<{ success: boolean; data?: ReceivingDetail; error?: string }> {
+): Promise<{ success: boolean; data?: ReceivingDetail; error?: string; __authError?: boolean }> {
  try {
-    const headers = await getApiHeaders();
    const apiData = transformProcessDataToApi(data);

-    console.log('[ReceivingActions] POST process request:', apiData);
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/receivings/${id}/process`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(apiData),
-      }
+      { method: 'POST', body: JSON.stringify(apiData) }
    );

-    const result = await response.json();
-    console.log('[ReceivingActions] POST process response:', result);
-
-    if (!response.ok || !result.success) {
-      return {
-        success: false,
-        error: result.message || '입고처리에 실패했습니다.',
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
    }

-    return {
-      success: true,
-      data: transformApiToDetail(result.data),
-    };
+    if (!response) {
+      return { success: false, error: '입고처리에 실패했습니다.' };
+    }
+
+    const result = await response.json();
+
+    if (!response.ok || !result.success) {
+      return { success: false, error: result.message || '입고처리에 실패했습니다.' };
+    }
+
+    return { success: true, data: transformApiToDetail(result.data) };
  } catch (error) {
    console.error('[ReceivingActions] processReceiving error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
-}
+}
--- a/src/components/material/StockStatus/actions.ts
+++ b/src/components/material/StockStatus/actions.ts
@@ -10,7 +10,7 @@

 'use server';

-import { cookies } from 'next/headers';
+import { serverFetch } from '@/lib/api/fetch-wrapper';
 import type {
  StockItem,
  StockDetail,
@@ -156,18 +156,6 @@ function transformApiToStats(data: StockApiStatsResponse): StockStats {
  };
 }

-// ===== 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 || '',
-  };
-}

 // ===== 페이지네이션 타입 =====
 interface PaginationMeta {
@@ -192,9 +180,9 @@ export async function getStocks(params?: {
  data: StockItem[];
  pagination: PaginationMeta;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
    const searchParams = new URLSearchParams();

    if (params?.page) searchParams.set('page', String(params.page));
@@ -213,27 +201,33 @@ export async function getStocks(params?: {
    const queryString = searchParams.toString();
    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/stocks${queryString ? `?${queryString}` : ''}`;

-    console.log('[StockActions] GET stocks:', url);
-
-    const response = await fetch(url, {
+    const { response, error } = await serverFetch(url, {
      method: 'GET',
-      headers,
      cache: 'no-store',
    });

-    if (!response.ok) {
-      console.warn('[StockActions] GET stocks error:', response.status);
+    if (error) {
      return {
        success: false,
        data: [],
        pagination: { currentPage: 1, lastPage: 1, perPage: 20, total: 0 },
-        error: `API 오류: ${response.status}`,
+        error: error.message,
+        __authError: error.code === 'UNAUTHORIZED',
+      };
+    }
+
+    if (!response) {
+      return {
+        success: false,
+        data: [],
+        pagination: { currentPage: 1, lastPage: 1, perPage: 20, total: 0 },
+        error: '재고 목록 조회에 실패했습니다.',
      };
    }

    const result = await response.json();

-    if (!result.success) {
+    if (!response.ok || !result.success) {
      return {
        success: false,
        data: [],
@@ -278,46 +272,32 @@ export async function getStockStats(): Promise<{
  success: boolean;
  data?: StockStats;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/stocks/stats`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
+      { method: 'GET', cache: 'no-store' }
    );

-    if (!response.ok) {
-      console.warn('[StockActions] GET stats error:', response.status);
-      return {
-        success: false,
-        error: `API 오류: ${response.status}`,
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
+    }
+
+    if (!response) {
+      return { success: false, error: '재고 통계 조회에 실패했습니다.' };
    }

    const result = await response.json();

-    if (!result.success || !result.data) {
-      return {
-        success: false,
-        error: result.message || '재고 통계 조회에 실패했습니다.',
-      };
+    if (!response.ok || !result.success || !result.data) {
+      return { success: false, error: result.message || '재고 통계 조회에 실패했습니다.' };
    }

-    return {
-      success: true,
-      data: transformApiToStats(result.data),
-    };
+    return { success: true, data: transformApiToStats(result.data) };
  } catch (error) {
    console.error('[StockActions] getStockStats error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

@@ -326,46 +306,32 @@ export async function getStockStatsByType(): Promise<{
  success: boolean;
  data?: StockApiStatsByTypeResponse;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/stocks/stats-by-type`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
+      { method: 'GET', cache: 'no-store' }
    );

-    if (!response.ok) {
-      console.warn('[StockActions] GET stats-by-type error:', response.status);
-      return {
-        success: false,
-        error: `API 오류: ${response.status}`,
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
+    }
+
+    if (!response) {
+      return { success: false, error: '품목유형별 통계 조회에 실패했습니다.' };
    }

    const result = await response.json();

-    if (!result.success || !result.data) {
-      return {
-        success: false,
-        error: result.message || '품목유형별 통계 조회에 실패했습니다.',
-      };
+    if (!response.ok || !result.success || !result.data) {
+      return { success: false, error: result.message || '품목유형별 통계 조회에 실패했습니다.' };
    }

-    return {
-      success: true,
-      data: result.data,
-    };
+    return { success: true, data: result.data };
  } catch (error) {
    console.error('[StockActions] getStockStatsByType error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }

@@ -374,45 +340,31 @@ export async function getStockById(id: string): Promise<{
  success: boolean;
  data?: StockDetail;
  error?: string;
+  __authError?: boolean;
 }> {
  try {
-    const headers = await getApiHeaders();
-
-    const response = await fetch(
+    const { response, error } = await serverFetch(
      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/stocks/${id}`,
-      {
-        method: 'GET',
-        headers,
-        cache: 'no-store',
-      }
+      { method: 'GET', cache: 'no-store' }
    );

-    if (!response.ok) {
-      console.error('[StockActions] GET stock error:', response.status);
-      return {
-        success: false,
-        error: `API 오류: ${response.status}`,
-      };
+    if (error) {
+      return { success: false, error: error.message, __authError: error.code === 'UNAUTHORIZED' };
+    }
+
+    if (!response) {
+      return { success: false, error: '재고 조회에 실패했습니다.' };
    }

    const result = await response.json();

-    if (!result.success || !result.data) {
-      return {
-        success: false,
-        error: result.message || '재고 조회에 실패했습니다.',
-      };
+    if (!response.ok || !result.success || !result.data) {
+      return { success: false, error: result.message || '재고 조회에 실패했습니다.' };
    }

-    return {
-      success: true,
-      data: transformApiToDetail(result.data),
-    };
+    return { success: true, data: transformApiToDetail(result.data) };
  } catch (error) {
    console.error('[StockActions] getStockById error:', error);
-    return {
-      success: false,
-      error: '서버 오류가 발생했습니다.',
-    };
+    return { success: false, error: '서버 오류가 발생했습니다.' };
  }
 }