31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# NotiHub Server
|
|
|
|
## 이메일 발송 상태 101 운영 참고
|
|
|
|
`result_code=101` (`EMAIL_SENDING`)은 서버가 이메일 발송 처리를 시작했지만
|
|
공급사 접수 결과를 아직 DB에 반영하지 않은 일시적인 상태다.
|
|
이때 `send_status`는 `0` (`STANDBY`)이다.
|
|
|
|
- 즉시 단건 이메일은 `101`로 등록·커밋한 뒤 공급사 API를 호출한다.
|
|
- 예약·벌크 이메일은 발송 대기 `100`에서 처리 시작 시 `101`로 전환한다.
|
|
- 공급사 접수 성공과 실제 `return_key` 저장이 완료되면 `111`로 전환한다.
|
|
이는 접수 성공이며 최종 발송 결과는 poller로 조회한다.
|
|
- 준비 오류·접수 실패·타임아웃·키 미수신 등이 처리되고 DB 저장까지 완료되면
|
|
`109`로 전환한다.
|
|
|
|
### 내부 장애로 101이 남은 경우
|
|
|
|
공급사 API 처리 후 `111` 또는 `109`를 저장하기 전에 서버가 강제 종료되거나
|
|
DB 저장이 실패하면, 먼저 커밋된 `101`이 남을 수 있다.
|
|
정상적으로 응답·타임아웃 처리와 DB 저장이 끝난 경우에는 계속 남는 상태가 아니다.
|
|
|
|
잔류한 `101`만으로 공급사 접수 여부를 판단할 수 없으므로 운영 확인 대상으로 취급한다.
|
|
임시 UUID 또는 `RESERVATION_…`는 실제 `return_key`가 아니므로 결과 조회에 사용할 수 없다.
|
|
공급사 접수·발송 여부를 확인하지 않고 재발송하면 중복 발송될 수 있다.
|
|
|
|
이번 템플릿 soft delete 변경에는 별도의 `101` 자동 복구 기능을 추가하지 않는다.
|
|
미완료 발송(`send_status=0`)이 남아 있으면 해당 템플릿의 삭제를 차단한다.
|
|
|
|
기존 비예약 벌크 이메일의 오래된 `101`을 `100`으로 되돌리는 복구 처리는 유지된다.
|
|
해당 처리는 `bulk_send_key`가 없는 즉시 단건 이메일에는 적용되지 않는다.
|