Round5

.codeguide/loopers-1-week.md

@@ -43,3 +43,16 @@
 
 - [ ]  포인트 조회에 성공할 경우, 보유 포인트를 응답으로 반환한다.
 - [ ]  `X-USER-ID` 헤더가 없을 경우, `400 Bad Request` 응답을 반환한다.
+
+
+### 포인트 충전
+
+**🧱 단위 테스트**
+- [ ] 이하의 정수로 포인트를 충전 시 실패한다.
+
+**🔗 통합 테스트**
+- [ ] 존재하지 않는 유저 ID 로 충전을 시도한 경우, 실패한다.
+
+**🌐 E2E 테스트**
+- [ ] 포인트 충전이 성공할 경우, 업데이트된 보유 포인트를 응답으로 반환한다.
+- [ ] 존재하지 않는 유저로 요청할 경우, 404 Not Found 응답을 반환한다.

.gitignore

@@ -4,7 +4,9 @@ build/
 !gradle/wrapper/gradle-wrapper.jar
 !**/src/main/**/build/
 !**/src/test/**/build/
-
+.kiro
+apps/commerce-api/src/main/generated/**
+docs/project-analysis
 ### STS ###
 .apt_generated
 .classpath

apps/commerce-api/build.gradle.kts

@@ -11,6 +11,10 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-actuator")
     implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:${project.properties["springDocOpenApiVersion"]}")
 
+
+    // faker
+    implementation("net.datafaker:datafaker:2.0.2")
+
     // querydsl
     annotationProcessor("com.querydsl:querydsl-apt::jakarta")
     annotationProcessor("jakarta.persistence:jakarta.persistence-api")

apps/commerce-api/src/main/java/com/loopers/CommerceApiApplication.java

@@ -1,13 +1,17 @@
 package com.loopers;
 
-import jakarta.annotation.PostConstruct;
+import java.util.TimeZone;
+
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
-import java.util.TimeZone;
+import org.springframework.scheduling.annotation.EnableScheduling;
+
+import jakarta.annotation.PostConstruct;
 
 @ConfigurationPropertiesScan
 @SpringBootApplication
+@EnableScheduling
 public class CommerceApiApplication {
 
     @PostConstruct

apps/commerce-api/src/main/java/com/loopers/application/brand/BrandInfo.java

@@ -0,0 +1,12 @@
+package com.loopers.application.brand;
+
+/**
+ * @author hyunjikoh
+ * @since 2025. 11. 10.
+ */
+public record BrandInfo(
+        Long id,
+        String name,
+        String description
+) {
+}

apps/commerce-api/src/main/java/com/loopers/application/example/ExampleFacade.java

@@ -1,9 +1,11 @@
 package com.loopers.application.example;
 
+import org.springframework.stereotype.Component;
+
 import com.loopers.domain.example.ExampleModel;
 import com.loopers.domain.example.ExampleService;
+
 import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Component;
 
 @RequiredArgsConstructor
 @Component

apps/commerce-api/src/main/java/com/loopers/application/example/ExampleInfo.java

@@ -5,9 +5,9 @@
 public record ExampleInfo(Long id, String name, String description) {
     public static ExampleInfo from(ExampleModel model) {
         return new ExampleInfo(
-            model.getId(),
-            model.getName(),
-            model.getDescription()
+                model.getId(),
+                model.getName(),
+                model.getDescription()
         );
     }
 }

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

@@ -0,0 +1,83 @@
+package com.loopers.application.like;
+
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.loopers.domain.like.LikeResult;
+import com.loopers.domain.like.LikeService;
+import com.loopers.domain.product.ProductCacheService;
+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;
+import lombok.extern.slf4j.Slf4j;
+
+/**
+ * 좋아요 애플리케이션 파사드
+ * 
+ * 좋아요 관련 유스케이스를 조정합니다.
+ * 여러 도메인 서비스(User, Product, Like)를 조합하여 완전한 비즈니스 흐름을 구현합니다.
+ *
+ * @author hyunjikoh
+ * @since 2025. 11. 11.
+ */
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class LikeFacade {
+    private final ProductService productService;
+    private final UserService userService;
+    private final LikeService likeService;
+    private final ProductCacheService cacheService;
+
+    /**
+     * 좋아요를 등록하거나 복원합니다.
+     *
+     * @param username  사용자명
+     * @param productId 상품 ID
+     * @return 좋아요 정보 DTO
+     * @throws CoreException 사용자 또는 상품을 찾을 수 없는 경우
+     */
+    @Transactional
+    public LikeInfo upsertLike(String username, Long productId) {
+        log.debug("좋아요 등록/복원 시작 - username: {}, productId: {}", username, productId);
+
+        // 1. 사용자 검증
+        UserEntity user = userService.getUserByUsername(username);
+
+        // 2. 상품 검증
+        ProductEntity product = productService.getActiveProductDetail(productId);
+
+        // 3. 좋아요 등록/복원 (실제 변경 여부 확인)
+        LikeResult result = likeService.upsertLike(user, product);
+
+        // 5. DTO 변환 후 반환
+        return LikeInfo.of(result.entity(), product, user);
+    }
+
+    /**
+     * 좋아요를 취소합니다.
+     * 
+     * 좋아요를 삭제하고 상품의 좋아요 카운트를 감소시킵니다.
+     *
+     * @param username  사용자명
+     * @param productId 상품 ID
+     * @throws CoreException 사용자 또는 상품을 찾을 수 없는 경우
+     */
+    @Transactional
+    public void unlikeProduct(String username, Long productId) {
+        log.debug("좋아요 취소 시작 - username: {}, productId: {}", username, productId);
+
+        // 1. 사용자 검증
+        UserEntity user = userService.getUserByUsername(username);
+
+        // 2. 상품 검증
+        ProductEntity product = productService.getActiveProductDetail(productId);
+
+        // 3. 좋아요 취소
+        likeService.unlikeProduct(user, product);
+    }
+}

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

@@ -0,0 +1,27 @@
+package com.loopers.application.like;
+
+import java.time.ZonedDateTime;
+
+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,
+        ZonedDateTime createdAt
+) {
+    public static LikeInfo of(LikeEntity like, ProductEntity product, UserEntity user) {
+        return new LikeInfo(
+                user.getUsername(),
+                product.getId(),
+                product.getName(),
+                like.getCreatedAt()
+        );
+    }
+}

apps/commerce-api/src/main/java/com/loopers/application/order/OrderCreateCommand.java

@@ -0,0 +1,18 @@
+package com.loopers.application.order;
+
+import java.util.List;
+
+import lombok.Builder;
+
+/**
+ * 주문 생성 커맨드
+ *
+ * @author hyunjikoh
+ * @since 2025. 11. 14.
+ */
+@Builder
+public record OrderCreateCommand(
+        String username,
+        List<OrderItemCommand> orderItems
+) {
+}