#170 [Feat] 마이페이지 기능 구현

build.gradle

@@ -77,6 +77,8 @@ dependencies {
 	implementation 'io.micrometer:micrometer-registry-prometheus'
 
 
+	// ahocorasick(아호코라식) 의존성 추가
+	implementation 'org.ahocorasick:ahocorasick:0.6.3'
 }
 
 // Querydsl 빌드 옵션 설정

src/main/java/org/sopt/certi_server/domain/acquisition/controller/AcquisitionController.java

@@ -4,10 +4,11 @@
 import io.swagger.v3.oas.annotations.Parameter;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.RequiredArgsConstructor;
+import org.sopt.certi_server.domain.acquisition.dto.request.CreateAcquisitionRequest;
+import org.sopt.certi_server.domain.acquisition.dto.request.PatchAcquisitionRequest;
 import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionDetailResponse;
-import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionListDetailResponse;
-import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionListResponse;
 import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionResponse;
+import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionListResponse;
 import org.sopt.certi_server.domain.acquisition.service.AcquisitionService;
 import org.sopt.certi_server.global.error.code.SuccessCode;
 import org.sopt.certi_server.global.error.dto.SuccessResponse;
@@ -24,19 +25,19 @@
 public class AcquisitionController {
     private final AcquisitionService acquisitionService;
 
-    @PostMapping("/{certificationId}")
+    @PostMapping
     @Operation(summary = "취득한 자격증 추가 API", description = "취득한 자격증을 추가합니다")
-    public ResponseEntity<SuccessResponse<?>> addAcquisition(
+    public ResponseEntity<SuccessResponse<Boolean>> addAcquisition(
             @AuthenticationPrincipal Long userId,
             @Parameter(description = "certification Id", example = "1")
-            @PathVariable(name = "certificationId") Long certificationId
-    ) {
-        boolean isAcquired = acquisitionService.createAcquisition(userId, certificationId);
+            @RequestBody CreateAcquisitionRequest request
+            ) {
+        boolean isAcquired = acquisitionService.createAcquisition(userId, request);
 
         return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_CREATE, isAcquired));
     }
 
-    @GetMapping("/{acquisitionId}")
+    @GetMapping(value = "/{acquisitionId}")
     @Operation(summary = "취득한 자격증 상세 조회 API", description = "취득한 자격증을 상세 조회합니다")
     public ResponseEntity<SuccessResponse<GetAcquisitionDetailResponse>> getAcquisition(
             @Parameter(description = "acquisition Id", example = "1")
@@ -46,7 +47,18 @@ public ResponseEntity<SuccessResponse<GetAcquisitionDetailResponse>> getAcquisit
         return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_FETCH, getAcquisitionDetailResponse));
     }
 
