feat: 멘토링 관련 도메인 추가

src/main/java/com/example/solidconnection/common/exception/ErrorCode.java

@@ -104,6 +104,13 @@ public enum ErrorCode {
     // database
     DATA_INTEGRITY_VIOLATION(HttpStatus.CONFLICT.value(), "데이터베이스 무결성 제약조건 위반이 발생했습니다."),
 
+    // mentor
+    ALREADY_MENTOR(HttpStatus.BAD_REQUEST.value(), "이미 멘토로 등록된 사용자입니다."),
+    MENTOR_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "해당 사용자는 멘토로 등록되어 있지 않습니다."),
+    MENTORING_NOT_FOUND(HttpStatus.NOT_FOUND.value(), "해당 멘토링 신청을 찾을 수 없습니다."),
+    UNAUTHORIZED_MENTORING(HttpStatus.FORBIDDEN.value(), "멘토링 권한이 없습니다."),
+    MENTORING_ALREADY_CONFIRMED(HttpStatus.BAD_REQUEST.value(), "이미 승인 또는 거절된 멘토링입니다."),
+
     // general
     JSON_PARSING_FAILED(HttpStatus.BAD_REQUEST.value(), "JSON 파싱을 할 수 없습니다."),
     JWT_EXCEPTION(HttpStatus.BAD_REQUEST.value(), "JWT 토큰을 처리할 수 없습니다."),

src/main/java/com/example/solidconnection/mentor/controller/MentoringController.java

