feat(agent-ratio): 에이전트 정산 비율 관리 기능을 추가한다

This commit is contained in:
2026-04-10 02:23:18 +09:00
parent b84f70a6bf
commit d0be8ec2db
8 changed files with 697 additions and 0 deletions

View File

@@ -0,0 +1,81 @@
package kr.co.vividnext.sodalive.admin.partner.agent.ratio
import kr.co.vividnext.sodalive.partner.agent.ratio.CreateAgentSettlementRatioRequest
import kr.co.vividnext.sodalive.partner.agent.ratio.GetAgentSettlementRatioItem
import kr.co.vividnext.sodalive.partner.agent.ratio.GetAgentSettlementRatioResponse
import org.junit.jupiter.api.Assertions.assertEquals
import org.junit.jupiter.api.BeforeEach
import org.junit.jupiter.api.DisplayName
import org.junit.jupiter.api.Test
import org.mockito.Mockito
import org.springframework.data.domain.PageRequest
import java.time.LocalDateTime
class AdminAgentSettlementRatioControllerTest {
private lateinit var service: AdminAgentSettlementRatioService
private lateinit var controller: AdminAgentSettlementRatioController
@BeforeEach
fun setup() {
service = Mockito.mock(AdminAgentSettlementRatioService::class.java)
controller = AdminAgentSettlementRatioController(service)
}
@Test
@DisplayName("관리자 컨트롤러는 정산 비율 생성 요청을 서비스로 전달한다")
fun shouldForwardCreateRequestToService() {
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
val response = controller.createAgentSettlementRatio(request)
assertEquals(true, response.success)
Mockito.verify(service).createAgentSettlementRatio(request)
}
@Test
@DisplayName("관리자 컨트롤러는 정산 비율 수정 요청을 서비스로 전달한다")
fun shouldForwardUpdateRequestToService() {
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 18,
effectiveFrom = LocalDateTime.of(2026, 4, 10, 0, 0)
)
val response = controller.updateAgentSettlementRatio(request)
assertEquals(true, response.success)
Mockito.verify(service).updateAgentSettlementRatio(request)
}
@Test
@DisplayName("관리자 컨트롤러는 정산 비율 목록 조회 파라미터를 서비스로 전달한다")
fun shouldForwardPageableToService() {
val responseBody = GetAgentSettlementRatioResponse(
totalCount = 1,
items = listOf(
GetAgentSettlementRatioItem(
memberId = 31L,
nickname = "agent-a",
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0),
effectiveTo = null
)
)
)
Mockito.`when`(service.getAgentSettlementRatio(offset = 20L, limit = 20L)).thenReturn(responseBody)
val response = controller.getAgentSettlementRatio(PageRequest.of(1, 20))
assertEquals(true, response.success)
assertEquals(1, response.data!!.totalCount)
assertEquals(15, response.data!!.items[0].settlementRatio)
assertEquals(LocalDateTime.of(2026, 4, 9, 10, 0), response.data!!.items[0].effectiveFrom)
assertEquals(null, response.data!!.items[0].effectiveTo)
Mockito.verify(service).getAgentSettlementRatio(offset = 20L, limit = 20L)
}
}

View File

