From 0600a2f8226754766b8d6179e32b2af718345a2e Mon Sep 17 00:00:00 2001
From: hskwon <shine1324@gmail.com>
Date: Tue, 9 Dec 2025 10:30:35 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20Items=20API=20show=20=EB=A9=94=EC=84=9C?=
 =?UTF-8?q?=EB=93=9C=20Swagger=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 app/Swagger/v1/ItemsApi.php | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

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}",