From 156b1d7d509478e9e181a167e7b721c7dab86226 Mon Sep 17 00:00:00 2001
From: Roy <suhwj81@gmail.com>
Date: Tue, 8 Sep 2026 20:37:42 +0900
Subject: [PATCH] =?UTF-8?q?#441=20[Feat]=20=EA=B4=91=EA=B3=A0=20=EC=8A=A4?=
 =?UTF-8?q?=EC=9B=A8=EA=B1=B0=20=ED=83=AD=EC=97=90=20=EC=9A=B4=EC=98=81=20?=
 =?UTF-8?q?=EA=B4=91=EA=B3=A0=20=EB=8F=84=EB=A9=94=EC=9D=B8=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- ad.picke.store 를 광고 그룹 서버 목록에 넣는다. 운영 광고 조회·클릭·랜딩을
  받는 도메인인데 목록에 없어 스웨거에서 고를 수가 없었다.
- 운영 API 서버(picke.store)와 별도 Railway 서비스라, 운영 광고를 조회하려면
  이 도메인을 직접 골라야 한다.
- 문서를 연 주소를 첫 번째로 두는 것은 그대로 둔다.
---
 .../com/swyp/picke/global/config/SwaggerConfig.java  | 12 +++++++++++-
 .../swyp/picke/global/config/SwaggerAdGroupTest.java |  8 ++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/main/java/com/swyp/picke/global/config/SwaggerConfig.java b/src/main/java/com/swyp/picke/global/config/SwaggerConfig.java
index 9b17e2e..b4adb35 100644
--- a/src/main/java/com/swyp/picke/global/config/SwaggerConfig.java
+++ b/src/main/java/com/swyp/picke/global/config/SwaggerConfig.java
@@ -118,7 +118,7 @@ public GroupedOpenApi adApi() {
                 .group("3. 광고 API")
                 .pathsToMatch("/api/v1/ads", "/api/v1/ads/**", "/api/v1/admin/ads", "/api/v1/admin/ads/**")
                 .addOpenApiCustomizer(openApi -> openApi.setServers(
-                        List.of(currentServer(), prodServer(), localServer(), devServer())))
+                        List.of(currentServer(), adServer(), devServer(), localServer(), prodServer())))
                 .build();
     }
 
@@ -137,6 +137,16 @@ private Server currentServer() {
                 .description("현재 접속한 서버");
     }
 
+    /**
+     * 광고 전용 도메인. 운영에서 광고 조회·클릭·랜딩을 받는 곳이다.
+     * 운영 API 서버(picke.store)와 별도 서비스라 광고 그룹에서 따로 고를 수 있어야 한다.
+     */
+    private Server adServer() {
+        return new Server()
+                .url("https://ad.picke.store")
+                .description("Ad Server (운영 광고 도메인)");
+    }
+
     // 1. 운영 서버 (8080)
     private Server prodServer() {
         return new Server()
diff --git a/src/test/java/com/swyp/picke/global/config/SwaggerAdGroupTest.java b/src/test/java/com/swyp/picke/global/config/SwaggerAdGroupTest.java
index 4356e57..d83769a 100644
--- a/src/test/java/com/swyp/picke/global/config/SwaggerAdGroupTest.java
+++ b/src/test/java/com/swyp/picke/global/config/SwaggerAdGroupTest.java
@@ -45,6 +45,14 @@ void adGroup_defaultsToCurrentOrigin() throws Exception {
                 .andExpect(jsonPath("$.servers[*].url").value(hasItem("https://picke.store")));
     }
 
+    @Test
+    @DisplayName("광고 탭에서 운영 광고 도메인을 고를 수 있다. 운영 광고는 별도 서비스라 API 서버로는 조회되지 않는다")
+    void adGroup_offersAdDomain() throws Exception {
+        mockMvc.perform(get("/v3/api-docs/" + AD_GROUP))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.servers[1].url").value("https://ad.picke.store"));
+    }
+
     @Test
     @DisplayName("다른 탭의 서버 순서는 그대로 둔다")
     void otherGroups_keepProdFirst() throws Exception {