Refactor/66 utc migration

deploy-docker.sh

@@ -74,7 +74,7 @@ docker run -d \
   --name memory-app \
   --restart unless-stopped \
   -p 8081:8081 \
-  -e SPRING_DATASOURCE_URL="jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Seoul&allowPublicKeyRetrieval=true" \
+  -e SPRING_DATASOURCE_URL="jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true" \
   -e SPRING_DATASOURCE_USERNAME="${DB_USERNAME}" \
   -e SPRING_DATASOURCE_PASSWORD="${DB_PASSWORD}" \
   -e CLOUD_AWS_CREDENTIALS_ACCESS_KEY="${AWS_ACCESS_KEY_ID}" \

deploy-production-direct.sh

@@ -62,7 +62,7 @@ docker run -d \
   --network "$NETWORK_NAME" \
   --restart unless-stopped \
   -p 8081:8081 \
-  -e SPRING_DATASOURCE_URL="jdbc:mysql://memory-mysql:3306/$MYSQL_DATABASE?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Seoul&allowPublicKeyRetrieval=true" \
+      -e SPRING_DATASOURCE_URL="jdbc:mysql://memory-mysql:3306/$MYSQL_DATABASE?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true" \
   -e SPRING_DATASOURCE_USERNAME="$MYSQL_USER" \
   -e SPRING_DATASOURCE_PASSWORD="$MYSQL_PASSWORD" \
   "$IMAGE_NAME:$IMAGE_TAG"

deploy-production-docker.sh

@@ -125,7 +125,7 @@ deploy_docker() {
           --name memory-app \
           --restart unless-stopped \
           -p 8081:8081 \
-          -e SPRING_DATASOURCE_URL="jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Seoul&allowPublicKeyRetrieval=true" \
+          -e SPRING_DATASOURCE_URL="jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true" \
           -e SPRING_DATASOURCE_USERNAME="${DB_USERNAME}" \
           -e SPRING_DATASOURCE_PASSWORD="${DB_PASSWORD}" \
           -e CLOUD_AWS_CREDENTIALS_ACCESS_KEY="${AWS_ACCESS_KEY_ID}" \

docker-compose.yml

@@ -28,7 +28,7 @@ services:
       mysql:
         condition: service_healthy
     environment:
-      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/memory_db?useSSL=false&allowPublicKeyRetrieval=true
+      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/memory_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
       SPRING_DATASOURCE_USERNAME: memory_user
       SPRING_DATASOURCE_PASSWORD: memory_password
     ports:

src/main/java/zim/tave/memory/config/JacksonConfig.java

@@ -0,0 +1,72 @@
+package zim.tave.memory.config;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.core.JsonGenerator;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonSerializer;
+import com.fasterxml.jackson.databind.SerializerProvider;
+import com.fasterxml.jackson.databind.SerializationFeature;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import java.io.IOException;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
+import java.time.format.DateTimeFormatter;
+import java.util.TimeZone;
+
+@Configuration
+public class JacksonConfig {
+
+    private static final DateTimeFormatter OFFSET_DATE_TIME_FORMATTER =
+            DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSXXX");
+
+    @Bean
+    public Jackson2ObjectMapperBuilderCustomizer utcOffsetDateTimeCustomizer() {
+        return builder -> {
+            // Ensure UTC baseline
+            builder.timeZone(TimeZone.getTimeZone("UTC"));
+            builder.serializationInclusion(JsonInclude.Include.NON_NULL);
+            builder.featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
+
+            // Force OffsetDateTime format globally (UTC -> "Z")
+            JavaTimeModule javaTimeModule = new JavaTimeModule();
+            javaTimeModule.addSerializer(OffsetDateTime.class, new JsonSerializer<>() {
+                @Override
+                public void serialize(OffsetDateTime value, JsonGenerator gen, SerializerProvider serializers)
+                        throws IOException {
+                    if (value == null) {
+                        gen.writeNull();
+                        return;
+                    }
+                    gen.writeString(value.format(OFFSET_DATE_TIME_FORMATTER));
+                }
+            });
+            javaTimeModule.addDeserializer(OffsetDateTime.class, new JsonDeserializer<>() {
+                @Override
+                public OffsetDateTime deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
+                    String raw = p.getValueAsString();
+                    if (raw == null || raw.isBlank()) {
+                        return null;
+                    }
+                    return OffsetDateTime.parse(raw, OFFSET_DATE_TIME_FORMATTER);
+                }
+            });
+
+            builder.modules(javaTimeModule);
+        };
+    }
+
+    /**
+     * Helper for normalizing an OffsetDateTime to UTC when needed.
+     * (Not wired automatically; kept for consistency utilities if required.)
+     */
+    public static OffsetDateTime normalizeToUtc(OffsetDateTime value) {
+        return value == null ? null : value.withOffsetSameInstant(ZoneOffset.UTC);
+    }
+}
+

src/main/java/zim/tave/memory/domain/Board.java

