@@ -55,34 +55,31 @@ public ResponseEntity<SuccessResponse<AdminToolPageRes>> fetchAllTool(
5555 @ Operation (
5656 summary = "관리자용 툴 추가" ,
5757 description = """
58- 관리자용 툴 추가 API입니다.
59-
60- **플랜(plans) 필드 사용 가이드:**
61- - 플랜은 여러 개를 추가할 수 있습니다 (배열 형태)
62- - 각 플랜은 planName(플랜명), planPrice(가격), planDescription(설명)을 포함합니다
58+ 관리자용 툴 추가 API입니다.
59+ **플랜(plans) 필드 사용 가이드:**
60+ - 플랜은 여러 개를 추가할 수 있습니다 (배열 형태)
61+ - 각 플랜은 planName(플랜명), planPrice(가격), planDescription(설명)을 포함합니다
6362 - planType과 plans는 함께 사용됩니다:
64- * FREE: 무료 플랜인 경우 plans는 빈 배열이거나 무료 플랜 1개만 포함
65- * MONTHLY: 월간 구독 플랜들 (예: Basic, Pro, Enterprise 등)
66- * PURCHASE: 일회성 구매 플랜들 (예: Starter, Professional 등)
67- * MONTHLY_ANNUAL: 월간 & 연간 플랜 혼합 (예: 월간 Basic, 연간 Basic 등)
68-
63+ * FREE: 무료 플랜인 경우 plans는 빈 배열이거나 무료 플랜 1개만 포함
64+ * MONTHLY: 월간 구독 플랜들 (예: Basic, Pro, Enterprise 등)
65+ * PURCHASE: 일회성 구매 플랜들 (예: Starter, Professional 등)
66+ * MONTHLY_ANNUAL: 월간 & 연간 플랜 혼합 (예: 월간 Basic, 연간 Basic 등)
6967 **플랜 케이스 예시:**
7068 1. 무료 툴: planType="무료", plans=[]
71- 또는 plans=[{planName:"무료", planPrice:0, planDescription:"기본 기능 무료 제공"}]
69+ 또는 plans=[{planName:"무료", planPrice:0, planDescription:"기본 기능 무료 제공"}]
7270 2. 월간 구독: planType="월간",
73- plans=[{planName:"Basic", planPrice:10000, ...}, {planName:"Pro", planPrice:30000, ...}]
71+ plans=[{planName:"Basic", planPrice:10000, ...}, {planName:"Pro", planPrice:30000, ...}]
7472 3. 일회성 구매: planType="구매",
75- plans=[{planName:"Starter", planPrice:50000, ...},
76- {planName:"Professional", planPrice:150000, ...}]
73+ plans=[{planName:"Starter", planPrice:50000, ...},
74+ {planName:"Professional", planPrice:150000, ...}]
7775 4. 혼합: planType="월간 & 연간",
78- plans=[{planName:"Basic 월간", planPrice:10000, ...},
79- {planName:"Basic 연간", planPrice:100000, ...}]
80-
81- **주의사항:**
82- - planPrice는 원화 단위로 입력합니다 (예: 10000 = 1만원)
83- - planName, planPrice, planDescription은 모두 필수입니다
84- - planDescription은 최대 500자까지 입력 가능합니다
85- - plans가 null이거나 빈 배열일 수 있지만, planType이 설정된 경우 적절한 플랜 정보를 제공하는 것을 권장합니다
76+ plans=[{planName:"Basic 월간", planPrice:10000, ...},
77+ {planName:"Basic 연간", planPrice:100000, ...}]
78+ **주의사항:**
79+ - planPrice는 원화 단위로 입력합니다 (예: 10000 = 1만원)
80+ - planName, planPrice, planDescription은 모두 필수입니다
81+ - planDescription은 최대 500자까지 입력 가능합니다
82+ - plans가 null이거나 빈 배열일 수 있지만, planType이 설정된 경우 적절한 플랜 정보를 제공하는 것을 권장합니다
8683 """
8784 )
8885 public ResponseEntity <SuccessResponse <Void >> createTool (
@@ -98,18 +95,15 @@ public ResponseEntity<SuccessResponse<Void>> createTool(
9895 summary = "관리자용 툴 수정" ,
9996 description = """
10097 관리자용 툴 수정 API입니다.
101-
10298 **플랜(plans) 필드 수정 가이드:**
10399 - plans 필드를 전송하면 기존 플랜들이 모두 삭제되고 새로운 플랜들로 교체됩니다
104100 - plans를 null로 보내면 플랜 정보는 변경되지 않습니다
105101 - plans를 빈 배열([])로 보내면 모든 플랜이 삭제됩니다
106-
107102 **플랜 수정 케이스:**
108103 1. 플랜 추가/변경: plans=[{planName:"New Plan", planPrice:20000, planDescription:"새로운 플랜"}]
109104 2. 플랜 삭제: plans=[] (모든 플랜 삭제)
110105 3. 플랜 유지: plans=null (기존 플랜 그대로 유지)
111106 4. 플랜 수정: plans=[수정된 플랜 목록] (기존 플랜 삭제 후 새로 추가)
112-
113107 **주의사항:**
114108 - 플랜 수정 시 planName, planPrice, planDescription은 모두 필수입니다 (null이면 해당 플랜은 저장되지 않습니다)
115109 - planDescription은 최대 500자까지 입력 가능합니다
0 commit comments