SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(api): Items API 멀티 item_type 지원 및 파라미터 일관성 개선

Browse Source 
- ItemService: 콤마 구분 멀티 item_type 지원 (예: type=FG,PT)
  - parseItemTypes(): 콤마 구분 문자열을 배열로 파싱
  - validateItemTypesInSameGroup(): 같은 group_id 검증
  - index(), search() 메서드에 멀티 타입 로직 적용

- ItemsController: type/item_type 파라미터 일관성
  - show(), showByCode(), destroy() 메서드에서 type 파라미터 지원
  - 모든 엔드포인트에서 type 또는 item_type 둘 다 허용

- ItemBatchDeleteRequest: prepareForValidation()으로 type→item_type 매핑

- i18n: item_types_must_be_same_group 에러 메시지 추가 (ko/en)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
권혁성
2025-12-21 01:10:38 +09:00
parent 496aec04f5
commit 65c5de2db1
5 changed files with 104 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
app/Http/Controllers/Api/V1/ItemsController.php
View File

@@ -38,15 +38,15 @@ public function index(Request $request)
/**
* 단일 품목 조회 (동적 테이블 라우팅)
*
* GET /api/v1/items/{id}?item_type=FG&include_price=true&client_id=1&price_date=2025-01-10
* GET /api/v1/items/{id}?type=FG&include_price=true&client_id=1&price_date=2025-01-10
*
* @param string|null item_type 품목 유형 (선택적 - 없으면 ID만으로 조회)
* @param string|null type 품목 유형 (선택적 - 없으면 ID만으로 조회)
*/
public function show(Request $request, int $id)
{
return ApiResponse::handle(function () use ($request, $id) {
// item_type 선택적 (없으면 ID만으로 items 테이블에서 조회)
$itemType = $request->input('item_type');
$itemType = $request->input('type') ?? $request->input('item_type');
$itemType = $itemType ? strtoupper($itemType) : null;
$includePrice = filter_var($request->input('include_price', false), FILTER_VALIDATE_BOOLEAN);
@@ -64,15 +64,15 @@ public function show(Request $request, int $id)
/**
* 품목 상세 조회 (동적 테이블 라우팅, code 기반, BOM 포함 옵션)
*
* GET /api/v1/items/code/{code}?item_type=FG&include_bom=true
* GET /api/v1/items/code/{code}?type=FG&include_bom=true
*
* @param string item_type 품목 유형 (필수 - 동적 테이블 라우팅)
* @param string type 품목 유형 (필수 - 동적 테이블 라우팅)
*/
public function showByCode(Request $request, string $code)
{
return ApiResponse::handle(function () use ($request, $code) {
// item_type 필수 (동적 테이블 라우팅에 사용)
$itemType = strtoupper($request->input('item_type', ''));
$itemType = strtoupper($request->input('type') ?? $request->input('item_type') ?? '');
$includeBom = filter_var($request->input('include_bom', false), FILTER_VALIDATE_BOOLEAN);
return $this->service->showByCode($code, $itemType, $includeBom);
@@ -106,15 +106,15 @@ public function update(int $id, ItemUpdateRequest $request)
/**
* 품목 삭제 (동적 테이블 라우팅, Soft Delete)
*
* DELETE /api/v1/items/{id}?item_type=FG
* DELETE /api/v1/items/{id}?type=FG
*
* @param string item_type 품목 유형 (필수 - 동적 테이블 라우팅)
* @param string type 품목 유형 (필수 - 동적 테이블 라우팅)
*/
public function destroy(Request $request, int $id)
{
return ApiResponse::handle(function () use ($request, $id) {
// item_type 필수 (동적 테이블 라우팅에 사용)
$itemType = strtoupper($request->input('item_type', ''));
$itemType = strtoupper($request->input('type') ?? $request->input('item_type') ?? '');
$this->service->destroy($id, $itemType);
return 'success';