@@ -4,7 +4,8 @@
 import jakarta.persistence.*;
 import lombok.*;
 
-import java.time.LocalDateTime;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
 import java.util.ArrayList;
 import java.util.List;
 
@@ -23,9 +24,9 @@ public class Board {
     private String title;
 
     @Column(nullable = false, updatable = false)
-    private LocalDateTime createdAt;
+    private OffsetDateTime createdAt;
 
-    private LocalDateTime updatedAt;
+    private OffsetDateTime updatedAt;
 
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "userId", nullable = false)
@@ -40,11 +41,13 @@ public class Board {
 
     @PrePersist
     public void prePersist() {
-        createdAt = LocalDateTime.now();
+        if (this.createdAt == null) {
+            createdAt = OffsetDateTime.now(ZoneOffset.UTC);
+        }
     }
 
     @PreUpdate
     public void preUpdate() {
-        updatedAt = LocalDateTime.now();
+        updatedAt = OffsetDateTime.now(ZoneOffset.UTC);
     }
 }

src/main/java/zim/tave/memory/domain/Diary.java

@@ -5,7 +5,8 @@
 import lombok.Setter;
 import org.hibernate.annotations.BatchSize;
 
-import java.time.LocalDateTime;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
 import java.util.ArrayList;
 import java.util.List;
 
