feat: 디스플레이용 조회 API 구현

Author: tnals0924

src/main/kotlin/site/billilge/api/backend/domain/display/controller/DisplayApi.kt

@@ -0,0 +1,26 @@
+package site.billilge.api.backend.domain.display.controller
+
+import io.swagger.v3.oas.annotations.Operation
+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 site.billilge.api.backend.domain.display.dto.response.DisplayResponse
+
+@Tag(name = "Display", description = "디스플레이 조회 API")
+interface DisplayApi {
+
+    @Operation(
+        summary = "디스플레이 데이터 조회",
+        description = "활성 포스터, 일정 캘린더(±3일), 복지물품 현황을 조회하는 API"
+    )
+    @ApiResponses(
+        value = [
+            ApiResponse(
+                responseCode = "200",
+                description = "디스플레이 데이터 조회 성공"
+            )
+        ]
+    )
+    fun getDisplay(): ResponseEntity<DisplayResponse>
+}

src/main/kotlin/site/billilge/api/backend/domain/display/controller/DisplayController.kt

@@ -0,0 +1,20 @@
+package site.billilge.api.backend.domain.display.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 site.billilge.api.backend.domain.display.dto.response.DisplayResponse
+import site.billilge.api.backend.domain.display.facade.DisplayFacade
+
+@RestController
+@RequestMapping("/display")
+class DisplayController(
+    private val displayFacade: DisplayFacade,
+) : DisplayApi {
+
+    @GetMapping
+    override fun getDisplay(): ResponseEntity<DisplayResponse> {
+        return ResponseEntity.ok(displayFacade.getDisplay())
+    }
+}

src/main/kotlin/site/billilge/api/backend/domain/display/dto/response/DisplayResponse.kt

@@ -0,0 +1,19 @@
+package site.billilge.api.backend.domain.display.dto.response
+
+data class DisplayResponse(
+    val posters: List<PosterDetail>,
+    val schedules: List<Map<String, List<String>>>,
+    val items: List<DisplayItemDetail>,
+) {
+    data class PosterDetail(
+        val posterId: Long,
+        val title: String,
+        val imageUrl: String,
+    )
+
+    data class DisplayItemDetail(
+        val itemName: String,
+        val count: Int,
+        val imageUrl: String,
+    )
+}

src/main/kotlin/site/billilge/api/backend/domain/display/facade/DisplayFacade.kt

@@ -0,0 +1,53 @@
+package site.billilge.api.backend.domain.display.facade
+
+import org.springframework.stereotype.Component
+import site.billilge.api.backend.domain.display.dto.response.DisplayResponse
+import site.billilge.api.backend.domain.display.service.DisplayCalendarScheduleService
+import site.billilge.api.backend.domain.display.service.DisplayPosterService
+import site.billilge.api.backend.domain.item.service.ItemService
+import java.time.LocalDate
+
+@Component
+class DisplayFacade(
+    private val displayPosterService: DisplayPosterService,
+    private val displayCalendarScheduleService: DisplayCalendarScheduleService,
+    private val itemService: ItemService,
+) {
+    fun getDisplay(): DisplayResponse {
+        val posters = displayPosterService.getActivePosters()
+            .map { poster ->
+                DisplayResponse.PosterDetail(
+                    posterId = poster.id!!,
+                    title = poster.title,
+                    imageUrl = poster.imageUrl,
+                )
+            }
+
+        val today = LocalDate.now()
+        val startDate = today.minusDays(3)
+        val endDate = today.plusDays(3)
+
+        val scheduleEntities = displayCalendarScheduleService.getSchedules(startDate, endDate)
+        val scheduleMap = scheduleEntities.associate { it.date to it.scheduleList }
+
+        val schedules = (0L..6L).map { offset ->
+            val date = startDate.plusDays(offset)
+            mapOf(date.toString() to (scheduleMap[date] ?: emptyList()))
+        }
+
+        val items = itemService.getAllItems()
+            .map { item ->
+                DisplayResponse.DisplayItemDetail(
+                    itemName = item.name,
+                    count = item.count,
+                    imageUrl = item.imageUrl,
+                )
+            }
+
+        return DisplayResponse(
+            posters = posters,
+            schedules = schedules,
+            items = items,
+        )
+    }
+}

src/main/kotlin/site/billilge/api/backend/domain/display/repository/DisplayPosterRepository.kt

@@ -3,4 +3,6 @@ package site.billilge.api.backend.domain.display.repository
 import org.springframework.data.jpa.repository.JpaRepository
 import site.billilge.api.backend.domain.display.entity.DisplayPoster
 
-interface DisplayPosterRepository : JpaRepository<DisplayPoster, Long>
+interface DisplayPosterRepository : JpaRepository<DisplayPoster, Long> {
+    fun findByIsActiveTrue(): List<DisplayPoster>
+}

src/main/kotlin/site/billilge/api/backend/domain/display/service/DisplayPosterService.kt

@@ -16,6 +16,10 @@ class DisplayPosterService(
         return displayPosterRepository.findAll()
     }
 
+    fun getActivePosters(): List<DisplayPoster> {
+        return displayPosterRepository.findByIsActiveTrue()
+    }
+
     @Transactional
     fun addPoster(imageUrl: String, title: String) {
         val poster = DisplayPoster(

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

@@ -62,6 +62,7 @@ class SecurityConfig (
             .authorizeHttpRequests { httpRequests ->
                 httpRequests
                     .requestMatchers("/auth/**").permitAll()
+                    .requestMatchers("/display").permitAll()
                     .requestMatchers(*SWAGGER_API_PATH).permitAll()
                     .anyRequest().authenticated()
             }