Files
clean-architecture-backend-…/src/application/notification/AGENTS.md
T
DongHyeonka 7fdbbcaa87 docs: leaf 안내와 web 한도 표의 틀린 위치·주체를 코드에 맞춘다
문제(새 눈 리뷰):
- web-notification 안내가 callback 서명 검증을 유스케이스가 한다고 적었다.
  실제로는 composition의 ProviderCallbackIngressBridge가 outbound provider
  adapter(SES는 SnsSignatureVerifier)로 검증하고 검증된 event만 넘긴다.
- application-notification 안내가 없는 패키지 platform.port.out을 나가는 포트
  위치로 적었고, testFixtures를 「포트마다 fake 하나」라고 실제보다 크게 적었다.
- web-fileserver 책임 목록에 lifecycle(삭제·복사·이동)과 http(Range·조건부
  다운로드 계획) 패키지가 없었다.
- redis-runtime README가 app.redis.* 기본값 위치를 잘못 적었다. objectstorage
  README가 포트 개수를 복사했다.
- web 한도 표가 multipart 한도를 「전역 한도 없음」이라 했고, 아무도 막지 않는
  칸을 「늘 애플리케이션」이라 했다.
- TESTING_STRATEGY가 묶음 태스크를 셋이라 세며 performanceCheck를 빠뜨렸다.
- roadmap messaging-r2 이력 블록의 날짜·이유가 틀렸다(6d27356e, 2026-09-25).
- 지운 ComposeMergeCharacterizationTest 행의 커밋이 지운 쪽 기준이 아니었다.

고친 것: 위 문장을 지금 코드대로 고쳤다. 공개 경로 스냅숏 문장과 fileserver
「오류 코드」 절 안내는 공개 표면 PR·계약 PR이 만드는 것이라 병합 순서로 맞춘다.

검증: check-docs.py·check-work-docs.py rc=0.

Refs: RR9-04-09, RR9-04-21, RR9-04-35, RR9-04-42, RR9-03-30
2026-11-13 05:20:40 +09:00

1.9 KiB

application-notification — 알림 플랫폼의 유스케이스와 포트

등록 정보

  • 모듈 ID: application-notification
  • Gradle 경로: :application-notification
  • 이 모듈만 시험(Gradle 경로에서 나온 명령): ./gradlew :application-notification:test --console=plain
  • registry 정본: gradle/modules.json.

패키지 루트: dev.caskeleton.application.notification. 무엇을 주는지와 조립은 README.md에 있다.

책임

  • 알림 플랫폼의 업무 흐름: 제출·예약·취소·조회, template 게시, provider callback 수집, 발송 판정과 재시도 정책.
  • 들어오는 포트(platform.port.in의 *UseCase·*Command·*Query), 나가는 포트(*Port, 쓰는 흐름의 패키지에 있다: platform.dispatch·platform.callback·platform.policy·platform.observation·platform.admin·platform.inbox·platform.template), 오류 어휘(platform.api.error). port.out 패키지는 따로 없다.
  • testFixtures: 흐름 패키지마다 testkit에 저장 포트의 in-memory fake와 공유 계약(*Contract), provider adapter 계약(ProviderAdapterContract). adapter의 시험이 같은 계약을 상속한다.

규칙

  • framework 의존이 없다(ca.java-library). Spring·JPA·HTTP 타입을 쓰지 않는다. 허용 의존은 registry의 application-core·shared-contract뿐이다.
  • 전송 DTO(HTTP 요청·응답 record)를 여기에 두지 않는다. 전송 모양은 adapter:inbound:web-notification의 것이다.
  • 발송 판정(마케팅 억제, category 필수)은 여기서 한다. 전송이나 설정에서 기본값을 골라 넣지 않는다.
  • 공개 타입이 늘면 docs/notification/api-surface-snapshot.txt가 바뀐다(adapter:outbound:notification의 verifyNotificationApiSurface가 이 leaf까지 본다).

테스트

./gradlew :application-notification:test --console=plain