@@ -33,7 +34,7 @@ public class Diary {
     private String city;
 
     @Column(nullable = false)
-    private LocalDateTime dateTime;
+    private OffsetDateTime dateTime;
 
     @Lob
     @Column(nullable = false, length = 88)
@@ -54,14 +55,16 @@ public class Diary {
     private List<DiaryImage> diaryImages = new ArrayList<>();
 
     @Column(updatable = false)
-    private LocalDateTime createdAt;
+    private OffsetDateTime createdAt;
 
     @Column(nullable = false)
     private Boolean isStored;
 
     @PrePersist
     protected void onCreate() {
-        this.createdAt = LocalDateTime.now();
+        if (this.createdAt == null) {
+            this.createdAt = OffsetDateTime.now(ZoneOffset.UTC);
+        }
     }
 
     public void addDiaryImage(DiaryImage image) {
@@ -70,15 +73,15 @@ public void addDiaryImage(DiaryImage image) {
     }
 
     public static Diary createDiary(User user, Trip trip, Country country, String city,
-                                   LocalDateTime dateTime, String content) {
+                                   OffsetDateTime dateTime, String content) {
         Diary diary = new Diary();
         diary.setUser(user);
         diary.setTrip(trip);
         diary.setCountry(country);
         diary.setCity(city);
         diary.setDateTime(dateTime);
         diary.setContent(content != null ? content : ""); // content는 선택 필드이므로 null인 경우 빈 문자열로 처리
-        diary.setCreatedAt(dateTime != null ? dateTime : LocalDateTime.now());
+        diary.setCreatedAt(dateTime != null ? dateTime : OffsetDateTime.now(ZoneOffset.UTC));
         diary.setIsStored(false);
         return diary;
     }

src/main/java/zim/tave/memory/domain/Trip.java

@@ -7,6 +7,7 @@
 import lombok.Setter;
 
 import java.time.LocalDate;
+import java.time.ZoneOffset;
 import java.util.ArrayList;
 import java.util.List;
 
@@ -55,7 +56,7 @@ public class Trip {
     @PrePersist
     protected void onCreate() {
         if (this.startDate == null) {
-            this.startDate = LocalDate.now();
+            this.startDate = LocalDate.now(ZoneOffset.UTC);
         }
         if (this.endDate == null) {
             this.endDate = this.startDate;
@@ -76,8 +77,8 @@ public static Trip createTrip(User user, String tripName, String description, Tr
         trip.setTripName(tripName);
         trip.setDescription(description);
         trip.setTripTheme(tripTheme);
-        trip.setStartDate(LocalDate.now());
-        trip.setEndDate(LocalDate.now());
+        trip.setStartDate(LocalDate.now(ZoneOffset.UTC));
+        trip.setEndDate(LocalDate.now(ZoneOffset.UTC));
         return trip;
     }
 

src/main/java/zim/tave/memory/domain/VisitedCountry.java

@@ -5,7 +5,8 @@
 import lombok.NoArgsConstructor;
 import lombok.Setter;
 
-import java.time.LocalDateTime;
+import java.time.OffsetDateTime;
+import java.time.ZoneOffset;
 
 @Entity
 @Getter
@@ -19,7 +20,7 @@ public class VisitedCountry {
 
     private String color;
 
-    private LocalDateTime createdAt;
+    private OffsetDateTime createdAt;
 
     @ManyToOne(fetch = FetchType.LAZY)
     @JoinColumn(name = "userId")
@@ -35,6 +36,8 @@ public class VisitedCountry {
 
     @PrePersist
     protected void onCreate() {
-        this.createdAt = LocalDateTime.now();
+        if (this.createdAt == null) {
+            this.createdAt = OffsetDateTime.now(ZoneOffset.UTC);
+        }
     }
 }

src/main/java/zim/tave/memory/dto/request/CreateDiaryRequest.java

@@ -22,7 +22,6 @@
                   "tripId": 1,
                   "countryCode": "KR",
                   "city": "제주시",
-                  "dateTime": "2025-11-30T11:20:01.570Z",
                   "content": "오늘은 제주도에서 멋진 하루를 보냈다.",
                   "images": [
                     {
@@ -56,14 +55,6 @@ public class CreateDiaryRequest {
     @Schema(description = "도시명 (필수)", example = "제주시")
     private String city;
 
-    @Schema(
-            description = """
-                    일기 작성 날짜 및 시간 (ISO 8601 형식) : 자동 생성됩니다.
-                    """,
-            example = "2025-11-30T11:20:01.570Z"
-    )
-    private String dateTime;
-
     @Schema(description = "일기 내용", example = "오늘은 제주도에서 멋진 하루를 보냈다.")
     private String content;
 

src/main/java/zim/tave/memory/dto/response/BoardCreateResponseDto.java

@@ -6,8 +6,7 @@
 import lombok.NoArgsConstructor;
 import zim.tave.memory.domain.Board;
 
-import java.time.LocalDateTime;
-import java.time.format.DateTimeFormatter;
+import java.time.OffsetDateTime;
 
 @Getter
 @AllArgsConstructor
@@ -24,21 +23,19 @@ public class BoardCreateResponseDto {
     @Schema(description = "보드 테마 ID", example = "3")
     private Long boardThemeId;
 
-    @Schema(description = "보드 생성 시각", example = "2025-12-01T14:20:00")
-    private String createdAt;
+    @Schema(description = "보드 생성 시각 (UTC 기준, ISO-8601 형식). 프론트엔드에서는 사용자의 로컬 타임존으로 변환하여 표시해야 합니다.", example = "2025-12-01T14:20:00.000Z")
+    private OffsetDateTime createdAt;
 
-    @Schema(description = "보드 최종 수정 시각", example = "2025-12-01T14:20:00")
-    private String updatedAt;
+    @Schema(description = "보드 최종 수정 시각 (UTC 기준, ISO-8601 형식). 프론트엔드에서는 사용자의 로컬 타임존으로 변환하여 표시해야 합니다.", example = "2025-12-01T14:20:00.000Z")
+    private OffsetDateTime updatedAt;
 
     public static BoardCreateResponseDto from(Board board) {
-        DateTimeFormatter fmt = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
-
         return new BoardCreateResponseDto(
                 board.getBoardId(),
                 board.getTitle(),
                 board.getBoardTheme().getBoardThemeId(),
-                board.getCreatedAt().format(fmt),
-                board.getUpdatedAt().format(fmt)
+                board.getCreatedAt(),
+                board.getUpdatedAt()
         );
     }
 }

src/main/java/zim/tave/memory/dto/response/BoardDetailResponseDto.java

@@ -8,8 +8,7 @@
 import zim.tave.memory.domain.Board;
 import zim.tave.memory.domain.BoardStickerMap;
 
-import java.time.LocalDateTime;
-import java.time.format.DateTimeFormatter;
+import java.time.OffsetDateTime;
 import java.util.List;
 
 @Getter
@@ -31,25 +30,23 @@ public class BoardDetailResponseDto {
     @Schema(description = "테마 썸네일 URL")
     private String thumbnailUrl;
 
-    @Schema(description = "생성 시각")
-    private String createdAt;
+    @Schema(description = "생성 시각 (UTC 기준, ISO-8601 형식). 프론트엔드에서는 사용자의 로컬 타임존으로 변환하여 표시해야 합니다.", example = "2025-12-01T14:20:00.000Z")
+    private OffsetDateTime createdAt;
 
-    @Schema(description = "수정 시각")
-    private String updatedAt;
+    @Schema(description = "수정 시각 (UTC 기준, ISO-8601 형식). 프론트엔드에서는 사용자의 로컬 타임존으로 변환하여 표시해야 합니다.", example = "2025-12-01T17:30:00.000Z")
+    private OffsetDateTime updatedAt;
 
     @Schema(description = "스티커 목록")
     private List<BoardStickerDetailDto> stickers;
 
     public static BoardDetailResponseDto from(Board board, List<BoardStickerMap> stickerMaps) {
-        DateTimeFormatter fmt = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
-
         return BoardDetailResponseDto.builder()
                 .boardId(board.getBoardId())
                 .title(board.getTitle())
                 .boardThemeId(board.getBoardTheme().getBoardThemeId())
                 .thumbnailUrl(board.getBoardTheme().getThumbnailUrl())
-                .createdAt(board.getCreatedAt().format(fmt))
-                .updatedAt(board.getUpdatedAt().format(fmt))
+                .createdAt(board.getCreatedAt())
+                .updatedAt(board.getUpdatedAt())
                 .stickers(stickerMaps.stream()
                         .map(BoardStickerDetailDto::from)
                         .toList())