[LIME-9] 친구 관계 기능 추가

lime-api/src/main/java/com/programmers/lime/domains/friendships/api/FriendshipController.java

@@ -0,0 +1,75 @@
+package com.programmers.lime.domains.friendships.api;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.ModelAttribute;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.programmers.lime.common.cursor.CursorSummary;
+import com.programmers.lime.domains.friendships.api.dto.response.FriendshipGetByCursorResponse;
+import com.programmers.lime.domains.friendships.application.FriendshipService;
+import com.programmers.lime.domains.friendships.model.FriendshipSummary;
+import com.programmers.lime.global.cursor.CursorRequest;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+
+@Tag(name = "friendships", description = "친구 관계 API")
+@RestController
+@RequiredArgsConstructor
+@RequestMapping("/api/friendships")
+public class FriendshipController {
+
+	private final FriendshipService friendshipService;
+
+	@Operation(summary = "팔로우", description = "팔로우 할 닉네임을 이용하여 팔로우 합니다.")
+	@PostMapping("/follow/{nickname}")
+	public ResponseEntity<Void> follow(@PathVariable final String nickname) {
+		friendshipService.follow(nickname);
+
+		return ResponseEntity.ok().build();
+	}
+
+	@Operation(summary = "언팔로우", description = "언팔로우 할 닉네임을 이용하여 팔로우를 취소합니다.")
+	@PostMapping("/unfollow/{nickname}")
+	public ResponseEntity<Void> unfollow(@PathVariable final String nickname) {
+		friendshipService.unfollow(nickname);
+
+		return ResponseEntity.ok().build();
+	}
+
+	@Operation(summary = "팔로워 목록 조회", description = "회원을 팔로우한 사람들의 목록을 조회한다.")
+	@GetMapping("/follower/{nickname}")
+	public ResponseEntity<FriendshipGetByCursorResponse> getFollower(
+		@PathVariable final String nickname,
+		@ModelAttribute @Valid final CursorRequest request
+	) {
+		final CursorSummary<FriendshipSummary> cursorSummary = friendshipService.getFollower(
+			nickname,
+			request.toParameters()
+		);
+		final FriendshipGetByCursorResponse response = FriendshipGetByCursorResponse.from(cursorSummary);
+
+		return ResponseEntity.ok(response);
+	}
+
+	@Operation(summary = "팔로잉 목록 조회", description = "회원이 팔로우한 사람들의 목록을 조회한다.")
+	@GetMapping("/following/{nickname}")
+	public ResponseEntity<FriendshipGetByCursorResponse> getFollowing(
+		@PathVariable final String nickname,
+		@ModelAttribute @Valid final CursorRequest request
+	) {
+		final CursorSummary<FriendshipSummary> cursorSummary = friendshipService.getFollowing(
+			nickname,
+			request.toParameters()
+		);
+		final FriendshipGetByCursorResponse response = FriendshipGetByCursorResponse.from(cursorSummary);
+
+		return ResponseEntity.ok(response);
+	}
+}

lime-api/src/main/java/com/programmers/lime/domains/friendships/api/dto/response/FriendshipGetByCursorResponse.java

@@ -0,0 +1,20 @@
+package com.programmers.lime.domains.friendships.api.dto.response;
+
+import java.util.List;
+
+import com.programmers.lime.common.cursor.CursorSummary;
+import com.programmers.lime.domains.friendships.model.FriendshipSummary;
+
+public record FriendshipGetByCursorResponse(
+	String nextCursorId,
+	Integer totalCount,
+	List<FriendshipSummary> followers
+) {
+	public static FriendshipGetByCursorResponse from(final CursorSummary<FriendshipSummary> cursorSummary) {
+		return new FriendshipGetByCursorResponse(
+			cursorSummary.nextCursorId(),
+			cursorSummary.summaryCount(),
+			cursorSummary.summaries()
+		);
+	}
+}

lime-api/src/main/java/com/programmers/lime/domains/friendships/application/FriendshipService.java

