fix: [bim] 하단 툴바 2행 시 스크롤바 제거 및 컴팩트화

- 컨테이너 padding/gap 축소 (px-4 py-2 gap-3 → px-3 py-1 gap-1.5)
- 버튼 padding 축소 (py-1.5 → py-1, px-2/3 → px-1.5/2)
- 버튼 내부 gap 축소 (gap-1 → gap-0.5)
- 구분선 높이 축소 (h-6 → h-5)
- overflow-hidden 추가로 스크롤바 방지

.gitignore

@@ -165,3 +165,6 @@ package-lock.json
 
 # 다운로드용 PPTX 파일은 프로젝트 자산으로 추적
 !public/downloads/*.pptx
+
+# 건설PMIS KCC 참고 이미지는 프로젝트 자산으로 추적
+!public/images/juil/pmis-flow/*.png

CLAUDE.md

@@ -126,44 +126,81 @@ ### Tailwind 기본 클래스는 그대로 사용
 
 ---
 
-## 데이터베이스 아키텍처 (필수 규칙)
+## Blade + React(JSX) 혼용 규칙 (필수)
 
-> **경고: MNG 프로젝트에서는 마이그레이션 파일을 생성하지 않습니다!**
+> **경고: Blade 파일에서 React/JSX 코드 수정 시 반드시 확인하세요!**
+> **정책 문서**: `/home/aweso/sam/docs/dev/standards/blade-react-policy.md`
 
 ### 핵심 원칙
 
-| 작업 | 올바른 위치 | MNG에서 |
-|------|------------|---------|
-| 마이그레이션 생성 | `/home/aweso/sam/api/database/migrations/` | ❌ 금지 |
-| 마이그레이션 실행 | `docker exec sam-api-1 php artisan migrate` | ❌ 금지 |
-| 테이블 생성/수정 | API 프로젝트에서만 | ❌ 금지 |
+Blade 엔진은 `@verbatim` 외부의 모든 이중 중괄호를 PHP echo로 변환한다. JSX의 `style=` 이중중괄호 패턴은 Blade와 충돌하여 **500 에러(ParseError)**를 유발한다.
+
+### 필수 준수 사항
+
+```
+❌ @verbatim 없는 파일에서 style={{ key: 'value' }} 사용 금지
+❌ JS 주석에 이중 중괄호 텍스트 포함 금지
+✅ 스타일 객체를 JS 변수로 선언 후 단일 중괄호로 참조
+✅ React/JSX 코드 수정 전 @verbatim 사용 여부 확인
+```
+
+### 허용 패턴
+
+```javascript
+// 변수로 분리 (Blade 충돌 없음)
+const tableStyle = { tableLayout: 'fixed' };
+const colWidths = [{ width: '10%' }, { width: '22%' }];
+
+// 단일 중괄호로 참조
+<table style={tableStyle}>
+    <col style={colWidths[0]} />
+</table>
+```
+
+### 현재 파일 현황
+
+| 파일 | @verbatim | 주의 |
+|------|:---------:|:----:|
+| `finance/journal-entries.blade.php` | ✅ | 안전 |
+| `barobill/ecard/index.blade.php` | ❌ | 주의 필요 |
+
+---
+
+## 데이터베이스 아키텍처 (필수 규칙)
+
+> **codebridge 서버 분리 이후, MNG는 자체 DB 마이그레이션을 관리합니다.**
+
+### 핵심 원칙
+
+| 작업 | MNG 전용 테이블 | 공용 테이블 |
+|------|----------------|------------|
+| 마이그레이션 생성 | ✅ `mng/database/migrations/` | ⚠️ `api/database/migrations/` |
+| 마이그레이션 실행 | `docker exec sam-mng-1 php artisan migrate` | `docker exec sam-api-1 php artisan migrate` |
+| 모델 생성 | ✅ `mng/app/Models/` | ✅ `mng/app/Models/` |
 
 ### MNG database 폴더 상태
 
 ```
 /home/aweso/sam/mng/database/
-├── migrations/     ← 비어있음 (파일 생성 금지!)
-├── seeders/        ← MNG 전용 시더만 허용 (예: MngMenuSeeder)
-└── factories/      ← 사용 안 함
+├── migrations/     ← MNG 전용 테이블 마이그레이션 (예: pmis_*)
+├── seeders/        ← MNG 전용 시더 (예: MngMenuSeeder)
+└── factories/      ← 필요 시 사용
 ```
 
 ### MNG에서 허용되는 것
 
 - ✅ 컨트롤러, 뷰, 라우트 작성
-- ✅ 모델 작성 (API의 테이블 사용)
+- ✅ 모델 작성
+- ✅ MNG 전용 테이블 마이그레이션 생성/실행
 - ✅ MNG 전용 시더 (MngMenuSeeder 등)
 
-### MNG에서 금지되는 것
+### 공용 테이블이 필요할 때
 
-- ❌ `database/migrations/` 에 파일 생성
-- ❌ `docker exec sam-mng-1 php artisan migrate` 실행
-- ❌ 테이블 구조 변경 관련 작업
-
-### 새 테이블이 필요할 때
+공용 테이블(API와 MNG 모두 사용)은 API에서 관리:
 
 1. API 프로젝트에서 마이그레이션 생성
 2. `docker exec sam-api-1 php artisan migrate` 실행
-3. MNG에서 해당 테이블의 모델만 작성
+3. MNG에서 해당 테이블의 모델 작성
 
 ---
 

CURRENT_WORKS.md

@@ -12,4 +12,4 @@ ## 최근 커밋 이력 (참고용)
 
 ## 다음 단계 (필요 시)
 - API Explorer Phase 2-5 (API 실행, 즐겨찾기, 히스토리, UX 개선)
-- MNG 견적수식 관리 UI 개발 (`docs/plans/mng-quote-formula-development-plan.md`)
+- MNG 견적수식 관리 UI 개발 (`docs/dev/dev_plans/mng-quote-formula-development-plan.md`)

Jenkinsfile

@@ -32,6 +32,7 @@ pipeline {
                             --exclude='.git' \
                             --exclude='.env' \
                             --exclude='storage/app' \
+                            --exclude='storage/fonts' \
                             --exclude='storage/logs' \
                             --exclude='storage/framework/sessions' \
                             --exclude='storage/framework/cache' \
@@ -46,6 +47,7 @@ pipeline {
                             sudo chmod 640 /home/webservice/mng/shared/.env &&
                             ln -sfn /home/webservice/mng/shared/storage/app storage/app &&
                             ln -sfn /home/webservice/mng/shared/storage/credentials storage/credentials &&
+                            rm -rf storage/fonts && ln -sfn /home/webservice/mng/shared/storage/fonts storage/fonts &&
                             composer install --no-dev --optimize-autoloader --no-interaction &&
                             npm install --prefer-offline &&
                             npm run build &&

app/Http/Controllers/Api/Admin/DepartmentController.php

@@ -178,6 +178,54 @@ public function restore(Request $request, int $id): JsonResponse
         ]);
     }
 
+    /**
+     * 일괄 삭제 (Soft Delete)
+     */
+    public function bulkDelete(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $deleted = 0;
+        foreach ($validated['ids'] as $id) {
+            if ($this->departmentService->deleteDepartment($id)) {
+                $deleted++;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$deleted}개 부서가 삭제되었습니다.", 'deleted' => $deleted]);
+    }
+
+    /**
+     * 일괄 복원
+     */
+    public function bulkRestore(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $restored = 0;
+        foreach ($validated['ids'] as $id) {
+            if ($this->departmentService->restoreDepartment($id)) {
+                $restored++;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$restored}개 부서가 복원되었습니다.", 'restored' => $restored]);
+    }
+
+    /**
+     * 일괄 영구삭제 (슈퍼관리자 전용)
+     */
+    public function bulkForceDelete(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $deleted = 0;
+        foreach ($validated['ids'] as $id) {
+            if ($this->departmentService->forceDeleteDepartment($id)) {
+                $deleted++;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$deleted}개 부서가 영구 삭제되었습니다.", 'deleted' => $deleted]);
+    }
+
     /**
      * 부서 영구 삭제
      */

app/Http/Controllers/Api/Admin/HR/BusinessIncomePaymentController.php

@@ -17,7 +17,7 @@
 
 class BusinessIncomePaymentController extends Controller
 {
-    private const ALLOWED_PAYROLL_USERS = ['이경호', '전진선', '김보곤'];
+    private const ALLOWED_PAYROLL_USERS = ['이의찬', '전진선', '김보곤'];
 
     public function __construct(
         private BusinessIncomePaymentService $service
@@ -25,7 +25,10 @@ public function __construct(
 
     private function checkPayrollAccess(): ?JsonResponse
     {
-        if (! in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS)) {
+        $isAllowedUser = in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS);
+        $isDevSuperAdmin = ! app()->environment('production') && auth()->user()->isSuperAdmin();
+
+        if (! $isAllowedUser && ! $isDevSuperAdmin) {
             return response()->json([
                 'success' => false,
                 'message' => '급여관리는 관계자만 볼 수 있습니다.',

app/Http/Controllers/Api/Admin/HR/EmployeeController.php

@@ -95,6 +95,7 @@ public function store(Request $request): JsonResponse
             'address' => 'nullable|string|max:200',
             'emergency_contact' => 'nullable|string|max:100',
             'resident_number' => 'nullable|string|max:14',
+            'personal_email' => 'nullable|email|max:100',
             'bank_account.bank_code' => 'nullable|string|max:20',
             'bank_account.bank_name' => 'nullable|string|max:50',
             'bank_account.account_holder' => 'nullable|string|max:50',
@@ -176,6 +177,7 @@ public function update(Request $request, int $id): JsonResponse
             'address' => 'nullable|string|max:200',
             'emergency_contact' => 'nullable|string|max:100',
             'resident_number' => 'nullable|string|max:14',
+            'personal_email' => 'nullable|email|max:100',
             'bank_account.bank_code' => 'nullable|string|max:20',
             'bank_account.bank_name' => 'nullable|string|max:50',
             'bank_account.account_holder' => 'nullable|string|max:50',

app/Http/Controllers/Api/Admin/HR/EmployeeSalaryController.php

@@ -0,0 +1,139 @@
+<?php
+
+namespace App\Http\Controllers\Api\Admin\HR;
+
+use App\Http\Controllers\Controller;
+use App\Models\HR\Employee;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class EmployeeSalaryController extends Controller
+{
+    private const ALLOWED_SALARY_USERS = ['이의찬', '전진선', '김보곤'];
+
+    private function checkSalaryAccess(): ?JsonResponse
+    {
+        $isAllowedUser = in_array(auth()->user()->name, self::ALLOWED_SALARY_USERS);
+        $isDevSuperAdmin = ! app()->environment('production') && auth()->user()->isSuperAdmin();
+
+        if (! $isAllowedUser && ! $isDevSuperAdmin) {
+            return response()->json([
+                'success' => false,
+                'message' => '연봉 정보는 권한이 있는 관계자만 열람할 수 있습니다.',
+            ], 403);
+        }
+
+        return null;
+    }
+
+    /**
+     * 사원 연봉 정보 조회
+     */
+    public function show(int $id): JsonResponse
+    {
+        if ($denied = $this->checkSalaryAccess()) {
+            return $denied;
+        }
+
+        $employee = Employee::forTenant()->find($id);
+
+        if (! $employee) {
+            return response()->json([
+                'success' => false,
+                'message' => '사원 정보를 찾을 수 없습니다.',
+            ], 404);
+        }
+
+        return response()->json([
+            'success' => true,
+            'data' => $employee->getSalaryInfo(),
+        ]);
+    }
+
+    /**
+     * 사원 연봉 정보 저장/수정
+     */
+    public function update(Request $request, int $id): JsonResponse
+    {
+        if ($denied = $this->checkSalaryAccess()) {
+            return $denied;
+        }
+
+        $validated = $request->validate([
+            'annual_salary' => 'nullable|integer|min:0',
+            'meal_allowance' => 'nullable|integer|min:0|max:1000000',
+            'fixed_overtime_hours' => 'nullable|integer|min:0|max:52',
+            'effective_date' => 'nullable|date',
+            'notes' => 'nullable|string|max:500',
+        ]);
+
+        $employee = Employee::forTenant()->find($id);
+
+        if (! $employee) {
+            return response()->json([
+                'success' => false,
+                'message' => '사원 정보를 찾을 수 없습니다.',
+            ], 404);
+        }
+
+        try {
+            $employee->setSalaryInfo($validated);
+            $employee->save();
+
+            return response()->json([
+                'success' => true,
+                'message' => '연봉 정보가 저장되었습니다.',
+                'data' => $employee->getSalaryInfo(),
+            ]);
+        } catch (\Throwable $e) {
+            report($e);
+
+            return response()->json([
+                'success' => false,
+                'message' => '연봉 정보 저장 중 오류가 발생했습니다.',
+                'error' => config('app.debug') ? $e->getMessage() : null,
+            ], 500);
+        }
+    }
+
+    /**
+     * 연봉 이력 삭제 (특정 인덱스)
+     */
+    public function deleteHistory(Request $request, int $id, int $historyIndex): JsonResponse
+    {
+        if ($denied = $this->checkSalaryAccess()) {
+            return $denied;
+        }
+
+        $employee = Employee::forTenant()->find($id);
+
+        if (! $employee) {
+            return response()->json([
+                'success' => false,
+                'message' => '사원 정보를 찾을 수 없습니다.',
+            ], 404);
+        }
+
+        $salaryInfo = $employee->getSalaryInfo();
+        $history = $salaryInfo['history'] ?? [];
+
+        if (! isset($history[$historyIndex])) {
+            return response()->json([
+                'success' => false,
+                'message' => '해당 이력을 찾을 수 없습니다.',
+            ], 404);
+        }
+
+        array_splice($history, $historyIndex, 1);
+        $salaryInfo['history'] = $history;
+
+        $employee->setJsonExtraValue('salary_info', $salaryInfo);
+        $employee->save();
+
+        return response()->json([
+            'success' => true,
+            'message' => '이력이 삭제되었습니다.',
+            'data' => $employee->getSalaryInfo(),
+        ]);
+    }
+}

app/Http/Controllers/Api/Admin/HR/LeaveController.php

@@ -53,6 +53,8 @@ public function store(Request $request): JsonResponse
             'end_date' => 'required|date|after_or_equal:start_date',
             'reason' => 'nullable|string|max:1000',
             'approval_line_id' => 'nullable|integer|exists:approval_lines,id',
+            'references' => 'nullable|array',
+            'references.*.user_id' => 'required|integer|exists:users,id',
         ]);
 
         try {

app/Http/Controllers/Api/Admin/HR/PayrollController.php

@@ -24,7 +24,7 @@
 
 class PayrollController extends Controller
 {
-    private const ALLOWED_PAYROLL_USERS = ['이경호', '전진선', '김보곤'];
+    private const ALLOWED_PAYROLL_USERS = ['이의찬', '전진선', '김보곤'];
 
     public function __construct(
         private PayrollService $payrollService
@@ -32,7 +32,10 @@ public function __construct(
 
     private function checkPayrollAccess(): ?JsonResponse
     {
-        if (! in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS)) {
+        $isAllowedUser = in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS);
+        $isDevSuperAdmin = ! app()->environment('production') && auth()->user()->isSuperAdmin();
+
+        if (! $isAllowedUser && ! $isDevSuperAdmin) {
             return response()->json([
                 'success' => false,
                 'message' => '급여관리는 관계자만 볼 수 있습니다.',
@@ -187,7 +190,8 @@ public function update(Request $request, int $id): JsonResponse
         ]);
 
         try {
-            $payroll = $this->payrollService->updatePayroll($id, $validated);
+            $isSuperAdmin = auth()->user()?->isSuperAdmin() ?? false;
+            $payroll = $this->payrollService->updatePayroll($id, $validated, $isSuperAdmin);
 
             if (! $payroll) {
                 return response()->json([
@@ -360,6 +364,48 @@ public function pay(Request $request, int $id): JsonResponse
         }
     }
 
+    /**
+     * 급여 지급 취소 (paid → draft, 슈퍼관리자 전용)
+     */
+    public function unpay(Request $request, int $id): JsonResponse
+    {
+        if ($denied = $this->checkPayrollAccess()) {
+            return $denied;
+        }
+
+        if (! auth()->user()?->isSuperAdmin()) {
+            return response()->json([
+                'success' => false,
+                'message' => '슈퍼관리자만 지급 취소할 수 있습니다.',
+            ], 403);
+        }
+
+        try {
+            $payroll = $this->payrollService->unpayPayroll($id);
+
+            if (! $payroll) {
+                return response()->json([
+                    'success' => false,
+                    'message' => '급여 지급을 취소할 수 없습니다.',
+                ], 404);
+            }
+
+            return response()->json([
+                'success' => true,
+                'message' => '급여 지급이 취소되었습니다. (작성중 상태로 변경)',
+                'data' => $payroll,
+            ]);
+        } catch (\Throwable $e) {
+            report($e);
+
+            return response()->json([
+                'success' => false,
+                'message' => '급여 지급 취소 중 오류가 발생했습니다.',
+                'error' => config('app.debug') ? $e->getMessage() : null,
+            ], 500);
+        }
+    }
+
     /**
      * 전월 급여 복사 등록
      */
@@ -738,27 +784,49 @@ public function generateJournalEntry(Request $request): JsonResponse
         }
 
         // 해당월 급여 합산
-        $sums = Payroll::forTenant($tenantId)
+        $payrolls = Payroll::forTenant($tenantId)
             ->forPeriod($year, $month)
-            ->selectRaw('
-                SUM(gross_salary) as total_gross,
-                SUM(pension) as total_pension,
-                SUM(health_insurance) as total_health,
-                SUM(long_term_care) as total_ltc,
-                SUM(employment_insurance) as total_emp,
-                SUM(income_tax) as total_income_tax,
-                SUM(resident_tax) as total_resident_tax,
-                SUM(net_salary) as total_net
-            ')
-            ->first();
+            ->get();
 
-        if (! $sums || (int) $sums->total_gross === 0) {
+        if ($payrolls->isEmpty()) {
             return response()->json([
                 'success' => false,
                 'message' => '해당 월 급여 데이터가 없습니다.',
             ], 422);
         }
 
+        // 기타공제(deductions JSON) 항목별 합산 (이름 정규화)
+        $extraDeductionsByName = [];
+        foreach ($payrolls as $p) {
+            foreach ($p->deductions ?? [] as $d) {
+                $name = trim(preg_replace('/\s+/', ' ', $d['name'] ?? '기타공제'));
+                $amount = (int) ($d['amount'] ?? 0);
+                if ($amount != 0) {
+                    $extraDeductionsByName[$name] = ($extraDeductionsByName[$name] ?? 0) + $amount;
+                }
+            }
+        }
+        $extraDeductionsTotal = array_sum($extraDeductionsByName);
+
+        $sums = (object) [
+            'total_gross' => $payrolls->sum('gross_salary'),
+            'total_pension' => $payrolls->sum('pension'),
+            'total_health' => $payrolls->sum('health_insurance'),
+            'total_ltc' => $payrolls->sum('long_term_care'),
+            'total_emp' => $payrolls->sum('employment_insurance'),
+            'total_income_tax' => $payrolls->sum('income_tax'),
+            'total_resident_tax' => $payrolls->sum('resident_tax'),
+            'total_net' => $payrolls->sum('net_salary'),
+            'total_extra_deductions' => $extraDeductionsTotal,
+        ];
+
+        if ((int) $sums->total_gross === 0) {
+            return response()->json([
+                'success' => false,
+                'message' => '해당 월 급여 데이터의 총지급액이 0입니다.',
+            ], 422);
+        }
+
         // 거래처 조회
         $partnerNames = ['임직원', '건강보험연금', '건강보험건강', '건강보험고용', '강서세무서', '강서구청'];
         $partners = TradingPartner::forTenant($tenantId)
@@ -791,11 +859,33 @@ public function generateJournalEntry(Request $request): JsonResponse
         $monthLabel = "{$month}월분";
 
         // 분개 행 구성
+        // 양수 공제 → 대변 207 예수금 (원천징수)
+        // 음수 공제 → 차변 207 예수금 (환급, 예수금 감소)
+        // net_salary → DB 실제 값 사용 (역산 아님)
         $lines = [];
         $lineNo = 1;
 
-        // 1. 차변: 801 급여 / 임직원
         $grossAmount = (int) $sums->total_gross;
+        $netSalary = (int) $sums->total_net;
+
+        // 공제항목 정의: [합산값, 거래처, 적요]
+        $deductionItems = [
+            [(int) $sums->total_pension, '건강보험연금', '국민연금'],
+            [(int) $sums->total_health, '건강보험건강', '건강보험'],
+            [(int) $sums->total_ltc, '건강보험건강', '장기요양보험'],
+            [(int) $sums->total_emp, '건강보험고용', '고용보험'],
+            [(int) $sums->total_income_tax, '강서세무서', "{$monthLabel} 근로소득세"],
+            [(int) $sums->total_resident_tax, '강서구청', "{$monthLabel} 지방소득세"],
+        ];
+
+        // 기타공제 (항목별)
+        foreach ($extraDeductionsByName as $deductionName => $deductionAmount) {
+            if ($deductionAmount != 0) {
+                $deductionItems[] = [$deductionAmount, '임직원', $deductionName];
+            }
+        }
+
+        // 1. 차변: 801 급여 / 임직원 — 총지급액
         if ($grossAmount > 0) {
             $lines[] = [
                 'dc_type' => 'debit',
@@ -810,104 +900,42 @@ public function generateJournalEntry(Request $request): JsonResponse
             ];
         }
 
-        // 2. 대변: 207 예수금 / 건강보험연금 — 국민연금
-        $pension = (int) $sums->total_pension;
-        if ($pension > 0) {
-            $lines[] = [
-                'dc_type' => 'credit',
-                'account_code' => '207',
-                'account_name' => $accountCodes['207'],
-                'trading_partner_id' => $partners['건강보험연금'],
-                'trading_partner_name' => '건강보험연금',
-                'debit_amount' => 0,
-                'credit_amount' => $pension,
-                'description' => '국민연금',
-                'line_no' => $lineNo++,
-            ];
+        // 2~N. 공제항목: 모두 대변 처리 (음수 공제는 마이너스 대변)
+        // 동일 description + partner 병합을 위해 key 기반 합산
+        $creditLines = [];
+        foreach ($deductionItems as [$amount, $partnerName, $desc]) {
+            if ($amount == 0) {
+                continue;
+            }
+
+            $description = $amount < 0 ? "{$desc} (환급)" : $desc;
+            $mergeKey = "{$partnerName}|{$description}";
+
+            if (isset($creditLines[$mergeKey])) {
+                $creditLines[$mergeKey]['credit_amount'] += $amount;
+            } else {
+                $creditLines[$mergeKey] = [
+                    'dc_type' => 'credit',
+                    'account_code' => '207',
+                    'account_name' => $accountCodes['207'],
+                    'trading_partner_id' => $partners[$partnerName],
+                    'trading_partner_name' => $partnerName,
+                    'debit_amount' => 0,
+                    'credit_amount' => $amount,
+                    'description' => $description,
+                ];
+            }
         }
 
-        // 3. 대변: 207 예수금 / 건강보험건강 — 건강보험
-        $health = (int) $sums->total_health;
-        if ($health > 0) {
-            $lines[] = [
-                'dc_type' => 'credit',
-                'account_code' => '207',
-                'account_name' => $accountCodes['207'],
-                'trading_partner_id' => $partners['건강보험건강'],
-                'trading_partner_name' => '건강보험건강',
-                'debit_amount' => 0,
-                'credit_amount' => $health,
-                'description' => '건강보험',
-                'line_no' => $lineNo++,
-            ];
+        foreach ($creditLines as $creditLine) {
+            if ($creditLine['credit_amount'] == 0) {
+                continue;
+            }
+            $creditLine['line_no'] = $lineNo++;
+            $lines[] = $creditLine;
         }
 
-        // 4. 대변: 207 예수금 / 건강보험건강 — 장기요양보험
-        $ltc = (int) $sums->total_ltc;
-        if ($ltc > 0) {
-            $lines[] = [
-                'dc_type' => 'credit',
-                'account_code' => '207',
-                'account_name' => $accountCodes['207'],
-                'trading_partner_id' => $partners['건강보험건강'],
-                'trading_partner_name' => '건강보험건강',
-                'debit_amount' => 0,
-                'credit_amount' => $ltc,
-                'description' => '장기요양보험',
-                'line_no' => $lineNo++,
-            ];
-        }
-
-        // 5. 대변: 207 예수금 / 건강보험고용 — 고용보험
-        $emp = (int) $sums->total_emp;
-        if ($emp > 0) {
-            $lines[] = [
-                'dc_type' => 'credit',
-                'account_code' => '207',
-                'account_name' => $accountCodes['207'],
-                'trading_partner_id' => $partners['건강보험고용'],
-                'trading_partner_name' => '건강보험고용',
-                'debit_amount' => 0,
-                'credit_amount' => $emp,
-                'description' => '고용보험',
-                'line_no' => $lineNo++,
-            ];
-        }
-
-        // 6. 대변: 207 예수금 / 강서세무서 — 근로소득세
-        $incomeTax = (int) $sums->total_income_tax;
-        if ($incomeTax > 0) {
-            $lines[] = [
-                'dc_type' => 'credit',
-                'account_code' => '207',
-                'account_name' => $accountCodes['207'],
-                'trading_partner_id' => $partners['강서세무서'],
-                'trading_partner_name' => '강서세무서',
-                'debit_amount' => 0,
-                'credit_amount' => $incomeTax,
-                'description' => "{$monthLabel} 근로소득세",
-                'line_no' => $lineNo++,
-            ];
-        }
-
-        // 7. 대변: 207 예수금 / 강서구청 — 지방소득세
-        $residentTax = (int) $sums->total_resident_tax;
-        if ($residentTax > 0) {
-            $lines[] = [
-                'dc_type' => 'credit',
-                'account_code' => '207',
-                'account_name' => $accountCodes['207'],
-                'trading_partner_id' => $partners['강서구청'],
-                'trading_partner_name' => '강서구청',
-                'debit_amount' => 0,
-                'credit_amount' => $residentTax,
-                'description' => "{$monthLabel} 지방소득세",
-                'line_no' => $lineNo++,
-            ];
-        }
-
-        // 8. 대변: 205 미지급비용 / 임직원 — 급여
-        $netSalary = (int) $sums->total_net;
+        // 최종: 대변 205 미지급비용 / 임직원 — 실수령액 (DB 값)
         if ($netSalary > 0) {
             $lines[] = [
                 'dc_type' => 'credit',
@@ -927,9 +955,18 @@ public function generateJournalEntry(Request $request): JsonResponse
         $totalCredit = collect($lines)->sum('credit_amount');
 
         if ($totalDebit !== $totalCredit || $totalDebit === 0) {
+            $detail = collect($lines)->map(fn ($l) => sprintf(
+                '[%s] %s %s: %s',
+                $l['dc_type'],
+                $l['account_code'],
+                $l['description'],
+                number_format($l['dc_type'] === 'debit' ? $l['debit_amount'] : $l['credit_amount'])
+            ))->implode("\n");
+
             return response()->json([
                 'success' => false,
-                'message' => "차변({$totalDebit})과 대변({$totalCredit})이 일치하지 않습니다.",
+                'message' => '차변('.number_format($totalDebit).')과 대변('.number_format($totalCredit).")이 일치하지 않습니다.\n차이: ".number_format(abs($totalDebit - $totalCredit)),
+                'detail' => "급여 {$payrolls->count()}건 합산\n\n{$detail}",
             ], 422);
         }
 
@@ -980,6 +1017,46 @@ public function generateJournalEntry(Request $request): JsonResponse
         }
     }
 
+    /**
+     * 급여명세서 이메일 발송
+     */
+    public function sendPayslip(Request $request, int $id): JsonResponse
+    {
+        if ($denied = $this->checkPayrollAccess()) {
+            return $denied;
+        }
+
+        try {
+            $result = $this->payrollService->sendPayslip($id);
+
+            if (! $result) {
+                return response()->json([
+                    'success' => false,
+                    'message' => '급여 정보를 찾을 수 없습니다.',
+                ], 404);
+            }
+
+            return response()->json([
+                'success' => true,
+                'message' => $result['message'],
+                'data' => ['email' => $result['email']],
+            ]);
+        } catch (\RuntimeException $e) {
+            return response()->json([
+                'success' => false,
+                'message' => $e->getMessage(),
+            ], 422);
+        } catch (\Throwable $e) {
+            report($e);
+
+            return response()->json([
+                'success' => false,
+                'message' => '이메일 발송 중 오류가 발생했습니다.',
+                'error' => config('app.debug') ? $e->getMessage() : null,
+            ], 500);
+        }
+    }
+
     /**
      * 급여 계산 미리보기 (AJAX)
      */

app/Http/Controllers/Api/Admin/RoleController.php

@@ -115,6 +115,25 @@ public function update(UpdateRoleRequest $request, int $id): JsonResponse
         ]);
     }
 
+    /**
+     * 일괄 삭제
+     */
+    public function bulkDelete(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $deleted = 0;
+        foreach ($validated['ids'] as $id) {
+            try {
+                $this->roleService->deleteRole($id);
+                $deleted++;
+            } catch (\Exception $e) {
+                continue;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$deleted}개 역할이 삭제되었습니다.", 'deleted' => $deleted]);
+    }
+
     /**
      * 역할 삭제 (Soft Delete)
      */

app/Http/Controllers/Api/Admin/TenantUserApiController.php

@@ -84,10 +84,14 @@ public function list(): JsonResponse
                     ->whereRaw('pos_title.`key` COLLATE utf8mb4_unicode_ci = tp.job_title_key COLLATE utf8mb4_unicode_ci');
             })
             ->whereNull('users.deleted_at')
+            ->whereNotNull('tp.department_id')
             ->where(function ($q) {
                 $q->whereNull('tp.employee_status')
                     ->orWhere('tp.employee_status', '!=', 'resigned');
             })
+            ->when($tenantId == 1, function ($q) {
+                $q->where('departments.name', '!=', '영업팀');
+            })
             ->orderBy('departments.name')
             ->orderByRaw('COALESCE(pos_rank.sort_order, pos_title.sort_order, 9999) ASC')
             ->orderBy('users.name')

app/Http/Controllers/Api/Admin/UserController.php

@@ -294,6 +294,57 @@ public function forceDestroy(Request $request, int $id): JsonResponse
         ]);
     }
 
+    /**
+     * 일괄 삭제 (Soft Delete)
+     */
+    public function bulkDelete(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $deleted = 0;
+        foreach ($validated['ids'] as $id) {
+            if ($this->userService->deleteUser($id)) {
+                $deleted++;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$deleted}명의 사용자가 삭제되었습니다.", 'deleted' => $deleted]);
+    }
+
+    /**
+     * 일괄 복원
+     */
+    public function bulkRestore(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $restored = 0;
+        foreach ($validated['ids'] as $id) {
+            if ($this->userService->restoreUser($id)) {
+                $restored++;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$restored}명의 사용자가 복원되었습니다.", 'restored' => $restored]);
+    }
+
+    /**
+     * 일괄 영구삭제 (슈퍼관리자 전용)
+     */
+    public function bulkForceDelete(Request $request): JsonResponse
+    {
+        $validated = $request->validate(['ids' => 'required|array', 'ids.*' => 'integer']);
+        $deleted = 0;
+        foreach ($validated['ids'] as $id) {
+            try {
+                $this->userService->forceDeleteUser($id);
+                $deleted++;
+            } catch (\Exception $e) {
+                continue;
+            }
+        }
+
+        return response()->json(['success' => true, 'message' => "{$deleted}명의 사용자가 영구 삭제되었습니다.", 'deleted' => $deleted]);
+    }
+
     /**
      * DEV 사이트 자동 로그인 토큰 생성
      * MNG → DEV 자동 로그인용 One-Time Token 발급

app/Http/Controllers/Barobill/EaccountController.php

@@ -1344,11 +1344,15 @@ public function save(Request $request): JsonResponse
                         ]);
                     $updated++;
                 } else {
-                    DB::table('barobill_bank_transactions')->insert(array_merge($data, [
+                    $inserted = DB::table('barobill_bank_transactions')->insertOrIgnore(array_merge($data, [
                         'created_at' => now(),
                         'updated_at' => now(),
                     ]));
-                    $saved++;
+                    if ($inserted) {
+                        $saved++;
+                    } else {
+                        $updated++;
+                    }
                 }
             }
 

app/Http/Controllers/ChinaTech/ChinaAiController.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Controllers\ChinaTech;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+/**
+ * 중국의 기술도약 > 중국 AI기술 컨트롤러
+ */
+class ChinaAiController extends Controller
+{
+    /**
+     * 중국 AI기술 발전과정 페이지
+     */
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('china-tech.ai.index'));
+        }
+
+        return view('china-tech.ai.index');
+    }
+}

app/Http/Controllers/ClaudeCode/HistoryController.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers\ClaudeCode;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+/**
+ * Claude Code > 발전과정 컨트롤러
+ */
+class HistoryController extends Controller
+{
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('claude-code.history.index'));
+        }
+
+        return view('claude-code.history.index');
+    }
+}

app/Http/Controllers/ESign/EsignApiController.php

@@ -75,6 +75,78 @@ public function searchPartners(Request $request): JsonResponse
         return response()->json(['success' => true, 'data' => $data]);
     }
 
+    /**
+     * 사원 검색 (근로계약서용)
+     */
+    public function searchEmployees(Request $request): JsonResponse
+    {
+        $q = trim($request->input('q', ''));
+        $tenantId = session('selected_tenant_id', 1);
+
+        $query = \App\Models\HR\Employee::where('tenant_id', $tenantId)
+            ->where('employee_status', 'active')
+            ->with(['user', 'department']);
+
+        if ($q !== '') {
+            $query->where(function ($w) use ($q) {
+                $w->whereHas('user', fn ($u) => $u->where('name', 'like', "%{$q}%")
+                    ->orWhere('phone', 'like', "%{$q}%")
+                    ->orWhere('email', 'like', "%{$q}%"))
+                    ->orWhereHas('department', fn ($d) => $d->where('name', 'like', "%{$q}%"));
+            });
+        }
+
+        $employees = $query->limit(20)->get();
+
+        $data = $employees->map(function ($emp) {
+            $rn = $emp->resident_number;
+            $birthYear = null;
+            $birthMonth = null;
+            $birthDay = null;
+
+            if ($rn && strlen($rn) >= 7) {
+                $genderDigit = substr($rn, 6, 1);
+                $prefix = in_array($genderDigit, ['3', '4', '7', '8']) ? '20' : '19';
+                $birthYear = $prefix.substr($rn, 0, 2);
+                $birthMonth = substr($rn, 2, 2);
+                $birthDay = substr($rn, 4, 2);
+            }
+
+            $salaryInfo = $emp->getSalaryInfo();
+
+            // 최신 연봉 정보 결정: 현재값 우선, 없으면 이력에서 최신 탐색
+            $annualSalary = $salaryInfo['annual_salary'] ?? null;
+            $salaryEffectiveDate = $salaryInfo['effective_date'] ?? null;
+
+            if ($annualSalary === null && ! empty($salaryInfo['history'])) {
+                $latest = collect($salaryInfo['history'])
+                    ->sortByDesc('effective_date')
+                    ->first();
+                $annualSalary = $latest['annual_salary'] ?? null;
+                $salaryEffectiveDate = $latest['effective_date'] ?? null;
+            }
+
+            return [
+                'id' => $emp->id,
+                'name' => $emp->user?->name,
+                'phone' => $emp->user?->phone,
+                'email' => $emp->user?->email,
+                'department' => $emp->department?->name,
+                'position' => $emp->position_label,
+                'job_title' => $emp->job_title_label,
+                'address' => $emp->address,
+                'hire_date' => $emp->hire_date,
+                'birth_year' => $birthYear,
+                'birth_month' => $birthMonth,
+                'birth_day' => $birthDay,
+                'annual_salary' => $annualSalary,
+                'salary_effective_date' => $salaryEffectiveDate,
+            ];
+        });
+
+        return response()->json(['success' => true, 'data' => $data]);
+    }
+
     /**
      * 고객(명함 등록 고객) 검색
      */
@@ -572,6 +644,110 @@ public function store(Request $request): JsonResponse
         ]);
     }
 
+    /**
+     * 계약 수정 (draft 상태만)
+     */
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $tenantId = session('selected_tenant_id', 1);
+        $contract = EsignContract::forTenant($tenantId)->findOrFail($id);
+
+        if ($contract->status !== 'draft') {
+            return response()->json(['success' => false, 'message' => '초안 상태의 계약만 수정할 수 있습니다.'], 422);
+        }
+
+        $request->validate([
+            'title' => 'required|string|max:200',
+            'description' => 'nullable|string',
+            'sign_order_type' => 'required|in:counterpart_first,creator_first',
+            'expires_at' => 'nullable|date',
+            'signers' => 'required|array|size:2',
+            'signers.*.name' => 'required|string|max:100',
+            'signers.*.email' => 'required|email|max:200',
+            'signers.*.phone' => 'nullable|string|max:20',
+            'signers.*.role' => 'required|in:creator,counterpart',
+            'file' => 'nullable|file|mimes:pdf,doc,docx|max:20480',
+            'fields' => 'nullable|array',
+            'fields.*.id' => 'required|integer',
+            'fields.*.field_value' => 'nullable|string|max:500',
+        ]);
+
+        $userId = auth()->id();
+
+        // PDF 파일 교체
+        if ($request->hasFile('file')) {
+            // 기존 파일 삭제
+            if ($contract->original_file_path && Storage::disk('local')->exists($contract->original_file_path)) {
+                Storage::disk('local')->delete($contract->original_file_path);
+            }
+
+            $file = $request->file('file');
+            $converter = new DocxToPdfConverter;
+            $result = $converter->convertAndStore($file, "esign/{$tenantId}/contracts");
+
+            $contract->original_file_path = $result['path'];
+            $contract->original_file_name = $result['name'];
+            $contract->original_file_hash = $result['hash'];
+            $contract->original_file_size = $result['size'];
+        }
+
+        $contract->title = $request->input('title');
+        $contract->description = $request->input('description');
+        $contract->sign_order_type = $request->input('sign_order_type');
+        $contract->expires_at = $request->input('expires_at')
+            ? \Carbon\Carbon::parse($request->input('expires_at'))
+            : $contract->expires_at;
+        $contract->updated_by = $userId;
+        $contract->save();
+
+        // 서명자 정보 업데이트
+        $signers = $request->input('signers');
+        foreach ($signers as $signerData) {
+            $existingSigner = EsignSigner::withoutGlobalScopes()
+                ->where('contract_id', $contract->id)
+                ->where('role', $signerData['role'])
+                ->first();
+
+            if ($existingSigner) {
+                $existingSigner->update([
+                    'name' => $signerData['name'],
+                    'email' => $signerData['email'],
+                    'phone' => $signerData['phone'] ?? null,
+                    'sign_order' => $signerData['role'] === 'creator'
+                        ? ($request->input('sign_order_type') === 'creator_first' ? 1 : 2)
+                        : ($request->input('sign_order_type') === 'counterpart_first' ? 1 : 2),
+                ]);
+            }
+        }
+
+        // 필드 값 업데이트
+        if ($request->has('fields')) {
+            foreach ($request->input('fields') as $fieldData) {
+                EsignSignField::withoutGlobalScopes()
+                    ->where('id', $fieldData['id'])
+                    ->where('contract_id', $contract->id)
+                    ->update(['field_value' => $fieldData['field_value'] ?? null]);
+            }
+        }
+
+        // 감사 로그
+        EsignAuditLog::create([
+            'tenant_id' => $tenantId,
+            'contract_id' => $contract->id,
+            'action' => 'contract_updated',
+            'ip_address' => $request->ip(),
+            'user_agent' => $request->userAgent(),
+            'metadata' => ['updated_by' => $userId],
+            'created_at' => now(),
+        ]);
+
+        return response()->json([
+            'success' => true,
+            'message' => '계약이 수정되었습니다.',
+            'data' => $contract->load(['signers', 'signFields']),
+        ]);
+    }
+
     /**
      * 계약 취소
      */

app/Http/Controllers/ESign/EsignController.php

@@ -27,6 +27,15 @@ public function create(Request $request): View|Response
         return view('esign.create');
     }
 
