fix(API): Controller 타입 및 코드 정리

- FcmController, EstimateController, ItemsController 개선
- LoanController, PositionController 수정
- ReceivablesController, SalaryController 수정
- StructureReviewController 수정

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

app/Http/Controllers/Api/V1/Construction/HandoverReportController.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Construction;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Construction\HandoverReportStoreRequest;
+use App\Http\Requests\Construction\HandoverReportUpdateRequest;
+use App\Services\Construction\HandoverReportService;
+use Illuminate\Http\Request;
+
+class HandoverReportController extends Controller
+{
+    public function __construct(private HandoverReportService $service) {}
+
+    /**
+     * 인수인계보고서 목록 조회
+     */
+    public function index(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->index($request->all());
+        }, __('message.handover_report.fetched'));
+    }
+
+    /**
+     * 인수인계보고서 상세 조회
+     */
+    public function show(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->show($id);
+        }, __('message.handover_report.fetched'));
+    }
+
+    /**
+     * 인수인계보고서 등록
+     */
+    public function store(HandoverReportStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.handover_report.created'));
+    }
+
+    /**
+     * 인수인계보고서 수정
+     */
+    public function update(HandoverReportUpdateRequest $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.handover_report.updated'));
+    }
+
+    /**
+     * 인수인계보고서 삭제
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.handover_report.deleted'));
+    }
+
+    /**
+     * 인수인계보고서 일괄 삭제
+     */
+    public function bulkDestroy(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $this->service->bulkDestroy($request->input('ids', []));
+
+            return 'success';
+        }, __('message.handover_report.deleted'));
+    }
+
+    /**
+     * 인수인계보고서 통계 조회
+     */
+    public function stats(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->stats($request->all());
+        }, __('message.handover_report.fetched'));
+    }
+}

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

@@ -27,6 +27,15 @@ public function index(Request $request)
         ], __('message.fetched'));
     }
 
+    public function stats()
+    {
+        $stats = $this->estimateService->stats();
+
+        return ApiResponse::success([
+            'stats' => $stats,
+        ], __('message.fetched'));
+    }
+
     public function show($id)
     {
         $estimate = $this->estimateService->getEstimateDetail($id);

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

@@ -103,6 +103,23 @@ public function update(int $id, ItemUpdateRequest $request)
         }, __('message.item.updated'));
     }
 
+    /**
+     * 품목 통계 조회
+     *
+     * GET /api/v1/items/stats
+     */
+    public function stats(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $params = [
+                'item_type' => $request->input('type') ?? $request->input('item_type'),
+                'group_id' => $request->input('group_id'),
+            ];
+
+            return $this->service->stats($params);
+        }, __('message.fetched'));
+    }
+
     /**
      * 품목 삭제 (동적 테이블 라우팅, Soft Delete)
      *

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

@@ -2,13 +2,13 @@
 
 namespace App\Http\Controllers\Api\V1;
 
+use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
 use App\Http\Requests\Loan\LoanCalculateInterestRequest;
 use App\Http\Requests\Loan\LoanIndexRequest;
 use App\Http\Requests\Loan\LoanSettleRequest;
 use App\Http\Requests\Loan\LoanStoreRequest;
 use App\Http\Requests\Loan\LoanUpdateRequest;
-use App\Helpers\ApiResponse;
 use App\Services\LoanService;
 use Illuminate\Http\JsonResponse;
 

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

@@ -0,0 +1,113 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\SiteBriefing\StoreSiteBriefingRequest;
+use App\Http\Requests\SiteBriefing\UpdateSiteBriefingRequest;
+use App\Services\SiteBriefingService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+/**
+ * 현장설명회 관리 컨트롤러
+ */
+class SiteBriefingController extends Controller
+{
+    public function __construct(
+        private readonly SiteBriefingService $service
+    ) {}
+
+    /**
+     * 현장설명회 목록 조회
+     */
+    public function index(Request $request): JsonResponse
+    {
+        $params = $request->only([
+            'search',
+            'status',
+            'bid_status',
+            'partner_id',
+            'site_id',
+            'start_date',
+            'end_date',
+            'sort_by',
+            'sort_dir',
+            'page',
+            'per_page',
+        ]);
+
+        $result = $this->service->index($params);
+
+        return ApiResponse::success($result, __('message.fetched'));
+    }
+
+    /**
+     * 현장설명회 상세 조회
+     */
+    public function show(int $id): JsonResponse
+    {
+        $siteBriefing = $this->service->show($id);
+
+        return ApiResponse::success($siteBriefing, __('message.fetched'));
+    }
+
+    /**
+     * 현장설명회 등록
+     */
+    public function store(StoreSiteBriefingRequest $request): JsonResponse
+    {
+        $siteBriefing = $this->service->store($request->validated());
+
+        return ApiResponse::success($siteBriefing, __('message.created'), [], 201);
+    }
+
+    /**
+     * 현장설명회 수정
+     */
+    public function update(UpdateSiteBriefingRequest $request, int $id): JsonResponse
+    {
+        $siteBriefing = $this->service->update($id, $request->validated());
+
+        return ApiResponse::success($siteBriefing, __('message.updated'));
+    }
+
+    /**
+     * 현장설명회 삭제
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::success(null, __('message.deleted'));
+    }
+
+    /**
+     * 현장설명회 일괄 삭제
+     */
+    public function bulkDestroy(Request $request): JsonResponse
+    {
+        $request->validate([
+            'ids' => 'required|array|min:1',
+            'ids.*' => 'integer',
+        ]);
+
+        $deletedCount = $this->service->bulkDestroy($request->input('ids'));
+
+        return ApiResponse::success(
+            ['deleted_count' => $deletedCount],
+            __('message.bulk_deleted')
+        );
+    }
+
+    /**
+     * 현장설명회 통계 조회
+     */
+    public function stats(): JsonResponse
+    {
+        $stats = $this->service->stats();
+
+        return ApiResponse::success($stats, __('message.fetched'));
+    }
+}