From e511af62d818906562e6ed463844454872b163d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Wed, 28 Jan 2026 14:07:05 +0900
Subject: [PATCH 01/12] =?UTF-8?q?fix:Labs=20=EB=A9=94=EB=89=B4=20=EB=9D=BC?=
 =?UTF-8?q?=EC=9A=B0=ED=8A=B8=20=EB=AF=B8=EC=A0=95=EC=9D=98=20=EC=98=A4?=
 =?UTF-8?q?=EB=A5=98=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- route() 호출 전 Route::has() 체크 추가
- 라우트가 없는 경우 url 또는 # 사용

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../components/sidebar/labs-menu.blade.php    | 24 +++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/resources/views/components/sidebar/labs-menu.blade.php b/resources/views/components/sidebar/labs-menu.blade.php
index cbd6e1af..97340acf 100644
--- a/resources/views/components/sidebar/labs-menu.blade.php
+++ b/resources/views/components/sidebar/labs-menu.blade.php
@@ -64,8 +64,12 @@
             <!-- S. Strategy 메뉴 -->
             <ul id="lab-panel-s" class="lab-panel space-y-1">
                 @foreach($sMenus as $menu)
+                    @php
+                        $routeName = $menu->getRouteName();
+                        $href = ($routeName && Route::has($routeName)) ? route($routeName) : ($menu->url ?: '#');
+                    @endphp
                     <li>
-                        <a href="{{ $menu->getRouteName() ? route($menu->getRouteName()) : $menu->url }}"
+                        <a href="{{ $href }}"
                            class="flex items-center gap-2 px-3 py-2 rounded-lg text-sm text-gray-600 hover:bg-gray-100 hover:text-gray-900 transition-colors"
                            title="{{ $menu->name }}">
                             <x-sidebar.menu-icon :icon="$menu->icon" class="w-4 h-4 flex-shrink-0" />
@@ -78,8 +82,12 @@ class="flex items-center gap-2 px-3 py-2 rounded-lg text-sm text-gray-600 hover:
             <!-- A. AI/Automation 메뉴 -->
             <ul id="lab-panel-a" class="lab-panel space-y-1 hidden">
                 @foreach($aMenus as $menu)
+                    @php
+                        $routeName = $menu->getRouteName();
+                        $href = ($routeName && Route::has($routeName)) ? route($routeName) : ($menu->url ?: '#');
+                    @endphp
                     <li>
-                        <a href="{{ $menu->getRouteName() ? route($menu->getRouteName()) : $menu->url }}"
+                        <a href="{{ $href }}"
                            class="flex items-center gap-2 px-3 py-2 rounded-lg text-sm text-gray-600 hover:bg-gray-100 hover:text-gray-900 transition-colors"
                            title="{{ $menu->name }}">
                             <x-sidebar.menu-icon :icon="$menu->icon" class="w-4 h-4 flex-shrink-0" />
@@ -127,8 +135,12 @@ class="flex items-center gap-2 px-3 py-2 rounded-lg text-sm text-gray-600 hover:
                     <!-- S. Strategy -->
                     <ul id="lab-flyout-panel-s" class="lab-flyout-panel space-y-0.5">
                         @foreach($sMenus as $menu)
+                            @php
+                                $routeName = $menu->getRouteName();
+                                $href = ($routeName && Route::has($routeName)) ? route($routeName) : ($menu->url ?: '#');
+                            @endphp
                             <li>
-                                <a href="{{ $menu->getRouteName() ? route($menu->getRouteName()) : $menu->url }}"
+                                <a href="{{ $href }}"
                                    class="block px-2 py-1 text-xs text-gray-600 rounded hover:bg-gray-100 hover:text-gray-900">
                                     {{ $menu->name }}
                                 </a>
@@ -139,8 +151,12 @@ class="block px-2 py-1 text-xs text-gray-600 rounded hover:bg-gray-100 hover:tex
                     <!-- A. AI/Automation -->
                     <ul id="lab-flyout-panel-a" class="lab-flyout-panel space-y-0.5 hidden">
                         @foreach($aMenus as $menu)
+                            @php
+                                $routeName = $menu->getRouteName();
+                                $href = ($routeName && Route::has($routeName)) ? route($routeName) : ($menu->url ?: '#');
+                            @endphp
                             <li>
-                                <a href="{{ $menu->getRouteName() ? route($menu->getRouteName()) : $menu->url }}"
+                                <a href="{{ $href }}"
                                    class="block px-2 py-1 text-xs text-gray-600 rounded hover:bg-gray-100 hover:text-gray-900">
                                     {{ $menu->name }}
                                 </a>

From 407c98a39132ad9859d44778ae08d71b9839970d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Wed, 28 Jan 2026 16:33:10 +0900
Subject: [PATCH 02/12] =?UTF-8?q?feat:=EC=9E=90=EB=8F=99=20=EC=9E=AC?=
 =?UTF-8?q?=EC=9D=B8=EC=A6=9D=20=EB=AF=B8=EB=93=A4=EC=9B=A8=EC=96=B4=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- AutoLoginViaRemember: 세션 만료 시 remember_token으로 자동 로그인
- HQ 소속/활성 상태 검증
- API 토큰 자동 재발급
- web 미들웨어 그룹에 등록

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 app/Http/Middleware/AutoLoginViaRemember.php | 82 ++++++++++++++++++++
 bootstrap/app.php                            |  4 +-
 2 files changed, 84 insertions(+), 2 deletions(-)
 create mode 100644 app/Http/Middleware/AutoLoginViaRemember.php

diff --git a/app/Http/Middleware/AutoLoginViaRemember.php b/app/Http/Middleware/AutoLoginViaRemember.php
new file mode 100644
index 00000000..f3ea54c1
--- /dev/null
+++ b/app/Http/Middleware/AutoLoginViaRemember.php
@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use App\Services\ApiTokenService;
+use Closure;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Log;
+use Symfony\Component\HttpFoundation\Response;
+
+class AutoLoginViaRemember
+{
+    public function __construct(
+        private readonly ApiTokenService $apiTokenService
+    ) {}
+
+    /**
+     * 세션 만료 시 remember_token으로 자동 로그인
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        // 이미 인증된 경우 통과
+        if (Auth::check()) {
+            return $next($request);
+        }
+
+        // Remember Token으로 재인증 시도
+        if (Auth::viaRemember()) {
+            $user = Auth::user();
+
+            // HQ 테넌트 소속 확인
+            if (!$user->belongsToHQ()) {
+                Auth::logout();
+                Log::info('[AutoLoginViaRemember] Non-HQ user rejected', ['user_id' => $user->id]);
+                return $next($request);
+            }
+
+            // 활성 상태 확인
+            if (!$user->is_active) {
+                Auth::logout();
+                Log::info('[AutoLoginViaRemember] Inactive user rejected', ['user_id' => $user->id]);
+                return $next($request);
+            }
+
+            // HQ 테넌트를 기본 선택
+            $hqTenant = $user->getHQTenant();
+            if ($hqTenant) {
+                session(['selected_tenant_id' => $hqTenant->id]);
+
+                // API 토큰 재발급
+                $this->refreshApiToken($user->id, $hqTenant->id);
+            }
+
+            Log::info('[AutoLoginViaRemember] Auto login successful', ['user_id' => $user->id]);
+        }
+
+        return $next($request);
+    }
+
+    /**
+     * API 토큰 재발급
+     */
+    private function refreshApiToken(int $userId, int $tenantId): void
+    {
+        try {
+            $result = $this->apiTokenService->exchangeToken($userId, $tenantId);
+
+            if ($result['success']) {
+                $this->apiTokenService->storeTokenInSession(
+                    $result['data']['access_token'],
+                    $result['data']['expires_in']
+                );
+            }
+        } catch (\Exception $e) {
+            Log::warning('[AutoLoginViaRemember] API token refresh failed', [
+                'user_id' => $userId,
+                'error' => $e->getMessage(),
+            ]);
+        }
+    }
+}
\ No newline at end of file
diff --git a/bootstrap/app.php b/bootstrap/app.php
index afb18a8f..f65416b7 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -26,9 +26,9 @@
             'menu-sync/*',
         ]);
 
-        // auth 미들웨어 그룹에 HQ 검증 추가
+        // web 미들웨어 그룹에 자동 재인증 추가
         $middleware->appendToGroup('web', [
-            // 기본 web 미들웨어에는 추가하지 않음 (auth에서만 적용)
+            \App\Http\Middleware\AutoLoginViaRemember::class,
         ]);
     })
     ->withExceptions(function (Exceptions $exceptions): void {

From d1fad7039585121a662d0ec809b261d56785405c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Wed, 28 Jan 2026 17:47:14 +0900
Subject: [PATCH 03/12] =?UTF-8?q?refactor:=EB=AC=B8=EC=84=9C=ED=85=9C?=
 =?UTF-8?q?=ED=94=8C=EB=A6=BF=20=EB=B6=84=EB=A5=98=20=EB=8F=99=EC=A0=81=20?=
 =?UTF-8?q?=EC=A1=B0=ED=9A=8C=20=EB=B0=8F=20=ED=9A=8C=EC=82=AC=EC=A0=95?=
 =?UTF-8?q?=EB=B3=B4=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 분류: CommonCode → DocumentTemplate에서 group by 조회
- 분류 입력: select → input + datalist (자유입력 + 자동완성)
- 회사정보 입력 필드 제거 (tenant에서 자동 조회)
- 미리보기: tenant 회사명 자동 표시

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .../DocumentTemplateController.php            | 38 ++++++++++------
 .../views/document-templates/edit.blade.php   | 45 ++++---------------
 .../views/document-templates/index.blade.php  |  4 +-
 3 files changed, 34 insertions(+), 53 deletions(-)

diff --git a/app/Http/Controllers/DocumentTemplateController.php b/app/Http/Controllers/DocumentTemplateController.php
index 22d18f54..613402b5 100644
--- a/app/Http/Controllers/DocumentTemplateController.php
+++ b/app/Http/Controllers/DocumentTemplateController.php
@@ -3,7 +3,7 @@
 namespace App\Http\Controllers;
 
 use App\Models\DocumentTemplate;
-use App\Models\Products\CommonCode;
+use App\Models\Tenants\Tenant;
 use Illuminate\Http\Request;
 use Illuminate\View\View;
 
@@ -15,7 +15,7 @@ class DocumentTemplateController extends Controller
     public function index(Request $request): View
     {
         return view('document-templates.index', [
-            'documentTypes' => $this->getDocumentTypes(),
+            'categories' => $this->getCategories(),
         ]);
     }
 
@@ -28,7 +28,8 @@ public function create(): View
             'template' => null,
             'templateData' => null,
             'isCreate' => true,
-            'documentTypes' => $this->getDocumentTypes(),
+            'categories' => $this->getCategories(),
+            'tenant' => $this->getCurrentTenant(),
         ]);
     }
 
@@ -51,28 +52,40 @@ public function edit(int $id): View
             'template' => $template,
             'templateData' => $templateData,
             'isCreate' => false,
-            'documentTypes' => $this->getDocumentTypes(),
+            'categories' => $this->getCategories(),
+            'tenant' => $this->getCurrentTenant(),
         ]);
     }
 
     /**
-     * 문서분류 목록 조회 (글로벌 + 테넌트)
+     * 현재 선택된 테넌트 조회
      */
-    private function getDocumentTypes(): array
+    private function getCurrentTenant(): ?Tenant
     {
         $tenantId = session('selected_tenant_id');
 
-        return CommonCode::query()
+        return $tenantId ? Tenant::find($tenantId) : null;
+    }
+
+    /**
+     * 문서분류 목록 조회 (글로벌 + 테넌트, 기존 데이터에서 group by)
+     */
+    private function getCategories(): array
+    {
+        $tenantId = session('selected_tenant_id');
+
+        return DocumentTemplate::query()
             ->where(function ($query) use ($tenantId) {
                 $query->whereNull('tenant_id');
                 if ($tenantId) {
                     $query->orWhere('tenant_id', $tenantId);
                 }
             })
-            ->where('code_group', 'document_type')
-            ->where('is_active', true)
-            ->orderBy('sort_order')
-            ->pluck('name', 'code')
+            ->whereNotNull('category')
+            ->where('category', '!=', '')
+            ->distinct()
+            ->orderBy('category')
+            ->pluck('category')
             ->toArray();
     }
 
@@ -85,9 +98,6 @@ private function prepareTemplateData(DocumentTemplate $template): array
             'name' => $template->name,
             'category' => $template->category,
             'title' => $template->title,
-            'company_name' => $template->company_name,
-            'company_address' => $template->company_address,
-            'company_contact' => $template->company_contact,
             'footer_remark_label' => $template->footer_remark_label,
             'footer_judgement_label' => $template->footer_judgement_label,
             'footer_judgement_options' => $template->footer_judgement_options,
diff --git a/resources/views/document-templates/edit.blade.php b/resources/views/document-templates/edit.blade.php
index 0d3f02db..76c07866 100644
--- a/resources/views/document-templates/edit.blade.php
+++ b/resources/views/document-templates/edit.blade.php
@@ -68,12 +68,13 @@ class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none foc
             <!-- 분류 -->
             <div>
                 <label class="block text-sm font-medium text-gray-700 mb-1">분류</label>
-                <select id="category" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    <option value="">선택하세요</option>
-                    @foreach($documentTypes as $code => $name)
-                        <option value="{{ $name }}">{{ $name }}</option>
+                <input type="text" id="category" list="category-list" placeholder="분류를 입력하거나 선택하세요"
+                       class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <datalist id="category-list">
+                    @foreach($categories as $category)
+                        <option value="{{ $category }}">
                     @endforeach
-                </select>
+                </datalist>
             </div>
             <!-- 문서 제목 -->
             <div class="md:col-span-2">
@@ -81,24 +82,6 @@ class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none foc
                 <input type="text" id="title" placeholder="예: 최종 검사 성적서"
                        class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
-            <!-- 회사명 -->
-            <div>
-                <label class="block text-sm font-medium text-gray-700 mb-1">회사명</label>
-                <input type="text" id="company_name" placeholder="예: 경동기업"
-                       class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-            </div>
-            <!-- 회사 연락처 -->
-            <div>
-                <label class="block text-sm font-medium text-gray-700 mb-1">회사 연락처</label>
-                <input type="text" id="company_contact" placeholder="예: TEL: 02-0000-0000"
-                       class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-            </div>
-            <!-- 회사 주소 -->
-            <div class="md:col-span-2">
-                <label class="block text-sm font-medium text-gray-700 mb-1">회사 주소</label>
-                <input type="text" id="company_address" placeholder="예: 서울시 강남구..."
-                       class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-            </div>
             <!-- 활성 상태 -->
             <div class="flex items-center gap-2">
                 <input type="checkbox" id="is_active" checked class="w-4 h-4 text-blue-600 rounded focus:ring-blue-500">
@@ -188,9 +171,6 @@ class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none foc
         name: '',
         category: '',
         title: '',
-        company_name: '경동기업',
-        company_address: '',
-        company_contact: '',
         footer_remark_label: '비고',
         footer_judgement_label: '종합판정',
         footer_judgement_options: ['합격', '불합격', '조건부합격'],
