Merge pull request #12 from hyujikoh/feat/like

좋아요 도메인 기능 구현

Author: hyujikoh

apps/commerce-api/src/main/java/com/loopers/application/like/LikeFacade.java

@@ -0,0 +1,81 @@
+package com.loopers.application.like;
+
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.loopers.domain.like.LikeEntity;
+import com.loopers.domain.like.LikeService;
+import com.loopers.domain.product.ProductEntity;
+import com.loopers.domain.product.ProductService;
+import com.loopers.domain.user.UserEntity;
+import com.loopers.domain.user.UserService;
+import com.loopers.support.error.CoreException;
+
+import lombok.RequiredArgsConstructor;
+
+/**
+ * 좋아요 애플리케이션 파사드
+ * <p>
+ * 좋아요 관련 유스케이스를 조정합니다.
+ * 여러 도메인 서비스(User, Product, Like)를 조합하여 완전한 비즈니스 흐름을 구현합니다.
+ *
+ * @author hyunjikoh
+ * @since 2025. 11. 11.
+ */
+@Component
+@RequiredArgsConstructor
+public class LikeFacade {
+    private final ProductService productService;
+    private final UserService userService;
+    private final LikeService likeService;
+
+    /**
+     * 좋아요를 등록하거나 복원합니다.
+     *
+     * @param username  사용자명
+     * @param productId 상품 ID
+     * @return 좋아요 정보 DTO
+     * @throws CoreException 사용자 또는 상품을 찾을 수 없는 경우
+     */
+    @Transactional
+    public LikeInfo upsertLike(String username, Long productId) {
+        // 1. 사용자 검증
+        UserEntity user = userService.getUserByUsername(username);
+
+        // 2. 상품 검증
+        ProductEntity product = productService.getProductDetail(productId);
+
+        // 3. 좋아요 등록/복원
+        LikeEntity likeEntity = likeService.upsertLike(user.getId(), product.getId());
+
+        // 4. 상품의 좋아요 수 증가
+        productService.increaseLikeCount(product.getId());
+
+        // 5. DTO 변환 후 반환
+        return LikeInfo.of(likeEntity, product, user);
+    }
+
+    /**
+     * 좋아요를 취소합니다.
+     *
+     * @param username  사용자명
+     * @param productId 상품 ID
+     * @throws CoreException 사용자 또는 상품을 찾을 수 없는 경우
+     */
+    @Transactional
+    public void unlikeProduct(String username, Long productId) {
+        // 1. 사용자 검증
+        UserEntity user = userService.getUserByUsername(username);
+
+        // 2. 상품 검증
+        ProductEntity product = productService.getProductDetail(productId);
+
+        // 3. 좋아요 취소
+        likeService.findLike(user.getId(), productId)
+                .ifPresent(like -> {
+                    like.delete();
+                    // 4. 상품의 좋아요 수 감소
+                    productService.decreaseLikeCount(product.getId());
+                });
+    }
+}

apps/commerce-api/src/main/java/com/loopers/application/like/LikeInfo.java

@@ -0,0 +1,23 @@
+package com.loopers.application.like;
+
+import com.loopers.domain.like.LikeEntity;
+import com.loopers.domain.product.ProductEntity;
+import com.loopers.domain.user.UserEntity;
+
+/**
+ * @author hyunjikoh
+ * @since 2025. 11. 12.
+ */
+public record LikeInfo(
+        String username,
+        Long productId,
+        String productName
+) {
+    public static LikeInfo of(LikeEntity like, ProductEntity product, UserEntity user) {
+        return new LikeInfo(
+                user.getUsername(),
+                product.getId(),
+                product.getName()
+        );
+    }
+}

apps/commerce-api/src/main/java/com/loopers/application/product/ProductDetailInfo.java

