Merge pull request #13 from Block-Guard/chore/#12/jpa-entity

chaeyuuu · web-flow · commit 24db5e999226 · 2025-07-14T18:01:20.000+09:00
[Chore] JPA Entity 작성
diff --git a/build.gradle b/build.gradle
@@ -29,6 +29,7 @@ dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-web'
 	implementation 'org.springframework.boot:spring-boot-starter-actuator'
 	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0'
+	implementation 'org.springframework.boot:spring-boot-starter-validation'
 	compileOnly 'org.projectlombok:lombok'
 	runtimeOnly 'com.mysql:mysql-connector-j'
 	annotationProcessor 'org.projectlombok:lombok'
diff --git a/src/main/java/com/blockguard/server/domain/analysis/domain/FraudAnalysisRecord.java b/src/main/java/com/blockguard/server/domain/analysis/domain/FraudAnalysisRecord.java
@@ -0,0 +1,42 @@
+package com.blockguard.server.domain.analysis.domain;
+
+import com.blockguard.server.domain.analysis.domain.enums.FraudType;
+import com.blockguard.server.domain.analysis.domain.enums.RiskLevel;
+import com.blockguard.server.domain.user.domain.User;
+import com.blockguard.server.global.common.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.math.BigDecimal;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@Getter
+@Table(name = "fraud_analysis_records")
+public class FraudAnalysisRecord extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(nullable = false)
+    private Long id;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "risk_level", nullable = false)
+    private RiskLevel riskLevel;
+
+    @Column(nullable = false, precision = 5, scale = 2)
+    private BigDecimal score;
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "estimated_fraud_type", nullable = false)
+    private FraudType estimatedFraudType;
+
+    @Column(nullable = false, length = 255)
+    private String keywords;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "user_id", nullable = false)
+    private User user;
+}
diff --git a/src/main/java/com/blockguard/server/domain/analysis/domain/enums/FraudType.java b/src/main/java/com/blockguard/server/domain/analysis/domain/enums/FraudType.java
@@ -0,0 +1,9 @@
+package com.blockguard.server.domain.analysis.domain.enums;
+
+// Todo: 사기 클래스 확정 후 변경
+public enum FraudType {
+    PROSECUTOR_IMPERSONATION,
+    FAMILY_IMPERSONATION,
+    LOAN_FRAUD,
+    CARD_DELIVERY_IMPERSONATION
+}
diff --git a/src/main/java/com/blockguard/server/domain/analysis/domain/enums/RiskLevel.java b/src/main/java/com/blockguard/server/domain/analysis/domain/enums/RiskLevel.java
@@ -0,0 +1,5 @@
+package com.blockguard.server.domain.analysis.domain.enums;
+
+public enum RiskLevel {
+    Dangers, Caution, Safety
+}
diff --git a/src/main/java/com/blockguard/server/domain/auth/api/AuthApi.java b/src/main/java/com/blockguard/server/domain/auth/api/AuthApi.java
@@ -10,6 +10,7 @@
 import com.blockguard.server.global.config.swagger.CustomExceptionDescription;
 import com.blockguard.server.global.config.swagger.SwaggerResponseDescription;
 import io.swagger.v3.oas.annotations.Operation;
