feat: 정책, 클라이언트 settings 정보 조회 api 구축

# 변경점 👍

- GET /api/users/init-settings : 클라이언트(Android, IOS)에 맞는 버전 충족 여부, 필수 약관
동의 여부 및 초기 태그 설정 여부 조회
- POST /api/users/policy-agreement : 약관 동의 api
- 약관 종류는 enum인 PolicyType으로 관리하고 revision으로 약관 버전을 관리해서 필요 시 재동의 유도하도록
구성했습니다.
- 기존 유저는 tag값을 변경할 필요가 없기에 앞으로 신규 유저들만 UserInitSettingEntity를 만들어서 tag
설정 여부를 확인합니다.
 
# 비고 ✏
- 현재는 figma 상 보이는 2개의 약관만 정의해두었고, 필요 시 enum 값 추가 가능합니다.
- 현재는 클라이언트 최소요구버전, 최신버전 모두 1.0.0으로 둬서 needsOptionalUpdate,
needsForseUpdate 모두 항상 false 입니다.

Author: sinsehwan

src/main/java/apptive/team5/global/exception/ExceptionCode.java

@@ -21,7 +21,8 @@ public enum ExceptionCode {
     BAD_SUBSCRIBE_REQUEST("자기 자신은 구독할 수 없습니다."),
     DUPLICATE_SUBSCRIBE_REQUEST("이미 구독한 회원입니다."),
     INVALID_DIARY_LIST("유효하지 않은 다이어리 ID가 포함되어 있습니다."),
-    DUPLICATE_DIARY_REPORT("이미 신고한 게시글입니다.");
+    DUPLICATE_DIARY_REPORT("이미 신고한 게시글입니다."),
+    REQUIRED_POLICY_NOT_AGREED("필수 약관에 동의해야 합니다.");
 
     private final String description;
 

src/main/java/apptive/team5/user/controller/UserController.java

@@ -1,12 +1,20 @@
 package apptive.team5.user.controller;
 
 import apptive.team5.file.dto.FileUploadRequest;
+import apptive.team5.user.dto.InitSettingsRequest;
+import apptive.team5.user.dto.InitSettingsResponse;
+import apptive.team5.user.dto.InitSettingsResponse.AppUpdateStatus;
+import apptive.team5.user.dto.PolicyAgreementRequest;
+import apptive.team5.user.dto.PolicyStatusResponse;
 import apptive.team5.user.dto.UserResponse;
 import apptive.team5.user.dto.UserSearchResponse;
 import apptive.team5.user.dto.UserStaticsResponse;
 import apptive.team5.user.dto.UserTagUpdateRequest;
+import apptive.team5.user.service.UserInitSettingService;
+import apptive.team5.user.service.UserPolicyService;
 import apptive.team5.user.service.UserService;
 import jakarta.validation.Valid;
+import java.util.List;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.PageRequest;
@@ -21,6 +29,8 @@
 public class UserController {
 
     private final UserService userService;
+    private final UserPolicyService userPolicyService;
+    private final UserInitSettingService userInitSettingService;
 
     @GetMapping("/my")
     public ResponseEntity<UserResponse> getMyInfo(@AuthenticationPrincipal Long userId) {
@@ -82,4 +92,25 @@ public ResponseEntity<UserStaticsResponse> getUserStatics(@PathVariable Long use
 
         return ResponseEntity.status(HttpStatus.OK).body(response);
     }
+
+    @GetMapping("/init-settings")
+    public ResponseEntity<InitSettingsResponse> getInitSettings(@AuthenticationPrincipal Long userId,
+                                                                @Valid @ModelAttribute InitSettingsRequest request) {
+
+        AppUpdateStatus appUpdateStatus = userInitSettingService.checkAppUpdate(request.clientType(), request.clientVersion());
+        List<PolicyStatusResponse> policies = userPolicyService.getPolicyStatuses(userId);
+        boolean needsPolicyAgreement = policies.stream().anyMatch(PolicyStatusResponse::needsUpdate);
+        boolean needsTagSetup = userInitSettingService.checkNeedsTagSetup(userId);
+
+        return ResponseEntity.ok(new InitSettingsResponse(appUpdateStatus, needsPolicyAgreement, needsTagSetup, policies));
+    }
+
+    @PostMapping("/policy-agreement")
+    public ResponseEntity<Void> agreePolicy(@Valid @RequestBody PolicyAgreementRequest request,
+                                            @AuthenticationPrincipal Long userId) {
+
+        userPolicyService.agreePolicy(userId, request);
+
+        return ResponseEntity.status(HttpStatus.OK).build();
+    }
 }

src/main/java/apptive/team5/user/domain/ClientType.java

@@ -0,0 +1,5 @@
+package apptive.team5.user.domain;
+
+public enum ClientType {
+    ANDROID, IOS
+}

src/main/java/apptive/team5/user/domain/ClientVersion.java

@@ -0,0 +1,24 @@
+package apptive.team5.user.domain;
+
+import java.util.Map;
+
+public class ClientVersion {
+
+    private static final Map<ClientType, String> MIN_VERSION = Map.of(
+            ClientType.ANDROID, "1.0.0",
+            ClientType.IOS, "1.0.0"
+    );
+
+    private static final Map<ClientType, String> LATEST_VERSION = Map.of(
+            ClientType.ANDROID, "1.0.0",
+            ClientType.IOS, "1.0.0"
+    );
+
+    public static String getMinVersion(ClientType type) {
+        return MIN_VERSION.get(type);
+    }
+
+    public static String getLatestVersion(ClientType type) {
+        return LATEST_VERSION.get(type);
+    }
+}

src/main/java/apptive/team5/user/domain/PolicyRevision.java

@@ -0,0 +1,15 @@
+package apptive.team5.user.domain;
+
+import java.util.Map;
+
+public class PolicyRevision {
+
+    private static final Map<PolicyType, Long> LATEST = Map.of(
+            PolicyType.SERVICE_TERMS, 1L,
+            PolicyType.PRIVACY, 1L
+    );
+
+    public static Long getLatest(PolicyType type) {
+        return LATEST.get(type);
+    }
+}

src/main/java/apptive/team5/user/domain/PolicyType.java

@@ -0,0 +1,17 @@
+package apptive.team5.user.domain;
+
+public enum PolicyType {
+
+    SERVICE_TERMS(true),
+    PRIVACY(true);
+
+    private final boolean required;
+
+    PolicyType(boolean required) {
+        this.required = required;
+    }
+
+    public boolean isRequired() {
+        return required;
+    }
+}

src/main/java/apptive/team5/user/domain/UserInitSettingEntity.java

@@ -0,0 +1,33 @@
+package apptive.team5.user.domain;
+
+import apptive.team5.global.entity.BaseTimeEntity;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+public class UserInitSettingEntity extends BaseTimeEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @OneToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "user_id", nullable = false, unique = true)
+    private UserEntity userEntity;
+
+    @Column(nullable = false)
+    private Boolean isTagSet;
+
+    public UserInitSettingEntity(UserEntity userEntity, boolean isTagSet) {
+        this.userEntity = userEntity;
+        this.isTagSet = isTagSet;
+    }
+
+    public void markTagSet() {
+        this.isTagSet = true;
+    }
+}

