feat: ItemMaster Phase 1 API 구현 (핵심 기능 13개 엔드포인트)

- Controller 4개 생성 (ItemMaster, ItemPage, ItemSection, ItemField)
- Service 4개 생성 (비즈니스 로직 및 Multi-tenant 지원)
- FormRequest 7개 생성 (Validation)
- Routes 등록 (/v1/item-master/*)

주요 API:
- GET /init - 전체 초기 데이터 로드
- 페이지 관리 (GET/POST/PUT/DELETE)
- 섹션 관리 (POST/PUT/DELETE/reorder)
- 필드 관리 (POST/PUT/DELETE/reorder)

기술적 특징:
- Service-First 패턴 (Controller는 DI + ApiResponse만)
- Multi-tenant 지원 (tenantId() 검증 + BelongsToTenant)
- Cascade Soft Delete (하위 엔티티 자동 처리)
- i18n 메시지 키 사용 (__('message.xxx'))
- order_no 자동 계산 및 reorder 지원

검증:
- 라우트 테스트: 13개 엔드포인트 정상 등록
- Pint 검사: 15 files PASS

SAM API Development Rules 준수

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

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\ItemMaster;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\ItemMaster\ItemFieldStoreRequest;
+use App\Http\Requests\ItemMaster\ItemFieldUpdateRequest;
+use App\Http\Requests\ItemMaster\ReorderRequest;
+use App\Services\ItemMaster\ItemFieldService;
+
+class ItemFieldController extends Controller
+{
+    public function __construct(private ItemFieldService $service) {}
+
+    /**
+     * 필드 생성
+     *
+     * POST /api/v1/item-master/sections/{sectionId}/fields
+     */
+    public function store(int $sectionId, ItemFieldStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($sectionId, $request) {
+            return $this->service->store($sectionId, $request->validated());
+        }, __('message.created'));
+    }
+
+    /**
+     * 필드 수정
+     *
+     * PUT /api/v1/item-master/fields/{id}
+     */
+    public function update(int $id, ItemFieldUpdateRequest $request)
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 필드 삭제 (Soft Delete)
+     *
+     * DELETE /api/v1/item-master/fields/{id}
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.deleted'));
+    }
+
+    /**
+     * 필드 순서 변경
+     *
+     * PUT /api/v1/item-master/sections/{sectionId}/fields/reorder
+     */
+    public function reorder(int $sectionId, ReorderRequest $request)
+    {
+        return ApiResponse::handle(function () use ($sectionId, $request) {
+            $this->service->reorder($sectionId, $request->validated()['items']);
+
+            return 'success';
+        }, __('message.reordered'));
+    }
+}

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

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\ItemMaster;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Services\ItemMaster\ItemMasterService;
+
+class ItemMasterController extends Controller
+{
+    public function __construct(private ItemMasterService $service) {}
+
+    /**
+     * 초기화 API - 전체 데이터 로드
+     *
+     * GET /api/v1/item-master/init
+     */
+    public function init()
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->init();
+        }, __('message.fetched'));
+    }
+}

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

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\ItemMaster;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\ItemMaster\ItemPageStoreRequest;
+use App\Http\Requests\ItemMaster\ItemPageUpdateRequest;
+use App\Services\ItemMaster\ItemPageService;
+use Illuminate\Http\Request;
+
+class ItemPageController extends Controller
+{
+    public function __construct(private ItemPageService $service) {}
+
+    /**
+     * 페이지 목록 조회 (섹션/필드 중첩 포함)
+     *
+     * GET /api/v1/item-master/pages?item_type=FG
+     */
+    public function index(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $itemType = $request->input('item_type');
+
+            return $this->service->index($itemType);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 페이지 생성
+     *
+     * POST /api/v1/item-master/pages
+     */
+    public function store(ItemPageStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.created'));
+    }
+
+    /**
+     * 페이지 수정
+     *
+     * PUT /api/v1/item-master/pages/{id}
+     */
+    public function update(int $id, ItemPageUpdateRequest $request)
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 페이지 삭제 (Soft Delete)
+     *
+     * DELETE /api/v1/item-master/pages/{id}
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.deleted'));
+    }
+}

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

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\ItemMaster;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\ItemMaster\ItemSectionStoreRequest;
+use App\Http\Requests\ItemMaster\ItemSectionUpdateRequest;
+use App\Http\Requests\ItemMaster\ReorderRequest;
+use App\Services\ItemMaster\ItemSectionService;
+
+class ItemSectionController extends Controller
+{
+    public function __construct(private ItemSectionService $service) {}
+
+    /**
+     * 섹션 생성
+     *
+     * POST /api/v1/item-master/pages/{pageId}/sections
+     */
+    public function store(int $pageId, ItemSectionStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($pageId, $request) {
+            return $this->service->store($pageId, $request->validated());
+        }, __('message.created'));
+    }
+
+    /**
+     * 섹션 수정
+     *
+     * PUT /api/v1/item-master/sections/{id}
+     */
+    public function update(int $id, ItemSectionUpdateRequest $request)
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 섹션 삭제 (Soft Delete)
+     *
+     * DELETE /api/v1/item-master/sections/{id}
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.deleted'));
+    }
+
+    /**
+     * 섹션 순서 변경
+     *
+     * PUT /api/v1/item-master/pages/{pageId}/sections/reorder
+     */
+    public function reorder(int $pageId, ReorderRequest $request)
+    {
+        return ApiResponse::handle(function () use ($pageId, $request) {
+            $this->service->reorder($pageId, $request->validated()['items']);
+
+            return 'success';
+        }, __('message.reordered'));
+    }
+}