@@ -0,0 +1,54 @@
+package com.programmers.lime.domains.friendships.application;
+
+import org.springframework.stereotype.Service;
+
+import com.programmers.lime.common.cursor.CursorPageParameters;
+import com.programmers.lime.common.cursor.CursorSummary;
+import com.programmers.lime.domains.friendships.implementation.FriendshipAppender;
+import com.programmers.lime.domains.friendships.implementation.FriendshipReader;
+import com.programmers.lime.domains.friendships.implementation.FriendshipRemover;
+import com.programmers.lime.domains.friendships.model.FriendshipSummary;
+import com.programmers.lime.domains.member.domain.Member;
+import com.programmers.lime.domains.member.implementation.MemberReader;
+import com.programmers.lime.global.util.MemberUtils;
+
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+public class FriendshipService {
+
+	private final FriendshipAppender friendshipAppender;
+	private final FriendshipRemover friendshipRemover;
+	private final FriendshipReader friendshipReader;
+	private final MemberUtils memberUtils;
+	private final MemberReader memberReader;
+
+	public void follow(final String nickname) {
+		final Member fromMember = memberUtils.getCurrentMember();
+		final Member toMember = memberReader.readByNickname(nickname);
+
+		friendshipAppender.append(toMember, fromMember);
+	}
+
+	public void unfollow(final String nickname) {
+		final Member fromMember = memberUtils.getCurrentMember();
+		final Member toMember = memberReader.readByNickname(nickname);
+
+		friendshipRemover.remove(toMember, fromMember);
+	}
+
+	public CursorSummary<FriendshipSummary> getFollower(
+		final String nickname,
+		final CursorPageParameters parameters
+	) {
+		return friendshipReader.readFollowerByCursor(nickname, parameters);
+	}
+
+	public CursorSummary<FriendshipSummary> getFollowing(
+		final String nickname,
+		final CursorPageParameters parameters
+	) {
+		return friendshipReader.readFollowingByCursor(nickname, parameters);
+	}
+}

lime-api/src/main/java/com/programmers/lime/global/config/security/SecurityConfiguration.java

@@ -19,6 +19,7 @@
 import org.springframework.web.cors.CorsConfigurationSource;
 import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
 
+import com.programmers.lime.domains.auth.OAuth2UserService;
 import com.programmers.lime.domains.member.implementation.MemberReader;
 import com.programmers.lime.global.config.security.auth.handler.OAuth2LoginFailureHandler;
 import com.programmers.lime.global.config.security.auth.handler.OAuth2LoginSuccessHandler;
@@ -57,6 +58,9 @@ public SecurityFilterChain securityFilterChain(final HttpSecurity http) throws E
 					.requestMatchers("/api/members/mypage/{nickname}").permitAll()
 					.requestMatchers("/api/members/refresh").permitAll()
 
+					.requestMatchers("/api/friendships/follower/**").permitAll()
+					.requestMatchers("/api/friendships/following/**").permitAll()
+
 					.requestMatchers(HttpMethod.GET, "/api/votes").permitAll()
 					.requestMatchers(HttpMethod.GET, "/api/votes/{voteId}").permitAll()
 

lime-common/src/main/java/com/programmers/lime/error/ErrorCode.java

