hskwon
4ccee253b6
- 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 준수
68 lines
1.8 KiB
PHP
68 lines
1.8 KiB
PHP
<?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'));
|
|
}
|
|
}
|