feat: 어드민 멤버 정보 수정 api 구현

src/main/java/com/gdschongik/gdsc/domain/member/api/AdminMemberController.java

@@ -2,14 +2,18 @@
 
 import com.gdschongik.gdsc.domain.member.application.MemberService;
 import com.gdschongik.gdsc.domain.member.dto.request.MemberQueryRequest;
+import com.gdschongik.gdsc.domain.member.dto.request.MemberUpdateRequest;
 import com.gdschongik.gdsc.domain.member.dto.response.MemberFindAllResponse;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.DeleteMapping;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
@@ -31,4 +35,11 @@ public ResponseEntity<Void> withdrawMember(@PathVariable Long memberId) {
         memberService.withdrawMember(memberId);
         return ResponseEntity.ok().build();
     }
+
+    @PutMapping("/{memberId}")
+    public ResponseEntity<Void> withdrawMember(
+            @PathVariable Long memberId, @Valid @RequestBody MemberUpdateRequest request) {
+        memberService.updateMember(memberId, request);
+        return ResponseEntity.ok().build();
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/member/application/MemberService.java

@@ -5,8 +5,10 @@
 import com.gdschongik.gdsc.domain.member.dao.MemberRepository;
 import com.gdschongik.gdsc.domain.member.domain.Member;
 import com.gdschongik.gdsc.domain.member.dto.request.MemberQueryRequest;
+import com.gdschongik.gdsc.domain.member.dto.request.MemberUpdateRequest;
 import com.gdschongik.gdsc.domain.member.dto.response.MemberFindAllResponse;
 import com.gdschongik.gdsc.global.exception.CustomException;
+import com.gdschongik.gdsc.global.exception.ErrorCode;
 import lombok.RequiredArgsConstructor;
 import org.springframework.data.domain.Page;
 import org.springframework.data.domain.Pageable;
@@ -30,4 +32,13 @@ public void withdrawMember(Long memberId) {
         Member member = memberRepository.findById(memberId).orElseThrow(() -> new CustomException(MEMBER_NOT_FOUND));
         member.withdraw();
     }
+
+    @Transactional
+    public void updateMember(Long memberId, MemberUpdateRequest request) {
+        Member member =
+                memberRepository.findById(memberId).orElseThrow(() -> new CustomException(ErrorCode.MEMBER_NOT_FOUND));
+
+        member.validateStatus();
+        member.updateMemberInfo(request);
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/member/domain/Member.java

@@ -1,8 +1,10 @@
 package com.gdschongik.gdsc.domain.member.domain;
 
+import static com.gdschongik.gdsc.global.common.constant.RegexConstant.*;
 import static com.gdschongik.gdsc.global.exception.ErrorCode.*;
 
 import com.gdschongik.gdsc.domain.common.model.BaseTimeEntity;
+import com.gdschongik.gdsc.domain.member.dto.request.MemberUpdateRequest;
 import com.gdschongik.gdsc.global.exception.CustomException;
 import jakarta.persistence.Column;
 import jakarta.persistence.Entity;
@@ -100,4 +102,70 @@ public void withdraw() {
     public boolean isDeleted() {
         return this.status.isDeleted();
     }
+
+    public void updateMemberInfo(MemberUpdateRequest request) {
+        updateStudentId(request.studentId());
+        updateName(request.name());
+        updatePhone(request.phone());
+        updateDepartment(request.department());
+        updateEmail(request.email());
+        updateDiscordUsername(request.discordUsername());
+        updateNickname(request.nickname());
+    }
+
+    private void updateStudentId(String studentId) {
+        validateStringNotNull(studentId);
+        validateRegex(studentId, STUDENT_ID);
+        this.studentId = studentId;
+    }
+
+    private void updateName(String name) {
+        validateStringNotNull(name);
+        this.name = name;
+    }
+
+    private void updatePhone(String phone) {
+        validateStringNotNull(phone);
+        validateRegex(phone, PHONE);
+        this.phone = phone;
+    }
+
+    private void updateDepartment(String department) {
+        validateStringNotNull(department);
+        this.department = department;
+    }
+
+    private void updateEmail(String email) {
+        validateStringNotNull(email);
+        this.email = email;
+    }
+
+    private void updateDiscordUsername(String discordUsername) {
+        validateStringNotNull(discordUsername);
+        this.discordUsername = discordUsername;
+    }
+
+    private void updateNickname(String nickname) {
+        validateStringNotNull(nickname);
+        validateRegex(nickname, NICKNAME);
+        this.nickname = nickname;
+    }
+
+    private void validateStringNotNull(String value) {
+        if (value == null) {
+            throw new CustomException(METHOD_ARGUMENT_NULL);
+        }
+    }
+
+    private void validateRegex(String value, String regex) {
+        if (!value.matches(regex)) {
+            throw new CustomException(REGEX_VIOLATION);
+        }
+    }
+
+    public void validateStatus() {
+        if (isDeleted()) {
+            throw new CustomException(MEMBER_DELETED);
+        }
+    }
 }

src/main/java/com/gdschongik/gdsc/domain/member/dto/request/MemberUpdateRequest.java

@@ -0,0 +1,16 @@
+package com.gdschongik.gdsc.domain.member.dto.request;
+
+import static com.gdschongik.gdsc.global.common.constant.RegexConstant.*;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+
+public record MemberUpdateRequest(
+        @NotBlank @Pattern(regexp = STUDENT_ID, message = "학번은 " + STUDENT_ID + " 형식이어야 합니다.") String studentId,
+        @NotBlank String name,
+        @NotBlank @Pattern(regexp = PHONE, message = "전화번호는 " + PHONE + " 형식이어야 합니다.") String phone,
+        @NotBlank String department,
+        @NotBlank @Email String email,
+        @NotBlank String discordUsername,
+        @NotBlank @Pattern(regexp = NICKNAME, message = "닉네임은 " + NICKNAME + " 형식이어야 합니다.") String nickname) {}

src/main/java/com/gdschongik/gdsc/global/common/constant/RegexConstant.java

@@ -0,0 +1,9 @@
+package com.gdschongik.gdsc.global.common.constant;
+
+public class RegexConstant {
+    public static final String STUDENT_ID = "^[A-C]{1}[0-9]{6}$";
+    public static final String PHONE = "^010-[0-9]{4}-[0-9]{4}$";
+    public static final String NICKNAME = "[ㄱ-ㅣ가-힣]{1,6}$";
+
+    private RegexConstant() {}
+}

src/main/java/com/gdschongik/gdsc/global/exception/ErrorCode.java

@@ -8,17 +8,20 @@
 @AllArgsConstructor
 public enum ErrorCode {
     INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "서버 에러입니다."),
+    METHOD_ARGUMENT_NULL(HttpStatus.BAD_REQUEST, "인자는 null이 될 수 없습니다."),
+    METHOD_ARGUMENT_NOT_VALID(HttpStatus.BAD_REQUEST, "인자가 유효하지 않습니다."),
+    REGEX_VIOLATION(HttpStatus.BAD_REQUEST, "정규표현식을 위반했습니다."),
 
     // Jwt
     INVALID_JWT_TOKEN(HttpStatus.UNAUTHORIZED, "유효하지 않은 JWT 토큰입니다."),
     EXPIRED_JWT_TOKEN(HttpStatus.UNAUTHORIZED, "만료된 JWT 토큰입니다."),
 
-    // Parameter
-    INVALID_QUERY_PARAMETER(HttpStatus.BAD_REQUEST, "잘못된 쿼리 파라미터입니다."),
-
     // Member
     MEMBER_NOT_FOUND(HttpStatus.NOT_FOUND, "존재하지 않는 회원입니다."),
-    MEMBER_DELETED(HttpStatus.CONFLICT, "탈퇴한 회원입니다.");
+    MEMBER_DELETED(HttpStatus.CONFLICT, "탈퇴한 회원입니다."),
+
+    // Parameter
+    INVALID_QUERY_PARAMETER(HttpStatus.BAD_REQUEST, "잘못된 쿼리 파라미터입니다.");
 
     private final HttpStatus status;
     private final String message;

src/main/java/com/gdschongik/gdsc/global/exception/ErrorResponse.java

@@ -4,4 +4,8 @@ public record ErrorResponse(String errorCodeName, String errorMessage) {
     public static ErrorResponse of(ErrorCode errorCode) {
         return new ErrorResponse(errorCode.name(), errorCode.getMessage());
     }
+
+    public static ErrorResponse of(String errorCodeName, String errorMessage) {
+        return new ErrorResponse(errorCodeName, errorMessage);
+    }
 }

src/main/java/com/gdschongik/gdsc/global/exception/GlobalExceptionHandler.java

@@ -1,9 +1,13 @@
 package com.gdschongik.gdsc.global.exception;
 
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.HttpStatusCode;
 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 org.springframework.web.context.request.WebRequest;
 import org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler;
 
 @Slf4j
@@ -22,4 +26,13 @@ public ResponseEntity<ErrorResponse> handleException(Exception e) {
         return ResponseEntity.status(ErrorCode.INTERNAL_SERVER_ERROR.getStatus())
                 .body(ErrorResponse.of(ErrorCode.INTERNAL_SERVER_ERROR));
     }
+
+    @Override
+    protected ResponseEntity<Object> handleMethodArgumentNotValid(
+            MethodArgumentNotValidException e, HttpHeaders headers, HttpStatusCode status, WebRequest request) {
+        log.error("METHOD_ARGUMENT_NOT_VALID : {}", e.getMessage(), e);
+        String errorMessage = e.getBindingResult().getAllErrors().get(0).getDefaultMessage();
+        return ResponseEntity.status(status.value())
+                .body(ErrorResponse.of(ErrorCode.METHOD_ARGUMENT_NOT_VALID.name(), errorMessage));
+    }
 }

src/test/java/com/gdschongik/gdsc/domain/member/application/MemberServiceTest.java

@@ -0,0 +1,36 @@
+package com.gdschongik.gdsc.domain.member.application;
+
+import static org.assertj.core.api.Assertions.*;
+
+import com.gdschongik.gdsc.domain.member.dao.MemberRepository;
+import com.gdschongik.gdsc.domain.member.domain.Member;
+import com.gdschongik.gdsc.domain.member.dto.request.MemberUpdateRequest;
+import com.gdschongik.gdsc.global.exception.CustomException;
+import com.gdschongik.gdsc.global.exception.ErrorCode;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class MemberServiceTest {
+    @Autowired
+    private MemberRepository memberRepository;
+
+    @Autowired
+    private MemberService memberService;
+
+    @Test
+    void status가_DELETED라면_예외_발생() {
+        // given
+        Member member = Member.createGuestMember("oAuthId");
+        member.withdraw();
+        memberRepository.save(member);
+
+        // when & then
+        MemberUpdateRequest requestBody = new MemberUpdateRequest(
+                "A111111", "name", "010-1234-5678", "department", "[email protected]", "discordUsername", "한글");
+        assertThatThrownBy(() -> memberService.updateMember(member.getId(), requestBody))
+                .isInstanceOf(CustomException.class)
+                .hasMessage(ErrorCode.MEMBER_DELETED.getMessage());
+    }
+}