@@ -39,7 +39,8 @@ public enum ErrorCode {
 	MEMBER_NICKNAME_BAD_PATTERN("MEMBER_009", "닉네임은 영어 대소문자, 한글, 숫자 그리고 언더스코어만 허용합니다."),
 	MEMBER_INTRODUCTION_CONTENT_BAD_LENGTH("MEMBER_012", "자기소개는 최대 300자 입니다."),
 	MEMBER_INTRODUCTION_MBTI_BAD_REQUEST("MEMBER_014", "잘못된 MBTI 값입니다."),
-	MEMBER_INTRODUCTION_CAREER_BAD_VALUE("MEMBER_015", "취미 경력은 0보다 작을 수 없습니다."),
+	MEMBER_INTRODUCTION_FAVORABILITY_BAD_REQUEST("MEMBER_015", "잘못된 선호도 값입니다."),
+	MEMBER_INTRODUCTION_CAREER_BAD_VALUE("MEMBER_016", "경력은 최소 0개월 이상이어야 합니다."),
 
 	// Item
 	ITEM_MARKET_NOT_FOUND("ITEM_001", "지원하지 않는 아이템 URL 입니다."),
@@ -107,7 +108,12 @@ public enum ErrorCode {
 
 	// MemberItemFolder
 	MEMBER_ITEM_FOLDER_NOT_FOUND("MEMBER_ITEM_FOLDER_001", "폴더를 찾을 수 없습니다."),
-	MEMBER_ITEM_FOLDER_NOT_MINE("MEMBER_ITEM_FOLDER_002", "나의 아이템 폴더가 아닙니다.");
+	MEMBER_ITEM_FOLDER_NOT_MINE("MEMBER_ITEM_FOLDER_002", "나의 아이템 폴더가 아닙니다."),
+
+	// Friendship
+	FRIENDSHIP_NOT_FOUND("FRIENDSHIP_001", "친구 관계를 찾을 수 없습니다."),
+	FRIENDSHIP_ALREADY_EXISTS("FRIENDSHIP_002", "이미 친구 관계가 존재합니다."),
+	;
 
 	private static final Map<String, ErrorCode> ERROR_CODE_MAP;
 

lime-domain/src/main/java/com/programmers/lime/domains/friendships/domain/Friendship.java

@@ -0,0 +1,47 @@
+package com.programmers.lime.domains.friendships.domain;
+
+import java.util.Objects;
+
+import com.programmers.lime.domains.BaseEntity;
+import com.programmers.lime.domains.member.domain.Member;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+import jakarta.persistence.ManyToOne;
+import jakarta.persistence.Table;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor(access = AccessLevel.PROTECTED)
+@Entity
+@Table(name = "friendships")
+public class Friendship extends BaseEntity {
+
+	@Id
+	@GeneratedValue(strategy = GenerationType.IDENTITY)
+	@Column(name = "id")
+	private Long id;
+
+	@ManyToOne(fetch = FetchType.LAZY)
+	@JoinColumn(name = "to_member_id", nullable = false)
+	private Member toMember;
+
+	@ManyToOne(fetch = FetchType.LAZY)
+	@JoinColumn(name = "from_member_id", nullable = false)
+	private Member fromMember;
+
+	public Friendship(
+		final Member toMember,
+		final Member fromMember
+	) {
+		this.toMember = Objects.requireNonNull(toMember);
+		this.fromMember = Objects.requireNonNull(fromMember);
+	}
+}

lime-domain/src/main/java/com/programmers/lime/domains/friendships/implementation/FriendshipAppender.java

@@ -0,0 +1,31 @@
+package com.programmers.lime.domains.friendships.implementation;
+
+import org.springframework.stereotype.Component;
+
+import com.programmers.lime.domains.friendships.domain.Friendship;
+import com.programmers.lime.domains.friendships.repository.FriendshipRepository;
+import com.programmers.lime.domains.member.domain.Member;
+import com.programmers.lime.error.BusinessException;
+import com.programmers.lime.error.ErrorCode;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@RequiredArgsConstructor
+public class FriendshipAppender {
+
+	private final FriendshipRepository friendshipRepository;
+
+	public Friendship append(
+		final Member toMember,
+		final Member fromMember
+	) {
+		if (friendshipRepository.existsByToMemberAndFromMember(toMember, fromMember)) {
+			throw new BusinessException(ErrorCode.FRIENDSHIP_ALREADY_EXISTS);
+		}
+
+		final Friendship friendship = new Friendship(toMember, fromMember);
+
+		return friendshipRepository.save(friendship);
+	}
+}

lime-domain/src/main/java/com/programmers/lime/domains/friendships/implementation/FriendshipCounter.java

@@ -0,0 +1,26 @@
+package com.programmers.lime.domains.friendships.implementation;
+
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.programmers.lime.domains.friendships.repository.FriendshipRepository;
+import com.programmers.lime.domains.member.domain.Member;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@RequiredArgsConstructor
+public class FriendshipCounter {
+
+	private final FriendshipRepository friendshipRepository;
+
+	@Transactional(readOnly = true)
+	public long countFollower(final Member member) {
+		return friendshipRepository.countByToMember(member);
+	}
+
+	@Transactional(readOnly = true)
+	public long countFollowing(final Member member) {
+		return friendshipRepository.countByFromMember(member);
+	}
+}

lime-domain/src/main/java/com/programmers/lime/domains/friendships/implementation/FriendshipReader.java

@@ -0,0 +1,70 @@
+package com.programmers.lime.domains.friendships.implementation;
+
+import java.util.List;
+
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import com.programmers.lime.common.cursor.CursorPageParameters;
+import com.programmers.lime.common.cursor.CursorSummary;
+import com.programmers.lime.common.cursor.CursorUtils;
+import com.programmers.lime.domains.friendships.domain.Friendship;
+import com.programmers.lime.domains.friendships.model.FriendshipSummary;
+import com.programmers.lime.domains.friendships.repository.FriendshipRepository;
+import com.programmers.lime.domains.member.domain.Member;
+import com.programmers.lime.error.EntityNotFoundException;
+import com.programmers.lime.error.ErrorCode;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@RequiredArgsConstructor
+public class FriendshipReader {
+
+	public static final int DEFAULT_PAGING_SIZE = 20;
+
+	private final FriendshipRepository friendshipRepository;
+
+	@Transactional(readOnly = true)
+	public Friendship read(
+		final Member toMember,
+		final Member fromMember
+	) {
+		return friendshipRepository.findByToMemberAndFromMember(toMember, fromMember)
+			.orElseThrow(() -> new EntityNotFoundException(ErrorCode.FRIENDSHIP_NOT_FOUND));
+	}
+
+	@Transactional(readOnly = true)
+	public CursorSummary<FriendshipSummary> readFollowerByCursor(
+		final String nickname,
+		final CursorPageParameters parameters
+	) {
+		final int pageSize = getPageSize(parameters);
+		final List<FriendshipSummary> followerSummaries = friendshipRepository.findFollowerByCursor(
+			nickname,
+			parameters.cursorId(),
+			pageSize
+		);
+
+		return CursorUtils.getCursorSummaries(followerSummaries);
+	}
+
+	@Transactional(readOnly = true)
+	public CursorSummary<FriendshipSummary> readFollowingByCursor(
+		final String nickname,
+		final CursorPageParameters parameters
+	) {
+		final int pageSize = getPageSize(parameters);
+		final List<FriendshipSummary> followerSummaries = friendshipRepository.findFollowingByCursor(
+			nickname,
+			parameters.cursorId(),
+			pageSize
+		);
+
+		return CursorUtils.getCursorSummaries(followerSummaries);
+	}
+
+	private int getPageSize(final CursorPageParameters parameters) {
+		return parameters.size() == null ? DEFAULT_PAGING_SIZE : parameters.size();
+	}
+}

lime-domain/src/main/java/com/programmers/lime/domains/friendships/implementation/FriendshipRemover.java

@@ -0,0 +1,25 @@
+package com.programmers.lime.domains.friendships.implementation;
+
+import org.springframework.stereotype.Component;
+
+import com.programmers.lime.domains.friendships.domain.Friendship;
+import com.programmers.lime.domains.friendships.repository.FriendshipRepository;
+import com.programmers.lime.domains.member.domain.Member;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@RequiredArgsConstructor
+public class FriendshipRemover {
+
+	private final FriendshipRepository friendshipRepository;
+	private final FriendshipReader friendshipReader;
+
+	public void remove(
+		final Member toMember,
+		final Member fromMember
+	) {
+		final Friendship friendship = friendshipReader.read(toMember, fromMember);
+		friendshipRepository.delete(friendship);
+	}
+}