feat(#102): 대여 기록 추가/삭제 API 구현

Author: tnals0924

src/main/kotlin/site/billilge/api/backend/domain/rental/controller/AdminRentalController.kt

@@ -3,6 +3,8 @@ package site.billilge.api.backend.domain.rental.controller
 import org.springframework.http.ResponseEntity
 import org.springframework.security.core.annotation.AuthenticationPrincipal
 import org.springframework.web.bind.annotation.*
+import site.billilge.api.backend.domain.rental.dto.request.AdminRentalHistoryRequest
+import site.billilge.api.backend.domain.rental.dto.request.RentalHistoryRequest
 import site.billilge.api.backend.domain.rental.dto.request.RentalStatusUpdateRequest
 import site.billilge.api.backend.domain.rental.dto.response.AdminRentalHistoryFindAllResponse
 import site.billilge.api.backend.domain.rental.dto.response.DashboardResponse
@@ -43,4 +45,18 @@ class AdminRentalController(
         rentalService.updateRentalStatus(userAuthInfo.memberId, rentalHistoryId, request)
         return ResponseEntity.ok().build()
     }
+
+    @PostMapping
+    fun addRentalHistory(
+        @RequestBody request: AdminRentalHistoryRequest
+    ): ResponseEntity<Void> {
+        rentalService.createRentalByAdmin(request)
+        return ResponseEntity.ok().build()
+    }
+
+    @DeleteMapping("/{rentalHistoryId}")
+    fun deleteRentalHistory(@PathVariable rentalHistoryId: Long): ResponseEntity<Void> {
+        rentalService.deleteRentalHistory(rentalHistoryId)
+        return ResponseEntity.ok().build()
+    }
 }

src/main/kotlin/site/billilge/api/backend/domain/rental/dto/request/AdminRentalHistoryRequest.kt

@@ -0,0 +1,27 @@
+package site.billilge.api.backend.domain.rental.dto.request
+
+import io.swagger.v3.oas.annotations.media.Schema
+
+@Schema(description = "관리자 전용 대여기록 추가 DTO")
+data class AdminRentalHistoryRequest(
+    @field:Schema(description = "대여자 ID", example = "1")
+    val memberId: Long,
+
+    @field:Schema(description = "대여할 물품의 ID", example = "1")
+    val itemId: Long,
+
+    @field:Schema(description = "대여할 물품의 수량", example = "1")
+    val count: Int,
+
+    @field:Schema(description = "대여 시작 시간 정보")
+    val rentalTime: RentalTime
+) {
+    @Schema(description = "대여 시작 시간 (시간 및 분)")
+    data class RentalTime(
+        @field:Schema(description = "대여 시작 시각의 시간(24시간 기준)", example = "13")
+        val hour: Int,
+
+        @field:Schema(description = "대여 시작 시각의 분", example = "0")
+        val minute: Int
+    )
+}

src/main/kotlin/site/billilge/api/backend/domain/rental/service/RentalService.kt

@@ -13,6 +13,7 @@ import site.billilge.api.backend.domain.member.exception.MemberErrorCode
 import site.billilge.api.backend.domain.member.repository.MemberRepository
 import site.billilge.api.backend.domain.notification.enums.NotificationStatus
 import site.billilge.api.backend.domain.notification.service.NotificationService
+import site.billilge.api.backend.domain.rental.dto.request.AdminRentalHistoryRequest
 import site.billilge.api.backend.domain.rental.dto.request.RentalHistoryRequest
 import site.billilge.api.backend.domain.rental.dto.request.RentalStatusUpdateRequest
 import site.billilge.api.backend.domain.rental.dto.response.*
@@ -129,16 +130,63 @@ class RentalService(
             true
         )
 
-        notificationService.sendNotificationToAdmin(
-            NotificationStatus.ADMIN_RENTAL_APPLY,
-            listOf(
-                rentUser.name,
-                rentUser.studentId,
-                "${String.format("%02d", rentalHour)}:${String.format("%02d", rentalMinute)}",
-                item.name
-            ),
-            true
+        if (!isDevMode) {
+            notificationService.sendNotificationToAdmin(
+                NotificationStatus.ADMIN_RENTAL_APPLY,
+                listOf(
+                    rentUser.name,
+                    rentUser.studentId,
+                    "${String.format("%02d", rentalHour)}:${String.format("%02d", rentalMinute)}",
+                    item.name
+                ),
+                true
+            )
+        }
+    }
+
+    @Transactional
+    fun createRentalByAdmin(request: AdminRentalHistoryRequest) {
+
+        val item = itemRepository.findById(request.itemId)
+            .orElseThrow { ApiException(RentalErrorCode.ITEM_NOT_FOUND) }
+        val rentedCount = request.count
+
+        if (rentedCount > item.count)
+            throw ApiException(RentalErrorCode.ITEM_OUT_OF_STOCK)
+
+        val rentUser = memberRepository.findById(request.memberId)
+            .orElseThrow { ApiException(RentalErrorCode.MEMBER_NOT_FOUND) }
+
+        if (!rentUser.isFeePaid)
+            throw ApiException(RentalErrorCode.MEMBER_IS_NOT_PAYER)
+
+        val koreanZone = ZoneId.of("Asia/Seoul")
+        val today = LocalDate.now(koreanZone)
+        val requestedRentalDateTime = LocalDateTime.of(
+            today,
+            LocalTime.of(request.rentalTime.hour, request.rentalTime.minute)
         )
+
+        val rentAt = requestedRentalDateTime.atZone(koreanZone).toLocalDateTime()
+
+        val newRental = RentalHistory(
+            member = rentUser,
+            item = item,
+            rentalStatus = if (item.type == ItemType.RENTAL) RentalStatus.RENTAL else RentalStatus.RETURNED,
+            rentedCount = rentedCount,
+            rentAt = rentAt
+        ).apply {
+            if (rentalStatus == RentalStatus.RETURNED) {
+                returnedAt = LocalDateTime.now()
+            }
+        }
+
+        rentalRepository.save(newRental)
+    }
+
+    @Transactional
+    fun deleteRentalHistory(rentalHistoryId: Long) {
+        rentalRepository.deleteById(rentalHistoryId)
     }
 
     fun getMemberRentalHistory(memberId: Long?, rentalStatus: RentalStatus?): RentalHistoryFindAllResponse {

src/main/kotlin/site/billilge/api/backend/global/config/SecurityConfig.kt

@@ -74,7 +74,7 @@ class SecurityConfig (
     fun apiConfigurationSource(): CorsConfigurationSource {
         val configuration = CorsConfiguration()
         configuration.allowedOrigins = allowedOrigins.toList()
-        configuration.allowedMethods = mutableListOf("GET", "POST", "PATCH", "PUT", "DELETE")
+        configuration.allowedMethods = mutableListOf("GET", "POST", "PATCH", "PUT", "DELETE", "OPTIONS", "HEAD")
         configuration.allowedHeaders = mutableListOf("Content-Type", "Authorization")
 
         val source = UrlBasedCorsConfigurationSource()