feat(agent-calculate): 소속 크리에이터 응답에 프로필 이미지를 추가한다

2026-04-13 18:51:33 +09:00
parent f740041dca
commit 2c19e4b76c
9 changed files with 75 additions and 11 deletions
--- a/docs/20260413_에이전트소속크리에이터프로필이미지추가.md
+++ b/docs/20260413_에이전트소속크리에이터프로필이미지추가.md
@@ -0,0 +1,20 @@
+# 에이전트 소속 크리에이터 프로필 이미지 추가
+
+- [x] `getAssignedCreators` 흐름과 기존 프로필 이미지 응답 패턴을 확인한다.
+- [x] `GetAgentAssignedCreatorItem`에 프로필 이미지 URL 필드를 추가한다.
+- [x] `AgentCalculateQueryRepository.getAssignedCreators` projection에 프로필 이미지 URL을 포함한다.
+- [x] `AgentCalculateQueryRepositoryTest`에 프로필 이미지 URL 및 기본 이미지 fallback 검증을 추가한다.
+- [x] `AgentCalculateServiceTest`, `AgentCalculateControllerTest` fixture와 검증을 갱신한다.
+- [x] 정적 진단과 관련 테스트를 실행해 변경을 검증한다.
+
+## 검증 기록
+
+### 1차 구현
+- 무엇을: 에이전트 소속 크리에이터 조회 응답에 프로필 이미지 URL 필드 추가 구현 및 검증
+- 왜: 크리에이터 목록 응답에서 프로필 이미지를 함께 내려주기 위해
+- 어떻게:
+  - `./gradlew test --tests "kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateServiceTest"` 실행 시 `profileImageUrl` 및 `cloudFrontHost` 관련 컴파일 실패를 확인해 red 단계 검증
+  - `./gradlew test --tests "kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateQueryRepositoryTest" --tests "kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateServiceTest" --tests "kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateControllerTest"` 실행 결과 `BUILD SUCCESSFUL`
+  - `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL`
+  - `./gradlew test --tests "kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateQueryRepositoryTest.shouldGetAssignedCreatorsWithProfileImageUrl" --tests "kr.co.vividnext.sodalive.partner.agent.calculate.AgentCalculateControllerTest.shouldForwardAssignedCreatorsRequestToService"` 실행 결과 `BUILD SUCCESSFUL`
+  - Kotlin LSP 서버가 현재 환경에 없어 `lsp_diagnostics`는 수행 불가였고, 대신 compile/test/ktlint 결과로 정적 검증 대체
--- a/src/main/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateQueryRepository.kt
+++ b/src/main/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateQueryRepository.kt
@@ -15,6 +15,7 @@ import kr.co.vividnext.sodalive.live.room.QLiveRoom.liveRoom
 import kr.co.vividnext.sodalive.member.QMember.member
 import kr.co.vividnext.sodalive.partner.agent.assignment.QAgentCreatorRelation.agentCreatorRelation
 import kr.co.vividnext.sodalive.partner.agent.ratio.QAgentSettlementRatio.agentSettlementRatio
+import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Repository
 import java.time.LocalDateTime
 import javax.persistence.EntityManager
