feat: 공통 모듈 추가 (엑셀 내보내기, 계정과목 일괄변경)

Phase 0 - 공통 모듈:
- ExportService.php 생성 (Maatwebsite/Excel 기반 엑셀 내보내기)
- BulkUpdateAccountCodeRequest.php 생성 (계정과목 일괄변경 유효성 검사)

Phase 1 - 계정과목 일괄변경:
- WithdrawalController/Service: bulkUpdateAccountCode 메서드 추가
- DepositController/Service: bulkUpdateAccountCode 메서드 추가
- POST /v1/withdrawals/bulk-update-account-code
- POST /v1/deposits/bulk-update-account-code

Phase 2 - 엑셀 내보내기:
- AttendanceController/Service: export, getExportData 메서드 추가
- SalaryController/Service: export, getExportData 메서드 추가
- GET /v1/attendances/export
- GET /v1/salaries/export

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

app/Http/Controllers/Api/V1/AttendanceController.php

@@ -11,12 +11,17 @@
 use App\Http\Requests\Attendance\StoreRequest;
 use App\Http\Requests\Attendance\UpdateRequest;
 use App\Services\AttendanceService;
+use App\Services\ExportService;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\BinaryFileResponse;
 
 class AttendanceController extends Controller
 {
-    public function __construct(private AttendanceService $service) {}
+    public function __construct(
+        private AttendanceService $service,
+        private ExportService $exportService
+    ) {}
 
     /**
      * 근태 목록 조회
@@ -121,4 +126,32 @@ public function monthlyStats(MonthlyStatsRequest $request): JsonResponse
             return $this->service->monthlyStats($request->validated());
         }, __('message.fetched'));
     }
+
+    /**
+     * 근태 엑셀 내보내기
+     * GET /v1/attendances/export
+     */
+    public function export(Request $request): BinaryFileResponse
+    {
+        $params = $request->only([
+            'user_id',
+            'date',
+            'date_from',
+            'date_to',
+            'status',
+            'department_id',
+            'sort_by',
+            'sort_dir',
+        ]);
+
+        $exportData = $this->service->getExportData($params);
+        $filename = '근태현황_'.date('Ymd_His');
+
+        return $this->exportService->download(
+            $exportData['data'],
+            $exportData['headings'],
+            $filename,
+            '근태현황'
+        );
+    }
 }

app/Http/Controllers/Api/V1/DepositController.php

@@ -4,6 +4,7 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\BulkUpdateAccountCodeRequest;
 use App\Http\Requests\V1\Deposit\StoreDepositRequest;
 use App\Http\Requests\V1\Deposit\UpdateDepositRequest;
 use App\Services\DepositService;
@@ -94,4 +95,20 @@ public function summary(Request $request)
 
         return ApiResponse::success($summary, __('message.fetched'));
     }
+
+    /**
+     * 계정과목 일괄 변경
+     */
+    public function bulkUpdateAccountCode(BulkUpdateAccountCodeRequest $request)
+    {
+        $updatedCount = $this->service->bulkUpdateAccountCode(
+            $request->getIds(),
+            $request->getAccountCode()
+        );
+
+        return ApiResponse::success(
+            ['updated_count' => $updatedCount],
+            __('message.bulk_updated')
+        );
+    }
 }

app/Http/Controllers/Api/V1/SalaryController.php

@@ -7,13 +7,16 @@
 use App\Http\Requests\V1\Salary\BulkUpdateStatusRequest;
 use App\Http\Requests\V1\Salary\StoreSalaryRequest;
 use App\Http\Requests\V1\Salary\UpdateSalaryRequest;
+use App\Services\ExportService;
 use App\Services\SalaryService;
 use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\BinaryFileResponse;
 
 class SalaryController extends Controller
 {
     public function __construct(
-        private readonly SalaryService $service
+        private readonly SalaryService $service,
+        private readonly ExportService $exportService
     ) {}
 
     /**
@@ -123,4 +126,33 @@ public function statistics(Request $request)
 
         return ApiResponse::success($stats, __('message.fetched'));
     }
+
+    /**
+     * 급여 엑셀 내보내기
+     * GET /v1/salaries/export
+     */
+    public function export(Request $request): BinaryFileResponse
+    {
+        $params = $request->only([
+            'search',
+            'year',
+            'month',
+            'status',
+            'employee_id',
+            'start_date',
+            'end_date',
+            'sort_by',
+            'sort_dir',
+        ]);
+
+        $exportData = $this->service->getExportData($params);
+        $filename = '급여현황_'.date('Ymd_His');
+
+        return $this->exportService->download(
+            $exportData['data'],
+            $exportData['headings'],
+            $filename,
+            '급여현황'
+        );
+    }
 }

app/Http/Controllers/Api/V1/WithdrawalController.php

@@ -4,6 +4,7 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\BulkUpdateAccountCodeRequest;
 use App\Http\Requests\V1\Withdrawal\StoreWithdrawalRequest;
 use App\Http\Requests\V1\Withdrawal\UpdateWithdrawalRequest;
 use App\Services\WithdrawalService;
@@ -94,4 +95,20 @@ public function summary(Request $request)
 
         return ApiResponse::success($summary, __('message.fetched'));
     }
+
+    /**
+     * 계정과목 일괄 변경
+     */
+    public function bulkUpdateAccountCode(BulkUpdateAccountCodeRequest $request)
+    {
+        $updatedCount = $this->service->bulkUpdateAccountCode(
+            $request->getIds(),
+            $request->getAccountCode()
+        );
+
+        return ApiResponse::success(
+            ['updated_count' => $updatedCount],
+            __('message.bulk_updated')
+        );
+    }
 }