+    public function edit(Request $request, int $id): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('esign.edit', $id));
+        }
+
+        return view('esign.create', ['contractId' => $id]);
+    }
+
     public function detail(Request $request, int $id): View|Response
     {
         if ($request->header('HX-Request')) {

app/Http/Controllers/Finance/DailyFundController.php

@@ -7,6 +7,7 @@
 use App\Models\Barobill\BankTransactionOverride;
 use App\Models\Finance\DailyFundMemo;
 use App\Models\Finance\DailyFundTransaction;
+use App\Services\Barobill\BarobillBankSyncService;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 
@@ -173,6 +174,13 @@ public function periodReport(Request $request): JsonResponse
         $startDateYmd = str_replace('-', '', $startDate);
         $endDateYmd = str_replace('-', '', $endDate);
 
+        // 바로빌 데이터 자동 동기화 (캐시가 오래되었으면 API에서 갱신)
+        try {
+            app(BarobillBankSyncService::class)->syncIfNeeded($tenantId, $startDateYmd, $endDateYmd);
+        } catch (\Throwable $e) {
+            \Illuminate\Support\Facades\Log::warning('[DailyFund] 바로빌 동기화 실패 (DB 캐시로 계속): '.$e->getMessage());
+        }
+
         // 기간 내 거래내역 조회 (중복 제거: balance 포함 고유키로 동일 거래만 제거)
         $transactions = BarobillBankTransaction::where('tenant_id', $tenantId)
             ->whereBetween('trans_date', [$startDateYmd, $endDateYmd])

app/Http/Controllers/Finance/JournalEntryController.php

@@ -5,6 +5,7 @@
 use App\Http\Controllers\Controller;
 use App\Models\Barobill\AccountCode;
 use App\Models\Barobill\BankTransaction;
+use App\Models\Barobill\BankTransactionOverride;
 use App\Models\Barobill\CardTransaction;
 use App\Models\Barobill\CardTransactionHide;
 use App\Models\Finance\JournalEntry;
@@ -149,8 +150,8 @@ public function store(Request $request): JsonResponse
             'lines.*.account_name' => 'required|string|max:100',
             'lines.*.trading_partner_id' => 'nullable|integer',
             'lines.*.trading_partner_name' => 'nullable|string|max:100',
-            'lines.*.debit_amount' => 'required|integer|min:0',
-            'lines.*.credit_amount' => 'required|integer|min:0',
+            'lines.*.debit_amount' => 'required|integer',
+            'lines.*.credit_amount' => 'required|integer',
             'lines.*.description' => 'nullable|string|max:300',
         ]);
 
