Merge pull request #38 from Kimjipang/main

[volume-1] 회원가입, 내 정보 조회, 포인트 충전, 포인트 조회 API 구현 및 테스트 코드 작성

Author: Kimjipang

apps/commerce-api/src/main/java/com/loopers/application/point/PointFacade.java

@@ -0,0 +1,45 @@
+package com.loopers.application.point;
+
+import com.loopers.domain.point.Point;
+import com.loopers.domain.point.PointService;
+import com.loopers.domain.user.UserService;
+import com.loopers.interfaces.api.point.PointV1Dto;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+@Component
+@RequiredArgsConstructor
+public class PointFacade {
+    private final PointService pointService;
+    private final UserService userService;
+
+    @Transactional(readOnly = true)
+    public PointInfo getPoint(Long userId) {
+        /*
+        - [ ] 사용자 존재 여부 확인
+        - [ ] 포인트 잔액 조회
+         */
+        userService.checkUserExists(userId);
+
+        Point point = pointService.getPointBalanceByUserId(userId);
+
+        return PointInfo.from(point);
+
+    }
+
+    @Transactional
+    public PointInfo chargePoint(PointV1Dto.PointChargeRequest request) {
+        /*
+        - [ ] 사용자 존재 여부 확인
+        - [ ] 충전 금액 유효성 검사
+        - [ ] 포인트 충전 로직
+         */
+        userService.checkUserExists(request.userId()); // 사용자 존재 여부 확인
+
+        Point current = pointService.getPointBalanceByUserId(request.userId());
+        current.charge(request.amount()); // 포인트 충전 로직
+
+        return PointInfo.from(current);
+    }
+}

apps/commerce-api/src/main/java/com/loopers/application/point/PointInfo.java

@@ -0,0 +1,12 @@
+package com.loopers.application.point;
+
+import com.loopers.domain.point.Point;
+
+public record PointInfo(Long userId, Long balance) {
+    public static PointInfo from(Point point) {
+        return new PointInfo(
+            point.getUserId(),
+            point.getBalance()
+        );
+    }
+}

apps/commerce-api/src/main/java/com/loopers/application/user/UserFacade.java

@@ -0,0 +1,41 @@
+package com.loopers.application.user;
+
+import com.loopers.domain.user.UserEntity;
+import com.loopers.domain.user.UserService;
+import com.loopers.interfaces.api.user.UserV1Dto;
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+@Component
+@RequiredArgsConstructor
+public class UserFacade {
+
+    private final UserService userService;
+
+    @Transactional
+    public UserInfo signUp(UserV1Dto.SignUpRequest request) {
+        boolean isExist = userService.existsByLoginId(request.loginId());
+
+        if (isExist) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "이미 존재하는 유저입니다.");
+        }
+
+        UserEntity savedUser = userService.save(request.toEntity());
+        return UserInfo.from(savedUser);
+    }
+
+    @Transactional(readOnly = true)
+    public UserInfo getUserByLoginId(String loginId) {
+        boolean isExist = userService.existsByLoginId(loginId);
+
+        if (!isExist) {
+            throw new CoreException(ErrorType.NOT_FOUND, "해당 유저ID의 사용자가 존재하지 않습니다.");
+        }
+
+        UserEntity userEntity = userService.getUserByLoginId(loginId);
+        return UserInfo.from(userEntity);
+    }
+}

apps/commerce-api/src/main/java/com/loopers/application/user/UserInfo.java

@@ -0,0 +1,17 @@
+package com.loopers.application.user;
+
+import com.loopers.domain.user.Gender;
+import com.loopers.domain.user.UserEntity;
+
+public record UserInfo(Long id, String loginId, Gender gender, String email, String birth) {
+    public static UserInfo from(UserEntity userEntity) {
+        return new UserInfo(
+            userEntity.getId(),
+            userEntity.getLoginId(),
+            userEntity.getGender(),
+            userEntity.getEmail(),
+            userEntity.getBirth()
+        );
+    }
+
+}

apps/commerce-api/src/main/java/com/loopers/domain/point/Point.java

@@ -0,0 +1,32 @@
+package com.loopers.domain.point;
+
+import com.loopers.domain.BaseEntity;
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.Table;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@Table(name = "point")
+@NoArgsConstructor(access = lombok.AccessLevel.PROTECTED)
+public class Point extends BaseEntity {
+    @Column(name = "user_id", nullable = false)
+    private Long userId;
+    @Column(nullable = false)
+    private Long balance;
+
+    public Point(Long userId, Long balance) {
+        PointValidator.validateBalance(balance);
+
+        this.userId = userId;
+        this.balance = balance;
+    }
+
+    public void charge(Long amount) {
+        PointValidator.validateChargeAmount(amount); // 충전 금액 유효성 검사 (0보다 커야 함)
+        this.balance += amount;
+    }
+
+}

apps/commerce-api/src/main/java/com/loopers/domain/point/PointRepository.java

@@ -0,0 +1,9 @@
+package com.loopers.domain.point;
+
+import java.util.Optional;
+
+public interface PointRepository {
+
+    Optional<Point> findByUserId(Long userId);
+    Point save(Point point);
+}

apps/commerce-api/src/main/java/com/loopers/domain/point/PointService.java

@@ -0,0 +1,18 @@
+package com.loopers.domain.point;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+@Component
+@RequiredArgsConstructor
+public class PointService {
+    private final PointRepository pointRepository;
+
+    public Point getPointBalanceByUserId(Long userId) {
+        return pointRepository.findByUserId(userId).orElseThrow(
+                () -> new CoreException(ErrorType.NOT_FOUND, "해당 사용자의 포인트 정보가 존재하지 않습니다.")
+        );
+    }
+}

apps/commerce-api/src/main/java/com/loopers/domain/point/PointValidator.java

@@ -0,0 +1,18 @@
+package com.loopers.domain.point;
+
+import com.loopers.support.error.CoreException;
+import com.loopers.support.error.ErrorType;
+
+public class PointValidator {
+    public static void validateBalance(Long balance) {
+        if (balance == null || balance < 0) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "포인트 잔액은 0 이상이어야 합니다.");
+        }
+    }
+
+    public static void validateChargeAmount(Long amount) {
+        if (amount == null || amount <= 0) {
+            throw new CoreException(ErrorType.BAD_REQUEST, "충전 금액은 0 초과이어야 합니다.");
+        }
+    }
+}

apps/commerce-api/src/main/java/com/loopers/domain/user/Gender.java

@@ -0,0 +1,6 @@
+package com.loopers.domain.user;
+
+public enum Gender {
+    MALE,
+    FEMALE
+}

apps/commerce-api/src/main/java/com/loopers/domain/user/UserEntity.java

@@ -0,0 +1,34 @@
+package com.loopers.domain.user;
+
+import com.loopers.domain.BaseEntity;
+import jakarta.persistence.Entity;
+import jakarta.persistence.Table;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Entity
+@Table(name = "user")
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class UserEntity extends BaseEntity {
+    private String loginId;
+    private String email;
+    private Gender gender;
+    private String birth;
+    private String password;
+
+    public UserEntity(String loginId, String email, Gender gender, String birth, String password) {
+        UserValidator.validateLoginId(loginId);
+        UserValidator.validateEmail(email);
+        UserValidator.validateBirth(birth);
+        UserValidator.validatePassword(password);
+
+        this.loginId = loginId;
+        this.email = email;
+        this.gender = gender;
+        this.birth = birth;
+        this.password = password;
+    }
+
+}