feat: add daily chess puzzle api

src/test/kotlin/me/wypark/blogbackend/api/controller/ChessPuzzleControllerIntegrationTest.kt

@@ -0,0 +1,130 @@
+package me.wypark.blogbackend.api.controller
+
+import me.wypark.blogbackend.domain.chess.ChessPuzzle
+import me.wypark.blogbackend.domain.chess.ChessPuzzleRepository
+import org.junit.jupiter.api.BeforeEach
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.boot.test.context.TestConfiguration
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Primary
+import org.springframework.test.context.ActiveProfiles
+import org.springframework.test.web.servlet.MockMvc
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
+import org.springframework.transaction.annotation.Transactional
+import java.time.Clock
+import java.time.Instant
+import java.time.LocalDate
+import java.time.ZoneId
+import java.time.ZoneOffset
+
+@SpringBootTest
+@AutoConfigureMockMvc
+@ActiveProfiles("test")
+@Transactional
+class ChessPuzzleControllerIntegrationTest {
+
+    @Autowired
+    lateinit var mockMvc: MockMvc
+
+    @Autowired
+    lateinit var chessPuzzleRepository: ChessPuzzleRepository
+
+    @Autowired
+    lateinit var clock: MutableClock
+
+    @BeforeEach
+    fun setUp() {
+        clock.setDate(LocalDate.of(2026, 5, 28), ZoneId.of("Asia/Seoul"))
+    }
+
+    @Test
+    fun `today puzzle is public and returns selected puzzle`() {
+        savePuzzle(sourcePuzzleId = "puzzle-1", sortOrder = 1, answer = "Be8#", answerUci = "d7e8")
+
+        mockMvc.perform(get("/api/chess-puzzles/today").param("timezone", "Asia/Seoul"))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.code").value("SUCCESS"))
+            .andExpect(jsonPath("$.data.date").value("2026-05-28"))
+            .andExpect(jsonPath("$.data.title").value("오늘의 메이트"))
+            .andExpect(jsonPath("$.data.theme").value("mateIn1"))
+            .andExpect(jsonPath("$.data.answer").value("Be8#"))
+            .andExpect(jsonPath("$.data.answerUci").value("d7e8"))
+    }
+
+    @Test
+    fun `today puzzle rotates by date`() {
+        savePuzzle(sourcePuzzleId = "puzzle-1", sortOrder = 1, answer = "Be8#", answerUci = "d7e8")
+        savePuzzle(sourcePuzzleId = "puzzle-2", sortOrder = 2, answer = "Qh5#", answerUci = "g6h5")
+
+        clock.setDate(LocalDate.of(2026, 5, 28), ZoneId.of("Asia/Seoul"))
+        mockMvc.perform(get("/api/chess-puzzles/today").param("timezone", "Asia/Seoul"))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.data.answer").value("Be8#"))
+
+        clock.setDate(LocalDate.of(2026, 5, 29), ZoneId.of("Asia/Seoul"))
+        mockMvc.perform(get("/api/chess-puzzles/today").param("timezone", "Asia/Seoul"))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.data.answer").value("Qh5#"))
+    }
+
+    @Test
+    fun `today puzzle returns not found when no active puzzle exists`() {
+        mockMvc.perform(get("/api/chess-puzzles/today").param("timezone", "Asia/Seoul"))
+            .andExpect(status().isNotFound)
+            .andExpect(jsonPath("$.code").value("CHESS_PUZZLE_NOT_FOUND"))
+            .andExpect(jsonPath("$.message").value("오늘의 체스 퍼즐이 준비되지 않았습니다."))
+    }
+
+    private fun savePuzzle(
+        sourcePuzzleId: String,
+        sortOrder: Int,
+        answer: String,
+        answerUci: String
+    ): ChessPuzzle {
+        return chessPuzzleRepository.saveAndFlush(
+            ChessPuzzle(
+                sourcePuzzleId = sourcePuzzleId,
+                sourceUrl = "https://lichess.org/training/$sourcePuzzleId",
+                title = "오늘의 메이트",
+                theme = "mateIn1",
+                fen = "8/3B2pp/p5k1/6P1/1ppp1K2/8/1P6/8 w - - 0 39",
+                answer = answer,
+                answerUci = answerUci,
+                hint = "체크메이트가 되는 한 수를 찾으세요.",
+                rating = 1200,
+                popularity = 90,
+                sortOrder = sortOrder
+            )
+        )
+    }
+
+    @TestConfiguration
+    class ClockTestConfiguration {
+        @Bean
+        @Primary
+        fun mutableClock(): MutableClock = MutableClock()
+    }
+}
+
+class MutableClock(
+    private var currentInstant: Instant = LocalDate.of(2026, 5, 28)
+        .atStartOfDay(ZoneId.of("Asia/Seoul"))
+        .toInstant(),
+    private val currentZone: ZoneId = ZoneOffset.UTC
+) : Clock() {
+
+    override fun getZone(): ZoneId = currentZone
+
+    override fun withZone(zone: ZoneId): Clock = MutableClock(currentInstant, zone)
+
+    override fun instant(): Instant = currentInstant
+
+    fun setDate(date: LocalDate, zoneId: ZoneId) {
+        currentInstant = date.atStartOfDay(zoneId).toInstant()
+    }
+}