Files
clean-architecture-backend-…/docs/adr/NOTIF-ADR-001-durable-acceptance.md
T
DongHyeonka 59dff0041c ci(docs): 문서 검사에 문체를 더하고 번역한 결정 기록의 머리 문구를 맞춘다
문체 규칙(「~한다」, 「~합니다」와 섞지 않음)은 docs/README.md에 있지만
지키는 검사가 없어서, 번역 뒤에도 runbook 열 개에 높임 문장이 남았다.
그리고 결정 기록 머리 블록의 둘째 줄은 「본문은 결정한 때의 원문이다」인데,
2026-11-07에 본문을 한국어로 옮긴 ADR에는 맞지 않는다.

- check-docs.py `style`: 살아 있는 문서의 문장 끝이 높임(습니다·합니다·
  입니다·됩니다·십시오·하세요·주세요)이면 실패. 코드 블록, 인라인 코드,
  따옴표·낫표 안 인용, 「이력」 인용 블록은 보지 않는다.
- runbook 열 개의 「이 runbook은 다음 alert에서 발동됩니다.」를 「다음 alert가
  울리면 쓴다.」로 고쳤다. 지금 걸리는 곳은 이것뿐이었다.
- 결정 기록 표시 줄을 「본문은 결정한 때의 내용이다(번역은 뜻을 바꾸지
  않았다)」로 바꿨다: check-docs.py의 DECISION_LABEL, docs/README.md 설명,
  docs/adr의 머리 블록 33개(기록은 머리 블록만 고친다는 규칙 안).
- docs/README.md 「문서 검사」에 앞 커밋이 더한 `link`와 이번 `style`을 적고,
  링크 검사 설명을 바로잡았다. 「모듈 README」 절(design-docs
  docs-system.md 6.2절 다섯 칸)을 더했다.

버린 대안: 문체를 리뷰로만 보기(번역 묶음 네 개를 거쳐도 남았다).

위험: design-docs docs-system.md 4.1절과 프론트의 같은 문구는 이 repo
밖이라 고치지 않았다(총괄에게 알린다).

검증: python3 -m unittest discover -s scripts/tests(문체 시험 5 포함),
check-docs.py, check-work-docs.py 모두 rc=0. 이 커밋의 트리만 얹은 임시
worktree에서 돌렸다. 검사 조건을 끈 사본 둘에서 문체 시험이 각각 2건,
1건 실패했다.
2026-11-07 22:20:18 +09:00

1.8 KiB

결정 기록 본문은 결정한 때의 내용이다(번역은 뜻을 바꾸지 않았다). 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.

  • 상태: 채택
  • 작성일: 2026-08-14
  • 요약: 알림 submit()은 영속적으로 받아들였다는 뜻이라는 결정이다.
  • 현재 정본: docs/notification/support-matrix.md

NOTIF-ADR-001 — submit()은 durable 접수를 뜻한다

상태

채택.

배경

알림 플랫폼의 뻔한 API는 성공이나 실패를 돌려주는 send()다. 이 플랫폼이 지원하는 모든 채널이 그 반환값을 거짓말로 만든다:

  • SES는 요청을 받고 MessageId를 돌려준 뒤에도 보내기를 거절할 수 있다.
  • Twilio는 accepted, sent, delivered를 따로따로, 나중에 오는 이벤트로 나눈다.
  • APNs는 알림을 받은 뒤 전달하거나, 저장하거나, 버릴 수 있다.
  • Web Push는 프로토콜 수준에서 push service의 접수와 user agent의 확인 응답을 나눈다.

결정

submit()과 schedule()은 논리 요청과 그 수신자 job이 데이터베이스에 커밋되면 돌아온다. 접수증은 notificationId, RequestStatus, acceptedAt을 싣고, delivered·sent·read 요소가 없다. 트랜잭션이 열려 있는 동안에는 어떤 provider에도 연락하지 않는다.

결과

타입이 그렇게 읽을 길을 주지 않으므로, 호출자는 접수를 전달로 착각할 수 없다. 전달 상태는 provider 이벤트 원장에서 만든 projection에 대한 따로 둔 query다. 비용은 「도착했나?」가 두 번째 질문이라는 것이다 — 그것이 정직한 질문 수다.