260714_01_ENH: 이메일 발송 수정 및 발송결과 재갱신 5분단위 스케쥴 추가

This commit is contained in:
2026-07-14 09:07:34 +09:00
parent fd43fce572
commit 06fe85e7ee
4 changed files with 49 additions and 43 deletions

View File

@@ -58,9 +58,9 @@ public interface SendRepository extends JpaRepository<TSendEntity, Long> {
/**
* Poller 복구용: STANDBY_EMAIL 상태로 남아있는 최근 발송건을 다시 enqueue 하기 위해 사용
*/
Page<TSendEntity> findBySendTyAndResultCodeAndSendDtAfterOrderBySendDtAsc(
Page<TSendEntity> findBySendTyAndResultCodeInAndSendDtAfterOrderBySendDtAsc(
short sendTy,
short resultCode,
List<Short> resultCodes,
LocalDateTime sendDtAfter,
Pageable pageable
);

View File

@@ -0,0 +1,18 @@
package com.kri.notihub.server.scheduler;
import com.kri.notihub.server.service.EmailResultPoller;
import lombok.RequiredArgsConstructor;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Service;
@Service
@RequiredArgsConstructor
public class EmailResultPollScheduler {
private final EmailResultPoller emailResultPoller;
@Scheduled(cron = "0 */5 * * * *")
public void enqueueRecoverableEmailResults() {
emailResultPoller.enqueueRecoverableEmailResults();
}
}

View File

@@ -3,6 +3,7 @@ package com.kri.notihub.server.service;
import com.kri.common.feature.datetime.DateTimeUtil;
import com.kri.common.feature.util.CommonUtil;
import com.kri.common.feature.util.NumericUtil;
import com.kri.common.feature.util.StringUtil;
import com.kri.notihub.server.common.consts.NotihubConst;
import com.kri.notihub.server.common.enums.ChannelType;
import com.kri.notihub.server.common.enums.SendStatusType;
@@ -89,6 +90,9 @@ public abstract class AbstractPringoSendService extends AbstractSendService {
public SendInternalResultDto sendPringoEmail(PringoJsonSendRequestDto pringoReq) {
PringoJsonSendResponseDto pringoRes = null;
try {
if(StringUtil.isNullOrBlank(pringoReq.getRecipientName())){
pringoReq.setRecipientName(pringoReq.getRecipient());
}
pringoRes = pringoApiClient.jsonSend(pringoReq);
} catch (Exception e) {
log.warn("Pringo json-send failed (pringoReq={})", pringoReq, e);
@@ -139,7 +143,7 @@ public abstract class AbstractPringoSendService extends AbstractSendService {
.sender(sendEml)
.senderName(Optional.ofNullable(sendNm).orElse(""))
.recipient(dest.getDestEml())
.recipientName(Optional.ofNullable(dest.getDestNm()).orElse(""))
.recipientName(Optional.ofNullable(dest.getDestNm()).orElse(dest.getDestEml()))
.subject(Optional.ofNullable(msgTitle).orElse(""))
.body(Optional.ofNullable(msgBody).orElse(""))
.vars(vars)

View File

@@ -27,41 +27,28 @@ import org.springframework.data.domain.PageRequest;
import org.springframework.data.domain.Pageable;
import org.springframework.stereotype.Component;
/**
* Pringo는 발송요청/결과조회가 "1건씩"만 가능하므로, 동기(요청 스레드)에서 json_return을 반복 호출하지 않고 Poller에서 비동기로 1회만 조회해 DB를
* 갱신한다.
* <p>
* - 단건/벌크 공통: 발송요청 성공(return_key 수신) -> Poller enqueue -> (지연 후) json_return 1회 조회 - 서비스 재기동 시:
* STANDBY_EMAIL + RESULT_CODE_PENDING 인 레코드를 DB에서 스캔하여 재등록
* <p>
* 운영 정책(딜레이/재시도 횟수)은 설정으로 조정 가능(기본: 재시도 0회).
*/
@Slf4j
@Component
@RequiredArgsConstructor
public class EmailResultPoller {
private static final List<Short> RECOVERABLE_RESULT_CODES = List.of(
NotihubConst.EMAIL_PENDING,
NotihubConst.EMAIL_NOT_RESULT
);
private final DelayQueue<PollTask> queue = new DelayQueue<>();
private final EmailResultUpdater emailResultUpdater;
private final SendRepository sendRepository;
/**
* 런타임 중 중복 enqueue 방지(같은 returnKey를 여러 번 등록하지 않기 위함)
*/
private final Set<String> scheduledKeys = ConcurrentHashMap.newKeySet();
private volatile boolean running = true;
private Thread worker;
/**
* 운영 권장값은 '최종 상태가 나올 가능성이 높은 지연'이다. 즉시성보다 '1회 조회로 최종 상태 반영'을 우선하면 60~180초 수준이 실무적으로 안정적이다.
*/
@Value("${kri.email.result-poll.initial-delay-ms:60000}")
private long initialDelayMs;
/**
* 사용자는 json_return을 여러 번 호출하지 않을 예정이라고 했으므로 기본은 0(재시도 없음). 필요 시 설정으로 1~2 정도만 허용하는 것을 권장.
*/
@Value("${kri.email.result-poll.max-attempts:0}")
private int maxAttempts;
@@ -82,16 +69,14 @@ public class EmailResultPoller {
}
public EmailPollQueueResponseDto snapshotQueue() {
final long nowNanos = System.nanoTime(); // queue 내부 기준(상대시간)
final long nowEpochMs = System.currentTimeMillis(); // 출력용 기준(절대시간)
final long nowNanos = System.nanoTime();
final long nowEpochMs = System.currentTimeMillis();
List<EmailPollQueueItemDto> items = queue.stream()
.filter(Objects::nonNull)
.map(t -> {
long remainingNanos = t.triggerAtNanos - nowNanos;
long remainingMs = Math.max(0L, TimeUnit.NANOSECONDS.toMillis(remainingNanos));
// nanoTime은 epoch로 직접 변환 불가 → "현재 epoch + remainingMs"로 예상 시각 구성
long triggerAtEpochMs = nowEpochMs + remainingMs;
return EmailPollQueueItemDto.of(
@@ -109,42 +94,43 @@ public class EmailResultPoller {
return EmailPollQueueResponseDto.of(items);
}
/**
* 서비스 재기동 시 유실된 PollTask를 복구한다. - DB(t_send)에 STANDBY_EMAIL로 남아 있는 Pringo 이메일 중, cmid가
* return_key(숫자)인 레코드를 재등록 - in-memory 큐를 신뢰하지 않고, DB를 단일 소스 오브 트루스로 본다
*/
@EventListener(ApplicationReadyEvent.class)
public void recoverFromDbOnStartup() {
enqueueRecoverableEmailResults(1000L);
}
public void enqueueRecoverableEmailResults() {
enqueueRecoverableEmailResults(initialDelayMs);
}
private void enqueueRecoverableEmailResults(long delayMs) {
try {
LocalDateTime from = LocalDateTime.now().minusDays(Math.max(1, recoverDays));
int page = 0;
Pageable pageable = PageRequest.of(page, Math.max(100, recoverPageSize));
Pageable pageable = PageRequest.of(0, Math.max(100, recoverPageSize));
while (true) {
Page<TSendEntity> p = sendRepository.findBySendTyAndResultCodeAndSendDtAfterOrderBySendDtAsc(
Page<TSendEntity> page = sendRepository.findBySendTyAndResultCodeInAndSendDtAfterOrderBySendDtAsc(
SendType.EMAIL.getCode(),
NotihubConst.EMAIL_PENDING, // ★ STANDBY_EMAIL(100) 같은 값이 아니라 PENDING(111)을 복구 대상으로
RECOVERABLE_RESULT_CODES,
from,
pageable
);
if (!p.hasContent()) {
if (!page.hasContent()) {
break;
}
for (TSendEntity e : p.getContent()) {
for (TSendEntity e : page.getContent()) {
if (isNumeric(e.getCmid())) {
// 재기동 복구는 '가능한 빨리' 한 번 조회하도록 짧은 딜레이로 등록
enqueueInternal(e.getCmid(), 1000L, 0);
enqueueInternal(e.getCmid(), delayMs, 0);
}
}
if (!p.hasNext()) {
if (!page.hasNext()) {
break;
}
pageable = p.nextPageable();
pageable = page.nextPageable();
}
} catch (Exception ex) {
// 복구 실패가 서비스 기동을 막지 않도록
log.warn("EmailResultPoller recovery skipped due to error", ex);
log.warn("EmailResultPoller recoverable enqueue skipped due to error", ex);
}
}
@@ -167,13 +153,11 @@ public class EmailResultPoller {
maxDelayMs);
enqueueInternal(task.returnKey, nextDelay, task.attempt + 1);
} else if (!done) {
// 더 이상 재시도하지 않는 경우: 재기동 복구/중복 조회를 막기 위해 '조회 실패'로 마킹
markQueryFailIfPending(task.returnKey);
}
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
} catch (Exception e) {
// Poller 자체는 죽지 않도록 방어
log.debug("EmailResultPoller worker error", e);
}
}