docs: Items API show 메서드 Swagger 추가

This commit is contained in:
2025-12-09 10:30:35 +09:00
parent b2b3b27f17
commit 0600a2f822

View File

@@ -197,6 +197,36 @@ public function store() {}
*/
public function showByCode() {}
/**
* @OA\Get(
* path="/api/v1/items/{id}",
* tags={"Items"},
* summary="품목 ID로 상세 조회",
* description="품목 ID로 상세 정보를 조회합니다. item_type 파라미터 필수.",
* security={{"ApiKeyAuth": {}, "BearerAuth": {}}},
*
* @OA\Parameter(name="id", in="path", required=true, @OA\Schema(type="integer"), example=1, description="품목 ID"),
* @OA\Parameter(name="item_type", in="query", required=true, @OA\Schema(type="string", enum={"PRODUCT", "MATERIAL"}), example="PRODUCT", description="품목 유형"),
* @OA\Parameter(name="include_price", in="query", @OA\Schema(type="boolean"), example=false, description="단가 정보 포함 여부"),
* @OA\Parameter(name="client_id", in="query", @OA\Schema(type="integer"), example=1, description="거래처 ID (단가 조회 시)"),
* @OA\Parameter(name="price_date", in="query", @OA\Schema(type="string", format="date"), example="2025-01-10", description="단가 기준일"),
*
* @OA\Response(
* response=200,
* description="성공",
*
* @OA\JsonContent(
* type="object",
*
* @OA\Property(property="success", type="boolean", example=true),
* @OA\Property(property="message", type="string", example="조회되었습니다."),
* @OA\Property(property="data", ref="#/components/schemas/Item")
* )
* )
* )
*/
public function show() {}
/**
* @OA\Put(
* path="/api/v1/items/{id}",