@@ -15,16 +15,30 @@ public record ProductDetailInfo(
         Long likeCount,
         Integer stockQuantity,
         ProductPriceInfo price,
-        BrandInfo brand
+        BrandInfo brand,
+        Boolean isLiked  // 사용자의 좋아요 여부 (null: 비로그인, true: 좋아요함, false: 좋아요 안함)
 ) {
     /**
      * ProductEntity와 BrandEntity를 조합하여 ProductDetailInfo를 생성한다.
+     * (비로그인 사용자용 - isLiked는 null)
      *
      * @param product 상품 엔티티
      * @param brand   브랜드 엔티티
      * @return ProductDetailInfo
      */
     public static ProductDetailInfo of(ProductEntity product, BrandEntity brand) {
+        return of(product, brand, false);
+    }
+
+    /**
+     * ProductEntity, BrandEntity, 좋아요 여부를 조합하여 ProductDetailInfo를 생성한다.
+     *
+     * @param product 상품 엔티티
+     * @param brand   브랜드 엔티티
+     * @param isLiked 사용자의 좋아요 여부 (null: 비로그인)
+     * @return ProductDetailInfo
+     */
+    public static ProductDetailInfo of(ProductEntity product, BrandEntity brand, Boolean isLiked) {
         if (product == null) {
             throw new IllegalArgumentException("상품 정보는 필수입니다.");
         }
@@ -47,7 +61,8 @@ public static ProductDetailInfo of(ProductEntity product, BrandEntity brand) {
                         brand.getId(),
                         brand.getName(),
                         brand.getDescription()
-                )
+                ),
+                isLiked
         );
     }
 }

apps/commerce-api/src/main/java/com/loopers/application/product/ProductFacade.java

@@ -6,9 +6,11 @@
 
 import com.loopers.domain.brand.BrandEntity;
 import com.loopers.domain.brand.BrandService;
+import com.loopers.domain.like.LikeService;
 import com.loopers.domain.product.ProductEntity;
 import com.loopers.domain.product.ProductService;
 import com.loopers.domain.product.dto.ProductSearchFilter;
+import com.loopers.domain.user.UserService;
 
 import lombok.RequiredArgsConstructor;
 