@@ -239,9 +240,15 @@ public function update(Request $request, int $id): JsonResponse
         $tenantId = session('selected_tenant_id', 1);
         $entry = JournalEntry::forTenant($tenantId)->findOrFail($id);
 
-        // 출처 연결 전표 수정 제한 (카드/홈택스는 원본에서 수정, 계좌는 허용)
-        if ($entry->source_type && ! in_array($entry->source_type, ['manual', 'bank_transaction'])) {
-            $sourceLabel = $entry->source_type === 'ecard_transaction' ? '카드사용내역' : '홈택스 매출/매입';
+        // 출처 연결 전표 수정 제한 (카드/홈택스는 원본에서 수정, 계좌/급여는 허용)
+        $editableTypes = ['manual', 'bank_transaction', 'payroll'];
+        if ($entry->source_type && ! in_array($entry->source_type, $editableTypes)) {
+            $sourceLabels = [
+                'ecard_transaction' => '카드사용내역',
+                'hometax_sales' => '홈택스 매출',
+                'hometax_purchase' => '홈택스 매입',
+            ];
+            $sourceLabel = $sourceLabels[$entry->source_type] ?? '홈택스 매출/매입';
 
             return response()->json([
                 'success' => false,
@@ -259,8 +266,8 @@ public function update(Request $request, int $id): JsonResponse
             'lines.*.account_name' => 'required|string|max:100',
             'lines.*.trading_partner_id' => 'nullable|integer',
             'lines.*.trading_partner_name' => 'nullable|string|max:100',
-            'lines.*.debit_amount' => 'required|integer|min:0',
-            'lines.*.credit_amount' => 'required|integer|min:0',
+            'lines.*.debit_amount' => 'required|integer',
+            'lines.*.credit_amount' => 'required|integer',
             'lines.*.description' => 'nullable|string|max:300',
         ]);
 
@@ -303,6 +310,20 @@ public function update(Request $request, int $id): JsonResponse
                     'description' => $line['description'] ?? null,
                 ]);
             }
+
+            // 은행거래 출처 전표의 적요 수정 시 자금일보에도 반영
+            if ($entry->source_type === 'bank_transaction' && $entry->source_key && $request->description) {
+                $existing = BankTransactionOverride::forTenant($tenantId)
+                    ->byUniqueKey($entry->source_key)
+                    ->first();
+
+                BankTransactionOverride::saveOverride(
+                    $tenantId,
+                    $entry->source_key,
+                    $request->description,
+                    $existing->modified_cast ?? null
+                );
+            }
         });
 
         return response()->json([
@@ -377,7 +398,7 @@ public function tradingPartners(Request $request): JsonResponse
             });
         }
 
-        $partners = $query->orderBy('name')->limit(50)->get();
+        $partners = $query->orderBy('name')->get();
 
         return response()->json([
             'success' => true,
@@ -564,8 +585,8 @@ public function storeFromBank(Request $request): JsonResponse
             'lines.*.account_name' => 'required|string|max:100',
             'lines.*.trading_partner_id' => 'nullable|integer',
             'lines.*.trading_partner_name' => 'nullable|string|max:100',
-            'lines.*.debit_amount' => 'required|integer|min:0',
-            'lines.*.credit_amount' => 'required|integer|min:0',
+            'lines.*.debit_amount' => 'required|integer',
+            'lines.*.credit_amount' => 'required|integer',
             'lines.*.description' => 'nullable|string|max:300',
         ]);
 
@@ -1032,8 +1053,8 @@ public function storeFromCard(Request $request): JsonResponse
             'lines.*.account_name' => 'required|string|max:100',
             'lines.*.trading_partner_id' => 'nullable|integer',
             'lines.*.trading_partner_name' => 'nullable|string|max:100',
-            'lines.*.debit_amount' => 'required|integer|min:0',
-            'lines.*.credit_amount' => 'required|integer|min:0',
+            'lines.*.debit_amount' => 'required|integer',
+            'lines.*.credit_amount' => 'required|integer',
             'lines.*.description' => 'nullable|string|max:300',
         ]);
 

app/Http/Controllers/Finance/TradingPartnerController.php

@@ -83,6 +83,7 @@ public function store(Request $request): JsonResponse
     {
         $request->validate([
             'name' => 'required|string|max:100',
+            'bizNo' => 'required|string|max:20',
             'type' => 'nullable|string|max:100',
             'category' => 'nullable|string|max:100',
         ]);
@@ -92,9 +93,9 @@ public function store(Request $request): JsonResponse
         $partner = TradingPartner::create([
             'tenant_id' => $tenantId,
             'name' => $request->input('name'),
-            'trade_type' => $request->input('tradeType', 'sales'),
-            'type' => $request->input('type'),
-            'category' => $request->input('category'),
+            'trade_type' => $request->input('tradeType') ?? 'sales',
+            'type' => $request->input('type') ?? 'vendor',
+            'category' => $request->input('category') ?? '기타',
             'biz_no' => $request->input('bizNo'),
             'ceo' => $request->input('ceo'),
             'bank_account' => $request->input('bankAccount'),
@@ -103,7 +104,7 @@ public function store(Request $request): JsonResponse
             'address' => $request->input('address'),
             'manager' => $request->input('manager'),
             'manager_phone' => $request->input('managerPhone'),
-            'status' => $request->input('status', 'active'),
+            'status' => $request->input('status') ?? 'active',
             'memo' => $request->input('memo'),
         ]);
 
@@ -144,8 +145,8 @@ public function update(Request $request, int $id): JsonResponse
         $partner->update([
             'name' => $request->input('name'),
             'trade_type' => $request->input('tradeType', $partner->trade_type),
-            'type' => $request->input('type'),
-            'category' => $request->input('category'),
+            'type' => $request->input('type') ?? $partner->type,
+            'category' => $request->input('category') ?? $partner->category,
             'biz_no' => $request->input('bizNo'),
             'ceo' => $request->input('ceo'),
             'bank_account' => $request->input('bankAccount'),

app/Http/Controllers/HR/BusinessIncomePaymentController.php

@@ -10,7 +10,7 @@
 
 class BusinessIncomePaymentController extends Controller
 {
-    private const ALLOWED_PAYROLL_USERS = ['이경호', '전진선', '김보곤'];
+    private const ALLOWED_PAYROLL_USERS = ['이의찬', '전진선', '김보곤'];
 
     public function __construct(
         private BusinessIncomePaymentService $service
@@ -25,7 +25,10 @@ public function index(Request $request): View|Response
             return response('', 200)->header('HX-Redirect', route('hr.business-income-payments.index'));
         }
 
-        if (! in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS)) {
+        $isAllowedUser = in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS);
+        $isDevSuperAdmin = ! app()->environment('production') && auth()->user()->isSuperAdmin();
+
+        if (! $isAllowedUser && ! $isDevSuperAdmin) {
             return view('hr.payrolls.restricted');
         }
 

app/Http/Controllers/HR/EmployeeController.php

@@ -9,10 +9,20 @@
 
 class EmployeeController extends Controller
 {
+    private const ALLOWED_SALARY_USERS = ['이의찬', '전진선', '김보곤'];
+
     public function __construct(
         private EmployeeService $employeeService
     ) {}
 
+    private function canViewSalary(): bool
+    {
+        $isAllowedUser = in_array(auth()->user()->name, self::ALLOWED_SALARY_USERS);
+        $isDevSuperAdmin = ! app()->environment('production') && auth()->user()->isSuperAdmin();
+
+        return $isAllowedUser || $isDevSuperAdmin;
+    }
+
     /**
      * 사원 목록 페이지
      */
@@ -62,9 +72,13 @@ public function show(int $id): View
             ->orderBy('created_at', 'desc')
             ->get();
 
+        $canViewSalary = $this->canViewSalary();
+
         return view('hr.employees.show', [
             'employee' => $employee,
             'files' => $files,
+            'canViewSalary' => $canViewSalary,
+            'salaryInfo' => $canViewSalary ? $employee->getSalaryInfo() : null,
         ]);
     }
 
@@ -89,6 +103,8 @@ public function edit(int $id): View
             ->orderBy('created_at', 'desc')
             ->get();
 
+        $canViewSalary = $this->canViewSalary();
+
         return view('hr.employees.edit', [
             'employee' => $employee,
             'departments' => $departments,
@@ -96,6 +112,8 @@ public function edit(int $id): View
             'titles' => $titles,
             'banks' => config('banks', []),
             'files' => $files,
+            'canViewSalary' => $canViewSalary,
+            'salaryInfo' => $canViewSalary ? $employee->getSalaryInfo() : null,
         ]);
     }
 }

app/Http/Controllers/HR/PayrollController.php

@@ -11,7 +11,7 @@
 
 class PayrollController extends Controller
 {
-    private const ALLOWED_PAYROLL_USERS = ['이경호', '전진선', '김보곤'];
+    private const ALLOWED_PAYROLL_USERS = ['이의찬', '전진선', '김보곤'];
 
     public function __construct(
         private PayrollService $payrollService
@@ -26,7 +26,10 @@ public function index(Request $request): View|Response
             return response('', 200)->header('HX-Redirect', route('hr.payrolls.index'));
         }
 
-        if (! in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS)) {
+        $isAllowedUser = in_array(auth()->user()->name, self::ALLOWED_PAYROLL_USERS);
+        $isDevSuperAdmin = ! app()->environment('production') && auth()->user()->isSuperAdmin();
+
+        if (! $isAllowedUser && ! $isDevSuperAdmin) {
             return view('hr.payrolls.restricted');
         }
 

app/Http/Controllers/Help/AccountingGuideController.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers\Help;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+/**
+ * 도움말 > 회계동작원리 컨트롤러
+ */
+class AccountingGuideController extends Controller
+{
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('help.accounting.index'));
+        }
+
+        return view('help.accounting.index');
+    }
+}

app/Http/Controllers/Help/AttendanceGuideController.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers\Help;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+/**
+ * 도움말 > 연차휴가/근태관리 컨트롤러
+ */
+class AttendanceGuideController extends Controller
+{
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('help.attendance.index'));
+        }
+
+        return view('help.attendance.index');
+    }
+}

app/Http/Controllers/Help/BarobillGuideController.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers\Help;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+/**
+ * 도움말 > 바로빌 연동 가이드 컨트롤러
+ */
+class BarobillGuideController extends Controller
+{
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('help.barobill.index'));
+        }
+
+        return view('help.barobill.index');
+    }
+}

app/Http/Controllers/Juil/PlanningController.php

@@ -3,6 +3,9 @@
 namespace App\Http\Controllers\Juil;
 
 use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisWorker;
+use App\Services\WeatherService;
+use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
 use Illuminate\View\View;
@@ -35,4 +38,212 @@ public function workflow(Request $request): View|Response
 
         return view('juil.workflow');
     }
+
+    public function constructionPmis(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis'));
+        }
+
+        return view('juil.construction-pmis');
+    }
+
+    public function bimViewer(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.bim-viewer'));
+        }
+
+        return view('juil.bim-viewer');
+    }
+
+    // ── 시공관리 ──
+
+    public function pmisWorkforce(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.workforce'));
+        }
+
+        return view('juil.pmis-workforce');
+    }
+
+    public function pmisEquipment(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.equipment'));
+        }
+
+        return view('juil.pmis-equipment');
+    }
+
+    public function pmisMaterials(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.materials'));
+        }
+
+        return view('juil.pmis-materials');
+    }
+
+    public function pmisWorkVolume(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.work-volume'));
+        }
+
+        return view('juil.pmis-work-volume');
+    }
+
+    public function pmisDailyAttendance(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.daily-attendance'));
+        }
+
+        return view('juil.pmis-daily-attendance');
+    }
+
+    public function pmisDailyReport(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.daily-report'));
+        }
+
+        return view('juil.pmis-daily-report');
+    }
+
+    public function pmisCorrectiveAction(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.corrective-action'));
+        }
+
+        return view('juil.pmis-corrective-action');
+    }
+
+    // ── 안전관리 ──
+
+    public function pmisSafetyEducation(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.safety-education'));
+        }
+
+        return view('juil.pmis-safety-education');
+    }
+
+    public function pmisTbm(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.tbm'));
+        }
+
+        return view('juil.pmis-tbm');
+    }
+
+    public function pmisRiskAssessment(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.risk-assessment'));
+        }
+
+        return view('juil.pmis-risk-assessment');
+    }
+
+    public function pmisDisasterPrevention(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.disaster-prevention'));
+        }
+
+        return view('juil.pmis-disaster-prevention');
+    }
+
+    public function pmisArchiveFiles(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.archive-files'));
+        }
+
+        return view('juil.pmis-archive-files');
+    }
+
+    public function pmisArchiveManual(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.archive-manual'));
+        }
+
+        return view('juil.pmis-archive-manual');
+    }
+
+    public function pmisArchiveNotice(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('juil.construction-pmis.archive-notice'));
+        }
+
+        return view('juil.pmis-archive-notice');
+    }
+
+    public function pmisWeather(WeatherService $weatherService): JsonResponse
+    {
+        $forecasts = $weatherService->getWeeklyForecast();
+
+        return response()->json(['forecasts' => array_slice($forecasts, 0, 2)]);
+    }
+
+    public function pmisProfile(): JsonResponse
+    {
+        $user = auth()->user();
+        $tenantId = session('current_tenant_id', 1);
+        $worker = PmisWorker::findOrCreateFromUser($user, $tenantId);
+
+        return response()->json([
+            'worker' => [
+                'id' => $worker->id,
+                'name' => $worker->name,
+                'login_id' => $worker->login_id,
+                'phone' => $worker->phone,
+                'email' => $worker->email,
+                'department' => $worker->department ?? '-',
+                'position' => $worker->position ?? '-',
+                'role_type' => $worker->role_type ?? '-',
+                'gender' => $worker->gender ?? '',
+                'company' => $worker->company ?? '-',
+                'profile_photo_path' => $worker->profile_photo_path,
+                'created_at' => $worker->created_at?->format('Y-m-d'),
+                'last_login_at' => $worker->last_login_at?->format('Y-m-d H:i')
+                    ?? $user->last_login_at?->format('Y-m-d H:i'),
+                'is_admin' => $user->isAdmin(),
+                'is_super_admin' => $user->isSuperAdmin(),
+            ],
+        ]);
+    }
+
+    public function pmisProfileUpdate(Request $request): JsonResponse
+    {
+        $request->validate([
+            'phone' => ['nullable', 'string', 'max:20'],
+            'email' => ['nullable', 'email', 'max:255'],
+            'gender' => ['nullable', 'string', 'in:남,여'],
+            'position' => ['nullable', 'string', 'max:50'],
+            'company' => ['nullable', 'string', 'max:100'],
+        ]);
+
+        $user = auth()->user();
+        $tenantId = session('current_tenant_id', 1);
+        $worker = PmisWorker::findOrCreateFromUser($user, $tenantId);
+
+        $worker->update([
+            'phone' => $request->input('phone'),
+            'email' => $request->input('email'),
+            'gender' => $request->input('gender'),
+            'position' => $request->input('position'),
+            'company' => $request->input('company'),
+        ]);
+
+        return response()->json(['success' => true, 'message' => '개인정보가 저장되었습니다.']);
+    }
 }