@@ -22,7 +23,10 @@ import javax.persistence.EntityManager
@Repository
 class AgentCalculateQueryRepository(
    private val queryFactory: JPAQueryFactory,
-    private val entityManager: EntityManager
+    private val entityManager: EntityManager,
+
+    @Value("\${cloud.aws.cloud-front.host}")
+    private val cloudFrontHost: String
 ) {
    fun getAssignedCreatorTotalCount(agentId: Long, currentTime: LocalDateTime): Int {
        return queryFactory
@@ -46,7 +50,11 @@ class AgentCalculateQueryRepository(
            .select(
                QGetAgentAssignedCreatorItem(
                    agentCreatorRelation.creator.id,
-                    agentCreatorRelation.creator.nickname
+                    agentCreatorRelation.creator.nickname,
+                    agentCreatorRelation.creator.profileImage
+                        .coalesce("profile/default-profile.png")
+                        .prepend("/")
+                        .prepend(cloudFrontHost)
                )
            )
            .from(agentCreatorRelation)
--- a/src/main/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/GetAgentAssignedCreatorResponse.kt
+++ b/src/main/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/GetAgentAssignedCreatorResponse.kt
@@ -9,5 +9,6 @@ data class GetAgentAssignedCreatorResponse(

 data class GetAgentAssignedCreatorItem @QueryProjection constructor(
    val creatorId: Long,
-    val creatorNickname: String
+    val creatorNickname: String,
+    val profileImageUrl: String
 )
--- a/src/test/kotlin/kr/co/vividnext/sodalive/admin/partner/agent/read/AdminAgentReadCurrentMonthListSummaryTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/admin/partner/agent/read/AdminAgentReadCurrentMonthListSummaryTest.kt
@@ -58,12 +58,14 @@ class AdminAgentReadCurrentMonthListSummaryTest @Autowired constructor(
    private val snapshotRepository: AgentSettlementSnapshotRepository,
    private val entityManager: EntityManager
 ) {
+    private val cloudFrontHost = "https://cdn.test"
+
    private lateinit var repository: AdminAgentReadQueryRepository
    private lateinit var calculateService: AgentCalculateService

    @BeforeEach
    fun setup() {
-        val calculateQueryRepository = AgentCalculateQueryRepository(queryFactory, entityManager)
+        val calculateQueryRepository = AgentCalculateQueryRepository(queryFactory, entityManager, cloudFrontHost)
        repository = AdminAgentReadQueryRepository(queryFactory, calculateQueryRepository)
        calculateService = AgentCalculateService(calculateQueryRepository, snapshotRepository)
        registerMysqlDateFunctions()
--- a/src/test/kotlin/kr/co/vividnext/sodalive/admin/partner/agent/read/AdminAgentReadParityTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/admin/partner/agent/read/AdminAgentReadParityTest.kt
@@ -55,6 +55,8 @@ class AdminAgentReadParityTest @Autowired constructor(
    private val snapshotRepository: AgentSettlementSnapshotRepository,
    private val entityManager: EntityManager
 ) {
+    private val cloudFrontHost = "https://cdn.test"
+
    private var seededAgentId: Long = 0L
    private lateinit var agentService: AgentCalculateService
    private lateinit var adminService: AdminAgentReadService
@@ -62,7 +64,7 @@ class AdminAgentReadParityTest @Autowired constructor(
    @BeforeEach
    fun setup() {
        registerMysqlDateFunctions()
-        val queryRepository = AgentCalculateQueryRepository(queryFactory, entityManager)
+        val queryRepository = AgentCalculateQueryRepository(queryFactory, entityManager, cloudFrontHost)
        val adminQueryRepository = AdminAgentReadQueryRepository(queryFactory, queryRepository)
        agentService = AgentCalculateService(queryRepository, snapshotRepository)
        adminService = AdminAgentReadService(adminQueryRepository, memberRepository, agentService)
--- a/src/test/kotlin/kr/co/vividnext/sodalive/admin/partner/agent/read/AdminAgentReadQueryRepositoryTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/admin/partner/agent/read/AdminAgentReadQueryRepositoryTest.kt
@@ -28,13 +28,15 @@ class AdminAgentReadQueryRepositoryTest @Autowired constructor(
    private val relationRepository: AgentCreatorRelationRepository,
    private val entityManager: EntityManager
 ) {
+    private val cloudFrontHost = "https://cdn.test"
+
    private lateinit var repository: AdminAgentReadQueryRepository

    @BeforeEach
    fun setup() {
        repository = AdminAgentReadQueryRepository(
            queryFactory,
-            AgentCalculateQueryRepository(queryFactory, entityManager)
+            AgentCalculateQueryRepository(queryFactory, entityManager, cloudFrontHost)
        )
    }

--- a/src/test/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateControllerTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateControllerTest.kt
@@ -43,7 +43,8 @@ class AgentCalculateControllerTest {
            items = listOf(
                GetAgentAssignedCreatorItem(
                    creatorId = 21L,
-                    creatorNickname = "creator-a"
+                    creatorNickname = "creator-a",
+                    profileImageUrl = "https://cdn.test/profile/creator-a.png"
                )
            )
        )
@@ -58,6 +59,7 @@ class AgentCalculateControllerTest {
        assertEquals(true, apiResponse.success)
        assertEquals(1, apiResponse.data!!.totalCount)
        assertEquals(21L, apiResponse.data!!.items[0].creatorId)
+        assertEquals("https://cdn.test/profile/creator-a.png", apiResponse.data!!.items[0].profileImageUrl)
        Mockito.verify(service).getAssignedCreators(agentId = 7L, offset = 10L, limit = 5L)
    }

--- a/src/test/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateQueryRepositoryTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateQueryRepositoryTest.kt
@@ -56,13 +56,15 @@ class AgentCalculateQueryRepositoryTest @Autowired constructor(
    private val useCanCalculateRepository: UseCanCalculateRepository,
    private val entityManager: EntityManager
 ) {
+    private val cloudFrontHost = "https://cdn.test"
+
    private lateinit var repository: AgentCalculateQueryRepository
    private lateinit var service: AgentCalculateService

    @BeforeEach
    fun setup() {
        registerMysqlDateFunctions()
-        repository = AgentCalculateQueryRepository(queryFactory, entityManager)
+        repository = AgentCalculateQueryRepository(queryFactory, entityManager, cloudFrontHost)
        service = AgentCalculateService(repository, snapshotRepository)
    }

@@ -110,6 +112,28 @@ class AgentCalculateQueryRepositoryTest @Autowired constructor(
        assertEquals(listOf(endingFutureCreator.id, currentCreator.id), items.map { it.creatorId })
    }

+    @Test
+    @DisplayName("소속 크리에이터 목록 조회는 프로필 이미지 URL과 기본 이미지를 함께 반환한다")
+    fun shouldGetAssignedCreatorsWithProfileImageUrl() {
+        val agent = saveMember("agent-image", MemberRole.AGENT)
+        val creatorWithImage = saveMember("creator-image", MemberRole.CREATOR, profileImage = "profile/creator-image.png")
+        val creatorWithoutImage = saveMember("creator-default", MemberRole.CREATOR)
+        val currentTime = LocalDateTime.of(2026, 2, 20, 12, 0, 0)
+
+        saveRelation(agent, creatorWithImage)
+        saveRelation(agent, creatorWithoutImage)
+
+        val items = repository.getAssignedCreators(agent.id!!, offset = 0, limit = 10, currentTime = currentTime)
+
+        assertEquals(
+            listOf(
+                "$cloudFrontHost/profile/default-profile.png",
+                "$cloudFrontHost/profile/creator-image.png"
+            ),
+            items.map { it.profileImageUrl }
+        )
+    }
+
    @Test
    @DisplayName("라이브 크리에이터별 조회는 소속된 크리에이터만 집계한다")
    fun shouldGetLiveSummaryRowsOnlyForAssignedCreators() {
@@ -683,13 +707,14 @@ class AgentCalculateQueryRepositoryTest @Autowired constructor(
        assertEquals(zeroTotal, repository.getCalculateContentDonationByCreatorTotal(startDate, endDate, agent.id!!))
    }

-    private fun saveMember(nickname: String, role: MemberRole): Member {
+    private fun saveMember(nickname: String, role: MemberRole, profileImage: String? = null): Member {
        return memberRepository.saveAndFlush(
            Member(
                email = "$nickname@test.com",
                password = "password",
                nickname = nickname,
-                role = role
+                role = role,
+                profileImage = profileImage
            )
        )
    }
--- a/src/test/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateServiceTest.kt
+++ b/src/test/kotlin/kr/co/vividnext/sodalive/partner/agent/calculate/AgentCalculateServiceTest.kt
@@ -41,7 +41,8 @@ class AgentCalculateServiceTest {
        val items = listOf(
            GetAgentAssignedCreatorItem(
                creatorId = 21L,
-                creatorNickname = "creator-a"
+                creatorNickname = "creator-a",
+                profileImageUrl = "https://cdn.test/profile/creator-a.png"
            )
        )

@@ -64,6 +65,7 @@ class AgentCalculateServiceTest {

        assertEquals(1, response.totalCount)
        assertEquals(21L, response.items[0].creatorId)
+        assertEquals("https://cdn.test/profile/creator-a.png", response.items[0].profileImageUrl)
        Mockito.verify(repository).getAssignedCreatorTotalCount(
            Mockito.eq(7L),
            Mockito.any(LocalDateTime::class.java) ?: LocalDateTime.now()