Feat/#3

build.gradle

@@ -30,7 +30,7 @@ dependencies {
 	implementation 'org.springframework.boot:spring-boot-starter-validation'
 
 	// Security
-	// implementation 'org.springframework.boot:spring-boot-starter-security'
+	implementation 'org.springframework.boot:spring-boot-starter-security'
 
 	// Database & Cache
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

src/main/java/com/whereyouad/WhereYouAd/WhereYouAdApplication.java

@@ -2,8 +2,10 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 
 @SpringBootApplication
+@EnableJpaAuditing
 public class WhereYouAdApplication {
 
 	public static void main(String[] args) {

src/main/java/com/whereyouad/WhereYouAd/domains/user/application/dto/request/SignUpRequest.java

@@ -0,0 +1,18 @@
+package com.whereyouad.WhereYouAd.domains.user.application.dto.request;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+
+public record SignUpRequest(
+        @NotBlank(message = "이메일은 필수입니다.")
+        @Email(message = "이메일 형식이 올바르지 않습니다.")
+        String email,
+        @NotBlank(message = "비밀번호는 필수입니다.")
+        String password,
+        @NotBlank(message = "이름은 필수입니다.")
+        String name,
+        @NotBlank(message = "전화번호는 필수입니다.")
+        @JsonProperty("phone_number")
+        String phoneNumber
+) {}

src/main/java/com/whereyouad/WhereYouAd/domains/user/application/dto/response/SignUpResponse.java

@@ -0,0 +1,8 @@
+package com.whereyouad.WhereYouAd.domains.user.application.dto.response;
+
+import java.time.LocalDateTime;
+
+public record SignUpResponse(
+         Long userId,
+         LocalDateTime createdAt
+) { }

src/main/java/com/whereyouad/WhereYouAd/domains/user/application/mapper/UserConverter.java

@@ -0,0 +1,12 @@
+package com.whereyouad.WhereYouAd.domains.user.application.mapper;
+
+import com.whereyouad.WhereYouAd.domains.user.application.dto.response.SignUpResponse;
+import com.whereyouad.WhereYouAd.domains.user.persistence.entity.User;
+
+public class UserConverter {
+
+    public static SignUpResponse toSignInResponse(User user) {
+        return new SignUpResponse(user.getId(), user.getCreatedAt());
+    }
+
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/domain/constant/UserStatus.java

@@ -0,0 +1,5 @@
+package com.whereyouad.WhereYouAd.domains.user.domain.constant;
+
+public enum UserStatus {
+    ACTIVE, SUSPENDED, DELETED
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/domain/service/UserService.java

@@ -0,0 +1,49 @@
+package com.whereyouad.WhereYouAd.domains.user.domain.service;
+
+import com.whereyouad.WhereYouAd.domains.user.exception.UserSignUpException;
+import com.whereyouad.WhereYouAd.domains.user.exception.code.UserErrorCode;
+import com.whereyouad.WhereYouAd.domains.user.domain.constant.UserStatus;
+import com.whereyouad.WhereYouAd.domains.user.application.mapper.UserConverter;
+import com.whereyouad.WhereYouAd.domains.user.application.dto.request.SignUpRequest;
+import com.whereyouad.WhereYouAd.domains.user.application.dto.response.SignUpResponse;
+import com.whereyouad.WhereYouAd.domains.user.persistence.entity.User;
+import com.whereyouad.WhereYouAd.domains.user.persistence.repository.UserRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Service
+@Transactional
+@RequiredArgsConstructor
+public class UserService {
+
+    private final UserRepository userRepository;
+    private final PasswordEncoder passwordEncoder;
+
+    //회원가입 메서드
+    public SignUpResponse signUpUser(SignUpRequest request) {
+        if (userRepository.existsByEmail(request.email())) { //이미 이메일로 만든 계정이 존재할 시
+            throw new UserSignUpException(UserErrorCode.USER_EMAIL_DUPLICATE); //이메일 중복 예외
+        }
+
+        //비밀번호 암호화 -> SecurityConfig 클래스 내 에서 BCryptPasswordEncoder 를 Bean 등록한거로 사용
+        String encodedPwd = passwordEncoder.encode(request.password());
+
+        //User 엔티티 생성
+        User user = User.builder()
+                .email(request.email())
+                .password(encodedPwd)
+                .name(request.name())
+                .phoneNumber(request.phoneNumber())
+                .profileImageUrl(null)
+                .status(UserStatus.ACTIVE)
+                .isEmailVerified(false)
+                .build();
+
+        User savedUser = userRepository.save(user);
+
+        //Response DTO 로 변환 및 반환
+        return UserConverter.toSignInResponse(savedUser);
+    }
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/exception/UserSignUpException.java

@@ -0,0 +1,10 @@
+package com.whereyouad.WhereYouAd.domains.user.exception;
+
+import com.whereyouad.WhereYouAd.global.exception.AppException;
+import com.whereyouad.WhereYouAd.global.exception.BaseErrorCode;
+
+public class UserSignUpException extends AppException {
+    public UserSignUpException(BaseErrorCode errorCode) {
+        super(errorCode);
+    }
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/exception/code/UserErrorCode.java

@@ -0,0 +1,17 @@
+package com.whereyouad.WhereYouAd.domains.user.exception.code;
+
+import com.whereyouad.WhereYouAd.global.exception.BaseErrorCode;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.http.HttpStatus;
+
+@Getter
+@AllArgsConstructor
+public enum UserErrorCode implements BaseErrorCode {
+    USER_EMAIL_DUPLICATE(HttpStatus.BAD_REQUEST, "USER_400_2", "이미 사용중인 이메일 입니다."),
+    ;
+
+    private final HttpStatus httpStatus;
+    private final String code;
+    private final String message;
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/persistence/entity/User.java

@@ -0,0 +1,45 @@
+package com.whereyouad.WhereYouAd.domains.user.persistence.entity;
+
+import com.whereyouad.WhereYouAd.domains.user.domain.constant.UserStatus;
+import com.whereyouad.WhereYouAd.global.common.BaseEntity;
+import jakarta.persistence.*;
+import lombok.*;
+import org.hibernate.annotations.ColumnDefault;
+
+@Entity
+@Table(name = "users")
+@Getter
+@AllArgsConstructor
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Builder
+public class User extends BaseEntity {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    @Column(name = "user_id")
+    private Long id;
+
+    @Column(nullable = false, name = "email", length = 320)
+    private String email;
+
+    @Column(name = "password", length = 255)
+    private String password;
+
+    @Column(nullable = false, name = "name", length = 50)
+    private String name;
+
+    @Column(name = "profile_image_url", length = 1024)
+    private String profileImageUrl;
+
+    @Column(nullable = false, name = "phone_number", length = 32)
+    private String phoneNumber;
+
+    @Column(nullable = false, name = "is_email_verified")
+    @ColumnDefault("false")  //기본값 false
+    private boolean isEmailVerified;  //회원 가입시 이메일 인증 여부
+
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false, name = "status")
+    @ColumnDefault("'ACTIVE'")  //기본값 ACTIVE
+    private UserStatus status;  //ACTIVE, SUSPENDED, DELETED
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/persistence/repository/UserRepository.java

@@ -0,0 +1,16 @@
+package com.whereyouad.WhereYouAd.domains.user.persistence.repository;
+
+import com.whereyouad.WhereYouAd.domains.user.persistence.entity.User;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.data.repository.query.Param;
+
+import java.util.Optional;
+
+public interface UserRepository extends JpaRepository<User, Long> {
+    @Query("select u from User u where u.email = :email")
+    Optional<User> findUserByEmail(@Param("email") String email);
+
+    //이메일 중복 예외 처리를 위한 이메일로 조회 메서드
+    boolean existsByEmail(String email);
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/presentation/UserController.java

@@ -0,0 +1,32 @@
+package com.whereyouad.WhereYouAd.domains.user.presentation;
+
+import com.whereyouad.WhereYouAd.domains.user.domain.service.UserService;
+import com.whereyouad.WhereYouAd.domains.user.application.dto.request.SignUpRequest;
+import com.whereyouad.WhereYouAd.domains.user.application.dto.response.SignUpResponse;
+import com.whereyouad.WhereYouAd.domains.user.presentation.docs.UserControllerDocs;
+import com.whereyouad.WhereYouAd.global.response.DataResponse;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+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;
+
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/users")
+public class UserController implements UserControllerDocs {
+
+    private final UserService userService;
+
+    @PostMapping("/signup")
+    public ResponseEntity<DataResponse<SignUpResponse>> signUp(@RequestBody @Valid SignUpRequest request)
+    {
+        SignUpResponse signUpResponse = userService.signUpUser(request);
+        return ResponseEntity.ok(
+                DataResponse.created(signUpResponse)
+        );
+    }
+
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/presentation/docs/UserControllerDocs.java

@@ -0,0 +1,23 @@
+package com.whereyouad.WhereYouAd.domains.user.presentation.docs;
+
+import com.whereyouad.WhereYouAd.domains.user.application.dto.request.SignUpRequest;
+import com.whereyouad.WhereYouAd.domains.user.application.dto.response.SignUpResponse;
+import com.whereyouad.WhereYouAd.global.response.DataResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+import jakarta.validation.Valid;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+
+public interface UserControllerDocs {
+    @Operation(
+            summary = "단순 회원가입 API",
+            description = "이메일, 비밀번호, 이름, 전화번호를 받아 회원가입을 진행합니다(이메일 인증 미진행상태)"
+    )
+    @ApiResponses({
+            @ApiResponse(responseCode = "200", description = "성공"),
+            @ApiResponse(responseCode = "400_2", description = "이메일 중복 회원 존재")
+    })
+    public ResponseEntity<DataResponse<SignUpResponse>> signUp(@RequestBody @Valid SignUpRequest request);
+}

src/main/java/com/whereyouad/WhereYouAd/global/common/BaseEntity.java

@@ -0,0 +1,25 @@
+package com.whereyouad.WhereYouAd.global.common;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.EntityListeners;
+import jakarta.persistence.MappedSuperclass;
+import lombok.Getter;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.jpa.domain.support.AuditingEntityListener;
+
+import java.time.LocalDateTime;
+
+@Getter
+@MappedSuperclass
+@EntityListeners(AuditingEntityListener.class)
+public class BaseEntity { //BaseEntity 활용 생성 시간, 변경 시간 반영
+
+    @CreatedDate
+    @Column(name = "created_at", updatable = false)
+    private LocalDateTime createdAt;
+
+    @LastModifiedDate
+    @Column(name = "updated_at")
+    private LocalDateTime updatedAt;
+}

src/main/java/com/whereyouad/WhereYouAd/global/exception/GlobalExceptionHandler.java

@@ -3,13 +3,16 @@
 import com.whereyouad.WhereYouAd.global.response.ErrorResponse;
 import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 
 
 import jakarta.servlet.http.HttpServletRequest;
 import lombok.extern.slf4j.Slf4j;
 
+import java.util.stream.Collectors;
+
 
 @Slf4j
 @RestControllerAdvice
@@ -38,4 +41,25 @@ public ResponseEntity<ErrorResponse> handleAppCustomException(AppException e, Ht
                 .status(e.getErrorCode().getHttpStatus())
                 .body(errorResponse);
     }
+
+    //@Valid 검사 실패(필수 파라미터가 null 또는 공백) 인 경우 예외를 잡는 핸들러
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ResponseEntity<ErrorResponse> handleNotValidException(MethodArgumentNotValidException e, HttpServletRequest request) {
+        // 예시 결과: "email: 이메일 형식이 아닙니다, password: 비밀번호는 필수입니다"
+        String errorMessage = e.getBindingResult().getFieldErrors().stream()
+                .map(fieldError -> fieldError.getField() + ": " + fieldError.getDefaultMessage())
+                .collect(Collectors.joining(", "));
+
+        log.error("MethodArgumentNotValidException 발생: {}", errorMessage);
+        log.error("에러가 발생한 지점 {}, {}", request.getMethod(), request.getRequestURI());
+
+        ErrorResponse errorResponse = ErrorResponse.of(
+                ErrorCode.INVALID_PARAMETER,
+                request
+        );
+
+        return ResponseEntity
+                .status(HttpStatus.BAD_REQUEST)
+                .body(errorResponse);
+    }
 }

src/main/java/com/whereyouad/WhereYouAd/global/security/SecurityConfig.java

@@ -0,0 +1,28 @@
+package com.whereyouad.WhereYouAd.global.security;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.security.web.SecurityFilterChain;
+
+@Configuration
+public class SecurityConfig {
+
+    @Bean
+    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
+        http
+                .csrf(csrf -> csrf.disable()) //CSRF 보호 비활성화
+                .authorizeHttpRequests(auth -> auth
+                        .anyRequest().permitAll() //우선 모든 접근 허용 -> 추후 로그인 구현 이후 접근 제한 예정
+                );
+
+        return http.build();
+    }
+
+    @Bean  //회원 비밀번호 BCrypt 암호화를 위한 Bean 등록
+    public PasswordEncoder passwordEncoder() {
+        return new BCryptPasswordEncoder();
+    }
+}