앱 버전 관리 기능 구현

src/lombok.config

@@ -0,0 +1 @@
+lombok.copyableAnnotations += org.springframework.beans.factory.annotation.Value

src/main/java/com/coniverse/dangjang/domain/version/controller/VersionController.java

@@ -0,0 +1,52 @@
+package com.coniverse.dangjang.domain.version.controller;
+
+import org.springframework.http.HttpStatus;
+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.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.coniverse.dangjang.domain.version.dto.request.VersionRequest;
+import com.coniverse.dangjang.domain.version.dto.response.VersionResponse;
+import com.coniverse.dangjang.domain.version.service.VersionService;
+import com.coniverse.dangjang.global.dto.SuccessSingleResponse;
+
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+
+/**
+ * 앱 버전 관련 controller
+ *
+ * @author TEO
+ * @since 1.3.0
+ */
+@RestController
+@RequestMapping("/api/version")
+@RequiredArgsConstructor
+public class VersionController {
+	private final VersionService versionService;
+
+	/**
+	 * 버전 정보를 GET 요청한다.
+	 *
+	 * @since 1.3.0
+	 */
+	@GetMapping("/intro")
+	public ResponseEntity<SuccessSingleResponse<VersionResponse<?>>> getIntro() {
+		VersionResponse<?> versionResponse = versionService.getVersionResponse();
+		return ResponseEntity.ok().body(new SuccessSingleResponse<>(HttpStatus.OK.getReasonPhrase(), versionResponse));
+	}
+
+	/**
+	 * 버전 정보를 POST 요청한다.
+	 *
+	 * @since 1.3.0
+	 */
+	@PostMapping
+	public ResponseEntity<SuccessSingleResponse<VersionResponse<?>>> postVersion(@Valid @RequestBody VersionRequest request) {
+		VersionResponse<?> versionResponse = versionService.saveVersion(request);
+		return ResponseEntity.ok().body(new SuccessSingleResponse<>(HttpStatus.OK.getReasonPhrase(), versionResponse));
+	}
+}

src/main/java/com/coniverse/dangjang/domain/version/dto/request/VersionRequest.java

@@ -0,0 +1,14 @@
+package com.coniverse.dangjang.domain.version.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+
+/**
+ * 앱 버전 post dto
+ *
+ * @author TEO
+ * @since 1.3.0
+ */
+public record VersionRequest(@NotBlank @Pattern(regexp = "^\\d\\.\\d\\.\\d$") String minVersion,
+							 @NotBlank @Pattern(regexp = "^\\d\\.\\d\\.\\d$") String latestVersion, @NotBlank String key) {
+}

src/main/java/com/coniverse/dangjang/domain/version/dto/response/VersionResponse.java

@@ -0,0 +1,18 @@
+package com.coniverse.dangjang.domain.version.dto.response;
+
+import java.util.List;
+
+import com.coniverse.dangjang.domain.version.entity.Version;
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * 버전 정보를 반환하는 dto이다.
+ *
+ * @author TEO
+ * @since 1.3.0
+ */
+public record VersionResponse<T>(String minVersion, String latestVersion, @JsonInclude(JsonInclude.Include.NON_NULL) List<T> loadData) {
+	public VersionResponse(Version version, List<T> loadData) {
+		this(version.getMinVersion(), version.getLatestVersion(), loadData);
+	}
+}

src/main/java/com/coniverse/dangjang/domain/version/entity/Version.java

@@ -0,0 +1,38 @@
+package com.coniverse.dangjang.domain.version.entity;
+
+import java.time.LocalDateTime;
+
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import jakarta.persistence.Entity;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.Id;
+import lombok.AccessLevel;
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+/**
+ * app version entity
+ *
+ * @author TEO
+ * @since 1.3.0
+ */
+@Entity
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@EntityListeners(AuditingEntityListener.class)
+public class Version {
+	@Id
+	@CreatedDate
+	private LocalDateTime createdAt;
+	private String minVersion;
+	private String latestVersion;
+
+	@Builder
+	private Version(String minVersion, String latestVersion) {
+		this.minVersion = minVersion;
+		this.latestVersion = latestVersion;
+	}
+}

src/main/java/com/coniverse/dangjang/domain/version/repository/VersionRepository.java

@@ -0,0 +1,22 @@
+package com.coniverse.dangjang.domain.version.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import com.coniverse.dangjang.domain.version.entity.Version;
+
+/**
+ * app version repository
+ *
+ * @author TEO
+ * @since 1.3.0
+ */
+public interface VersionRepository extends JpaRepository<Version, Long> {
+
+	/**
+	 * 가장 최근의 버전 정보를 반환한다.
+	 *
+	 * @return Version
+	 * @since 1.3.0
+	 */
+	Version findFirstByOrderByCreatedAtDesc();
+}

src/main/java/com/coniverse/dangjang/domain/version/service/VersionService.java

@@ -0,0 +1,69 @@
+package com.coniverse.dangjang.domain.version.service;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.coniverse.dangjang.domain.version.dto.request.VersionRequest;
+import com.coniverse.dangjang.domain.version.dto.response.VersionResponse;
+import com.coniverse.dangjang.domain.version.entity.Version;
+import com.coniverse.dangjang.domain.version.repository.VersionRepository;
+
+import lombok.RequiredArgsConstructor;
+
+/**
+ * 앱 버전 관련 service
+ *
+ * @author TEO
+ * @since 1.3.0
+ */
+@Service
+@RequiredArgsConstructor
+@Transactional
+public class VersionService {
+	private final VersionRepository versionRepository;
+	@Value("${version.key}")
+	private final String serverKey;
+
+	/**
+	 * 가장 최근의 버전 정보를 반환한다.
+	 *
+	 * @return VersionResponse
+	 * @since 1.0.0
+	 */
+	@Transactional(readOnly = true)
+	public VersionResponse<?> getVersionResponse() {
+		Version version = versionRepository.findFirstByOrderByCreatedAtDesc();
+		return new VersionResponse<>(version, null);
+	}
+
+	/**
+	 * 버전 정보를 저장한다.
+	 *
+	 * @param request 버전 정보
+	 * @return VersionResponse
+	 * @since 1.3.0
+	 */
+	public VersionResponse<?> saveVersion(VersionRequest request) {
+		validateKey(request.key());
+		Version version = Version.builder()
+			.minVersion(request.minVersion())
+			.latestVersion(request.latestVersion())
+			.build();
+		versionRepository.save(version);
+		return new VersionResponse<>(version, null);
+	}
+
+	/**
+	 * 버전 정보의 키 값을 확인한다.
+	 *
+	 * @param key 버전 키
+	 * @throws IllegalArgumentException 서버 키가 아닐 경우
+	 * @since 1.3.0
+	 */
+	private void validateKey(String key) {
+		if (!key.equals(serverKey)) {
+			throw new IllegalArgumentException("올바르지 않은 키 값입니다.");
+		}
+	}
+}

src/main/resources/data-dev.sql

@@ -44,3 +44,6 @@ VALUES ("11111111", "fcmToken1", '2023-10-08'),
 --        ("체중 기록!", "오늘 체중을 기록해보세요 ~ ", '2023-10-08', "기록", "22222222", true),
 --        ("접속해주세요!", "오늘은 접속 안하셨네요 ~ 접속해서 포인트 받아가세요", '2023-10-09', "접속", "22222222", false),
 --        ("운동 기록 !", "오늘 운동을 기록해보세요 ~ ", '2023-10-10', "기록", "11111111", false);
+
+INSERT INTO version(created_at, min_version, latest_version)
+VALUES (now(), "1.0.0", "1.0.0");