feat: ItemMaster Phase 3 API 구현 (부가 기능 8개 엔드포인트)

- Controller 2개, Service 2개, FormRequest 3개 생성
- Routes 등록 (커스텀 탭, 단위 옵션)
- Service-First, Multi-tenant, Soft Delete
- 라우트 테스트 및 Pint 검사 통과
- ItemMaster API 전체 32개 엔드포인트 구현 완료

9 files changed, 467 insertions(+)

app/Http/Controllers/Api/V1/ItemMaster/CustomTabController.php

@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\ItemMaster;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\ItemMaster\CustomTabStoreRequest;
+use App\Http\Requests\ItemMaster\CustomTabUpdateRequest;
+use App\Http\Requests\ItemMaster\ReorderRequest;
+use App\Http\Responses\ApiResponse;
+use App\Services\ItemMaster\CustomTabService;
+
+class CustomTabController extends Controller
+{
+    public function __construct(
+        protected CustomTabService $service,
+    ) {}
+
+    /**
+     * 커스텀 탭 목록
+     */
+    public function index()
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->index();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 커스텀 탭 생성
+     */
+    public function store(CustomTabStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.created'));
+    }
+
+    /**
+     * 커스텀 탭 수정
+     */
+    public function update(int $id, CustomTabUpdateRequest $request)
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 커스텀 탭 삭제
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.deleted'));
+    }
+
+    /**
+     * 커스텀 탭 순서 변경
+     */
+    public function reorder(ReorderRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $this->service->reorder($request->validated()['items']);
+
+            return 'success';
+        }, __('message.reordered'));
+    }
+}

app/Http/Controllers/Api/V1/ItemMaster/UnitOptionController.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\ItemMaster;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\ItemMaster\UnitOptionStoreRequest;
+use App\Http\Responses\ApiResponse;
+use App\Services\ItemMaster\UnitOptionService;
+
+class UnitOptionController extends Controller
+{
+    public function __construct(
+        protected UnitOptionService $service,
+    ) {}
+
+    /**
+     * 단위 옵션 목록
+     */
+    public function index()
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->index();
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 단위 옵션 생성
+     */
+    public function store(UnitOptionStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.created'));
+    }
+
+    /**
+     * 단위 옵션 삭제
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.deleted'));
+    }
+}

app/Http/Requests/ItemMaster/CustomTabStoreRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests\ItemMaster;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class CustomTabStoreRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'label' => 'required|string|max:255',
+            'icon' => 'nullable|string|max:100',
+            'is_default' => 'nullable|boolean',
+        ];
+    }
+}

app/Http/Requests/ItemMaster/CustomTabUpdateRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests\ItemMaster;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class CustomTabUpdateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'label' => 'sometimes|string|max:255',
+            'icon' => 'sometimes|nullable|string|max:100',
+            'is_default' => 'sometimes|nullable|boolean',
+        ];
+    }
+}

app/Http/Requests/ItemMaster/UnitOptionStoreRequest.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Http\Requests\ItemMaster;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UnitOptionStoreRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'label' => 'required|string|max:100',
+            'value' => 'required|string|max:50',
+        ];
+    }
+}