🐛 Fix: 브랜드 이미지 경로 불일치

src/main/java/com/likelion/picklbe/domain/brand/Brand.java

@@ -1,6 +1,10 @@
 package com.likelion.picklbe.domain.brand;
 
+import java.util.Collections;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Locale;
+import java.util.Map;
 import java.util.regex.Pattern;
 
 public enum Brand {
@@ -69,20 +73,12 @@ public enum Brand {
           Pattern.compile("hanaro", Pattern.CASE_INSENSITIVE))),
   GS_SUPER(
       "gs-super",
-      "GS수퍼마켓",
+      "GS슈퍼",
       "gs_super.png",
       List.of(
-          Pattern.compile("지에스\\s*리테일"),
-          Pattern.compile("\\bGS\\s*수퍼", Pattern.CASE_INSENSITIVE),
-          Pattern.compile("\\bGS\\s*super", Pattern.CASE_INSENSITIVE))),
-  GS_THE_FRESH(
-      "gs-the-fresh",
-      "GS더프레시",
-      "gs_the_fresh.png",
-      List.of(
-          Pattern.compile("더\\s*프레시"),
-          Pattern.compile("\\bGS\\s*the\\s*fresh", Pattern.CASE_INSENSITIVE))),
-  DEFAULT("default", "기타", null, List.of());
+          Pattern.compile("지에스리테일"),
+          Pattern.compile("\\bGS\\b\\s*(THE\\s*FRESH|슈퍼)?", Pattern.CASE_INSENSITIVE))),
+  DEFAULT("default", "기타", "mart_default.png", List.of());
 
   private final String code;
   private final String displayName;
@@ -108,10 +104,29 @@ public String displayName() {
     return displayName;
   }
 
