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/approval/ReferenceBox/actions.ts

@@ -9,8 +9,8 @@
 
 'use server';
 
-import { cookies } from 'next/headers';
-import type { ReferenceRecord, ApprovalType, DocumentStatus, ReadStatus } from './types';
+import { serverFetch } from '@/lib/api/fetch-wrapper';
+import type { ReferenceRecord, ApprovalType, DocumentStatus } from './types';
 
 // ============================================
 // API 응답 타입 정의
@@ -72,21 +72,6 @@ interface ReferenceStepApiData {
 // 헬퍼 함수
 // ============================================
 
-/**
- * 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 || '',
-  };
-}
-
 /**
  * API 상태 → 프론트엔드 상태 변환
  */
@@ -156,7 +141,6 @@ export async function getReferences(params?: {
   sort_dir?: 'asc' | 'desc';
 }): Promise<{ data: ReferenceRecord[]; total: number; lastPage: number }> {
   try {
-    const headers = await getApiHeaders();
     const searchParams = new URLSearchParams();
 
     if (params?.page) searchParams.set('page', String(params.page));
@@ -173,12 +157,16 @@ export async function getReferences(params?: {
 
     const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/approvals/reference?${searchParams.toString()}`;
 
-    const response = await fetch(url, {
+    const { response, error } = await serverFetch(url, {
       method: 'GET',
-      headers,
-      cache: 'no-store',
     });
 
+    // serverFetch handles 401 with redirect, so we just check for other errors
+    if (error || !response) {
+      console.error('[ReferenceBoxActions] GET reference error:', error?.message);
+      return { data: [], total: 0, lastPage: 1 };
+    }
+
     if (!response.ok) {
       console.error('[ReferenceBoxActions] GET reference error:', response.status);
       return { data: [], total: 0, lastPage: 1 };
@@ -228,16 +216,20 @@ export async function getReferenceSummary(): Promise<{ all: number; read: number
  */
 export async function markAsRead(id: string): Promise<{ success: boolean; error?: string }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/approvals/${id}/read`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/approvals/${id}/read`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({}),
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+      body: JSON.stringify({}),
+    });
+
+    // serverFetch handles 401 with redirect
+    if (error || !response) {
+      return {
+        success: false,
+        error: error?.message || '열람 처리에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();
 
@@ -263,16 +255,20 @@ export async function markAsRead(id: string): Promise<{ success: boolean; error?
  */
 export async function markAsUnread(id: string): Promise<{ success: boolean; error?: string }> {
   try {
-    const headers = await getApiHeaders();
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/v1/approvals/${id}/unread`;
 
-    const response = await fetch(
-      `${process.env.NEXT_PUBLIC_API_URL}/api/v1/approvals/${id}/unread`,
-      {
-        method: 'POST',
-        headers,
-        body: JSON.stringify({}),
-      }
-    );
+    const { response, error } = await serverFetch(url, {
+      method: 'POST',
+      body: JSON.stringify({}),
+    });
+
+    // serverFetch handles 401 with redirect
+    if (error || !response) {
+      return {
+        success: false,
+        error: error?.message || '미열람 처리에 실패했습니다.',
+      };
+    }
 
     const result = await response.json();