app/Http/Controllers/Juil/PmisArchiveController.php

@@ -0,0 +1,201 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisArchiveFile;
+use App\Models\Juil\PmisArchiveFolder;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+class PmisArchiveController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    /* ─── 폴더 트리 ─── */
+
+    public function folderTree(): JsonResponse
+    {
+        $folders = PmisArchiveFolder::tenant($this->tenantId())
+            ->whereNull('parent_id')
+            ->with('children.children.children')
+            ->orderBy('sort_order')
+            ->get();
+
+        return response()->json(['folders' => $folders]);
+    }
+
+    public function folderStore(Request $request): JsonResponse
+    {
+        $request->validate([
+            'name' => 'required|string|max:200',
+            'parent_id' => 'nullable|integer',
+        ]);
+
+        $folder = PmisArchiveFolder::create([
+            'tenant_id' => $this->tenantId(),
+            'parent_id' => $request->parent_id,
+            'name' => $request->name,
+            'sort_order' => PmisArchiveFolder::tenant($this->tenantId())
+                ->where('parent_id', $request->parent_id)
+                ->count(),
+        ]);
+
+        return response()->json(['folder' => $folder], 201);
+    }
+
+    public function folderUpdate(Request $request, int $id): JsonResponse
+    {
+        $folder = PmisArchiveFolder::tenant($this->tenantId())->findOrFail($id);
+
+        $request->validate(['name' => 'required|string|max:200']);
+        $folder->update(['name' => $request->name]);
+
+        return response()->json(['folder' => $folder]);
+    }
+
+    public function folderDestroy(int $id): JsonResponse
+    {
+        $folder = PmisArchiveFolder::tenant($this->tenantId())->findOrFail($id);
+        $descendantIds = $folder->allDescendantIds();
+
+        PmisArchiveFile::tenant($this->tenantId())
+            ->whereIn('folder_id', $descendantIds)
+            ->each(function ($file) {
+                Storage::disk('public')->delete($file->file_path);
+                $file->delete();
+            });
+
+        PmisArchiveFolder::tenant($this->tenantId())
+            ->whereIn('id', $descendantIds)
+            ->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    /* ─── 파일 목록 ─── */
+
+    public function fileList(Request $request): JsonResponse
+    {
+        $folderId = $request->query('folder_id');
+        $tab = $request->query('tab', '전체');
+        $search = $request->query('search', '');
+        $dateFrom = $request->query('date_from');
+        $dateTo = $request->query('date_to');
+        $includeSubfolder = $request->boolean('include_subfolder', true);
+
+        $query = PmisArchiveFile::tenant($this->tenantId());
+
+        if ($folderId) {
+            if ($includeSubfolder) {
+                $folder = PmisArchiveFolder::tenant($this->tenantId())->find($folderId);
+                if ($folder) {
+                    $folderIds = $folder->allDescendantIds();
+                    $query->whereIn('folder_id', $folderIds);
+                }
+            } else {
+                $query->where('folder_id', $folderId);
+            }
+        }
+
+        if ($tab !== '전체') {
+            $query->where('file_type', $tab);
+        }
+
+        if ($search) {
+            $query->where(function ($q) use ($search) {
+                $q->where('title', 'like', "%{$search}%")
+                    ->orWhere('original_name', 'like', "%{$search}%")
+                    ->orWhereHas('folder', fn ($fq) => $fq->where('name', 'like', "%{$search}%"));
+            });
+        }
+
+        if ($dateFrom) {
+            $query->whereDate('created_at', '>=', $dateFrom);
+        }
+        if ($dateTo) {
+            $query->whereDate('created_at', '<=', $dateTo);
+        }
+
+        $files = $query->orderByDesc('created_at')->get();
+
+        $result = $files->map(fn ($f) => [
+            'id' => $f->id,
+            'title' => $f->title ?: $f->original_name,
+            'fileName' => $f->original_name,
+            'filePath' => Storage::disk('public')->url($f->file_path),
+            'fileType' => $f->file_type,
+            'siteName' => $f->site_name,
+            'size' => PmisArchiveFile::formatSize($f->file_size),
+            'sizeRaw' => $f->file_size,
+            'registrant' => $f->registeredByUser?->name ?? '-',
+            'registeredAt' => $f->created_at->format('Y-m-d'),
+            'folderId' => $f->folder_id,
+        ]);
+
+        return response()->json(['files' => $result]);
+    }
+
+    /* ─── 파일 업로드 ─── */
+
+    public function fileStore(Request $request): JsonResponse
+    {
+        $request->validate([
+            'folder_id' => 'required|integer|exists:pmis_archive_folders,id',
+            'files' => 'required|array|min:1',
+            'files.*' => 'file|max:51200',
+            'title' => 'nullable|string|max:300',
+            'site_name' => 'nullable|string|max:200',
+        ]);
+
+        $user = auth()->user();
+        $uploaded = [];
+
+        foreach ($request->file('files') as $file) {
+            $ext = $file->getClientOriginalExtension();
+            $path = $file->store('pmis/archive', 'public');
+
+            $record = PmisArchiveFile::create([
+                'tenant_id' => $this->tenantId(),
+                'folder_id' => $request->folder_id,
+                'title' => $request->title ?: '',
+                'original_name' => $file->getClientOriginalName(),
+                'file_path' => $path,
+                'file_type' => PmisArchiveFile::detectFileType($ext),
+                'file_size' => $file->getSize(),
+                'site_name' => $request->site_name ?: '',
+                'registered_by' => $user?->id,
+            ]);
+
+            $uploaded[] = $record;
+        }
+
+        return response()->json(['files' => $uploaded, 'message' => count($uploaded).'개 파일이 업로드되었습니다.'], 201);
+    }
+
+    /* ─── 파일 삭제 ─── */
+
+    public function fileDestroy(int $id): JsonResponse
+    {
+        $file = PmisArchiveFile::tenant($this->tenantId())->findOrFail($id);
+
+        Storage::disk('public')->delete($file->file_path);
+        $file->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    /* ─── 파일 다운로드 ─── */
+
+    public function fileDownload(int $id)
+    {
+        $file = PmisArchiveFile::tenant($this->tenantId())->findOrFail($id);
+        $fullPath = Storage::disk('public')->path($file->file_path);
+
+        return response()->download($fullPath, $file->original_name);
+    }
+}

app/Http/Controllers/Juil/PmisDailyAttendanceController.php

@@ -0,0 +1,212 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisAttendanceEquipment;
+use App\Models\Juil\PmisAttendanceWorker;
+use App\Models\Juil\PmisDailyAttendance;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PmisDailyAttendanceController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    /**
+     * 해당 날짜의 출면일보 조회 (없으면 생성)
+     */
+    public function show(Request $request): JsonResponse
+    {
+        $date = $request->input('date', now()->toDateString());
+        $company = $request->input('company', '');
+
+        $attendance = PmisDailyAttendance::tenant($this->tenantId())
+            ->where('date', $date)
+            ->when($company, fn ($q) => $q->where('company_name', $company))
+            ->first();
+
+        if (! $attendance) {
+            $attendance = PmisDailyAttendance::create([
+                'tenant_id' => $this->tenantId(),
+                'date' => $date,
+                'company_name' => $company,
+                'weather' => '맑음',
+                'status' => 'draft',
+            ]);
+        }
+
+        $attendance->load(['workers', 'equipments']);
+
+        return response()->json($attendance);
+    }
+
+    /**
+     * 해당 월의 일별 상태 조회 (캘린더 닷 표시용)
+     */
+    public function monthStatus(Request $request): JsonResponse
+    {
+        $year = $request->integer('year', now()->year);
+        $month = $request->integer('month', now()->month);
+        $company = $request->input('company', '');
+
+        $attendances = PmisDailyAttendance::tenant($this->tenantId())
+            ->whereYear('date', $year)
+            ->whereMonth('date', $month)
+            ->when($company, fn ($q) => $q->where('company_name', $company))
+            ->withCount(['workers', 'equipments'])
+            ->get();
+
+        $result = [];
+        foreach ($attendances as $att) {
+            $day = (int) $att->date->format('d');
+            if ($att->workers_count > 0 || $att->equipments_count > 0) {
+                $result[$day] = $att->status;
+            }
+        }
+
+        return response()->json($result);
+    }
+
+    /**
+     * 출면일보 메타 업데이트 (날씨, 특이사항, 상태)
+     */
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $attendance = PmisDailyAttendance::tenant($this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'weather' => 'sometimes|string|max:50',
+            'notes' => 'sometimes|nullable|string',
+            'status' => 'sometimes|in:draft,review,approved',
+            'options' => 'sometimes|nullable|array',
+        ]);
+
+        $attendance->update($validated);
+
+        return response()->json($attendance);
+    }
+
+    /**
+     * 검토자 저장
+     */
+    public function saveReviewers(Request $request, int $id): JsonResponse
+    {
+        $attendance = PmisDailyAttendance::tenant($this->tenantId())->findOrFail($id);
+
+        $reviewers = $request->input('reviewers', []);
+        $options = $attendance->options ?? [];
+        $options['reviewers'] = $reviewers;
+        $attendance->update(['options' => $options]);
+
+        return response()->json(['message' => '검토자가 저장되었습니다.']);
+    }
+
+    // ─── 인원(Worker) CRUD ───
+
+    public function workerStore(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'attendance_id' => 'required|integer|exists:pmis_daily_attendances,id',
+            'work_type' => 'required|string|max:200',
+            'job_type' => 'required|string|max:200',
+            'name' => 'required|string|max:100',
+            'man_days' => 'nullable|numeric|min:0',
+            'amount' => 'nullable|numeric|min:0',
+            'work_content' => 'nullable|string|max:500',
+        ]);
+
+        $validated['tenant_id'] = $this->tenantId();
+        $validated['man_days'] = $validated['man_days'] ?? 1.0;
+        $validated['amount'] = $validated['amount'] ?? 0;
+        $validated['work_content'] = $validated['work_content'] ?? '';
+
+        $maxSort = PmisAttendanceWorker::where('attendance_id', $validated['attendance_id'])->max('sort_order') ?? 0;
+        $validated['sort_order'] = $maxSort + 1;
+
+        $worker = PmisAttendanceWorker::create($validated);
+
+        return response()->json($worker, 201);
+    }
+
+    public function workerUpdate(Request $request, int $id): JsonResponse
+    {
+        $worker = PmisAttendanceWorker::where('tenant_id', $this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'work_type' => 'sometimes|string|max:200',
+            'job_type' => 'sometimes|string|max:200',
+            'name' => 'sometimes|string|max:100',
+            'man_days' => 'nullable|numeric|min:0',
+            'amount' => 'nullable|numeric|min:0',
+            'work_content' => 'nullable|string|max:500',
+        ]);
+
+        $worker->update($validated);
+
+        return response()->json($worker);
+    }
+
+    public function workerDestroy(int $id): JsonResponse
+    {
+        $worker = PmisAttendanceWorker::where('tenant_id', $this->tenantId())->findOrFail($id);
+        $worker->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    // ─── 장비(Equipment) CRUD ───
+
+    public function equipmentStore(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'attendance_id' => 'required|integer|exists:pmis_daily_attendances,id',
+            'equipment_name' => 'required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'equipment_number' => 'nullable|string|max:100',
+            'operator' => 'nullable|string|max:100',
+            'man_days' => 'nullable|numeric|min:0',
+            'work_content' => 'nullable|string|max:500',
+        ]);
+
+        $validated['tenant_id'] = $this->tenantId();
+        $validated['man_days'] = $validated['man_days'] ?? 1.0;
+        $validated['work_content'] = $validated['work_content'] ?? '';
+
+        $maxSort = PmisAttendanceEquipment::where('attendance_id', $validated['attendance_id'])->max('sort_order') ?? 0;
+        $validated['sort_order'] = $maxSort + 1;
+
+        $equipment = PmisAttendanceEquipment::create($validated);
+
+        return response()->json($equipment, 201);
+    }
+
+    public function equipmentUpdate(Request $request, int $id): JsonResponse
+    {
+        $equipment = PmisAttendanceEquipment::where('tenant_id', $this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'equipment_name' => 'sometimes|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'equipment_number' => 'nullable|string|max:100',
+            'operator' => 'nullable|string|max:100',
+            'man_days' => 'nullable|numeric|min:0',
+            'work_content' => 'nullable|string|max:500',
+        ]);
+
+        $equipment->update($validated);
+
+        return response()->json($equipment);
+    }
+
+    public function equipmentDestroy(int $id): JsonResponse
+    {
+        $equipment = PmisAttendanceEquipment::where('tenant_id', $this->tenantId())->findOrFail($id);
+        $equipment->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisDailyWorkReportController.php

@@ -0,0 +1,322 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisDailyWorkReport;
+use App\Models\Juil\PmisWorkReportEquipment;
+use App\Models\Juil\PmisWorkReportMaterial;
+use App\Models\Juil\PmisWorkReportPhoto;
+use App\Models\Juil\PmisWorkReportVolume;
+use App\Models\Juil\PmisWorkReportWorker;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PmisDailyWorkReportController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    public function show(Request $request): JsonResponse
+    {
+        $date = $request->input('date', now()->toDateString());
+        $company = $request->input('company') ?? '';
+
+        $report = PmisDailyWorkReport::tenant($this->tenantId())
+            ->where('date', $date)
+            ->when($company, fn ($q) => $q->where('company_name', $company))
+            ->first();
+
+        if (! $report) {
+            $report = PmisDailyWorkReport::create([
+                'tenant_id' => $this->tenantId(),
+                'date' => $date,
+                'company_name' => $company,
+                'weather' => '맑음',
+                'status' => 'draft',
+            ]);
+        }
+
+        $report->load(['workers', 'equipments', 'materials', 'volumes', 'photos']);
+
+        return response()->json($report);
+    }
+
+    public function monthStatus(Request $request): JsonResponse
+    {
+        $year = $request->integer('year', now()->year);
+        $month = $request->integer('month', now()->month);
+        $company = $request->input('company') ?? '';
+
+        $reports = PmisDailyWorkReport::tenant($this->tenantId())
+            ->whereYear('date', $year)
+            ->whereMonth('date', $month)
+            ->when($company, fn ($q) => $q->where('company_name', $company))
+            ->withCount(['workers', 'equipments', 'materials', 'volumes', 'photos'])
+            ->get();
+
+        $result = [];
+        foreach ($reports as $r) {
+            $day = (int) $r->date->format('d');
+            $hasData = $r->workers_count > 0 || $r->equipments_count > 0
+                || $r->materials_count > 0 || $r->volumes_count > 0
+                || $r->photos_count > 0
+                || $r->work_content_today;
+            if ($hasData) {
+                $result[$day] = $r->status;
+            }
+        }
+
+        return response()->json($result);
+    }
+
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $report = PmisDailyWorkReport::tenant($this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'weather' => 'sometimes|string|max:50',
+            'temp_low' => 'sometimes|nullable|numeric',
+            'temp_high' => 'sometimes|nullable|numeric',
+            'precipitation' => 'sometimes|nullable|numeric',
+            'snowfall' => 'sometimes|nullable|numeric',
+            'fine_dust' => 'sometimes|nullable|string|max:50',
+            'ultra_fine_dust' => 'sometimes|nullable|string|max:50',
+            'work_content_today' => 'sometimes|nullable|string',
+            'work_content_tomorrow' => 'sometimes|nullable|string',
+            'notes' => 'sometimes|nullable|string',
+            'status' => 'sometimes|in:draft,review,approved',
+            'options' => 'sometimes|nullable|array',
+        ]);
+
+        // NOT NULL string 컬럼의 null → 빈 문자열 변환
+        foreach (['fine_dust', 'ultra_fine_dust', 'weather'] as $col) {
+            if (array_key_exists($col, $validated) && $validated[$col] === null) {
+                $validated[$col] = '';
+            }
+        }
+
+        $report->update($validated);
+        $report->load(['workers', 'equipments', 'materials', 'volumes', 'photos']);
+
+        return response()->json($report);
+    }
+
+    public function destroy(int $id): JsonResponse
+    {
+        $report = PmisDailyWorkReport::tenant($this->tenantId())->findOrFail($id);
+        $report->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    public function saveReviewers(Request $request, int $id): JsonResponse
+    {
+        $report = PmisDailyWorkReport::tenant($this->tenantId())->findOrFail($id);
+        $reviewers = $request->input('reviewers', []);
+        $options = $report->options ?? [];
+        $options['reviewers'] = $reviewers;
+        $report->update(['options' => $options]);
+
+        return response()->json(['message' => '검토자가 저장되었습니다.']);
+    }
+
+    // ─── Worker CRUD ───
+
+    public function workerStore(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'report_id' => 'required|integer|exists:pmis_daily_work_reports,id',
+            'work_type' => 'required|string|max:200',
+            'job_type' => 'required|string|max:200',
+            'prev_cumulative' => 'nullable|integer|min:0',
+            'today_count' => 'nullable|integer|min:0',
+        ]);
+        $v['tenant_id'] = $this->tenantId();
+        $v['prev_cumulative'] = $v['prev_cumulative'] ?? 0;
+        $v['today_count'] = $v['today_count'] ?? 0;
+        $v['sort_order'] = (PmisWorkReportWorker::where('report_id', $v['report_id'])->max('sort_order') ?? 0) + 1;
+
+        return response()->json(PmisWorkReportWorker::create($v), 201);
+    }
+
+    public function workerUpdate(Request $request, int $id): JsonResponse
+    {
+        $w = PmisWorkReportWorker::where('tenant_id', $this->tenantId())->findOrFail($id);
+        $w->update($request->validate([
+            'work_type' => 'sometimes|string|max:200',
+            'job_type' => 'sometimes|string|max:200',
+            'prev_cumulative' => 'nullable|integer|min:0',
+            'today_count' => 'nullable|integer|min:0',
+        ]));
+
+        return response()->json($w);
+    }
+
+    public function workerDestroy(int $id): JsonResponse
+    {
+        PmisWorkReportWorker::where('tenant_id', $this->tenantId())->findOrFail($id)->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    // ─── Equipment CRUD ───
+
+    public function equipmentStore(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'report_id' => 'required|integer|exists:pmis_daily_work_reports,id',
+            'equipment_name' => 'required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'prev_cumulative' => 'nullable|integer|min:0',
+            'today_count' => 'nullable|integer|min:0',
+        ]);
+        $v['tenant_id'] = $this->tenantId();
+        $v['specification'] = $v['specification'] ?? '';
+        $v['prev_cumulative'] = $v['prev_cumulative'] ?? 0;
+        $v['today_count'] = $v['today_count'] ?? 0;
+        $v['sort_order'] = (PmisWorkReportEquipment::where('report_id', $v['report_id'])->max('sort_order') ?? 0) + 1;
+
+        return response()->json(PmisWorkReportEquipment::create($v), 201);
+    }
+
+    public function equipmentUpdate(Request $request, int $id): JsonResponse
+    {
+        $e = PmisWorkReportEquipment::where('tenant_id', $this->tenantId())->findOrFail($id);
+        $e->update($request->validate([
+            'equipment_name' => 'sometimes|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'prev_cumulative' => 'nullable|integer|min:0',
+            'today_count' => 'nullable|integer|min:0',
+        ]));
+
+        return response()->json($e);
+    }
+
+    public function equipmentDestroy(int $id): JsonResponse
+    {
+        PmisWorkReportEquipment::where('tenant_id', $this->tenantId())->findOrFail($id)->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    // ─── Material CRUD ───
+
+    public function materialStore(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'report_id' => 'required|integer|exists:pmis_daily_work_reports,id',
+            'material_name' => 'required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'unit' => 'nullable|string|max:50',
+            'design_qty' => 'nullable|numeric|min:0',
+            'prev_cumulative' => 'nullable|numeric|min:0',
+            'today_count' => 'nullable|numeric|min:0',
+        ]);
+        $v['tenant_id'] = $this->tenantId();
+        $v['sort_order'] = (PmisWorkReportMaterial::where('report_id', $v['report_id'])->max('sort_order') ?? 0) + 1;
+
+        return response()->json(PmisWorkReportMaterial::create($v), 201);
+    }
+
+    public function materialUpdate(Request $request, int $id): JsonResponse
+    {
+        $m = PmisWorkReportMaterial::where('tenant_id', $this->tenantId())->findOrFail($id);
+        $m->update($request->validate([
+            'material_name' => 'sometimes|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'unit' => 'nullable|string|max:50',
+            'design_qty' => 'nullable|numeric|min:0',
+            'prev_cumulative' => 'nullable|numeric|min:0',
+            'today_count' => 'nullable|numeric|min:0',
+        ]));
+
+        return response()->json($m);
+    }
+
+    public function materialDestroy(int $id): JsonResponse
+    {
+        PmisWorkReportMaterial::where('tenant_id', $this->tenantId())->findOrFail($id)->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    // ─── Volume CRUD ───
+
+    public function volumeStore(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'report_id' => 'required|integer|exists:pmis_daily_work_reports,id',
+            'work_type' => 'required|string|max:200',
+            'sub_work_type' => 'nullable|string|max:200',
+            'unit' => 'nullable|string|max:50',
+            'design_qty' => 'nullable|numeric|min:0',
+            'prev_cumulative' => 'nullable|numeric|min:0',
+            'today_count' => 'nullable|numeric|min:0',
+        ]);
+        $v['tenant_id'] = $this->tenantId();
+        $v['sort_order'] = (PmisWorkReportVolume::where('report_id', $v['report_id'])->max('sort_order') ?? 0) + 1;
+
+        return response()->json(PmisWorkReportVolume::create($v), 201);
+    }
+
+    public function volumeUpdate(Request $request, int $id): JsonResponse
+    {
+        $vol = PmisWorkReportVolume::where('tenant_id', $this->tenantId())->findOrFail($id);
+        $vol->update($request->validate([
+            'work_type' => 'sometimes|string|max:200',
+            'sub_work_type' => 'nullable|string|max:200',
+            'unit' => 'nullable|string|max:50',
+            'design_qty' => 'nullable|numeric|min:0',
+            'prev_cumulative' => 'nullable|numeric|min:0',
+            'today_count' => 'nullable|numeric|min:0',
+        ]));
+
+        return response()->json($vol);
+    }
+
+    public function volumeDestroy(int $id): JsonResponse
+    {
+        PmisWorkReportVolume::where('tenant_id', $this->tenantId())->findOrFail($id)->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    // ─── Photo CRUD ───
+
+    public function photoStore(Request $request): JsonResponse
+    {
+        $v = $request->validate([
+            'report_id' => 'required|integer|exists:pmis_daily_work_reports,id',
+            'location' => 'nullable|string|max:200',
+            'content' => 'nullable|string|max:500',
+            'photo' => 'nullable|image|max:10240',
+        ]);
+
+        $path = '';
+        if ($request->hasFile('photo')) {
+            $path = $request->file('photo')->store('pmis/work-report-photos', 'public');
+        }
+
+        $photo = PmisWorkReportPhoto::create([
+            'tenant_id' => $this->tenantId(),
+            'report_id' => $v['report_id'],
+            'photo_path' => $path,
+            'location' => $v['location'] ?? '',
+            'content' => $v['content'] ?? '',
+            'photo_date' => now()->toDateString(),
+            'sort_order' => (PmisWorkReportPhoto::where('report_id', $v['report_id'])->max('sort_order') ?? 0) + 1,
+        ]);
+
+        return response()->json($photo, 201);
+    }
+
+    public function photoDestroy(int $id): JsonResponse
+    {
+        PmisWorkReportPhoto::where('tenant_id', $this->tenantId())->findOrFail($id)->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisEquipmentController.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisEquipment;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PmisEquipmentController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    public function list(Request $request): JsonResponse
+    {
+        $query = PmisEquipment::tenant($this->tenantId())
+            ->orderByDesc('id');
+
+        if ($request->filled('company')) {
+            $query->where('company_name', 'like', '%' . $request->company . '%');
+        }
+        if ($request->filled('equipment_name')) {
+            $query->where('equipment_name', 'like', '%' . $request->equipment_name . '%');
+        }
+        if ($request->filled('search')) {
+            $s = $request->search;
+            $query->where(function ($q) use ($s) {
+                $q->where('equipment_name', 'like', "%{$s}%")
+                    ->orWhere('equipment_code', 'like', "%{$s}%")
+                    ->orWhere('equipment_number', 'like', "%{$s}%")
+                    ->orWhere('operator', 'like', "%{$s}%");
+            });
+        }
+
+        $perPage = $request->integer('per_page', 15);
+        $equipments = $query->paginate($perPage);
+
+        return response()->json($equipments);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'company_name' => 'required|string|max:200',
+            'equipment_code' => 'nullable|string|max:50',
+            'equipment_name' => 'required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'unit' => 'nullable|string|max:50',
+            'equipment_number' => 'required|string|max:100',
+            'operator' => 'nullable|string|max:50',
+            'inspection_end_date' => 'nullable|date',
+            'inspection_not_applicable' => 'nullable|boolean',
+            'insurance_end_date' => 'nullable|date',
+            'insurance_not_applicable' => 'nullable|boolean',
+        ]);
+
+        $validated['tenant_id'] = $this->tenantId();
+        $validated['inspection_not_applicable'] = $validated['inspection_not_applicable'] ?? false;
+        $validated['insurance_not_applicable'] = $validated['insurance_not_applicable'] ?? false;
+
+        $equipment = PmisEquipment::create($validated);
+
+        return response()->json($equipment, 201);
+    }
+
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $equipment = PmisEquipment::tenant($this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'company_name' => 'sometimes|required|string|max:200',
+            'equipment_code' => 'nullable|string|max:50',
+            'equipment_name' => 'sometimes|required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'unit' => 'nullable|string|max:50',
+            'equipment_number' => 'sometimes|required|string|max:100',
+            'operator' => 'nullable|string|max:50',
+            'inspection_end_date' => 'nullable|date',
+            'inspection_not_applicable' => 'nullable|boolean',
+            'insurance_end_date' => 'nullable|date',
+            'insurance_not_applicable' => 'nullable|boolean',
+        ]);
+
+        $equipment->update($validated);
+
+        return response()->json($equipment);
+    }
+
+    public function destroy(int $id): JsonResponse
+    {
+        $equipment = PmisEquipment::tenant($this->tenantId())->findOrFail($id);
+        $equipment->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisManualController.php

@@ -0,0 +1,187 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisManual;
+use App\Models\Juil\PmisManualAttachment;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+class PmisManualController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    public function list(Request $request): JsonResponse
+    {
+        $search = $request->query('search', '');
+
+        $query = PmisManual::tenant($this->tenantId())
+            ->with('author:id,name')
+            ->withCount('attachments')
+            ->orderByDesc('id');
+
+        if ($search) {
+            $query->where(function ($q) use ($search) {
+                $q->where('title', 'like', "%{$search}%")
+                    ->orWhere('tags', 'like', "%{$search}%");
+            });
+        }
+
+        $manuals = $query->get()->map(fn ($m) => [
+            'id' => $m->id,
+            'title' => $m->title,
+            'author' => $m->author?->name ?? '관리자',
+            'createdAt' => $m->created_at->format('Y-m-d'),
+            'views' => $m->views,
+            'hasAttachment' => $m->attachments_count > 0,
+        ]);
+
+        return response()->json(['manuals' => $manuals]);
+    }
+
+    public function show(int $id): JsonResponse
+    {
+        $manual = PmisManual::tenant($this->tenantId())
+            ->with(['author:id,name', 'attachments'])
+            ->findOrFail($id);
+
+        $manual->increment('views');
+
+        return response()->json([
+            'manual' => [
+                'id' => $manual->id,
+                'title' => $manual->title,
+                'content' => $manual->content,
+                'tags' => $manual->tags,
+                'author' => $manual->author?->name ?? '관리자',
+                'createdAt' => $manual->created_at->format('Y-m-d'),
+                'views' => $manual->views,
+                'attachments' => $manual->attachments->map(fn ($a) => [
+                    'id' => $a->id,
+                    'fileName' => $a->original_name,
+                    'size' => PmisManualAttachment::formatSize($a->file_size),
+                    'downloadUrl' => "/juil/construction-pmis/api/manuals/attachments/{$a->id}/download",
+                ]),
+            ],
+        ]);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $request->validate([
+            'title' => 'required|string|max:300',
+            'content' => 'nullable|string',
+            'tags' => 'nullable|string|max:500',
+            'files' => 'nullable|array',
+            'files.*' => 'file|max:51200',
+        ]);
+
+        $manual = PmisManual::create([
+            'tenant_id' => $this->tenantId(),
+            'title' => $request->title,
+            'content' => $request->content ?? '',
+            'tags' => $request->tags ?? '',
+            'author_id' => $user->id,
+        ]);
+
+        if ($request->hasFile('files')) {
+            foreach ($request->file('files') as $file) {
+                $path = $file->store('pmis/manuals', 'public');
+                $manual->attachments()->create([
+                    'original_name' => $file->getClientOriginalName(),
+                    'file_path' => $path,
+                    'file_size' => $file->getSize(),
+                ]);
+            }
+        }
+
+        return response()->json(['manual' => $manual->load('attachments'), 'message' => '등록되었습니다.'], 201);
+    }
+
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $manual = PmisManual::tenant($this->tenantId())->findOrFail($id);
+
+        $request->validate([
+            'title' => 'required|string|max:300',
+            'content' => 'nullable|string',
+            'tags' => 'nullable|string|max:500',
+            'files' => 'nullable|array',
+            'files.*' => 'file|max:51200',
+        ]);
+
+        $manual->update([
+            'title' => $request->title,
+            'content' => $request->content ?? '',
+            'tags' => $request->tags ?? '',
+        ]);
+
+        if ($request->hasFile('files')) {
+            foreach ($request->file('files') as $file) {
+                $path = $file->store('pmis/manuals', 'public');
+                $manual->attachments()->create([
+                    'original_name' => $file->getClientOriginalName(),
+                    'file_path' => $path,
+                    'file_size' => $file->getSize(),
+                ]);
+            }
+        }
+
+        return response()->json(['manual' => $manual->load('attachments'), 'message' => '수정되었습니다.']);
+    }
+
+    public function destroy(int $id): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $manual = PmisManual::tenant($this->tenantId())->findOrFail($id);
+
+        foreach ($manual->attachments as $att) {
+            Storage::disk('public')->delete($att->file_path);
+        }
+
+        $manual->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    public function attachmentDownload(int $id)
+    {
+        $att = PmisManualAttachment::findOrFail($id);
+        $fullPath = Storage::disk('public')->path($att->file_path);
+
+        return response()->download($fullPath, $att->original_name);
+    }
+
+    public function attachmentDestroy(int $id): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $att = PmisManualAttachment::findOrFail($id);
+        Storage::disk('public')->delete($att->file_path);
+        $att->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisMaterialController.php

