refactor: PoseService 책임 분리 + 관리자 업로드용 userId nullable화

- PoseService를 포즈 자체의 목록 조회/등록으로 좁히고, 스크랩은 PoseScrapService,
  조회수는 PoseViewService, 무작위 추첨은 RandomPoseService로 분리
- PoseRepository/PoseQuery에 관리자 전체 목록 조회(GetAllPoses) 추가
- HeadCount에 ALL 추가 (관리자 목록에서 인원수로 거르지 않는 경우)
- PoseCommand.UploadPoses.userId를 Long?로 변경 — 인증이 없는 관리자 업로드는
  User 귀속 없이 null로 넘긴다. apps/api 쪽은 UploadPosesUseCase에서
  requireNotNull로 여전히 인증된 사용자만 허용하도록 유지
- 분리된 서비스를 쓰도록 Pose 관련 UseCase 6개 갱신

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: koosco

apps/api/src/main/kotlin/com/neki/api/pose/application/GetPoseUseCase.kt

@@ -6,20 +6,22 @@ import com.neki.core.transaction.TransactionRunner
 import com.neki.domain.pose.client.MediaClient
 import com.neki.domain.pose.dto.PoseQuery
 import com.neki.domain.pose.models.MediaMetadata
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
+import com.neki.domain.pose.service.PoseViewService
 
 @UseCase
 class GetPoseUseCase(
-    private val poseService: PoseService,
+    private val poseScrapService: PoseScrapService,
+    private val poseViewService: PoseViewService,
     private val mediaClient: MediaClient,
     private val transactionRunner: TransactionRunner,
 ) {
 
     fun execute(query: PoseQuery.GetPose): PoseResult.GetPose {
-        val (pose, isScraped) = poseService.getOwnedPoseWithScrap(query)
+        val (pose, isScraped) = poseScrapService.getOwnedPoseWithScrap(query)
 
-        if (poseService.isFirstViewOf(query)) {
-            transactionRunner.run { poseService.incrementViewCount(query) }
+        if (poseViewService.isFirstViewOf(query)) {
+            transactionRunner.run { poseViewService.incrementViewCount(query) }
         }
 
         val mediaInfo: MediaMetadata = mediaClient.getMediaMetadata(pose.mediaId)

apps/api/src/main/kotlin/com/neki/api/pose/application/GetPosesUseCase.kt

@@ -9,7 +9,7 @@ import com.neki.domain.pose.client.MediaClient
 import com.neki.domain.pose.dto.PoseQuery
 import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.PoseWithScrap
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
 
 /**
  * fileName       : GetPosesUseCase
@@ -19,14 +19,14 @@ import com.neki.domain.pose.service.PoseService
  */
 @UseCase
 class GetPosesUseCase(
-    private val poseService: PoseService,
+    private val poseScrapService: PoseScrapService,
     private val mediaClient: MediaClient,
     private val transactionRunner: TransactionRunner,
 ) {
 
     fun execute(query: PoseQuery.GetPoses): PoseResult.GetPoses {
         val page: Page<PoseWithScrap> = transactionRunner.readOnly {
-            poseService.listPosesWithScrap(query)
+            poseScrapService.listPosesWithScrap(query)
         }
 
         if (page.items.isEmpty()) {

apps/api/src/main/kotlin/com/neki/api/pose/application/GetScrapPosesUseCase.kt

@@ -9,7 +9,7 @@ import com.neki.domain.pose.client.MediaClient
 import com.neki.domain.pose.dto.PoseQuery
 import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.Pose
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
 
 /**
  * fileName       : GetScrapPosesUseCase
@@ -19,14 +19,14 @@ import com.neki.domain.pose.service.PoseService
  */
 @UseCase
 class GetScrapPosesUseCase(
-    private val poseService: PoseService,
+    private val poseScrapService: PoseScrapService,
     private val mediaClient: MediaClient,
     private val transactionRunner: TransactionRunner,
 ) {
 
     fun execute(query: PoseQuery.GetScrapPoses): PoseResult.GetPoses {
         val page: Page<Pose> = transactionRunner.readOnly {
-            poseService.listOwnedScrapPoses(query)
+            poseScrapService.listOwnedScrapPoses(query)
         }
 
         if (page.items.isEmpty()) {

apps/api/src/main/kotlin/com/neki/api/pose/application/RandomPoseUseCase.kt

@@ -6,15 +6,20 @@ import com.neki.domain.pose.client.MediaClient
 import com.neki.domain.pose.dto.PoseQuery
 import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.Pose
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
+import com.neki.domain.pose.service.RandomPoseService
 
 @UseCase
-class RandomPoseUseCase(private val poseService: PoseService, private val mediaClient: MediaClient) {
+class RandomPoseUseCase(
+    private val randomPoseService: RandomPoseService,
+    private val poseScrapService: PoseScrapService,
+    private val mediaClient: MediaClient,
+) {
 
     fun execute(query: PoseQuery.GetRandomPose): PoseResult.GetPose {
-        val pose: Pose = poseService.pickRandomPose(query)
+        val pose: Pose = randomPoseService.pickRandomPose(query)
 
-        val isScraped: Boolean = poseService.isScraped(query, pose)
+        val isScraped: Boolean = poseScrapService.isScraped(query, pose)
 
         val mediaInfo: MediaMetadata = mediaClient.getMediaMetadata(pose.mediaId)
 

apps/api/src/main/kotlin/com/neki/api/pose/application/UpdatePoseScrapUseCase.kt

@@ -2,12 +2,12 @@ package com.neki.api.pose.application
 
 import com.neki.core.annotation.UseCase
 import com.neki.domain.pose.dto.PoseCommand
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
 import org.springframework.transaction.annotation.Transactional
 
 @UseCase
-class UpdatePoseScrapUseCase(private val poseService: PoseService) {
+class UpdatePoseScrapUseCase(private val poseScrapService: PoseScrapService) {
 
     @Transactional
-    fun execute(command: PoseCommand.UpdatePoseScrap) = poseService.updateScrap(command)
+    fun execute(command: PoseCommand.UpdatePoseScrap) = poseScrapService.updateScrap(command)
 }

apps/api/src/main/kotlin/com/neki/api/pose/application/UploadPosesUseCase.kt

@@ -24,15 +24,18 @@ class UploadPosesUseCase(
 ) {
 
     fun execute(command: PoseCommand.UploadPoses) {
+        // apps:api 업로드는 인증된 사용자만 호출한다. userId가 없는 업로드는 apps:admin 전용이다.
+        val userId: Long = requireNotNull(command.userId)
+
         val poses: List<Pose> = poseService.createPoses(command)
 
         val mediaIds: List<Long> = command.uploads.map { it.mediaId }
-        verifyUploadedOrRollback(command.userId, mediaIds)
+        verifyUploadedOrRollback(userId, mediaIds)
 
         try {
             transactionRunner.run { poseService.saveAll(poses) }
         } catch (e: Exception) {
-            mediaClient.rollbackMediasUploaded(command.userId, mediaIds)
+            mediaClient.rollbackMediasUploaded(userId, mediaIds)
             throw e
         }
     }

apps/api/src/test/kotlin/com/neki/api/pose/application/usecase/GetPoseUseCaseTest.kt

@@ -11,7 +11,8 @@ import com.neki.domain.pose.external.PoseViewCache
 import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.PoseWithScrap
 import com.neki.domain.pose.repository.PoseRepository
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
+import com.neki.domain.pose.service.PoseViewService
 import io.kotest.assertions.throwables.shouldThrow
 import io.kotest.matchers.shouldBe
 import io.mockk.every
@@ -37,7 +38,8 @@ class GetPoseUseCaseTest {
         poseViewCache = mockk()
         transactionRunner = FakeTransactionRunner()
         useCase = GetPoseUseCase(
-            PoseService(poseRepository, mockk(), poseViewCache, mockk()),
+            PoseScrapService(poseRepository, mockk()),
+            PoseViewService(poseRepository, poseViewCache),
             mediaClient,
             transactionRunner,
         )

apps/api/src/test/kotlin/com/neki/api/pose/application/usecase/GetPosesUseCaseTest.kt

@@ -10,7 +10,7 @@ import com.neki.domain.pose.dto.PoseQuery
 import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.PoseWithScrap
 import com.neki.domain.pose.repository.PoseRepository
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
 import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
@@ -32,7 +32,7 @@ class GetPosesUseCaseTest {
         mediaClient = mockk()
         transactionRunner = FakeTransactionRunner()
         useCase = GetPosesUseCase(
-            PoseService(poseRepository, mockk(), mockk(), mockk()),
+            PoseScrapService(poseRepository, mockk()),
             mediaClient,
             transactionRunner,
         )

apps/api/src/test/kotlin/com/neki/api/pose/application/usecase/GetScrapPosesUseCaseTest.kt

@@ -10,7 +10,7 @@ import com.neki.domain.pose.dto.PoseQuery
 import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.Pose
 import com.neki.domain.pose.repository.PoseRepository
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
 import io.kotest.matchers.shouldBe
 import io.mockk.every
 import io.mockk.mockk
@@ -32,7 +32,7 @@ class GetScrapPosesUseCaseTest {
         mediaClient = mockk()
         transactionRunner = FakeTransactionRunner()
         useCase = GetScrapPosesUseCase(
-            PoseService(poseRepository, mockk(), mockk(), mockk()),
+            PoseScrapService(poseRepository, mockk()),
             mediaClient,
             transactionRunner,
         )

apps/api/src/test/kotlin/com/neki/api/pose/application/usecase/RandomPoseUseCaseTest.kt

@@ -12,7 +12,8 @@ import com.neki.domain.pose.models.MediaMetadata
 import com.neki.domain.pose.models.ScrapPoseId
 import com.neki.domain.pose.repository.PoseRepository
 import com.neki.domain.pose.repository.ScrapPoseRepository
-import com.neki.domain.pose.service.PoseService
+import com.neki.domain.pose.service.PoseScrapService
+import com.neki.domain.pose.service.RandomPoseService
 import io.kotest.assertions.throwables.shouldThrow
 import io.kotest.matchers.shouldBe
 import io.mockk.every
@@ -38,7 +39,8 @@ class RandomPoseUseCaseTest {
         randomGenerator = mockk()
         useCase =
             RandomPoseUseCase(
-                PoseService(poseRepository, scrapPoseRepository, mockk(), randomGenerator),
+                RandomPoseService(poseRepository, randomGenerator),
+                PoseScrapService(poseRepository, scrapPoseRepository),
                 mediaClient,
             )
     }