Book 480 feature/#145

apis/src/main/kotlin/org/yapp/apis/emotion/controller/EmotionController.kt

@@ -0,0 +1,21 @@
+package org.yapp.apis.emotion.controller
+
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+import org.yapp.apis.emotion.dto.response.EmotionListResponse
+import org.yapp.apis.emotion.service.EmotionService
+
+@RestController
+@RequestMapping("/api/v2/emotions")
+class EmotionController(
+    private val emotionService: EmotionService
+) : EmotionControllerApi {
+
+    @GetMapping
+    override fun getEmotions(): ResponseEntity<EmotionListResponse> {
+        val response = emotionService.getEmotionList()
+        return ResponseEntity.ok(response)
+    }
+}

apis/src/main/kotlin/org/yapp/apis/emotion/controller/EmotionControllerApi.kt

@@ -0,0 +1,33 @@
+package org.yapp.apis.emotion.controller
+
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.media.Content
+import io.swagger.v3.oas.annotations.media.Schema
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.responses.ApiResponses
+import io.swagger.v3.oas.annotations.tags.Tag
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.RequestMapping
+import org.yapp.apis.emotion.dto.response.EmotionListResponse
+
+@Tag(name = "Emotions", description = "감정 관련 API")
+@RequestMapping("/api/v2/emotions")
+interface EmotionControllerApi {
+
+    @Operation(
+        summary = "감정 목록 조회",
+        description = "대분류 감정과 세부 감정 목록을 조회합니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "감정 목록 조회 성공",
+                content = [Content(schema = Schema(implementation = EmotionListResponse::class))]
+            )
+        ]
+    )
+    @GetMapping
+    fun getEmotions(): ResponseEntity<EmotionListResponse>
+}

apis/src/main/kotlin/org/yapp/apis/emotion/dto/response/EmotionListResponse.kt

@@ -0,0 +1,52 @@
+package org.yapp.apis.emotion.dto.response
+
+import io.swagger.v3.oas.annotations.media.Schema
+import org.yapp.domain.detailtag.DetailTag
+import org.yapp.domain.readingrecord.PrimaryEmotion
+import java.util.UUID
+
+@Schema(name = "EmotionListResponse", description = "감정 목록 응답")
+data class EmotionListResponse(
+    @field:Schema(description = "감정 그룹 목록")
+    val emotions: List<EmotionGroupDto>
+) {
+    companion object {
+        fun from(detailTags: List<DetailTag>): EmotionListResponse {
+            val grouped = detailTags.groupBy { it.primaryEmotion }
+
+            val emotions = PrimaryEmotion.entries.map { primary ->
+                EmotionGroupDto(
+                    code = primary.name,
+                    displayName = primary.displayName,
+                    detailEmotions = grouped[primary]
+                        ?.sortedBy { it.displayOrder }
+                        ?.map { EmotionDetailDto(id = it.id.value, name = it.name) }
+                        ?: emptyList()
+                )
+            }
+
+            return EmotionListResponse(emotions = emotions)
+        }
+    }
+}
+
+@Schema(name = "EmotionGroupDto", description = "감정 그룹 (대분류 + 세부감정)")
+data class EmotionGroupDto(
+    @field:Schema(description = "대분류 코드", example = "JOY")
+    val code: String,
+
+    @field:Schema(description = "대분류 표시 이름", example = "즐거움")
+    val displayName: String,
+
+    @field:Schema(description = "세부 감정 목록")
+    val detailEmotions: List<EmotionDetailDto>
+)
+
+@Schema(name = "EmotionDetailDto", description = "세부 감정")
+data class EmotionDetailDto(
+    @field:Schema(description = "세부 감정 ID", example = "123e4567-e89b-12d3-a456-426614174000")
+    val id: UUID,
+
+    @field:Schema(description = "세부 감정 이름", example = "설레는")
+    val name: String
+)

apis/src/main/kotlin/org/yapp/apis/emotion/service/EmotionService.kt

@@ -0,0 +1,16 @@
+package org.yapp.apis.emotion.service
+
+import org.yapp.apis.emotion.dto.response.EmotionListResponse
+import org.yapp.domain.detailtag.DetailTagDomainService
+import org.yapp.globalutils.annotation.ApplicationService
+
+@ApplicationService
+class EmotionService(
+    private val detailTagDomainService: DetailTagDomainService
+) {
+    fun getEmotionList(): EmotionListResponse {
+        val detailTags = detailTagDomainService.findAll()
+        return EmotionListResponse.from(detailTags)
+    }
+}
+

apis/src/main/kotlin/org/yapp/apis/readingrecord/controller/ReadingRecordControllerApiV2.kt