+import jakarta.validation.Valid;
 import lombok.AllArgsConstructor;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -26,7 +27,7 @@ public class AuthApi {
     @Operation(summary = "회원가입")
     @CustomExceptionDescription(SwaggerResponseDescription.REGISTER_FAIL)
     @PostMapping("/register")
-    public ResponseEntity<BaseResponse<RegisterResponse>> register(@RequestBody RegisterRequest registerRequest) {
+    public ResponseEntity<BaseResponse<RegisterResponse>> register(@Valid @RequestBody RegisterRequest registerRequest) {
         RegisterResponse registerResponse = authService.register(registerRequest);
         return ResponseEntity.ok(BaseResponse.of(SuccessCode.USER_REGISTERED, registerResponse));
 
diff --git a/src/main/java/com/blockguard/server/domain/fraud/domain/FraudPhoneNumber.java b/src/main/java/com/blockguard/server/domain/fraud/domain/FraudPhoneNumber.java
@@ -0,0 +1,32 @@
+package com.blockguard.server.domain.fraud.domain;
+
+import com.blockguard.server.global.common.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@Getter
+@Table(name = "fraud_phone_numbers")
+public class FraudPhoneNumber extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(nullable = false)
+    private Long id;
+
+    @Column(name = "phone_number", nullable = false, length = 20, unique = true)
+    private String phoneNumber;
+
+    // Todo: Open API 제공자 추후 enum type 변경
+    @Column(nullable = false, length = 100)
+    private String provider;
+
+    @Column(name = "last_checked_at", nullable = false)
+    private LocalDateTime lastCheckedAt;
+
+}
diff --git a/src/main/java/com/blockguard/server/domain/fraud/domain/FraudUrl.java b/src/main/java/com/blockguard/server/domain/fraud/domain/FraudUrl.java
@@ -0,0 +1,32 @@
+package com.blockguard.server.domain.fraud.domain;
+
+import com.blockguard.server.global.common.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@Getter
+@Table(name = "fraud_urls")
+public class FraudUrl extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(nullable = false)
+    private Long id;
+
+    @Column(nullable = false, columnDefinition = "TEXT", unique = true)
+    private String url;
+
+    // Todo: Open API 제공자 추후 enum type 변경
+    @Column(nullable = false, length = 100)
+    private String provider;
+
+    @Column(name = "last_checked_at", nullable = false)
+    private LocalDateTime lastCheckedAt;
+
+}
diff --git a/src/main/java/com/blockguard/server/domain/guardian/domain/Guardian.java b/src/main/java/com/blockguard/server/domain/guardian/domain/Guardian.java
@@ -0,0 +1,47 @@
+package com.blockguard.server.domain.guardian.domain;
+
+import com.blockguard.server.domain.user.domain.User;
+import com.blockguard.server.global.common.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+import org.hibernate.annotations.SQLRestriction;
+
+import java.time.LocalDateTime;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@Getter
+@SQLRestriction("deleted_at IS NULL")
+@Table(name = "guardians")
+public class Guardian extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(nullable = false)
+    private Long id;
+
+    @Column(nullable = false, length = 50)
+    private String name;
+
+    @Column(name = "phone_number", nullable = false, length = 20)
+    private String phoneNumber;
+
+    @Column(name = "profile_image_key", length = 512)
+    private String profileImageKey;
+
+    @Column(name = "is_primary", nullable = false)
+    private boolean isPrimary = false;
+
+    @Column(name = "deleted_at")
+    private LocalDateTime deletedAt = null;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "user_id", nullable = false)
+    private User user;
+
+    public void markDeleted() {
+        this.deletedAt = LocalDateTime.now();
+    }
+}
diff --git a/src/main/java/com/blockguard/server/domain/news/domain/NewsArticle.java b/src/main/java/com/blockguard/server/domain/news/domain/NewsArticle.java
@@ -0,0 +1,33 @@
+package com.blockguard.server.domain.news.domain;
+
+import com.blockguard.server.global.common.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@Getter
+@Table(name = "news_articles")
+public class NewsArticle extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(nullable = false)
+    private Long id;
+
+    @Column(nullable = false, length = 500)
+    private String title;
+
+    @Column(nullable = false, length = 1000, unique = true)
+    private String url;
+
+    @Column(name = "published_at", nullable = false)
+    private LocalDateTime publishedAt;
+
+    @Column(nullable = false, length = 100)
+    private String newspaper;
+}
diff --git a/src/main/java/com/blockguard/server/domain/report/domain/UserReportRecord.java b/src/main/java/com/blockguard/server/domain/report/domain/UserReportRecord.java
@@ -0,0 +1,32 @@
+package com.blockguard.server.domain.report.domain;
+
+import com.blockguard.server.domain.user.domain.User;
+import com.blockguard.server.domain.report.domain.enums.ReportStep;
+import com.blockguard.server.global.common.entity.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+
+@Entity
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@AllArgsConstructor
+@Builder
+@Getter
+@Table(name = "user_report_records")
+public class UserReportRecord extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(nullable = false)
+    private Long id;
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false)
+    private ReportStep step;
+
+    @Column(name = "is_completed", nullable = false)
+    private boolean isCompleted = false;
+
+    @ManyToOne(fetch = FetchType.LAZY, optional = false)
+    @JoinColumn(name = "user_id", nullable = false)
+    private User user;
+}
diff --git a/src/main/java/com/blockguard/server/domain/report/domain/enums/ReportStep.java b/src/main/java/com/blockguard/server/domain/report/domain/enums/ReportStep.java
@@ -0,0 +1,8 @@
+package com.blockguard.server.domain.report.domain.enums;
+
+public enum ReportStep {
+    STEP1,
+    STEP2,
+    STEP3,
+    STEP4
+}
diff --git a/src/main/java/com/blockguard/server/domain/user/domain/User.java b/src/main/java/com/blockguard/server/domain/user/domain/User.java
@@ -1,19 +1,27 @@
 package com.blockguard.server.domain.user.domain;
 
