@Configuration
@EnableScheduling  // 필수
class SchedulingConfig

@Component
class ScheduledTasks {
    
    // 고정 딜레이: 이전 작업 종료 후 5초 대기
    @Scheduled(fixedDelay = 5000)
    fun fixedDelayTask() {
        println("5초마다 실행 (이전 작업 완료 기준)")
    }
    
    // 고정 간격: 이전 작업 시작 후 5초마다
    @Scheduled(fixedRate = 5000)
    fun fixedRateTask() {
        println("5초마다 실행 (시작 시간 기준)")
    }
    
    // Cron 표현식: 매일 새벽 2시
    @Scheduled(cron = "0 0 2 * * *")
    fun cronTask() {
        println("매일 새벽 2시 실행")
    }
    
    // 초기 지연: 앱 시작 10초 후 첫 실행
    @Scheduled(initialDelay = 10000, fixedRate = 60000)
    fun initialDelayTask() {
        println("앱 시작 10초 후, 이후 1분마다")
    }
}

"0 0 2 * * *"        // 매일 새벽 2시
"0 */30 * * * *"     // 30분마다
"0 0 9-18 * * MON-FRI"  // 평일 9시~18시 매 정시
"0 0 0 1 * *"        // 매월 1일 자정

// ShedLock 사용
@Component
class ScheduledTasks {
    
    @Scheduled(cron = "0 0 2 * * *")
    @SchedulerLock(
        name = "settlementTask",
        lockAtMostFor = "30m",
        lockAtLeastFor = "5m"
    )
    fun settlement() {
        // DB 락으로 한 인스턴스만 실행
    }
}

// build.gradle.kts
dependencies {
    implementation("org.springframework.boot:spring-boot-starter-quartz")
}

// Job 정의
class SettlementJob : Job {
    override fun execute(context: JobExecutionContext) {
        println("정산 배치 실행: ${context.fireTime}")
        // 배치 로직
    }
}

// 설정
@Configuration
class QuartzConfig {
    
    @Bean
    fun settlementJobDetail(): JobDetail {
        return JobBuilder.newJob(SettlementJob::class.java)
            .withIdentity("settlementJob", "batch")
            .withDescription("일일 정산 Job")
            .storeDurably()
            .build()
    }
    
    @Bean
    fun settlementTrigger(): Trigger {
        return TriggerBuilder.newTrigger()
            .forJob(settlementJobDetail())
            .withIdentity("settlementTrigger", "batch")
            .withSchedule(
                CronScheduleBuilder.cronSchedule("0 0 2 * * ?")
                    .withMisfireHandlingInstructionFireAndProceed()
            )
            .build()
    }
}

@RestController
@RequestMapping("/api/batch")
class BatchController(private val scheduler: Scheduler) {
    
    @PostMapping("/trigger/{jobName}")
    fun triggerJob(
        @PathVariable jobName: String,
        @RequestParam params: Map<String, String>
    ): ResponseEntity<*> {
        
        val jobKey = JobKey.jobKey(jobName, "batch")
        
        // Job 존재 확인
        if (!scheduler.checkExists(jobKey)) {
            return ResponseEntity.badRequest().body("Job not found")
        }
        
        // 파라미터와 함께 실행
        val jobDataMap = JobDataMap(params)
        scheduler.triggerJob(jobKey, jobDataMap)
        
        return ResponseEntity.ok("Triggered: $jobName")
    }
}

// @Scheduled: 가벼운 실시간 작업
@Component
class RealtimeScheduler {
    
    @Scheduled(fixedDelay = 300000)
    fun refreshCache() {
        // 5분마다 캐시 갱신
    }
}

// Quartz: 앱 로직과 밀접한 작업
@Service
class OrderService(private val scheduler: Scheduler) {
    
    fun createOrder(order: Order) {
        orderRepository.save(order)
        
        // 30분 후 자동 취소 스케줄
        scheduler.scheduleJob(
            CancelOrderJob(order.id),
            Date(System.currentTimeMillis() + 1800000)
        )
    }
}