From 0a02f6a099d9919fe20745a40f977144449f2776 Mon Sep 17 00:00:00 2001
From: minij02 <mjryu00211@gmail.com>
Date: Sun, 21 Jun 2026 17:37:34 +0900
Subject: [PATCH] =?UTF-8?q?feat:=20=EB=8B=A4=EC=9A=B4=EB=A1=9C=EB=93=9C=20?=
 =?UTF-8?q?=EB=AA=A9=EB=A1=9D=20=EC=9D=91=EB=8B=B5=EC=97=90=20purchase=5Fi?=
 =?UTF-8?q?d=20/=20is=5Frefunded=20=EC=B6=94=EA=B0=80=20(#518)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- PromptDownloadRepository.getDownloadedPromptsByUser include에 refund 추가
- DownloadedPromptResponseDTO에 purchase_id, is_refunded 필드 추가
- PromptDownloadService에서 purchase 단위로 매핑 (환불 API 호출 경로 제공)
- Swagger 응답 스키마 갱신 + swagger.json 재생성
---
 src/prompts/dtos/prompt.download.dto.ts             |  2 ++
 .../repositories/prompt.download.repository.ts      |  1 +
 src/prompts/routes/prompt.download.route.ts         |  2 ++
 src/prompts/services/prompt.download.service.ts     | 13 ++++++++-----
 swagger.json                                        |  8 ++++++++
 5 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/src/prompts/dtos/prompt.download.dto.ts b/src/prompts/dtos/prompt.download.dto.ts
index 218e218..dfece09 100644
--- a/src/prompts/dtos/prompt.download.dto.ts
+++ b/src/prompts/dtos/prompt.download.dto.ts
@@ -10,6 +10,8 @@ export interface PromptDownloadResponseDTO {
 export interface DownloadedPromptResponseDTO {
   message: string;
   prompt_id: number;
+  purchase_id: number;
+  is_refunded: boolean;
   title: string;
   description: string;
   models: string[];
diff --git a/src/prompts/repositories/prompt.download.repository.ts b/src/prompts/repositories/prompt.download.repository.ts
index 4712bd4..a6b116a 100644
--- a/src/prompts/repositories/prompt.download.repository.ts
+++ b/src/prompts/repositories/prompt.download.repository.ts
@@ -28,6 +28,7 @@ export const PromptDownloadRepository = {
     return prisma.purchase.findMany({
       where: { user_id: userId },
       include: {
+        refund: { select: { refund_id: true } },
         prompt: {
           select: {
             prompt_id: true,
diff --git a/src/prompts/routes/prompt.download.route.ts b/src/prompts/routes/prompt.download.route.ts
index 09af072..89ba6ff 100644
--- a/src/prompts/routes/prompt.download.route.ts
+++ b/src/prompts/routes/prompt.download.route.ts
@@ -98,6 +98,8 @@ router.get('/:promptId/downloads', authenticateJwt, PromptDownloadController.get
  *                     type: object
  *                     properties:
  *                       prompt_id: { type: integer }
+ *                       purchase_id: { type: integer, description: 환불 API 호출에 필요한 구매 ID }
+ *                       is_refunded: { type: boolean, description: 환불 완료 여부 }
  *                       title: { type: string }
  *                       description: { type: string, nullable: true }
  *                       price: { type: integer }
diff --git a/src/prompts/services/prompt.download.service.ts b/src/prompts/services/prompt.download.service.ts
index 3932f15..2af7c65 100644
--- a/src/prompts/services/prompt.download.service.ts
+++ b/src/prompts/services/prompt.download.service.ts
@@ -95,7 +95,8 @@ async getDownloadedPrompts(userId: number): Promise<DownloadedPromptResponseDTO[
     const THIRTY_DAYS_AGO = new Date();
     THIRTY_DAYS_AGO.setDate(THIRTY_DAYS_AGO.getDate() - 30);
 
-    return downloads.map(({ prompt }) => {
+    return downloads.map((purchase) => {
+        const { prompt } = purchase;
         const userReviewRaw = prompt.reviews[0];
         const hasReview = !!userReviewRaw;
         const isRecentReview = hasReview && new Date(userReviewRaw.created_at) >= THIRTY_DAYS_AGO;
@@ -111,17 +112,19 @@ async getDownloadedPrompts(userId: number): Promise<DownloadedPromptResponseDTO[
         return {
             message: "다운로드한 프롬프트 목록 조회 성공",
             statusCode: 200,
-            
+
             prompt_id: prompt.prompt_id,
+            purchase_id: purchase.purchase_id,
+            is_refunded: !!purchase.refund,
             title: prompt.title,
              description: prompt.description,
             price: prompt.price,
             models: prompt.models.map((m) => m.model.name),
             imageUrls: imageUrls,
-            
+
             has_review: hasReview,
-            is_recent_review: isRecentReview, 
-    
+            is_recent_review: isRecentReview,
+
             userNickname: userNickname,
             userProfileImageUrl: userProfileImageUrl,
             userReview: userReview,
diff --git a/swagger.json b/swagger.json
index aeb7ebd..43b660f 100644
--- a/swagger.json
+++ b/swagger.json
@@ -3938,6 +3938,14 @@
                           "prompt_id": {
                             "type": "integer"
                           },
+                          "purchase_id": {
+                            "type": "integer",
+                            "description": "환불 API 호출에 필요한 구매 ID"
+                          },
+                          "is_refunded": {
+                            "type": "boolean",
+                            "description": "환불 완료 여부"
+                          },
                           "title": {
                             "type": "string"
                           },