feat: 복지서비스 수집을 최초 기동 시 1회 실행

[horisomebody]

관련 이슈

작업 내용

WelfareCollectScheduler가 매월 1일 00:00 KST에만 돌아서, 배포 직후엔 welfare_program이 DEMO-* 시드만 있는 빈 상태였다. 다음 달 1일까지 기다려야 실데이터가 채워짐.

ApplicationReadyEvent에서 자동 수집 이력이 하나도 없으면 최초 1회 수집을 돌린다.

WelfareCollectBootstrap (신규)

@EventListener(ApplicationReadyEvent.class)
public void collectOnceIfNeverRun() {
    if (serviceKey.isBlank()) return;                         // CI·로컬 기본 — 매 기동 실패 로그 안 남김
    if (repository.existsBySource(API_CANDIDATE)) return;      // 이미 돌았음 — 재배포마다 외부 API 안 때림
    // 데몬 스레드에서 launcher.launch()
}

• existsBySource(API_CANDIDATE) — DEMO-* 시드는 MANUAL_CURATION이라 안 잡힘 → "진짜 수집이 한 번이라도 돌았나" 판단
• 기동을 막지 않게 데몬 스레드에서 실행
• 실패해도 WelfareCollectLauncher가 예외를 삼키므로, 다음 기동 때 이력이 여전히 없어 자동 재시도

그 외

• WelfareProgramRepository.existsBySource(ProgramSource) 추가
• spring.batch.job.enabled=false는 유지 — "등록된 잡 전부 기동 시 실행"은 여전히 위험. 이건 그것과 별개로 조건부 1회만.
• 관련 주석 갱신 (application.yml, WelfareCollectScheduler)

확인한 것

• 백엔드 — ./gradlew build 통과
• WelfareCollectBootstrapTest 3케이스 (키 없음 / 이미 수집됨 / 최초 실행)
• DdayApplicationTests 컨텍스트 로딩 통과 (테스트엔 키 없어 건너뜀)

리뷰어에게

• 이 PR은 WELFARE_API_KEY가 운영에 설정돼 있어야 실제로 동작함 (별도 PR chore: 배포 시 WELFARE_API_KEY를 서버 .env에 반영 #142 + 리포 Secret).
• 키 설정 후 다음 배포에서 기동 → 최초 수집 1회 자동 실행됨.

🤖 Generated with Claude Code