refactor: 모집공고 등록 API 수정 및 상세 조회 기능 추가 완료 (#652)

Author: SongJaeHoonn

src/main/java/page/clab/api/domain/auth/login/application/dto/request/TwoFactorAuthenticationRequestDto.java

@@ -9,11 +9,11 @@
 @Setter
 public class TwoFactorAuthenticationRequestDto {
 
-    @NotNull(message = "{notNull.twoFactorAuthenticationRequestDto.memberId}")
+    @NotNull(message = "{notNull.twoFactorAuthentication.memberId}")
     @Schema(description = "학번", example = "202310000", required = true)
     private String memberId;
 
-    @NotNull(message = "{notNull.twoFactorAuthenticationRequestDto.totp}")
+    @NotNull(message = "{notNull.twoFactorAuthentication.totp}")
     @Schema(description = "TOTP", example = "123456", required = true)
     private String totp;
 }

src/main/java/page/clab/api/domain/hiring/recruitment/adapter/in/web/RecruitmentDetailsRetrievalController.java

@@ -0,0 +1,30 @@
+package page.clab.api.domain.hiring.recruitment.adapter.in.web;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+import page.clab.api.domain.hiring.recruitment.application.dto.response.RecruitmentDetailsResponseDto;
+import page.clab.api.domain.hiring.recruitment.application.port.in.RetrieveRecruitmentUseCase;
+import page.clab.api.global.common.dto.ApiResponse;
+
+@RestController
+@RequestMapping("/api/v1/recruitments")
+@RequiredArgsConstructor
+@Tag(name = "Hiring - Recruitment", description = "모집 공고")
+public class RecruitmentDetailsRetrievalController {
+
+    private final RetrieveRecruitmentUseCase retrieveRecruitmentUseCase;
+
+    @Operation(summary = "모집 공고 상세 조회", description = "ROLE_ANONYMOUS 이상의 권한이 필요함")
+    @GetMapping("/{recruitmentId}")
+    public ApiResponse<RecruitmentDetailsResponseDto> retrieveRecruitmentDetails(
+        @PathVariable(name = "recruitmentId") Long recruitmentId
+    ) {
+        RecruitmentDetailsResponseDto recruitment = retrieveRecruitmentUseCase.retrieveRecruitmentDetails(recruitmentId);
+        return ApiResponse.success(recruitment);
+    }
+}

src/main/java/page/clab/api/domain/hiring/recruitment/adapter/out/persistence/RecruitmentJpaEntity.java

@@ -37,16 +37,32 @@ public class RecruitmentJpaEntity extends BaseEntity {
     @GeneratedValue(strategy = GenerationType.IDENTITY)
     private Long id;
 
+    @Column(nullable = false)
+    @Size(min = 1, max = 100, message = "{size.recruitment.title}")
+    private String title;
+
+    @Column(nullable = false)
+    @Size(min = 1, max = 10000, message = "{size.recruitment.teamIntroduction}")
+    private String teamIntroduction;
+
     @Column(nullable = false)
     private LocalDateTime startDate;
 
     @Column(nullable = false)
     private LocalDateTime endDate;
 
+    @Column(nullable = false)
+    @Size(min = 1, max = 10000, message = "{size.recruitment.processTimeline}")
+    private String processTimeline;
+
     @Column(nullable = false)
     @Enumerated(EnumType.STRING)
     private ApplicationType applicationType;
 
+    @Column(nullable = false)
+    @Size(min = 1, max = 10000, message = "{size.recruitment.jobDescription}")
+    private String jobDescription;
+
     @Column(nullable = false)
     @Size(min = 1, message = "{size.recruitment.target}")
     private String target;

src/main/java/page/clab/api/domain/hiring/recruitment/application/dto/mapper/RecruitmentDtoMapper.java

@@ -2,6 +2,7 @@
 
 import org.springframework.stereotype.Component;
 import page.clab.api.domain.hiring.recruitment.application.dto.request.RecruitmentRequestDto;
+import page.clab.api.domain.hiring.recruitment.application.dto.response.RecruitmentDetailsResponseDto;
 import page.clab.api.domain.hiring.recruitment.application.dto.response.RecruitmentEndDateResponseDto;
 import page.clab.api.domain.hiring.recruitment.application.dto.response.RecruitmentResponseDto;
 import page.clab.api.domain.hiring.recruitment.domain.Recruitment;
@@ -11,9 +12,13 @@ public class RecruitmentDtoMapper {
 
     public Recruitment fromDto(RecruitmentRequestDto requestDto) {
         return Recruitment.builder()
+            .title(requestDto.getTitle())
+            .teamIntroduction(requestDto.getTeamIntroduction())
             .startDate(requestDto.getStartDate())
             .endDate(requestDto.getEndDate())
+            .processTimeline(requestDto.getProcessTimeline())
             .applicationType(requestDto.getApplicationType())
+            .jobDescription(requestDto.getJobDescription())
             .target(requestDto.getTarget())
             .isDeleted(false)
             .build();
@@ -22,6 +27,7 @@ public Recruitment fromDto(RecruitmentRequestDto requestDto) {
     public RecruitmentResponseDto toDto(Recruitment recruitment) {
         return RecruitmentResponseDto.builder()
             .id(recruitment.getId())
+            .title(recruitment.getTitle())
             .startDate(recruitment.getStartDate())
             .endDate(recruitment.getEndDate())
             .applicationType(recruitment.getApplicationType())
@@ -37,4 +43,20 @@ public RecruitmentEndDateResponseDto toEndDateDto(Recruitment recruitment) {
             .applicationType(recruitment.getApplicationType())
             .build();
     }
+
+    public RecruitmentDetailsResponseDto toDetailsDto(Recruitment recruitment) {
+        return RecruitmentDetailsResponseDto.builder()
+            .id(recruitment.getId())
+            .title(recruitment.getTitle())
+            .teamIntroduction(recruitment.getTeamIntroduction())
+            .startDate(recruitment.getStartDate())
+            .endDate(recruitment.getEndDate())
+            .processTimeline(recruitment.getProcessTimeline())
+            .applicationType(recruitment.getApplicationType())
+            .jobDescription(recruitment.getJobDescription())
+            .target(recruitment.getTarget())
+            .status(recruitment.getStatus().getDescription())
+            .updatedAt(recruitment.getUpdatedAt())
+            .build();
+    }
 }

src/main/java/page/clab/api/domain/hiring/recruitment/application/dto/request/RecruitmentRequestDto.java

@@ -11,6 +11,14 @@
 @Setter
 public class RecruitmentRequestDto {
 
+    @NotNull(message = "{notNull.recruitment.title}")
+    @Schema(description = "모집 공고 제목", example = "C-Lab Core Team 3기 모집", required = true)
+    private String title;
+
+    @NotNull(message = "{notNull.recruitment.teamIntroduction}")
+    @Schema(description = "모집 공고 소개", example = "C-Lab Core Team 3기 모집", required = true)
+    private String teamIntroduction;
+
     @NotNull(message = "{notNull.recruitment.startDate}")
     @Schema(description = "모집 시작일", example = "2023-11-06T00:00:00", required = true)
     private LocalDateTime startDate;
@@ -19,10 +27,18 @@ public class RecruitmentRequestDto {
     @Schema(description = "모집 종료일", example = "2023-11-08T00:00:00", required = true)
     private LocalDateTime endDate;
 
+    @NotNull(message = "{notNull.recruitment.processTimeline}")
+    @Schema(description = "모집 일정", example = "대면 면접 | 09월 10일(화)", required = true)
+    private String processTimeline;
+
     @NotNull(message = "{notNull.recruitment.applicationType}")
     @Schema(description = "구분", example = "CORE_TEAM", required = true)
     private ApplicationType applicationType;
 
+    @NotNull(message = "{notNull.recruitment.jobDescription}")
+    @Schema(description = "설명", example = "실무에 가까운 경험을 쌓을 수 있어요.", required = true)
+    private String jobDescription;
+
     @NotNull(message = "{notNull.recruitment.target}")
     @Schema(description = "대상", example = "2~3학년", required = true)
     private String target;

src/main/java/page/clab/api/domain/hiring/recruitment/application/dto/request/RecruitmentUpdateRequestDto.java

@@ -10,15 +10,27 @@
 @Setter
 public class RecruitmentUpdateRequestDto {
 
+    @Schema(description = "모집 공고 제목", example = "C-Lab Core Team 3기 모집")
+    private String title;
+
+    @Schema(description = "모집 공고 소개", example = "C-Lab Core Team 3기 모집")
+    private String teamIntroduction;
+
     @Schema(description = "모집 시작일", example = "2023-11-06T00:00:00")
     private LocalDateTime startDate;
 
     @Schema(description = "모집 종료일", example = "2023-11-08T00:00:00")
     private LocalDateTime endDate;
 
+    @Schema(description = "모집 일정", example = "대면 면접 | 09월 10일(화)")
+    private String processTimeline;
+
     @Schema(description = "구분", example = "CORE_TEAM")
     private ApplicationType applicationType;
 
+    @Schema(description = "설명", example = "실무에 가까운 경험을 쌓을 수 있어요.")
+    private String jobDescription;
+
     @Schema(description = "대상", example = "2~3학년")
     private String target;
 }

src/main/java/page/clab/api/domain/hiring/recruitment/application/dto/response/RecruitmentDetailsResponseDto.java

@@ -0,0 +1,23 @@
+package page.clab.api.domain.hiring.recruitment.application.dto.response;
+
+import java.time.LocalDateTime;
+import lombok.Builder;
+import lombok.Getter;
+import page.clab.api.domain.hiring.application.domain.ApplicationType;
+
+@Getter
+@Builder
+public class RecruitmentDetailsResponseDto {
+
+    private Long id;
+    private String title;
+    private String teamIntroduction;
+    private LocalDateTime startDate;
+    private LocalDateTime endDate;
+    private String processTimeline;
+    private ApplicationType applicationType;
+    private String jobDescription;
+    private String target;
+    private String status;
+    private LocalDateTime updatedAt;
+}

src/main/java/page/clab/api/domain/hiring/recruitment/application/dto/response/RecruitmentResponseDto.java

@@ -10,6 +10,7 @@
 public class RecruitmentResponseDto {
 
     private Long id;
+    private String title;
     private LocalDateTime startDate;
     private LocalDateTime endDate;
     private ApplicationType applicationType;

src/main/java/page/clab/api/domain/hiring/recruitment/application/port/in/RetrieveRecruitmentUseCase.java

@@ -1,9 +1,7 @@
 package page.clab.api.domain.hiring.recruitment.application.port.in;
 
-
-import page.clab.api.domain.hiring.recruitment.domain.Recruitment;
+import page.clab.api.domain.hiring.recruitment.application.dto.response.RecruitmentDetailsResponseDto;
 
 public interface RetrieveRecruitmentUseCase {
-
-    Recruitment getById(Long recruitmentId);
+    RecruitmentDetailsResponseDto retrieveRecruitmentDetails(Long recruitmentId);
 }

src/main/java/page/clab/api/domain/hiring/recruitment/application/service/RecruitmentRetrievalService.java

@@ -2,6 +2,9 @@
 
 import lombok.RequiredArgsConstructor;
 import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import page.clab.api.domain.hiring.recruitment.application.dto.mapper.RecruitmentDtoMapper;
+import page.clab.api.domain.hiring.recruitment.application.dto.response.RecruitmentDetailsResponseDto;
 import page.clab.api.domain.hiring.recruitment.application.port.in.RetrieveRecruitmentUseCase;
 import page.clab.api.domain.hiring.recruitment.application.port.out.RetrieveRecruitmentPort;
 import page.clab.api.domain.hiring.recruitment.domain.Recruitment;
@@ -11,9 +14,12 @@
 public class RecruitmentRetrievalService implements RetrieveRecruitmentUseCase {
 
     private final RetrieveRecruitmentPort retrieveRecruitmentPort;
+    private final RecruitmentDtoMapper mapper;
 
+    @Transactional(readOnly = true)
     @Override
-    public Recruitment getById(Long recruitmentId) {
-        return retrieveRecruitmentPort.getById(recruitmentId);
+    public RecruitmentDetailsResponseDto retrieveRecruitmentDetails(Long id) {
+        Recruitment recruitment = retrieveRecruitmentPort.getById(id);
+        return mapper.toDetailsDto(recruitment);
     }
 }

src/main/java/page/clab/api/domain/hiring/recruitment/application/service/RecruitmentUpdateService.java

@@ -4,23 +4,23 @@
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 import page.clab.api.domain.hiring.recruitment.application.dto.request.RecruitmentUpdateRequestDto;
-import page.clab.api.domain.hiring.recruitment.application.port.in.RetrieveRecruitmentUseCase;
 import page.clab.api.domain.hiring.recruitment.application.port.in.UpdateRecruitmentUseCase;
+import page.clab.api.domain.hiring.recruitment.application.port.out.RetrieveRecruitmentPort;
 import page.clab.api.domain.hiring.recruitment.application.port.out.UpdateRecruitmentPort;
 import page.clab.api.domain.hiring.recruitment.domain.Recruitment;
 
 @Service
 @RequiredArgsConstructor
 public class RecruitmentUpdateService implements UpdateRecruitmentUseCase {
 
-    private final RetrieveRecruitmentUseCase retrieveRecruitmentUseCase;
+    private final RetrieveRecruitmentPort retrieveRecruitmentPort;
     private final UpdateRecruitmentPort updateRecruitmentPort;
     private final RecruitmentStatusUpdater recruitmentStatusUpdater;
 
     @Transactional
     @Override
     public Long updateRecruitment(Long recruitmentId, RecruitmentUpdateRequestDto requestDto) {
-        Recruitment recruitment = retrieveRecruitmentUseCase.getById(recruitmentId);
+        Recruitment recruitment = retrieveRecruitmentPort.getById(recruitmentId);
         recruitment.update(requestDto);
         recruitmentStatusUpdater.updateRecruitmentStatus(recruitment);
         recruitment.validateDateRange();

src/main/java/page/clab/api/domain/hiring/recruitment/domain/Recruitment.java

@@ -23,18 +23,26 @@
 public class Recruitment {
 
     private Long id;
+    private String title;
+    private String teamIntroduction;
     private LocalDateTime startDate;
     private LocalDateTime endDate;
+    private String processTimeline;
     private ApplicationType applicationType;
+    private String jobDescription;
     private String target;
     private RecruitmentStatus status;
     private Boolean isDeleted;
     private LocalDateTime updatedAt;
 
     public void update(RecruitmentUpdateRequestDto recruitmentUpdateRequestDto) {
+        Optional.ofNullable(recruitmentUpdateRequestDto.getTitle()).ifPresent(this::setTitle);
+        Optional.ofNullable(recruitmentUpdateRequestDto.getTeamIntroduction()).ifPresent(this::setTeamIntroduction);
         Optional.ofNullable(recruitmentUpdateRequestDto.getStartDate()).ifPresent(this::setStartDate);
         Optional.ofNullable(recruitmentUpdateRequestDto.getEndDate()).ifPresent(this::setEndDate);
+        Optional.ofNullable(recruitmentUpdateRequestDto.getProcessTimeline()).ifPresent(this::setProcessTimeline);
         Optional.ofNullable(recruitmentUpdateRequestDto.getApplicationType()).ifPresent(this::setApplicationType);
+        Optional.ofNullable(recruitmentUpdateRequestDto.getJobDescription()).ifPresent(this::setJobDescription);
         Optional.ofNullable(recruitmentUpdateRequestDto.getTarget()).ifPresent(this::setTarget);
     }
 

src/main/java/page/clab/api/global/config/SecurityConstants.java

@@ -18,6 +18,7 @@ public class SecurityConstants {
     public static final String[] PERMIT_ALL_API_ENDPOINTS_GET = {
         "/api/v1/applications/{recruitmentId}/{studentId}",
         "/api/v1/recruitments", "/api/v1/recruitments/recent-week",
+        "/api/v1/recruitments/{recruitmentId}",
         "/api/v1/news", "/api/v1/news/**",
         "/api/v1/blogs", "/api/v1/blogs/**",
         "/api/v1/positions", "/api/v1/positions/**",