@@ -0,0 +1,87 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisMaterial;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PmisMaterialController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    public function list(Request $request): JsonResponse
+    {
+        $query = PmisMaterial::tenant($this->tenantId())
+            ->orderByDesc('id');
+
+        if ($request->filled('company')) {
+            $query->where('company_name', 'like', '%' . $request->company . '%');
+        }
+        if ($request->filled('material_name')) {
+            $query->where('material_name', 'like', '%' . $request->material_name . '%');
+        }
+        if ($request->filled('search')) {
+            $s = $request->search;
+            $query->where(function ($q) use ($s) {
+                $q->where('material_name', 'like', "%{$s}%")
+                    ->orWhere('material_code', 'like', "%{$s}%")
+                    ->orWhere('specification', 'like', "%{$s}%");
+            });
+        }
+
+        $perPage = $request->integer('per_page', 15);
+        $materials = $query->paginate($perPage);
+
+        return response()->json($materials);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'company_name' => 'required|string|max:200',
+            'material_code' => 'nullable|string|max:50',
+            'material_name' => 'required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'unit' => 'nullable|string|max:50',
+            'design_quantity' => 'nullable|numeric|min:0',
+        ]);
+
+        $validated['tenant_id'] = $this->tenantId();
+        $validated['design_quantity'] = $validated['design_quantity'] ?? 0;
+
+        $material = PmisMaterial::create($validated);
+
+        return response()->json($material, 201);
+    }
+
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $material = PmisMaterial::tenant($this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'company_name' => 'sometimes|required|string|max:200',
+            'material_code' => 'nullable|string|max:50',
+            'material_name' => 'sometimes|required|string|max:200',
+            'specification' => 'nullable|string|max:300',
+            'unit' => 'nullable|string|max:50',
+            'design_quantity' => 'nullable|numeric|min:0',
+        ]);
+
+        $material->update($validated);
+
+        return response()->json($material);
+    }
+
+    public function destroy(int $id): JsonResponse
+    {
+        $material = PmisMaterial::tenant($this->tenantId())->findOrFail($id);
+        $material->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisNoticeController.php

@@ -0,0 +1,185 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisNotice;
+use App\Models\Juil\PmisNoticeAttachment;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+class PmisNoticeController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    public function list(Request $request): JsonResponse
+    {
+        $search = $request->query('search', '');
+        $withTrashed = $request->boolean('with_trashed', false);
+
+        $query = PmisNotice::tenant($this->tenantId())
+            ->with('author:id,name')
+            ->withCount('attachments')
+            ->orderByDesc('id');
+
+        if ($withTrashed && auth()->user()->isAdmin()) {
+            $query->withTrashed();
+        }
+
+        if ($search) {
+            $query->where('title', 'like', "%{$search}%");
+        }
+
+        $notices = $query->get()->map(fn ($n) => [
+            'id' => $n->id,
+            'title' => $n->title,
+            'author' => $n->author?->name ?? '관리자',
+            'createdAt' => $n->created_at->format('Y-m-d H:i:s'),
+            'views' => $n->views,
+            'hasAttachment' => $n->attachments_count > 0,
+            'isDeleted' => $n->trashed(),
+        ]);
+
+        return response()->json(['notices' => $notices]);
+    }
+
+    public function show(int $id): JsonResponse
+    {
+        $notice = PmisNotice::tenant($this->tenantId())
+            ->with(['author:id,name', 'attachments'])
+            ->findOrFail($id);
+
+        $notice->increment('views');
+
+        return response()->json([
+            'notice' => [
+                'id' => $notice->id,
+                'title' => $notice->title,
+                'content' => $notice->content,
+                'author' => $notice->author?->name ?? '관리자',
+                'createdAt' => $notice->created_at->format('Y-m-d H:i:s'),
+                'views' => $notice->views,
+                'attachments' => $notice->attachments->map(fn ($a) => [
+                    'id' => $a->id,
+                    'fileName' => $a->original_name,
+                    'size' => PmisNoticeAttachment::formatSize($a->file_size),
+                    'downloadUrl' => "/juil/construction-pmis/api/notices/attachments/{$a->id}/download",
+                ]),
+            ],
+        ]);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $request->validate([
+            'title' => 'required|string|max:300',
+            'content' => 'nullable|string',
+            'files' => 'nullable|array',
+            'files.*' => 'file|max:51200',
+        ]);
+
+        $notice = PmisNotice::create([
+            'tenant_id' => $this->tenantId(),
+            'title' => $request->title,
+            'content' => $request->content ?? '',
+            'author_id' => $user->id,
+        ]);
+
+        if ($request->hasFile('files')) {
+            foreach ($request->file('files') as $file) {
+                $path = $file->store('pmis/notices', 'public');
+                $notice->attachments()->create([
+                    'original_name' => $file->getClientOriginalName(),
+                    'file_path' => $path,
+                    'file_size' => $file->getSize(),
+                ]);
+            }
+        }
+
+        return response()->json(['notice' => $notice->load('attachments'), 'message' => '등록되었습니다.'], 201);
+    }
+
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $notice = PmisNotice::tenant($this->tenantId())->findOrFail($id);
+
+        $request->validate([
+            'title' => 'required|string|max:300',
+            'content' => 'nullable|string',
+            'files' => 'nullable|array',
+            'files.*' => 'file|max:51200',
+        ]);
+
+        $notice->update([
+            'title' => $request->title,
+            'content' => $request->content ?? '',
+        ]);
+
+        if ($request->hasFile('files')) {
+            foreach ($request->file('files') as $file) {
+                $path = $file->store('pmis/notices', 'public');
+                $notice->attachments()->create([
+                    'original_name' => $file->getClientOriginalName(),
+                    'file_path' => $path,
+                    'file_size' => $file->getSize(),
+                ]);
+            }
+        }
+
+        return response()->json(['notice' => $notice->load('attachments'), 'message' => '수정되었습니다.']);
+    }
+
+    public function destroy(int $id): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $notice = PmisNotice::tenant($this->tenantId())->findOrFail($id);
+
+        foreach ($notice->attachments as $att) {
+            Storage::disk('public')->delete($att->file_path);
+        }
+
+        $notice->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    public function attachmentDownload(int $id)
+    {
+        $att = PmisNoticeAttachment::findOrFail($id);
+        $fullPath = Storage::disk('public')->path($att->file_path);
+
+        return response()->download($fullPath, $att->original_name);
+    }
+
+    public function attachmentDestroy(int $id): JsonResponse
+    {
+        $user = auth()->user();
+        if (! $user->isAdmin()) {
+            return response()->json(['message' => '권한이 없습니다.'], 403);
+        }
+
+        $att = PmisNoticeAttachment::findOrFail($id);
+        Storage::disk('public')->delete($att->file_path);
+        $att->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisWorkVolumeController.php

@@ -0,0 +1,79 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisWorkVolume;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PmisWorkVolumeController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    public function list(Request $request): JsonResponse
+    {
+        $query = PmisWorkVolume::tenant($this->tenantId())
+            ->orderByDesc('id');
+
+        if ($request->filled('search')) {
+            $s = $request->search;
+            $query->where(function ($q) use ($s) {
+                $q->where('work_type', 'like', "%{$s}%")
+                    ->orWhere('sub_work_type', 'like', "%{$s}%");
+            });
+        }
+
+        $perPage = $request->integer('per_page', 15);
+        $workVolumes = $query->paginate($perPage);
+
+        return response()->json($workVolumes);
+    }
+
+    public function store(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'work_type' => 'required|string|max:200',
+            'sub_work_type' => 'required|string|max:200',
+            'unit' => 'required|string|max:50',
+            'design_quantity' => 'nullable|numeric|min:0',
+            'daily_report_applied' => 'nullable|boolean',
+        ]);
+
+        $validated['tenant_id'] = $this->tenantId();
+        $validated['design_quantity'] = $validated['design_quantity'] ?? 0;
+        $validated['daily_report_applied'] = $validated['daily_report_applied'] ?? false;
+
+        $workVolume = PmisWorkVolume::create($validated);
+
+        return response()->json($workVolume, 201);
+    }
+
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $workVolume = PmisWorkVolume::tenant($this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'work_type' => 'sometimes|required|string|max:200',
+            'sub_work_type' => 'sometimes|required|string|max:200',
+            'unit' => 'sometimes|required|string|max:50',
+            'design_quantity' => 'nullable|numeric|min:0',
+            'daily_report_applied' => 'nullable|boolean',
+        ]);
+
+        $workVolume->update($validated);
+
+        return response()->json($workVolume);
+    }
+
+    public function destroy(int $id): JsonResponse
+    {
+        $workVolume = PmisWorkVolume::tenant($this->tenantId())->findOrFail($id);
+        $workVolume->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+}

