feat: 인증 로직 구현

* chore: Security, OpenApi 의존성 추가

* chore: exception 구성 수정
- ControllerAdvice가 ResponseEntity 타입으로 응답하도록 수정
- 서비스 관련 에러 코드 추가
- ErrorResponse 생성자 수정

* feat: JpaAuditing 도입

* feat: BaseEntity 생성
- 엔티티 간 공통으로 활용
- Status Enum 추가

* feat: Member 도메인 구현
- BaseEntity 상속 받은 Member 엔티티 구현
- 회원가입 구현
- Role Enum으로 권한 정의

* feat: Spring Security 구성
- SecurityConfig, EncoderConfig 구성

* feat: 로그인 요청 DTO 구현

* feat: Security FilterChain 예외 처리 구현
- ErrorResponse 타입으로 예외 응답

* feat: UserDetails 구현체 구현

* chore: redis 연결 정보, JWT 설정 정보 추가

* chore: SwaggerConfig 구현

* feat: ControllerAdvice 예외 처리 추가
- 객체 필드 타입 검증 예외 Handler 추가

* feat: JwtUtil 구현
- 토큰 생성, 저장, Claims 추출, 만료 등의 작업 수행

* feat: 토큰 응답 DTO 구현

* feat: JwtFilter 구현
- JWT 유효성 검증 필터

* chore: 토큰 관련 예외 에러코드 추가

* feat: CustomAuthenticationFilter 구현
- 로그인 요청 시 호출되는 필터
- authenticationManager.authenticate()를 통해 내부적으로 인증 진행
- 인증 성공, 실패 처리 메소드 구현

* feat: CustomLogoutFilter 구현
- 로그아웃 요청 발생 시 catch 하여 토큰 만료 처리 진행

* chore: swagger-ui 접근 url 수정

* feat: 리소스 접근 제어 수정
- 인증이 필요하지 않은 접근은 모두 허용해 불필요한 권한 검사를 피함

* feat: error 핸들링 엔드포인트 추가
- 404, 500 등 에러 상황에 따라 ErrorResponse 타입으로 응답하도록 구현
- 에러 코드 추가

* test: 테스트 모듈 설정

* test: MemberService 단위 테스트 구현

Author: ysw789

build.gradle

