[ Feature ] - 플랫폼 정산 규칙 기반 가상계좌 소득 입금 생성

[KSBoscoKim]

관련 이슈

• Resolves : [ Feature ] - 플랫폼 정산 규칙 기반 가상계좌 소득 입금 생성 #216

작업 사항

• 예상 정산일·정산기간 순방향 계산 (ExpectedSettlementDateCalculator, SettlementDayOfWeekParser)

  • DAILY/WEEKLY/MONTHLY 정산주기별로 근무일 → 예상 입금일을 순방향 계산
  • settlement_offset_unit=BUSINESS_DAY는 주말·공휴일을 건너뛰고 계산
  • WEEKLY는 settlement_day_of_week(예: 쿠팡이츠=금요일) 고정 요일 기준으로, 기존 역방향 계산기(SettlementPeriodCalculator)와 정합되는 입금일을 탐색
  • SettlementPeriodCalculator도 함께 수정: 정산 요일이 고정된 WEEKLY 플랫폼은 공휴일로 실제 입금만 밀릴 뿐 정산기간 자체는 달력일 고정 간격으로 유지되도록 변경

• 가상 정산 입금 배치 (VirtualSettlementDepositService)

  • 확정(CONFIRMED)된 근무일지의 플랫폼별 예상 소득을 정산기간 단위로 그룹핑해 입금 생성 요청
  • settlement_trigger_type=ON_DEMAND 플랫폼은 자동 생성 대상에서 제외
  • 한 플랫폼의 정산 규칙 계산 실패가 같은 사용자의 다른 플랫폼 처리를 막지 않도록 소득/그룹 단위로 예외 격리

• NTROPY 가상계좌 입금 처리 (LocalVirtualSettlementDepositCommandClient)

  • provider=NTROPY인 수시입출금 계좌만 대상으로 하고 CODEF 실계좌는 건드리지 않음
  • 사용자·플랫폼·정산기간 기준 결정적 fingerprint로 중복 입금 생성 방지
  • 같은 정산기간에 근무일지가 늦게 확정되는 경우, 이미 입금된 금액과의 차액만 top-up으로 추가 입금 (계좌 잔액은 row lock으로 동시성 보호)

• 기존 정산 매칭 배치 연동 (SettlementScheduler, SettlementService)

  • 가상 입금 생성 직후 실제 입금일 목록(matchTargets)을 즉시 재매칭해, 기존 정산 배치의 3일 백필 윈도우보다 오래된 과거 입금도 누락 없이 정산 완료 처리