src/main/java/apptive/team5/user/domain/UserPolicyAgreementEntity.java

@@ -0,0 +1,54 @@
+package apptive.team5.user.domain;
+
+import apptive.team5.global.entity.BaseTimeEntity;
+import jakarta.persistence.*;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+@Getter
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Table(uniqueConstraints = @UniqueConstraint(columnNames = {"user_id", "policy_type"}))
+public class UserPolicyAgreementEntity extends BaseTimeEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "user_id", nullable = false)
+    private UserEntity userEntity;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "policy_type", nullable = false)
+    private PolicyType policyType;
+
+    @Column(nullable = false)
+    private Boolean agreed;
+
+    @Column(nullable = false)
+    private Long revision;
+
+    private LocalDateTime agreedAt;
+
+    public UserPolicyAgreementEntity(UserEntity userEntity, PolicyType policyType, boolean agreed, Long revision) {
+        this.userEntity = userEntity;
+        this.policyType = policyType;
+        this.agreed = agreed;
+        this.revision = revision;
+        this.agreedAt = agreed ? LocalDateTime.now() : null;
+    }
+
+    public void updateAgreement(boolean agreed, Long revision) {
+        this.agreed = agreed;
+        this.revision = revision;
+        this.agreedAt = agreed ? LocalDateTime.now() : null;
+    }
+
+    public boolean needsUpdate(Long latestRevision) {
+        return !agreed || revision < latestRevision;
+    }
+}

src/main/java/apptive/team5/user/dto/AgreementItem.java

@@ -0,0 +1,14 @@
+package apptive.team5.user.dto;
+
+import apptive.team5.user.domain.PolicyType;
+import jakarta.validation.constraints.NotNull;
+
+public record AgreementItem(
+
+        @NotNull(message = "약관 종류는 필수입니다.")
+        PolicyType policyType,
+
+        @NotNull(message = "동의 여부는 필수입니다.")
+        Boolean agreed
+) {
+}

src/main/java/apptive/team5/user/dto/InitSettingsRequest.java

@@ -0,0 +1,14 @@
+package apptive.team5.user.dto;
+
+import apptive.team5.user.domain.ClientType;
+import jakarta.validation.constraints.NotNull;
+
+public record InitSettingsRequest(
+
+        @NotNull(message = "클라이언트 타입은 필수입니다.")
+        ClientType clientType,
+
+        @NotNull(message = "클라이언트 버전은 필수입니다.")
+        String clientVersion
+) {
+}