@@ -21,6 +23,8 @@
 public class ProductFacade {
     private final ProductService productService;
     private final BrandService brandService;
+    private final LikeService likeService;
+    private final UserService userService;
 
     @Transactional(readOnly = true)
     public Page<ProductInfo> getProducts(ProductSearchFilter productSearchFilter) {
@@ -30,15 +34,29 @@ public Page<ProductInfo> getProducts(ProductSearchFilter productSearchFilter) {
         return products.map(ProductInfo::of);
     }
 
+
+    /**
+     * 상품 상세 정보를 좋아요 정보와 함께 조회합니다.
+     *
+     * @param productId 상품 ID
+     * @param username  사용자명 (null인 경우 비로그인 사용자)
+     * @return 상품 상세 정보 (좋아요 여부 포함)
+     */
     @Transactional(readOnly = true)
-    public ProductDetailInfo getProductDetail(Long id) {
+    public ProductDetailInfo getProductDetail(Long productId, String username) {
         // 1. Product 조회
-        ProductEntity product = productService.getProductDetail(id);
+        ProductEntity product = productService.getProductDetail(productId);
 
         // 2. Brand 조회
         BrandEntity brand = brandService.getBrandById(product.getBrandId());
 
-        // 3. DTO 조합 후 반환
-        return ProductDetailInfo.of(product, brand);
+        // 3. 사용자의 좋아요 여부 확인
+        Boolean isLiked = username != null
+                ? likeService.findLike(userService.getUserByUsername(username).getId(), productId)
+                .map(like -> like.getDeletedAt() == null)
+                .orElse(false)
+                : false;
+        // 4. DTO 조합 후 반환
+        return ProductDetailInfo.of(product, brand, isLiked);
     }
 }

apps/commerce-api/src/main/java/com/loopers/domain/brand/BrandDomainCreateRequest.java

@@ -0,0 +1,33 @@
+package com.loopers.domain.brand;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+/**
+ * 브랜드 도메인 생성 요청 DTO
+ *
+ * 도메인 레이어에서 사용하는 브랜드 생성 요청 정보입니다.
+ * Application Layer에서 Domain Layer로 전달되는 데이터 구조입니다.
+ *
+ * @author hyunjikoh
+ * @since 2025. 11. 12.
+ */
+public record BrandDomainCreateRequest(
+        @NotBlank(message = "브랜드 이름은 필수입니다.")
+        @Size(max = 100, message = "브랜드 이름은 100자를 초과할 수 없습니다.")
+        String name,
+
+        String description
+) {
+    /**
+     * 정적 팩토리 메서드
+     *
+     * @param name 브랜드 이름
+     * @param description 브랜드 설명
+     * @return BrandDomainCreateRequest 인스턴스
+     */
+    public static BrandDomainCreateRequest of(String name, String description) {
+        return new BrandDomainCreateRequest(name, description);
+    }
+}
+

apps/commerce-api/src/main/java/com/loopers/domain/brand/BrandEntity.java

@@ -38,12 +38,22 @@ public BrandEntity(String name, String description) {
 
     }
 
-    public static BrandEntity createBrandEntity(String name, String description) {
-        if (Objects.isNull(name)) {
+    /**
+     * 브랜드 엔티티를 생성합니다.
+     *
+     * @param request 브랜드 생성 요청 정보
+     * @return 생성된 브랜드 엔티티
+     */
+    public static BrandEntity createBrandEntity(BrandDomainCreateRequest request) {
+        if (Objects.isNull(request)) {
+            throw new IllegalArgumentException("브랜드 생성 요청 정보는 필수입니다.");
+        }
+
+        if (Objects.isNull(request.name()) || request.name().isBlank()) {
             throw new IllegalArgumentException("브랜드 이름은 필수 입력값입니다.");
         }
 
-        return new BrandEntity(name, description);
+        return new BrandEntity(request.name(), request.description());
     }
 
     @Override

apps/commerce-api/src/main/java/com/loopers/domain/brand/BrandService.java

@@ -11,7 +11,14 @@
 
 import lombok.RequiredArgsConstructor;
 
+import jakarta.validation.Valid;
+
 /**
+ * 브랜드 도메인 서비스
+ *
+ * 브랜드 도메인의 비즈니스 로직을 처리합니다.
+ * 단일 책임 원칙에 따라 브랜드 Repository에만 의존합니다.
+ *
  * @author hyunjikoh
  * @since 2025. 11. 9.
  */
@@ -20,11 +27,24 @@
 public class BrandService {
     private final BrandRepository brandRepository;
 
+    /**
+     * 브랜드 목록을 조회합니다.
+     *
+     * @param pageable 페이징 정보
+     * @return 브랜드 목록 페이지
+     */
     @Transactional(readOnly = true)
     public Page<BrandEntity> listBrands(Pageable pageable) {
         return brandRepository.listBrands(pageable);
     }
 
+    /**
+     * 브랜드 ID로 브랜드를 조회합니다.
+     *
+     * @param id 브랜드 ID
+     * @return 조회된 브랜드 엔티티
+     * @throws CoreException 브랜드를 찾을 수 없는 경우
+     */
     @Transactional(readOnly = true)
     public BrandEntity getBrandById(long id) {
         return brandRepository.getBrandById(id)
@@ -34,6 +54,13 @@ public BrandEntity getBrandById(long id) {
                 ));
     }
 
+    /**
+     * 브랜드 이름으로 브랜드를 조회합니다.
+     *
+     * @param name 브랜드 이름
+     * @return 조회된 브랜드 엔티티
+     * @throws CoreException 브랜드를 찾을 수 없는 경우
+     */
     @Transactional(readOnly = true)
     public BrandEntity getBrandByName(String name) {
         return brandRepository.findByName(name)
@@ -43,8 +70,41 @@ public BrandEntity getBrandByName(String name) {
                 ));
     }
 
+    /**
+     * 검색 필터 조건으로 브랜드를 조회합니다.
+     *
+     * @param filter 검색 필터
+     * @param pageable 페이징 정보
+     * @return 검색된 브랜드 목록 페이지
+     */
     @Transactional(readOnly = true)
     public Page<BrandEntity> searchBrands(BrandSearchFilter filter, Pageable pageable) {
         return brandRepository.searchBrands(filter, pageable);
     }
+
+    /**
+     * 브랜드를 등록합니다.
+     *
+     * 브랜드 등록은 단일 도메인 작업이므로 도메인 서비스에서 트랜잭션 처리합니다.
+     *
+     * @param request 브랜드 생성 요청 정보
+     * @return 등록된 브랜드 엔티티
+     * @throws CoreException 중복된 브랜드 이름이 존재하는 경우
+     */
+    @Transactional
+    public BrandEntity registerBrand(@Valid BrandDomainCreateRequest request) {
+        // 중복 브랜드명 검증
+        brandRepository.findByName(request.name())
+                .ifPresent(existingBrand -> {
+                    throw new CoreException(
+                            ErrorType.DUPLICATE_BRAND,
+                            String.format("이미 존재하는 브랜드 이름입니다. (이름: %s)", request.name())
+                    );
+                });
+
+        // 브랜드 엔티티 생성
+        BrandEntity brandEntity = BrandEntity.createBrandEntity(request);
+
+        return brandRepository.save(brandEntity);
+    }
 }