diff --git a/app/Swagger/v1/ItemsApi.php b/app/Swagger/v1/ItemsApi.php index cdf5b93..e1705ea 100644 --- a/app/Swagger/v1/ItemsApi.php +++ b/app/Swagger/v1/ItemsApi.php @@ -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}",