@@ -0,0 +1,83 @@
+package com.example.solidconnection.mentor.controller;
+
+import com.example.solidconnection.common.resolver.AuthorizedUser;
+import com.example.solidconnection.mentor.dto.MentoringApplyRequest;
+import com.example.solidconnection.mentor.dto.MentoringApplyResponse;
+import com.example.solidconnection.mentor.dto.MentoringCheckResponse;
+import com.example.solidconnection.mentor.dto.MentoringConfirmRequest;
+import com.example.solidconnection.mentor.dto.MentoringConfirmResponse;
+import com.example.solidconnection.mentor.dto.MentoringCountResponse;
+import com.example.solidconnection.mentor.dto.MentoringListResponse;
+import com.example.solidconnection.mentor.service.MentoringCommandService;
+import com.example.solidconnection.mentor.service.MentoringQueryService;
+import com.example.solidconnection.security.annotation.RequireRoleAccess;
+import com.example.solidconnection.siteuser.domain.Role;
+import com.example.solidconnection.siteuser.domain.SiteUser;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+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("/mentorings")
+public class MentoringController {
+
+    private final MentoringCommandService mentoringCommandService;
+    private final MentoringQueryService mentoringQueryService;
+
+    @RequireRoleAccess(roles = Role.MENTEE)
+    @PostMapping("/apply")
+    public ResponseEntity<MentoringApplyResponse> applyMentoring(
+            @AuthorizedUser SiteUser siteUser,
+            @Valid @RequestBody MentoringApplyRequest mentoringApplyRequest
+    ) {
+        MentoringApplyResponse response = mentoringCommandService.applyMentoring(siteUser.getId(), mentoringApplyRequest);
+        return ResponseEntity.ok(response);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @GetMapping("/apply")
+    public ResponseEntity<MentoringListResponse> getMentorings(
+            @AuthorizedUser SiteUser siteUser
+    ) {
+        MentoringListResponse responses = mentoringQueryService.getMentorings(siteUser.getId());
+        return ResponseEntity.ok(responses);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @PatchMapping("/{mentoring-id}/apply")
+    public ResponseEntity<MentoringConfirmResponse> confirmMentoring(
+            @AuthorizedUser SiteUser siteUser,
+            @PathVariable("mentoring-id") Long mentoringId,
+            @Valid @RequestBody MentoringConfirmRequest mentoringConfirmRequest
+    ) {
+        MentoringConfirmResponse response = mentoringCommandService.confirmMentoring(siteUser.getId(), mentoringId, mentoringConfirmRequest);
+        return ResponseEntity.ok(response);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @PatchMapping("/{mentoring-id}/check")
+    public ResponseEntity<MentoringCheckResponse> checkMentoring(
+            @AuthorizedUser SiteUser siteUser,
+            @PathVariable("mentoring-id") Long mentoringId
+    ) {
+        MentoringCheckResponse response = mentoringCommandService.checkMentoring(siteUser.getId(), mentoringId);
+        return ResponseEntity.ok(response);
+    }
+
+    @RequireRoleAccess(roles = {Role.ADMIN, Role.MENTOR})
+    @GetMapping("/check")
+    public ResponseEntity<MentoringCountResponse> getUncheckedMentoringsCount(
+            @AuthorizedUser SiteUser siteUser
+    ) {
+        MentoringCountResponse response = mentoringQueryService.getNewMentoringsCount(siteUser.getId());
+        return ResponseEntity.ok(response);
+    }
+}

src/main/java/com/example/solidconnection/mentor/domain/Mentor.java

@@ -45,4 +45,8 @@ public class Mentor {
 
     @OneToMany(mappedBy = "mentor", cascade = CascadeType.ALL, orphanRemoval = true)
     private List<Channel> channels = new ArrayList<>();
+
+    public void increaseMenteeCount() {
+        this.menteeCount++;
+    }
 }

src/main/java/com/example/solidconnection/mentor/domain/Mentoring.java

@@ -56,8 +56,28 @@ public class Mentoring {
     @Column
     private long menteeId;
 
+    public Mentoring(long mentorId, long menteeId, VerifyStatus verifyStatus) {
+        this.mentorId = mentorId;
+        this.menteeId = menteeId;
+        this.verifyStatus = verifyStatus;
+    }
+
     @PrePersist
     public void onPrePersist() {
         this.createdAt = ZonedDateTime.now(UTC).truncatedTo(MICROS); // 나노초 6자리 까지만 저장
     }
+
+    public void confirm(VerifyStatus status, String rejectedReason) {
+        this.verifyStatus = status;
+        this.rejectedReason = rejectedReason;
+        this.confirmedAt = ZonedDateTime.now(UTC).truncatedTo(MICROS);
+
+        if (this.checkedAt == null) {
+            this.checkedAt = this.confirmedAt;
+        }
+    }
+
+    public void check() {
+        this.checkedAt = ZonedDateTime.now(UTC).truncatedTo(MICROS);
+    }
 }

src/main/java/com/example/solidconnection/mentor/dto/MentoringApplyRequest.java

@@ -0,0 +1,9 @@
+package com.example.solidconnection.mentor.dto;
+
+import jakarta.validation.constraints.NotNull;
+
+public record MentoringApplyRequest(
+        @NotNull(message = "멘토 id를 입력해주세요.")
+        Long mentorId
+) {
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringApplyResponse.java

@@ -0,0 +1,12 @@
+package com.example.solidconnection.mentor.dto;
+
+import com.example.solidconnection.mentor.domain.Mentoring;
+
+public record MentoringApplyResponse(
+        long mentoringId
+) {
+
+    public static MentoringApplyResponse from(Mentoring mentoring) {
+        return new MentoringApplyResponse(mentoring.getId());
+    }
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringCheckResponse.java

@@ -0,0 +1,10 @@
+package com.example.solidconnection.mentor.dto;
+
+public record MentoringCheckResponse(
+        long mentoringId
+) {
+
+    public static MentoringCheckResponse from(long mentoringId) {
+        return new MentoringCheckResponse(mentoringId);
+    }
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringConfirmRequest.java

@@ -0,0 +1,12 @@
+package com.example.solidconnection.mentor.dto;
+
+import com.example.solidconnection.common.VerifyStatus;
+import jakarta.validation.constraints.NotNull;
+
+public record MentoringConfirmRequest(
+        @NotNull(message = "승인 상태를 설정해주세요.")
+        VerifyStatus status,
+
+        String rejectedReason
+) {
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringConfirmResponse.java

@@ -0,0 +1,11 @@
+package com.example.solidconnection.mentor.dto;
+
+import com.example.solidconnection.mentor.domain.Mentoring;
+
+public record MentoringConfirmResponse(
+        long mentoringId
+) {
+    public static MentoringConfirmResponse from(Mentoring mentoring) {
+        return new MentoringConfirmResponse(mentoring.getId());
+    }
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringCountResponse.java

@@ -0,0 +1,10 @@
+package com.example.solidconnection.mentor.dto;
+
+public record MentoringCountResponse(
+        int uncheckedCount
+) {
+
+    public static MentoringCountResponse from(int uncheckedCount) {
+        return new MentoringCountResponse(uncheckedCount);
+    }
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringListResponse.java

@@ -0,0 +1,11 @@
+package com.example.solidconnection.mentor.dto;
+
+import java.util.List;
+
+public record MentoringListResponse(
+        List<MentoringResponse> requests
+) {
+    public static MentoringListResponse from(List<MentoringResponse> requests) {
+        return new MentoringListResponse(requests);
+    }
+}

src/main/java/com/example/solidconnection/mentor/dto/MentoringResponse.java

@@ -0,0 +1,24 @@
+package com.example.solidconnection.mentor.dto;
+
+import com.example.solidconnection.mentor.domain.Mentoring;
+import com.example.solidconnection.siteuser.domain.SiteUser;
+
+import java.time.ZonedDateTime;
+
+public record MentoringResponse(
+        long mentoringId,
+        String profileImageUrl,
+        String nickname,
+        boolean isChecked,
+        ZonedDateTime createdAt
+) {
+    public static MentoringResponse from(Mentoring mentoring, SiteUser mentee) {
+        return new MentoringResponse(
+                mentoring.getId(),
+                mentee.getProfileImageUrl(),
+                mentee.getNickname(),
+                mentoring.getCheckedAt() != null,
+                mentoring.getCreatedAt()
+        );
+    }
+}

src/main/java/com/example/solidconnection/mentor/repository/MentorRepository.java

@@ -0,0 +1,13 @@
+package com.example.solidconnection.mentor.repository;
+
+import com.example.solidconnection.mentor.domain.Mentor;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.Optional;
+
+public interface MentorRepository extends JpaRepository<Mentor, Long> {
+
+    Optional<Mentor> findBySiteUserId(long siteUserId);
+
+    boolean existsBySiteUserId(long siteUserId);
+}

src/main/java/com/example/solidconnection/mentor/repository/MentoringRepository.java

@@ -0,0 +1,13 @@
+package com.example.solidconnection.mentor.repository;
+
+import com.example.solidconnection.mentor.domain.Mentoring;
+import org.springframework.data.jpa.repository.JpaRepository;
+
+import java.util.List;
+
+public interface MentoringRepository extends JpaRepository<Mentoring, Long> {
+
+    List<Mentoring> findAllByMentorId(long mentorId);
+
+    int countByMentorIdAndCheckedAtIsNull(long mentorId);
+}

src/main/java/com/example/solidconnection/mentor/service/MentoringCommandService.java

@@ -0,0 +1,90 @@
+package com.example.solidconnection.mentor.service;
+
+import com.example.solidconnection.common.VerifyStatus;
+import com.example.solidconnection.common.exception.CustomException;
+import com.example.solidconnection.mentor.domain.Mentor;
+import com.example.solidconnection.mentor.domain.Mentoring;
+import com.example.solidconnection.mentor.dto.MentoringApplyRequest;
+import com.example.solidconnection.mentor.dto.MentoringApplyResponse;
+import com.example.solidconnection.mentor.dto.MentoringCheckResponse;
+import com.example.solidconnection.mentor.dto.MentoringConfirmRequest;
+import com.example.solidconnection.mentor.dto.MentoringConfirmResponse;
+import com.example.solidconnection.mentor.repository.MentorRepository;
+import com.example.solidconnection.mentor.repository.MentoringRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import static com.example.solidconnection.common.exception.ErrorCode.MENTORING_ALREADY_CONFIRMED;
+import static com.example.solidconnection.common.exception.ErrorCode.MENTORING_NOT_FOUND;
+import static com.example.solidconnection.common.exception.ErrorCode.MENTOR_NOT_FOUND;
+import static com.example.solidconnection.common.exception.ErrorCode.REJECTED_REASON_REQUIRED;
+import static com.example.solidconnection.common.exception.ErrorCode.UNAUTHORIZED_MENTORING;
+
+@Service
+@RequiredArgsConstructor
+public class MentoringCommandService {
+
+    private final MentoringRepository mentoringRepository;
+    private final MentorRepository mentorRepository;
+
+    @Transactional
+    public MentoringApplyResponse applyMentoring(long siteUserId, MentoringApplyRequest mentoringApplyRequest) {
+        Mentoring mentoring = new Mentoring(mentoringApplyRequest.mentorId(), siteUserId, VerifyStatus.PENDING);
+
+        return MentoringApplyResponse.from(mentoringRepository.save(mentoring));
+    }
+
+    @Transactional
+    public MentoringConfirmResponse confirmMentoring(long siteUserId, long mentoringId, MentoringConfirmRequest mentoringConfirmRequest) {
+        Mentoring mentoring = mentoringRepository.findById(mentoringId)
+                .orElseThrow(() -> new CustomException(MENTORING_NOT_FOUND));
+
+        Mentor mentor = mentorRepository.findBySiteUserId(siteUserId)
+                .orElseThrow(() -> new CustomException(MENTOR_NOT_FOUND));
+
+        validateMentoringOwnership(mentor, mentoring);
+        validateMentoringNotConfirmed(mentoring);
+
+        if (mentoringConfirmRequest.status() == VerifyStatus.REJECTED
+                && (mentoringConfirmRequest.rejectedReason() == null || mentoringConfirmRequest.rejectedReason().isBlank())) {
+            throw new CustomException(REJECTED_REASON_REQUIRED);
+        }
+
+        mentoring.confirm(mentoringConfirmRequest.status(), mentoringConfirmRequest.rejectedReason());
+
+        if (mentoringConfirmRequest.status() == VerifyStatus.APPROVED) {
+            mentor.increaseMenteeCount();
+        }
+
+        return MentoringConfirmResponse.from(mentoring);
+    }
+
+    private void validateMentoringNotConfirmed(Mentoring mentoring) {
+        if (mentoring.getVerifyStatus() != VerifyStatus.PENDING) {
+            throw new CustomException(MENTORING_ALREADY_CONFIRMED);
+        }
+    }
+
+    @Transactional
+    public MentoringCheckResponse checkMentoring(long siteUserId, long mentoringId) {
+        Mentoring mentoring = mentoringRepository.findById(mentoringId)
+                .orElseThrow(() -> new CustomException(MENTORING_NOT_FOUND));
+
+        Mentor mentor = mentorRepository.findBySiteUserId(siteUserId)
+                .orElseThrow(() -> new CustomException(MENTOR_NOT_FOUND));
+
+        validateMentoringOwnership(mentor, mentoring);
+
+        mentoring.check();
+
+        return MentoringCheckResponse.from(mentoring.getId());
+    }
+
+    // 멘토는 본인의 멘토링에 대해 confirm 및 check해야 한다.
+    private void validateMentoringOwnership(Mentor mentor, Mentoring mentoring) {
+        if (mentoring.getMentorId() != mentor.getId()) {
+            throw new CustomException(UNAUTHORIZED_MENTORING);
+        }
+    }
+}