app/Http/Controllers/Juil/PmisWorkforceController.php

@@ -0,0 +1,133 @@
+<?php
+
+namespace App\Http\Controllers\Juil;
+
+use App\Http\Controllers\Controller;
+use App\Models\Juil\PmisConstructionWorker;
+use App\Models\Juil\PmisJobType;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PmisWorkforceController extends Controller
+{
+    private function tenantId(): int
+    {
+        return (int) session('current_tenant_id', 1);
+    }
+
+    // ── 인원 CRUD ──
+
+    public function workerList(Request $request): JsonResponse
+    {
+        $query = PmisConstructionWorker::tenant($this->tenantId())
+            ->with('jobType:id,name')
+            ->orderByDesc('id');
+
+        if ($request->filled('company')) {
+            $query->where('company_name', 'like', '%' . $request->company . '%');
+        }
+        if ($request->filled('trade')) {
+            $query->where('trade_name', $request->trade);
+        }
+        if ($request->filled('job_type_id')) {
+            $query->where('job_type_id', $request->job_type_id);
+        }
+        if ($request->filled('search')) {
+            $s = $request->search;
+            $query->where(function ($q) use ($s) {
+                $q->where('name', 'like', "%{$s}%")
+                    ->orWhere('phone', 'like', "%{$s}%");
+            });
+        }
+
+        $perPage = $request->integer('per_page', 15);
+        $workers = $query->paginate($perPage);
+
+        return response()->json($workers);
+    }
+
+    public function workerStore(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'company_name' => 'required|string|max:200',
+            'trade_name' => 'required|string|max:100',
+            'job_type_id' => 'nullable|exists:pmis_job_types,id',
+            'name' => 'required|string|max:50',
+            'phone' => 'nullable|string|max:20',
+            'birth_date' => 'nullable|string|max:6',
+            'ssn_gender' => 'nullable|string|max:1',
+            'wage' => 'nullable|integer|min:0',
+            'blood_type' => 'nullable|string|max:5',
+            'remark' => 'nullable|string|max:500',
+        ]);
+
+        $validated['tenant_id'] = $this->tenantId();
+        $validated['wage'] = $validated['wage'] ?? 0;
+
+        $worker = PmisConstructionWorker::create($validated);
+        $worker->load('jobType:id,name');
+
+        return response()->json($worker, 201);
+    }
+
+    public function workerUpdate(Request $request, int $id): JsonResponse
+    {
+        $worker = PmisConstructionWorker::tenant($this->tenantId())->findOrFail($id);
+
+        $validated = $request->validate([
+            'company_name' => 'sometimes|required|string|max:200',
+            'trade_name' => 'sometimes|required|string|max:100',
+            'job_type_id' => 'nullable|exists:pmis_job_types,id',
+            'name' => 'sometimes|required|string|max:50',
+            'phone' => 'nullable|string|max:20',
+            'birth_date' => 'nullable|string|max:6',
+            'ssn_gender' => 'nullable|string|max:1',
+            'wage' => 'nullable|integer|min:0',
+            'blood_type' => 'nullable|string|max:5',
+            'remark' => 'nullable|string|max:500',
+        ]);
+
+        $worker->update($validated);
+        $worker->load('jobType:id,name');
+
+        return response()->json($worker);
+    }
+
+    public function workerDestroy(int $id): JsonResponse
+    {
+        $worker = PmisConstructionWorker::tenant($this->tenantId())->findOrFail($id);
+        $worker->delete();
+
+        return response()->json(['message' => '삭제되었습니다.']);
+    }
+
+    // ── 직종 CRUD ──
+
+    public function jobTypeList(): JsonResponse
+    {
+        $types = PmisJobType::tenant($this->tenantId())
+            ->where('is_active', true)
+            ->orderBy('sort_order')
+            ->orderBy('name')
+            ->get(['id', 'name', 'sort_order']);
+
+        return response()->json($types);
+    }
+
+    public function jobTypeStore(Request $request): JsonResponse
+    {
+        $validated = $request->validate([
+            'name' => 'required|string|max:100',
+        ]);
+
+        $maxSort = PmisJobType::tenant($this->tenantId())->max('sort_order') ?? 0;
+
+        $type = PmisJobType::create([
+            'tenant_id' => $this->tenantId(),
+            'name' => $validated['name'],
+            'sort_order' => $maxSort + 1,
+        ]);
+
+        return response()->json($type, 201);
+    }
+}

app/Http/Controllers/ProjectManagementController.php

@@ -6,6 +6,8 @@
 use App\Models\Admin\AdminPmTask;
 use App\Services\ProjectManagement\ImportService;
 use App\Services\ProjectManagement\ProjectService;
+use Illuminate\Http\Response;
+use Illuminate\Http\Request;
 use Illuminate\View\View;
 
 class ProjectManagementController extends Controller
@@ -17,8 +19,13 @@ public function __construct(
     /**
      * 프로젝트 관리 대시보드
      */
-    public function index(): View
+    public function index(Request $request): View|Response
     {
+        // HTMX 부분 로드 시 @push('scripts')가 실행되지 않으므로 전체 페이지 리로드
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('pm.index'));
+        }
+
         $summary = $this->projectService->getDashboardSummary();
         $statuses = AdminPmProject::getStatuses();
         $taskStatuses = AdminPmTask::getStatuses();

app/Http/Controllers/Rd/CmSongController.php

@@ -2,6 +2,7 @@
 
 namespace App\Http\Controllers\Rd;
 
+use App\Helpers\AiTokenHelper;
 use App\Http\Controllers\Controller;
 use App\Models\Rd\CmSong;
 use Illuminate\Http\JsonResponse;
@@ -114,6 +115,10 @@ public function generateLyrics(Request $request): JsonResponse
             }
 
             $data = $response->json();
+
+            // 토큰 사용량 기록
+            AiTokenHelper::saveGeminiUsage($data, 'gemini-2.5-flash', '나레이션-가사생성');
+
             $text = $data['candidates'][0]['content']['parts'][0]['text'] ?? '';
 
             return response()->json([
@@ -165,6 +170,10 @@ public function generateAudio(Request $request): JsonResponse
             }
 
             $data = $response->json();
+
+            // 토큰 사용량 기록
+            AiTokenHelper::saveGeminiUsage($data, 'gemini-2.5-flash-preview-tts', '나레이션-TTS');
+
             $inlineData = $data['candidates'][0]['content']['parts'][0]['inlineData'] ?? null;
 
             if (! $inlineData || empty($inlineData['data'])) {

app/Http/Controllers/RdController.php

@@ -2,6 +2,7 @@
 
 namespace App\Http\Controllers;
 
+use App\Helpers\AiTokenHelper;
 use App\Models\HR\Employee;
 use App\Models\Rd\AiQuotation;
 use App\Models\Tenants\Department;
@@ -9,6 +10,8 @@
 use App\Services\Rd\AiQuotationService;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Log;
 use Illuminate\View\View;
 
 class RdController extends Controller
@@ -301,4 +304,325 @@ public function editQuotation(Request $request, int $id): View|\Illuminate\Http\
 
         return view('rd.ai-quotation.edit', compact('quotation'));
     }
+
+    /**
+     * 기획디자인 - 플래닝 캔버스
+     */
+    public function planningDesign(Request $request): View|\Illuminate\Http\Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('rd.planning-design'));
+        }
+
+        return view('rd.planning-design.index');
+    }
+
+    /**
+     * 디자인 인사이트 - UI/UX 연구 도구
+     */
+    public function designInsight(Request $request): View|\Illuminate\Http\Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('rd.design-insight'));
+        }
+
+        return view('rd.design-insight.index');
+    }
+
+    /**
+     * 사운드 로고 생성기
+     */
+    public function soundLogo(Request $request): View|\Illuminate\Http\Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('rd.sound-logo'));
+        }
+
+        return view('rd.sound-logo.index');
+    }
+
+    /**
+     * Lyria RealTime 접속용 API 설정 반환
+     */
+    public function soundLogoLyriaConfig(): JsonResponse
+    {
+        $apiKey = config('services.gemini.api_key');
+
+        if (! $apiKey) {
+            return response()->json(['success' => false, 'error' => 'API 키가 설정되지 않았습니다.'], 500);
+        }
+
+        return response()->json([
+            'success' => true,
+            'api_key' => $apiKey,
+            'ws_url' => 'wss://generativelanguage.googleapis.com/ws/google.ai.generativelanguage.v1alpha.GenerativeService.BidiGenerateMusic',
+            'model' => 'models/lyria-realtime-exp',
+        ]);
+    }
+
+    /**
+     * 사운드 로고 AI 생성 (Gemini API)
+     */
+    public function soundLogoGenerate(Request $request): JsonResponse
+    {
+        $request->validate([
+            'prompt' => 'required|string|max:500',
+            'category' => 'nullable|string',
+            'duration' => 'nullable|numeric|min:0.3|max:5',
+        ]);
+
+        $apiKey = config('services.gemini.api_key');
+        $baseUrl = config('services.gemini.base_url', 'https://generativelanguage.googleapis.com/v1beta');
+        $model = config('services.gemini.model', 'gemini-2.5-flash');
+
+        if (! $apiKey) {
+            return response()->json(['success' => false, 'error' => 'Gemini API 키가 설정되지 않았습니다.'], 500);
+        }
+
+        $category = $request->category ?? '기업 시그널';
+        $duration = $request->duration ?? 1.5;
+
+        $prompt = <<<PROMPT
+당신은 사운드 디자인 전문가입니다. 사용자의 요청에 맞는 사운드 로고(짧은 시그니처 사운드)를 Web Audio API 음표 시퀀스로 설계해주세요.
+
+## 사용자 요청
+- 설명: {$request->prompt}
+- 카테고리: {$category}
+- 목표 길이: {$duration}초
+
+## 사용 가능한 음표
+C3, C#3, D3, D#3, E3, F3, F#3, G3, G#3, A3, A#3, B3,
+C4, C#4, D4, D#4, E4, F4, F#4, G4, G#4, A4, A#4, B4,
+C5, C#5, D5, D#5, E5, F5, F#5, G5, G#5, A5, A#5, B5, C6
+
+## 음표 타입
+- note: 단일 음 (note 필드 필수)
+- chord: 화음 (chord 배열 필수, 2~4개 음)
+- rest: 쉼표 (duration만 필요)
+
+## 신스 타입
+- sine: 부드러움 (기업 로고, 알림에 적합)
+- triangle: 따뜻함 (성공, 게임에 적합)
+- square: 8bit/디지털 (게임, UI에 적합)
+- sawtooth: 날카로움 (록, 긴급 알림에 적합)
+
+## 반드시 아래 JSON 형식으로만 응답하세요
+{
+  "name": "사운드 이름",
+  "desc": "사운드 설명 (한줄)",
+  "synth": "sine",
+  "adsr": { "attack": 10, "decay": 80, "sustain": 0.6, "release": 400 },
+  "volume": 0.8,
+  "reverb": 0.3,
+  "notes": [
+    { "type": "note", "note": "C5", "duration": 0.20, "velocity": 0.8 },
+    { "type": "rest", "duration": 0.10 },
+    { "type": "chord", "chord": ["C4", "E4", "G4"], "duration": 0.50, "velocity": 1.0 }
+  ]
+}
+
+## 설계 원칙
+- 음표의 duration 합계가 목표 길이({$duration}초)에 근접하도록 설계
+- velocity: 0.3~1.0 (음의 강약으로 표현력 추가)
+- ADSR: attack(1~500ms), decay(10~1000ms), sustain(0~1.0), release(10~3000ms)
+- 카테고리 특성에 맞는 synth와 ADSR 선택
+- 음악적으로 조화롭고 기억에 남는 멜로디 설계
+- 최소 2개, 최대 12개 음표 사용
+- name은 10자 이내, desc는 30자 이내로 간결하게 작성
+PROMPT;
+
+        try {
+            $response = Http::timeout(30)->post(
+                "{$baseUrl}/models/{$model}:generateContent?key={$apiKey}",
+                [
+                    'contents' => [
+                        ['parts' => [['text' => $prompt]]],
+                    ],
+                    'generationConfig' => [
+                        'temperature' => 0.7,
+                        'maxOutputTokens' => 4096,
+                        'responseMimeType' => 'application/json',
+                    ],
+                ]
+            );
+        } catch (\Exception $e) {
+            Log::error('SoundLogo AI 생성 실패', ['error' => $e->getMessage()]);
+
+            return response()->json(['success' => false, 'error' => 'AI 서버 연결 실패'], 500);
+        }
+
+        if (! $response->successful()) {
+            Log::error('SoundLogo AI API 오류', ['status' => $response->status(), 'body' => $response->body()]);
+
+            return response()->json(['success' => false, 'error' => 'AI 생성 실패: '.$response->status()], 500);
+        }
+
+        $data = $response->json();
+
+        // 토큰 사용량 기록
+        AiTokenHelper::saveGeminiUsage($data, $model, '사운드로고-AI생성');
+
+        $text = $data['candidates'][0]['content']['parts'][0]['text'] ?? '';
+
+        // JSON 파싱 (코드블록 제거)
+        $text = preg_replace('/^```(?:json)?\s*/m', '', $text);
+        $text = preg_replace('/```\s*$/m', '', $text);
+        $result = json_decode(trim($text), true);
+
+        if (! $result || ! isset($result['notes'])) {
+            Log::warning('SoundLogo AI 응답 파싱 실패', ['text' => substr($text, 0, 500)]);
+
+            return response()->json(['success' => false, 'error' => 'AI 응답을 파싱할 수 없습니다.'], 500);
+        }
+
+        return response()->json(['success' => true, 'data' => $result]);
+    }
+
+    /**
+     * 사운드 로고 TTS 음성 생성 (Gemini TTS API)
+     */
+    public function soundLogoTts(Request $request): JsonResponse
+    {
+        $request->validate([
+            'text' => 'required|string|max:200',
+            'voice_name' => 'nullable|string|max:30',
+            'voice_category' => 'nullable|string|in:female,male,child',
+            'voice_style' => 'nullable|string|max:100',
+            'voice_speed' => 'nullable|integer|min:1|max:5',
+        ]);
+
+        $apiKey = config('services.gemini.api_key');
+        $baseUrl = config('services.gemini.base_url', 'https://generativelanguage.googleapis.com/v1beta');
+
+        if (! $apiKey) {
+            return response()->json(['success' => false, 'error' => 'Gemini API 키가 설정되지 않았습니다.'], 500);
+        }
+
+        $voiceName = $request->voice_name ?: 'Kore';
+        $voiceCategory = $request->voice_category ?: 'female';
+        $voiceStyle = $request->voice_style ?: '';
+        $voiceSpeed = $request->voice_speed ?: 3;
+
+        // 속도 지시문 매핑
+        $speedDirectives = [
+            1 => '아주 천천히 또박또박 말해주세요.',
+            2 => '조금 느린 속도로 말해주세요.',
+            3 => '',
+            4 => '조금 빠른 속도로 말해주세요.',
+            5 => '아주 빠른 속도로 말해주세요.',
+        ];
+
+        // TTS 프롬프트 구성 — Director's Note 형식
+        $ttsText = $request->text;
+        $notes = [];
+
+        // 아이 카테고리: 높은 톤으로 어린이처럼 연기하도록 강한 지시문
+        if ($voiceCategory === 'child') {
+            $notes[] = 'Speak as a young child with a high-pitched, innocent voice';
+        }
+
+        if ($voiceStyle) {
+            $notes[] = $voiceStyle;
+        }
+
+        if (! empty($speedDirectives[$voiceSpeed])) {
+            $notes[] = $speedDirectives[$voiceSpeed];
+        }
+
+        if (! empty($notes)) {
+            $direction = implode('. ', $notes);
+            $ttsText = "[{$direction}]\n\n{$ttsText}";
+        }
+
+        // 짧은 텍스트는 TTS 모델이 텍스트 생성으로 인식할 수 있으므로 발화 컨텍스트 추가
+        if (mb_strlen($ttsText) < 4) {
+            $ttsText = "'{$ttsText}' ";
+        }
+
+        try {
+            $response = Http::timeout(30)->post(
+                "{$baseUrl}/models/gemini-2.5-flash-preview-tts:generateContent?key={$apiKey}",
+                [
+                    'contents' => [
+                        ['parts' => [['text' => $ttsText]]],
+                    ],
+                    'generationConfig' => [
+                        'responseModalities' => ['AUDIO'],
+                        'speechConfig' => [
+                            'voiceConfig' => [
+                                'prebuiltVoiceConfig' => [
+                                    'voiceName' => $voiceName,
+                                ],
+                            ],
+                        ],
+                    ],
+                ]
+            );
+        } catch (\Exception $e) {
+            Log::error('SoundLogo TTS 생성 실패', ['error' => $e->getMessage()]);
+
+            return response()->json(['success' => false, 'error' => 'TTS 서버 연결 실패'], 500);
+        }
+
+        if (! $response->successful()) {
+            $body = $response->json();
+            $msg = $body['error']['message'] ?? ('TTS 생성 실패: '.$response->status());
+            Log::warning('SoundLogo TTS API 에러', ['status' => $response->status(), 'body' => $msg]);
+
+            return response()->json(['success' => false, 'error' => $msg], $response->status());
+        }
+
+        $data = $response->json();
+
+        // 토큰 사용량 기록
+        AiTokenHelper::saveGeminiUsage($data, 'gemini-2.5-flash-preview-tts', '사운드로고-TTS');
+
+        $inlineData = $data['candidates'][0]['content']['parts'][0]['inlineData'] ?? null;
+
+        if (! $inlineData || empty($inlineData['data'])) {
+            return response()->json(['success' => false, 'error' => '음성 데이터를 받지 못했습니다.'], 500);
+        }
+
+        return response()->json([
+            'success' => true,
+            'audio_data' => $inlineData['data'],
+            'mime_type' => $inlineData['mimeType'] ?? 'audio/L16;rate=24000',
+        ]);
+    }
+
+    /**
+     * 자동도면 생성 (전개도 시뮬레이터)
+     */
+    public function autoDrawing(Request $request): View|\Illuminate\Http\Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('rd.auto-drawing'));
+        }
+
+        return view('rd.auto-drawing.index');
+    }
+
+    /**
+     * 방화셔터 도면생성
+     */
+    public function fireShutterDrawing(Request $request): View|\Illuminate\Http\Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('rd.fire-shutter-drawing'));
+        }
+
+        return view('rd.fire-shutter-drawing.index');
+    }
+
+    /**
+     * 클코 → 슬랙 변환기
+     */
+    public function ccToSlack(Request $request): View|\Illuminate\Http\Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('rd.cc-to-slack'));
+        }
+
+        return view('rd.cc-to-slack.index');
+    }
 }