-    @DeleteMapping("/{acquisitionId}")
+    @PatchMapping(value = "/{acquisitionId}")
+    @Operation(summary = "취득한 자격증 정보 수정 API", description = "취득한 자격증 정보를 수정합니다.")
+    public ResponseEntity<SuccessResponse<Void>> modifyAcquisition(
+            @AuthenticationPrincipal Long userId,
+            @RequestBody PatchAcquisitionRequest request,
+            @PathVariable(name = "acquisitionId") Long acquisitionId
+    ){
+        acquisitionService.patchAcquisition(userId, acquisitionId, request);
+        return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_UPDATE));
+    }
+
+    @DeleteMapping(value = "/{acquisitionId}")
     @Operation(summary = "취득한 자격증 삭제 API", description = "취득한 자격증을 상세 조회합니다")
     public ResponseEntity<SuccessResponse<Void>> deleteAcquisition(
             @AuthenticationPrincipal Long userId,
@@ -62,7 +74,7 @@ public ResponseEntity<SuccessResponse<Void>> deleteAcquisition(
     public ResponseEntity<SuccessResponse<GetAcquisitionListResponse>> getAllAcquisitions(
             @AuthenticationPrincipal Long userId
     ) {
-        List<GetAcquisitionListDetailResponse> getAcquisitionResponses = acquisitionService.getAcquisitionList(userId);
+        List<GetAcquisitionResponse> getAcquisitionResponses = acquisitionService.getAcquisitionList(userId);
         GetAcquisitionListResponse getAcquisitionListResponse = GetAcquisitionListResponse.of(getAcquisitionResponses);
 
         return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_FETCH, getAcquisitionListResponse));

src/main/java/org/sopt/certi_server/domain/acquisition/dto/request/CreateAcquisitionRequest.java

@@ -0,0 +1,10 @@
+package org.sopt.certi_server.domain.acquisition.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+
+public record CreateAcquisitionRequest(
+        @NotNull(message = "자격증 id는 필수 값입니다.") Long certificationId
+) {
+}

src/main/java/org/sopt/certi_server/domain/acquisition/dto/request/PatchAcquisitionRequest.java

@@ -0,0 +1,16 @@
+package org.sopt.certi_server.domain.acquisition.dto.request;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import jakarta.validation.constraints.NotNull;
+
+import java.time.LocalDate;
+
+public record PatchAcquisitionRequest(
+
+        @NotNull(message = "취득 날짜 정보를 입력해주세요")
+        @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy.MM.dd", timezone = "Asia/Seoul")
+        LocalDate acquisitionDate,
+
+        String grade
+) {
+}

src/main/java/org/sopt/certi_server/domain/acquisition/dto/response/GetAcquisitionDetailResponse.java

@@ -20,7 +20,7 @@ public record GetAcquisitionDetailResponse(
         List<String> tags,
         String description,
         @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy.MM.dd", timezone = "Asia/Seoul")
-        LocalDate createdAt
+        LocalDate acquisitionDate
 ) {
     public static GetAcquisitionDetailResponse from(Acquisition acquisition) {
         return GetAcquisitionDetailResponse.builder()
@@ -29,7 +29,7 @@ public static GetAcquisitionDetailResponse from(Acquisition acquisition) {
                 .cardBackImageUrl(acquisition.getCardType().getCardBackImageUrl())
                 .index(acquisition.getCardType().getIndex())
                 .name(acquisition.getCertification().getName())
-                .createdAt(acquisition.getCreatedTime().toLocalDate())
+                .acquisitionDate(acquisition.getAcquisitionDate())
                 .description(acquisition.getCertification().getDescription())
                 .tags(acquisition.getCertification().getTags())
                 .build();

src/main/java/org/sopt/certi_server/domain/acquisition/dto/response/GetAcquisitionListResponse.java

@@ -3,9 +3,9 @@
 import java.util.List;
 
 public record GetAcquisitionListResponse(
-        List<GetAcquisitionListDetailResponse> acquisitionListDetailResponses
+        List<GetAcquisitionResponse> acquisitionListDetailResponses
 ) {
-    public static GetAcquisitionListResponse of(List<GetAcquisitionListDetailResponse> priorCertificaitonResponseList) {
+    public static GetAcquisitionListResponse of(List<GetAcquisitionResponse> priorCertificaitonResponseList) {
         return new GetAcquisitionListResponse(priorCertificaitonResponseList);
     }
 }

src/main/java/org/sopt/certi_server/domain/acquisition/dto/response/GetAcquisitionResponse.java

@@ -1,32 +1,36 @@
 package org.sopt.certi_server.domain.acquisition.dto.response;
 
-import com.fasterxml.jackson.annotation.JsonFormat;
-import lombok.Builder;
-import org.sopt.certi_server.domain.acquisition.entity.Acquisition;
-
 import java.time.LocalDate;
 import java.util.List;
 
+import org.sopt.certi_server.domain.acquisition.entity.Acquisition;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+import lombok.Builder;
+
 @Builder
 public record GetAcquisitionResponse(
-        Long acquisitionId,
-        int index,
-        String name,
-        @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy.MM.dd", timezone = "Asia/Seoul")
-        LocalDate createdAt,
-        String cardFrontImageUrl,
-        String cardBackImageUrl,
-        List<String> tags
+	Long acquisitionId,
+	String cardFrontImageUrl,
+	int index,
+	String name,
+	List<String> tags,
+	String description,
+	@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy.MM.dd", timezone = "Asia/Seoul")
+	LocalDate acquisitionDate,
+	String grade
 ) {
-    public static GetAcquisitionResponse from(Acquisition acquisition) {
-        return GetAcquisitionResponse.builder()
-                .acquisitionId(acquisition.getId())
-                .index(acquisition.getCardType().getIndex())
-                .name(acquisition.getCertification().getName())
-                .createdAt(acquisition.getCreatedTime().toLocalDate())
-                .cardFrontImageUrl(acquisition.getCardType().getCardFrontImageUrl())
-                .cardBackImageUrl(acquisition.getCardType().getCardBackImageUrl())
-                .tags(acquisition.getCertification().getTags())
-                .build();
-    }
+	public static GetAcquisitionResponse from(Acquisition acquisition) {
+		return GetAcquisitionResponse.builder()
+			.acquisitionId(acquisition.getId())
+			.cardFrontImageUrl(acquisition.getCardType().getCardFrontImageUrl())
+			.index(acquisition.getCardType().getIndex())
+			.name(acquisition.getCertification().getName())
+			.acquisitionDate(acquisition.getAcquisitionDate())
+			.description(acquisition.getCertification().getDescription())
+			.tags(acquisition.getCertification().getTags())
+			.grade(acquisition.getGrade())
+			.build();
+	}
 }

src/main/java/org/sopt/certi_server/domain/acquisition/entity/Acquisition.java

@@ -11,6 +11,8 @@
 import org.sopt.certi_server.domain.user.entity.User;
 import org.sopt.certi_server.global.entity.BaseTimeEntity;
 
+import java.time.LocalDate;
+
 @Entity
 @Getter
 @NoArgsConstructor(access = AccessLevel.PROTECTED)
@@ -44,11 +46,23 @@ public class Acquisition extends BaseTimeEntity {
     @JoinColumn(name = "user_id")
     private User user;
 
+    @Column(name = "grade")
+    private String grade;
+
+    @Column(name = "acquisition_date")
+    private LocalDate acquisitionDate;
+
     @Builder
-    public Acquisition(Certification certification, CardType cardType, User user, SmallCardType smallCardType) {
+    public Acquisition(Certification certification, CardType cardType, User user, SmallCardType smallCardType, String grade) {
         this.certification = certification;
         this.smallCardType = smallCardType;
         this.cardType = cardType;
         this.user = user;
+        this.acquisitionDate = LocalDate.now();
+    }
+
+    public void changeAcquisition(LocalDate acquisitionDate, String grade) {
+        this.acquisitionDate = acquisitionDate;
+        this.grade = grade;
     }
 }

src/main/java/org/sopt/certi_server/domain/acquisition/service/AcquisitionService.java

@@ -2,8 +2,9 @@
 
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.sopt.certi_server.domain.acquisition.dto.request.CreateAcquisitionRequest;
+import org.sopt.certi_server.domain.acquisition.dto.request.PatchAcquisitionRequest;
 import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionDetailResponse;
-import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionListDetailResponse;
 import org.sopt.certi_server.domain.acquisition.dto.response.GetAcquisitionResponse;
 import org.sopt.certi_server.domain.acquisition.entity.Acquisition;
 import org.sopt.certi_server.domain.acquisition.entity.enums.CardType;
@@ -39,8 +40,8 @@ public class AcquisitionService {
 
 
     @Transactional
-    public boolean createAcquisition(final Long userId, final Long certificationId) {
-        Certification certification = certificationService.getCertification(certificationId);
+    public boolean createAcquisition(final Long userId, final CreateAcquisitionRequest request) {
+        Certification certification = certificationService.getCertification(request.certificationId());
         User user = userService.getUser(userId);
 
         //중복 여부 확인
@@ -91,12 +92,12 @@ public GetAcquisitionDetailResponse getAcquisitionDetail(final Long acquisitionI
         return GetAcquisitionDetailResponse.from(acquisition);
     }
 
-    public List<GetAcquisitionListDetailResponse> getAcquisitionList(final Long userId) {
+    public List<GetAcquisitionResponse> getAcquisitionList(final Long userId) {
         User user = userService.getUser(userId);
         List<Acquisition> acquisitionList = acquisitionRepository.findByUserOrderByIdDesc(user);
 
         return acquisitionList.stream()
-                .map(GetAcquisitionListDetailResponse::from)
+                .map(GetAcquisitionResponse::from)
                 .toList();
     }
 
@@ -111,4 +112,20 @@ public void deleteAcquisition(final Long userId, final Long acquisitionId) {
 
         acquisitionRepository.delete(findAcquisition);
     }
+
+    @Transactional
+    public void patchAcquisition(Long userId, Long acquisitionId, PatchAcquisitionRequest request) {
+
+        User user = userService.getUser(userId);
+        Acquisition acquisition = getAcquisition(acquisitionId);
+
+        if (!Objects.equals(acquisition.getUser().getId(), user.getId())) {
+            throw new ForbiddenException(ErrorCode.ACCESS_DENIED);
+        }
+
+        acquisition.changeAcquisition(
+                request.acquisitionDate(),
+                request.grade()
+        );
+    }
 }

src/main/java/org/sopt/certi_server/domain/certification/controller/CertificationController.java

@@ -6,6 +6,7 @@
 import lombok.RequiredArgsConstructor;
 import org.sopt.certi_server.domain.certification.dto.response.CertificationDetailResponse;
 import org.sopt.certi_server.domain.certification.dto.response.CertificationListResponse;
+import org.sopt.certi_server.domain.certification.dto.response.CertificationRankResponse;
 import org.sopt.certi_server.domain.certification.dto.response.CertificationRecommendationListResponse;
 import org.sopt.certi_server.domain.certification.dto.response.CertificationSimple;
 import org.sopt.certi_server.domain.certification.service.CertificationService;
@@ -81,4 +82,24 @@ public ResponseEntity<SuccessResponse<CertificationRecommendationListResponse>>
         return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_FETCH, certiRecommendListRes));
     }
 
+    @GetMapping("/job")
+    @Operation(summary = "직무별 자격증 조회 API", description = "3순위 직무별 자격증을 조회합니다")
+    public ResponseEntity<SuccessResponse<?>> getTop3ByJob(
+        @AuthenticationPrincipal Long userId
+    ){
+        List<CertificationRankResponse> certificationRankResponseList = certificationService.getCertificationJob(userId);
+        return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_FETCH, certificationRankResponseList));
+    }
+
+    @GetMapping("/track")
+    @Operation(summary = "계열별 자격증 조회 API", description = "3순위 계열별 자격증을 조회합니다")
+    public ResponseEntity<SuccessResponse<?>> getTop3ByTrack(
+        @AuthenticationPrincipal Long userId
+    ) {
+        List<CertificationRankResponse> certificationRankResponseList = certificationService.getCertificationTrack(userId);
+        return ResponseEntity.ok(SuccessResponse.of(SuccessCode.SUCCESS_FETCH, certificationRankResponseList));
+
+    }
+
+
 }

src/main/java/org/sopt/certi_server/domain/certification/dto/response/CertificationRankResponse.java

@@ -0,0 +1,19 @@
+package org.sopt.certi_server.domain.certification.dto.response;
+
+import org.sopt.certi_server.domain.certification.entity.Certification;
+
+public record CertificationRankResponse(
+	int rank,
+	String certificationName,
+	String certificationType
+) {
+	public CertificationRankResponse(int rank, Certification certification) {
+		this(
+			rank,
+			certification.getName(),
+			certification.getCertificationType() != null
+				? certification.getCertificationType().getKoreanName()
+				: null
+		);
+	}
+}

src/main/java/org/sopt/certi_server/domain/certification/dto/response/CertificationScoreDto.java

@@ -11,7 +11,8 @@ public record CertificationScoreDto(
         String testType,
         List<String> tags,
         int recommendationScore,
-        boolean isFavorite) {
+        boolean isFavorite,
+        String description) {
     public static CertificationScoreDto from(
             Certification certification,
             int recommendationScore,
@@ -24,7 +25,8 @@ public static CertificationScoreDto from(
                 certification.getTestType().getType(),
                 certification.getTags().stream().toList(),
                 recommendationScore,
-                isFavorite
+                isFavorite,
+                certification.getDescription()
         );
     }