# 전달 증거 모델 ## 모양 ```text NotificationRequest └─ RecipientDelivery └─ DeliveryAttempt └─ ProviderEvent (append-only) └─ channel projector └─ SubmissionOutcome / DeliveryOutcome / EvidenceLevel + EngagementFacts + SuppressionFacts ``` 신원 넷, 수명 주기 넷이다. 논리 요청은 수신자 작업이 아니고, 수신자 작업은 provider attempt가 아니고, provider attempt는 그것을 설명하는 이벤트 흐름이 아니다. ## 상태 enum 하나가 아닌 이유 일직선 상태 하나는 「무슨 일이 있었나」에 값 하나로 답해야 하는데, 실제 답은 한 줄에 들어가지 않는다. - 이메일은 `DELIVERED`가 된 뒤 complaint를 낼 수 있다. 두 사실이 다 참이고 다 중요하다. 하나는 보고에, 다른 하나는 억제에 쓴다. - Twilio는 콜백 순서를 보장하지 않아서 `sent`가 `delivered` 뒤에 오는 일이 흔하다. 순번 규칙에서는 뒤에 온 약한 이벤트가 강한 이벤트를 조용히 덮어쓴다. - APNs는 알림을 수락한 뒤 저장하거나, 바꾸거나, 버릴 수 있다. 그래서 ledger는 이벤트를 저장하고, channel projector가 명시한 전이 표로 그것을 합친다. 공통 규칙은 `StandardDeliveryProjector`가 가지고, provider projector는 자기 이벤트 어휘만 더한다. ## 합치는 규칙 | 전이 | 결과 | |---|---| | `sent` → `delivered` | 적용 | | `delivered` → `sent` | 무시, 이벤트는 저장 | | `delivered` → `complaint` | complaint 사실을 더하고 전달은 유지 | | `complaint` → `delivered` | 전달을 적용하고 complaint는 유지 | | `accepted` → `bounced` | 적용 | | `read` → `displayed` | 무시 | | hard bounce → `delivered` | 무시, hard bounce는 끝 상태 | 참여(`opened`, `clicked`)는 전달 결과 옆에 저장하고 그것을 바꾸지 않는다. ## 모호함 ```text platform ──── send ────▶ provider │ └── accepted ✗ connection reset ``` 알림이 실제로 보내졌는데 플랫폼은 provider request id를 하나도 가지지 못할 수 있다. attempt는 `requestStarted`, `requestBodyCommitted`, `providerResponseReceived`와 그 각각의 `EvidenceCertainty`를 기록한다. 그래서 나중의 판단이 「아무것도 보내지 않았음을 안다」와 「답을 읽지 못했다」를 가릴 수 있다. `ProviderSubmissionResult`가 이것을 강제한다. 모호한 결과는 `PROVIDER_ACCEPTED`를 주장할 수 없고, 어떤 제출 결과도 전달 결과를 실을 수 없다.