+  private static final Map<String, Brand> BY_CODE;
+
+  static {
+    Map<String, Brand> m = new HashMap<>();
+    for (Brand b : values()) {
+      m.put(b.code().toLowerCase(Locale.ROOT), b);
+    }
+    BY_CODE = Collections.unmodifiableMap(m);
+  }
+
+  public static Brand fromCodeSafe(String code) {
+    if (code == null || code.isBlank()) {
+      return DEFAULT;
+    }
+    Brand b = BY_CODE.get(code.toLowerCase(Locale.ROOT));
+    return (b != null) ? b : DEFAULT;
+  }
+
   public static Brand fromStoreName(String name) {
     if (name == null || name.isBlank()) {
       return DEFAULT;
     }
+    // 우선순위: 에브리데이 → GS → 이마트 등 (선언 순서 유지)
     for (Brand b : values()) {
       if (b == DEFAULT) {
         continue;
@@ -124,16 +139,4 @@ public static Brand fromStoreName(String name) {
     }
     return DEFAULT;
   }
-
-  public static Brand fromCodeSafe(String code) {
-    if (code == null || code.isBlank()) {
-      return DEFAULT;
-    }
-    for (Brand b : values()) {
-      if (b.code.equalsIgnoreCase(code)) {
-        return b;
-      }
-    }
-    return DEFAULT;
-  }
 }

src/main/java/com/likelion/picklbe/domain/brand/BrandImageResolver.java

@@ -2,12 +2,10 @@
 
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.stereotype.Component;
-import org.springframework.util.StringUtils;
 
 @Component
 public class BrandImageResolver {
 
-  // ex) https://picklocal.s3.ap-northeast-2.amazonaws.com
   @Value("${app.cdn.base-url:https://picklocal.s3.ap-northeast-2.amazonaws.com}")
   private String baseUrl;
 
@@ -19,109 +17,50 @@ public class BrandImageResolver {
 
   /** 원문(지점명/상호명/브랜드명 포함 가능)에서 Brand enum을 추정 */
   public Brand resolveBrand(String raw) {
-    if (!StringUtils.hasText(raw)) {
+    if (raw == null || raw.isBlank()) {
       return Brand.DEFAULT;
     }
     return Brand.fromStoreName(raw);
   }
 
-  /** explicitBrand(컬럼) 우선, 없으면 name(지점명)으로 추정 */
-  public Brand resolveBrand(String explicitBrand, String name) {
-    if (StringUtils.hasText(explicitBrand)) {
-      // fromStoreName 가 브랜드명도 파싱한다는 전제
-      return resolveBrand(explicitBrand);
-    }
-    return resolveBrand(name);
-  }
-
   /** Brand 코드만 필요할 때 */
   public String resolveBrandCode(String raw) {
     return resolveBrand(raw).code();
   }
 
-  /** Brand 코드만 이미 있는 경우(예: DB 조회) */
-  public String resolveBrandCodeFromCode(String brandCode) {
-    Brand b = Brand.fromCodeSafe(brandCode); // 없으면 DEFAULT 반환하도록 enum에 구현되어 있어야 함
-    return b.code();
+  /** Brand 코드만 이미 있는 경우 → 이미지 URL */
+  public String imageUrlForCode(String brandCode) {
+    Brand b = Brand.fromCodeSafe(brandCode);
+    return imageUrlFor(b);
   }
 
   /** 원문에서 바로 대표 이미지 URL */
   public String resolveImageUrl(String raw) {
     return imageUrlFor(resolveBrand(raw));
   }
 
-  /** explicitBrand + name 동시 고려 */
-  public String resolveImageUrl(String explicitBrand, String name) {
-    return imageUrlFor(resolveBrand(explicitBrand, name));
-  }
-
   /** Brand가 이미 있는 경우 이미지 URL */
   public String imageUrlFor(Brand brand) {
-    // 1) brand가 null/DEFAULT 이거나 파일명이 비어있으면 기본 이미지
     String filename =
-        (brand == null || brand == Brand.DEFAULT || !StringUtils.hasText(brand.filename()))
+        (brand == null || brand.filename() == null || brand == Brand.DEFAULT)
             ? defaultFile
             : brand.filename();
-
-    // 2) filename 자체가 절대 URL이면 그대로 반환 (운영 중 전체 URL을 enum에 넣은 경우 대응)
-    if (isAbsoluteUrl(filename)) {
-      return filename;
-    }
-
-    // 3) baseUrl/brandPath 안전 조합
-    return joinUrl(rtrimSlashes(baseUrl), rtrimSlashes(brandPath), filename);
-  }
-
-  /** Brand 코드로 바로 이미지 URL (코드만 내려받는 API/쿼리 대응) */
-  public String imageUrlForCode(String brandCode) {
-    Brand b = Brand.fromCodeSafe(brandCode);
-    return imageUrlFor(b);
+    return String.format("%s/%s/%s", rtrim(baseUrl), rtrim(brandPath), filename);
   }
 
-  /** 원문에서 Brand와 이미지 URL/코드를 한 번에 */
+  /** 원문에서 Brand와 이미지 URL을 한 번에 */
   public ResolvedBrand resolve(String raw) {
     Brand b = resolveBrand(raw);
     return new ResolvedBrand(b, imageUrlFor(b), b.code());
   }
 
-  /** explicitBrand + name 동시 입력 버전 */
-  public ResolvedBrand resolve(String explicitBrand, String name) {
-    Brand b = resolveBrand(explicitBrand, name);
-    return new ResolvedBrand(b, imageUrlFor(b), b.code());
-  }
-
-  // ---- helpers -------------------------------------------------------------
-
-  private static boolean isAbsoluteUrl(String s) {
-    if (!StringUtils.hasText(s)) {
-      return false;
-    }
-    String t = s.trim().toLowerCase();
-    return t.startsWith("http://") || t.startsWith("https://");
-  }
-
-  private static String rtrimSlashes(String s) {
-    if (!StringUtils.hasText(s)) {
+  private String rtrim(String s) {
+    if (s == null || s.isBlank()) {
       return "";
     }
     return s.replaceAll("/+$", "");
   }
 
-  private static String joinUrl(String... parts) {
-    StringBuilder sb = new StringBuilder();
-    for (int i = 0; i < parts.length; i++) {
-      String p = parts[i] == null ? "" : parts[i].trim();
-      if (p.isEmpty()) {
-        continue;
-      }
-      if (sb.length() > 0 && sb.charAt(sb.length() - 1) != '/') {
-        sb.append('/');
-      }
-      sb.append(p.replaceAll("^/+", "")); // 앞 슬래시 제거
-    }
-    return sb.toString();
-  }
-
   /** 편의 반환 DTO */
   public record ResolvedBrand(Brand brand, String imageUrl, String code) {}
 }

src/main/java/com/likelion/picklbe/domain/brand/controller/BrandAdminController.java

@@ -0,0 +1,105 @@
+package com.likelion.picklbe.domain.brand.controller;
+
+import java.util.List;
+
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import com.likelion.picklbe.domain.brand.Brand;
+import com.likelion.picklbe.global.s3.service.BrandImagePromotionService;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.ArraySchema;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/admin/brands")
+@Tag(name = "Brand Admin", description = "브랜드 이미지 승격(관리자) API")
+public class BrandAdminController {
+
+  private final BrandImagePromotionService promotionService;
+
+  /** 단건 승격: uuid, brandCode */
+  @PostMapping(path = "/promote", produces = MediaType.TEXT_PLAIN_VALUE)
+  @Operation(
+      summary = "브랜드 이미지 단건 승격",
+      description =
+          """
+          업로드된 UUID 키 파일을 해당 브랜드의 **고정 파일명**으로 복사(승격)합니다.
+          - `uuid`는 `images/brand/<uuid>`에서 `<uuid>` **파일명 부분**만 넣으세요.
+          - 가능한 brandCode 예: emart, homeplus, lotte-mart, emart-everyday, no-brand, costco, lotte-super, lotte-fresh, traders, hanaro
+          반환값은 최종 S3 키(예: `images/brand/emart.png`)입니다.
+          """)
+  @ApiResponse(responseCode = "200", description = "승격 성공 (텍스트 키 반환)")
+  @ApiResponse(responseCode = "400", description = "유효하지 않은 brandCode", content = @Content)
+  public ResponseEntity<String> promote(
+      @Parameter(
+              description = "UUID 파일명 (예: 8799915c-9018-406a-...)",
+              example = "8799915c-9018-406a-ad2e-47678f87ca96")
+          @RequestParam("uuid")
+          String uuidKey,
+      @Parameter(description = "브랜드 코드 (예: emart, homeplus, lotte-mart)", example = "emart")
+          @RequestParam("brandCode")
+          String brandCode) {
+    Brand brand = Brand.fromCodeSafe(brandCode);
+    if (brand == Brand.DEFAULT || brand.filename() == null) {
+      return ResponseEntity.badRequest().body("유효하지 않은 brandCode: " + brandCode);
+    }
+    String dstKey = promotionService.promote(uuidKey, brand);
+    return ResponseEntity.ok(dstKey);
+  }
+
+  /** 배치 승격: [{uuid, brandCode}, ...] */
+  @PostMapping(
+      path = "/promote-batch",
+      consumes = MediaType.APPLICATION_JSON_VALUE,
+      produces = MediaType.APPLICATION_JSON_VALUE)
+  @Operation(
+      summary = "브랜드 이미지 배치 승격",
+      description =
+          """
+          여러 개의 UUID 파일을 한 번에 승격합니다.
+          요청 바디 예:
+          [
+            {"uuid":"8799915c-9018-406a-ad2e-47678f87ca96","brandCode":"emart"},
+            {"uuid":"b45a7445-be38-4573-89dc-c5afbebcb0e9","brandCode":"homeplus"}
+          ]
+          반환값은 최종 S3 키 배열입니다.
+          """)
+  @ApiResponse(
+      responseCode = "200",
+      description = "승격 성공",
+      content = @Content(array = @ArraySchema(schema = @Schema(implementation = String.class))))
+  public ResponseEntity<List<String>> promoteBatch(
+      @io.swagger.v3.oas.annotations.parameters.RequestBody(
+              required = true,
+              content = @Content(schema = @Schema(implementation = PromoteReq[].class)))
+          @RequestBody
+          List<PromoteReq> reqs) {
+    List<String> results =
+        reqs.stream()
+            .map(
+                req -> {
+                  Brand brand = Brand.fromCodeSafe(req.brandCode());
+                  if (brand == Brand.DEFAULT || brand.filename() == null) {
+                    throw new IllegalArgumentException("invalid brandCode: " + req.brandCode());
+                  }
+                  return promotionService.promote(req.uuid(), brand);
+                })
+            .toList();
+    return ResponseEntity.ok(results);
+  }
+
+  @Schema(name = "PromoteReq", description = "승격 요청 항목")
+  public record PromoteReq(
+      @Schema(description = "UUID 파일명", example = "8799915c-9018-406a-ad2e-47678f87ca96")
+          String uuid,
+      @Schema(description = "브랜드 코드", example = "emart") String brandCode) {}
+}

src/main/java/com/likelion/picklbe/domain/mart/service/MartQueryService.java

@@ -20,11 +20,14 @@ public class MartQueryService {
   private final PlaceRepository placeRepository;
   private final BrandImageResolver brandImageResolver;
 
-  /** 브랜드명이 없으면 지점명(name)으로 키를 만들어 이미지/브랜드코드 모두 해석 */
+  /**
+   * brand 컬럼이 있으면 우선 사용, 없으면 name 기반으로 브랜드 추정. brandCode를 한 번만 해석해서 imageUrl은 imageUrlForCode(...)로
+   * 생성해 중복 파싱을 피한다.
+   */
   private BrandInfo resolveBrandInfo(Place p) {
     String key = (p.getBrand() != null && !p.getBrand().isBlank()) ? p.getBrand() : p.getName();
-    String img = brandImageResolver.resolveImageUrl(key);
-    String code = brandImageResolver.resolveBrandCode(key);
+    String code = brandImageResolver.resolveBrandCode(key); // ex) "emart", "gs-super", "default"
+    String img = brandImageResolver.imageUrlForCode(code); // baseUrl/brandPath/default 처리 포함
     return new BrandInfo(img, code);
   }
 
@@ -44,7 +47,6 @@ public List<PlaceResponse> findInBounds(
         .map(
             p -> {
               BrandInfo brand = resolveBrandInfo(p);
-              // PlaceResponse.of(Place, imageUrl, brandCode) 시그니처 사용
               return PlaceResponse.of(p, brand.imageUrl(), brand.brandCode());
             })
         .collect(Collectors.toList());
@@ -56,12 +58,11 @@ public List<PlaceResponse> findNearby(double lng, double lat, int radiusMeters,
         .map(
             p -> {
               BrandInfo brand = resolveBrandInfo(p);
-              // PlaceResponse.of(Place, imageUrl, brandCode) 시그니처 사용
               return PlaceResponse.of(p, brand.imageUrl(), brand.brandCode());
             })
         .collect(Collectors.toList());
   }
 
-  /** 내부 전용 DTO (Java 16+): 이미지 URL과 브랜드 코드 한 번에 전달 */
+  /** 내부 전용 DTO: 이미지 URL과 브랜드 코드 동시 전달 */
   private record BrandInfo(String imageUrl, String brandCode) {}
 }