sam-api/app/Http/Controllers/Api/V1/ItemsController.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\ItemsService;
use Illuminate\Http\Request;

class ItemsController extends Controller
{
    public function __construct(private ItemsService $service) {}

    /**
     * 통합 품목 목록 조회 (materials + products)
     *
     * GET /api/v1/items
     */
    public function index(Request $request)
    {
        return ApiResponse::handle(function () use ($request) {
            $filters = $request->only(['type', 'search', 'q', 'category_id']);
            $perPage = (int) ($request->input('size') ?? 20);
            $includeDeleted = filter_var($request->input('include_deleted', false), FILTER_VALIDATE_BOOLEAN);

            return $this->service->getItems($filters, $perPage, $includeDeleted);
        }, __('message.fetched'));
    }

    /**
     * 단일 품목 조회
     *
     * GET /api/v1/items/{id}?item_type=PRODUCT|MATERIAL&include_price=true&client_id=1&price_date=2025-01-10
     */
    public function show(Request $request, int $id)
    {
        return ApiResponse::handle(function () use ($request, $id) {
            $itemType = strtoupper($request->input('item_type', 'PRODUCT'));
            $includePrice = filter_var($request->input('include_price', false), FILTER_VALIDATE_BOOLEAN);
            $clientId = $request->input('client_id') ? (int) $request->input('client_id') : null;
            $priceDate = $request->input('price_date');

            return $this->service->getItem($itemType, $id, $includePrice, $clientId, $priceDate);
        }, __('message.fetched'));
    }

    /**
     * 품목 상세 조회 (code 기반, BOM 포함 옵션)
     *
     * GET /api/v1/items/code/{code}?include_bom=true
     */
    public function showByCode(Request $request, string $code)
    {
        return ApiResponse::handle(function () use ($request, $code) {
            $includeBom = filter_var($request->input('include_bom', false), FILTER_VALIDATE_BOOLEAN);

            return $this->service->getItemByCode($code, $includeBom);
        }, __('message.item.fetched'));
    }

    /**
     * 품목 생성
     *
     * POST /api/v1/items
     */
    public function store(ItemStoreRequest $request)
    {
        return ApiResponse::handle(function () use ($request) {
            return $this->service->createItem($request->validated());
        }, __('message.item.created'));
    }

    /**
     * 품목 수정
     *
     * PUT /api/v1/items/{id}
     */
    public function update(int $id, ItemUpdateRequest $request)
    {
        return ApiResponse::handle(function () use ($id, $request) {
            return $this->service->updateItem($id, $request->validated());
        }, __('message.item.updated'));
    }

    /**
     * 품목 삭제 (Soft Delete)
     *
     * DELETE /api/v1/items/{id}
     */
    public function destroy(int $id)
    {
        return ApiResponse::handle(function () use ($id) {
            $this->service->deleteItem($id);

            return 'success';
        }, __('message.item.deleted'));
    }

    /**
     * 품목 일괄 삭제 (Soft Delete)
     *
     * DELETE /api/v1/items/batch
     */
    public function batchDestroy(ItemBatchDeleteRequest $request)
    {
        return ApiResponse::handle(function () use ($request) {
            $this->service->batchDeleteItems($request->validated()['ids']);

            return 'success';
        }, __('message.item.batch_deleted'));
    }
}