pr / done (pull_request) Canceled after 0s
시스템이 부르는 쓰기가 유스케이스 계약 밖에 있다. fileserver 정리·맞추기, 알림 claim·발송·lease 회복·맞추기·provider event replay는 capability도 트랜잭션 선언도 없는 서비스를 worker가 바로 부르고, 그 worker와 조립은 outbound adapter 안에 있다. 알림 운영자 연산 넷은 permission 없이 서비스 하나에 모여 있고 재시도 시각은 상수다. web stream bridge는 outbound가 구현한 replay 포트를 바로 읽는다. fileserver 관리 HTTP 기본값은 controller가 정한다. 고른 방법: 시스템 쓰기는 @SystemInvoked 유스케이스로 나누고 composition worker 설정이 new로 만든다(bean 아님). 알림 worker와 fileserver 정리 조립은 composition으로 옮기고, 맞추기의 재시도·포기 시점은 유스케이스가 정한다. 운영자 연산은 platform.admin의 유스케이스 클래스 넷과 notification-admin:* permission이다(port.in 인터페이스는 port.in과 admin의 cycle을 만들어 두지 않는다). replay 읽기는 조회 유스케이스 둘을 거치고 포트는 LiveEventReplayQueryPort로 이름을 바꾼다. 아키텍처 규칙 둘: 사용자 전송은 저장·id 포트를 쥐지 못하고, inbound는 application 서비스·coordinator를 interface로도 쥐지 못한다. 재시도 시각은 설정, 관리 기본값은 command 팩터리다. 재시도 시각의 규칙은 policy의 값 RetryTiming 하나가 갖고 설정은 그 값을 만든다. retry·routing 값들은 서버가 만드는 값이라 잘못된 값을 IllegalStateException으로 거절한다(manual 06). 모듈 기본값이 role notification-admin에 운영자 permission 넷을 준다(fileserver의 ROLE_FILE_ADMIN과 같다). 버린 대안: 서비스에 @UseCaseCapability만 달기(사용자와 시스템이 같은 진입점을 나눠 써서 권한 규칙이 막지 못한다), 운영자 서비스 삭제, 설정에서 policy를 만들어 버리며 검증하기(규칙이 바뀐 policy bean과 상관없이 남는다). 위험·한계: 공개 타입·생성자·bean 이름·아키텍처 규칙이 바뀐다. 파생 서비스가 할 일은 docs/upgrade/2026-11-round9-application.md 1~3·5·6행이다. claim·fence 커밋 위에 쌓았다. 검증: PR 본문의 desktop 결과. Refs: RR9-05-06, RR9-05-07, RR9-05-08, RR9-05-10, RR9-05-19 BREAKING CHANGE: NotificationAdminService·NotificationAdminApplicationService가 없어지고 운영자 연산은 platform.admin의 RedriveDeliveryUseCase 등이다(permission notification-admin:*). 알림 worker가 composition:notification-platform으로 옮기고 ReconciliationJobWorker·ProviderEventReplayWorker는 유스케이스가 됐다. MessagingReplayBridge 생성자가 조회 유스케이스를 받고 LiveEventReplayPort는 LiveEventReplayQueryPort다. 사용자 전송이 저장·id 포트나 application 서비스 interface를 쥐면 architectureTest가 실패한다. 운영자 요청 record 이름이 *Request로 바뀌고 DefaultNotificationRetryPolicy 생성자가 RetryTiming을 받는다. RetryBackoff·RetryBudget·RetryContext·RetryDecision.RetryAfter·RouteCandidate·RoutingContext·RoutingDecision·EligibilityResult가 잘못된 값에 IllegalStateException을 던진다.
3.4 KiB
3.4 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), 나가는 포트(쓰는 흐름의 패키지에 있다:platform.dispatch·platform.callback·platform.policy·platform.observation·platform.admin·platform.inbox·platform.template·platform.provider·platform.security), 오류 어휘(platform.api.error).port.out패키지는 따로 없다. 나가는 포트 이름은 대개*Port지만 아닌 것도 있다:provider.NotificationProviderAdapter·AttachmentResolver,security.SecretMaterialProvider·ContactPointProtector,template.TemplateRegistry,callback.ProviderEventLedger. 새 포트를 만들기 전에 이 이름들도 찾는다. - 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 필수)은 여기서 한다. 전송이나 설정에서 기본값을 골라 넣지 않는다.
- 시스템이 부르는 쓰기는
@SystemInvoked유스케이스다: 발송 claim·발송(ClaimDueDeliveriesUseCase·DispatchClaimedDeliveryUseCase), lease 회복, provider 결과 맞추기, provider event 다시 투영.composition:notification-platform의 worker가new로 만들어 쥐고, bean으로 두지 않는다. 그 유스케이스가 감싸는 서비스(LeaseRecoveryService·ReconciliationService등)는 bean이지만 inbound가 쥐면 빌드가 실패한다(INBOUND_ADAPTERS_DEPEND_ON_PORTS_NOT_APPLICATION_SERVICES). 언제 다시 묻고 언제 포기하는지는 이 유스케이스가 정한다. worker는 스레드와 일정만 가진다. - 운영자 연산(redrive·reconcile·suppress·provider 상태)은 연산마다
platform.admin의 유스케이스 클래스이고(RedriveDeliveryUseCase등, command는 그 옆),notification-admin:*permission을 선언한다.platform.port.in에 두지 않는다: command가AdminActor같은 운영자 어휘를 실어port.in과admin이 서로를 보게 된다. 운영자 authority와 tenant 범위는 command의AdminActor로 한 번 더 본다. - 공개 타입이 늘면
docs/notification/api-surface-snapshot.txt가 바뀐다(adapter:outbound:notification의verifyNotificationApiSurface가 이 leaf까지 본다).
테스트
./gradlew :application-notification:test --console=plain