feat(settlement): 정산 도메인 구현 및 전 모듈 동시성 보강

- 정산 서비스/컨트롤러/엔티티/스케줄러 구현
- 전 엔티티 @Version 낙관적 락 적용
- ID 생성 AtomicLong → UUID 전환
- 스케줄러 무제한 조회 → 페이지 배치 처리
- docker-compose에 settlementdb 추가
- 전 모듈 순수 유닛 테스트 추가

Author: hellowco

.gitignore

@@ -3,7 +3,7 @@
 CLAUDE.md
 
 ### Docs ###
-**/TEST_LIST.md
+**/*.md
 
 ### Gradle ###
 .gradle/

buildSrc/src/main/groovy/paybook.java-conventions.gradle

@@ -1,6 +1,7 @@
 plugins {
     id 'java'
     id 'io.spring.dependency-management'
+    id 'jacoco'
 }
 
 group = 'com.paybook'
@@ -31,4 +32,12 @@ dependencyManagement {
 
 test {
     useJUnitPlatform()
+    finalizedBy jacocoTestReport
+}
+
+jacocoTestReport {
+    dependsOn test
+    reports {
+        csv.required = true
+    }
 }

core/src/main/java/com/paybook/core/entity/CouponEntity.java

@@ -36,6 +36,9 @@ public class CouponEntity {
 
     private Integer minOrderAmount;
 
+    @Version
+    private Long version;
+
     public CouponEntity(String couponId, CouponStatus status, CouponType couponType,
                         DiscountType discountType, int discountValue, Integer maxDiscountAmount) {
         this(couponId, status, couponType, discountType, discountValue, maxDiscountAmount, null);

core/src/main/java/com/paybook/core/entity/PaymentEntity.java

@@ -20,7 +20,7 @@ public class PaymentEntity {
     @Column(nullable = false, unique = true)
     private String paymentId;
 
-    @Column(nullable = false)
+    @Column(nullable = false, unique = true)
     private String orderId;
 
     private int pgPaymentAmount;
@@ -34,6 +34,9 @@ public class PaymentEntity {
     @Column(nullable = false)
     private LocalDateTime createdAt;
 
+    @Version
+    private Long version;
+
     public PaymentEntity(String paymentId, String orderId, int pgPaymentAmount) {
         this.paymentId = paymentId;
         this.orderId = orderId;

core/src/main/java/com/paybook/core/entity/UserPointEntity.java

@@ -20,6 +20,9 @@ public class UserPointEntity {
 
     private int balance;
 
+    @Version
+    private Long version;
+
     public UserPointEntity(String userId, int balance) {
         this.userId = userId;
         this.balance = balance;

docker-compose.yml

@@ -0,0 +1,41 @@
+services:
+  orderdb:
+    image: postgres:17
+    container_name: paybook-orderdb
+    environment:
+      POSTGRES_DB: orderdb
+      POSTGRES_USER: paybook
+      POSTGRES_PASSWORD: paybook
+    ports:
+      - "5432:5432"
+    volumes:
+      - orderdb-data:/var/lib/postgresql/data
+
+  paymentdb:
+    image: postgres:17
+    container_name: paybook-paymentdb
+    environment:
+      POSTGRES_DB: paymentdb
+      POSTGRES_USER: paybook
+      POSTGRES_PASSWORD: paybook
+    ports:
+      - "5433:5432"
+    volumes:
+      - paymentdb-data:/var/lib/postgresql/data
+
+  settlementdb:
+    image: postgres:17
+    container_name: paybook-settlementdb
+    environment:
+      POSTGRES_DB: settlementdb
+      POSTGRES_USER: paybook
+      POSTGRES_PASSWORD: paybook
+    ports:
+      - "5434:5432"
+    volumes:
+      - settlementdb-data:/var/lib/postgresql/data
+
+volumes:
+  orderdb-data:
+  paymentdb-data:
+  settlementdb-data:

order/build.gradle

@@ -7,7 +7,8 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-web'
     implementation 'org.springframework.boot:spring-boot-starter-validation'
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
-    runtimeOnly 'com.h2database:h2'
+    runtimeOnly 'org.postgresql:postgresql'
+    testRuntimeOnly 'com.h2database:h2'
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
     testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
     testImplementation 'org.springframework.boot:spring-boot-starter-data-jpa-test'

order/src/main/java/com/paybook/order/dto/OrderResponse.java

@@ -12,6 +12,7 @@ public record OrderResponse(
         int pgPaymentAmount,
         int deliveryFee,
         String status,
+        String couponId,
         String createdAt
 ) {
     public record OrderItemResponse(

order/src/main/java/com/paybook/order/entity/OrderEntity.java

@@ -2,9 +2,7 @@
 
 import com.paybook.order.exception.OrderException;
 import jakarta.persistence.*;
-import lombok.AccessLevel;
-import lombok.Getter;
-import lombok.NoArgsConstructor;
+import lombok.*;
 
 import java.time.LocalDateTime;
 import java.util.ArrayList;
@@ -16,6 +14,8 @@
 @Table(name = "orders")
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor(access = AccessLevel.PRIVATE)
+@Builder
 public class OrderEntity {
 
     private static final Set<OrderStatus> NON_CANCELLABLE_STATUSES = EnumSet.of(
@@ -34,6 +34,7 @@ public class OrderEntity {
     private String userId;
 
     @OneToMany(mappedBy = "order", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
     private List<OrderItemEntity> items = new ArrayList<>();
 
     private int totalAmount;
@@ -48,7 +49,8 @@ public class OrderEntity {
 
     @Enumerated(EnumType.STRING)
     @Column(nullable = false)
-    private OrderStatus status;
+    @Builder.Default
+    private OrderStatus status = OrderStatus.PENDING_PAYMENT;
 
     private String deliveryAddress;
 
@@ -57,25 +59,11 @@ public class OrderEntity {
     private Integer pointAmountToUse;
 
     @Column(nullable = false)
-    private LocalDateTime createdAt;
-
-    public OrderEntity(String orderId, String userId, int totalAmount,
-                       int couponDiscountAmount, int pointDiscountAmount, int pgPaymentAmount,
-                       int deliveryFee, String deliveryAddress, String couponId,
-                       Integer pointAmountToUse) {
-        this.orderId = orderId;
-        this.userId = userId;
-        this.totalAmount = totalAmount;
-        this.couponDiscountAmount = couponDiscountAmount;
-        this.pointDiscountAmount = pointDiscountAmount;
-        this.pgPaymentAmount = pgPaymentAmount;
-        this.deliveryFee = deliveryFee;
-        this.deliveryAddress = deliveryAddress;
-        this.couponId = couponId;
-        this.pointAmountToUse = pointAmountToUse;
-        this.status = OrderStatus.PENDING_PAYMENT;
-        this.createdAt = LocalDateTime.now();
-    }
+    @Builder.Default
+    private LocalDateTime createdAt = LocalDateTime.now();
+
+    @Version
+    private Long version;
 
     public void addItem(OrderItemEntity item) {
         items.add(item);

order/src/main/java/com/paybook/order/repository/OrderRepository.java

@@ -7,7 +7,6 @@
 import org.springframework.data.jpa.repository.JpaRepository;
 
 import java.time.LocalDateTime;
-import java.util.List;
 import java.util.Optional;
 
 public interface OrderRepository extends JpaRepository<OrderEntity, Long> {
@@ -18,5 +17,5 @@ public interface OrderRepository extends JpaRepository<OrderEntity, Long> {
 
     Page<OrderEntity> findByUserIdAndStatusOrderByCreatedAtDesc(String userId, OrderStatus status, Pageable pageable);
 
-    List<OrderEntity> findByStatusAndCreatedAtBefore(OrderStatus status, LocalDateTime cutoff);
+    Page<OrderEntity> findByStatusAndCreatedAtBefore(OrderStatus status, LocalDateTime cutoff, Pageable pageable);
 }