Files
sam-api/app/Http/Controllers/Api/V1/ItemsController.php
권혁성 f640a837e9 feat:경동기업 견적/수주 전환 로직 개선
- KyungdongFormulaHandler: 수식 계산 로직 리팩토링 및 확장
- OrderService: 수주 전환 시 BOM 품목 매핑 로직 추가
- QuoteService: 견적 상태 처리 개선
- FormulaEvaluatorService: 디버그 로깅 추가
- Quote 모델: 캐스팅 타입 수정

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-05 21:58:49 +09:00

181 lines
6.3 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\Item\ItemBatchDeleteRequest;
use App\Http\Requests\Item\ItemStoreRequest;
use App\Http\Requests\Item\ItemUpdateRequest;
use App\Services\ItemService;
use Illuminate\Http\Request;
class ItemsController extends Controller
{
public function __construct(private ItemService $service) {}
/**
* 통합 품목 목록 조회 (items 테이블)
*
* GET /api/v1/items
*/
public function index(Request $request)
{
return ApiResponse::handle(function () use ($request) {
$params = [
'size' => $request->input('size', 20),
'q' => $request->input('q') ?? $request->input('search'),
'category_id' => $request->input('category_id'),
'item_type' => $request->input('type') ?? $request->input('item_type'),
'item_category' => $request->input('item_category'),
'group_id' => $request->input('group_id'),
'active' => $request->input('is_active') ?? $request->input('active'),
'has_bom' => $request->input('has_bom'),
'exclude_process_id' => $request->input('exclude_process_id'),
];
return $this->service->index($params);
}, __('message.fetched'));
}
/**
* 단일 품목 조회 (동적 테이블 라우팅)
*
* GET /api/v1/items/{id}?type=FG&include_price=true&client_id=1&price_date=2025-01-10
*
* @param string|null type 품목 유형 (선택적 - 없으면 ID만으로 조회)
*/
public function show(Request $request, $id)
{
$id = (int) $id;
return ApiResponse::handle(function () use ($request, $id) {
// item_type 선택적 (없으면 ID만으로 items 테이블에서 조회)
$itemType = $request->input('type') ?? $request->input('item_type');
$itemType = $itemType ? strtoupper($itemType) : null;
$includePrice = filter_var($request->input('include_price', false), FILTER_VALIDATE_BOOLEAN);
if ($includePrice) {
$clientId = $request->input('client_id') ? (int) $request->input('client_id') : null;
$priceDate = $request->input('price_date');
return $this->service->showWithPrice($id, $itemType, $clientId, $priceDate);
}
return $this->service->show($id, $itemType);
}, __('message.fetched'));
}
/**
* 품목 상세 조회 (동적 테이블 라우팅, code 기반, BOM 포함 옵션)
*
* GET /api/v1/items/code/{code}?type=FG&include_bom=true
*
* @param string type 품목 유형 (필수 - 동적 테이블 라우팅)
*/
public function showByCode(Request $request, string $code)
{
return ApiResponse::handle(function () use ($request, $code) {
// 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);
}, __('message.item.fetched'));
}
/**
* 품목 생성
*
* POST /api/v1/items
*/
public function store(ItemStoreRequest $request)
{
return ApiResponse::handle(function () use ($request) {
// Request는 product_type 검증, Service는 item_type 사용
$data = $request->all();
if (isset($data['product_type'])) {
$data['item_type'] = $data['product_type'];
unset($data['product_type']);
}
return $this->service->store($data);
}, __('message.item.created'));
}
/**
* 품목 수정
*
* PUT /api/v1/items/{id}
*/
public function update(int $id, ItemUpdateRequest $request)
{
return ApiResponse::handle(function () use ($id, $request) {
// Request는 product_type 검증, Service는 item_type 사용
$data = $request->all();
if (isset($data['product_type'])) {
$data['item_type'] = $data['product_type'];
unset($data['product_type']);
}
return $this->service->update($id, $data);
}, __('message.item.updated'));
}
/**
* 품목 통계 조회
*
* GET /api/v1/items/stats
*/
public function stats(Request $request)
{
return ApiResponse::handle(function () use ($request) {
$params = [
'item_type' => $request->input('type') ?? $request->input('item_type'),
'group_id' => $request->input('group_id'),
];
return $this->service->stats($params);
}, __('message.fetched'));
}
/**
* 품목 삭제 (동적 테이블 라우팅, Soft Delete)
*
* DELETE /api/v1/items/{id}?type=FG
*
* @param string type 품목 유형 (필수 - 동적 테이블 라우팅)
*/
public function destroy(Request $request, $id)
{
$id = (int) $id;
return ApiResponse::handle(function () use ($request, $id) {
// item_type 필수 (동적 테이블 라우팅에 사용)
$itemType = strtoupper($request->input('type') ?? $request->input('item_type') ?? '');
$this->service->destroy($id, $itemType);
return 'success';
}, __('message.item.deleted'));
}
/**
* 품목 일괄 삭제 (동적 테이블 라우팅, Soft Delete)
*
* DELETE /api/v1/items/batch?item_type=FG
*
* @param string item_type 품목 유형 (필수 - 동적 테이블 라우팅)
*/
public function batchDestroy(ItemBatchDeleteRequest $request)
{
return ApiResponse::handle(function () use ($request) {
$validated = $request->validated();
// item_type 필수 (동적 테이블 라우팅에 사용)
$itemType = strtoupper($validated['item_type'] ?? '');
$deletedCount = $this->service->batchDestroy($validated['ids'], $itemType);
return ['deleted_count' => $deletedCount];
}, __('message.item.batch_deleted'));
}
}