feat: Phase 6.2 팝업관리 API 구현

- popups 테이블 마이그레이션 생성 - Popup 모델 (BelongsToTenant, SoftDeletes) - PopupService CRUD 구현 - FormRequest 검증 (Store/Update) - PopupController 6개 엔드포인트 - Swagger 문서 (PopupApi.php) - PROJECT_DEVELOPMENT_POLICY.md 정책 준수
2025-12-19 16:14:04 +09:00
parent ac551d2c30
commit 8f1292f7c4
10 changed files with 926 additions and 2 deletions
--- a/app/Http/Controllers/Api/V1/PopupController.php
+++ b/app/Http/Controllers/Api/V1/PopupController.php
@@ -0,0 +1,89 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\Popup\StorePopupRequest;
+use App\Http\Requests\V1\Popup\UpdatePopupRequest;
+use App\Services\PopupService;
+use Illuminate\Http\Request;
+
+class PopupController extends Controller
+{
+    public function __construct(
+        private readonly PopupService $service
+    ) {}
+
+    /**
+     * 팝업 목록 (관리자용)
+     */
+    public function index(Request $request)
+    {
+        $params = $request->only([
+            'target_type',
+            'status',
+            'search',
+            'sort_by',
+            'sort_dir',
+            'per_page',
+            'page',
+        ]);
+
+        $popups = $this->service->index($params);
+
+        return ApiResponse::success($popups, __('message.fetched'));
+    }
+
+    /**
+     * 활성 팝업 목록 (사용자용)
+     */
+    public function active(Request $request)
+    {
+        $departmentId = $request->input('department_id');
+
+        $popups = $this->service->getActivePopups($departmentId);
+
+        return ApiResponse::success($popups, __('message.fetched'));
+    }
+
+    /**
+     * 팝업 등록
+     */
+    public function store(StorePopupRequest $request)
+    {
+        $popup = $this->service->store($request->validated());
+
+        return ApiResponse::success($popup, __('message.created'), [], 201);
+    }
+
+    /**
+     * 팝업 상세
+     */
+    public function show(int $id)
+    {
+        $popup = $this->service->show($id);
+
+        return ApiResponse::success($popup, __('message.fetched'));
+    }
+
+    /**
+     * 팝업 수정
+     */
+    public function update(int $id, UpdatePopupRequest $request)
+    {
+        $popup = $this->service->update($id, $request->validated());
+
+        return ApiResponse::success($popup, __('message.updated'));
+    }
+
+    /**
+     * 팝업 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::success(null, __('message.deleted'));
+    }
+}