[MERGE] Merge pull request #234 from Team-WSS/feat/#233

[FEAT] 최소 지원 버전 API 구현

Author: ChaeAg

src/main/java/org/websoso/WSSServer/config/SecurityConfig.java

@@ -41,7 +41,8 @@ public class SecurityConfig {
             "/login/callback",
             "/login/apple",
             "/auth/login/kakao",
-            "/auth/login/apple"
+            "/auth/login/apple",
+            "/minimum-version"
     };
 
     @Bean

src/main/java/org/websoso/WSSServer/controller/AppVersionController.java

@@ -0,0 +1,38 @@
+package org.websoso.WSSServer.controller;
+
+import static org.springframework.http.HttpStatus.NO_CONTENT;
+import static org.springframework.http.HttpStatus.OK;
+
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.websoso.WSSServer.dto.AppVersion.MinimumVersionGetResponse;
+import org.websoso.WSSServer.dto.AppVersion.MinimumVersionUpdateRequest;
+import org.websoso.WSSServer.service.AppVersionService;
+
+@RestController
+@RequiredArgsConstructor
+public class AppVersionController {
+
+    private final AppVersionService appVersionService;
+
+    @GetMapping("/minimum-version")
+    public ResponseEntity<MinimumVersionGetResponse> getMinimumVersion(@RequestParam String os) {
+        return ResponseEntity
+                .status(OK)
+                .body(appVersionService.getMinimumVersion(os));
+    }
+
+    @PostMapping("/minimum-version")
+    public ResponseEntity<Void> updateMinimumVersion(@Valid @RequestBody MinimumVersionUpdateRequest request) {
+        appVersionService.updateMinimumVersion(request);
+        return ResponseEntity
+                .status(NO_CONTENT)
+                .build();
+    }
+}

src/main/java/org/websoso/WSSServer/domain/MinimumVersion.java

@@ -0,0 +1,49 @@
+package org.websoso.WSSServer.domain;
+
+import static jakarta.persistence.EnumType.STRING;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.Enumerated;
+import jakarta.persistence.Id;
+import java.time.LocalDateTime;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+import org.websoso.WSSServer.domain.common.OS;
+
+@Entity
+@Getter
+@EntityListeners(AuditingEntityListener.class)
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class MinimumVersion {
+
+    @Id
+    @Enumerated(STRING)
+    @Column(columnDefinition = "varchar(10)", nullable = false)
+    private OS os;
+
+    @Column(columnDefinition = "varchar(20)", nullable = false)
+    private String minimumVersion;
+
+    @LastModifiedDate
+    @Column(nullable = false)
+    private LocalDateTime updateDate;
+
+    private MinimumVersion(OS os, String minimumVersion) {
+        this.os = os;
+        this.minimumVersion = minimumVersion;
+        this.updateDate = LocalDateTime.now();
+    }
+
+    public static MinimumVersion create(OS os, String minimumVersion) {
+        return new MinimumVersion(os, minimumVersion);
+    }
+
+    public void updateMinimumVersion(String minimumVersion) {
+        this.minimumVersion = minimumVersion;
+    }
+}

src/main/java/org/websoso/WSSServer/domain/common/OS.java

@@ -0,0 +1,26 @@
+package org.websoso.WSSServer.domain.common;
+
+import static org.websoso.WSSServer.exception.error.CustomMinimumVersionError.OS_NOT_FOUND;
+
+import java.util.Arrays;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.websoso.WSSServer.exception.exception.CustomMinimumVersionException;
+
+@Getter
+@AllArgsConstructor
+public enum OS {
+
+    ANDROID("android"),
+    IOS("ios");
+
+    private final String label;
+
+    public static OS fromLabel(String osLabel) {
+        return Arrays.stream(OS.values())
+                .filter(os -> os.label.equalsIgnoreCase(osLabel))
+                .findFirst()
+                .orElseThrow(() -> new CustomMinimumVersionException(OS_NOT_FOUND,
+                        "the requested OS value is invalid or not supported"));
+    }
+}

src/main/java/org/websoso/WSSServer/dto/AppVersion/MinimumVersionGetResponse.java

@@ -0,0 +1,19 @@
+package org.websoso.WSSServer.dto.AppVersion;
+
+import java.time.format.DateTimeFormatter;
+import org.websoso.WSSServer.domain.MinimumVersion;
+
+public record MinimumVersionGetResponse(
+        String minimumVersion,
+        String updateDate
+) {
+
+    private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd");
+
+    public static MinimumVersionGetResponse of(MinimumVersion minimumVersion) {
+        return new MinimumVersionGetResponse(
+                minimumVersion.getMinimumVersion(),
+                minimumVersion.getUpdateDate().format(FORMATTER)
+        );
+    }
+}