app/Http/Controllers/System/TenantMailConfigController.php

@@ -0,0 +1,250 @@
+<?php
+
+namespace App\Http\Controllers\System;
+
+use App\Http\Controllers\Controller;
+use App\Models\Tenants\MailLog;
+use App\Models\Tenants\Tenant;
+use App\Models\Tenants\TenantMailConfig;
+use App\Services\Mail\SmtpConnectionTester;
+use App\Services\Mail\TenantMailService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\View\View;
+
+class TenantMailConfigController extends Controller
+{
+    /**
+     * 전체 테넌트 메일 설정 현황
+     */
+    public function index(Request $request): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('system.tenant-mail.index'));
+        }
+
+        $tenants = Tenant::orderBy('company_name')
+            ->get()
+            ->map(function ($tenant) {
+                $config = TenantMailConfig::withoutGlobalScopes()
+                    ->where('tenant_id', $tenant->id)
+                    ->first();
+
+                $todayCount = MailLog::withoutGlobalScopes()
+                    ->where('tenant_id', $tenant->id)
+                    ->whereDate('created_at', today())
+                    ->whereIn('status', ['queued', 'sent'])
+                    ->count();
+
+                return (object) [
+                    'tenant' => $tenant,
+                    'config' => $config,
+                    'today_count' => $todayCount,
+                ];
+            });
+
+        return view('system.tenant-mail.index', compact('tenants'));
+    }
+
+    /**
+     * 테넌트 메일 설정 편집 폼
+     */
+    public function edit(Request $request, int $tenantId): View|Response
+    {
+        if ($request->header('HX-Request')) {
+            return response('', 200)->header('HX-Redirect', route('system.tenant-mail.edit', $tenantId));
+        }
+
+        $tenant = Tenant::findOrFail($tenantId);
+
+        $config = TenantMailConfig::withoutGlobalScopes()
+            ->where('tenant_id', $tenantId)
+            ->first();
+
+        $presets = config('mail-presets', []);
+
+        $mailService = app(TenantMailService::class);
+        $todayCount = $mailService->getTodayCount($tenantId);
+        $monthCount = $mailService->getMonthCount($tenantId);
+
+        return view('system.tenant-mail.edit', compact(
+            'tenant',
+            'config',
+            'presets',
+            'todayCount',
+            'monthCount'
+        ));
+    }
+
+    /**
+     * 메일 설정 저장
+     */
+    public function update(Request $request, int $tenantId): JsonResponse
+    {
+        $tenant = Tenant::findOrFail($tenantId);
+
+        $validated = $request->validate([
+            'provider' => 'required|string|in:platform,smtp',
+            'from_name' => 'required|string|max:255',
+            'from_address' => 'required|email|max:255',
+            'reply_to' => 'nullable|email|max:255',
+            'daily_limit' => 'required|integer|min:1|max:99999',
+            'is_active' => 'boolean',
+            // SMTP 설정
+            'preset' => 'nullable|string',
+            'smtp_host' => 'required_if:provider,smtp|nullable|string|max:255',
+            'smtp_port' => 'required_if:provider,smtp|nullable|integer|min:1|max:65535',
+            'smtp_encryption' => 'required_if:provider,smtp|nullable|string|in:tls,ssl',
+            'smtp_username' => 'required_if:provider,smtp|nullable|string|max:255',
+            'smtp_password' => 'nullable|string|max:255',
+            // 브랜딩
+            'branding_company_name' => 'nullable|string|max:255',
+            'branding_primary_color' => 'nullable|string|max:7',
+            'branding_company_address' => 'nullable|string|max:500',
+            'branding_company_phone' => 'nullable|string|max:50',
+            'branding_footer_text' => 'nullable|string|max:500',
+        ]);
+
+        $config = TenantMailConfig::withoutGlobalScopes()
+            ->where('tenant_id', $tenantId)
+            ->first();
+
+        $data = [
+            'tenant_id' => $tenantId,
+            'provider' => $validated['provider'],
+            'from_name' => $validated['from_name'],
+            'from_address' => $validated['from_address'],
+            'reply_to' => $validated['reply_to'] ?? null,
+            'daily_limit' => $validated['daily_limit'],
+            'is_active' => $validated['is_active'] ?? true,
+        ];
+
+        // Options 구성
+        $options = $config?->options ?? [];
+
+        // SMTP 설정
+        if ($validated['provider'] === 'smtp') {
+            $options['preset'] = $validated['preset'] ?? 'custom';
+            $options['smtp'] = [
+                'host' => $validated['smtp_host'],
+                'port' => $validated['smtp_port'],
+                'encryption' => $validated['smtp_encryption'],
+                'username' => $validated['smtp_username'],
+            ];
+
+            // 비밀번호: 새로 입력된 경우에만 업데이트
+            if (! empty($validated['smtp_password'])) {
+                $options['smtp']['password'] = encrypt($validated['smtp_password']);
+            } elseif (isset($config?->options['smtp']['password'])) {
+                $options['smtp']['password'] = $config->options['smtp']['password'];
+            }
+        } else {
+            // platform 모드에서는 SMTP 설정 제거
+            unset($options['smtp'], $options['preset']);
+        }
+
+        // 브랜딩
+        $options['branding'] = array_filter([
+            'company_name' => $validated['branding_company_name'] ?? null,
+            'primary_color' => $validated['branding_primary_color'] ?? '#1a56db',
+            'company_address' => $validated['branding_company_address'] ?? null,
+            'company_phone' => $validated['branding_company_phone'] ?? null,
+            'footer_text' => $validated['branding_footer_text'] ?? 'SAM 시스템에서 발송된 메일입니다.',
+        ]);
+
+        $data['options'] = $options;
+        $data['updated_by'] = auth()->id();
+
+        if ($config) {
+            $config->update($data);
+        } else {
+            $data['created_by'] = auth()->id();
+            $config = TenantMailConfig::create($data);
+        }
+
+        return response()->json([
+            'ok' => true,
+            'message' => '메일 설정이 저장되었습니다.',
+            'data' => $config->fresh(),
+        ]);
+    }
+
+    /**
+     * SMTP 연결 테스트
+     */
+    public function test(Request $request, int $tenantId): JsonResponse
+    {
+        $validated = $request->validate([
+            'host' => 'required|string',
+            'port' => 'required|integer',
+            'encryption' => 'required|string|in:tls,ssl',
+            'username' => 'required|string',
+            'password' => 'required|string',
+            'preset' => 'nullable|string',
+            'send_test_mail' => 'boolean',
+        ]);
+
+        $tester = new SmtpConnectionTester;
+        $result = $tester->testViaLaravel(
+            host: $validated['host'],
+            port: $validated['port'],
+            encryption: $validated['encryption'],
+            username: $validated['username'],
+            password: $validated['password'],
+            testRecipient: ($validated['send_test_mail'] ?? false) ? $validated['username'] : null
+        );
+
+        // 테스트 결과를 config에 기록
+        $config = TenantMailConfig::withoutGlobalScopes()
+            ->where('tenant_id', $tenantId)
+            ->first();
+
+        if ($config) {
+            $config->setOption('connection_test', [
+                'last_tested_at' => now()->toIso8601String(),
+                'last_result' => $result['success'] ? 'success' : 'failed',
+                'response_time_ms' => $result['response_time_ms'],
+                'server_banner' => $result['server_banner'] ?? null,
+                'tested_by' => auth()->user()?->email,
+            ]);
+            $config->save();
+        }
+
+        if ($result['success']) {
+            return response()->json([
+                'ok' => true,
+                'message' => $result['message'],
+                'data' => [
+                    'response_time_ms' => $result['response_time_ms'],
+                    'server_banner' => $result['server_banner'],
+                    'test_mail_sent' => $result['test_mail_sent'] ?? false,
+                ],
+            ]);
+        }
+
+        return response()->json([
+            'ok' => false,
+            'message' => $result['message'],
+            'data' => [
+                'error_code' => $result['error_code'],
+                'troubleshoot' => SmtpConnectionTester::getTroubleshoot(
+                    $result['error_code'] ?? 'UNKNOWN',
+                    $validated['preset'] ?? null
+                ),
+                'response_time_ms' => $result['response_time_ms'],
+            ],
+        ]);
+    }
+
+    /**
+     * SMTP 프리셋 목록
+     */
+    public function presets(): JsonResponse
+    {
+        return response()->json([
+            'ok' => true,
+            'data' => config('mail-presets', []),
+        ]);
+    }
+}

app/Mail/PayslipMail.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Mail;
+
+use Illuminate\Bus\Queueable;
+use Illuminate\Mail\Attachment;
+use Illuminate\Mail\Mailable;
+use Illuminate\Mail\Mailables\Content;
+use Illuminate\Mail\Mailables\Envelope;
+use Illuminate\Queue\SerializesModels;
+
+class PayslipMail extends Mailable
+{
+    use Queueable, SerializesModels;
+
+    public function __construct(
+        public array $payslipData,
+        private string $pdfContent,
+        private string $fileName,
+    ) {}
+
+    public function envelope(): Envelope
+    {
+        $year = $this->payslipData['pay_year'] ?? '';
+        $month = str_pad($this->payslipData['pay_month'] ?? '', 2, '0', STR_PAD_LEFT);
+
+        return new Envelope(
+            from: new \Illuminate\Mail\Mailables\Address('admin@codebridge-x.com', '(주)코드브릿지엑스'),
+            subject: "[SAM] {$year}년{$month}월분 급여명세서",
+        );
+    }
+
+    public function content(): Content
+    {
+        return new Content(
+            view: 'emails.payslip-notification',
+        );
+    }
+
+    public function attachments(): array
+    {
+        return [
+            Attachment::fromData(fn () => $this->pdfContent, $this->fileName)
+                ->withMime('application/pdf'),
+        ];
+    }
+}

app/Models/Admin/AdminApiFlow.php