@@ -0,0 +1,153 @@
+package org.yapp.apis.readingrecord.controller
+
+import io.swagger.v3.oas.annotations.Operation
+import io.swagger.v3.oas.annotations.Parameter
+import io.swagger.v3.oas.annotations.media.Content
+import io.swagger.v3.oas.annotations.media.Schema
+import io.swagger.v3.oas.annotations.responses.ApiResponse
+import io.swagger.v3.oas.annotations.responses.ApiResponses
+import io.swagger.v3.oas.annotations.tags.Tag
+import jakarta.validation.Valid
+import org.springframework.data.domain.Page
+import org.springframework.data.domain.Pageable
+import org.springframework.data.domain.Sort
+import org.springframework.data.web.PageableDefault
+import org.springframework.http.ResponseEntity
+import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.web.bind.annotation.*
+import org.yapp.apis.readingrecord.dto.request.CreateReadingRecordRequestV2
+import org.yapp.apis.readingrecord.dto.request.UpdateReadingRecordRequestV2
+import org.yapp.apis.readingrecord.dto.response.ReadingRecordResponseV2
+import org.yapp.domain.readingrecord.ReadingRecordSortType
+import org.yapp.globalutils.exception.ErrorResponse
+import java.util.*
+
+@Tag(name = "Reading Records V2", description = "독서 기록 관련 API (V2)")
+@RequestMapping("/api/v2/reading-records")
+interface ReadingRecordControllerApiV2 {
+
+    @Operation(
+        summary = "독서 기록 생성 (V2)",
+        description = "사용자의 책에 대한 독서 기록을 생성합니다. 대분류 감정은 필수, 세부 감정은 선택입니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "201",
+                description = "독서 기록 생성 성공",
+                content = [Content(schema = Schema(implementation = ReadingRecordResponseV2::class))]
+            ),
+            ApiResponse(
+                responseCode = "400",
+                description = "잘못된 요청",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            ),
+            ApiResponse(
+                responseCode = "404",
+                description = "사용자 또는 책을 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @PostMapping("/{userBookId}")
+    fun createReadingRecord(
+        @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
+        @PathVariable @Parameter(description = "독서 기록을 생성할 사용자 책 ID") userBookId: UUID,
+        @Valid @RequestBody @Parameter(description = "독서 기록 생성 요청 객체") request: CreateReadingRecordRequestV2
+    ): ResponseEntity<ReadingRecordResponseV2>
+
+    @Operation(
+        summary = "독서 기록 상세 조회 (V2)",
+        description = "독서 기록 ID로 독서 기록 상세 정보를 조회합니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "독서 기록 상세 조회 성공",
+                content = [Content(schema = Schema(implementation = ReadingRecordResponseV2::class))]
+            ),
+            ApiResponse(
+                responseCode = "404",
+                description = "사용자 또는 독서 기록을 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @GetMapping("/detail/{readingRecordId}")
+    fun getReadingRecordDetail(
+        @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
+        @PathVariable @Parameter(description = "조회할 독서 기록 ID") readingRecordId: UUID
+    ): ResponseEntity<ReadingRecordResponseV2>
+
+    @Operation(
+        summary = "독서 기록 목록 조회 (V2)",
+        description = "사용자의 책에 대한 독서 기록을 페이징하여 조회합니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "독서 기록 목록 조회 성공"
+            ),
+            ApiResponse(
+                responseCode = "404",
+                description = "사용자 또는 책을 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @GetMapping("/{userBookId}")
+    fun getReadingRecords(
+        @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
+        @PathVariable @Parameter(description = "독서 기록을 조회할 사용자 책 ID") userBookId: UUID,
+        @RequestParam(required = false) @Parameter(description = "정렬 타입") sort: ReadingRecordSortType?,
+        @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
+        @Parameter(description = "페이징 정보") pageable: Pageable
+    ): ResponseEntity<Page<ReadingRecordResponseV2>>
+
+    @Operation(
+        summary = "독서 기록 수정 (V2)",
+        description = "독서 기록을 수정합니다. 대분류 감정과 세부 감정을 변경할 수 있습니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "독서 기록 수정 성공",
+                content = [Content(schema = Schema(implementation = ReadingRecordResponseV2::class))]
+            ),
+            ApiResponse(
+                responseCode = "404",
+                description = "독서 기록을 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @PutMapping("/{readingRecordId}")
+    fun updateReadingRecord(
+        @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
+        @PathVariable @Parameter(description = "수정할 독서 기록 ID") readingRecordId: UUID,
+        @Valid @RequestBody @Parameter(description = "독서 기록 수정 요청 객체") request: UpdateReadingRecordRequestV2
+    ): ResponseEntity<ReadingRecordResponseV2>
+
+    @Operation(
+        summary = "독서 기록 삭제",
+        description = "독서 기록을 삭제합니다."
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(responseCode = "204", description = "독서 기록 삭제 성공"),
+            ApiResponse(
+                responseCode = "404",
+                description = "독서 기록을 찾을 수 없음",
+                content = [Content(schema = Schema(implementation = ErrorResponse::class))]
+            )
+        ]
+    )
+    @DeleteMapping("/{readingRecordId}")
+    fun deleteReadingRecord(
+        @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
+        @PathVariable @Parameter(description = "삭제할 독서 기록 ID") readingRecordId: UUID
+    ): ResponseEntity<Void>
+}

apis/src/main/kotlin/org/yapp/apis/readingrecord/controller/ReadingRecordControllerV2.kt

@@ -0,0 +1,90 @@
+package org.yapp.apis.readingrecord.controller
+
+import jakarta.validation.Valid
+import org.springframework.data.domain.Page
+import org.springframework.data.domain.Pageable
+import org.springframework.data.domain.Sort
+import org.springframework.data.web.PageableDefault
+import org.springframework.http.HttpStatus
+import org.springframework.http.ResponseEntity
+import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.web.bind.annotation.*
+import org.yapp.apis.readingrecord.dto.request.CreateReadingRecordRequestV2
+import org.yapp.apis.readingrecord.dto.request.UpdateReadingRecordRequestV2
+import org.yapp.apis.readingrecord.dto.response.ReadingRecordResponseV2
+import org.yapp.apis.readingrecord.usecase.ReadingRecordUseCaseV2
+import org.yapp.domain.readingrecord.ReadingRecordSortType
+import java.util.UUID
+
+@RestController
+@RequestMapping("/api/v2/reading-records")
+class ReadingRecordControllerV2(
+    private val readingRecordUseCaseV2: ReadingRecordUseCaseV2
+) : ReadingRecordControllerApiV2 {
+
+    @PostMapping("/{userBookId}")
+    override fun createReadingRecord(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable userBookId: UUID,
+        @Valid @RequestBody request: CreateReadingRecordRequestV2
+    ): ResponseEntity<ReadingRecordResponseV2> {
+        val response = readingRecordUseCaseV2.createReadingRecord(
+            userId = userId,
+            userBookId = userBookId,
+            request = request
+        )
+        return ResponseEntity.status(HttpStatus.CREATED).body(response)
+    }
+
+    @GetMapping("/detail/{readingRecordId}")
+    override fun getReadingRecordDetail(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable readingRecordId: UUID
+    ): ResponseEntity<ReadingRecordResponseV2> {
+        val response = readingRecordUseCaseV2.getReadingRecordDetail(
+            userId = userId,
+            readingRecordId = readingRecordId
+        )
+        return ResponseEntity.ok(response)
+    }
+
+    @GetMapping("/{userBookId}")
+    override fun getReadingRecords(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable userBookId: UUID,
+        @RequestParam(required = false) sort: ReadingRecordSortType?,
+        @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
+        pageable: Pageable
+    ): ResponseEntity<Page<ReadingRecordResponseV2>> {
+        val response = readingRecordUseCaseV2.getReadingRecordsByUserBookId(
+            userId = userId,
+            userBookId = userBookId,
+            sort = sort,
+            pageable = pageable
+        )
+        return ResponseEntity.ok(response)
+    }
+
+    @PutMapping("/{readingRecordId}")
+    override fun updateReadingRecord(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable readingRecordId: UUID,
+        @Valid @RequestBody request: UpdateReadingRecordRequestV2
+    ): ResponseEntity<ReadingRecordResponseV2> {
+        val response = readingRecordUseCaseV2.updateReadingRecord(
+            userId = userId,
+            readingRecordId = readingRecordId,
+            request = request
+        )
+        return ResponseEntity.ok(response)
+    }
+
+    @DeleteMapping("/{readingRecordId}")
+    override fun deleteReadingRecord(
+        @AuthenticationPrincipal userId: UUID,
+        @PathVariable readingRecordId: UUID
+    ): ResponseEntity<Void> {
+        readingRecordUseCaseV2.deleteReadingRecord(userId, readingRecordId)
+        return ResponseEntity.noContent().build()
+    }
+}

apis/src/main/kotlin/org/yapp/apis/readingrecord/dto/request/CreateReadingRecordRequest.kt

@@ -43,6 +43,4 @@ data class CreateReadingRecordRequest private constructor(
 
     fun validQuote(): String =
         requireNotNull(quote) { "quote는 null일 수 없습니다." }
-
-    fun validEmotionTags(): List<String> = emotionTags
 }