서버 및 DB 시간 처리 정책 UTC로 통일 (#93)

* fix: 서버 타임존 처리 UTC로 통일

* fix: 서버 타임존 처리 UTC로 통일

* refactor: UTC 변환로직을 도메인 레이어로 이동

* refactor: Jackson 설정 application.yaml 설정으로 변경

Author: jhan0121

Dockerfile

@@ -2,10 +2,7 @@ FROM amazoncorretto:25-alpine3.21
 
 WORKDIR /app
 
-RUN apk add --no-cache curl tzdata && \
-    cp /usr/share/zoneinfo/Asia/Seoul /etc/localtime && \
-    echo "Asia/Seoul" > /etc/timezone && \
-    apk del tzdata
+RUN apk add --no-cache curl
 
 RUN addgroup -g 1001 appgroup && adduser -u 1001 -G appgroup -D appuser
 RUN mkdir -p /app/log && chown -R appuser:appgroup /app
@@ -16,4 +13,4 @@ USER appuser
 
 EXPOSE 8080
 
-ENTRYPOINT ["java", "-jar", "app.jar"]
+ENTRYPOINT ["java", "-Duser.timezone=UTC", "-jar", "app.jar"]

src/main/java/com/recyclestudy/common/config/TimeConfig.java

@@ -9,6 +9,6 @@ public class TimeConfig {
 
     @Bean
     public Clock clock() {
-        return Clock.systemDefaultZone();
+        return Clock.systemUTC();
     }
 }

src/main/java/com/recyclestudy/email/ReviewEmailSender.java

@@ -22,7 +22,7 @@ public class ReviewEmailSender {
     private final ReviewCycleService reviewCycleService;
     private final Clock clock;
 
-    @Scheduled(cron = "${schedule.review-mail.cron}", zone = "Asia/Seoul")
+    @Scheduled(cron = "${schedule.review-mail.cron}", zone = "UTC")
     public void sendReviewMail() {
         final LocalDateTime targetDateTime = LocalDateTime.now(clock).truncatedTo(ChronoUnit.MINUTES);
 

src/main/java/com/recyclestudy/member/controller/response/MemberFindResponse.java

@@ -1,7 +1,7 @@
 package com.recyclestudy.member.controller.response;
 
 import com.recyclestudy.member.service.output.MemberFindOutput;
-import java.time.LocalDateTime;
+import java.time.Instant;
 import java.util.List;
 
 public record MemberFindResponse(String email, List<MemberFindElement> devices) {
@@ -14,6 +14,6 @@ public static MemberFindResponse from(final MemberFindOutput output) {
         return new MemberFindResponse(output.email().getValue(), memberFindElements);
     }
 
-    private record MemberFindElement(String identifier, LocalDateTime createdAt) {
+    private record MemberFindElement(String identifier, Instant createdAt) {
     }
 }

src/main/java/com/recyclestudy/member/service/output/MemberFindOutput.java

@@ -3,7 +3,8 @@
 import com.recyclestudy.member.domain.Device;
 import com.recyclestudy.member.domain.DeviceIdentifier;
 import com.recyclestudy.member.domain.Email;
-import java.time.LocalDateTime;
+import java.time.Instant;
+import java.time.ZoneOffset;
 import java.util.List;
 
 public record MemberFindOutput(Email email, List<MemberFindElement> elements) {
@@ -13,11 +14,12 @@ public static MemberFindOutput of(
             final List<Device> devices
     ) {
         final List<MemberFindElement> memberFindElements = devices.stream()
-                .map(device -> new MemberFindElement(device.getIdentifier(), device.getCreatedAt()))
+                .map(device -> new MemberFindElement(device.getIdentifier(),
+                        device.getCreatedAt() != null ? device.getCreatedAt().toInstant(ZoneOffset.UTC) : null))
                 .toList();
         return new MemberFindOutput(email, memberFindElements);
     }
 
-    public record MemberFindElement(DeviceIdentifier identifier, LocalDateTime createdAt) {
+    public record MemberFindElement(DeviceIdentifier identifier, Instant createdAt) {
     }
 }

src/main/java/com/recyclestudy/review/controller/ReviewController.java

@@ -35,7 +35,7 @@ public ResponseEntity<ReviewSaveResponse> saveReview(
     ) {
         final ReviewSaveInput input = ReviewSaveInput.of(identifier, request.targetUrl(), request.cycle());
         final ReviewSaveOutput output = reviewService.saveReview(input);
-        ReviewSaveResponse response = ReviewSaveResponse.of(output.url(), output.scheduledAts());
+        ReviewSaveResponse response = ReviewSaveResponse.from(output);
         return ResponseEntity.status(HttpStatus.CREATED).body(response);
     }
 

src/main/java/com/recyclestudy/review/controller/response/NextReviewResponse.java

@@ -1,9 +1,9 @@
 package com.recyclestudy.review.controller.response;
 
 import com.recyclestudy.review.service.output.NextReviewOutput;
-import java.time.LocalDateTime;
+import java.time.Instant;
 
-public record NextReviewResponse(LocalDateTime scheduledAt, int count) {
+public record NextReviewResponse(Instant scheduledAt, int count) {
 
     public static NextReviewResponse of(final NextReviewOutput output) {
         return new NextReviewResponse(output.scheduledAt(), output.count());

src/main/java/com/recyclestudy/review/controller/response/ReviewSaveResponse.java

@@ -1,12 +1,12 @@
 package com.recyclestudy.review.controller.response;
 
-import com.recyclestudy.review.domain.ReviewURL;
-import java.time.LocalDateTime;
+import com.recyclestudy.review.service.output.ReviewSaveOutput;
+import java.time.Instant;
 import java.util.List;
 
-public record ReviewSaveResponse(String url, List<LocalDateTime> scheduledAts) {
+public record ReviewSaveResponse(String url, List<Instant> scheduledAts) {
 
-    public static ReviewSaveResponse of(ReviewURL url, List<LocalDateTime> scheduledAts) {
-        return new ReviewSaveResponse(url.getValue(), scheduledAts);
+    public static ReviewSaveResponse from(final ReviewSaveOutput output) {
+        return new ReviewSaveResponse(output.url().getValue(), output.scheduledAts());
     }
 }

src/main/java/com/recyclestudy/review/service/output/NextReviewOutput.java

@@ -1,14 +1,16 @@
 package com.recyclestudy.review.service.output;
 
+import java.time.Instant;
 import java.time.LocalDateTime;
+import java.time.ZoneOffset;
 
-public record NextReviewOutput(LocalDateTime scheduledAt, int count) {
+public record NextReviewOutput(Instant scheduledAt, int count) {
 
     public static NextReviewOutput empty() {
         return new NextReviewOutput(null, 0);
     }
 
     public static NextReviewOutput of(final LocalDateTime scheduledAt, final int count) {
-        return new NextReviewOutput(scheduledAt, count);
+        return new NextReviewOutput(scheduledAt.toInstant(ZoneOffset.UTC), count);
     }
 }

src/main/java/com/recyclestudy/review/service/output/ReviewSaveOutput.java

@@ -1,12 +1,15 @@
 package com.recyclestudy.review.service.output;
 
 import com.recyclestudy.review.domain.ReviewURL;
+import java.time.Instant;
 import java.time.LocalDateTime;
+import java.time.ZoneOffset;
 import java.util.List;
 
-public record ReviewSaveOutput(ReviewURL url, List<LocalDateTime> scheduledAts) {
+public record ReviewSaveOutput(ReviewURL url, List<Instant> scheduledAts) {
 
     public static ReviewSaveOutput of(ReviewURL url, List<LocalDateTime> scheduledAts) {
-        return new ReviewSaveOutput(url, scheduledAts);
+        return new ReviewSaveOutput(url,
+                scheduledAts.stream().map(scheduledAt -> scheduledAt.toInstant(ZoneOffset.UTC)).toList());
     }
 }