+import com.blockguard.server.domain.analysis.domain.FraudAnalysisRecord;
+import com.blockguard.server.domain.guardian.domain.Guardian;
 import com.blockguard.server.domain.user.domain.enums.Gender;
+import com.blockguard.server.domain.report.domain.UserReportRecord;
+import com.blockguard.server.global.common.entity.BaseEntity;
 import jakarta.persistence.*;
 import lombok.*;
+import org.hibernate.annotations.SQLRestriction;
 
 import java.time.LocalDate;
 import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.List;
 
 @Entity
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 @AllArgsConstructor
 @Builder
 @Getter
-@Table(name = "user")
-public class User {
+@SQLRestriction("deleted_at IS NULL")
+@Table(name = "users")
+public class User extends BaseEntity {
     @Id
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     @Column(nullable = false)
@@ -28,7 +36,7 @@ public class User {
     @Column(nullable = false, length = 255)
     private String password;
 
-    @Column(name = "phone_number", nullable = false)
+    @Column(name = "phone_number", nullable = false, length = 20)
     private String phoneNumber;
 
     @Column(name = "birth_date", nullable = false)
@@ -38,22 +46,25 @@ public class User {
     @Column(nullable = false)
     private Gender gender;
 
-    @Column(name = "created_at", nullable = false, updatable = false)
-    private LocalDateTime createdAt;
+    @Column(name = "profile_image_key", length = 512)
+    private String profileImageKey;
 
-    @Column(name = "updated_at", nullable = false)
-    private LocalDateTime updatedAt;
+    @Column(name = "deleted_at")
+    private LocalDateTime deletedAt = null;
 
-    @PrePersist
-    protected void onCreate() {
-        this.createdAt = LocalDateTime.now();
-        this.updatedAt = LocalDateTime.now();
-    }
+    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<Guardian> guardians = new ArrayList<>();
 
-    @PreUpdate
-    protected void onUpdate() {
-        this.updatedAt = LocalDateTime.now();
-    }
+    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<UserReportRecord> userReportRecords = new ArrayList<>();
 
+    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL, orphanRemoval = true)
+    @Builder.Default
+    private List<FraudAnalysisRecord> fraudAnalysisRecords = new ArrayList<>();
 
+    public void markDeleted() {
+        this.deletedAt = LocalDateTime.now();
+    }
 }
diff --git a/src/main/java/com/blockguard/server/domain/user/dto/request/RegisterRequest.java b/src/main/java/com/blockguard/server/domain/user/dto/request/RegisterRequest.java
@@ -1,9 +1,11 @@
 package com.blockguard.server.domain.user.dto.request;
 
 import com.blockguard.server.domain.user.domain.enums.Gender;
-import lombok.AllArgsConstructor;
-import lombok.Builder;
-import lombok.Getter;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+import lombok.*;
 
 import java.time.LocalDate;
 
@@ -12,11 +14,24 @@
 @AllArgsConstructor
 public class RegisterRequest {
 
+    @Email
+    @NotBlank
     private String email;
+
+    @NotBlank
     private String name;
+
+    @NotBlank
     private String password;
+
+    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyyMMdd")
     private LocalDate birthDate;
+
     private Gender gender;
+
+    @NotBlank
+    @Pattern(regexp = "^\\d{3}-\\d{4}-\\d{4}$",
+            message = "phoneNumber must match 010-1234-5678 format")
     private String phoneNumber;
 
 }
diff --git a/src/main/java/com/blockguard/server/global/common/entity/BaseEntity.java b/src/main/java/com/blockguard/server/global/common/entity/BaseEntity.java
diff --git a/src/main/java/com/blockguard/server/global/config/AuditingConfig.java b/src/main/java/com/blockguard/server/global/config/AuditingConfig.java