@@ -24,6 +24,7 @@
  */
 class AdminApiFlow extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_flows';
 
     protected $fillable = [

app/Models/Admin/AdminApiFlowRun.php

@@ -37,6 +37,7 @@ class AdminApiFlowRun extends Model
 
     public const STATUS_PARTIAL = 'PARTIAL';
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_flow_runs';
 
     public $timestamps = false; // created_at만 사용

app/Models/Admin/AdminPmDailyLog.php

@@ -27,6 +27,7 @@ class AdminPmDailyLog extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_pm_daily_logs';
 
     protected $fillable = [

app/Models/Admin/AdminPmDailyLogEntry.php

@@ -22,6 +22,7 @@
  */
 class AdminPmDailyLogEntry extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'admin_pm_daily_log_entries';
 
     protected $fillable = [

app/Models/Admin/AdminPmIssue.php

@@ -29,6 +29,7 @@ class AdminPmIssue extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_pm_issues';
 
     protected $fillable = [

app/Models/Admin/AdminPmProject.php

@@ -28,6 +28,7 @@ class AdminPmProject extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_pm_projects';
 
     protected $fillable = [

app/Models/Admin/AdminPmTask.php

@@ -31,6 +31,7 @@ class AdminPmTask extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_pm_tasks';
 
     protected $fillable = [

app/Models/Admin/AdminRoadmapMilestone.php

@@ -11,6 +11,7 @@ class AdminRoadmapMilestone extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_roadmap_milestones';
 
     protected $fillable = [

app/Models/Admin/AdminRoadmapPlan.php

@@ -12,6 +12,7 @@ class AdminRoadmapPlan extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_roadmap_plans';
 
     protected $fillable = [

app/Models/Approvals/Approval.php

@@ -13,6 +13,8 @@ class Approval extends Model
 {
     use BelongsToTenant, SoftDeletes;
 
+    protected $connection = 'mysql';
+
     protected $table = 'approvals';
 
     protected $casts = [

app/Models/Approvals/ApprovalStep.php

@@ -5,9 +5,12 @@
 use App\Models\User;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
 
 class ApprovalStep extends Model
 {
+    use SoftDeletes;
+
     protected $table = 'approval_steps';
 
     protected $casts = [
@@ -19,6 +22,7 @@ class ApprovalStep extends Model
     ];
 
     protected $fillable = [
+        'tenant_id',
         'approval_id',
         'step_order',
         'step_type',

app/Models/BizCert.php

@@ -9,6 +9,7 @@
  */
 class BizCert extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'biz_cert';
 
     protected $fillable = [

app/Models/Boards/File.php

@@ -12,6 +12,8 @@
 /**
  * 파일 모델 (Polymorphic)
  *
+ * @note $connection = 'mysql' 명시: codebridge 모델에서 relation으로 참조 시 connection 상속 방지
+ *
  * @property int $id
  * @property int|null $tenant_id
  * @property int|null $folder_id
@@ -31,6 +33,8 @@ class File extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'mysql';
+
     protected $table = 'files';
 
     protected $fillable = [

app/Models/Commons/File.php

@@ -6,6 +6,8 @@
 
 class File extends Model
 {
+    protected $connection = 'mysql';
+
     protected $table = 'files';
 
     protected $fillable = [

app/Models/Department.php

@@ -11,6 +11,8 @@ class Department extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'mysql';
+
     protected $table = 'departments';
 
     protected $fillable = [

app/Models/DevTools/ApiBookmark.php

@@ -21,6 +21,7 @@
  */
 class ApiBookmark extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_bookmarks';
 
     protected $fillable = [

app/Models/DevTools/ApiDeprecation.php

@@ -22,6 +22,7 @@
  */
 class ApiDeprecation extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_deprecations';
 
     protected $fillable = [

app/Models/DevTools/ApiEnvironment.php

@@ -23,6 +23,7 @@
  */
 class ApiEnvironment extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_environments';
 
     protected $fillable = [

app/Models/DevTools/ApiHistory.php

@@ -29,6 +29,7 @@ class ApiHistory extends Model
      */
     public const UPDATED_AT = null;
 
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_histories';
 
     protected $fillable = [

app/Models/DevTools/ApiTemplate.php

@@ -25,6 +25,7 @@
  */
 class ApiTemplate extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'admin_api_templates';
 
     protected $fillable = [

app/Models/ESign/EsignFieldTemplate.php

@@ -8,6 +8,7 @@
 
 class EsignFieldTemplate extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'esign_field_templates';
 
     protected $fillable = [

app/Models/ESign/EsignFieldTemplateItem.php

@@ -7,6 +7,7 @@
 
 class EsignFieldTemplateItem extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'esign_field_template_items';
 
     protected $fillable = [

app/Models/Equipment/Equipment.php

@@ -14,6 +14,7 @@ class Equipment extends Model
 {
     use BelongsToTenant, SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'equipments';
 
     protected $fillable = [

app/Models/Equipment/EquipmentInspection.php

@@ -9,6 +9,7 @@
 
 class EquipmentInspection extends Model
 {
+    protected $connection = 'codebridge';
     use BelongsToTenant;
 
     protected $fillable = [

app/Models/Equipment/EquipmentInspectionDetail.php

@@ -7,6 +7,7 @@
 
 class EquipmentInspectionDetail extends Model
 {
+    protected $connection = 'codebridge';
     protected $fillable = [
         'inspection_id',
         'template_item_id',

app/Models/Equipment/EquipmentInspectionTemplate.php

@@ -8,6 +8,7 @@
 
 class EquipmentInspectionTemplate extends Model
 {
+    protected $connection = 'codebridge';
     use BelongsToTenant;
 
     protected $fillable = [

app/Models/Equipment/EquipmentProcess.php

@@ -7,6 +7,7 @@
 
 class EquipmentProcess extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'equipment_process';
 
     protected $fillable = [

app/Models/Equipment/EquipmentRepair.php

@@ -9,6 +9,7 @@
 
 class EquipmentRepair extends Model
 {
+    protected $connection = 'codebridge';
     use BelongsToTenant, SoftDeletes;
 
     protected $fillable = [

app/Models/Finance/CondolenceExpense.php

@@ -9,6 +9,7 @@ class CondolenceExpense extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'condolence_expenses';
 
     protected $fillable = [

app/Models/Finance/ConsultingFee.php

@@ -9,6 +9,7 @@ class ConsultingFee extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'consulting_fees';
 
     protected $fillable = [

app/Models/Finance/CorporateCard.php

@@ -9,6 +9,7 @@ class CorporateCard extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'corporate_cards';
 
     protected $fillable = [

app/Models/Finance/CorporateCardPrepayment.php

@@ -6,6 +6,7 @@
 
 class CorporateCardPrepayment extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'corporate_card_prepayments';
 
     protected $fillable = ['tenant_id', 'year_month', 'amount', 'memo', 'items'];

app/Models/Finance/CustomerSettlement.php

@@ -9,6 +9,7 @@ class CustomerSettlement extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'customer_settlements';
 
     protected $fillable = [

app/Models/Finance/DailyFundMemo.php

@@ -6,6 +6,7 @@
 
 class DailyFundMemo extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'daily_fund_memos';
 
     protected $fillable = [

app/Models/Finance/DailyFundTransaction.php

@@ -9,6 +9,7 @@ class DailyFundTransaction extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'daily_fund_transactions';
 
     protected $fillable = [

app/Models/Finance/Income.php

@@ -9,6 +9,7 @@ class Income extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'incomes';
 
     protected $fillable = [

app/Models/Finance/SalesRecord.php

@@ -9,6 +9,7 @@ class SalesRecord extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'sales_records';
 
     protected $fillable = [

app/Models/Finance/VatRecord.php

@@ -9,6 +9,7 @@ class VatRecord extends Model
 {
     use SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'vat_records';
 
     protected $fillable = [

app/Models/HR/BusinessIncomePayment.php

@@ -12,6 +12,7 @@ class BusinessIncomePayment extends Model
 {
     use ModelTrait, SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'business_income_payments';
 
     protected $fillable = [

app/Models/HR/Employee.php

@@ -111,6 +111,11 @@ public function getResidentNumberAttribute(): ?string
         return $this->json_extra['resident_number'] ?? null;
     }
 
+    public function getPersonalEmailAttribute(): ?string
+    {
+        return $this->json_extra['personal_email'] ?? null;
+    }
+
     public function getBankAccountAttribute(): ?array
     {
         return $this->json_extra['bank_account'] ?? null;
@@ -169,6 +174,118 @@ public function setJsonExtraValue(string $key, mixed $value): void
         $this->json_extra = $extra;
     }
 
+    // =========================================================================
+    // 연봉 정보 (salary_info) — 민감 데이터, 별도 접근 제어
+    // =========================================================================
+
+    public function getSalaryInfo(): array
+    {
+        $defaults = [
+            'annual_salary' => null,
+            'effective_date' => null,
+            'notes' => null,
+            'fixed_overtime_hours' => null,
+            'meal_allowance' => 200000,
+            'monthly_salary' => null,
+            'base_salary' => null,
+            'fixed_overtime_pay' => null,
+            'hourly_wage' => null,
+            'monthly_work_hours' => 209,
+            'overtime_multiplier' => 1.5,
+            'history' => [],
+        ];
+
+        $data = $this->json_extra['salary_info'] ?? [];
+
+        return array_merge($defaults, $data);
+    }
+
+    public function setSalaryInfo(array $data): void
+    {
+        $current = $this->getSalaryInfo();
+        $history = $current['history'] ?? [];
+
+        // 기존 연봉이 있으면 이력에 추가
+        if ($current['annual_salary'] !== null) {
+            $history[] = [
+                'annual_salary' => $current['annual_salary'],
+                'fixed_overtime_hours' => $current['fixed_overtime_hours'],
+                'meal_allowance' => $current['meal_allowance'],
+                'base_salary' => $current['base_salary'],
+                'fixed_overtime_pay' => $current['fixed_overtime_pay'],
+                'effective_date' => $current['effective_date'],
+                'notes' => $current['notes'],
+                'recorded_at' => now()->format('Y-m-d H:i:s'),
+                'recorded_by' => auth()->user()?->name ?? '-',
+            ];
+        }
+
+        $annualSalary = $data['annual_salary'] ?? null;
+        $mealAllowance = $data['meal_allowance'] ?? 200000;
+        $fixedOvertimeHours = $data['fixed_overtime_hours'] ?? null;
+        $breakdown = $this->calculateSalaryBreakdown($annualSalary, $mealAllowance, $fixedOvertimeHours);
+
+        $this->setJsonExtraValue('salary_info', array_merge([
+            'annual_salary' => $annualSalary,
+            'effective_date' => $data['effective_date'] ?? null,
+            'notes' => $data['notes'] ?? null,
+            'fixed_overtime_hours' => $fixedOvertimeHours,
+            'meal_allowance' => $mealAllowance,
+        ], $breakdown, ['history' => $history]));
+    }
+
+    /**
+     * 급여 산정 계산
+     *
+     * 공식: (기본급 + 식대) = 월급여 × 209 / (209 + 고정연장근로시간 × 1.5)
+     */
+    private function calculateSalaryBreakdown(?int $annualSalary, int $mealAllowance, ?int $fixedOvertimeHours): array
+    {
+        $monthlyWorkHours = 209;
+        $overtimeMultiplier = 1.5;
+
+        if (! $annualSalary) {
+            return [
+                'monthly_salary' => null,
+                'base_salary' => null,
+                'fixed_overtime_pay' => null,
+                'hourly_wage' => null,
+                'monthly_work_hours' => $monthlyWorkHours,
+                'overtime_multiplier' => $overtimeMultiplier,
+            ];
+        }
+
+        $monthlySalary = (int) round($annualSalary / 12);
+        $otFactor = ($fixedOvertimeHours ?? 0) * $overtimeMultiplier;
+        $basePlusMeal = (int) round($monthlySalary * $monthlyWorkHours / ($monthlyWorkHours + $otFactor));
+        $baseSalary = $basePlusMeal - $mealAllowance;
+        $hourlyWage = (int) floor($basePlusMeal / $monthlyWorkHours);
+        $fixedOvertimePay = $monthlySalary - $baseSalary - $mealAllowance;
+
+        return [
+            'monthly_salary' => $monthlySalary,
+            'base_salary' => $baseSalary,
+            'fixed_overtime_pay' => $fixedOvertimePay,
+            'hourly_wage' => $hourlyWage,
+            'monthly_work_hours' => $monthlyWorkHours,
+            'overtime_multiplier' => $overtimeMultiplier,
+        ];
+    }
+
+    /**
+     * toArray 시 salary_info 제거 (일반 API 응답에서 연봉 정보 노출 방지)
+     */
+    public function toArray(): array
+    {
+        $array = parent::toArray();
+
+        if (isset($array['json_extra']['salary_info'])) {
+            unset($array['json_extra']['salary_info']);
+        }
+
+        return $array;
+    }
+
     // =========================================================================
     // 스코프
     // =========================================================================

app/Models/HR/Payroll.php

@@ -39,6 +39,7 @@ class Payroll extends Model
         'paid_at',
         'withdrawal_id',
         'note',
+        'options',
         'created_by',
         'updated_by',
         'deleted_by',
@@ -65,6 +66,7 @@ class Payroll extends Model
         'deductions' => 'array',
         'confirmed_at' => 'datetime',
         'paid_at' => 'datetime',
+        'options' => 'array',
     ];
 
     protected $attributes = [
@@ -131,8 +133,12 @@ public function getPeriodLabelAttribute(): string
     // 상태 헬퍼
     // =========================================================================
 
-    public function isEditable(): bool
+    public function isEditable(?bool $isSuperAdmin = null): bool
     {
+        if ($isSuperAdmin && in_array($this->status, [self::STATUS_CONFIRMED, self::STATUS_PAID])) {
+            return true;
+        }
+
         return $this->status === self::STATUS_DRAFT;
     }
 
@@ -156,6 +162,11 @@ public function isDeletable(): bool
         return $this->status === self::STATUS_DRAFT;
     }
 
+    public function isUnpayable(): bool
+    {
+        return $this->status === self::STATUS_PAID;
+    }
+
     // =========================================================================
     // 스코프
     // =========================================================================

app/Models/Interview/InterviewKnowledge.php

@@ -12,6 +12,7 @@ class InterviewKnowledge extends Model
 {
     use BelongsToTenant, ModelTrait, SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'interview_knowledge';
 
     protected $fillable = [

app/Models/Interview/InterviewProject.php

@@ -12,6 +12,8 @@ class InterviewProject extends Model
 {
     use BelongsToTenant, ModelTrait, SoftDeletes;
 
+    protected $connection = 'mysql';
+
     protected $fillable = [
         'tenant_id',
         'company_name',

app/Models/Juil/ConstructionSitePhoto.php

@@ -13,6 +13,7 @@ class ConstructionSitePhoto extends Model
 {
     use BelongsToTenant, SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'construction_site_photos';
 
     protected $fillable = [

app/Models/Juil/ConstructionSitePhotoRow.php

@@ -7,6 +7,7 @@
 
 class ConstructionSitePhotoRow extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'construction_site_photo_rows';
 
     protected $fillable = [

app/Models/Juil/MeetingMinute.php

@@ -13,6 +13,7 @@ class MeetingMinute extends Model
 {
     use BelongsToTenant, SoftDeletes;
 
+    protected $connection = 'codebridge';
     protected $table = 'meeting_minutes';
 
     const STATUS_DRAFT = 'DRAFT';

app/Models/Juil/MeetingMinuteSegment.php

@@ -7,6 +7,7 @@
 
 class MeetingMinuteSegment extends Model
 {
+    protected $connection = 'codebridge';
     protected $table = 'meeting_minute_segments';
 
     protected $fillable = [

app/Models/Juil/PmisArchiveFile.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace App\Models\Juil;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisArchiveFile extends Model
+{
+    use SoftDeletes;
+
+    protected $fillable = [
+        'tenant_id',
+        'folder_id',
+        'title',
+        'original_name',
+        'file_path',
+        'file_type',
+        'file_size',
+        'site_name',
+        'registered_by',
+        'options',
+    ];
+
+    protected $casts = [
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+
+    public function folder(): BelongsTo
+    {
+        return $this->belongsTo(PmisArchiveFolder::class, 'folder_id');
+    }
+
+    public function registeredByUser(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'registered_by');
+    }
+
+    public static function detectFileType(string $extension): string
+    {
+        $ext = strtolower($extension);
+        $imageExts = ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'svg'];
+        $videoExts = ['mp4', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'webm'];
+
+        if (in_array($ext, $imageExts)) {
+            return '사진';
+        }
+        if (in_array($ext, $videoExts)) {
+            return '동영상';
+        }
+
+        return '문서';
+    }
+
+    public static function formatSize(int $bytes): string
+    {
+        if ($bytes >= 1073741824) {
+            return round($bytes / 1073741824, 1).'GB';
+        }
+        if ($bytes >= 1048576) {
+            return round($bytes / 1048576, 1).'MB';
+        }
+        if ($bytes >= 1024) {
+            return round($bytes / 1024, 1).'KB';
+        }
+
+        return $bytes.'B';
+    }
+}

app/Models/Juil/PmisArchiveFolder.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisArchiveFolder extends Model
+{
+    use SoftDeletes;
+
+    protected $fillable = [
+        'tenant_id',
+        'parent_id',
+        'name',
+        'sort_order',
+        'options',
+    ];
+
+    protected $casts = [
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+
+    public function children(): HasMany
+    {
+        return $this->hasMany(self::class, 'parent_id')->orderBy('sort_order');
+    }
+
+    public function files(): HasMany
+    {
+        return $this->hasMany(PmisArchiveFile::class, 'folder_id');
+    }
+
+    public function allDescendantIds(): array
+    {
+        $ids = [$this->id];
+        foreach ($this->children as $child) {
+            $ids = array_merge($ids, $child->allDescendantIds());
+        }
+
+        return $ids;
+    }
+}

app/Models/Juil/PmisAttendanceEquipment.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisAttendanceEquipment extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_attendance_equipments';
+
+    protected $fillable = [
+        'tenant_id',
+        'attendance_id',
+        'equipment_name',
+        'specification',
+        'equipment_number',
+        'operator',
+        'man_days',
+        'work_content',
+        'sort_order',
+        'options',
+    ];
+
+    protected $casts = [
+        'man_days' => 'decimal:1',
+        'options' => 'array',
+    ];
+
+    public function attendance(): BelongsTo
+    {
+        return $this->belongsTo(PmisDailyAttendance::class, 'attendance_id');
+    }
+}

app/Models/Juil/PmisAttendanceWorker.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisAttendanceWorker extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_attendance_workers';
+
+    protected $fillable = [
+        'tenant_id',
+        'attendance_id',
+        'work_type',
+        'job_type',
+        'name',
+        'man_days',
+        'amount',
+        'work_content',
+        'sort_order',
+        'options',
+    ];
+
+    protected $casts = [
+        'man_days' => 'decimal:1',
+        'amount' => 'integer',
+        'options' => 'array',
+    ];
+
+    public function attendance(): BelongsTo
+    {
+        return $this->belongsTo(PmisDailyAttendance::class, 'attendance_id');
+    }
+}

app/Models/Juil/PmisConstructionWorker.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisConstructionWorker extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_construction_workers';
+
+    protected $fillable = [
+        'tenant_id',
+        'company_name',
+        'trade_name',
+        'job_type_id',
+        'name',
+        'phone',
+        'birth_date',
+        'ssn_gender',
+        'wage',
+        'blood_type',
+        'remark',
+        'options',
+    ];
+
+    protected $casts = [
+        'wage' => 'integer',
+        'options' => 'array',
+    ];
+
+    public function jobType(): BelongsTo
+    {
+        return $this->belongsTo(PmisJobType::class, 'job_type_id');
+    }
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+}

app/Models/Juil/PmisDailyAttendance.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisDailyAttendance extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_daily_attendances';
+
+    protected $fillable = [
+        'tenant_id',
+        'date',
+        'company_name',
+        'weather',
+        'status',
+        'notes',
+        'options',
+    ];
+
+    protected $casts = [
+        'date' => 'date',
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+
+    public function workers(): HasMany
+    {
+        return $this->hasMany(PmisAttendanceWorker::class, 'attendance_id')->orderBy('sort_order');
+    }
+
+    public function equipments(): HasMany
+    {
+        return $this->hasMany(PmisAttendanceEquipment::class, 'attendance_id')->orderBy('sort_order');
+    }
+}

app/Models/Juil/PmisDailyWorkReport.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisDailyWorkReport extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_daily_work_reports';
+
+    protected $fillable = [
+        'tenant_id',
+        'date',
+        'company_name',
+        'weather',
+        'temp_low',
+        'temp_high',
+        'precipitation',
+        'snowfall',
+        'fine_dust',
+        'ultra_fine_dust',
+        'work_content_today',
+        'work_content_tomorrow',
+        'notes',
+        'status',
+        'options',
+    ];
+
+    protected $casts = [
+        'date' => 'date',
+        'temp_low' => 'decimal:1',
+        'temp_high' => 'decimal:1',
+        'precipitation' => 'decimal:1',
+        'snowfall' => 'decimal:1',
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+
+    public function workers(): HasMany
+    {
+        return $this->hasMany(PmisWorkReportWorker::class, 'report_id')->orderBy('sort_order');
+    }
+
+    public function equipments(): HasMany
+    {
+        return $this->hasMany(PmisWorkReportEquipment::class, 'report_id')->orderBy('sort_order');
+    }
+
+    public function materials(): HasMany
+    {
+        return $this->hasMany(PmisWorkReportMaterial::class, 'report_id')->orderBy('sort_order');
+    }
+
+    public function volumes(): HasMany
+    {
+        return $this->hasMany(PmisWorkReportVolume::class, 'report_id')->orderBy('sort_order');
+    }
+
+    public function photos(): HasMany
+    {
+        return $this->hasMany(PmisWorkReportPhoto::class, 'report_id')->orderBy('sort_order');
+    }
+}

app/Models/Juil/PmisEquipment.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisEquipment extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_equipments';
+
+    protected $fillable = [
+        'tenant_id',
+        'company_name',
+        'equipment_code',
+        'equipment_name',
+        'specification',
+        'unit',
+        'equipment_number',
+        'operator',
+        'inspection_end_date',
+        'inspection_not_applicable',
+        'insurance_end_date',
+        'insurance_not_applicable',
+        'options',
+    ];
+
+    protected $casts = [
+        'inspection_end_date' => 'date',
+        'inspection_not_applicable' => 'boolean',
+        'insurance_end_date' => 'date',
+        'insurance_not_applicable' => 'boolean',
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+}

app/Models/Juil/PmisJobType.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisJobType extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'pmis_job_types';
+
+    protected $fillable = [
+        'tenant_id',
+        'name',
+        'sort_order',
+        'is_active',
+        'options',
+    ];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+}

app/Models/Juil/PmisManual.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Models\Juil;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class PmisManual extends Model
+{
+    use SoftDeletes;
+
+    protected $fillable = [
+        'tenant_id',
+        'title',
+        'content',
+        'tags',
+        'author_id',
+        'views',
+        'options',
+    ];
+
+    protected $casts = [
+        'options' => 'array',
+    ];
+
+    public function scopeTenant($query, $tenantId)
+    {
+        return $query->where('tenant_id', $tenantId);
+    }
+
+    public function author(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'author_id');
+    }
+
+    public function attachments(): HasMany
+    {
+        return $this->hasMany(PmisManualAttachment::class, 'manual_id');
+    }
+}

app/Models/Juil/PmisManualAttachment.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Models\Juil;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class PmisManualAttachment extends Model
+{
+    protected $fillable = [
+        'manual_id',
+        'original_name',
+        'file_path',
+        'file_size',
+    ];
+
+    public function manual(): BelongsTo
+    {
+        return $this->belongsTo(PmisManual::class, 'manual_id');
+    }
+
+    public static function formatSize(int $bytes): string
+    {
+        if ($bytes >= 1073741824) {
+            return round($bytes / 1073741824, 1).' G';
+        }
+        if ($bytes >= 1048576) {
+            return round($bytes / 1048576, 1).' M';
+        }
+        if ($bytes >= 1024) {
+            return round($bytes / 1024, 1).' K';
+        }
+
+        return $bytes.' B';
+    }
+}