@@ -214,9 +194,6 @@ function generateId() {
         templateState.name = loadedData.name || '';
         templateState.category = loadedData.category || '';
         templateState.title = loadedData.title || '';
-        templateState.company_name = loadedData.company_name || '';
-        templateState.company_address = loadedData.company_address || '';
-        templateState.company_contact = loadedData.company_contact || '';
         templateState.footer_remark_label = loadedData.footer_remark_label || '';
         templateState.footer_judgement_label = loadedData.footer_judgement_label || '';
         templateState.footer_judgement_options = loadedData.footer_judgement_options || [];
@@ -238,13 +215,10 @@ function initBasicFields() {
         document.getElementById('name').value = templateState.name || '';
         document.getElementById('category').value = templateState.category || '';
         document.getElementById('title').value = templateState.title || '';
-        document.getElementById('company_name').value = templateState.company_name || '';
-        document.getElementById('company_address').value = templateState.company_address || '';
-        document.getElementById('company_contact').value = templateState.company_contact || '';
         document.getElementById('is_active').checked = templateState.is_active;
 
         // 변경 이벤트 바인딩
-        ['name', 'category', 'title', 'company_name', 'company_address', 'company_contact'].forEach(field => {
+        ['name', 'category', 'title'].forEach(field => {
             document.getElementById(field).addEventListener('input', function() {
                 templateState[field] = this.value;
             });
@@ -564,9 +538,6 @@ function saveTemplate() {
             name: name,
             category: document.getElementById('category').value,
             title: document.getElementById('title').value,
-            company_name: document.getElementById('company_name').value,
-            company_address: document.getElementById('company_address').value,
-            company_contact: document.getElementById('company_contact').value,
             is_active: document.getElementById('is_active').checked,
             approval_lines: templateState.approval_lines,
             sections: templateState.sections,
@@ -618,7 +589,7 @@ function closePreviewModal() {
 
     function generatePreviewHtml() {
         const title = document.getElementById('title').value || '검사 성적서';
-        const companyName = document.getElementById('company_name').value || '회사명';
+        const companyName = '{{ $tenant?->company_name ?? "회사명" }}';
 
         return `
             <div class="bg-white p-8 border" style="font-family: 'Malgun Gothic', sans-serif;">
diff --git a/resources/views/document-templates/index.blade.php b/resources/views/document-templates/index.blade.php
index deb85370..a287fd99 100644
--- a/resources/views/document-templates/index.blade.php
+++ b/resources/views/document-templates/index.blade.php
@@ -40,8 +40,8 @@ class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none foc
             <div class="w-full sm:w-40">
                 <select name="category" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="">전체 분류</option>
-                    @foreach($documentTypes as $code => $name)
-                        <option value="{{ $name }}">{{ $name }}</option>
+                    @foreach($categories as $category)
+                        <option value="{{ $category }}">{{ $category }}</option>
                     @endforeach
                 </select>
             </div>

From c65d3f49dcad9d9c79ba7b1f19a27537218bf74a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Wed, 28 Jan 2026 21:51:23 +0900
Subject: [PATCH 04/12] =?UTF-8?q?feat:=20=EB=AC=B8=EC=84=9C=20=EA=B4=80?=
 =?UTF-8?q?=EB=A6=AC=20=EC=8B=9C=EC=8A=A4=ED=85=9C=20MNG=20=EA=B4=80?=
 =?UTF-8?q?=EB=A6=AC=EC=9E=90=20=ED=8C=A8=EB=84=90=20=EA=B5=AC=ED=98=84=20?=
 =?UTF-8?q?(Phase=202)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Document 관련 모델 4개 생성 (Document, DocumentApproval, DocumentData, DocumentAttachment)
- DocumentController 생성 (목록/생성/상세/수정 페이지)
- DocumentApiController 생성 (AJAX CRUD 처리)
- 문서 관리 뷰 3개 생성 (index, edit, show)
- 웹/API 라우트 등록

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../Api/Admin/DocumentApiController.php       | 226 +++++++++++++++++
 app/Http/Controllers/DocumentController.php   | 121 +++++++++
 app/Models/Documents/Document.php             | 178 +++++++++++++
 app/Models/Documents/DocumentApproval.php     |  94 +++++++
 app/Models/Documents/DocumentAttachment.php   |  69 +++++
 app/Models/Documents/DocumentData.php         |  47 ++++
 resources/views/documents/edit.blade.php      | 211 +++++++++++++++
 resources/views/documents/index.blade.php     | 240 ++++++++++++++++++
 resources/views/documents/show.blade.php      | 200 +++++++++++++++
 routes/api.php                                |  16 +-
 routes/web.php                                |  40 ++-
 11 files changed, 1435 insertions(+), 7 deletions(-)
 create mode 100644 app/Http/Controllers/Api/Admin/DocumentApiController.php
 create mode 100644 app/Http/Controllers/DocumentController.php
 create mode 100644 app/Models/Documents/Document.php
 create mode 100644 app/Models/Documents/DocumentApproval.php
 create mode 100644 app/Models/Documents/DocumentAttachment.php
 create mode 100644 app/Models/Documents/DocumentData.php
 create mode 100644 resources/views/documents/edit.blade.php
 create mode 100644 resources/views/documents/index.blade.php
 create mode 100644 resources/views/documents/show.blade.php

diff --git a/app/Http/Controllers/Api/Admin/DocumentApiController.php b/app/Http/Controllers/Api/Admin/DocumentApiController.php
new file mode 100644
index 00000000..149c393b
--- /dev/null
+++ b/app/Http/Controllers/Api/Admin/DocumentApiController.php
@@ -0,0 +1,226 @@
+<?php
+
+namespace App\Http\Controllers\Api\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Models\Documents\Document;
+use App\Models\Documents\DocumentData;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class DocumentApiController extends Controller
+{
+    /**
+     * 문서 목록 조회
+     */
+    public function index(Request $request): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id');
+
+        $query = Document::with(['template', 'creator'])
+            ->where('tenant_id', $tenantId)
+            ->orderBy('created_at', 'desc');
+
+        // 상태 필터
+        if ($request->filled('status')) {
+            $query->where('status', $request->status);
+        }
+
+        // 템플릿 필터
+        if ($request->filled('template_id')) {
+            $query->where('template_id', $request->template_id);
+        }
+
+        // 검색
+        if ($request->filled('search')) {
+            $search = $request->search;
+            $query->where(function ($q) use ($search) {
+                $q->where('document_no', 'like', "%{$search}%")
+                    ->orWhere('title', 'like', "%{$search}%");
+            });
+        }
+
+        $documents = $query->paginate($request->input('per_page', 15));
+
+        return response()->json($documents);
+    }
+
+    /**
+     * 문서 상세 조회
+     */
+    public function show(int $id): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id');
+
+        $document = Document::with([
+            'template.approvalLines',
+            'template.basicFields',
+            'template.sections.items',
+            'template.columns',
+            'approvals.user',
+            'data',
+            'attachments.file',
+            'creator',
+            'updater',
+        ])->where('tenant_id', $tenantId)->findOrFail($id);
+
+        return response()->json([
+            'success' => true,
+            'data' => $document,
+        ]);
+    }
+
+    /**
+     * 문서 생성
+     */
+    public function store(Request $request): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id');
+        $userId = auth()->id();
+
+        $request->validate([
+            'template_id' => 'required|exists:document_templates,id',
+            'title' => 'required|string|max:255',
+            'data' => 'nullable|array',
+            'data.*.field_key' => 'required|string',
+            'data.*.field_value' => 'nullable|string',
+        ]);
+
+        // 문서 번호 생성
+        $documentNo = $this->generateDocumentNo($tenantId, $request->template_id);
+
+        $document = Document::create([
+            'tenant_id' => $tenantId,
+            'template_id' => $request->template_id,
+            'document_no' => $documentNo,
+            'title' => $request->title,
+            'status' => Document::STATUS_DRAFT,
+            'created_by' => $userId,
+            'updated_by' => $userId,
+        ]);
+
+        // 문서 데이터 저장
+        if ($request->filled('data')) {
+            foreach ($request->data as $item) {
+                if (! empty($item['field_value'])) {
+                    DocumentData::create([
+                        'document_id' => $document->id,
+                        'field_key' => $item['field_key'],
+                        'field_value' => $item['field_value'],
+                    ]);
+                }
+            }
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => '문서가 저장되었습니다.',
+            'data' => $document->fresh(['template', 'data']),
+        ], 201);
+    }
+
+    /**
+     * 문서 수정
+     */
+    public function update(int $id, Request $request): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id');
+        $userId = auth()->id();
+
+        $document = Document::where('tenant_id', $tenantId)->findOrFail($id);
+
+        // 작성중 또는 반려 상태에서만 수정 가능
+        if (! in_array($document->status, [Document::STATUS_DRAFT, Document::STATUS_REJECTED])) {
+            return response()->json([
+                'success' => false,
+                'message' => '현재 상태에서는 수정할 수 없습니다.',
+            ], 422);
+        }
+
+        $request->validate([
+            'title' => 'sometimes|required|string|max:255',
+            'data' => 'nullable|array',
+            'data.*.field_key' => 'required|string',
+            'data.*.field_value' => 'nullable|string',
+        ]);
+
+        $document->update([
+            'title' => $request->input('title', $document->title),
+            'updated_by' => $userId,
+        ]);
+
+        // 문서 데이터 업데이트
+        if ($request->has('data')) {
+            // 기존 데이터 삭제
+            $document->data()->delete();
+
+            // 새 데이터 저장
+            foreach ($request->data as $item) {
+                if (! empty($item['field_value'])) {
+                    DocumentData::create([
+                        'document_id' => $document->id,
+                        'field_key' => $item['field_key'],
+                        'field_value' => $item['field_value'],
+                    ]);
+                }
+            }
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => '문서가 수정되었습니다.',
+            'data' => $document->fresh(['template', 'data']),
+        ]);
+    }
+
+    /**
+     * 문서 삭제 (소프트 삭제)
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id');
+
+        $document = Document::where('tenant_id', $tenantId)->findOrFail($id);
+
+        // 작성중 상태에서만 삭제 가능
+        if ($document->status !== Document::STATUS_DRAFT) {
+            return response()->json([
+                'success' => false,
+                'message' => '작성중 상태의 문서만 삭제할 수 있습니다.',
+            ], 422);
+        }
+
+        $document->delete();
+
+        return response()->json([
+            'success' => true,
+            'message' => '문서가 삭제되었습니다.',
+        ]);
+    }
+
+    /**
+     * 문서 번호 생성
+     */
+    private function generateDocumentNo(int $tenantId, int $templateId): string
+    {
+        $prefix = 'DOC';
+        $date = now()->format('Ymd');
+
+        $lastDocument = Document::where('tenant_id', $tenantId)
+            ->where('template_id', $templateId)
+            ->whereDate('created_at', now()->toDateString())
+            ->orderBy('id', 'desc')
+            ->first();
+
+        $sequence = 1;
+        if ($lastDocument) {
+            // 마지막 문서 번호에서 시퀀스 추출
+            $parts = explode('-', $lastDocument->document_no);
+            if (count($parts) >= 3) {
+                $sequence = (int) end($parts) + 1;
+            }
+        }
+
+        return sprintf('%s-%s-%04d', $prefix, $date, $sequence);
+    }
+}
diff --git a/app/Http/Controllers/DocumentController.php b/app/Http/Controllers/DocumentController.php
new file mode 100644
index 00000000..7c3db747
--- /dev/null
+++ b/app/Http/Controllers/DocumentController.php
@@ -0,0 +1,121 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Documents\Document;
+use App\Models\DocumentTemplate;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+class DocumentController extends Controller
+{
+    /**
+     * 문서 목록 페이지
+     */
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('documents.index'));
+        }
+
+        $tenantId = session('selected_tenant_id');
+
+        // 템플릿 목록 (필터용)
+        $templates = $tenantId
+            ? DocumentTemplate::where(function ($q) use ($tenantId) {
+                $q->whereNull('tenant_id')->orWhere('tenant_id', $tenantId);
+            })->where('is_active', true)->orderBy('name')->get()
+            : collect();
+
+        return view('documents.index', [
+            'templates' => $templates,
+            'statuses' => Document::STATUS_LABELS,
+        ]);
+    }
+
+    /**
+     * 문서 생성 페이지
+     */
+    public function create(Request $request): View
+    {
+        $tenantId = session('selected_tenant_id');
+        $templateId = $request->query('template_id');
+
+        // 템플릿 목록
+        $templates = $tenantId
+            ? DocumentTemplate::where(function ($q) use ($tenantId) {
+                $q->whereNull('tenant_id')->orWhere('tenant_id', $tenantId);
+            })->where('is_active', true)->orderBy('name')->get()
+            : collect();
+
+        // 선택된 템플릿
+        $template = $templateId
+            ? DocumentTemplate::with(['approvalLines', 'basicFields', 'sections.items', 'columns'])->find($templateId)
+            : null;
+
+        return view('documents.edit', [
+            'document' => null,
+            'template' => $template,
+            'templates' => $templates,
+            'isCreate' => true,
+        ]);
+    }
+
+    /**
+     * 문서 수정 페이지
+     */
+    public function edit(int $id): View
+    {
+        $tenantId = session('selected_tenant_id');
+
+        $document = Document::with([
+            'template.approvalLines',
+            'template.basicFields',
+            'template.sections.items',
+            'template.columns',
+            'approvals.user',
+            'data',
+            'attachments.file',
+            'creator',
+        ])->where('tenant_id', $tenantId)->findOrFail($id);
+
+        // 템플릿 목록 (변경용)
+        $templates = $tenantId
+            ? DocumentTemplate::where(function ($q) use ($tenantId) {
+                $q->whereNull('tenant_id')->orWhere('tenant_id', $tenantId);
+            })->where('is_active', true)->orderBy('name')->get()
+            : collect();
+
+        return view('documents.edit', [
+            'document' => $document,
+            'template' => $document->template,
+            'templates' => $templates,
+            'isCreate' => false,
+        ]);
+    }
+
+    /**
+     * 문서 상세 페이지 (읽기 전용)
+     */
+    public function show(int $id): View
+    {
+        $tenantId = session('selected_tenant_id');
+
+        $document = Document::with([
+            'template.approvalLines',
+            'template.basicFields',
+            'template.sections.items',
+            'template.columns',
+            'approvals.user',
+            'data',
+            'attachments.file',
+            'creator',
+            'updater',
+        ])->where('tenant_id', $tenantId)->findOrFail($id);
+
+        return view('documents.show', [
+            'document' => $document,
+        ]);
+    }
+}
diff --git a/app/Models/Documents/Document.php b/app/Models/Documents/Document.php
new file mode 100644
index 00000000..d6a2bb3e
--- /dev/null
+++ b/app/Models/Documents/Document.php
@@ -0,0 +1,178 @@
+<?php
+
+namespace App\Models\Documents;
+
+use App\Models\DocumentTemplate;
+use App\Models\User;
+use App\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Document extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    protected $table = 'documents';
+
+    // 상태 상수
+    public const STATUS_DRAFT = 'DRAFT';
+
+    public const STATUS_PENDING = 'PENDING';
+
+    public const STATUS_APPROVED = 'APPROVED';
+
+    public const STATUS_REJECTED = 'REJECTED';
+
+    public const STATUS_CANCELLED = 'CANCELLED';
+
+    public const STATUSES = [
+        self::STATUS_DRAFT,
+        self::STATUS_PENDING,
+        self::STATUS_APPROVED,
+        self::STATUS_REJECTED,
+        self::STATUS_CANCELLED,
+    ];
+
+    public const STATUS_LABELS = [
+        self::STATUS_DRAFT => '작성중',
+        self::STATUS_PENDING => '결재중',
+        self::STATUS_APPROVED => '승인',
+        self::STATUS_REJECTED => '반려',
+        self::STATUS_CANCELLED => '취소',
+    ];
+
+    protected $fillable = [
+        'tenant_id',
+        'template_id',
+        'document_no',
+        'title',
+        'status',
+        'linkable_type',
+        'linkable_id',
+        'submitted_at',
+        'completed_at',
+        'created_by',
+        'updated_by',
+        'deleted_by',
+    ];
+
+    protected $casts = [
+        'submitted_at' => 'datetime',
+        'completed_at' => 'datetime',
+    ];
+
+    protected $attributes = [
+        'status' => self::STATUS_DRAFT,
+    ];
+
+    // =========================================================================
+    // Relationships
+    // =========================================================================
+
+    public function template(): BelongsTo
+    {
+        return $this->belongsTo(DocumentTemplate::class, 'template_id');
+    }
+
+    public function approvals(): HasMany
+    {
+        return $this->hasMany(DocumentApproval::class)->orderBy('step');
+    }
+
+    public function data(): HasMany
+    {
+        return $this->hasMany(DocumentData::class);
+    }
+
+    public function attachments(): HasMany
+    {
+        return $this->hasMany(DocumentAttachment::class);
+    }
+
+    public function linkable(): MorphTo
+    {
+        return $this->morphTo();
+    }
+
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    public function updater(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'updated_by');
+    }
+
+    // =========================================================================
+    // Accessors
+    // =========================================================================
+
+    public function getStatusLabelAttribute(): string
+    {
+        return self::STATUS_LABELS[$this->status] ?? $this->status;
+    }
+
+    public function getStatusColorAttribute(): string
+    {
+        return match ($this->status) {
+            self::STATUS_DRAFT => 'gray',
+            self::STATUS_PENDING => 'yellow',
+            self::STATUS_APPROVED => 'green',
+            self::STATUS_REJECTED => 'red',
+            self::STATUS_CANCELLED => 'gray',
+            default => 'gray',
+        };
+    }
+
+    // =========================================================================
+    // Scopes
+    // =========================================================================
+
+    public function scopeStatus($query, string $status)
+    {
+        return $query->where('status', $status);
+    }
+
+    public function scopeDraft($query)
+    {
+        return $query->where('status', self::STATUS_DRAFT);
+    }
+
+    public function scopePending($query)
+    {
+        return $query->where('status', self::STATUS_PENDING);
+    }
+
+    // =========================================================================
+    // Helper Methods
+    // =========================================================================
+
+    public function isDraft(): bool
+    {
+        return $this->status === self::STATUS_DRAFT;
+    }
+
+    public function isPending(): bool
+    {
+        return $this->status === self::STATUS_PENDING;
+    }
+
+    public function isApproved(): bool
+    {
+        return $this->status === self::STATUS_APPROVED;
+    }
+
+    public function isRejected(): bool
+    {
+        return $this->status === self::STATUS_REJECTED;
+    }
+
+    public function canEdit(): bool
+    {
+        return in_array($this->status, [self::STATUS_DRAFT, self::STATUS_REJECTED]);
+    }
+}
diff --git a/app/Models/Documents/DocumentApproval.php b/app/Models/Documents/DocumentApproval.php
new file mode 100644
index 00000000..a9899c00
--- /dev/null
+++ b/app/Models/Documents/DocumentApproval.php
@@ -0,0 +1,94 @@
+<?php
+
+namespace App\Models\Documents;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class DocumentApproval extends Model
+{
+    protected $table = 'document_approvals';
+
+    // 상태 상수
+    public const STATUS_PENDING = 'PENDING';
+
+    public const STATUS_APPROVED = 'APPROVED';
+
+    public const STATUS_REJECTED = 'REJECTED';
+
+    public const STATUS_LABELS = [
+        self::STATUS_PENDING => '대기',
+        self::STATUS_APPROVED => '승인',
+        self::STATUS_REJECTED => '반려',
+    ];
+
+    protected $fillable = [
+        'document_id',
+        'user_id',
+        'step',
+        'role',
+        'status',
+        'comment',
+        'acted_at',
+        'created_by',
+        'updated_by',
+    ];
+
+    protected $casts = [
+        'step' => 'integer',
+        'acted_at' => 'datetime',
+    ];
+
+    // =========================================================================
+    // Relationships
+    // =========================================================================
+
+    public function document(): BelongsTo
+    {
+        return $this->belongsTo(Document::class);
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    // =========================================================================
+    // Accessors
+    // =========================================================================
+
+    public function getStatusLabelAttribute(): string
+    {
+        return self::STATUS_LABELS[$this->status] ?? $this->status;
+    }
+
+    public function getStatusColorAttribute(): string
+    {
+        return match ($this->status) {
+            self::STATUS_PENDING => 'yellow',
+            self::STATUS_APPROVED => 'green',
+            self::STATUS_REJECTED => 'red',
+            default => 'gray',
+        };
+    }
+
+    // =========================================================================
+    // Helper Methods
+    // =========================================================================
+
+    public function isPending(): bool
+    {
+        return $this->status === self::STATUS_PENDING;
+    }
+
+    public function isApproved(): bool
+    {
+        return $this->status === self::STATUS_APPROVED;
+    }
+
+    public function isRejected(): bool
+    {
+        return $this->status === self::STATUS_REJECTED;
+    }
+}
diff --git a/app/Models/Documents/DocumentAttachment.php b/app/Models/Documents/DocumentAttachment.php
new file mode 100644
index 00000000..0509185a
--- /dev/null
+++ b/app/Models/Documents/DocumentAttachment.php
@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Models\Documents;
+
+use App\Models\File;
+use App\Models\User;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class DocumentAttachment extends Model
+{
+    protected $table = 'document_attachments';
+
+    // 첨부 유형 상수
+    public const TYPE_GENERAL = 'general';
+
+    public const TYPE_SIGNATURE = 'signature';
+
+    public const TYPE_IMAGE = 'image';
+
+    public const TYPE_REFERENCE = 'reference';
+
+    public const TYPE_LABELS = [
+        self::TYPE_GENERAL => '일반',
+        self::TYPE_SIGNATURE => '서명',
+        self::TYPE_IMAGE => '이미지',
+        self::TYPE_REFERENCE => '참고자료',
+    ];
+
+    protected $fillable = [
+        'document_id',
+        'file_id',
+        'attachment_type',
+        'description',
+        'created_by',
+    ];
+
+    protected $attributes = [
+        'attachment_type' => self::TYPE_GENERAL,
+    ];
+
+    // =========================================================================
+    // Relationships
+    // =========================================================================
+
+    public function document(): BelongsTo
+    {
+        return $this->belongsTo(Document::class);
+    }
+
+    public function file(): BelongsTo
+    {
+        return $this->belongsTo(File::class);
+    }
+
+    public function creator(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    // =========================================================================
+    // Accessors
+    // =========================================================================
+
+    public function getTypeLabelAttribute(): string
+    {
+        return self::TYPE_LABELS[$this->attachment_type] ?? $this->attachment_type;
+    }
+}
diff --git a/app/Models/Documents/DocumentData.php b/app/Models/Documents/DocumentData.php
new file mode 100644
index 00000000..6421ac97
--- /dev/null
+++ b/app/Models/Documents/DocumentData.php
@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Models\Documents;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class DocumentData extends Model
+{
+    protected $table = 'document_data';
+
+    protected $fillable = [
+        'document_id',
+        'section_id',
+        'column_id',
+        'row_index',
+        'field_key',
+        'field_value',
+    ];
+
+    protected $casts = [
+        'row_index' => 'integer',
+    ];
+
+    // =========================================================================
+    // Relationships
+    // =========================================================================
+
+    public function document(): BelongsTo
+    {
+        return $this->belongsTo(Document::class);
+    }
+
+    // =========================================================================
+    // Scopes
+    // =========================================================================
+
+    public function scopeForSection($query, int $sectionId)
+    {
+        return $query->where('section_id', $sectionId);
+    }
+
+    public function scopeForField($query, string $fieldKey)
+    {
+        return $query->where('field_key', $fieldKey);
+    }
+}
diff --git a/resources/views/documents/edit.blade.php b/resources/views/documents/edit.blade.php
new file mode 100644
index 00000000..7f6c4671
--- /dev/null
+++ b/resources/views/documents/edit.blade.php
@@ -0,0 +1,211 @@
+@extends('layouts.app')
+
+@section('title', $isCreate ? '새 문서 작성' : '문서 수정')
+
+@section('content')
+<div class="p-6">
+    {{-- 헤더 --}}
+    <div class="flex justify-between items-center mb-6">
+        <div>
+            <h1 class="text-2xl font-bold text-gray-800">{{ $isCreate ? '새 문서 작성' : '문서 수정' }}</h1>
+            <p class="text-sm text-gray-500 mt-1">
+                @if($document)
+                    {{ $document->document_no }} - {{ $document->title }}
+                @else
+                    템플릿을 선택하여 문서를 작성합니다.
+                @endif
+            </p>
+        </div>
+        <a href="{{ route('documents.index') }}"
+           class="inline-flex items-center px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
+            <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18"/>
+            </svg>
+            목록으로
+        </a>
+    </div>
+
+    {{-- 템플릿 선택 (생성 시) --}}
+    @if($isCreate && !$template)
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6 mb-6">
+        <h2 class="text-lg font-semibold text-gray-800 mb-4">템플릿 선택</h2>
+        <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+            @forelse($templates as $tpl)
+                <a href="{{ route('documents.create', ['template_id' => $tpl->id]) }}"
+                   class="block p-4 border border-gray-200 rounded-lg hover:border-blue-500 hover:bg-blue-50 transition-colors">
+                    <h3 class="font-medium text-gray-900">{{ $tpl->name }}</h3>
+                    <p class="text-sm text-gray-500 mt-1">{{ $tpl->category }}</p>
+                </a>
+            @empty
+                <p class="text-gray-500 col-span-3">사용 가능한 템플릿이 없습니다.</p>
+            @endforelse
+        </div>
+    </div>
+    @endif
+
+    {{-- 문서 폼 --}}
+    @if($template)
+    <form id="documentForm" class="space-y-6">
+        @csrf
+        <input type="hidden" name="template_id" value="{{ $template->id }}">
+
+        {{-- 기본 정보 --}}
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+            <h2 class="text-lg font-semibold text-gray-800 mb-4">기본 정보</h2>
+
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">템플릿</label>
+                    <input type="text" value="{{ $template->name }}" disabled
+                           class="w-full rounded-lg border-gray-300 bg-gray-50 text-sm">
+                </div>
+
+                <div>
+                    <label class="block text-sm font-medium text-gray-700 mb-1">
+                        제목 <span class="text-red-500">*</span>
+                    </label>
+                    <input type="text" name="title" value="{{ $document->title ?? '' }}" required
+                           class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                           placeholder="문서 제목을 입력하세요">
+                </div>
+            </div>
+        </div>
+
+        {{-- 기본 필드 --}}
+        @if($template->basicFields && $template->basicFields->count() > 0)
+        <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+            <h2 class="text-lg font-semibold text-gray-800 mb-4">{{ $template->title ?? '문서 정보' }}</h2>
+
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+                @foreach($template->basicFields as $field)
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">
+                            {{ $field->label }}
+                            @if($field->is_required)
+                                <span class="text-red-500">*</span>
+                            @endif
+                        </label>
+                        @if($field->type === 'textarea')
+                            <textarea name="data[{{ $field->field_key }}]"
+                                      class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                                      rows="3"
+                                      {{ $field->is_required ? 'required' : '' }}
+                                      placeholder="{{ $field->placeholder ?? '' }}">{{ $document?->data->where('field_key', $field->field_key)->first()?->field_value ?? '' }}</textarea>
+                        @elseif($field->type === 'select' && $field->options)
+                            <select name="data[{{ $field->field_key }}]"
+                                    class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                                    {{ $field->is_required ? 'required' : '' }}>
+                                <option value="">선택하세요</option>
+                                @foreach($field->options as $option)
+                                    <option value="{{ $option }}" {{ ($document?->data->where('field_key', $field->field_key)->first()?->field_value ?? '') === $option ? 'selected' : '' }}>
+                                        {{ $option }}
+                                    </option>
+                                @endforeach
+                            </select>
+                        @elseif($field->type === 'date')
+                            <input type="date" name="data[{{ $field->field_key }}]"
+                                   value="{{ $document?->data->where('field_key', $field->field_key)->first()?->field_value ?? '' }}"
+                                   class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                                   {{ $field->is_required ? 'required' : '' }}>
+                        @elseif($field->type === 'number')
+                            <input type="number" name="data[{{ $field->field_key }}]"
+                                   value="{{ $document?->data->where('field_key', $field->field_key)->first()?->field_value ?? '' }}"
+                                   class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                                   {{ $field->is_required ? 'required' : '' }}
+                                   placeholder="{{ $field->placeholder ?? '' }}">
+                        @else
+                            <input type="text" name="data[{{ $field->field_key }}]"
+                                   value="{{ $document?->data->where('field_key', $field->field_key)->first()?->field_value ?? '' }}"
+                                   class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500"
+                                   {{ $field->is_required ? 'required' : '' }}
+                                   placeholder="{{ $field->placeholder ?? '' }}">
+                        @endif
+                    </div>
+                @endforeach
+            </div>
+        </div>
+        @endif
+
+        {{-- 섹션 (테이블 형태) --}}
+        @if($template->sections && $template->sections->count() > 0)
+            @foreach($template->sections as $section)
+            <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                <h2 class="text-lg font-semibold text-gray-800 mb-4">{{ $section->name }}</h2>
+                <p class="text-sm text-gray-500 mb-4">테이블 형태의 데이터는 추후 구현 예정입니다.</p>
+            </div>
+            @endforeach
+        @endif
+
+        {{-- 버튼 --}}
+        <div class="flex justify-end gap-3">
+            <a href="{{ route('documents.index') }}"
+               class="px-6 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
+                취소
+            </a>
+            <button type="submit"
+                    class="px-6 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition-colors">
+                {{ $isCreate ? '저장' : '수정' }}
+            </button>
+        </div>
+    </form>
+    @endif
+</div>
+@endsection
+
+@push('scripts')
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    const form = document.getElementById('documentForm');
+    if (!form) return;
+
+    form.addEventListener('submit', function(e) {
+        e.preventDefault();
+
+        const formData = new FormData(form);
+        const data = {
+            template_id: formData.get('template_id'),
+            title: formData.get('title'),
+            data: []
+        };
+
+        // data 필드 수집
+        for (const [key, value] of formData.entries()) {
+            if (key.startsWith('data[') && key.endsWith(']')) {
+                const fieldKey = key.slice(5, -1);
+                data.data.push({
+                    field_key: fieldKey,
+                    field_value: value
+                });
+            }
+        }
+
+        const isCreate = {{ $isCreate ? 'true' : 'false' }};
+        const url = isCreate ? '/api/admin/documents' : '/api/admin/documents/{{ $document?->id }}';
+        const method = isCreate ? 'POST' : 'PATCH';
+
+        fetch(url, {
+            method: method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+                'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
+            },
+            body: JSON.stringify(data)
+        })
+        .then(response => response.json())
+        .then(result => {
+            if (result.success) {
+                alert(isCreate ? '문서가 저장되었습니다.' : '문서가 수정되었습니다.');
+                window.location.href = '/documents';
+            } else {
+                alert(result.message || '오류가 발생했습니다.');
+            }
+        })
+        .catch(error => {
+            console.error('Error:', error);
+            alert('오류가 발생했습니다.');
+        });
+    });
+});
+</script>
+@endpush
\ No newline at end of file
diff --git a/resources/views/documents/index.blade.php b/resources/views/documents/index.blade.php
new file mode 100644
index 00000000..41798958
--- /dev/null
+++ b/resources/views/documents/index.blade.php
@@ -0,0 +1,240 @@
+@extends('layouts.app')
+
+@section('title', '문서 관리')
+
+@section('content')
+<div class="p-6">
+    {{-- 헤더 --}}
+    <div class="flex justify-between items-center mb-6">
+        <div>
+            <h1 class="text-2xl font-bold text-gray-800">문서 관리</h1>
+            <p class="text-sm text-gray-500 mt-1">작성된 문서를 관리합니다.</p>
+        </div>
+        <a href="{{ route('documents.create') }}"
+           class="inline-flex items-center px-4 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition-colors">
+            <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4"/>
+            </svg>
+            새 문서 작성
+        </a>
+    </div>
+
+    {{-- 필터 --}}
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4 mb-6">
+        <form id="filterForm" class="grid grid-cols-1 md:grid-cols-4 gap-4">
+            {{-- 상태 필터 --}}
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">상태</label>
+                <select name="status" class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
+                    <option value="">전체</option>
+                    @foreach($statuses as $value => $label)
+                        <option value="{{ $value }}">{{ $label }}</option>
+                    @endforeach
+                </select>
+            </div>
+
+            {{-- 템플릿 필터 --}}
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">템플릿</label>
+                <select name="template_id" class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
+                    <option value="">전체</option>
+                    @foreach($templates as $template)
+                        <option value="{{ $template->id }}">{{ $template->name }}</option>
+                    @endforeach
+                </select>
+            </div>
+
+            {{-- 검색 --}}
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">검색</label>
+                <input type="text" name="search" placeholder="문서번호, 제목"
+                       class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
+            </div>
+
+            {{-- 버튼 --}}
+            <div class="flex items-end gap-2">
+                <button type="submit"
+                        class="px-4 py-2 bg-gray-800 text-white text-sm font-medium rounded-lg hover:bg-gray-900 transition-colors">
+                    검색
+                </button>
+                <button type="reset"
+                        class="px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
+                    초기화
+                </button>
+            </div>
+        </form>
+    </div>
+
+    {{-- 문서 목록 --}}
+    <div class="bg-white rounded-lg shadow-sm border border-gray-200">
+        <div class="overflow-x-auto">
+            <table class="min-w-full divide-y divide-gray-200">
+                <thead class="bg-gray-50">
+                    <tr>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">문서번호</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">제목</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">템플릿</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">상태</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">작성자</th>
+                        <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">작성일</th>
+                        <th class="px-6 py-3 text-right text-xs font-medium text-gray-500 uppercase tracking-wider">관리</th>
+                    </tr>
+                </thead>
+                <tbody id="documentList" class="bg-white divide-y divide-gray-200">
+                    {{-- HTMX로 로드 --}}
+                </tbody>
+            </table>
+        </div>
+
+        {{-- 페이지네이션 --}}
+        <div id="pagination" class="px-6 py-4 border-t border-gray-200">
+            {{-- HTMX로 로드 --}}
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+    loadDocuments();
+
+    // 필터 폼 제출
+    document.getElementById('filterForm').addEventListener('submit', function(e) {
+        e.preventDefault();
+        loadDocuments();
+    });
+
+    // 초기화 버튼
+    document.getElementById('filterForm').addEventListener('reset', function() {
+        setTimeout(() => loadDocuments(), 10);
+    });
+});
+
+function loadDocuments(page = 1) {
+    const form = document.getElementById('filterForm');
+    const formData = new FormData(form);
+    const params = new URLSearchParams(formData);
+    params.set('page', page);
+
+    fetch(`/api/admin/documents?${params.toString()}`, {
+        headers: {
+            'Accept': 'application/json',
+            'X-Requested-With': 'XMLHttpRequest',
+        }
+    })
+    .then(response => response.json())
+    .then(data => {
+        renderDocuments(data.data);
+        renderPagination(data);
+    })
+    .catch(error => {
+        console.error('Error:', error);
+        document.getElementById('documentList').innerHTML = `
+            <tr>
+                <td colspan="7" class="px-6 py-12 text-center text-gray-500">
+                    데이터를 불러오는 중 오류가 발생했습니다.
+                </td>
+            </tr>
+        `;
+    });
+}
+
+function renderDocuments(documents) {
+    const tbody = document.getElementById('documentList');
+
+    if (!documents || documents.length === 0) {
+        tbody.innerHTML = `
+            <tr>
+                <td colspan="7" class="px-6 py-12 text-center text-gray-500">
+                    문서가 없습니다.
+                </td>
+            </tr>
+        `;
+        return;
+    }
+
+    tbody.innerHTML = documents.map(doc => `
+        <tr class="hover:bg-gray-50">
+            <td class="px-6 py-4 whitespace-nowrap">
+                <span class="text-sm font-medium text-gray-900">${doc.document_no}</span>
+            </td>
+            <td class="px-6 py-4">
+                <a href="/documents/${doc.id}" class="text-sm text-blue-600 hover:text-blue-800 hover:underline">
+                    ${doc.title}
+                </a>
+            </td>
+            <td class="px-6 py-4 whitespace-nowrap">
+                <span class="text-sm text-gray-600">${doc.template?.name || '-'}</span>
+            </td>
+            <td class="px-6 py-4 whitespace-nowrap">
+                <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium ${getStatusClass(doc.status)}">
+                    ${getStatusLabel(doc.status)}
+                </span>
+            </td>
+            <td class="px-6 py-4 whitespace-nowrap">
+                <span class="text-sm text-gray-600">${doc.creator?.name || '-'}</span>
+            </td>
+            <td class="px-6 py-4 whitespace-nowrap">
+                <span class="text-sm text-gray-600">${formatDate(doc.created_at)}</span>
+            </td>
+            <td class="px-6 py-4 whitespace-nowrap text-right text-sm font-medium">
+                <a href="/documents/${doc.id}" class="text-gray-600 hover:text-gray-900 mr-3">보기</a>
+                ${doc.status === 'DRAFT' || doc.status === 'REJECTED' ? `
+                    <a href="/documents/${doc.id}/edit" class="text-blue-600 hover:text-blue-900">수정</a>
+                ` : ''}
+            </td>
+        </tr>
+    `).join('');
+}
+
+function renderPagination(data) {
+    const container = document.getElementById('pagination');
+
+    if (data.last_page <= 1) {
+        container.innerHTML = '';
+        return;
+    }
+
+    let html = '<div class="flex items-center justify-between"><div class="text-sm text-gray-500">';
+    html += `총 ${data.total}건 중 ${data.from}-${data.to}건`;
+    html += '</div><div class="flex gap-1">';
+
+    for (let i = 1; i <= data.last_page; i++) {
+        const isActive = i === data.current_page;
+        html += `<button onclick="loadDocuments(${i})" class="px-3 py-1 text-sm rounded ${isActive ? 'bg-blue-600 text-white' : 'bg-gray-100 text-gray-700 hover:bg-gray-200'}">${i}</button>`;
+    }
+
+    html += '</div></div>';
+    container.innerHTML = html;
+}
+
+function getStatusLabel(status) {
+    const labels = {
+        'DRAFT': '작성중',
+        'PENDING': '결재중',
+        'APPROVED': '승인',
+        'REJECTED': '반려',
+        'CANCELLED': '취소'
+    };
+    return labels[status] || status;
+}
+
+function getStatusClass(status) {
+    const classes = {
+        'DRAFT': 'bg-gray-100 text-gray-800',
+        'PENDING': 'bg-yellow-100 text-yellow-800',
+        'APPROVED': 'bg-green-100 text-green-800',
+        'REJECTED': 'bg-red-100 text-red-800',
+        'CANCELLED': 'bg-gray-100 text-gray-600'
+    };
+    return classes[status] || 'bg-gray-100 text-gray-800';
+}
+
+function formatDate(dateString) {
+    if (!dateString) return '-';
+    const date = new Date(dateString);
+    return date.toLocaleDateString('ko-KR', { year: 'numeric', month: '2-digit', day: '2-digit' });
+}
+</script>
+@endpush
\ No newline at end of file
diff --git a/resources/views/documents/show.blade.php b/resources/views/documents/show.blade.php
new file mode 100644
index 00000000..4dcf9e2a
--- /dev/null
+++ b/resources/views/documents/show.blade.php
@@ -0,0 +1,200 @@
+@extends('layouts.app')
+
+@section('title', '문서 상세')
+
+@section('content')
+<div class="p-6">
+    {{-- 헤더 --}}
+    <div class="flex justify-between items-center mb-6">
+        <div>
+            <h1 class="text-2xl font-bold text-gray-800">문서 상세</h1>
+            <p class="text-sm text-gray-500 mt-1">{{ $document->document_no }} - {{ $document->title }}</p>
+        </div>
+        <div class="flex gap-2">
+            @if($document->status === 'DRAFT' || $document->status === 'REJECTED')
+                <a href="{{ route('documents.edit', $document->id) }}"
+                   class="inline-flex items-center px-4 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition-colors">
+                    <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/>
+                    </svg>
+                    수정
+                </a>
+            @endif
+            <a href="{{ route('documents.index') }}"
+               class="inline-flex items-center px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
+                <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18"/>
+                </svg>
+                목록으로
+            </a>
+        </div>
+    </div>
+
+    {{-- 문서 정보 --}}
+    <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+        {{-- 메인 컨텐츠 --}}
+        <div class="lg:col-span-2 space-y-6">
+            {{-- 기본 정보 --}}
+            <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                <h2 class="text-lg font-semibold text-gray-800 mb-4">기본 정보</h2>
+
+                <dl class="grid grid-cols-2 gap-4">
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">문서번호</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->document_no }}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">템플릿</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->template->name ?? '-' }}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">제목</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->title }}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">상태</dt>
+                        <dd class="mt-1">
+                            <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium {{ $document->status_color }}">
+                                {{ $document->status_label }}
+                            </span>
+                        </dd>
+                    </div>
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">작성자</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->creator->name ?? '-' }}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">작성일</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->created_at?->format('Y-m-d H:i') ?? '-' }}</dd>
+                    </div>
+                    @if($document->updated_at && $document->updated_at->ne($document->created_at))
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">수정자</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->updater->name ?? '-' }}</dd>
+                    </div>
+                    <div>
+                        <dt class="text-sm font-medium text-gray-500">수정일</dt>
+                        <dd class="mt-1 text-sm text-gray-900">{{ $document->updated_at?->format('Y-m-d H:i') ?? '-' }}</dd>
+                    </div>
+                    @endif
+                </dl>
+            </div>
+
+            {{-- 기본 필드 데이터 --}}
+            @if($document->template?->basicFields && $document->template->basicFields->count() > 0)
+            <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                <h2 class="text-lg font-semibold text-gray-800 mb-4">{{ $document->template->title ?? '문서 정보' }}</h2>
+
+                <dl class="grid grid-cols-1 md:grid-cols-2 gap-4">
+                    @foreach($document->template->basicFields as $field)
+                        @php
+                            $fieldData = $document->data->where('field_key', $field->field_key)->first();
+                            $value = $fieldData?->field_value ?? '-';
+                        @endphp
+                        <div class="{{ $field->type === 'textarea' ? 'col-span-2' : '' }}">
+                            <dt class="text-sm font-medium text-gray-500">{{ $field->label }}</dt>
+                            <dd class="mt-1 text-sm text-gray-900 {{ $field->type === 'textarea' ? 'whitespace-pre-wrap' : '' }}">{{ $value }}</dd>
+                        </div>
+                    @endforeach
+                </dl>
+            </div>
+            @endif
+
+            {{-- 섹션 데이터 (테이블) --}}
+            @if($document->template?->sections && $document->template->sections->count() > 0)
+                @foreach($document->template->sections as $section)
+                <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                    <h2 class="text-lg font-semibold text-gray-800 mb-4">{{ $section->name }}</h2>
+                    <p class="text-sm text-gray-500">테이블 형태의 데이터 표시는 추후 구현 예정입니다.</p>
+                </div>
+                @endforeach
+            @endif
+
+            {{-- 첨부파일 --}}
+            @if($document->attachments && $document->attachments->count() > 0)
+            <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                <h2 class="text-lg font-semibold text-gray-800 mb-4">첨부파일</h2>
+
+                <ul class="divide-y divide-gray-200">
+                    @foreach($document->attachments as $attachment)
+                    <li class="py-3 flex items-center justify-between">
+                        <div class="flex items-center">
+                            <svg class="w-5 h-5 text-gray-400 mr-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15.172 7l-6.586 6.586a2 2 0 102.828 2.828l6.414-6.586a4 4 0 00-5.656-5.656l-6.415 6.585a6 6 0 108.486 8.486L20.5 13"/>
+                            </svg>
+                            <div>
+                                <p class="text-sm font-medium text-gray-900">{{ $attachment->file->original_name ?? '파일명 없음' }}</p>
+                                <p class="text-xs text-gray-500">
+                                    {{ $attachment->type_label }} ·
+                                    {{ $attachment->file ? number_format($attachment->file->size / 1024, 1) . ' KB' : '-' }}
+                                </p>
+                            </div>
+                        </div>
+                        @if($attachment->file)
+                        <a href="{{ route('files.download', $attachment->file->id) }}"
+                           class="text-sm text-blue-600 hover:text-blue-800">
+                            다운로드
+                        </a>
+                        @endif
+                    </li>
+                    @endforeach
+                </ul>
+            </div>
+            @endif
+        </div>
+
+        {{-- 사이드바 --}}
+        <div class="space-y-6">
+            {{-- 결재 현황 --}}
+            <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                <h2 class="text-lg font-semibold text-gray-800 mb-4">결재 현황</h2>
+
+                @if($document->approvals && $document->approvals->count() > 0)
+                <ol class="relative border-l border-gray-200 ml-3">
+                    @foreach($document->approvals->sortBy('step_order') as $approval)
+                    <li class="mb-6 ml-6">
+                        <span class="absolute flex items-center justify-center w-6 h-6 rounded-full -left-3 ring-4 ring-white
+                            @if($approval->status === 'APPROVED') bg-green-500
+                            @elseif($approval->status === 'REJECTED') bg-red-500
+                            @elseif($approval->status === 'PENDING') bg-yellow-500
+                            @else bg-gray-300
+                            @endif">
+                            @if($approval->status === 'APPROVED')
+                                <svg class="w-3 h-3 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                    <path fill-rule="evenodd" d="M16.707 5.293a1 1 0 010 1.414l-8 8a1 1 0 01-1.414 0l-4-4a1 1 0 011.414-1.414L8 12.586l7.293-7.293a1 1 0 011.414 0z" clip-rule="evenodd"/>
+                                </svg>
+                            @elseif($approval->status === 'REJECTED')
+                                <svg class="w-3 h-3 text-white" fill="currentColor" viewBox="0 0 20 20">
+                                    <path fill-rule="evenodd" d="M4.293 4.293a1 1 0 011.414 0L10 8.586l4.293-4.293a1 1 0 111.414 1.414L11.414 10l4.293 4.293a1 1 0 01-1.414 1.414L10 11.414l-4.293 4.293a1 1 0 01-1.414-1.414L8.586 10 4.293 5.707a1 1 0 010-1.414z" clip-rule="evenodd"/>
+                                </svg>
+                            @else
+                                <span class="text-white text-xs font-bold">{{ $approval->step_order }}</span>
+                            @endif
+                        </span>
+                        <div>
+                            <h3 class="text-sm font-medium text-gray-900">{{ $approval->user->name ?? '미지정' }}</h3>
+                            <p class="text-xs text-gray-500">{{ $approval->step_name }}</p>
+                            @if($approval->approved_at)
+                            <p class="text-xs text-gray-400 mt-1">{{ $approval->approved_at->format('Y-m-d H:i') }}</p>
+                            @endif
+                            @if($approval->comment)
+                            <p class="text-xs text-gray-600 mt-1 bg-gray-50 p-2 rounded">{{ $approval->comment }}</p>
+                            @endif
+                        </div>
+                    </li>
+                    @endforeach
+                </ol>
+                @else
+                <p class="text-sm text-gray-500">결재선이 설정되지 않았습니다.</p>
+                @endif
+            </div>
+
+            {{-- 문서 이력 --}}
+            <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-6">
+                <h2 class="text-lg font-semibold text-gray-800 mb-4">문서 이력</h2>
+                <p class="text-sm text-gray-500">문서 이력 기능은 추후 구현 예정입니다.</p>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
\ No newline at end of file
diff --git a/routes/api.php b/routes/api.php
index ce1b9b8c..8d060e20 100644
--- a/routes/api.php
+++ b/routes/api.php
@@ -1,11 +1,12 @@
 <?php
 
 use App\Http\Controllers\Api\Admin\BoardController;
+use App\Http\Controllers\Api\Admin\CategoryApiController;
 use App\Http\Controllers\Api\Admin\CustomerCenterController;
 use App\Http\Controllers\Api\Admin\DailyLogController;
 use App\Http\Controllers\Api\Admin\DepartmentController;
+use App\Http\Controllers\Api\Admin\DocumentApiController;
 use App\Http\Controllers\Api\Admin\DocumentTemplateApiController;
-use App\Http\Controllers\Api\Admin\CategoryApiController;
 use App\Http\Controllers\Api\Admin\GlobalCategoryApiController;
 use App\Http\Controllers\Api\Admin\GlobalMenuController;
 use App\Http\Controllers\Api\Admin\ItemFieldController;
@@ -790,6 +791,19 @@
     Route::post('/upload-image', [DocumentTemplateApiController::class, 'uploadImage'])->name('upload-image');
 });
 
+/*
+|--------------------------------------------------------------------------
+| 문서 관리 API
+|--------------------------------------------------------------------------
+*/
+Route::middleware(['web', 'auth', 'hq.member'])->prefix('admin/documents')->name('api.admin.documents.')->group(function () {
+    Route::get('/', [DocumentApiController::class, 'index'])->name('index');
+    Route::post('/', [DocumentApiController::class, 'store'])->name('store');
+    Route::get('/{id}', [DocumentApiController::class, 'show'])->name('show');
+    Route::patch('/{id}', [DocumentApiController::class, 'update'])->name('update');
+    Route::delete('/{id}', [DocumentApiController::class, 'destroy'])->name('destroy');
+});
+
 /*
 |--------------------------------------------------------------------------
 | 카테고리 관리 API
diff --git a/routes/web.php b/routes/web.php
index 11bc1aeb..418eb3d9 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -6,17 +6,21 @@
 use App\Http\Controllers\AuditLogController;
 use App\Http\Controllers\Auth\LoginController;
 use App\Http\Controllers\BoardController;
+use App\Http\Controllers\CategoryController;
+use App\Http\Controllers\CommonCodeController;
 use App\Http\Controllers\CustomerCenterController;
 use App\Http\Controllers\DailyLogController;
 use App\Http\Controllers\DepartmentController;
 use App\Http\Controllers\DevTools\ApiExplorerController;
 use App\Http\Controllers\DevTools\FlowTesterController;
+use App\Http\Controllers\DocumentController;
+use App\Http\Controllers\DocumentTemplateController;
 use App\Http\Controllers\FcmController;
 use App\Http\Controllers\ItemFieldController;
 use App\Http\Controllers\Lab\AIController;
-use App\Http\Controllers\Lab\ManagementController;
 use App\Http\Controllers\Lab\StrategyController;
 use App\Http\Controllers\MenuController;
+use App\Http\Controllers\MenuSyncController;
 use App\Http\Controllers\PermissionController;
 use App\Http\Controllers\PostController;
 use App\Http\Controllers\ProfileController;
@@ -27,10 +31,6 @@
 use App\Http\Controllers\System\AiConfigController;
 use App\Http\Controllers\TenantController;
 use App\Http\Controllers\TenantSettingController;
-use App\Http\Controllers\CommonCodeController;
-use App\Http\Controllers\DocumentTemplateController;
-use App\Http\Controllers\CategoryController;
-use App\Http\Controllers\MenuSyncController;
 use App\Http\Controllers\UserController;
 use Illuminate\Support\Facades\Route;
 
@@ -319,6 +319,14 @@
         Route::get('/{id}/edit', [DocumentTemplateController::class, 'edit'])->name('edit');
     });
 
+    // 문서 관리
+    Route::prefix('documents')->name('documents.')->group(function () {
+        Route::get('/', [DocumentController::class, 'index'])->name('index');
+        Route::get('/create', [DocumentController::class, 'create'])->name('create');
+        Route::get('/{id}', [DocumentController::class, 'show'])->whereNumber('id')->name('show');
+        Route::get('/{id}/edit', [DocumentController::class, 'edit'])->whereNumber('id')->name('edit');
+    });
+
     // AI 설정 관리
     Route::prefix('system/ai-config')->name('system.ai-config.')->group(function () {
         Route::get('/', [AiConfigController::class, 'index'])->name('index');
@@ -629,6 +637,7 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.account-transactions'));
         }
+
         return view('finance.account-transactions');
     })->name('account-transactions');
 
@@ -641,12 +650,13 @@
     });
 
     // 기존 fund-schedule URL 리다이렉트 (호환성)
-    Route::get('/fund-schedule', fn() => redirect()->route('finance.fund-schedules.index'))->name('fund-schedule');
+    Route::get('/fund-schedule', fn () => redirect()->route('finance.fund-schedules.index'))->name('fund-schedule');
     Route::get('/daily-fund', function () {
         // HTMX 요청이면 전체 페이지로 리다이렉트 (React 스크립트 로딩을 위해)
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.daily-fund'));
         }
+
         return view('finance.daily-fund');
     })->name('daily-fund');
 
@@ -655,12 +665,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.corporate-cards'));
         }
+
         return view('finance.corporate-cards');
     })->name('corporate-cards');
     Route::get('/card-transactions', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.card-transactions'));
         }
+
         return view('finance.card-transactions');
     })->name('card-transactions');
 
@@ -669,12 +681,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.income'));
         }
+
         return view('finance.income');
     })->name('income');
     Route::get('/expense', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.expense'));
         }
+
         return view('finance.expense');
     })->name('expense');
 
@@ -683,12 +697,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.sales'));
         }
+
         return view('finance.sales');
     })->name('sales');
     Route::get('/purchase', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.purchase'));
         }
+
         return view('finance.purchase');
     })->name('purchase');
 
@@ -697,24 +713,28 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.sales-commission'));
         }
+
         return view('finance.sales-commission');
     })->name('sales-commission');
     Route::get('/consulting-fee', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.consulting-fee'));
         }
+
         return view('finance.consulting-fee');
     })->name('consulting-fee');
     Route::get('/customer-settlement', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.customer-settlement'));
         }
+
         return view('finance.customer-settlement');
     })->name('customer-settlement');
     Route::get('/subscription', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.subscription'));
         }
+
         return view('finance.subscription');
     })->name('subscription');
 
@@ -723,12 +743,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.corporate-vehicles'));
         }
+
         return view('finance.corporate-vehicles');
     })->name('corporate-vehicles');
     Route::get('/vehicle-maintenance', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.vehicle-maintenance'));
         }
+
         return view('finance.vehicle-maintenance');
     })->name('vehicle-maintenance');
 
@@ -737,12 +759,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.customers'));
         }
+
         return view('finance.customers');
     })->name('customers');
     Route::get('/partners', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.partners'));
         }
+
         return view('finance.partners');
     })->name('partners');
 
@@ -751,12 +775,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.receivables'));
         }
+
         return view('finance.receivables');
     })->name('receivables');
     Route::get('/payables', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.payables'));
         }
+
         return view('finance.payables');
     })->name('payables');
 
@@ -765,12 +791,14 @@
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.refunds'));
         }
+
         return view('finance.refunds');
     })->name('refunds');
     Route::get('/vat', function () {
         if (request()->header('HX-Request')) {
             return response('', 200)->header('HX-Redirect', route('finance.vat'));
         }
+
         return view('finance.vat');
     })->name('vat');
 });

From 1d9473d7d0e12f1c2e25be2861e22cbb4d110af7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Wed, 28 Jan 2026 23:07:15 +0900
Subject: [PATCH 05/12] =?UTF-8?q?refactor:=EC=B9=B4=ED=85=8C=EA=B3=A0?=
 =?UTF-8?q?=EB=A6=AC/=EA=B3=B5=ED=86=B5=EC=BD=94=EB=93=9C=20=ED=83=AD=20?=
 =?UTF-8?q?=EB=A0=88=EC=9D=B4=EC=95=84=EC=9B=83=20=EC=84=B8=EB=A1=9C?=
 =?UTF-8?q?=ED=98=95=EC=9C=BC=EB=A1=9C=20=EB=B3=80=EA=B2=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 가로 탭 → 좌측 세로 탭(사이드바 스타일)으로 변경
- 코드 그룹이 많아져도 세로 스크롤로 확인 가능
- 우측 글로벌/테넌트 2컬럼 그리드 유지

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 resources/views/categories/index.blade.php   | 28 +++++++++++---------
 resources/views/common-codes/index.blade.php | 27 +++++++++++--------
 2 files changed, 32 insertions(+), 23 deletions(-)

diff --git a/resources/views/categories/index.blade.php b/resources/views/categories/index.blade.php
index 5b511975..4b4fd318 100644
--- a/resources/views/categories/index.blade.php
+++ b/resources/views/categories/index.blade.php
@@ -43,26 +43,29 @@ class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg
             헤더에서 테넌트를 선택해주세요.
         </div>
     @else
-        <!-- 코드 그룹 탭 -->
-        <div class="bg-white rounded-lg shadow-sm mb-4">
-            <div class="border-b border-gray-200 overflow-x-auto">
-                <nav class="flex -mb-px min-w-max" aria-label="Tabs">
+        <!-- 메인 레이아웃: 좌측 탭 + 우측 콘텐츠 -->
+        <div class="flex gap-4 flex-1 min-h-0">
+            <!-- 좌측: 코드 그룹 탭 (세로) -->
+            <div class="w-40 flex-shrink-0 bg-white rounded-lg shadow-sm overflow-hidden">
+                <div class="px-3 py-2 bg-gray-50 border-b border-gray-200">
+                    <span class="text-xs font-semibold text-gray-500 uppercase tracking-wider">코드 그룹</span>
+                </div>
+                <nav class="overflow-y-auto max-h-[calc(100vh-220px)]" aria-label="Tabs">
                     @foreach($codeGroups as $group => $label)
                         <a href="{{ route('categories.index', ['group' => $group]) }}"
-                           class="px-4 py-3 border-b-2 whitespace-nowrap transition-colors flex flex-col items-center
+                           class="block px-3 py-2.5 border-l-4 transition-colors
                                   {{ $selectedGroup === $group
-                                      ? 'border-blue-500 text-blue-600'
-                                      : 'border-transparent text-gray-500 hover:text-gray-700 hover:border-gray-300' }}">
-                            <span class="text-sm font-medium">{{ $label }}</span>
-                            <span class="text-xs font-mono {{ $selectedGroup === $group ? 'text-blue-400' : 'text-gray-400' }}">{{ $group }}</span>
+                                      ? 'border-l-blue-500 bg-blue-50 text-blue-700'
+                                      : 'border-l-transparent text-gray-600 hover:bg-gray-50 hover:text-gray-900' }}">
+                            <span class="block text-sm font-medium truncate">{{ $label }}</span>
+                            <span class="block text-xs font-mono {{ $selectedGroup === $group ? 'text-blue-400' : 'text-gray-400' }}">{{ $group }}</span>
                         </a>
                     @endforeach
                 </nav>
             </div>
-        </div>
 
-        <!-- 카테고리 목록 -->
-        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+            <!-- 우측: 카테고리 목록 -->
+            <div class="flex-1 grid grid-cols-1 lg:grid-cols-2 gap-4 min-w-0">
             <!-- 글로벌 카테고리 -->
             <div class="bg-white rounded-lg shadow-sm">
                 <div class="px-4 py-3 border-b border-gray-200 flex items-center justify-between">
@@ -195,6 +198,7 @@ class="relative inline-flex h-4 w-7 items-center rounded-full transition-colors
                 </div>
             </div>
         </div>
+        </div>
     @endif
 </div>
 
diff --git a/resources/views/common-codes/index.blade.php b/resources/views/common-codes/index.blade.php
index 434fac6c..43ae126b 100644
--- a/resources/views/common-codes/index.blade.php
+++ b/resources/views/common-codes/index.blade.php
@@ -61,25 +61,29 @@ class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg
             </div>
         @endif
 
-        <!-- 코드 그룹 탭 -->
-        <div class="bg-white rounded-lg shadow-sm mb-4">
-            <div class="border-b border-gray-200 overflow-x-auto">
-                <nav class="flex -mb-px min-w-max" aria-label="Tabs">
+        <!-- 메인 레이아웃: 좌측 탭 + 우측 콘텐츠 -->
+        <div class="flex gap-4 flex-1 min-h-0">
+            <!-- 좌측: 코드 그룹 탭 (세로) -->
+            <div class="w-40 flex-shrink-0 bg-white rounded-lg shadow-sm overflow-hidden">
+                <div class="px-3 py-2 bg-gray-50 border-b border-gray-200">
+                    <span class="text-xs font-semibold text-gray-500 uppercase tracking-wider">코드 그룹</span>
+                </div>
+                <nav class="overflow-y-auto max-h-[calc(100vh-220px)]" aria-label="Tabs">
                     @foreach($codeGroups as $group => $label)
                         <a href="{{ route('common-codes.index', ['group' => $group]) }}"
-                           class="px-4 py-3 text-sm font-medium border-b-2 whitespace-nowrap transition-colors
+                           class="block px-3 py-2.5 border-l-4 transition-colors
                                   {{ $selectedGroup === $group
-                                      ? 'border-blue-500 text-blue-600'
-                                      : 'border-transparent text-gray-500 hover:text-gray-700 hover:border-gray-300' }}">
-                            {{ $label }}
+                                      ? 'border-l-blue-500 bg-blue-50 text-blue-700'
+                                      : 'border-l-transparent text-gray-600 hover:bg-gray-50 hover:text-gray-900' }}">
+                            <span class="block text-sm font-medium truncate">{{ $label }}</span>
+                            <span class="block text-xs font-mono {{ $selectedGroup === $group ? 'text-blue-400' : 'text-gray-400' }}">{{ $group }}</span>
                         </a>
                     @endforeach
                 </nav>
             </div>
-        </div>
 
-        <!-- 코드 목록 -->
-        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+            <!-- 우측: 코드 목록 -->
+            <div class="flex-1 grid grid-cols-1 lg:grid-cols-2 gap-4 min-w-0">
             <!-- 글로벌 코드 -->
             <div class="bg-white rounded-lg shadow-sm">
                 <div class="px-4 py-3 border-b border-gray-200 flex items-center justify-between">
@@ -269,6 +273,7 @@ class="p-1 text-gray-400 hover:text-red-600 transition-colors"
                 </div>
             </div>
         </div>
+        </div>
     @endif
 </div>
 

From 8b7f0b9f7ffa90afe4ebc4a284dec37a2a63a5d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Thu, 29 Jan 2026 00:31:51 +0900
Subject: [PATCH 06/12] =?UTF-8?q?feat:=EA=B3=B5=ED=86=B5=EC=BD=94=EB=93=9C?=
 =?UTF-8?q?/=EC=B9=B4=ED=85=8C=EA=B3=A0=EB=A6=AC=20=EB=8F=99=EA=B8=B0?=
 =?UTF-8?q?=ED=99=94=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- CommonCodeSyncController, CategorySyncController 생성
- 환경설정은 메뉴 동기화와 공유 (TenantSetting)
- Export/Import API 추가 (/common-code-sync, /category-sync)
- Push(로컬→원격), Pull(원격→로컬) 양방향 동기화
- 동일 코드 존재 시 체크박스 비활성화 (충돌 방지)
- 글로벌 + 테넌트 코드 모두 동기화 가능
- 공통코드/카테고리 관리 페이지에 동기화 버튼 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../Controllers/CategorySyncController.php    | 490 ++++++++++++++++++
 .../Controllers/CommonCodeSyncController.php  | 388 ++++++++++++++
 resources/views/categories/index.blade.php    |  25 +-
 resources/views/categories/sync.blade.php     | 369 +++++++++++++
 resources/views/common-codes/index.blade.php  |  25 +-
 resources/views/common-codes/sync.blade.php   | 370 +++++++++++++
 routes/web.php                                |  30 +-
 7 files changed, 1680 insertions(+), 17 deletions(-)
 create mode 100644 app/Http/Controllers/CategorySyncController.php
 create mode 100644 app/Http/Controllers/CommonCodeSyncController.php
 create mode 100644 resources/views/categories/sync.blade.php
 create mode 100644 resources/views/common-codes/sync.blade.php

diff --git a/app/Http/Controllers/CategorySyncController.php b/app/Http/Controllers/CategorySyncController.php
new file mode 100644
index 00000000..fc05cd42
--- /dev/null
+++ b/app/Http/Controllers/CategorySyncController.php
@@ -0,0 +1,490 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Category;
+use App\Models\GlobalCategory;
+use App\Models\Tenants\TenantSetting;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\Http;
+
+class CategorySyncController extends Controller
+{
+    /**
+     * 현재 선택된 테넌트 ID
+     */
+    protected function getTenantId(): int
+    {
+        $tenantId = session('selected_tenant_id');
+        return ($tenantId && $tenantId !== 'all') ? (int) $tenantId : 1;
+    }
+
+    /**
+     * 환경 설정 조회 (메뉴 동기화와 공유)
+     */
+    private function getEnvironments(): array
+    {
+        $setting = TenantSetting::withoutGlobalScopes()
+            ->where('tenant_id', $this->getTenantId())
+            ->where('setting_group', 'menu_sync')
+            ->where('setting_key', 'environments')
+            ->first();
+
+        return $setting?->setting_value ?? [
+            'dev' => ['name' => '개발', 'url' => '', 'api_key' => ''],
+            'prod' => ['name' => '운영', 'url' => '', 'api_key' => ''],
+        ];
+    }
+
+    /**
+     * 카테고리 동기화 페이지
+     */
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('categories.sync.index'));
+        }
+
+        $environments = $this->getEnvironments();
+        $selectedEnv = $request->get('env', 'dev');
+
+        // 로컬 카테고리 조회
+        $localCategories = $this->getCategoryList();
+
+        // 원격 카테고리 조회
+        $remoteCategories = [];
+        $remoteError = null;
+
+        if (! empty($environments[$selectedEnv]['url'])) {
+            try {
+                $remoteCategories = $this->fetchRemoteCategories($environments[$selectedEnv]);
+            } catch (\Exception $e) {
+                $remoteError = $e->getMessage();
+            }
+        }
+
+        // 차이점 계산
+        $diff = $this->calculateDiff($localCategories, $remoteCategories);
+
+        return view('categories.sync', [
+            'environments' => $environments,
+            'selectedEnv' => $selectedEnv,
+            'localCategories' => $localCategories,
+            'remoteCategories' => $remoteCategories,
+            'remoteError' => $remoteError,
+            'diff' => $diff,
+        ]);
+    }
+
+    /**
+     * 카테고리 Export API (다른 환경에서 호출)
+     */
+    public function export(Request $request): JsonResponse
+    {
+        // API Key 검증
+        $apiKey = $request->header('X-Menu-Sync-Key');
+        $validKey = config('app.menu_sync_api_key', env('MENU_SYNC_API_KEY'));
+
+        if (empty($validKey) || $apiKey !== $validKey) {
+            return response()->json(['error' => 'Unauthorized'], 401);
+        }
+
+        $categories = $this->getCategoryList();
+
+        return response()->json([
+            'success' => true,
+            'environment' => config('app.env'),
+            'exported_at' => now()->toIso8601String(),
+            'categories' => $categories,
+        ]);
+    }
+
+    /**
+     * 카테고리 Import API (다른 환경에서 호출)
+     */
+    public function import(Request $request): JsonResponse
+    {
+        // API Key 검증
+        $apiKey = $request->header('X-Menu-Sync-Key');
+        $validKey = config('app.menu_sync_api_key', env('MENU_SYNC_API_KEY'));
+
+        if (empty($validKey) || $apiKey !== $validKey) {
+            return response()->json(['error' => 'Unauthorized'], 401);
+        }
+
+        $validated = $request->validate([
+            'categories' => 'required|array',
+            'categories.*.is_global' => 'required|boolean',
+            'categories.*.tenant_id' => 'nullable|integer',
+            'categories.*.code_group' => 'required|string|max:50',
+            'categories.*.code' => 'required|string|max:50',
+            'categories.*.name' => 'required|string|max:100',
+            'categories.*.parent_code' => 'nullable|string|max:50',
+            'categories.*.sort_order' => 'nullable|integer',
+            'categories.*.description' => 'nullable|string',
+            'categories.*.is_active' => 'nullable|boolean',
+        ]);
+
+        $imported = 0;
+        $skipped = 0;
+
+        foreach ($validated['categories'] as $catData) {
+            if ($catData['is_global']) {
+                // 글로벌 카테고리
+                $exists = GlobalCategory::where('code_group', $catData['code_group'])
+                    ->where('code', $catData['code'])
+                    ->exists();
+
+                if ($exists) {
+                    $skipped++;
+                    continue;
+                }
+
+                // 부모 찾기
+                $parentId = null;
+                if (! empty($catData['parent_code'])) {
+                    $parent = GlobalCategory::where('code_group', $catData['code_group'])
+                        ->where('code', $catData['parent_code'])
+                        ->first();
+                    $parentId = $parent?->id;
+                }
+
+                GlobalCategory::create([
+                    'parent_id' => $parentId,
+                    'code_group' => $catData['code_group'],
+                    'code' => $catData['code'],
+                    'name' => $catData['name'],
+                    'sort_order' => $catData['sort_order'] ?? 0,
+                    'description' => $catData['description'] ?? null,
+                    'is_active' => $catData['is_active'] ?? true,
+                ]);
+            } else {
+                // 테넌트 카테고리
+                $tenantId = $catData['tenant_id'] ?? $this->getTenantId();
+
+                $exists = Category::withoutGlobalScopes()
+                    ->where('tenant_id', $tenantId)
+                    ->where('code_group', $catData['code_group'])
+                    ->where('code', $catData['code'])
+                    ->exists();
+
+                if ($exists) {
+                    $skipped++;
+                    continue;
+                }
+
+                // 부모 찾기
+                $parentId = null;
+                if (! empty($catData['parent_code'])) {
+                    $parent = Category::withoutGlobalScopes()
+                        ->where('tenant_id', $tenantId)
+                        ->where('code_group', $catData['code_group'])
+                        ->where('code', $catData['parent_code'])
+                        ->first();
+                    $parentId = $parent?->id;
+                }
+
+                Category::create([
+                    'tenant_id' => $tenantId,
+                    'parent_id' => $parentId,
+                    'code_group' => $catData['code_group'],
+                    'code' => $catData['code'],
+                    'name' => $catData['name'],
+                    'sort_order' => $catData['sort_order'] ?? 0,
+                    'description' => $catData['description'] ?? null,
+                    'is_active' => $catData['is_active'] ?? true,
+                ]);
+            }
+            $imported++;
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => "{$imported}개 카테고리가 동기화되었습니다." . ($skipped > 0 ? " ({$skipped}개 스킵)" : ''),
+            'imported' => $imported,
+            'skipped' => $skipped,
+        ]);
+    }
+
+    /**
+     * Push (로컬 → 원격)
+     */
+    public function push(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'env' => 'required|string|in:dev,prod',
+            'category_keys' => 'required|array|min:1',
+            'category_keys.*' => 'string',
+        ]);
+
+        $environments = $this->getEnvironments();
+        $env = $environments[$validated['env']] ?? null;
+
+        if (! $env || empty($env['url'])) {
+            return response()->json(['error' => '환경 설정이 없습니다.'], 400);
+        }
+
+        // 선택된 카테고리 조회
+        $localCategories = $this->getCategoryList();
+        $selectedCategories = array_filter($localCategories, function ($cat) use ($validated) {
+            $key = $this->makeCategoryKey($cat);
+            return in_array($key, $validated['category_keys']);
+        });
+
+        if (empty($selectedCategories)) {
+            return response()->json(['error' => '선택된 카테고리가 없습니다.'], 400);
+        }
+
+        // 원격 서버로 전송
+        try {
+            $response = Http::withHeaders([
+                'X-Menu-Sync-Key' => $env['api_key'],
+                'Accept' => 'application/json',
+            ])->post(rtrim($env['url'], '/') . '/category-sync/import', [
+                'categories' => array_values($selectedCategories),
+            ]);
+
+            if ($response->successful()) {
+                return response()->json([
+                    'success' => true,
+                    'message' => $response->json('message', '동기화 완료'),
+                    'imported' => $response->json('imported', 0),
+                    'skipped' => $response->json('skipped', 0),
+                ]);
+            }
+
+            return response()->json([
+                'error' => $response->json('error', '원격 서버 오류'),
+            ], $response->status());
+        } catch (\Exception $e) {
+            return response()->json(['error' => '연결 실패: ' . $e->getMessage()], 500);
+        }
+    }
+
+    /**
+     * Pull (원격 → 로컬)
+     */
+    public function pull(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'env' => 'required|string|in:dev,prod',
+            'category_keys' => 'required|array|min:1',
+            'category_keys.*' => 'string',
+        ]);
+
+        $environments = $this->getEnvironments();
+        $env = $environments[$validated['env']] ?? null;
+
+        if (! $env || empty($env['url'])) {
+            return response()->json(['error' => '환경 설정이 없습니다.'], 400);
+        }
+
+        // 원격 카테고리 조회
+        try {
+            $remoteCategories = $this->fetchRemoteCategories($env);
+        } catch (\Exception $e) {
+            return response()->json(['error' => $e->getMessage()], 500);
+        }
+
+        // 선택된 카테고리만 필터링
+        $selectedCategories = array_filter($remoteCategories, function ($cat) use ($validated) {
+            $key = $this->makeCategoryKey($cat);
+            return in_array($key, $validated['category_keys']);
+        });
+
+        if (empty($selectedCategories)) {
+            return response()->json(['error' => '선택된 카테고리를 찾을 수 없습니다.'], 400);
+        }
+
+        // 로컬에 Import
+        $imported = 0;
+        $skipped = 0;
+
+        foreach ($selectedCategories as $catData) {
+            if ($catData['is_global']) {
+                $exists = GlobalCategory::where('code_group', $catData['code_group'])
+                    ->where('code', $catData['code'])
+                    ->exists();
+
+                if ($exists) {
+                    $skipped++;
+                    continue;
+                }
+
+                $parentId = null;
+                if (! empty($catData['parent_code'])) {
+                    $parent = GlobalCategory::where('code_group', $catData['code_group'])
+                        ->where('code', $catData['parent_code'])
+                        ->first();
+                    $parentId = $parent?->id;
+                }
+
+                GlobalCategory::create([
+                    'parent_id' => $parentId,
+                    'code_group' => $catData['code_group'],
+                    'code' => $catData['code'],
+                    'name' => $catData['name'],
+                    'sort_order' => $catData['sort_order'] ?? 0,
+                    'description' => $catData['description'] ?? null,
+                    'is_active' => $catData['is_active'] ?? true,
+                ]);
+            } else {
+                $tenantId = $this->getTenantId();
+
+                $exists = Category::withoutGlobalScopes()
+                    ->where('tenant_id', $tenantId)
+                    ->where('code_group', $catData['code_group'])
+                    ->where('code', $catData['code'])
+                    ->exists();
+
+                if ($exists) {
+                    $skipped++;
+                    continue;
+                }
+
+                $parentId = null;
+                if (! empty($catData['parent_code'])) {
+                    $parent = Category::withoutGlobalScopes()
+                        ->where('tenant_id', $tenantId)
+                        ->where('code_group', $catData['code_group'])
+                        ->where('code', $catData['parent_code'])
+                        ->first();
+                    $parentId = $parent?->id;
+                }
+
+                Category::create([
+                    'tenant_id' => $tenantId,
+                    'parent_id' => $parentId,
+                    'code_group' => $catData['code_group'],
+                    'code' => $catData['code'],
+                    'name' => $catData['name'],
+                    'sort_order' => $catData['sort_order'] ?? 0,
+                    'description' => $catData['description'] ?? null,
+                    'is_active' => $catData['is_active'] ?? true,
+                ]);
+            }
+            $imported++;
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => "{$imported}개 카테고리가 동기화되었습니다." . ($skipped > 0 ? " ({$skipped}개 스킵)" : ''),
+            'imported' => $imported,
+            'skipped' => $skipped,
+        ]);
+    }
+
+    /**
+     * 카테고리 목록 조회 (글로벌 + 테넌트)
+     */
+    private function getCategoryList(): array
+    {
+        $tenantId = $this->getTenantId();
+        $categories = [];
+
+        // 글로벌 카테고리
+        $globalCategories = GlobalCategory::whereNull('deleted_at')
+            ->orderBy('code_group')
+            ->orderBy('sort_order')
+            ->get();
+
+        foreach ($globalCategories as $cat) {
+            $parentCode = null;
+            if ($cat->parent_id) {
+                $parent = GlobalCategory::find($cat->parent_id);
+                $parentCode = $parent?->code;
+            }
+
+            $categories[] = [
+                'is_global' => true,
+                'tenant_id' => null,
+                'code_group' => $cat->code_group,
+                'code' => $cat->code,
+                'name' => $cat->name,
+                'parent_code' => $parentCode,
+                'sort_order' => $cat->sort_order,
+                'description' => $cat->description,
+                'is_active' => $cat->is_active,
+            ];
+        }
+
+        // 테넌트 카테고리
+        $tenantCategories = Category::withoutGlobalScopes()
+            ->where('tenant_id', $tenantId)
+            ->whereNull('deleted_at')
+            ->orderBy('code_group')
+            ->orderBy('sort_order')
+            ->get();
+
+        foreach ($tenantCategories as $cat) {
+            $parentCode = null;
+            if ($cat->parent_id) {
+                $parent = Category::withoutGlobalScopes()->find($cat->parent_id);
+                $parentCode = $parent?->code;
+            }
+
+            $categories[] = [
+                'is_global' => false,
+                'tenant_id' => $cat->tenant_id,
+                'code_group' => $cat->code_group,
+                'code' => $cat->code,
+                'name' => $cat->name,
+                'parent_code' => $parentCode,
+                'sort_order' => $cat->sort_order,
+                'description' => $cat->description,
+                'is_active' => $cat->is_active,
+            ];
+        }
+
+        return $categories;
+    }
+
+    /**
+     * 원격 카테고리 조회
+     */
+    private function fetchRemoteCategories(array $env): array
+    {
+        $response = Http::withHeaders([
+            'X-Menu-Sync-Key' => $env['api_key'],
+            'Accept' => 'application/json',
+        ])->timeout(10)->get(rtrim($env['url'], '/') . '/category-sync/export');
+
+        if (! $response->successful()) {
+            throw new \Exception('API 오류: HTTP ' . $response->status());
+        }
+
+        $data = $response->json();
+        if (! isset($data['categories'])) {
+            throw new \Exception('잘못된 응답 형식');
+        }
+
+        return $data['categories'];
+    }
+
+    /**
+     * 카테고리 키 생성 (유니크 식별자)
+     */
+    private function makeCategoryKey(array $cat): string
+    {
+        $typePart = $cat['is_global'] ? 'global' : "tenant:{$cat['tenant_id']}";
+        return "{$typePart}:{$cat['code_group']}:{$cat['code']}";
+    }
+
+    /**
+     * 차이점 계산
+     */
+    private function calculateDiff(array $localCategories, array $remoteCategories): array
+    {
+        $localKeys = array_map(fn($c) => $this->makeCategoryKey($c), $localCategories);
+        $remoteKeys = array_map(fn($c) => $this->makeCategoryKey($c), $remoteCategories);
+
+        return [
+            'local_only' => array_values(array_diff($localKeys, $remoteKeys)),
+            'remote_only' => array_values(array_diff($remoteKeys, $localKeys)),
+            'both' => array_values(array_intersect($localKeys, $remoteKeys)),
+        ];
+    }
+}
\ No newline at end of file
diff --git a/app/Http/Controllers/CommonCodeSyncController.php b/app/Http/Controllers/CommonCodeSyncController.php
new file mode 100644
index 00000000..ba1b8f92
--- /dev/null
+++ b/app/Http/Controllers/CommonCodeSyncController.php
@@ -0,0 +1,388 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Products\CommonCode;
+use App\Models\Tenants\TenantSetting;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Support\Facades\Http;
+
+class CommonCodeSyncController extends Controller
+{
+    /**
+     * 현재 선택된 테넌트 ID
+     */
+    protected function getTenantId(): int
+    {
+        $tenantId = session('selected_tenant_id');
+        return ($tenantId && $tenantId !== 'all') ? (int) $tenantId : 1;
+    }
+
+    /**
+     * 환경 설정 조회 (메뉴 동기화와 공유)
+     */
+    private function getEnvironments(): array
+    {
+        $setting = TenantSetting::withoutGlobalScopes()
+            ->where('tenant_id', $this->getTenantId())
+            ->where('setting_group', 'menu_sync')
+            ->where('setting_key', 'environments')
+            ->first();
+
+        return $setting?->setting_value ?? [
+            'dev' => ['name' => '개발', 'url' => '', 'api_key' => ''],
+            'prod' => ['name' => '운영', 'url' => '', 'api_key' => ''],
+        ];
+    }
+
+    /**
+     * 공통코드 동기화 페이지
+     */
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('common-codes.sync.index'));
+        }
+
+        $environments = $this->getEnvironments();
+        $selectedEnv = $request->get('env', 'dev');
+
+        // 로컬 코드 조회
+        $localCodes = $this->getCodeList();
+
+        // 원격 코드 조회
+        $remoteCodes = [];
+        $remoteError = null;
+
+        if (! empty($environments[$selectedEnv]['url'])) {
+            try {
+                $remoteCodes = $this->fetchRemoteCodes($environments[$selectedEnv]);
+            } catch (\Exception $e) {
+                $remoteError = $e->getMessage();
+            }
+        }
+
+        // 차이점 계산
+        $diff = $this->calculateDiff($localCodes, $remoteCodes);
+
+        return view('common-codes.sync', [
+            'environments' => $environments,
+            'selectedEnv' => $selectedEnv,
+            'localCodes' => $localCodes,
+            'remoteCodes' => $remoteCodes,
+            'remoteError' => $remoteError,
+            'diff' => $diff,
+        ]);
+    }
+
+    /**
+     * 공통코드 Export API (다른 환경에서 호출)
+     */
+    public function export(Request $request): JsonResponse
+    {
+        // API Key 검증
+        $apiKey = $request->header('X-Menu-Sync-Key');
+        $validKey = config('app.menu_sync_api_key', env('MENU_SYNC_API_KEY'));
+
+        if (empty($validKey) || $apiKey !== $validKey) {
+            return response()->json(['error' => 'Unauthorized'], 401);
+        }
+
+        $codes = $this->getCodeList();
+
+        return response()->json([
+            'success' => true,
+            'environment' => config('app.env'),
+            'exported_at' => now()->toIso8601String(),
+            'codes' => $codes,
+        ]);
+    }
+
+    /**
+     * 공통코드 Import API (다른 환경에서 호출)
+     */
+    public function import(Request $request): JsonResponse
+    {
+        // API Key 검증
+        $apiKey = $request->header('X-Menu-Sync-Key');
+        $validKey = config('app.menu_sync_api_key', env('MENU_SYNC_API_KEY'));
+
+        if (empty($validKey) || $apiKey !== $validKey) {
+            return response()->json(['error' => 'Unauthorized'], 401);
+        }
+
+        $validated = $request->validate([
+            'codes' => 'required|array',
+            'codes.*.tenant_id' => 'nullable|integer',
+            'codes.*.code_group' => 'required|string|max:50',
+            'codes.*.code' => 'required|string|max:50',
+            'codes.*.name' => 'required|string|max:100',
+            'codes.*.sort_order' => 'nullable|integer',
+            'codes.*.attributes' => 'nullable|array',
+            'codes.*.is_active' => 'nullable|boolean',
+        ]);
+
+        $imported = 0;
+        $skipped = 0;
+
+        foreach ($validated['codes'] as $codeData) {
+            // 동일 코드 존재 확인
+            $exists = CommonCode::query()
+                ->where('tenant_id', $codeData['tenant_id'] ?? null)
+                ->where('code_group', $codeData['code_group'])
+                ->where('code', $codeData['code'])
+                ->exists();
+
+            if ($exists) {
+                $skipped++;
+                continue;
+            }
+
+            CommonCode::create([
+                'tenant_id' => $codeData['tenant_id'] ?? null,
+                'code_group' => $codeData['code_group'],
+                'code' => $codeData['code'],
+                'name' => $codeData['name'],
+                'sort_order' => $codeData['sort_order'] ?? 0,
+                'attributes' => $codeData['attributes'] ?? null,
+                'is_active' => $codeData['is_active'] ?? true,
+            ]);
+            $imported++;
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => "{$imported}개 코드가 동기화되었습니다." . ($skipped > 0 ? " ({$skipped}개 스킵)" : ''),
+            'imported' => $imported,
+            'skipped' => $skipped,
+        ]);
+    }
+
+    /**
+     * Push (로컬 → 원격)
+     */
+    public function push(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'env' => 'required|string|in:dev,prod',
+            'code_keys' => 'required|array|min:1',
+            'code_keys.*' => 'string',
+        ]);
+
+        $environments = $this->getEnvironments();
+        $env = $environments[$validated['env']] ?? null;
+
+        if (! $env || empty($env['url'])) {
+            return response()->json(['error' => '환경 설정이 없습니다.'], 400);
+        }
+
+        // 선택된 코드 조회
+        $localCodes = $this->getCodeList();
+        $selectedCodes = array_filter($localCodes, function ($code) use ($validated) {
+            $key = $this->makeCodeKey($code);
+            return in_array($key, $validated['code_keys']);
+        });
+
+        if (empty($selectedCodes)) {
+            return response()->json(['error' => '선택된 코드가 없습니다.'], 400);
+        }
+
+        // 원격 서버로 전송
+        try {
+            $response = Http::withHeaders([
+                'X-Menu-Sync-Key' => $env['api_key'],
+                'Accept' => 'application/json',
+            ])->post(rtrim($env['url'], '/') . '/common-code-sync/import', [
+                'codes' => array_values($selectedCodes),
+            ]);
+
+            if ($response->successful()) {
+                return response()->json([
+                    'success' => true,
+                    'message' => $response->json('message', '동기화 완료'),
+                    'imported' => $response->json('imported', 0),
+                    'skipped' => $response->json('skipped', 0),
+                ]);
+            }
+
+            return response()->json([
+                'error' => $response->json('error', '원격 서버 오류'),
+            ], $response->status());
+        } catch (\Exception $e) {
+            return response()->json(['error' => '연결 실패: ' . $e->getMessage()], 500);
+        }
+    }
+
+    /**
+     * Pull (원격 → 로컬)
+     */
+    public function pull(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'env' => 'required|string|in:dev,prod',
+            'code_keys' => 'required|array|min:1',
+            'code_keys.*' => 'string',
+        ]);
+
+        $environments = $this->getEnvironments();
+        $env = $environments[$validated['env']] ?? null;
+
+        if (! $env || empty($env['url'])) {
+            return response()->json(['error' => '환경 설정이 없습니다.'], 400);
+        }
+
+        // 원격 코드 조회
+        try {
+            $remoteCodes = $this->fetchRemoteCodes($env);
+        } catch (\Exception $e) {
+            return response()->json(['error' => $e->getMessage()], 500);
+        }
+
+        // 선택된 코드만 필터링
+        $selectedCodes = array_filter($remoteCodes, function ($code) use ($validated) {
+            $key = $this->makeCodeKey($code);
+            return in_array($key, $validated['code_keys']);
+        });
+
+        if (empty($selectedCodes)) {
+            return response()->json(['error' => '선택된 코드를 찾을 수 없습니다.'], 400);
+        }
+
+        // 로컬에 Import
+        $imported = 0;
+        $skipped = 0;
+
+        foreach ($selectedCodes as $codeData) {
+            // 동일 코드 존재 확인
+            $exists = CommonCode::query()
+                ->where('tenant_id', $codeData['tenant_id'] ?? null)
+                ->where('code_group', $codeData['code_group'])
+                ->where('code', $codeData['code'])
+                ->exists();
+
+            if ($exists) {
+                $skipped++;
+                continue;
+            }
+
+            CommonCode::create([
+                'tenant_id' => $codeData['tenant_id'] ?? null,
+                'code_group' => $codeData['code_group'],
+                'code' => $codeData['code'],
+                'name' => $codeData['name'],
+                'sort_order' => $codeData['sort_order'] ?? 0,
+                'attributes' => $codeData['attributes'] ?? null,
+                'is_active' => $codeData['is_active'] ?? true,
+            ]);
+            $imported++;
+        }
+
+        return response()->json([
+            'success' => true,
+            'message' => "{$imported}개 코드가 동기화되었습니다." . ($skipped > 0 ? " ({$skipped}개 스킵)" : ''),
+            'imported' => $imported,
+            'skipped' => $skipped,
+        ]);
+    }
+
+    /**
+     * 코드 목록 조회 (글로벌 + 테넌트)
+     */
+    private function getCodeList(): array
+    {
+        $tenantId = $this->getTenantId();
+
+        // 글로벌 코드 (tenant_id IS NULL)
+        $globalCodes = CommonCode::query()
+            ->whereNull('tenant_id')
+            ->orderBy('code_group')
+            ->orderBy('sort_order')
+            ->get();
+
+        // 테넌트 코드
+        $tenantCodes = CommonCode::query()
+            ->where('tenant_id', $tenantId)
+            ->orderBy('code_group')
+            ->orderBy('sort_order')
+            ->get();
+
+        $codes = [];
+
+        foreach ($globalCodes as $code) {
+            $codes[] = [
+                'tenant_id' => null,
+                'code_group' => $code->code_group,
+                'code' => $code->code,
+                'name' => $code->name,
+                'sort_order' => $code->sort_order,
+                'attributes' => $code->attributes,
+                'is_active' => $code->is_active,
+                'is_global' => true,
+            ];
+        }
+
+        foreach ($tenantCodes as $code) {
+            $codes[] = [
+                'tenant_id' => $code->tenant_id,
+                'code_group' => $code->code_group,
+                'code' => $code->code,
+                'name' => $code->name,
+                'sort_order' => $code->sort_order,
+                'attributes' => $code->attributes,
+                'is_active' => $code->is_active,
+                'is_global' => false,
+            ];
+        }
+
+        return $codes;
+    }
+
+    /**
+     * 원격 코드 조회
+     */
+    private function fetchRemoteCodes(array $env): array
+    {
+        $response = Http::withHeaders([
+            'X-Menu-Sync-Key' => $env['api_key'],
+            'Accept' => 'application/json',
+        ])->timeout(10)->get(rtrim($env['url'], '/') . '/common-code-sync/export');
+
+        if (! $response->successful()) {
+            throw new \Exception('API 오류: HTTP ' . $response->status());
+        }
+
+        $data = $response->json();
+        if (! isset($data['codes'])) {
+            throw new \Exception('잘못된 응답 형식');
+        }
+
+        return $data['codes'];
+    }
+
+    /**
+     * 코드 키 생성 (유니크 식별자)
+     */
+    private function makeCodeKey(array $code): string
+    {
+        $tenantPart = $code['tenant_id'] ?? 'global';
+        return "{$tenantPart}:{$code['code_group']}:{$code['code']}";
+    }
+
+    /**
+     * 차이점 계산
+     */
+    private function calculateDiff(array $localCodes, array $remoteCodes): array
+    {
+        $localKeys = array_map(fn($c) => $this->makeCodeKey($c), $localCodes);
+        $remoteKeys = array_map(fn($c) => $this->makeCodeKey($c), $remoteCodes);
+
+        return [
+            'local_only' => array_values(array_diff($localKeys, $remoteKeys)),
+            'remote_only' => array_values(array_diff($remoteKeys, $localKeys)),
+            'both' => array_values(array_intersect($localKeys, $remoteKeys)),
+        ];
+    }
+}
\ No newline at end of file
diff --git a/resources/views/categories/index.blade.php b/resources/views/categories/index.blade.php
index 4b4fd318..cdc37599 100644
--- a/resources/views/categories/index.blade.php
+++ b/resources/views/categories/index.blade.php
@@ -22,16 +22,25 @@
                 @endif
             </p>
         </div>
-        @if($tenant)
-            <button type="button"
-                    onclick="openAddModal()"
-                    class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+        <div class="flex items-center gap-2">
+            <a href="{{ route('categories.sync.index') }}"
+               class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
                 <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
                 </svg>
-                카테고리 추가
-            </button>
-        @endif
+                동기화
+            </a>
+            @if($tenant)
+                <button type="button"
+                        onclick="openAddModal()"
+                        class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                    </svg>
+                    카테고리 추가
+                </button>
+            @endif
+        </div>
     </div>
 
     <!-- 테넌트 미선택 경고 -->
diff --git a/resources/views/categories/sync.blade.php b/resources/views/categories/sync.blade.php
new file mode 100644
index 00000000..a9d9ea69
--- /dev/null
+++ b/resources/views/categories/sync.blade.php
@@ -0,0 +1,369 @@
+@extends('layouts.app')
+
+@section('title', '카테고리 동기화')
+
+@section('content')
+<div class="flex flex-col h-full">
+    <!-- 페이지 헤더 -->
+    <div class="flex flex-col sm:flex-row sm:justify-between sm:items-center gap-4 mb-6 flex-shrink-0">
+        <div>
+            <h1 class="text-2xl font-bold text-gray-800">카테고리 동기화</h1>
+            <p class="text-sm text-gray-500 mt-1">로컬과 원격 환경 간 카테고리를 동기화합니다.</p>
+        </div>
+        <a href="{{ route('menus.sync.index') }}"
+           class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+            </svg>
+            환경 설정 (메뉴 동기화)
+        </a>
+    </div>
+
+    <!-- 환경 선택 탭 -->
+    <div class="bg-white rounded-lg shadow-sm mb-4">
+        <div class="border-b border-gray-200">
+            <nav class="flex -mb-px" aria-label="Tabs">
+                @foreach($environments as $key => $env)
+                    <a href="{{ route('categories.sync.index', ['env' => $key]) }}"
+                       class="px-6 py-3 text-sm font-medium border-b-2 transition-colors
+                              {{ $selectedEnv === $key
+                                  ? 'border-blue-500 text-blue-600'
+                                  : 'border-transparent text-gray-500 hover:text-gray-700 hover:border-gray-300' }}">
+                        로컬 ↔ {{ $env['name'] ?? strtoupper($key) }}
+                        @if(empty($env['url']))
+                            <span class="ml-1 text-xs text-gray-400">(미설정)</span>
+                        @endif
+                    </a>
+                @endforeach
+            </nav>
+        </div>
+    </div>
+
+    @if($remoteError)
+        <div class="mb-4 bg-red-50 border border-red-200 text-red-700 px-4 py-3 rounded-lg flex items-center gap-2">
+            <svg class="w-5 h-5 text-red-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+            </svg>
+            원격 서버 연결 실패: {{ $remoteError }}
+        </div>
+    @endif
+
+    @if(empty($environments[$selectedEnv]['url']))
+        <div class="mb-4 bg-yellow-50 border border-yellow-200 text-yellow-700 px-4 py-3 rounded-lg flex items-center gap-2">
+            <svg class="w-5 h-5 text-yellow-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+            </svg>
+            <a href="{{ route('menus.sync.index') }}" class="underline">메뉴 동기화 환경 설정</a>에서 {{ $environments[$selectedEnv]['name'] ?? strtoupper($selectedEnv) }} 서버 URL을 설정해주세요.
+        </div>
+    @endif
+
+    <!-- 동기화 요약 -->
+    @if(!empty($environments[$selectedEnv]['url']) && !$remoteError)
+        <div class="grid grid-cols-3 gap-4 mb-4">
+            <div class="bg-green-50 border border-green-200 rounded-lg p-4">
+                <div class="flex items-center gap-2">
+                    <span class="w-8 h-8 bg-green-100 rounded-full flex items-center justify-center">
+                        <svg class="w-5 h-5 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                        </svg>
+                    </span>
+                    <div>
+                        <p class="text-sm font-medium text-green-800">로컬에만 있음</p>
+                        <p class="text-2xl font-bold text-green-600">{{ count($diff['local_only']) }}</p>
+                    </div>
+                </div>
+            </div>
+            <div class="bg-blue-50 border border-blue-200 rounded-lg p-4">
+                <div class="flex items-center gap-2">
+                    <span class="w-8 h-8 bg-blue-100 rounded-full flex items-center justify-center">
+                        <svg class="w-5 h-5 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
+                        </svg>
+                    </span>
+                    <div>
+                        <p class="text-sm font-medium text-blue-800">양쪽 모두</p>
+                        <p class="text-2xl font-bold text-blue-600">{{ count($diff['both']) }}</p>
+                    </div>
+                </div>
+            </div>
+            <div class="bg-purple-50 border border-purple-200 rounded-lg p-4">
+                <div class="flex items-center gap-2">
+                    <span class="w-8 h-8 bg-purple-100 rounded-full flex items-center justify-center">
+                        <svg class="w-5 h-5 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16l-4-4m0 0l4-4m-4 4h18" />
+                        </svg>
+                    </span>
+                    <div>
+                        <p class="text-sm font-medium text-purple-800">원격에만 있음</p>
+                        <p class="text-2xl font-bold text-purple-600">{{ count($diff['remote_only']) }}</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    @endif
+
+    <!-- 카테고리 비교 테이블 -->
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 flex-1 min-h-0">
+        <!-- 로컬 카테고리 -->
+        <div class="bg-white rounded-lg shadow-sm flex flex-col">
+            <div class="px-4 py-3 border-b border-gray-200 flex items-center justify-between flex-shrink-0">
+                <div class="flex items-center gap-2">
+                    <input type="checkbox" id="selectAllLocal" onchange="toggleSelectAll('local', this.checked)"
+                           class="w-4 h-4 text-green-600 border-gray-300 rounded focus:ring-green-500">
+                    <span class="w-6 h-6 bg-green-100 rounded flex items-center justify-center">
+                        <svg class="w-4 h-4 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
+                        </svg>
+                    </span>
+                    <h3 class="font-semibold text-gray-800">로컬 (현재)</h3>
+                    <span class="text-xs text-gray-500">({{ count($localCategories) }}개)</span>
+                </div>
+                @if(!empty($environments[$selectedEnv]['url']) && !$remoteError)
+                    <div class="flex items-center gap-2">
+                        <span id="localSelectedCount" class="text-xs text-gray-500">0개 선택</span>
+                        <button type="button" onclick="pushSelected()"
+                                class="px-3 py-1.5 bg-green-600 hover:bg-green-700 text-white text-xs font-medium rounded transition-colors flex items-center gap-1">
+                            Push →
+                        </button>
+                    </div>
+                @endif
+            </div>
+            <div class="overflow-auto flex-1">
+                <table class="w-full text-sm">
+                    <thead class="bg-gray-50 sticky top-0">
+                        <tr>
+                            <th class="px-3 py-2 text-center w-10"></th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">타입</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">그룹</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">코드</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">이름</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">상위</th>
+                        </tr>
+                    </thead>
+                    <tbody class="divide-y divide-gray-100">
+                        @forelse($localCategories as $cat)
+                            @php
+                                $typePart = $cat['is_global'] ? 'global' : 'tenant:' . $cat['tenant_id'];
+                                $key = $typePart . ':' . $cat['code_group'] . ':' . $cat['code'];
+                                $inBoth = in_array($key, $diff['both']);
+                                $localOnly = in_array($key, $diff['local_only']);
+                            @endphp
+                            <tr class="{{ $inBoth ? 'bg-blue-50/50' : ($localOnly ? 'bg-green-50/50' : '') }}">
+                                <td class="px-3 py-2 text-center">
+                                    <input type="checkbox" name="local_cat" value="{{ $key }}"
+                                           class="w-4 h-4 text-green-600 border-gray-300 rounded focus:ring-green-500"
+                                           {{ $inBoth ? 'disabled' : '' }}>
+                                </td>
+                                <td class="px-3 py-2">
+                                    @if($cat['is_global'])
+                                        <span class="px-1.5 py-0.5 bg-purple-100 text-purple-700 text-xs rounded">글로벌</span>
+                                    @else
+                                        <span class="px-1.5 py-0.5 bg-blue-100 text-blue-700 text-xs rounded">테넌트</span>
+                                    @endif
+                                </td>
+                                <td class="px-3 py-2 font-mono text-xs text-gray-600">{{ $cat['code_group'] }}</td>
+                                <td class="px-3 py-2 font-mono text-xs">{{ $cat['code'] }}</td>
+                                <td class="px-3 py-2">{{ $cat['name'] }}</td>
+                                <td class="px-3 py-2 text-xs text-gray-500">{{ $cat['parent_code'] ?? '-' }}</td>
+                            </tr>
+                        @empty
+                            <tr>
+                                <td colspan="6" class="px-3 py-8 text-center text-gray-400">카테고리가 없습니다.</td>
+                            </tr>
+                        @endforelse
+                    </tbody>
+                </table>
+            </div>
+        </div>
+
+        <!-- 원격 카테고리 -->
+        <div class="bg-white rounded-lg shadow-sm flex flex-col">
+            <div class="px-4 py-3 border-b border-gray-200 flex items-center justify-between flex-shrink-0">
+                <div class="flex items-center gap-2">
+                    <input type="checkbox" id="selectAllRemote" onchange="toggleSelectAll('remote', this.checked)"
+                           class="w-4 h-4 text-purple-600 border-gray-300 rounded focus:ring-purple-500">
+                    <span class="w-6 h-6 bg-purple-100 rounded flex items-center justify-center">
+                        <svg class="w-4 h-4 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 15a4 4 0 004 4h9a5 5 0 10-.1-9.999 5.002 5.002 0 10-9.78 2.096A4.001 4.001 0 003 15z" />
+                        </svg>
+                    </span>
+                    <h3 class="font-semibold text-gray-800">{{ $environments[$selectedEnv]['name'] ?? strtoupper($selectedEnv) }}</h3>
+                    <span class="text-xs text-gray-500">({{ count($remoteCategories) }}개)</span>
+                </div>
+                @if(!empty($environments[$selectedEnv]['url']) && !$remoteError)
+                    <div class="flex items-center gap-2">
+                        <span id="remoteSelectedCount" class="text-xs text-gray-500">0개 선택</span>
+                        <button type="button" onclick="pullSelected()"
+                                class="px-3 py-1.5 bg-purple-600 hover:bg-purple-700 text-white text-xs font-medium rounded transition-colors flex items-center gap-1">
+                            ← Pull
+                        </button>
+                    </div>
+                @endif
+            </div>
+            <div class="overflow-auto flex-1">
+                @if(empty($environments[$selectedEnv]['url']))
+                    <div class="flex items-center justify-center h-full text-gray-400">
+                        <p>환경을 설정해주세요</p>
+                    </div>
+                @elseif($remoteError)
+                    <div class="flex items-center justify-center h-full text-red-400">
+                        <p>연결 실패</p>
+                    </div>
+                @elseif(empty($remoteCategories))
+                    <div class="flex items-center justify-center h-full text-gray-400">
+                        <p>카테고리가 없습니다</p>
+                    </div>
+                @else
+                    <table class="w-full text-sm">
+                        <thead class="bg-gray-50 sticky top-0">
+                            <tr>
+                                <th class="px-3 py-2 text-center w-10"></th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">타입</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">그룹</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">코드</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">이름</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">상위</th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-gray-100">
+                            @foreach($remoteCategories as $cat)
+                                @php
+                                    $typePart = $cat['is_global'] ? 'global' : 'tenant:' . ($cat['tenant_id'] ?? '');
+                                    $key = $typePart . ':' . $cat['code_group'] . ':' . $cat['code'];
+                                    $inBoth = in_array($key, $diff['both']);
+                                    $remoteOnly = in_array($key, $diff['remote_only']);
+                                @endphp
+                                <tr class="{{ $inBoth ? 'bg-blue-50/50' : ($remoteOnly ? 'bg-purple-50/50' : '') }}">
+                                    <td class="px-3 py-2 text-center">
+                                        <input type="checkbox" name="remote_cat" value="{{ $key }}"
+                                               class="w-4 h-4 text-purple-600 border-gray-300 rounded focus:ring-purple-500"
+                                               {{ $inBoth ? 'disabled' : '' }}>
+                                    </td>
+                                    <td class="px-3 py-2">
+                                        @if($cat['is_global'])
+                                            <span class="px-1.5 py-0.5 bg-purple-100 text-purple-700 text-xs rounded">글로벌</span>
+                                        @else
+                                            <span class="px-1.5 py-0.5 bg-blue-100 text-blue-700 text-xs rounded">테넌트</span>
+                                        @endif
+                                    </td>
+                                    <td class="px-3 py-2 font-mono text-xs text-gray-600">{{ $cat['code_group'] }}</td>
+                                    <td class="px-3 py-2 font-mono text-xs">{{ $cat['code'] }}</td>
+                                    <td class="px-3 py-2">{{ $cat['name'] }}</td>
+                                    <td class="px-3 py-2 text-xs text-gray-500">{{ $cat['parent_code'] ?? '-' }}</td>
+                                </tr>
+                            @endforeach
+                        </tbody>
+                    </table>
+                @endif
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+    const selectedEnv = '{{ $selectedEnv }}';
+    const csrfToken = '{{ csrf_token() }}';
+
+    // 전체 선택
+    function toggleSelectAll(side, checked) {
+        const checkboxes = document.querySelectorAll(`input[name="${side}_cat"]:not(:disabled)`);
+        checkboxes.forEach(cb => cb.checked = checked);
+        updateSelectedCount(side);
+    }
+
+    // 선택된 개수 업데이트
+    function updateSelectedCount(side) {
+        const checkboxes = document.querySelectorAll(`input[name="${side}_cat"]:checked`);
+        const countEl = document.getElementById(`${side}SelectedCount`);
+        if (countEl) {
+            countEl.textContent = `${checkboxes.length}개 선택`;
+        }
+    }
+
+    // 체크박스 변경 이벤트 리스너
+    document.addEventListener('change', function(e) {
+        if (e.target.name === 'local_cat') {
+            updateSelectedCount('local');
+        } else if (e.target.name === 'remote_cat') {
+            updateSelectedCount('remote');
+        }
+    });
+
+    // Push
+    async function pushSelected() {
+        const checkboxes = document.querySelectorAll('input[name="local_cat"]:checked');
+        if (checkboxes.length === 0) {
+            alert('Push할 카테고리를 선택해주세요.');
+            return;
+        }
+
+        const categoryKeys = Array.from(checkboxes).map(cb => cb.value);
+
+        if (!confirm(`${categoryKeys.length}개 카테고리를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
+            return;
+        }
+
+        try {
+            const response = await fetch('{{ route("categories.sync.push") }}', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRF-TOKEN': csrfToken,
+                    'Accept': 'application/json'
+                },
+                body: JSON.stringify({ env: selectedEnv, category_keys: categoryKeys })
+            });
+
+            const result = await response.json();
+            if (result.success) {
+                alert(result.message);
+                location.reload();
+            } else {
+                alert(result.error || 'Push 실패');
+            }
+        } catch (e) {
+            alert('오류 발생: ' + e.message);
+        }
+    }
+
+    // Pull
+    async function pullSelected() {
+        const checkboxes = document.querySelectorAll('input[name="remote_cat"]:checked');
+        if (checkboxes.length === 0) {
+            alert('Pull할 카테고리를 선택해주세요.');
+            return;
+        }
+
+        const categoryKeys = Array.from(checkboxes).map(cb => cb.value);
+
+        if (!confirm(`${categoryKeys.length}개 카테고리를 로컬로 Pull 하시겠습니까?`)) {
+            return;
+        }
+
+        try {
+            const response = await fetch('{{ route("categories.sync.pull") }}', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRF-TOKEN': csrfToken,
+                    'Accept': 'application/json'
+                },
+                body: JSON.stringify({ env: selectedEnv, category_keys: categoryKeys })
+            });
+
+            const result = await response.json();
+            if (result.success) {
+                alert(result.message);
+                location.reload();
+            } else {
+                alert(result.error || 'Pull 실패');
+            }
+        } catch (e) {
+            alert('오류 발생: ' + e.message);
+        }
+    }
+</script>
+@endpush
\ No newline at end of file
diff --git a/resources/views/common-codes/index.blade.php b/resources/views/common-codes/index.blade.php
index 43ae126b..7daa3483 100644
--- a/resources/views/common-codes/index.blade.php
+++ b/resources/views/common-codes/index.blade.php
@@ -22,16 +22,25 @@
                 @endif
             </p>
         </div>
-        @if($tenant)
-            <button type="button"
-                    onclick="openAddModal()"
-                    class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+        <div class="flex items-center gap-2">
+            <a href="{{ route('common-codes.sync.index') }}"
+               class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
                 <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
                 </svg>
-                코드 추가
-            </button>
-        @endif
+                동기화
+            </a>
+            @if($tenant)
+                <button type="button"
+                        onclick="openAddModal()"
+                        class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                    </svg>
+                    코드 추가
+                </button>
+            @endif
+        </div>
     </div>
 
     <!-- 테넌트 미선택 경고 -->
diff --git a/resources/views/common-codes/sync.blade.php b/resources/views/common-codes/sync.blade.php
new file mode 100644
index 00000000..ef9335e8
--- /dev/null
+++ b/resources/views/common-codes/sync.blade.php
@@ -0,0 +1,370 @@
+@extends('layouts.app')
+
+@section('title', '공통코드 동기화')
+
+@section('content')
+<div class="flex flex-col h-full">
+    <!-- 페이지 헤더 -->
+    <div class="flex flex-col sm:flex-row sm:justify-between sm:items-center gap-4 mb-6 flex-shrink-0">
+        <div>
+            <h1 class="text-2xl font-bold text-gray-800">공통코드 동기화</h1>
+            <p class="text-sm text-gray-500 mt-1">로컬과 원격 환경 간 공통코드를 동기화합니다.</p>
+        </div>
+        <a href="{{ route('menus.sync.index') }}"
+           class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+            </svg>
+            환경 설정 (메뉴 동기화)
+        </a>
+    </div>
+
+    <!-- 환경 선택 탭 -->
+    <div class="bg-white rounded-lg shadow-sm mb-4">
+        <div class="border-b border-gray-200">
+            <nav class="flex -mb-px" aria-label="Tabs">
+                @foreach($environments as $key => $env)
+                    <a href="{{ route('common-codes.sync.index', ['env' => $key]) }}"
+                       class="px-6 py-3 text-sm font-medium border-b-2 transition-colors
+                              {{ $selectedEnv === $key
+                                  ? 'border-blue-500 text-blue-600'
+                                  : 'border-transparent text-gray-500 hover:text-gray-700 hover:border-gray-300' }}">
+                        로컬 ↔ {{ $env['name'] ?? strtoupper($key) }}
+                        @if(empty($env['url']))
+                            <span class="ml-1 text-xs text-gray-400">(미설정)</span>
+                        @endif
+                    </a>
+                @endforeach
+            </nav>
+        </div>
+    </div>
+
+    @if($remoteError)
+        <div class="mb-4 bg-red-50 border border-red-200 text-red-700 px-4 py-3 rounded-lg flex items-center gap-2">
+            <svg class="w-5 h-5 text-red-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+            </svg>
+            원격 서버 연결 실패: {{ $remoteError }}
+        </div>
+    @endif
+
+    @if(empty($environments[$selectedEnv]['url']))
+        <div class="mb-4 bg-yellow-50 border border-yellow-200 text-yellow-700 px-4 py-3 rounded-lg flex items-center gap-2">
+            <svg class="w-5 h-5 text-yellow-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+            </svg>
+            <a href="{{ route('menus.sync.index') }}" class="underline">메뉴 동기화 환경 설정</a>에서 {{ $environments[$selectedEnv]['name'] ?? strtoupper($selectedEnv) }} 서버 URL을 설정해주세요.
+        </div>
+    @endif
+
+    <!-- 동기화 요약 -->
+    @if(!empty($environments[$selectedEnv]['url']) && !$remoteError)
+        <div class="grid grid-cols-3 gap-4 mb-4">
+            <div class="bg-green-50 border border-green-200 rounded-lg p-4">
+                <div class="flex items-center gap-2">
+                    <span class="w-8 h-8 bg-green-100 rounded-full flex items-center justify-center">
+                        <svg class="w-5 h-5 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                        </svg>
+                    </span>
+                    <div>
+                        <p class="text-sm font-medium text-green-800">로컬에만 있음</p>
+                        <p class="text-2xl font-bold text-green-600">{{ count($diff['local_only']) }}</p>
+                    </div>
+                </div>
+            </div>
+            <div class="bg-blue-50 border border-blue-200 rounded-lg p-4">
+                <div class="flex items-center gap-2">
+                    <span class="w-8 h-8 bg-blue-100 rounded-full flex items-center justify-center">
+                        <svg class="w-5 h-5 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7h12m0 0l-4-4m4 4l-4 4m0 6H4m0 0l4 4m-4-4l4-4" />
+                        </svg>
+                    </span>
+                    <div>
+                        <p class="text-sm font-medium text-blue-800">양쪽 모두</p>
+                        <p class="text-2xl font-bold text-blue-600">{{ count($diff['both']) }}</p>
+                    </div>
+                </div>
+            </div>
+            <div class="bg-purple-50 border border-purple-200 rounded-lg p-4">
+                <div class="flex items-center gap-2">
+                    <span class="w-8 h-8 bg-purple-100 rounded-full flex items-center justify-center">
+                        <svg class="w-5 h-5 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M7 16l-4-4m0 0l4-4m-4 4h18" />
+                        </svg>
+                    </span>
+                    <div>
+                        <p class="text-sm font-medium text-purple-800">원격에만 있음</p>
+                        <p class="text-2xl font-bold text-purple-600">{{ count($diff['remote_only']) }}</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+    @endif
+
+    <!-- 코드 비교 테이블 -->
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-6 flex-1 min-h-0">
+        <!-- 로컬 코드 -->
+        <div class="bg-white rounded-lg shadow-sm flex flex-col">
+            <div class="px-4 py-3 border-b border-gray-200 flex items-center justify-between flex-shrink-0">
+                <div class="flex items-center gap-2">
+                    <input type="checkbox" id="selectAllLocal" onchange="toggleSelectAll('local', this.checked)"
+                           class="w-4 h-4 text-green-600 border-gray-300 rounded focus:ring-green-500">
+                    <span class="w-6 h-6 bg-green-100 rounded flex items-center justify-center">
+                        <svg class="w-4 h-4 text-green-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z" />
+                        </svg>
+                    </span>
+                    <h3 class="font-semibold text-gray-800">로컬 (현재)</h3>
+                    <span class="text-xs text-gray-500">({{ count($localCodes) }}개)</span>
+                </div>
+                @if(!empty($environments[$selectedEnv]['url']) && !$remoteError)
+                    <div class="flex items-center gap-2">
+                        <span id="localSelectedCount" class="text-xs text-gray-500">0개 선택</span>
+                        <button type="button" onclick="pushSelected()"
+                                class="px-3 py-1.5 bg-green-600 hover:bg-green-700 text-white text-xs font-medium rounded transition-colors flex items-center gap-1">
+                            Push →
+                        </button>
+                    </div>
+                @endif
+            </div>
+            <div class="overflow-auto flex-1">
+                <table class="w-full text-sm">
+                    <thead class="bg-gray-50 sticky top-0">
+                        <tr>
+                            <th class="px-3 py-2 text-center w-10"></th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">타입</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">그룹</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">코드</th>
+                            <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">이름</th>
+                        </tr>
+                    </thead>
+                    <tbody class="divide-y divide-gray-100">
+                        @php
+                            $localCodeMap = [];
+                            foreach ($localCodes as $code) {
+                                $key = ($code['tenant_id'] ?? 'global') . ':' . $code['code_group'] . ':' . $code['code'];
+                                $localCodeMap[$key] = $code;
+                            }
+                        @endphp
+                        @forelse($localCodes as $code)
+                            @php
+                                $key = ($code['tenant_id'] ?? 'global') . ':' . $code['code_group'] . ':' . $code['code'];
+                                $inBoth = in_array($key, $diff['both']);
+                                $localOnly = in_array($key, $diff['local_only']);
+                            @endphp
+                            <tr class="{{ $inBoth ? 'bg-blue-50/50' : ($localOnly ? 'bg-green-50/50' : '') }}">
+                                <td class="px-3 py-2 text-center">
+                                    <input type="checkbox" name="local_code" value="{{ $key }}"
+                                           class="w-4 h-4 text-green-600 border-gray-300 rounded focus:ring-green-500"
+                                           {{ $inBoth ? 'disabled' : '' }}>
+                                </td>
+                                <td class="px-3 py-2">
+                                    @if($code['is_global'] ?? false)
+                                        <span class="px-1.5 py-0.5 bg-purple-100 text-purple-700 text-xs rounded">글로벌</span>
+                                    @else
+                                        <span class="px-1.5 py-0.5 bg-blue-100 text-blue-700 text-xs rounded">테넌트</span>
+                                    @endif
+                                </td>
+                                <td class="px-3 py-2 font-mono text-xs text-gray-600">{{ $code['code_group'] }}</td>
+                                <td class="px-3 py-2 font-mono text-xs">{{ $code['code'] }}</td>
+                                <td class="px-3 py-2">{{ $code['name'] }}</td>
+                            </tr>
+                        @empty
+                            <tr>
+                                <td colspan="5" class="px-3 py-8 text-center text-gray-400">코드가 없습니다.</td>
+                            </tr>
+                        @endforelse
+                    </tbody>
+                </table>
+            </div>
+        </div>
+
+        <!-- 원격 코드 -->
+        <div class="bg-white rounded-lg shadow-sm flex flex-col">
+            <div class="px-4 py-3 border-b border-gray-200 flex items-center justify-between flex-shrink-0">
+                <div class="flex items-center gap-2">
+                    <input type="checkbox" id="selectAllRemote" onchange="toggleSelectAll('remote', this.checked)"
+                           class="w-4 h-4 text-purple-600 border-gray-300 rounded focus:ring-purple-500">
+                    <span class="w-6 h-6 bg-purple-100 rounded flex items-center justify-center">
+                        <svg class="w-4 h-4 text-purple-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 15a4 4 0 004 4h9a5 5 0 10-.1-9.999 5.002 5.002 0 10-9.78 2.096A4.001 4.001 0 003 15z" />
+                        </svg>
+                    </span>
+                    <h3 class="font-semibold text-gray-800">{{ $environments[$selectedEnv]['name'] ?? strtoupper($selectedEnv) }}</h3>
+                    <span class="text-xs text-gray-500">({{ count($remoteCodes) }}개)</span>
+                </div>
+                @if(!empty($environments[$selectedEnv]['url']) && !$remoteError)
+                    <div class="flex items-center gap-2">
+                        <span id="remoteSelectedCount" class="text-xs text-gray-500">0개 선택</span>
+                        <button type="button" onclick="pullSelected()"
+                                class="px-3 py-1.5 bg-purple-600 hover:bg-purple-700 text-white text-xs font-medium rounded transition-colors flex items-center gap-1">
+                            ← Pull
+                        </button>
+                    </div>
+                @endif
+            </div>
+            <div class="overflow-auto flex-1">
+                @if(empty($environments[$selectedEnv]['url']))
+                    <div class="flex items-center justify-center h-full text-gray-400">
+                        <p>환경을 설정해주세요</p>
+                    </div>
+                @elseif($remoteError)
+                    <div class="flex items-center justify-center h-full text-red-400">
+                        <p>연결 실패</p>
+                    </div>
+                @elseif(empty($remoteCodes))
+                    <div class="flex items-center justify-center h-full text-gray-400">
+                        <p>코드가 없습니다</p>
+                    </div>
+                @else
+                    <table class="w-full text-sm">
+                        <thead class="bg-gray-50 sticky top-0">
+                            <tr>
+                                <th class="px-3 py-2 text-center w-10"></th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">타입</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">그룹</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">코드</th>
+                                <th class="px-3 py-2 text-left text-xs font-medium text-gray-500">이름</th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-gray-100">
+                            @foreach($remoteCodes as $code)
+                                @php
+                                    $key = ($code['tenant_id'] ?? 'global') . ':' . $code['code_group'] . ':' . $code['code'];
+                                    $inBoth = in_array($key, $diff['both']);
+                                    $remoteOnly = in_array($key, $diff['remote_only']);
+                                @endphp
+                                <tr class="{{ $inBoth ? 'bg-blue-50/50' : ($remoteOnly ? 'bg-purple-50/50' : '') }}">
+                                    <td class="px-3 py-2 text-center">
+                                        <input type="checkbox" name="remote_code" value="{{ $key }}"
+                                               class="w-4 h-4 text-purple-600 border-gray-300 rounded focus:ring-purple-500"
+                                               {{ $inBoth ? 'disabled' : '' }}>
+                                    </td>
+                                    <td class="px-3 py-2">
+                                        @if($code['is_global'] ?? false)
+                                            <span class="px-1.5 py-0.5 bg-purple-100 text-purple-700 text-xs rounded">글로벌</span>
+                                        @else
+                                            <span class="px-1.5 py-0.5 bg-blue-100 text-blue-700 text-xs rounded">테넌트</span>
+                                        @endif
+                                    </td>
+                                    <td class="px-3 py-2 font-mono text-xs text-gray-600">{{ $code['code_group'] }}</td>
+                                    <td class="px-3 py-2 font-mono text-xs">{{ $code['code'] }}</td>
+                                    <td class="px-3 py-2">{{ $code['name'] }}</td>
+                                </tr>
+                            @endforeach
+                        </tbody>
+                    </table>
+                @endif
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+    const selectedEnv = '{{ $selectedEnv }}';
+    const csrfToken = '{{ csrf_token() }}';
+
+    // 전체 선택
+    function toggleSelectAll(side, checked) {
+        const checkboxes = document.querySelectorAll(`input[name="${side}_code"]:not(:disabled)`);
+        checkboxes.forEach(cb => cb.checked = checked);
+        updateSelectedCount(side);
+    }
+
+    // 선택된 개수 업데이트
+    function updateSelectedCount(side) {
+        const checkboxes = document.querySelectorAll(`input[name="${side}_code"]:checked`);
+        const countEl = document.getElementById(`${side}SelectedCount`);
+        if (countEl) {
+            countEl.textContent = `${checkboxes.length}개 선택`;
+        }
+    }
+
+    // 체크박스 변경 이벤트 리스너
+    document.addEventListener('change', function(e) {
+        if (e.target.name === 'local_code') {
+            updateSelectedCount('local');
+        } else if (e.target.name === 'remote_code') {
+            updateSelectedCount('remote');
+        }
+    });
+
+    // Push
+    async function pushSelected() {
+        const checkboxes = document.querySelectorAll('input[name="local_code"]:checked');
+        if (checkboxes.length === 0) {
+            alert('Push할 코드를 선택해주세요.');
+            return;
+        }
+
+        const codeKeys = Array.from(checkboxes).map(cb => cb.value);
+
+        if (!confirm(`${codeKeys.length}개 코드를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
+            return;
+        }
+
+        try {
+            const response = await fetch('{{ route("common-codes.sync.push") }}', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRF-TOKEN': csrfToken,
+                    'Accept': 'application/json'
+                },
+                body: JSON.stringify({ env: selectedEnv, code_keys: codeKeys })
+            });
+
+            const result = await response.json();
+            if (result.success) {
+                alert(result.message);
+                location.reload();
+            } else {
+                alert(result.error || 'Push 실패');
+            }
+        } catch (e) {
+            alert('오류 발생: ' + e.message);
+        }
+    }
+
+    // Pull
+    async function pullSelected() {
+        const checkboxes = document.querySelectorAll('input[name="remote_code"]:checked');
+        if (checkboxes.length === 0) {
+            alert('Pull할 코드를 선택해주세요.');
+            return;
+        }
+
+        const codeKeys = Array.from(checkboxes).map(cb => cb.value);
+
+        if (!confirm(`${codeKeys.length}개 코드를 로컬로 Pull 하시겠습니까?`)) {
+            return;
+        }
+
+        try {
+            const response = await fetch('{{ route("common-codes.sync.pull") }}', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CSRF-TOKEN': csrfToken,
+                    'Accept': 'application/json'
+                },
+                body: JSON.stringify({ env: selectedEnv, code_keys: codeKeys })
+            });
+
+            const result = await response.json();
+            if (result.success) {
+                alert(result.message);
+                location.reload();
+            } else {
+                alert(result.error || 'Pull 실패');
+            }
+        } catch (e) {
+            alert('오류 발생: ' + e.message);
+        }
+    }
+</script>
+@endpush
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
index 418eb3d9..ccee5b18 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -21,6 +21,8 @@
 use App\Http\Controllers\Lab\StrategyController;
 use App\Http\Controllers\MenuController;
 use App\Http\Controllers\MenuSyncController;
+use App\Http\Controllers\CommonCodeSyncController;
+use App\Http\Controllers\CategorySyncController;
 use App\Http\Controllers\PermissionController;
 use App\Http\Controllers\PostController;
 use App\Http\Controllers\ProfileController;
@@ -65,6 +67,16 @@
     Route::post('/import', [MenuSyncController::class, 'import']);
 });
 
+Route::prefix('common-code-sync')->group(function () {
+    Route::get('/export', [CommonCodeSyncController::class, 'export']);
+    Route::post('/import', [CommonCodeSyncController::class, 'import']);
+});
+
+Route::prefix('category-sync')->group(function () {
+    Route::get('/export', [CategorySyncController::class, 'export']);
+    Route::post('/import', [CategorySyncController::class, 'import']);
+});
+
 /*
 |--------------------------------------------------------------------------
 | Authenticated Routes (인증 필요)
@@ -310,6 +322,13 @@
         Route::post('/{id}/toggle', [CommonCodeController::class, 'toggle'])->name('toggle');
         Route::post('/{id}/copy', [CommonCodeController::class, 'copy'])->name('copy');
         Route::delete('/{id}', [CommonCodeController::class, 'destroy'])->name('destroy');
+
+        // 공통코드 동기화
+        Route::prefix('sync')->name('sync.')->group(function () {
+            Route::get('/', [CommonCodeSyncController::class, 'index'])->name('index');
+            Route::post('/push', [CommonCodeSyncController::class, 'push'])->name('push');
+            Route::post('/pull', [CommonCodeSyncController::class, 'pull'])->name('pull');
+        });
     });
 
     // 문서양식 관리
@@ -341,7 +360,16 @@
     Route::post('/api/business-card-ocr', [BusinessCardOcrController::class, 'process'])->name('api.business-card-ocr');
 
     // 카테고리 관리
-    Route::get('/categories', [CategoryController::class, 'index'])->name('categories.index');
+    Route::prefix('categories')->name('categories.')->group(function () {
+        Route::get('/', [CategoryController::class, 'index'])->name('index');
+
+        // 카테고리 동기화
+        Route::prefix('sync')->name('sync.')->group(function () {
+            Route::get('/', [CategorySyncController::class, 'index'])->name('index');
+            Route::post('/push', [CategorySyncController::class, 'push'])->name('push');
+            Route::post('/pull', [CategorySyncController::class, 'pull'])->name('pull');
+        });
+    });
 
     /*
     |--------------------------------------------------------------------------

From 50f9fa2fd30d1a0a94874caf5174945cdb4aef64 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Thu, 29 Jan 2026 00:40:56 +0900
Subject: [PATCH 07/12] =?UTF-8?q?fix:=EB=8F=99=EA=B8=B0=ED=99=94=20?=
 =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=EC=97=90=20=EA=B4=80=EB=A6=AC=20?=
 =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=20=EC=9D=B4=EB=8F=99=20=EB=B2=84?=
 =?UTF-8?q?=ED=8A=BC=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 resources/views/categories/sync.blade.php   | 25 ++++++++++++++-------
 resources/views/common-codes/sync.blade.php | 25 ++++++++++++++-------
 2 files changed, 34 insertions(+), 16 deletions(-)

diff --git a/resources/views/categories/sync.blade.php b/resources/views/categories/sync.blade.php
index a9d9ea69..ab1415a9 100644
--- a/resources/views/categories/sync.blade.php
+++ b/resources/views/categories/sync.blade.php
@@ -10,14 +10,23 @@
             <h1 class="text-2xl font-bold text-gray-800">카테고리 동기화</h1>
             <p class="text-sm text-gray-500 mt-1">로컬과 원격 환경 간 카테고리를 동기화합니다.</p>
         </div>
-        <a href="{{ route('menus.sync.index') }}"
-           class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
-            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
-            </svg>
-            환경 설정 (메뉴 동기화)
-        </a>
+        <div class="flex items-center gap-2">
+            <a href="{{ route('categories.index') }}"
+               class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+                <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+                </svg>
+                카테고리 관리
+            </a>
+            <a href="{{ route('menus.sync.index') }}"
+               class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+                <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+                </svg>
+                환경 설정
+            </a>
+        </div>
     </div>
 
     <!-- 환경 선택 탭 -->
diff --git a/resources/views/common-codes/sync.blade.php b/resources/views/common-codes/sync.blade.php
index ef9335e8..b557bc6d 100644
--- a/resources/views/common-codes/sync.blade.php
+++ b/resources/views/common-codes/sync.blade.php
@@ -10,14 +10,23 @@
             <h1 class="text-2xl font-bold text-gray-800">공통코드 동기화</h1>
             <p class="text-sm text-gray-500 mt-1">로컬과 원격 환경 간 공통코드를 동기화합니다.</p>
         </div>
-        <a href="{{ route('menus.sync.index') }}"
-           class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
-            <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
-            </svg>
-            환경 설정 (메뉴 동기화)
-        </a>
+        <div class="flex items-center gap-2">
+            <a href="{{ route('common-codes.index') }}"
+               class="px-4 py-2 bg-blue-600 hover:bg-blue-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+                <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+                </svg>
+                코드 관리
+            </a>
+            <a href="{{ route('menus.sync.index') }}"
+               class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg transition-colors flex items-center gap-2 text-sm">
+                <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z" />
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" />
+                </svg>
+                환경 설정
+            </a>
+        </div>
     </div>
 
     <!-- 환경 선택 탭 -->

From 1e70d2edbf718d7e76dcbf30ca30da577753c4ee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Thu, 29 Jan 2026 01:06:33 +0900
Subject: [PATCH 08/12] =?UTF-8?q?feat:=EB=8F=99=EA=B8=B0=ED=99=94=20?=
 =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=EC=97=90=20=EA=B8=80=EB=A1=9C?=
 =?UTF-8?q?=EB=B2=8C/=ED=85=8C=EB=84=8C=ED=8A=B8=20=ED=95=84=ED=84=B0=20?=
 =?UTF-8?q?=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 환경 탭 앞에 글로벌/테넌트 토글 버튼 추가
- 글로벌: tenant_id가 NULL인 코드/카테고리만 표시
- 테넌트: 현재 선택된 테넌트의 데이터만 표시
- Push/Pull API에 type 파라미터 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../Controllers/CategorySyncController.php    | 124 ++++++++++--------
 .../Controllers/CommonCodeSyncController.php  | 109 ++++++++-------
 resources/views/categories/sync.blade.php     |  42 +++++-
 resources/views/common-codes/sync.blade.php   |  42 +++++-
 4 files changed, 198 insertions(+), 119 deletions(-)

diff --git a/app/Http/Controllers/CategorySyncController.php b/app/Http/Controllers/CategorySyncController.php
index fc05cd42..16eab094 100644
--- a/app/Http/Controllers/CategorySyncController.php
+++ b/app/Http/Controllers/CategorySyncController.php
@@ -50,9 +50,10 @@ public function index(Request $request): View|Response
 
         $environments = $this->getEnvironments();
         $selectedEnv = $request->get('env', 'dev');
+        $selectedType = $request->get('type', 'global'); // global or tenant
 
-        // 로컬 카테고리 조회
-        $localCategories = $this->getCategoryList();
+        // 로컬 카테고리 조회 (타입 필터 적용)
+        $localCategories = $this->getCategoryList($selectedType);
 
         // 원격 카테고리 조회
         $remoteCategories = [];
@@ -60,7 +61,7 @@ public function index(Request $request): View|Response
 
         if (! empty($environments[$selectedEnv]['url'])) {
             try {
-                $remoteCategories = $this->fetchRemoteCategories($environments[$selectedEnv]);
+                $remoteCategories = $this->fetchRemoteCategories($environments[$selectedEnv], $selectedType);
             } catch (\Exception $e) {
                 $remoteError = $e->getMessage();
             }
@@ -72,6 +73,7 @@ public function index(Request $request): View|Response
         return view('categories.sync', [
             'environments' => $environments,
             'selectedEnv' => $selectedEnv,
+            'selectedType' => $selectedType,
             'localCategories' => $localCategories,
             'remoteCategories' => $remoteCategories,
             'remoteError' => $remoteError,
@@ -92,7 +94,8 @@ public function export(Request $request): JsonResponse
             return response()->json(['error' => 'Unauthorized'], 401);
         }
 
-        $categories = $this->getCategoryList();
+        $type = $request->get('type', 'all'); // global, tenant, or all
+        $categories = $this->getCategoryList($type);
 
         return response()->json([
             'success' => true,
@@ -216,6 +219,7 @@ public function push(Request $request): JsonResponse
     {
         $validated = $request->validate([
             'env' => 'required|string|in:dev,prod',
+            'type' => 'required|string|in:global,tenant',
             'category_keys' => 'required|array|min:1',
             'category_keys.*' => 'string',
         ]);
@@ -227,8 +231,8 @@ public function push(Request $request): JsonResponse
             return response()->json(['error' => '환경 설정이 없습니다.'], 400);
         }
 
-        // 선택된 카테고리 조회
-        $localCategories = $this->getCategoryList();
+        // 선택된 카테고리 조회 (타입 필터 적용)
+        $localCategories = $this->getCategoryList($validated['type']);
         $selectedCategories = array_filter($localCategories, function ($cat) use ($validated) {
             $key = $this->makeCategoryKey($cat);
             return in_array($key, $validated['category_keys']);
@@ -271,6 +275,7 @@ public function pull(Request $request): JsonResponse
     {
         $validated = $request->validate([
             'env' => 'required|string|in:dev,prod',
+            'type' => 'required|string|in:global,tenant',
             'category_keys' => 'required|array|min:1',
             'category_keys.*' => 'string',
         ]);
@@ -282,9 +287,9 @@ public function pull(Request $request): JsonResponse
             return response()->json(['error' => '환경 설정이 없습니다.'], 400);
         }
 
-        // 원격 카테고리 조회
+        // 원격 카테고리 조회 (타입 필터 적용)
         try {
-            $remoteCategories = $this->fetchRemoteCategories($env);
+            $remoteCategories = $this->fetchRemoteCategories($env, $validated['type']);
         } catch (\Exception $e) {
             return response()->json(['error' => $e->getMessage()], 500);
         }
@@ -378,65 +383,70 @@ public function pull(Request $request): JsonResponse
     }
 
     /**
-     * 카테고리 목록 조회 (글로벌 + 테넌트)
+     * 카테고리 목록 조회
+     * @param string $type 'global', 'tenant', or 'all'
      */
-    private function getCategoryList(): array
+    private function getCategoryList(string $type = 'all'): array
     {
         $tenantId = $this->getTenantId();
         $categories = [];
 
         // 글로벌 카테고리
-        $globalCategories = GlobalCategory::whereNull('deleted_at')
-            ->orderBy('code_group')
-            ->orderBy('sort_order')
-            ->get();
+        if ($type === 'global' || $type === 'all') {
+            $globalCategories = GlobalCategory::whereNull('deleted_at')
+                ->orderBy('code_group')
+                ->orderBy('sort_order')
+                ->get();
 
-        foreach ($globalCategories as $cat) {
-            $parentCode = null;
-            if ($cat->parent_id) {
-                $parent = GlobalCategory::find($cat->parent_id);
-                $parentCode = $parent?->code;
+            foreach ($globalCategories as $cat) {
+                $parentCode = null;
+                if ($cat->parent_id) {
+                    $parent = GlobalCategory::find($cat->parent_id);
+                    $parentCode = $parent?->code;
+                }
+
+                $categories[] = [
+                    'is_global' => true,
+                    'tenant_id' => null,
+                    'code_group' => $cat->code_group,
+                    'code' => $cat->code,
+                    'name' => $cat->name,
+                    'parent_code' => $parentCode,
+                    'sort_order' => $cat->sort_order,
+                    'description' => $cat->description,
+                    'is_active' => $cat->is_active,
+                ];
             }
-
-            $categories[] = [
-                'is_global' => true,
-                'tenant_id' => null,
-                'code_group' => $cat->code_group,
-                'code' => $cat->code,
-                'name' => $cat->name,
-                'parent_code' => $parentCode,
-                'sort_order' => $cat->sort_order,
-                'description' => $cat->description,
-                'is_active' => $cat->is_active,
-            ];
         }
 
         // 테넌트 카테고리
-        $tenantCategories = Category::withoutGlobalScopes()
-            ->where('tenant_id', $tenantId)
-            ->whereNull('deleted_at')
-            ->orderBy('code_group')
-            ->orderBy('sort_order')
-            ->get();
+        if ($type === 'tenant' || $type === 'all') {
+            $tenantCategories = Category::withoutGlobalScopes()
+                ->where('tenant_id', $tenantId)
+                ->whereNull('deleted_at')
+                ->orderBy('code_group')
+                ->orderBy('sort_order')
+                ->get();
 
-        foreach ($tenantCategories as $cat) {
-            $parentCode = null;
-            if ($cat->parent_id) {
-                $parent = Category::withoutGlobalScopes()->find($cat->parent_id);
-                $parentCode = $parent?->code;
+            foreach ($tenantCategories as $cat) {
+                $parentCode = null;
+                if ($cat->parent_id) {
+                    $parent = Category::withoutGlobalScopes()->find($cat->parent_id);
+                    $parentCode = $parent?->code;
+                }
+
+                $categories[] = [
+                    'is_global' => false,
+                    'tenant_id' => $cat->tenant_id,
+                    'code_group' => $cat->code_group,
+                    'code' => $cat->code,
+                    'name' => $cat->name,
+                    'parent_code' => $parentCode,
+                    'sort_order' => $cat->sort_order,
+                    'description' => $cat->description,
+                    'is_active' => $cat->is_active,
+                ];
             }
-
-            $categories[] = [
-                'is_global' => false,
-                'tenant_id' => $cat->tenant_id,
-                'code_group' => $cat->code_group,
-                'code' => $cat->code,
-                'name' => $cat->name,
-                'parent_code' => $parentCode,
-                'sort_order' => $cat->sort_order,
-                'description' => $cat->description,
-                'is_active' => $cat->is_active,
-            ];
         }
 
         return $categories;
@@ -445,12 +455,14 @@ private function getCategoryList(): array
     /**
      * 원격 카테고리 조회
      */
-    private function fetchRemoteCategories(array $env): array
+    private function fetchRemoteCategories(array $env, string $type = 'all'): array
     {
         $response = Http::withHeaders([
             'X-Menu-Sync-Key' => $env['api_key'],
             'Accept' => 'application/json',
-        ])->timeout(10)->get(rtrim($env['url'], '/') . '/category-sync/export');
+        ])->timeout(10)->get(rtrim($env['url'], '/') . '/category-sync/export', [
+            'type' => $type,
+        ]);
 
         if (! $response->successful()) {
             throw new \Exception('API 오류: HTTP ' . $response->status());
diff --git a/app/Http/Controllers/CommonCodeSyncController.php b/app/Http/Controllers/CommonCodeSyncController.php
index ba1b8f92..3623bade 100644
--- a/app/Http/Controllers/CommonCodeSyncController.php
+++ b/app/Http/Controllers/CommonCodeSyncController.php
@@ -49,9 +49,10 @@ public function index(Request $request): View|Response
 
         $environments = $this->getEnvironments();
         $selectedEnv = $request->get('env', 'dev');
+        $selectedType = $request->get('type', 'global'); // global or tenant
 
-        // 로컬 코드 조회
-        $localCodes = $this->getCodeList();
+        // 로컬 코드 조회 (타입 필터 적용)
+        $localCodes = $this->getCodeList($selectedType);
 
         // 원격 코드 조회
         $remoteCodes = [];
@@ -59,7 +60,7 @@ public function index(Request $request): View|Response
 
         if (! empty($environments[$selectedEnv]['url'])) {
             try {
-                $remoteCodes = $this->fetchRemoteCodes($environments[$selectedEnv]);
+                $remoteCodes = $this->fetchRemoteCodes($environments[$selectedEnv], $selectedType);
             } catch (\Exception $e) {
                 $remoteError = $e->getMessage();
             }
@@ -71,6 +72,7 @@ public function index(Request $request): View|Response
         return view('common-codes.sync', [
             'environments' => $environments,
             'selectedEnv' => $selectedEnv,
+            'selectedType' => $selectedType,
             'localCodes' => $localCodes,
             'remoteCodes' => $remoteCodes,
             'remoteError' => $remoteError,
@@ -91,7 +93,8 @@ public function export(Request $request): JsonResponse
             return response()->json(['error' => 'Unauthorized'], 401);
         }
 
-        $codes = $this->getCodeList();
+        $type = $request->get('type', 'all'); // global, tenant, or all
+        $codes = $this->getCodeList($type);
 
         return response()->json([
             'success' => true,
@@ -168,6 +171,7 @@ public function push(Request $request): JsonResponse
     {
         $validated = $request->validate([
             'env' => 'required|string|in:dev,prod',
+            'type' => 'required|string|in:global,tenant',
             'code_keys' => 'required|array|min:1',
             'code_keys.*' => 'string',
         ]);
@@ -179,8 +183,8 @@ public function push(Request $request): JsonResponse
             return response()->json(['error' => '환경 설정이 없습니다.'], 400);
         }
 
-        // 선택된 코드 조회
-        $localCodes = $this->getCodeList();
+        // 선택된 코드 조회 (타입 필터 적용)
+        $localCodes = $this->getCodeList($validated['type']);
         $selectedCodes = array_filter($localCodes, function ($code) use ($validated) {
             $key = $this->makeCodeKey($code);
             return in_array($key, $validated['code_keys']);
@@ -223,6 +227,7 @@ public function pull(Request $request): JsonResponse
     {
         $validated = $request->validate([
             'env' => 'required|string|in:dev,prod',
+            'type' => 'required|string|in:global,tenant',
             'code_keys' => 'required|array|min:1',
             'code_keys.*' => 'string',
         ]);
@@ -234,9 +239,9 @@ public function pull(Request $request): JsonResponse
             return response()->json(['error' => '환경 설정이 없습니다.'], 400);
         }
 
-        // 원격 코드 조회
+        // 원격 코드 조회 (타입 필터 적용)
         try {
-            $remoteCodes = $this->fetchRemoteCodes($env);
+            $remoteCodes = $this->fetchRemoteCodes($env, $validated['type']);
         } catch (\Exception $e) {
             return response()->json(['error' => $e->getMessage()], 500);
         }
@@ -289,52 +294,56 @@ public function pull(Request $request): JsonResponse
     }
 
     /**
-     * 코드 목록 조회 (글로벌 + 테넌트)
+     * 코드 목록 조회
+     * @param string $type 'global', 'tenant', or 'all'
      */
-    private function getCodeList(): array
+    private function getCodeList(string $type = 'all'): array
     {
         $tenantId = $this->getTenantId();
-
-        // 글로벌 코드 (tenant_id IS NULL)
-        $globalCodes = CommonCode::query()
-            ->whereNull('tenant_id')
-            ->orderBy('code_group')
-            ->orderBy('sort_order')
-            ->get();
-
-        // 테넌트 코드
-        $tenantCodes = CommonCode::query()
-            ->where('tenant_id', $tenantId)
-            ->orderBy('code_group')
-            ->orderBy('sort_order')
-            ->get();
-
         $codes = [];
 
-        foreach ($globalCodes as $code) {
-            $codes[] = [
-                'tenant_id' => null,
-                'code_group' => $code->code_group,
-                'code' => $code->code,
-                'name' => $code->name,
-                'sort_order' => $code->sort_order,
-                'attributes' => $code->attributes,
-                'is_active' => $code->is_active,
-                'is_global' => true,
-            ];
+        // 글로벌 코드 (tenant_id IS NULL)
+        if ($type === 'global' || $type === 'all') {
+            $globalCodes = CommonCode::query()
+                ->whereNull('tenant_id')
+                ->orderBy('code_group')
+                ->orderBy('sort_order')
+                ->get();
+
+            foreach ($globalCodes as $code) {
+                $codes[] = [
+                    'tenant_id' => null,
+                    'code_group' => $code->code_group,
+                    'code' => $code->code,
+                    'name' => $code->name,
+                    'sort_order' => $code->sort_order,
+                    'attributes' => $code->attributes,
+                    'is_active' => $code->is_active,
+                    'is_global' => true,
+                ];
+            }
         }
 
-        foreach ($tenantCodes as $code) {
-            $codes[] = [
-                'tenant_id' => $code->tenant_id,
-                'code_group' => $code->code_group,
-                'code' => $code->code,
-                'name' => $code->name,
-                'sort_order' => $code->sort_order,
-                'attributes' => $code->attributes,
-                'is_active' => $code->is_active,
-                'is_global' => false,
-            ];
+        // 테넌트 코드
+        if ($type === 'tenant' || $type === 'all') {
+            $tenantCodes = CommonCode::query()
+                ->where('tenant_id', $tenantId)
+                ->orderBy('code_group')
+                ->orderBy('sort_order')
+                ->get();
+
+            foreach ($tenantCodes as $code) {
+                $codes[] = [
+                    'tenant_id' => $code->tenant_id,
+                    'code_group' => $code->code_group,
+                    'code' => $code->code,
+                    'name' => $code->name,
+                    'sort_order' => $code->sort_order,
+                    'attributes' => $code->attributes,
+                    'is_active' => $code->is_active,
+                    'is_global' => false,
+                ];
+            }
         }
 
         return $codes;
@@ -343,12 +352,14 @@ private function getCodeList(): array
     /**
      * 원격 코드 조회
      */
-    private function fetchRemoteCodes(array $env): array
+    private function fetchRemoteCodes(array $env, string $type = 'all'): array
     {
         $response = Http::withHeaders([
             'X-Menu-Sync-Key' => $env['api_key'],
             'Accept' => 'application/json',
-        ])->timeout(10)->get(rtrim($env['url'], '/') . '/common-code-sync/export');
+        ])->timeout(10)->get(rtrim($env['url'], '/') . '/common-code-sync/export', [
+            'type' => $type,
+        ]);
 
         if (! $response->successful()) {
             throw new \Exception('API 오류: HTTP ' . $response->status());
diff --git a/resources/views/categories/sync.blade.php b/resources/views/categories/sync.blade.php
index ab1415a9..cf906050 100644
--- a/resources/views/categories/sync.blade.php
+++ b/resources/views/categories/sync.blade.php
@@ -29,12 +29,37 @@ class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg
         </div>
     </div>
 
-    <!-- 환경 선택 탭 -->
+    <!-- 타입 선택 + 환경 선택 탭 -->
     <div class="bg-white rounded-lg shadow-sm mb-4">
         <div class="border-b border-gray-200">
-            <nav class="flex -mb-px" aria-label="Tabs">
+            <nav class="flex items-center -mb-px" aria-label="Tabs">
+                <!-- 글로벌/테넌트 토글 -->
+                <div class="flex items-center border-r border-gray-200 px-4">
+                    <a href="{{ route('categories.sync.index', ['env' => $selectedEnv, 'type' => 'global']) }}"
+                       class="px-3 py-2 text-sm font-medium rounded-l-lg border transition-colors
+                              {{ $selectedType === 'global'
+                                  ? 'bg-purple-600 text-white border-purple-600'
+                                  : 'bg-white text-gray-600 border-gray-300 hover:bg-gray-50' }}">
+                        <svg class="w-4 h-4 inline-block mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3.055 11H5a2 2 0 012 2v1a2 2 0 002 2 2 2 0 012 2v2.945M8 3.935V5.5A2.5 2.5 0 0010.5 8h.5a2 2 0 012 2 2 2 0 104 0 2 2 0 012-2h1.064M15 20.488V18a2 2 0 012-2h3.064M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                        </svg>
+                        글로벌
+                    </a>
+                    <a href="{{ route('categories.sync.index', ['env' => $selectedEnv, 'type' => 'tenant']) }}"
+                       class="px-3 py-2 text-sm font-medium rounded-r-lg border border-l-0 transition-colors
+                              {{ $selectedType === 'tenant'
+                                  ? 'bg-blue-600 text-white border-blue-600'
+                                  : 'bg-white text-gray-600 border-gray-300 hover:bg-gray-50' }}">
+                        <svg class="w-4 h-4 inline-block mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 21V5a2 2 0 00-2-2H7a2 2 0 00-2 2v16m14 0h2m-2 0h-5m-9 0H3m2 0h5M9 7h1m-1 4h1m4-4h1m-1 4h1m-5 10v-5a1 1 0 011-1h2a1 1 0 011 1v5m-4 0h4" />
+                        </svg>
+                        테넌트
+                    </a>
+                </div>
+
+                <!-- 환경 탭 -->
                 @foreach($environments as $key => $env)
-                    <a href="{{ route('categories.sync.index', ['env' => $key]) }}"
+                    <a href="{{ route('categories.sync.index', ['env' => $key, 'type' => $selectedType]) }}"
                        class="px-6 py-3 text-sm font-medium border-b-2 transition-colors
                               {{ $selectedEnv === $key
                                   ? 'border-blue-500 text-blue-600'
@@ -274,6 +299,7 @@ class="w-4 h-4 text-purple-600 border-gray-300 rounded focus:ring-purple-500"
 @push('scripts')
 <script>
     const selectedEnv = '{{ $selectedEnv }}';
+    const selectedType = '{{ $selectedType }}';
     const csrfToken = '{{ csrf_token() }}';
 
     // 전체 선택
@@ -310,8 +336,9 @@ function updateSelectedCount(side) {
         }
 
         const categoryKeys = Array.from(checkboxes).map(cb => cb.value);
+        const typeLabel = selectedType === 'global' ? '글로벌' : '테넌트';
 
-        if (!confirm(`${categoryKeys.length}개 카테고리를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
+        if (!confirm(`${categoryKeys.length}개 ${typeLabel} 카테고리를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
             return;
         }
 
@@ -323,7 +350,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
-                body: JSON.stringify({ env: selectedEnv, category_keys: categoryKeys })
+                body: JSON.stringify({ env: selectedEnv, type: selectedType, category_keys: categoryKeys })
             });
 
             const result = await response.json();
@@ -347,8 +374,9 @@ function updateSelectedCount(side) {
         }
 
         const categoryKeys = Array.from(checkboxes).map(cb => cb.value);
+        const typeLabel = selectedType === 'global' ? '글로벌' : '테넌트';
 
-        if (!confirm(`${categoryKeys.length}개 카테고리를 로컬로 Pull 하시겠습니까?`)) {
+        if (!confirm(`${categoryKeys.length}개 ${typeLabel} 카테고리를 로컬로 Pull 하시겠습니까?`)) {
             return;
         }
 
@@ -360,7 +388,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
-                body: JSON.stringify({ env: selectedEnv, category_keys: categoryKeys })
+                body: JSON.stringify({ env: selectedEnv, type: selectedType, category_keys: categoryKeys })
             });
 
             const result = await response.json();
diff --git a/resources/views/common-codes/sync.blade.php b/resources/views/common-codes/sync.blade.php
index b557bc6d..ddaa2b46 100644
--- a/resources/views/common-codes/sync.blade.php
+++ b/resources/views/common-codes/sync.blade.php
@@ -29,12 +29,37 @@ class="px-4 py-2 bg-gray-600 hover:bg-gray-700 text-white font-medium rounded-lg
         </div>
     </div>
 
-    <!-- 환경 선택 탭 -->
+    <!-- 타입 선택 + 환경 선택 탭 -->
     <div class="bg-white rounded-lg shadow-sm mb-4">
         <div class="border-b border-gray-200">
-            <nav class="flex -mb-px" aria-label="Tabs">
+            <nav class="flex items-center -mb-px" aria-label="Tabs">
+                <!-- 글로벌/테넌트 토글 -->
+                <div class="flex items-center border-r border-gray-200 px-4">
+                    <a href="{{ route('common-codes.sync.index', ['env' => $selectedEnv, 'type' => 'global']) }}"
+                       class="px-3 py-2 text-sm font-medium rounded-l-lg border transition-colors
+                              {{ $selectedType === 'global'
+                                  ? 'bg-purple-600 text-white border-purple-600'
+                                  : 'bg-white text-gray-600 border-gray-300 hover:bg-gray-50' }}">
+                        <svg class="w-4 h-4 inline-block mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3.055 11H5a2 2 0 012 2v1a2 2 0 002 2 2 2 0 012 2v2.945M8 3.935V5.5A2.5 2.5 0 0010.5 8h.5a2 2 0 012 2 2 2 0 104 0 2 2 0 012-2h1.064M15 20.488V18a2 2 0 012-2h3.064M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                        </svg>
+                        글로벌
+                    </a>
+                    <a href="{{ route('common-codes.sync.index', ['env' => $selectedEnv, 'type' => 'tenant']) }}"
+                       class="px-3 py-2 text-sm font-medium rounded-r-lg border border-l-0 transition-colors
+                              {{ $selectedType === 'tenant'
+                                  ? 'bg-blue-600 text-white border-blue-600'
+                                  : 'bg-white text-gray-600 border-gray-300 hover:bg-gray-50' }}">
+                        <svg class="w-4 h-4 inline-block mr-1" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 21V5a2 2 0 00-2-2H7a2 2 0 00-2 2v16m14 0h2m-2 0h-5m-9 0H3m2 0h5M9 7h1m-1 4h1m4-4h1m-1 4h1m-5 10v-5a1 1 0 011-1h2a1 1 0 011 1v5m-4 0h4" />
+                        </svg>
+                        테넌트
+                    </a>
+                </div>
+
+                <!-- 환경 탭 -->
                 @foreach($environments as $key => $env)
-                    <a href="{{ route('common-codes.sync.index', ['env' => $key]) }}"
+                    <a href="{{ route('common-codes.sync.index', ['env' => $key, 'type' => $selectedType]) }}"
                        class="px-6 py-3 text-sm font-medium border-b-2 transition-colors
                               {{ $selectedEnv === $key
                                   ? 'border-blue-500 text-blue-600'
@@ -275,6 +300,7 @@ class="w-4 h-4 text-purple-600 border-gray-300 rounded focus:ring-purple-500"
 @push('scripts')
 <script>
     const selectedEnv = '{{ $selectedEnv }}';
+    const selectedType = '{{ $selectedType }}';
     const csrfToken = '{{ csrf_token() }}';
 
     // 전체 선택
@@ -311,8 +337,9 @@ function updateSelectedCount(side) {
         }
 
         const codeKeys = Array.from(checkboxes).map(cb => cb.value);
+        const typeLabel = selectedType === 'global' ? '글로벌' : '테넌트';
 
-        if (!confirm(`${codeKeys.length}개 코드를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
+        if (!confirm(`${codeKeys.length}개 ${typeLabel} 코드를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
             return;
         }
 
@@ -324,7 +351,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
-                body: JSON.stringify({ env: selectedEnv, code_keys: codeKeys })
+                body: JSON.stringify({ env: selectedEnv, type: selectedType, code_keys: codeKeys })
             });
 
             const result = await response.json();
@@ -348,8 +375,9 @@ function updateSelectedCount(side) {
         }
 
         const codeKeys = Array.from(checkboxes).map(cb => cb.value);
+        const typeLabel = selectedType === 'global' ? '글로벌' : '테넌트';
 
-        if (!confirm(`${codeKeys.length}개 코드를 로컬로 Pull 하시겠습니까?`)) {
+        if (!confirm(`${codeKeys.length}개 ${typeLabel} 코드를 로컬로 Pull 하시겠습니까?`)) {
             return;
         }
 
@@ -361,7 +389,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
-                body: JSON.stringify({ env: selectedEnv, code_keys: codeKeys })
+                body: JSON.stringify({ env: selectedEnv, type: selectedType, code_keys: codeKeys })
             });
 
             const result = await response.json();

From 6d708cfdda9382c7b4b31c145711e78227d1d31f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Thu, 29 Jan 2026 01:06:53 +0900
Subject: [PATCH 09/12] =?UTF-8?q?feat:=20=EC=88=98=EC=9E=85=EA=B2=80?=
 =?UTF-8?q?=EC=82=AC=20=EC=84=B1=EC=A0=81=EC=84=9C=20=ED=85=9C=ED=94=8C?=
 =?UTF-8?q?=EB=A6=BF=20=EC=8B=9C=EB=8D=94=20=EB=B0=8F=20=EB=AF=B8=EB=A6=AC?=
 =?UTF-8?q?=EB=B3=B4=EA=B8=B0=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- InspectionTemplateSeeder: 검사항목 4개(겉모양, 두께, 폭, 길이) 생성
- 템플릿 미리보기를 React 성적서 양식과 동일한 형태로 구현
  - 헤더: 로고, 제목, 결재란
  - 기본정보 테이블 (목업 데이터)
  - 검사항목 테이블: NO, 검사항목, 검사기준, 검사방식, 검사주기, 측정값(n1,n2,n3), 판정
  - 종합판정 영역
- 문서 목록/상세/편집 뷰 개선

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 database/seeders/InspectionTemplateSeeder.php |  78 ++++++++
 .../views/document-templates/edit.blade.php   | 188 ++++++++++--------
 resources/views/documents/edit.blade.php      |  21 +-
 resources/views/documents/index.blade.php     | 128 ++++++------
 resources/views/documents/show.blade.php      |  21 +-
 5 files changed, 276 insertions(+), 160 deletions(-)
 create mode 100644 database/seeders/InspectionTemplateSeeder.php

diff --git a/database/seeders/InspectionTemplateSeeder.php b/database/seeders/InspectionTemplateSeeder.php
new file mode 100644
index 00000000..3fbdc178
--- /dev/null
+++ b/database/seeders/InspectionTemplateSeeder.php
@@ -0,0 +1,78 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\DocumentTemplate;
+use App\Models\DocumentTemplateApprovalLine;
+use App\Models\DocumentTemplateBasicField;
+use App\Models\DocumentTemplateColumn;
+use App\Models\DocumentTemplateSection;
+use App\Models\DocumentTemplateSectionItem;
+use Illuminate\Database\Seeder;
+
+class InspectionTemplateSeeder extends Seeder
+{
+    /**
+     * 수입검사 성적서 템플릿 - 검사항목 테이블만
+     */
+    public function run(): void
+    {
+        $tenantId = 1;
+        $this->cleanupExisting($tenantId);
+
+        // 템플릿 생성
+        $template = DocumentTemplate::create([
+            'tenant_id' => $tenantId,
+            'name' => '철제품 수입검사 성적서',
+            'category' => '품질/수입검사',
+            'title' => '수입검사 성적서',
+            'is_active' => true,
+        ]);
+
+        // 검사항목 섹션
+        $section = DocumentTemplateSection::create([
+            'template_id' => $template->id,
+            'title' => '검사 항목',
+            'sort_order' => 1,
+        ]);
+
+        // 검사항목 (React 모달과 동일)
+        $items = [
+            ['item' => '겉모양', 'standard' => '외관 이상 없음', 'method' => '육안'],
+            ['item' => '두께', 'standard' => 't 1.0', 'method' => '계측'],
+            ['item' => '폭', 'standard' => 'W 1,000mm', 'method' => '계측'],
+            ['item' => '길이', 'standard' => 'L 2,000mm', 'method' => '계측'],
+        ];
+
+        foreach ($items as $i => $item) {
+            DocumentTemplateSectionItem::create([
+                'section_id' => $section->id,
+                'item' => $item['item'],
+                'standard' => $item['standard'],
+                'method' => $item['method'],
+                'sort_order' => $i + 1,
+            ]);
+        }
+
+        $this->command->info("✅ 템플릿 생성 완료 (ID: {$template->id})");
+    }
+
+    private function cleanupExisting(int $tenantId): void
+    {
+        $existing = DocumentTemplate::where('tenant_id', $tenantId)
+            ->where('name', '철제품 수입검사 성적서')
+            ->first();
+
+        if ($existing) {
+            DocumentTemplateColumn::where('template_id', $existing->id)->delete();
+            $sections = DocumentTemplateSection::where('template_id', $existing->id)->get();
+            foreach ($sections as $section) {
+                DocumentTemplateSectionItem::where('section_id', $section->id)->delete();
+            }
+            DocumentTemplateSection::where('template_id', $existing->id)->delete();
+            DocumentTemplateBasicField::where('template_id', $existing->id)->delete();
+            DocumentTemplateApprovalLine::where('template_id', $existing->id)->delete();
+            $existing->forceDelete();
+        }
+    }
+}
diff --git a/resources/views/document-templates/edit.blade.php b/resources/views/document-templates/edit.blade.php
index 76c07866..117ff75f 100644
--- a/resources/views/document-templates/edit.blade.php
+++ b/resources/views/document-templates/edit.blade.php
@@ -588,90 +588,122 @@ function closePreviewModal() {
     }
 
     function generatePreviewHtml() {
-        const title = document.getElementById('title').value || '검사 성적서';
-        const companyName = '{{ $tenant?->company_name ?? "회사명" }}';
+        const title = document.getElementById('title').value || '수입검사 성적서';
 
+        // 검사항목 행 생성
+        const renderItems = () => {
+            if (templateState.sections.length === 0 || templateState.sections[0].items.length === 0) {
+                return `<tr><td colspan="10" class="text-center py-4 text-gray-400">검사항목이 없습니다.</td></tr>`;
+            }
+            return templateState.sections[0].items.map((item, idx) => `
+                <tr>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">${idx + 1}</td>
+                    <td class="border border-gray-400 px-2 py-1.5">${escapeHtml(item.item)}</td>
+                    <td class="border border-gray-400 px-2 py-1.5">${escapeHtml(item.standard)}</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">${escapeHtml(item.method)}</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">LOT</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center"><input type="radio" name="j${idx}_1"> OK <input type="radio" name="j${idx}_1"> NG</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">-</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">-</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">-</td>
+                    <td class="border border-gray-400 px-2 py-1.5 text-center">-</td>
+                </tr>
+            `).join('');
+        };
+
+        // 실제 React 성적서 양식과 동일한 형태
         return `
-            <div class="bg-white p-8 border" style="font-family: 'Malgun Gothic', sans-serif;">
-                <div class="text-center mb-6">
-                    <h1 class="text-2xl font-bold">${escapeHtml(title)}</h1>
-                    <p class="text-gray-600 mt-1">${escapeHtml(companyName)}</p>
+            <div class="bg-white p-6" style="font-family: 'Malgun Gothic', sans-serif; font-size: 12px; max-width: 900px; margin: 0 auto;">
+                <!-- 헤더: 로고 + 제목 + 결재란 -->
+                <div class="flex justify-between items-start mb-4">
+                    <!-- 로고 -->
+                    <div class="text-center" style="width: 80px;">
+                        <div class="text-2xl font-bold">KD</div>
+                        <div class="text-xs">경동기업</div>
+                    </div>
+                    <!-- 제목 -->
+                    <div class="flex-1 text-center">
+                        <h1 class="text-xl font-bold tracking-widest">${escapeHtml(title)}</h1>
+                    </div>
+                    <!-- 결재란 -->
+                    <div>
+                        <table class="border-collapse text-xs" style="width: 120px;">
+                            <tr>
+                                <td class="border border-gray-400 px-2 py-1 bg-gray-100">담당</td>
+                                <td class="border border-gray-400 px-2 py-1 bg-gray-100">부서장</td>
+                            </tr>
+                            <tr>
+                                <td class="border border-gray-400 px-2 py-1">결재</td>
+                                <td class="border border-gray-400 px-2 py-1">노원호</td>
+                            </tr>
+                        </table>
+                        <div class="text-right text-xs mt-1">참고일자: 2026-01-29</div>
+                    </div>
                 </div>
 
-                ${templateState.approval_lines.length > 0 ? `
-                    <div class="flex justify-end mb-6">
-                        <table class="border-collapse border border-gray-400 text-sm">
-                            <tr>
-                                ${templateState.approval_lines.map(line => `
-                                    <td class="border border-gray-400 px-4 py-1 text-center font-medium bg-gray-100">${escapeHtml(line.name)}</td>
-                                `).join('')}
-                            </tr>
-                            <tr>
-                                ${templateState.approval_lines.map(line => `
-                                    <td class="border border-gray-400 px-4 py-6 text-center"></td>
-                                `).join('')}
-                            </tr>
-                        </table>
-                    </div>
-                ` : ''}
+                <!-- 기본 정보 테이블 -->
+                <table class="w-full border-collapse text-xs mb-4">
+                    <tr>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium" style="width:80px">품 명</td>
+                        <td class="border border-gray-400 px-2 py-1.5" colspan="2">SUS304 스테인리스 판재</td>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium" style="width:100px">납품업체<br>(제조업체)</td>
+                        <td class="border border-gray-400 px-2 py-1.5">(주)대한철강</td>
+                    </tr>
+                    <tr>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium">규 격<br>(두께*너비<br>*길이)</td>
+                        <td class="border border-gray-400 px-2 py-1.5" colspan="2">1000×2000×3T</td>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium">로트번호</td>
+                        <td class="border border-gray-400 px-2 py-1.5">LOT-2026-001</td>
+                    </tr>
+                    <tr>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium">자재번호</td>
+                        <td class="border border-gray-400 px-2 py-1.5" colspan="2">PE02RB</td>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium">검사일자</td>
+                        <td class="border border-gray-400 px-2 py-1.5">01/29</td>
+                    </tr>
+                    <tr>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium">로트크기</td>
+                        <td class="border border-gray-400 px-2 py-1.5">200</td>
+                        <td class="border border-gray-400 px-2 py-1.5 text-center">매</td>
+                        <td class="border border-gray-400 px-2 py-1.5 bg-gray-100 font-medium">검사자</td>
+                        <td class="border border-gray-400 px-2 py-1.5">노원호 <input type="checkbox" checked class="ml-2"></td>
+                    </tr>
+                </table>
 
-                ${templateState.sections.map(section => `
-                    <div class="mb-6">
-                        <h3 class="font-bold text-lg mb-2 border-b-2 border-gray-800 pb-1">${escapeHtml(section.title)}</h3>                        ${section.image_path ? `
-                            <div class="mb-3">
-                                <img src="/storage/${section.image_path}" alt="${escapeHtml(section.title)}" class="max-w-full h-auto border border-gray-300 rounded">
-                            </div>
-                        ` : ''}
-                        ${section.items.length > 0 ? `
-                            <table class="w-full border-collapse border border-gray-400 text-sm">
-                                <thead>
-                                    <tr class="bg-gray-100">
-                                        <th class="border border-gray-400 px-2 py-1">구분</th>
-                                        <th class="border border-gray-400 px-2 py-1">검사항목</th>
-                                        <th class="border border-gray-400 px-2 py-1">검사기준</th>
-                                        <th class="border border-gray-400 px-2 py-1">검사방법</th>
-                                        <th class="border border-gray-400 px-2 py-1">검사주기</th>
-                                        <th class="border border-gray-400 px-2 py-1">관련규정</th>
-                                    </tr>
-                                </thead>
-                                <tbody>
-                                    ${section.items.map(item => `
-                                        <tr>
-                                            <td class="border border-gray-400 px-2 py-1">${escapeHtml(item.category)}</td>
-                                            <td class="border border-gray-400 px-2 py-1">${escapeHtml(item.item)}</td>
-                                            <td class="border border-gray-400 px-2 py-1">${escapeHtml(item.standard)}</td>
-                                            <td class="border border-gray-400 px-2 py-1">${escapeHtml(item.method)}</td>
-                                            <td class="border border-gray-400 px-2 py-1">${escapeHtml(item.frequency)}</td>
-                                            <td class="border border-gray-400 px-2 py-1">${escapeHtml(item.regulation)}</td>
-                                        </tr>
-                                    `).join('')}
-                                </tbody>
-                            </table>
-                        ` : '<p class="text-gray-400">항목 없음</p>'}
-                    </div>
-                `).join('')}
+                <!-- 검사 항목 테이블 -->
+                <table class="w-full border-collapse text-xs">
+                    <thead>
+                        <tr>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" style="width:30px" rowspan="2">NO</th>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" style="width:80px" rowspan="2">검사항목</th>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" rowspan="2">검사기준</th>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" style="width:60px" rowspan="2">검사방식</th>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" style="width:60px" rowspan="2">검사주기</th>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" colspan="3">측정값</th>
+                            <th class="border border-gray-400 px-2 py-1.5 bg-gray-100" style="width:50px" rowspan="2">판정<br>(적/부)</th>
+                        </tr>
+                        <tr>
+                            <th class="border border-gray-400 px-1 py-1 bg-gray-100" style="width:50px">n1</th>
+                            <th class="border border-gray-400 px-1 py-1 bg-gray-100" style="width:50px">n2</th>
+                            <th class="border border-gray-400 px-1 py-1 bg-gray-100" style="width:50px">n3</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        ${renderItems()}
+                    </tbody>
+                </table>
 
-                ${templateState.columns.length > 0 ? `
-                    <div class="mb-6">
-                        <h3 class="font-bold text-lg mb-2 border-b-2 border-gray-800 pb-1">검사 데이터</h3>
-                        <table class="w-full border-collapse border border-gray-400 text-sm">
-                            <thead>
-                                <tr class="bg-gray-100">
-                                    ${templateState.columns.map(col => `
-                                        <th class="border border-gray-400 px-2 py-1" style="width: ${col.width}">${escapeHtml(col.label)}</th>
-                                    `).join('')}
-                                </tr>
-                            </thead>
-                            <tbody>
-                                <tr>
-                                    ${templateState.columns.map(() => `
-                                        <td class="border border-gray-400 px-2 py-4"></td>
-                                    `).join('')}
-                                </tr>
-                            </tbody>
-                        </table>
-                    </div>
-                ` : ''}
+                <!-- 종합판정 -->
+                <div class="flex justify-end mt-4">
+                    <table class="border-collapse text-xs">
+                        <tr>
+                            <td class="border border-gray-400 px-4 py-2 bg-gray-100 font-medium">종합판정</td>
+                        </tr>
+                        <tr>
+                            <td class="border border-gray-400 px-4 py-3 text-center text-gray-400">미완료</td>
+                        </tr>
+                    </table>
+                </div>
             </div>
         `;
     }
diff --git a/resources/views/documents/edit.blade.php b/resources/views/documents/edit.blade.php
index 7f6c4671..7de238f7 100644
--- a/resources/views/documents/edit.blade.php
+++ b/resources/views/documents/edit.blade.php
@@ -3,12 +3,12 @@
 @section('title', $isCreate ? '새 문서 작성' : '문서 수정')
 
 @section('content')
-<div class="p-6">
-    {{-- 헤더 --}}
-    <div class="flex justify-between items-center mb-6">
+<div class="max-w-7xl mx-auto">
+    <!-- 헤더 -->
+    <div class="flex flex-col lg:flex-row lg:justify-between lg:items-center gap-4 mb-6">
         <div>
             <h1 class="text-2xl font-bold text-gray-800">{{ $isCreate ? '새 문서 작성' : '문서 수정' }}</h1>
-            <p class="text-sm text-gray-500 mt-1">
+            <p class="text-sm text-gray-500 mt-1 hidden sm:block">
                 @if($document)
                     {{ $document->document_no }} - {{ $document->title }}
                 @else
@@ -16,13 +16,12 @@
                 @endif
             </p>
         </div>
-        <a href="{{ route('documents.index') }}"
-           class="inline-flex items-center px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
-            <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18"/>
-            </svg>
-            목록으로
-        </a>
+        <div class="flex items-center gap-2">
+            <a href="{{ route('documents.index') }}"
+               class="bg-gray-200 hover:bg-gray-300 text-gray-700 px-4 py-2 rounded-lg transition">
+                목록
+            </a>
+        </div>
     </div>
 
     {{-- 템플릿 선택 (생성 시) --}}
diff --git a/resources/views/documents/index.blade.php b/resources/views/documents/index.blade.php
index 41798958..7e831224 100644
--- a/resources/views/documents/index.blade.php
+++ b/resources/views/documents/index.blade.php
@@ -3,70 +3,68 @@
 @section('title', '문서 관리')
 
 @section('content')
-<div class="p-6">
-    {{-- 헤더 --}}
-    <div class="flex justify-between items-center mb-6">
+    <!-- 페이지 헤더 -->
+    <div class="flex flex-col lg:flex-row lg:justify-between lg:items-center gap-4 mb-6">
         <div>
             <h1 class="text-2xl font-bold text-gray-800">문서 관리</h1>
-            <p class="text-sm text-gray-500 mt-1">작성된 문서를 관리합니다.</p>
+            <p class="text-sm text-gray-500 mt-1 hidden sm:block">
+                작성된 문서를 관리합니다.
+            </p>
+        </div>
+        <div class="flex flex-wrap items-center gap-2 sm:gap-3">
+            <a href="{{ route('documents.create') }}"
+               class="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-lg transition flex items-center gap-2">
+                <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4" />
+                </svg>
+                새 문서 작성
+            </a>
         </div>
-        <a href="{{ route('documents.create') }}"
-           class="inline-flex items-center px-4 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition-colors">
-            <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4"/>
-            </svg>
-            새 문서 작성
-        </a>
     </div>
 
-    {{-- 필터 --}}
-    <div class="bg-white rounded-lg shadow-sm border border-gray-200 p-4 mb-6">
-        <form id="filterForm" class="grid grid-cols-1 md:grid-cols-4 gap-4">
-            {{-- 상태 필터 --}}
-            <div>
-                <label class="block text-sm font-medium text-gray-700 mb-1">상태</label>
-                <select name="status" class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
-                    <option value="">전체</option>
+    <!-- 필터 영역 -->
+    <x-filter-collapsible id="filterForm">
+        <form id="filterForm" class="flex flex-wrap gap-2 sm:gap-4">
+            <input type="hidden" name="per_page" id="perPageInput" value="15">
+            <input type="hidden" name="page" id="pageInput" value="1">
+
+            <!-- 검색 -->
+            <div class="flex-1 min-w-0 w-full sm:w-auto">
+                <input type="text"
+                       name="search"
+                       placeholder="문서번호, 제목으로 검색..."
+                       class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+
+            <!-- 상태 필터 -->
+            <div class="w-full sm:w-32">
+                <select name="status" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="">전체 상태</option>
                     @foreach($statuses as $value => $label)
                         <option value="{{ $value }}">{{ $label }}</option>
                     @endforeach
                 </select>
             </div>
 
-            {{-- 템플릿 필터 --}}
-            <div>
-                <label class="block text-sm font-medium text-gray-700 mb-1">템플릿</label>
-                <select name="template_id" class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
-                    <option value="">전체</option>
+            <!-- 템플릿 필터 -->
+            <div class="w-full sm:w-40">
+                <select name="template_id" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="">전체 템플릿</option>
                     @foreach($templates as $template)
                         <option value="{{ $template->id }}">{{ $template->name }}</option>
                     @endforeach
                 </select>
             </div>
 
-            {{-- 검색 --}}
-            <div>
-                <label class="block text-sm font-medium text-gray-700 mb-1">검색</label>
-                <input type="text" name="search" placeholder="문서번호, 제목"
-                       class="w-full rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500">
-            </div>
-
-            {{-- 버튼 --}}
-            <div class="flex items-end gap-2">
-                <button type="submit"
-                        class="px-4 py-2 bg-gray-800 text-white text-sm font-medium rounded-lg hover:bg-gray-900 transition-colors">
-                    검색
-                </button>
-                <button type="reset"
-                        class="px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
-                    초기화
-                </button>
-            </div>
+            <!-- 검색 버튼 -->
+            <button type="submit" class="bg-gray-600 hover:bg-gray-700 text-white px-6 py-2 rounded-lg transition w-full sm:w-auto">
+                검색
+            </button>
         </form>
-    </div>
+    </x-filter-collapsible>
 
-    {{-- 문서 목록 --}}
-    <div class="bg-white rounded-lg shadow-sm border border-gray-200">
+    <!-- 문서 목록 테이블 -->
+    <div class="bg-white rounded-lg shadow-sm overflow-hidden">
         <div class="overflow-x-auto">
             <table class="min-w-full divide-y divide-gray-200">
                 <thead class="bg-gray-50">
@@ -81,17 +79,22 @@ class="px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:
                     </tr>
                 </thead>
                 <tbody id="documentList" class="bg-white divide-y divide-gray-200">
-                    {{-- HTMX로 로드 --}}
+                    <!-- 로딩 스피너 -->
+                    <tr id="loadingRow">
+                        <td colspan="7" class="px-6 py-12 text-center">
+                            <div class="flex justify-center items-center">
+                                <div class="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-600"></div>
+                            </div>
+                        </td>
+                    </tr>
                 </tbody>
             </table>
         </div>
 
-        {{-- 페이지네이션 --}}
+        <!-- 페이지네이션 -->
         <div id="pagination" class="px-6 py-4 border-t border-gray-200">
-            {{-- HTMX로 로드 --}}
         </div>
     </div>
-</div>
 @endsection
 
 @push('scripts')
@@ -100,15 +103,13 @@ class="px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:
     loadDocuments();
 
     // 필터 폼 제출
-    document.getElementById('filterForm').addEventListener('submit', function(e) {
-        e.preventDefault();
-        loadDocuments();
-    });
-
-    // 초기화 버튼
-    document.getElementById('filterForm').addEventListener('reset', function() {
-        setTimeout(() => loadDocuments(), 10);
-    });
+    const filterForm = document.getElementById('filterForm');
+    if (filterForm) {
+        filterForm.addEventListener('submit', function(e) {
+            e.preventDefault();
+            loadDocuments();
+        });
+    }
 });
 
 function loadDocuments(page = 1) {
@@ -117,6 +118,17 @@ function loadDocuments(page = 1) {
     const params = new URLSearchParams(formData);
     params.set('page', page);
 
+    // 로딩 표시
+    document.getElementById('documentList').innerHTML = `
+        <tr>
+            <td colspan="7" class="px-6 py-12 text-center">
+                <div class="flex justify-center items-center">
+                    <div class="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-600"></div>
+                </div>
+            </td>
+        </tr>
+    `;
+
     fetch(`/api/admin/documents?${params.toString()}`, {
         headers: {
             'Accept': 'application/json',
diff --git a/resources/views/documents/show.blade.php b/resources/views/documents/show.blade.php
index 4dcf9e2a..5291b174 100644
--- a/resources/views/documents/show.blade.php
+++ b/resources/views/documents/show.blade.php
@@ -3,29 +3,25 @@
 @section('title', '문서 상세')
 
 @section('content')
-<div class="p-6">
-    {{-- 헤더 --}}
-    <div class="flex justify-between items-center mb-6">
+    <!-- 헤더 -->
+    <div class="flex flex-col lg:flex-row lg:justify-between lg:items-center gap-4 mb-6">
         <div>
             <h1 class="text-2xl font-bold text-gray-800">문서 상세</h1>
-            <p class="text-sm text-gray-500 mt-1">{{ $document->document_no }} - {{ $document->title }}</p>
+            <p class="text-sm text-gray-500 mt-1 hidden sm:block">{{ $document->document_no }} - {{ $document->title }}</p>
         </div>
-        <div class="flex gap-2">
+        <div class="flex flex-wrap items-center gap-2 sm:gap-3">
             @if($document->status === 'DRAFT' || $document->status === 'REJECTED')
                 <a href="{{ route('documents.edit', $document->id) }}"
-                   class="inline-flex items-center px-4 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition-colors">
-                    <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                   class="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-lg transition flex items-center gap-2">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/>
                     </svg>
                     수정
                 </a>
             @endif
             <a href="{{ route('documents.index') }}"
-               class="inline-flex items-center px-4 py-2 bg-gray-100 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-200 transition-colors">
-                <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18"/>
-                </svg>
-                목록으로
+               class="bg-gray-200 hover:bg-gray-300 text-gray-700 px-4 py-2 rounded-lg transition">
+                목록
             </a>
         </div>
     </div>
@@ -196,5 +192,4 @@ class="text-sm text-blue-600 hover:text-blue-800">
             </div>
         </div>
     </div>
-</div>
 @endsection
\ No newline at end of file

From 60ab03601f7f99b0983f1cda2f77cf2444b83338 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Thu, 29 Jan 2026 06:57:42 +0900
Subject: [PATCH 10/12] =?UTF-8?q?fix:=EB=8F=99=EA=B8=B0=ED=99=94=20?=
 =?UTF-8?q?=ED=8E=98=EC=9D=B4=EC=A7=80=20CSRF=20=EB=B0=8F=20=EC=9D=B8?=
 =?UTF-8?q?=EC=A6=9D=20=EB=AC=B8=EC=A0=9C=20=EC=88=98=EC=A0=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- CSRF 예외에 common-code-sync/*, category-sync/* 추가
- fetch 요청에 credentials: 'same-origin' 추가
- 메뉴 동기화 시 menu_id 파싱 방식 수정 (value → dataset.menuId)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 bootstrap/app.php                           | 2 ++
 resources/views/categories/sync.blade.php   | 2 ++
 resources/views/common-codes/sync.blade.php | 2 ++
 resources/views/menus/sync.blade.php        | 4 +++-
 4 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/bootstrap/app.php b/bootstrap/app.php
index f65416b7..ff80ee5e 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -24,6 +24,8 @@
         // CSRF 토큰 검증 예외 (외부 API 호출용)
         $middleware->validateCsrfTokens(except: [
             'menu-sync/*',
+            'common-code-sync/*',
+            'category-sync/*',
         ]);
 
         // web 미들웨어 그룹에 자동 재인증 추가
diff --git a/resources/views/categories/sync.blade.php b/resources/views/categories/sync.blade.php
index cf906050..f6914bea 100644
--- a/resources/views/categories/sync.blade.php
+++ b/resources/views/categories/sync.blade.php
@@ -350,6 +350,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
+                credentials: 'same-origin',
                 body: JSON.stringify({ env: selectedEnv, type: selectedType, category_keys: categoryKeys })
             });
 
@@ -388,6 +389,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
+                credentials: 'same-origin',
                 body: JSON.stringify({ env: selectedEnv, type: selectedType, category_keys: categoryKeys })
             });
 
diff --git a/resources/views/common-codes/sync.blade.php b/resources/views/common-codes/sync.blade.php
index ddaa2b46..7f3c3fa3 100644
--- a/resources/views/common-codes/sync.blade.php
+++ b/resources/views/common-codes/sync.blade.php
@@ -351,6 +351,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
+                credentials: 'same-origin',
                 body: JSON.stringify({ env: selectedEnv, type: selectedType, code_keys: codeKeys })
             });
 
@@ -389,6 +390,7 @@ function updateSelectedCount(side) {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
+                credentials: 'same-origin',
                 body: JSON.stringify({ env: selectedEnv, type: selectedType, code_keys: codeKeys })
             });
 
diff --git a/resources/views/menus/sync.blade.php b/resources/views/menus/sync.blade.php
index 08fb5454..4f864e45 100644
--- a/resources/views/menus/sync.blade.php
+++ b/resources/views/menus/sync.blade.php
@@ -381,7 +381,7 @@ function closeSettingsModal() {
             return;
         }
 
-        const menuIds = Array.from(checkboxes).map(cb => cb.value);
+        const menuIds = Array.from(checkboxes).map(cb => parseInt(cb.dataset.menuId));
 
         if (!confirm(`${menuIds.length}개 메뉴를 ${selectedEnv === 'dev' ? '개발' : '운영'} 서버로 Push 하시겠습니까?`)) {
             return;
@@ -395,6 +395,7 @@ function closeSettingsModal() {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
+                credentials: 'same-origin',
                 body: JSON.stringify({ env: selectedEnv, menu_ids: menuIds })
             });
 
@@ -432,6 +433,7 @@ function closeSettingsModal() {
                     'X-CSRF-TOKEN': csrfToken,
                     'Accept': 'application/json'
                 },
+                credentials: 'same-origin',
                 body: JSON.stringify({ env: selectedEnv, menu_names: menuNames })
             });
 

From 09323aaa4ca23d7b81a16d543419f48b03668c40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Thu, 29 Jan 2026 13:04:37 +0900
Subject: [PATCH 11/12] =?UTF-8?q?fix:=EA=B3=B5=ED=86=B5=EC=BD=94=EB=93=9C?=
 =?UTF-8?q?=20=EC=8A=88=ED=8D=BC=EA=B4=80=EB=A6=AC=EC=9E=90=20=EA=B6=8C?=
 =?UTF-8?q?=ED=95=9C=20=EC=9A=B0=ED=9A=8C=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

슈퍼관리자는 다른 테넌트/글로벌 코드 수정·토글·삭제 가능

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 app/Http/Controllers/CommonCodeController.php | 73 +++++++++++--------
 1 file changed, 44 insertions(+), 29 deletions(-)

diff --git a/app/Http/Controllers/CommonCodeController.php b/app/Http/Controllers/CommonCodeController.php
index 236f6e04..47d6d33e 100644
--- a/app/Http/Controllers/CommonCodeController.php
+++ b/app/Http/Controllers/CommonCodeController.php
@@ -178,19 +178,25 @@ public function update(Request $request, int $id): RedirectResponse|JsonResponse
             return redirect()->back()->with('error', '코드를 찾을 수 없습니다.');
         }
 
-        // 권한 체크: 글로벌 코드는 HQ만, 테넌트 코드는 해당 테넌트만
-        if ($code->tenant_id === null && ! $isHQ) {
-            if ($request->ajax()) {
-                return response()->json(['error' => '글로벌 코드는 본사만 수정할 수 있습니다.'], 403);
-            }
-            return redirect()->back()->with('error', '글로벌 코드는 본사만 수정할 수 있습니다.');
-        }
+        // 권한 체크: 슈퍼관리자는 모든 코드 수정 가능
+        $isSuperAdmin = auth()->user()?->isSuperAdmin() ?? false;
 
-        if ($code->tenant_id !== null && $code->tenant_id !== $tenantId) {
-            if ($request->ajax()) {
-                return response()->json(['error' => '다른 테넌트의 코드는 수정할 수 없습니다.'], 403);
+        if (! $isSuperAdmin) {
+            // 글로벌 코드는 HQ만
+            if ($code->tenant_id === null && ! $isHQ) {
+                if ($request->ajax()) {
+                    return response()->json(['error' => '글로벌 코드는 본사만 수정할 수 있습니다.'], 403);
+                }
+                return redirect()->back()->with('error', '글로벌 코드는 본사만 수정할 수 있습니다.');
+            }
+
+            // 테넌트 코드는 해당 테넌트만
+            if ($code->tenant_id !== null && $code->tenant_id !== $tenantId) {
+                if ($request->ajax()) {
+                    return response()->json(['error' => '다른 테넌트의 코드는 수정할 수 없습니다.'], 403);
+                }
+                return redirect()->back()->with('error', '다른 테넌트의 코드는 수정할 수 없습니다.');
             }
-            return redirect()->back()->with('error', '다른 테넌트의 코드는 수정할 수 없습니다.');
         }
 
         $validated = $request->validate([
@@ -244,13 +250,17 @@ public function toggle(Request $request, int $id): JsonResponse
             return response()->json(['error' => '코드를 찾을 수 없습니다.'], 404);
         }
 
-        // 권한 체크
-        if ($code->tenant_id === null && ! $isHQ) {
-            return response()->json(['error' => '글로벌 코드는 본사만 수정할 수 있습니다.'], 403);
-        }
+        // 권한 체크: 슈퍼관리자는 모든 코드 수정 가능
+        $isSuperAdmin = auth()->user()?->isSuperAdmin() ?? false;
 
-        if ($code->tenant_id !== null && $code->tenant_id !== $tenantId) {
-            return response()->json(['error' => '다른 테넌트의 코드는 수정할 수 없습니다.'], 403);
+        if (! $isSuperAdmin) {
+            if ($code->tenant_id === null && ! $isHQ) {
+                return response()->json(['error' => '글로벌 코드는 본사만 수정할 수 있습니다.'], 403);
+            }
+
+            if ($code->tenant_id !== null && $code->tenant_id !== $tenantId) {
+                return response()->json(['error' => '다른 테넌트의 코드는 수정할 수 없습니다.'], 403);
+            }
         }
 
         $code->is_active = ! $code->is_active;
@@ -438,20 +448,25 @@ public function destroy(Request $request, int $id): RedirectResponse|JsonRespons
             return redirect()->back()->with('error', '코드를 찾을 수 없습니다.');
         }
 
-        // 글로벌 코드 삭제는 HQ만
-        if ($code->tenant_id === null && ! $isHQ) {
-            if ($request->ajax()) {
-                return response()->json(['error' => '글로벌 코드는 본사만 삭제할 수 있습니다.'], 403);
-            }
-            return redirect()->back()->with('error', '글로벌 코드는 본사만 삭제할 수 있습니다.');
-        }
+        // 권한 체크: 슈퍼관리자는 모든 코드 삭제 가능
+        $isSuperAdmin = auth()->user()?->isSuperAdmin() ?? false;
 
-        // 다른 테넌트 코드 삭제 불가
-        if ($code->tenant_id !== null && $code->tenant_id !== $tenantId) {
-            if ($request->ajax()) {
-                return response()->json(['error' => '다른 테넌트의 코드는 삭제할 수 없습니다.'], 403);
+        if (! $isSuperAdmin) {
+            // 글로벌 코드 삭제는 HQ만
+            if ($code->tenant_id === null && ! $isHQ) {
+                if ($request->ajax()) {
+                    return response()->json(['error' => '글로벌 코드는 본사만 삭제할 수 있습니다.'], 403);
+                }
+                return redirect()->back()->with('error', '글로벌 코드는 본사만 삭제할 수 있습니다.');
+            }
+
+            // 다른 테넌트 코드 삭제 불가
+            if ($code->tenant_id !== null && $code->tenant_id !== $tenantId) {
+                if ($request->ajax()) {
+                    return response()->json(['error' => '다른 테넌트의 코드는 삭제할 수 없습니다.'], 403);
+                }
+                return redirect()->back()->with('error', '다른 테넌트의 코드는 삭제할 수 없습니다.');
             }
-            return redirect()->back()->with('error', '다른 테넌트의 코드는 삭제할 수 없습니다.');
         }
 
         $codeGroup = $code->code_group;

From 0ea373e8e3f86e3a08406395887542108524e247 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B6=8C=ED=98=81=EC=84=B1?= <shine1324@gmail.com>
Date: Fri, 30 Jan 2026 11:23:40 +0900
Subject: [PATCH 12/12] =?UTF-8?q?fix(MNG):=20tenant-storage=20=EC=8B=AC?=
 =?UTF-8?q?=EB=A7=81=ED=81=AC=20=EA=B2=BD=EB=A1=9C=EB=A5=BC=20api/storage?=
 =?UTF-8?q?=EB=A1=9C=20=EB=B3=80=EA=B2=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 public/tenant-storage | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/public/tenant-storage b/public/tenant-storage
index 96384d24..2a73345c 120000
--- a/public/tenant-storage
+++ b/public/tenant-storage
@@ -1 +1 @@
-/var/www/shared-storage/tenants
\ No newline at end of file
+/var/www/api/storage/app/tenants
\ No newline at end of file