src/main/java/org/websoso/WSSServer/dto/AppVersion/MinimumVersionUpdateRequest.java

@@ -0,0 +1,11 @@
+package org.websoso.WSSServer.dto.AppVersion;
+
+import jakarta.validation.constraints.NotBlank;
+
+public record MinimumVersionUpdateRequest(
+        @NotBlank(message = "os는 비어 있거나, 공백일 수 없습니다.")
+        String os,
+        @NotBlank(message = "최소 지원 버전은 비어 있거나, 공백일 수 없습니다.")
+        String minimumVersion
+) {
+}

src/main/java/org/websoso/WSSServer/exception/error/CustomMinimumVersionError.java

@@ -0,0 +1,21 @@
+package org.websoso.WSSServer.exception.error;
+
+import static org.springframework.http.HttpStatus.BAD_REQUEST;
+import static org.springframework.http.HttpStatus.NOT_FOUND;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+import org.websoso.WSSServer.exception.common.ICustomError;
+
+@AllArgsConstructor
+@Getter
+public enum CustomMinimumVersionError implements ICustomError {
+
+    OS_NOT_FOUND("MINIMUM-VERSION-001", "요청한 OS 값을 찾을 수 없습니다.", NOT_FOUND),
+    MINIMUM_VERSION_NOT_FOUND("MINIMUM-VERSION-002", "해당 OS에 대한 최소 지원 버전을 찾을 수 없습니다.", BAD_REQUEST);
+
+    private final String code;
+    private final String description;
+    private final HttpStatus statusCode;
+}

src/main/java/org/websoso/WSSServer/exception/exception/CustomMinimumVersionException.java

@@ -0,0 +1,13 @@
+package org.websoso.WSSServer.exception.exception;
+
+import lombok.Getter;
+import org.websoso.WSSServer.exception.common.AbstractCustomException;
+import org.websoso.WSSServer.exception.error.CustomMinimumVersionError;
+
+@Getter
+public class CustomMinimumVersionException extends AbstractCustomException {
+
+    public CustomMinimumVersionException(CustomMinimumVersionError customMinimumVersionError, String message) {
+        super(customMinimumVersionError, message);
+    }
+}

src/main/java/org/websoso/WSSServer/repository/MinimumVersionRepository.java

@@ -0,0 +1,10 @@
+package org.websoso.WSSServer.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+import org.websoso.WSSServer.domain.MinimumVersion;
+import org.websoso.WSSServer.domain.common.OS;
+
+@Repository
+public interface MinimumVersionRepository extends JpaRepository<MinimumVersion, OS> {
+}

src/main/java/org/websoso/WSSServer/service/AppVersionService.java

@@ -0,0 +1,41 @@
+package org.websoso.WSSServer.service;
+
+import static org.websoso.WSSServer.exception.error.CustomMinimumVersionError.MINIMUM_VERSION_NOT_FOUND;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.websoso.WSSServer.domain.MinimumVersion;
+import org.websoso.WSSServer.domain.common.OS;
+import org.websoso.WSSServer.dto.AppVersion.MinimumVersionGetResponse;
+import org.websoso.WSSServer.dto.AppVersion.MinimumVersionUpdateRequest;
+import org.websoso.WSSServer.exception.exception.CustomMinimumVersionException;
+import org.websoso.WSSServer.repository.MinimumVersionRepository;
+
+@Service
+@RequiredArgsConstructor
+@Transactional
+public class AppVersionService {
+
+    private final MinimumVersionRepository minimumVersionRepository;
+
+    @Transactional(readOnly = true)
+    public MinimumVersionGetResponse getMinimumVersion(String os) {
+        return MinimumVersionGetResponse.of(minimumVersionRepository.findById(OS.fromLabel(os))
+                .orElseThrow(() -> new CustomMinimumVersionException(MINIMUM_VERSION_NOT_FOUND,
+                        "the minimum supported version for the specified OS could not be found")));
+    }
+
+    public void updateMinimumVersion(MinimumVersionUpdateRequest request) {
+        OS os = OS.fromLabel(request.os());
+        MinimumVersion minimumVersion = minimumVersionRepository.findById(os).orElse(null);
+
+        if (minimumVersion == null) {
+            minimumVersion = MinimumVersion.create(os, request.minimumVersion());
+        } else {
+            minimumVersion.updateMinimumVersion(request.minimumVersion());
+        }
+
+        minimumVersionRepository.save(minimumVersion);
+    }
+}