Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -87,9 +87,22 @@ public ApiResponse<RecruitmentApplicantListResponse> getApplicants(
description = """
공고 작성자와 지원 본인만 조회할 수 있다. 그 외에는 403 이다.

지원자 프로필, 자기소개(`message`), 참고 링크, 첨부 파일 목록을 함께 반환한다.
지원자 프로필 화면에 필요한 값을 한 번에 반환한다.
이 API 하나로 끝나므로 `GET /users/{userId}` 와 `GET /users/{userId}/portfolios` 를
따로 부르지 않아도 된다.

- 지원 정보 — `message`, `referenceLink`, `files`
- 지원자 프로필 — `applicant` 에 자기소개·지역·역할·관심 카테고리·활동 통계
- 프로젝트 이력 — `applicant.portfolios` 에 최신 5건

`applicant.portfolios` 는 목록 API 와 같은 구조이며 `hasNext` 가 `true` 면
`GET /users/{userId}/portfolios` 로 이어서 조회한다. `nextCursor` 도 그대로 쓸 수 있다.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

포트폴리오 호출 안내를 조건부로 수정하세요.

Line 91-92는 포트폴리오 API를 호출할 필요가 없다고 설명합니다. Line 98-99는 hasNexttrue이면 같은 API를 호출하라고 설명합니다.

최초 5건만 필요한 경우에는 상세 응답만 사용하고, 전체 이력이 필요한 경우에는 포트폴리오 API를 호출한다고 명확히 설명하세요.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@src/main/java/com/slatto/domain/recruitment/controller/RecruitmentApplicationController.java`
around lines 90 - 99, RecruitmentApplicationController의 지원자 프로필 API 안내에서 포트폴리오
API 호출 조건을 명확히 수정하세요. 최초 5건만 필요하면 applicant.portfolios의 상세 응답만 사용하고, 전체 프로젝트 이력이
필요할 때만 GET /users/{userId}/portfolios를 호출하도록 설명을 일관되게 정리하세요.


`files` 에는 파일 본문이 아니라 메타데이터만 담긴다.
실제 내려받기는 첨부 파일 다운로드 API 를 쓴다.

탈퇴한 지원자의 지원도 조회된다. 지원 이력이 사라지면 공고 작성자가 지원자 목록에서
본 항목을 열 수 없게 되기 때문이다.
"""
)
@GetMapping("/{applicationId}")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@
import com.slatto.domain.recruitment.dto.RecruitmentListResponse;
import com.slatto.domain.recruitment.dto.RecruitmentRecommendationResponse;
import com.slatto.domain.recruitment.dto.RecruitmentSummary;
import com.slatto.domain.user.dto.PortfolioListResponse;
import com.slatto.domain.user.dto.UserPublicProfileResponse;
import com.slatto.domain.recruitment.entity.Recruitment;
import com.slatto.domain.recruitment.entity.RecruitmentApplication;
import com.slatto.domain.recruitment.enums.RecruitmentApplicationStatus;
Expand Down Expand Up @@ -186,6 +188,7 @@ public RecruitmentApplicantListResponse.ApplicantSummary toApplicantSummary(
.id(applicant.getId())
.nickname(applicant.getNickname())
.profileImageUrl(applicant.getProfileImageUrl())
.bio(applicant.getBio())
.primaryRole(primaryRole)
.locations(regions)
.build())
Expand All @@ -205,12 +208,10 @@ public RecruitmentApplicationResponse toApplicationResponse(RecruitmentApplicati

public RecruitmentApplicationDetailResponse toApplicationDetailResponse(
RecruitmentApplication application,
RoleName primaryRole,
List<RegionName> regions,
UserPublicProfileResponse applicantProfile,
PortfolioListResponse portfolios,
List<RecruitmentApplicationFileResponse> files
) {
Users applicant = application.getUser();

return RecruitmentApplicationDetailResponse.builder()
.applicationId(application.getId())
.recruitmentId(application.getRecruitment().getId())
Expand All @@ -219,11 +220,16 @@ public RecruitmentApplicationDetailResponse toApplicationDetailResponse(
.referenceLink(application.getReferenceLink())
.appliedAt(application.getCreatedAt())
.applicant(RecruitmentApplicationDetailResponse.ApplicantProfile.builder()
.id(applicant.getId())
.nickname(applicant.getNickname())
.profileImageUrl(applicant.getProfileImageUrl())
.primaryRole(primaryRole)
.locations(regions)
.id(applicantProfile.getId())
.nickname(applicantProfile.getNickname())
.profileImageUrl(applicantProfile.getProfileImageUrl())
.bio(applicantProfile.getBio())
.primaryRole(applicantProfile.getPrimaryRole())
.roles(applicantProfile.getRoles())
.locations(applicantProfile.getLocations())
.categories(applicantProfile.getCategories())
.stats(applicantProfile.getStats())
.portfolios(portfolios)
.build())
.files(files)
.build();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,8 @@ public static class ApplicantProfile {

private String profileImageUrl;

private String bio;

private RoleName primaryRole;

private List<RegionName> locations;
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
package com.slatto.domain.recruitment.dto;

import com.slatto.domain.recruitment.enums.RecruitmentApplicationStatus;
import com.slatto.domain.user.dto.PortfolioListResponse;
import com.slatto.domain.user.dto.UserStatsResponse;
import com.slatto.domain.user.enums.CategoryName;
import com.slatto.domain.user.enums.RegionName;
import com.slatto.domain.user.enums.RoleName;
import lombok.Builder;
Expand Down Expand Up @@ -30,6 +33,8 @@ public class RecruitmentApplicationDetailResponse {
// 파일 본문은 이 응답에 담기지 않는다. 다운로드 API 로 개별 조회한다.
private List<RecruitmentApplicationFileResponse> files;

// 공개 프로필(GET /users/{userId})과 같은 항목을 담는다.
// 지원자 프로필 화면이 이 응답 하나로 완성되도록 모아둔 것이라 노출 범위는 공개 프로필과 동일하다.
@Getter
@Builder
public static class ApplicantProfile {
Expand All @@ -40,8 +45,19 @@ public static class ApplicantProfile {

private String profileImageUrl;

private String bio;

private RoleName primaryRole;

private List<RoleName> roles;

private List<RegionName> locations;

private List<CategoryName> categories;

private UserStatsResponse stats;

// 최신 몇 건만 담는다. 전체 목록은 GET /users/{userId}/portfolios 로 이어서 조회한다.
private PortfolioListResponse portfolios;
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@
import com.slatto.domain.user.repository.LocationRepository;
import com.slatto.domain.user.repository.UserRepository;
import com.slatto.domain.user.repository.UserRoleRepository;
import com.slatto.domain.user.service.PortfolioService;
import com.slatto.domain.user.service.UserService;
import com.slatto.global.exception.BaseException;
import com.slatto.global.response.code.CommonErrorCode;
import lombok.RequiredArgsConstructor;
Expand All @@ -47,6 +49,8 @@ public class RecruitmentApplicationService {

private static final int DEFAULT_PAGE_SIZE = 10;
private static final int MAX_PAGE_SIZE = 50;
// 지원 상세에 끼워 넣는 포트폴리오 건수다. 전체 목록은 GET /users/{userId}/portfolios 로 이어서 받는다.
private static final int APPLICANT_PORTFOLIO_SIZE = 5;

private final RecruitmentRepository recruitmentRepository;
private final RecruitmentApplicationRepository recruitmentApplicationRepository;
Expand All @@ -57,6 +61,8 @@ public class RecruitmentApplicationService {
private final RecruitmentConverter recruitmentConverter;
private final RecruitmentNotificationDispatcher recruitmentNotificationDispatcher;
private final RecruitmentApplicationFileService recruitmentApplicationFileService;
private final UserService userService;
private final PortfolioService portfolioService;

@Transactional
public RecruitmentApplicationResponse applyToRecruitment(
Expand Down Expand Up @@ -160,13 +166,14 @@ public RecruitmentApplicationDetailResponse getApplicationDetail(

validateApplicationAccess(recruitment, application, currentUserId);

Long applicantId = application.getUser().getId();
List<Long> applicantIds = List.of(applicantId);
// 탈퇴한 지원자도 목록에 남으므로 유저 검증이 들어간 조회를 쓰지 않는다.
// getPublicProfile(Long) 을 쓰면 목록에는 보이는데 상세만 404 가 된다.
Users applicant = application.getUser();

return recruitmentConverter.toApplicationDetailResponse(
application,
getPrimaryRoleByUserId(applicantIds).get(applicantId),
getRegionsByUserId(applicantIds).getOrDefault(applicantId, List.of()),
userService.getPublicProfileOf(applicant),
portfolioService.getPortfoliosOf(applicant.getId(), null, APPLICANT_PORTFOLIO_SIZE),
recruitmentApplicationFileService.getFileResponses(List.of(applicationId))
);
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,11 @@ public PortfolioDetailResponse getPortfolio(Long userId, Long portfolioId) {
public PortfolioListResponse getPortfolios(Long userId, Long cursor, int size) {
getUserOrThrow(userId);

return getPortfoliosOf(userId, cursor, size);
}

// 탈퇴 여부를 판정하지 않는다. 지원 상세처럼 탈퇴한 유저의 이력도 함께 보여야 하는 곳에서 쓴다.
public PortfolioListResponse getPortfoliosOf(Long userId, Long cursor, int size) {
int pageSize = normalizePageSize(size);
List<UserPortfolio> portfolios = userPortfolioRepository.findActivePortfoliosByCursor(
userId,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -251,7 +251,13 @@ public UserProfileImageResponse uploadProfileImage(Long userId, MultipartFile fi
}

public UserPublicProfileResponse getPublicProfile(Long userId) {
Users user = getUserOrThrow(userId);
return getPublicProfileOf(getUserOrThrow(userId));
}

// 탈퇴 여부를 판정하지 않는다. 지원 이력처럼 탈퇴한 유저의 프로필도 함께 보여야 하는 곳에서 쓴다.
// 탈퇴 유저를 걸러야 하는 호출자는 getPublicProfile(Long) 을 쓴다.
public UserPublicProfileResponse getPublicProfileOf(Users user) {
Long userId = user.getId();

List<RoleName> roles = userRoleRepository.findAllByUserIdOrderByIdAsc(userId)
.stream()
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,147 @@
package com.slatto.domain.recruitment.service;

import com.slatto.domain.recruitment.dto.RecruitmentApplicationDetailResponse;
import com.slatto.domain.recruitment.entity.Recruitment;
import com.slatto.domain.recruitment.entity.RecruitmentApplication;
import com.slatto.domain.recruitment.repository.RecruitmentApplicationRepository;
import com.slatto.domain.recruitment.repository.RecruitmentRepository;
import com.slatto.domain.user.entity.UserPortfolio;
import com.slatto.domain.user.entity.UserPortfolioRole;
import com.slatto.domain.user.entity.Users;
import com.slatto.domain.user.enums.CategoryName;
import com.slatto.domain.user.enums.Kind;
import com.slatto.domain.user.enums.RegionName;
import com.slatto.domain.user.enums.RoleName;
import com.slatto.domain.user.enums.SocialType;
import com.slatto.domain.user.repository.UserPortfolioRepository;
import com.slatto.domain.user.repository.UserRepository;
import com.slatto.global.exception.BaseException;
import com.slatto.global.response.code.CommonErrorCode;
import jakarta.persistence.EntityManager;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.transaction.annotation.Transactional;

import java.time.LocalDateTime;

import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;

@SpringBootTest
@Transactional
class RecruitmentApplicationDetailIntegrationTest {

@Autowired
private RecruitmentApplicationService recruitmentApplicationService;

@Autowired
private RecruitmentApplicationRepository recruitmentApplicationRepository;

@Autowired
private RecruitmentRepository recruitmentRepository;

@Autowired
private UserPortfolioRepository userPortfolioRepository;

@Autowired
private UserRepository userRepository;

@Autowired
private EntityManager entityManager;

private Users writer;
private Users applicant;
private Recruitment recruitment;
private RecruitmentApplication application;

@BeforeEach
void setUp() {
writer = saveUser("writer@example.com", "작성자", "google-writer");
applicant = saveUser("applicant@example.com", "지원자", "google-applicant");
applicant.updateProfile("지원자", "영상 편집 5년차입니다", null);

recruitment = recruitmentRepository.save(Recruitment.create(
writer, "공고 제목입니다", CategoryName.FILM_DRAMA, null, RoleName.DIRECTOR,
RegionName.SEOUL, null, null, "010-0000-0000", "설명", null
));
application = recruitmentApplicationRepository.save(
RecruitmentApplication.create(applicant, recruitment, "지원합니다", "https://portfolio.example")
);
}

@Test
@DisplayName("지원 상세가 지원자 프로필과 프로젝트 이력을 함께 반환한다")
void returnsApplicantProfileAndPortfolios() {
savePortfolio(CategoryName.FILM_DRAMA, RoleName.EDITOR);

RecruitmentApplicationDetailResponse response = recruitmentApplicationService.getApplicationDetail(
writer.getId(), recruitment.getId(), application.getId()
);

RecruitmentApplicationDetailResponse.ApplicantProfile profile = response.getApplicant();
assertThat(profile.getBio()).isEqualTo("영상 편집 5년차입니다");
assertThat(profile.getPortfolios().getItems()).hasSize(1);
assertThat(profile.getStats().getProjectTypes()).hasSize(1);
assertThat(profile.getStats().getRoles()).hasSize(1);
}

@Test
@DisplayName("포트폴리오가 5건을 넘으면 hasNext 로 더 있음을 알린다")
void marksHasNextWhenPortfolioExceedsLimit() {
for (int i = 0; i < 6; i++) {
savePortfolio(CategoryName.FILM_DRAMA, RoleName.EDITOR);
}

RecruitmentApplicationDetailResponse response = recruitmentApplicationService.getApplicationDetail(
writer.getId(), recruitment.getId(), application.getId()
);

assertThat(response.getApplicant().getPortfolios().getItems()).hasSize(5);
assertThat(response.getApplicant().getPortfolios().getHasNext()).isTrue();
assertThat(response.getApplicant().getPortfolios().getNextCursor()).isNotNull();
}

@Test
@DisplayName("탈퇴한 지원자의 지원도 상세 조회된다")
void returnsDetailForWithdrawnApplicant() {
// 지원자 목록은 탈퇴 여부를 거르지 않는다. 상세만 404 가 되면 작성자가 목록에서 연 항목이 열리지 않는다.
applicant.withdraw(LocalDateTime.now());
entityManager.flush();

RecruitmentApplicationDetailResponse response = recruitmentApplicationService.getApplicationDetail(
writer.getId(), recruitment.getId(), application.getId()
);

assertThat(response.getApplicant().getId()).isEqualTo(applicant.getId());
}

@Test
@DisplayName("공고 작성자도 지원 본인도 아니면 상세를 볼 수 없다")
void deniesDetailToStranger() {
Users stranger = saveUser("stranger@example.com", "제삼자", "google-stranger");

assertThatThrownBy(() -> recruitmentApplicationService.getApplicationDetail(
stranger.getId(), recruitment.getId(), application.getId()
))
.isInstanceOf(BaseException.class)
.extracting(exception -> ((BaseException) exception).getErrorCode())
.isEqualTo(CommonErrorCode.FORBIDDEN);
}

private Users saveUser(String email, String nickname, String socialId) {
return userRepository.save(Users.createSocialUser(
email, nickname, null, SocialType.GOOGLE, socialId
));
}

private void savePortfolio(CategoryName type, RoleName roleName) {
UserPortfolio portfolio = userPortfolioRepository.save(UserPortfolio.create(
applicant, "작업 제목", type, null, Kind.PERSONAL, null, null, null, null, null
));
entityManager.persist(UserPortfolioRole.create(portfolio, applicant, roleName));
entityManager.flush();
}
}
Loading