@@ -0,0 +1,368 @@
package kr.co.vividnext.sodalive.admin.partner.agent.ratio
import kr.co.vividnext.sodalive.common.SodaException
import kr.co.vividnext.sodalive.member.Member
import kr.co.vividnext.sodalive.member.MemberRepository
import kr.co.vividnext.sodalive.member.MemberRole
import kr.co.vividnext.sodalive.partner.agent.ratio.AgentSettlementRatio
import kr.co.vividnext.sodalive.partner.agent.ratio.AgentSettlementRatioRepository
import kr.co.vividnext.sodalive.partner.agent.ratio.CreateAgentSettlementRatioRequest
import kr.co.vividnext.sodalive.partner.agent.ratio.GetAgentSettlementRatioItem
import org.junit.jupiter.api.Assertions.assertEquals
import org.junit.jupiter.api.Assertions.assertThrows
import org.junit.jupiter.api.BeforeEach
import org.junit.jupiter.api.DisplayName
import org.junit.jupiter.api.Test
import org.mockito.ArgumentCaptor
import org.mockito.InOrder
import org.mockito.Mockito
import org.springframework.dao.DataIntegrityViolationException
import java.time.LocalDateTime
class AgentSettlementRatioServiceTest {
private lateinit var repository: AgentSettlementRatioRepository
private lateinit var memberRepository: MemberRepository
private lateinit var service: AdminAgentSettlementRatioService
@BeforeEach
fun setup() {
repository = Mockito.mock(AgentSettlementRatioRepository::class.java)
memberRepository = Mockito.mock(MemberRepository::class.java)
service = AdminAgentSettlementRatioService(
repository = repository,
memberRepository = memberRepository
)
}
@Test
@DisplayName("관리자는 에이전트 정산 비율을 생성할 수 있다")
fun shouldCreateAgentSettlementRatio() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
val request = CreateAgentSettlementRatioRequest(memberId = 31L, settlementRatio = 15, effectiveFrom = effectiveFrom)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(null)
service.createAgentSettlementRatio(request)
val ratioCaptor = ArgumentCaptor.forClass(AgentSettlementRatio::class.java)
Mockito.verify(repository).saveAndFlush(ratioCaptor.capture())
assertEquals(agent, ratioCaptor.value.member)
assertEquals(15, ratioCaptor.value.settlementRatio)
assertEquals(effectiveFrom, ratioCaptor.value.effectiveFrom)
assertEquals(null, ratioCaptor.value.effectiveTo)
}
@Test
@DisplayName("기존 활성 비율이 있으면 생성 요청도 이전 row를 종료하고 새 이력 row를 추가한다")
fun shouldCloseCurrentRatioAndInsertNewHistoryWhenCreating() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val currentRatio = AgentSettlementRatio(
settlementRatio = 10,
effectiveFrom = LocalDateTime.of(2026, 4, 1, 0, 0)
)
currentRatio.member = agent
val newEffectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 15,
effectiveFrom = newEffectiveFrom
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(currentRatio)
service.createAgentSettlementRatio(request)
assertEquals(newEffectiveFrom, currentRatio.effectiveTo)
val ratioCaptor = ArgumentCaptor.forClass(AgentSettlementRatio::class.java)
val inOrder: InOrder = Mockito.inOrder(repository)
inOrder.verify(repository).save(currentRatio)
inOrder.verify(repository).saveAndFlush(ratioCaptor.capture())
assertEquals(agent, ratioCaptor.value.member)
assertEquals(15, ratioCaptor.value.settlementRatio)
assertEquals(newEffectiveFrom, ratioCaptor.value.effectiveFrom)
assertEquals(null, ratioCaptor.value.effectiveTo)
}
@Test
@DisplayName("기존 활성 비율 시작 시각보다 과거 effectiveFrom으로는 생성할 수 없다")
fun shouldThrowWhenCreatingRatioWithBackdatedEffectiveFrom() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val currentRatio = AgentSettlementRatio(
settlementRatio = 10,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
currentRatio.member = agent
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 9, 59)
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(currentRatio)
val exception = assertThrows(SodaException::class.java) {
service.createAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.invalid_effective_from", exception.messageKey)
Mockito.verify(repository, Mockito.never()).save(Mockito.any(AgentSettlementRatio::class.java))
Mockito.verify(repository, Mockito.never()).saveAndFlush(Mockito.any(AgentSettlementRatio::class.java))
}
@Test
@DisplayName("settlementRatio가 0보다 작으면 정산 비율을 생성할 수 없다")
fun shouldThrowWhenCreatingRatioWithSettlementRatioBelowZero() {
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = -1,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
val exception = assertThrows(SodaException::class.java) {
service.createAgentSettlementRatio(request)
}
assertEquals("common.error.invalid_request", exception.messageKey)
Mockito.verifyNoInteractions(memberRepository)
Mockito.verifyNoInteractions(repository)
}
@Test
@DisplayName("기존 활성 비율 시작 시각과 같은 effectiveFrom으로는 수정할 수 없다")
fun shouldThrowWhenUpdatingRatioWithSameEffectiveFrom() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val existingRatio = AgentSettlementRatio(
settlementRatio = 10,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
existingRatio.member = agent
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 18,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(existingRatio)
val exception = assertThrows(SodaException::class.java) {
service.updateAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.invalid_effective_from", exception.messageKey)
Mockito.verify(repository, Mockito.never()).save(Mockito.any(AgentSettlementRatio::class.java))
Mockito.verify(repository, Mockito.never()).saveAndFlush(Mockito.any(AgentSettlementRatio::class.java))
}
@Test
@DisplayName("settlementRatio가 100보다 크면 정산 비율을 수정할 수 없다")
fun shouldThrowWhenUpdatingRatioWithSettlementRatioAboveHundred() {
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 101,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
val exception = assertThrows(SodaException::class.java) {
service.updateAgentSettlementRatio(request)
}
assertEquals("common.error.invalid_request", exception.messageKey)
Mockito.verifyNoInteractions(memberRepository)
Mockito.verifyNoInteractions(repository)
}
@Test
@DisplayName("활성 비율이 없어도 기존 이력 구간과 겹치는 effectiveFrom으로는 생성할 수 없다")
fun shouldThrowWhenCreatingRatioOverlappingClosedHistory() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val historicalRatio = AgentSettlementRatio(
settlementRatio = 10,
effectiveFrom = LocalDateTime.of(2026, 4, 1, 0, 0)
)
historicalRatio.member = agent
historicalRatio.effectiveTo = LocalDateTime.of(2026, 4, 10, 0, 0)
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 18,
effectiveFrom = LocalDateTime.of(2026, 4, 5, 0, 0)
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(null)
Mockito.`when`(repository.findAllByMemberIdOrderByEffectiveFromAsc(31L)).thenReturn(listOf(historicalRatio))
val exception = assertThrows(SodaException::class.java) {
service.createAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.invalid_effective_from", exception.messageKey)
Mockito.verify(repository, Mockito.never()).save(Mockito.any(AgentSettlementRatio::class.java))
Mockito.verify(repository, Mockito.never()).saveAndFlush(Mockito.any(AgentSettlementRatio::class.java))
}
@Test
@DisplayName("동시 요청으로 비율 unique 제약이 충돌하면 잘못된 effectiveFrom 예외로 변환한다")
fun shouldThrowWhenConcurrentInsertViolatesUniqueConstraint() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
val currentRatio = AgentSettlementRatio(
settlementRatio = 12,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
currentRatio.member = agent
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(null, currentRatio)
Mockito.`when`(repository.saveAndFlush(Mockito.any(AgentSettlementRatio::class.java)))
.thenThrow(DataIntegrityViolationException("duplicate"))
val exception = assertThrows(SodaException::class.java) {
service.createAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.invalid_effective_from", exception.messageKey)
}
@Test
@DisplayName("에이전트 회원이 없으면 정산 비율을 생성할 수 없다")
fun shouldThrowWhenAgentDoesNotExist() {
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(null)
val exception = assertThrows(SodaException::class.java) {
service.createAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.agent_not_found", exception.messageKey)
Mockito.verify(memberRepository).findByIdForUpdate(31L)
Mockito.verifyNoInteractions(repository)
}
@Test
@DisplayName("에이전트가 아닌 회원에게는 정산 비율을 생성할 수 없다")
fun shouldThrowWhenMemberIsNotAgent() {
val creator = Member(password = "password", nickname = "creator", role = MemberRole.CREATOR)
creator.id = 31L
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(creator)
val exception = assertThrows(SodaException::class.java) {
service.createAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.invalid_agent", exception.messageKey)
Mockito.verify(memberRepository).findByIdForUpdate(31L)
Mockito.verifyNoInteractions(repository)
}
@Test
@DisplayName("관리자는 기존 에이전트 정산 비율을 수정할 수 있다")
fun shouldUpdateAgentSettlementRatio() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val existingRatio = AgentSettlementRatio(
settlementRatio = 10,
effectiveFrom = LocalDateTime.of(2026, 4, 1, 0, 0)
)
existingRatio.member = agent
val newEffectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 18,
effectiveFrom = newEffectiveFrom
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(existingRatio)
service.updateAgentSettlementRatio(request)
assertEquals(newEffectiveFrom, existingRatio.effectiveTo)
val ratioCaptor = ArgumentCaptor.forClass(AgentSettlementRatio::class.java)
val inOrder: InOrder = Mockito.inOrder(repository)
inOrder.verify(repository).save(existingRatio)
inOrder.verify(repository).saveAndFlush(ratioCaptor.capture())
assertEquals(agent, ratioCaptor.value.member)
assertEquals(18, ratioCaptor.value.settlementRatio)
assertEquals(newEffectiveFrom, ratioCaptor.value.effectiveFrom)
assertEquals(null, ratioCaptor.value.effectiveTo)
}
@Test
@DisplayName("기존 정산 비율이 없으면 수정할 수 없다")
fun shouldThrowWhenSettlementRatioDoesNotExist() {
val agent = Member(password = "password", nickname = "agent", role = MemberRole.AGENT)
agent.id = 31L
val request = CreateAgentSettlementRatioRequest(
memberId = 31L,
settlementRatio = 18,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0)
)
Mockito.`when`(memberRepository.findByIdForUpdate(31L)).thenReturn(agent)
Mockito.`when`(repository.findFirstByMemberIdAndEffectiveToIsNull(31L)).thenReturn(null)
val exception = assertThrows(SodaException::class.java) {
service.updateAgentSettlementRatio(request)
}
assertEquals("partner.agent.ratio.not_found", exception.messageKey)
Mockito.verify(repository).findFirstByMemberIdAndEffectiveToIsNull(31L)
Mockito.verify(repository, Mockito.never()).save(Mockito.any(AgentSettlementRatio::class.java))
}
@Test
@DisplayName("관리자는 에이전트 정산 비율 목록을 조회할 수 있다")
fun shouldGetAgentSettlementRatioList() {
val items = listOf(
GetAgentSettlementRatioItem(
memberId = 31L,
nickname = "agent-a",
settlementRatio = 15,
effectiveFrom = LocalDateTime.of(2026, 4, 9, 10, 0),
effectiveTo = null
)
)
Mockito.`when`(repository.getAgentSettlementRatioTotalCount()).thenReturn(1)
Mockito.`when`(repository.getAgentSettlementRatio(offset = 20L, limit = 20L)).thenReturn(items)
val response = service.getAgentSettlementRatio(offset = 20L, limit = 20L)
assertEquals(1, response.totalCount)
assertEquals(1, response.items.size)
assertEquals(15, response.items[0].settlementRatio)
assertEquals(LocalDateTime.of(2026, 4, 9, 10, 0), response.items[0].effectiveFrom)
assertEquals(null, response.items[0].effectiveTo)
}
}