@@ -34,10 +34,10 @@ repositories {
 }
 
 dependencies {
-//	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0'
+	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.7.0'
 	implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
 	implementation 'org.springframework.boot:spring-boot-starter-data-redis'
-//	implementation 'org.springframework.boot:spring-boot-starter-security'
+	implementation 'org.springframework.boot:spring-boot-starter-security'
 	implementation 'org.springframework.boot:spring-boot-starter-validation'
 	implementation 'org.springframework.boot:spring-boot-starter-web'
 	compileOnly 'org.projectlombok:lombok'

src/main/java/dmu/dasom/api/ApiApplication.java

@@ -2,7 +2,9 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 
+@EnableJpaAuditing
 @SpringBootApplication
 public class ApiApplication {
 

src/main/java/dmu/dasom/api/domain/common/BaseEntity.java

@@ -0,0 +1,36 @@
+package dmu.dasom.api.domain.common;
+
+import jakarta.persistence.*;
+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;
+
+@EntityListeners(AuditingEntityListener.class)
+@Getter
+@MappedSuperclass
+public class BaseEntity {
+
+    // 생성일
+    @CreatedDate
+    @Column(name = "created_at", updatable = false, nullable = false)
+    private LocalDateTime createdAt;
+
+    // 수정일
+    @LastModifiedDate
+    @Column(name = "updated_at", nullable = false)
+    private LocalDateTime updatedAt;
+
+    // 상태
+    @Column(name = "status", length = 16, nullable = false)
+    @Enumerated(EnumType.STRING)
+    private Status status = Status.ACTIVE;
+
+    // 상태 변경
+    public void updateStatus(final Status status) {
+        this.status = status;
+    }
+
+}

src/main/java/dmu/dasom/api/domain/common/Status.java

@@ -0,0 +1,7 @@
+package dmu.dasom.api.domain.common;
+
+public enum Status {
+    ACTIVE,
+    INACTIVE,
+    DELETED
+}

src/main/java/dmu/dasom/api/domain/common/exception/CustomControllerAdvice.java

@@ -1,14 +1,22 @@
 package dmu.dasom.api.domain.common.exception;
 
+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;
 
 @RestControllerAdvice
 public class CustomControllerAdvice {
 
     @ExceptionHandler(CustomException.class)
-    public ErrorResponse customException(final CustomException e) {
-        return new ErrorResponse(e.getErrorCode().getCode(), e.getErrorCode().getMessage());
+    public ResponseEntity<ErrorResponse> customException(final CustomException e) {
+        return ResponseEntity.status(e.getErrorCode().getStatus()).body(new ErrorResponse(e.getErrorCode()));
+    }
+
+    @ExceptionHandler(MethodArgumentNotValidException.class)
+    public ResponseEntity<ErrorResponse> methodArgumentNotValidException(final MethodArgumentNotValidException e) {
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(new ErrorResponse(ErrorCode.ARGUMENT_NOT_VALID));
     }
 
 }

src/main/java/dmu/dasom/api/domain/common/exception/CustomErrorController.java

@@ -0,0 +1,28 @@
+package dmu.dasom.api.domain.common.exception;
+
+import jakarta.servlet.RequestDispatcher;
+import jakarta.servlet.http.HttpServletRequest;
+import org.springframework.boot.web.servlet.error.ErrorController;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+public class CustomErrorController implements ErrorController {
+
+    @RequestMapping("/error")
+    public ResponseEntity<ErrorResponse> handleError(final HttpServletRequest request) {
+        // 에러 코드 추출
+        final Integer statusCode = (Integer) request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);
+        final HttpStatus status = statusCode != null ? HttpStatus.valueOf(statusCode) : HttpStatus.INTERNAL_SERVER_ERROR;
+
+        // 404 에러
+        if (status == HttpStatus.NOT_FOUND)
+            return ResponseEntity.status(status).body(new ErrorResponse(ErrorCode.NOT_FOUND));
+
+        // 기타 에러
+        return ResponseEntity.status(status).body(new ErrorResponse(ErrorCode.INTERNAL_SERVER_ERROR));
+    }
+
+}

src/main/java/dmu/dasom/api/domain/common/exception/ErrorCode.java

@@ -9,6 +9,14 @@ public enum ErrorCode {
 
     UNAUTHORIZED(401, "C001", "인증되지 않은 사용자입니다."),
     FORBIDDEN(403, "C002", "권한이 없습니다."),
+    MEMBER_NOT_FOUND(400, "C003", "해당 회원을 찾을 수 없습니다."),
+    TOKEN_EXPIRED(400, "C004", "토큰이 만료되었습니다."),
+    LOGIN_FAILED(400, "C005", "로그인에 실패하였습니다."),
+    SIGNUP_FAILED(400, "C006", "회원가입에 실패하였습니다."),
+    ARGUMENT_NOT_VALID(400, "C007", "요청한 값이 올바르지 않습니다."),
+    TOKEN_NOT_VALID(400, "C008", "토큰이 올바르지 않습니다."),
+    INTERNAL_SERVER_ERROR(500, "C009", "서버에 문제가 발생하였습니다."),
+    NOT_FOUND(404, "C010", "해당 리소스를 찾을 수 없습니다.")
     ;
 
     private final int status;

src/main/java/dmu/dasom/api/domain/common/exception/ErrorResponse.java

@@ -1,16 +1,19 @@
 package dmu.dasom.api.domain.common.exception;
 
 import lombok.AccessLevel;
-import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
-@AllArgsConstructor
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
 public class ErrorResponse {
 
     private String code;
     private String message;
 
+    public ErrorResponse(final ErrorCode errorCode) {
+        this.code = errorCode.getCode();
+        this.message = errorCode.getMessage();
+    }
+
 }

src/main/java/dmu/dasom/api/domain/member/controller/MemberController.java

@@ -0,0 +1,54 @@
+package dmu.dasom.api.domain.member.controller;
+
+import dmu.dasom.api.domain.common.exception.ErrorResponse;
+import dmu.dasom.api.domain.member.dto.SignupRequestDto;
+import dmu.dasom.api.domain.member.service.MemberService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.ExampleObject;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.responses.ApiResponses;
+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
+@RequestMapping("/api")
+@RequiredArgsConstructor
+public class MemberController {
+
+    private final MemberService memberService;
+
+    // 회원가입
+    @Operation(summary = "회원가입")
+    @ApiResponses(value = {
+            @ApiResponse(responseCode = "200", description = "회원가입 성공"),
+            @ApiResponse(responseCode = "400", description = "실패 케이스",
+                    content = @Content(
+                            mediaType = "application/json",
+                            schema = @Schema(implementation = ErrorResponse.class),
+                            examples = {
+                                    @ExampleObject(
+                                            name = "이메일 중복",
+                                            value = "{ \"code\": \"C006\", \"message\": \"회원가입에 실패하였습니다.\" }"
+                                    ),
+                                    @ExampleObject(
+                                            name = "이메일 또는 비밀번호 형식 올바르지 않음",
+                                            value = "{ \"code\": \"C007\", \"message\": \"요청한 값이 올바르지 않습니다.\" }"
+                                    )
+                            }
+                    )
+            )
+    })
+    @PostMapping("/auth/signup")
+    public ResponseEntity<Void> signUp(@Valid @RequestBody final SignupRequestDto request) {
+        memberService.signUp(request);
+        return ResponseEntity.ok().build();
+    }
+
+}

src/main/java/dmu/dasom/api/domain/member/dto/SignupRequestDto.java

@@ -0,0 +1,31 @@
+package dmu.dasom.api.domain.member.dto;
+
+import dmu.dasom.api.domain.member.entity.Member;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotNull;
+import lombok.Getter;
+import org.hibernate.validator.constraints.Length;
+
+@Getter
+@Schema(name = "SignupRequestDto", description = "회원가입 요청 DTO")
+public class SignupRequestDto {
+
+    @Email
+    @Length(max = 64)
+    @NotNull
+    @Schema(description = "이메일", example = "[email protected]", maxLength = 64)
+    private String email;
+
+    @Length(min = 8, max = 128)
+    @NotNull
+    @Schema(description = "비밀번호", example = "password", minLength = 8, maxLength = 128)
+    private String password;
+
+    public Member toEntity(final String password) {
+        return Member.builder()
+                .email(this.email)
+                .password(password)
+                .build();
+    }
+}