日付が変わった瞬間に、昨日の壁紙がもう一度出た — 時刻処理をエージェント任せにしないための日付境界設計

import java.time.LocalDate
import java.time.ZoneId
import java.time.Clock
 
// 「今日」を表す安定したキー。表示・選択・キャッシュの全てがこれを参照する
data class DayKey(val isoDate: String) {  // 例: "2026-06-25"
    companion object {
        fun of(clock: Clock, zone: ZoneId): DayKey =
            DayKey(LocalDate.now(clock.withZone(zone)).toString())
    }
}
 
// 日付キーから決定的にインデックスを引く（端末や言語に依存しない）
fun wallpaperIndexFor(key: DayKey, total: Int): Int {
    // 文字列ハッシュではなく、エポック日数で安定した連番にする
    val epochDay = LocalDate.parse(key.isoDate).toEpochDay()
    return Math.floorMod(epochDay, total)
}

class DailyRewardGate(
    private val store: PreferenceStore,
    private val clock: Clock,
    private val zone: ZoneId,
) {
    // 付与できる場合のみ true を返し、内部状態を進める
    fun tryClaim(): Boolean {
        val today = DayKey.of(clock, zone).isoDate
        val lastClaimed = store.getString("last_reward_day")  // "2026-06-24" 等
 
        // 端末時計が巻き戻された場合: today < lastClaimed のときは付与しない
        if (lastClaimed != null && today <= lastClaimed) return false
 
        // 同時タップでの二重付与を防ぐため、書き込みは比較と同じトランザクションで
        return store.compareAndSet("last_reward_day", expected = lastClaimed, newValue = today)
    }
}

import java.time.ZonedDateTime
import java.time.Duration
 
// 次の地域日付の始まり（0時）までの待ち時間を、夏時間込みで求める
fun durationUntilNextLocalMidnight(clock: Clock, zone: ZoneId): Duration {
    val now = ZonedDateTime.now(clock.withZone(zone))
    val nextMidnight = now.toLocalDate().plusDays(1).atStartOfDay(zone)
    return Duration.between(now, nextMidnight)
}

import java.time.Instant
import java.time.ZoneId
import kotlin.test.Test
import kotlin.test.assertFalse
import kotlin.test.assertTrue
 
class DailyRewardGateTest {
    private val tokyo = ZoneId.of("Asia/Tokyo")
 
    @Test fun 巻き戻し時計では二回目を付与しない() {
        var instant = Instant.parse("2026-06-25T15:30:00Z")  // JST 6/26 0:30
        val clock = object : java.time.Clock() {
            override fun instant() = instant
            override fun getZone() = tokyo
            override fun withZone(z: ZoneId) = this
        }
        val gate = DailyRewardGate(InMemoryStore(), clock, tokyo)
 
        assertTrue(gate.tryClaim())          // 6/26 分を付与
        instant = Instant.parse("2026-06-24T15:30:00Z")  // 時計を巻き戻す
        assertFalse(gate.tryClaim())         // 過去日では付与されない
    }
}