Merge branch 'main' of https://github.com/prgrms-web-devcourse-final-project/WEB6_8_CGNS_BE into feat/be/76

Author: Mrbaeksang

docs/api-specification.yaml

@@ -14,6 +14,7 @@ import org.springframework.web.bind.annotation.ExceptionHandler
  * @Valid 검증 실패 → 400
  * throw IllegalArgumentException("메시지") → 400
  * throw NoSuchElementException("메시지") → 404
+ * throw IllegalStateException("메시지") → 409
  * 기타 모든 예외 → 500
  */
 @ControllerAdvice
@@ -41,6 +42,12 @@ class GlobalExceptionHandler {
         return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ApiResponse(ex.message ?: "데이터를 찾을 수 없습니다"))
     }
 
+    @ExceptionHandler(IllegalStateException::class)
+    fun handleIllegalState(ex: IllegalStateException): ResponseEntity<ApiResponse<Void>> {
+        logger.warn("부적절한 상태: {}", ex.message)
+        return ResponseEntity.status(HttpStatus.CONFLICT).body(ApiResponse(ex.message ?: "요청을 처리할 수 없는 상태입니다"))
+    }
+
     @ExceptionHandler(Exception::class)
     fun handleGenericException(
         ex: Exception,

src/main/kotlin/com/back/koreaTravelGuide/common/exception/GlobalExceptionHandler.kt

@@ -0,0 +1,10 @@
+package com.back.koreaTravelGuide.common.security
+
+import org.springframework.security.core.Authentication
+
+fun Authentication.getUserId(): Long {
+    if (principal is Long) {
+        return principal as Long
+    }
+    throw IllegalStateException("인증된 사용자 ID를 찾을 수 없거나 타입이 올바르지 않습니다.")
+}

src/main/kotlin/com/back/koreaTravelGuide/common/security/AuthenticationExtensions.kt

@@ -1,6 +1,7 @@
 package com.back.koreaTravelGuide.domain.auth.controller
 
 import com.back.koreaTravelGuide.common.ApiResponse
+import com.back.koreaTravelGuide.common.security.getUserId
 import com.back.koreaTravelGuide.domain.auth.dto.request.UserRoleUpdateRequest
 import com.back.koreaTravelGuide.domain.auth.dto.response.AccessTokenResponse
 import com.back.koreaTravelGuide.domain.auth.dto.response.LoginResponse
@@ -10,7 +11,7 @@ import jakarta.servlet.http.HttpServletRequest
 import jakarta.servlet.http.HttpServletResponse
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.http.ResponseEntity
-import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.security.core.Authentication
 import org.springframework.web.bind.annotation.CookieValue
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
@@ -45,9 +46,10 @@ class AuthController(
     @Operation(summary = "신규 사용자 역할 선택")
     @PostMapping("/role")
     fun updateUserRole(
-        @AuthenticationPrincipal userId: Long,
+        authentication: Authentication,
         @RequestBody request: UserRoleUpdateRequest,
     ): ResponseEntity<ApiResponse<LoginResponse>> {
+        val userId = authentication.getUserId()
         val loginResponse = authService.updateRoleAndLogin(userId, request.role)
         return ResponseEntity.ok(ApiResponse("역할이 선택되었으며 로그인에 성공했습니다.", loginResponse))
     }

src/main/kotlin/com/back/koreaTravelGuide/domain/auth/controller/AuthController.kt

@@ -0,0 +1,67 @@
+package com.back.koreaTravelGuide.domain.rate.controller
+
+import com.back.koreaTravelGuide.common.ApiResponse
+import com.back.koreaTravelGuide.common.security.getUserId
+import com.back.koreaTravelGuide.domain.rate.dto.GuideRatingSummaryResponse
+import com.back.koreaTravelGuide.domain.rate.dto.RateRequest
+import com.back.koreaTravelGuide.domain.rate.dto.RateResponse
+import com.back.koreaTravelGuide.domain.rate.service.RateService
+import io.swagger.v3.oas.annotations.Operation
+import org.springframework.data.domain.Page
+import org.springframework.data.domain.Pageable
+import org.springframework.http.ResponseEntity
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.security.core.Authentication
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PathVariable
+import org.springframework.web.bind.annotation.PutMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+@RequestMapping("/api/rate")
+class RateController(
+    private val rateService: RateService,
+) {
+    @Operation(summary = "가이드 평가 생성/수정")
+    @PutMapping("/guides/{guideId}")
+    fun rateGuide(
+        authentication: Authentication,
+        @PathVariable guideId: Long,
+        @RequestBody request: RateRequest,
+    ): ResponseEntity<ApiResponse<RateResponse>> {
+        val raterUserId = authentication.getUserId()
+        val rate = rateService.rateGuide(raterUserId, guideId, request.rating, request.comment)
+        return ResponseEntity.ok(ApiResponse("가이드 평가가 등록되었습니다.", RateResponse.from(rate)))
+    }
+
+    @Operation(summary = "AI 채팅 세션 평가 생성/수정")
+    @PutMapping("/aichat/sessions/{sessionId}")
+    fun rateAiSession(
+        authentication: Authentication,
+        @PathVariable sessionId: Long,
+        @RequestBody request: RateRequest,
+    ): ResponseEntity<ApiResponse<RateResponse>> {
+        val raterUserId = authentication.getUserId()
+        val rate = rateService.rateAiSession(raterUserId, sessionId, request.rating, request.comment)
+        return ResponseEntity.ok(ApiResponse("AI 채팅 평가가 등록되었습니다.", RateResponse.from(rate)))
+    }
+
+    @Operation(summary = "내가 받은 가이드 평가 조회")
+    @GetMapping("/guides/my")
+    @PreAuthorize("hasRole('GUIDE')")
+    fun getMyGuideRatings(authentication: Authentication): ResponseEntity<ApiResponse<GuideRatingSummaryResponse>> {
+        val guideId = authentication.getUserId()
+        val summary = rateService.getMyGuideRatingSummary(guideId)
+        return ResponseEntity.ok(ApiResponse("내 가이드 평점 정보를 조회했습니다.", summary))
+    }
+
+    @Operation(summary = "관리자의 모든 AI 채팅 평가 조회")
+    @GetMapping("/admin/aichat/sessions")
+    @PreAuthorize("hasRole('ADMIN')")
+    fun getAllAiSessionRatings(pageable: Pageable): ResponseEntity<ApiResponse<Page<RateResponse>>> {
+        val ratingsPage = rateService.getAllAiSessionRatingsForAdmin(pageable)
+        return ResponseEntity.ok(ApiResponse("모든 AI 채팅 평가 목록을 조회했습니다.", ratingsPage))
+    }
+}

src/main/kotlin/com/back/koreaTravelGuide/domain/rate/controller/RateController.kt

@@ -0,0 +1,7 @@
+package com.back.koreaTravelGuide.domain.rate.dto
+
+data class GuideRatingSummaryResponse(
+    val averageRating: Double,
+    val totalRatings: Int,
+    val ratings: List<RateResponse>,
+)

src/main/kotlin/com/back/koreaTravelGuide/domain/rate/dto/GuideRatingSummaryResponse.kt

@@ -0,0 +1,11 @@
+package com.back.koreaTravelGuide.domain.rate.dto
+
+import jakarta.validation.constraints.Max
+import jakarta.validation.constraints.Min
+
+data class RateRequest(
+    @field:Min(1, message = "평점은 1 이상이어야 합니다.")
+    @field:Max(5, message = "평점은 5 이하여야 합니다.")
+    val rating: Int,
+    val comment: String?,
+)

src/main/kotlin/com/back/koreaTravelGuide/domain/rate/dto/RateRequest.kt

@@ -0,0 +1,24 @@
+package com.back.koreaTravelGuide.domain.rate.dto
+
+import com.back.koreaTravelGuide.domain.rate.entity.Rate
+import java.time.ZonedDateTime
+
+data class RateResponse(
+    val id: Long,
+    val raterNickname: String,
+    val rating: Int,
+    val comment: String?,
+    val createdAt: ZonedDateTime,
+) {
+    companion object {
+        fun from(rate: Rate): RateResponse {
+            return RateResponse(
+                id = rate.id!!,
+                raterNickname = rate.user.nickname,
+                rating = rate.rating,
+                comment = rate.comment,
+                createdAt = rate.createdAt,
+            )
+        }
+    }
+}

src/main/kotlin/com/back/koreaTravelGuide/domain/rate/dto/RateResponse.kt

@@ -0,0 +1,60 @@
+package com.back.koreaTravelGuide.domain.rate.entity
+
+import com.back.koreaTravelGuide.domain.user.entity.User
+import jakarta.persistence.Column
+import jakarta.persistence.Entity
+import jakarta.persistence.EnumType
+import jakarta.persistence.Enumerated
+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 jakarta.validation.constraints.Max
+import jakarta.validation.constraints.Min
+import java.time.ZoneId
+import java.time.ZonedDateTime
+
+@Entity
+@Table(name = "rates")
+class Rate(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    val id: Long? = null,
+    @ManyToOne
+    @JoinColumn(name = "user_id", nullable = false)
+    val user: User,
+    @Enumerated(EnumType.STRING)
+    @Column(nullable = false)
+    val targetType: RateTargetType,
+    @Column(nullable = false)
+    val targetId: Long,
+    @Min(1)
+    @Max(5)
+    @Column(nullable = false)
+    var rating: Int,
+    @Column(columnDefinition = "Text")
+    var comment: String?,
+    @Column(nullable = false, updatable = false)
+    val createdAt: ZonedDateTime = ZonedDateTime.now(ZoneId.of("Asia/Seoul")),
+    @Column(nullable = false)
+    var updatedAt: ZonedDateTime = ZonedDateTime.now(ZoneId.of("Asia/Seoul")),
+) {
+    fun update(
+        rating: Int,
+        comment: String?,
+    ) {
+        this.rating = rating
+        this.comment = comment
+        this.updatedAt = ZonedDateTime.now(ZoneId.of("Asia/Seoul"))
+    }
+}
+
+// /bigint id PK "Auto Increment"
+// bigint user_id FK "평가자 ID (GUEST만)"
+// enum target_type "AI_CHAT_SESSION, GUIDE"
+// bigint target_id "평가 대상 ID (세션 ID 또는 가이드 ID)"
+// int rating "평점 1-5"
+// text comment "평가 코멘트 (선택사항)"
+// datetime created_at "평가 일시"

src/main/kotlin/com/back/koreaTravelGuide/domain/rate/entity/Rate.kt

@@ -0,0 +1,6 @@
+package com.back.koreaTravelGuide.domain.rate.entity
+
+enum class RateTargetType {
+    AI_SESSION,
+    GUIDE,
+}