[yuyeol3]

#17(테스트 CI) 위에 쌓은 PR입니다. #17이 먼저 머지돼야 합니다. 또 Fin-BE의 dev 배포 전환(ApptiveDev/Fin-BE#40)이 끝난 뒤 머지해야 합니다. 그래야 서버 DB 포트와 GCP 설정이 준비돼 있습니다.

변경점 👍

수집 배치를 GitHub Actions에서 주기적으로 돌려 서버 DB에 씁니다. 서버(e2-micro, 1GB)에는 Chromium 8개를 띄울 여유가 없어서 러너에서 실행합니다.

• collect.yml
  • 주기: LLM API가 유료라 약 2주 간격으로 돕니다(매월 2·16일 04:00 KST). 그 사이에는 Actions 탭에서 수동 실행(workflow_dispatch)할 수 있습니다.
  • main → dev DB, release → 운영 DB입니다. 운영은 레포 변수 PROD_ENABLED=true일 때만 돕니다(운영 서버 준비 전에는 건너뜀).
• _collect.yml (재사용 워크플로)
  1. 같은 브랜치로 ci.yml(테스트)을 먼저 돌립니다. 실패하면 수집하지 않습니다.
  2. Chromium을 설치합니다(은행 상품 URL 스크래핑용).
  3. GCP에 OIDC로 인증하고, IAP SSH 포트 포워딩으로 서버 Postgres(127.0.0.1:5678)를 러너 15432에 연결합니다. DB 포트를 외부에 열지 않습니다.
  4. ./gradlew bootRun으로 배치를 실행합니다. 배치가 FAILED면 #17에서 고친 종료 코드 때문에 단계가 실패합니다.
• CLAUDE.md: 수집 워크플로 설정, 필요한 Environment 값, 그리고 "엔티티가 새 컬럼을 쓰면 Fin-BE 배포가 먼저"라는 순서 제약을 적었습니다.

테스트 💻

• actionlint(shellcheck 포함) 통과
• 종료 코드 전달은 #17에서 확인했습니다(FAILED → 종료 코드 5).
• 실제 수집(GCP 터널, Chromium 설치)은 스케줄·수동 실행 워크플로라 머지 후 첫 수동 실행에서 확인됩니다.

머지 전 체크리스트

• chore : 테스트 CI 추가와 배치 실패 시 종료 코드 전달 #17 머지 후 이 PR을 main 기준으로 정리
• Fin-BE#40 머지와 dev 배포 확인
• Environment dev 변수·시크릿 등록
• 머지 후 수동 실행(dev) 1회 → 상품 건수와 updated_at 확인