refactor: 부가 기능을 capability 모듈로 포장하고 기본 조립을 web-only로 전환
설계: docs/superpowers/specs/2026-09-25-capability-module-packaging-design.md
계획/진행 기록: docs/superpowers/plans/2026-09-25-capability-module-packaging.md
- Wave 0: 규칙 고정(AGENTS.md capability 완료 기준·테스트 규칙) + 차단 결함 7건
(compose overlay 검사, redis-sdk CI job, 적용된 V9/V13 원복 + V16, @EnableScheduling,
messaging bridge 순서, prod 에러 상세 validator, sample loggers read-only)
- Wave 1: 데이터·보안 Critical 10건 (durable operation 25P02, operation 유스케이스 이동,
outbox 재인코딩, Kafka TLS/SASL, 알림 트랜잭션, SNS 서명, tus checksum, GraphQL fragment,
Redis lane, gRPC FAILED_TERMINAL)
- Wave 2: 리팩터링 잔재·실험용 자리 삭제, outbox v1 fencing(V17), 멱등성 V2 정본화
- Wave 3: 라이브러리형 코드 정리(동작하지 않는 설정·인터페이스·gate 제거, web-advanced 분리)
- Wave 4: capability 11개를 "있으면 켜짐" 모듈로 포장, 끄는 장치 제거, 기본 조립 web-only,
qualificationBootJar 분리
- Wave 5: 빌드 로직 축소(17.2k -> 10.8k줄), sample 테스트 컨벤션 적용
삭제한 코드는 docs/capability-status.md "제거된 코드" 표에 복구 커밋(208077fd)과 함께 기록.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
208077fddf
commit
6d27356e2b
@@ -4,6 +4,13 @@
|
||||
|
||||
Accepted (2026-08-15). NTF-018 대응.
|
||||
|
||||
**갱신 (2026-09-25):** R1 type은 삭제됐다. production consumer가 끝까지 0건이었고 fake로만 증명된
|
||||
계약이라, 새 consumer를 막는 ArchUnit 규칙을 유지할 이유가 없어졌다. 남은 것은 adapter core의
|
||||
`RoutingNotifier`가 구현하는 단순 알림 포트 3개(`NotificationPort`, `Notification`,
|
||||
`NotificationChannel`)뿐이다. 그래서 아래 「강제」의 `NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER`
|
||||
규칙과 `compatibility.r1` 예외 패키지도 함께 없어졌다. 삭제 목록과 마지막 커밋은
|
||||
`docs/capability-status.md`의 「제거된 코드」 표에 있다. 아래 본문은 결정 당시 기록이다.
|
||||
|
||||
## 문제
|
||||
|
||||
같은 저장소에 notification 모델이 **두 개** 있다.
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
# NTF-022 — public type surface of the notification platform.
|
||||
# Every top-level public type under the platform packages. Growth is a reviewed
|
||||
# change: ./gradlew updateNotificationApiSurface -PapproveNotificationApiChange
|
||||
# NTF-022 — public type surface of the notification platform (application-notification + adapter:outbound:notification).
|
||||
# Every top-level public type under the platform packages. Growth is a reviewed change.
|
||||
# Update only after review with:
|
||||
# ./gradlew :adapter:outbound:notification:updateNotificationApiSurface -PapproveNotificationApiSurfaceChange
|
||||
# types: 416
|
||||
dev.caskeleton.adapter.outbound.notification.NotificationConfig
|
||||
dev.caskeleton.adapter.outbound.notification.NotificationRoutesSettings
|
||||
dev.caskeleton.adapter.outbound.notification.core.FailOpenNotificationProvider
|
||||
@@ -34,7 +36,6 @@ dev.caskeleton.adapter.outbound.notification.platform.dispatch.ConfiguredProfile
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.CredentialProbe
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.CredentialValidationException
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.JacksonRoutingPlanCodec
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.LeaseRecoveryService
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.LoggingInboxSignalPublisher
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.MapTemplateRendererRegistry
|
||||
dev.caskeleton.adapter.outbound.notification.platform.dispatch.NotificationBackgroundWorkers
|
||||
@@ -120,9 +121,6 @@ dev.caskeleton.adapter.outbound.notification.platform.provider.webpush.WebPushNo
|
||||
dev.caskeleton.adapter.outbound.notification.platform.provider.webpush.WebPushProviderProperties
|
||||
dev.caskeleton.adapter.outbound.notification.platform.provider.webpush.WebPushReceiptCapability
|
||||
dev.caskeleton.adapter.outbound.notification.platform.provider.webpush.WebPushRequestMapper
|
||||
dev.caskeleton.adapter.outbound.notification.platform.reactor.ReactiveNotificationOrchestrator
|
||||
dev.caskeleton.adapter.outbound.notification.platform.reactor.ReactorContextBridge
|
||||
dev.caskeleton.adapter.outbound.notification.platform.reactor.ReactorNotificationOrchestrator
|
||||
dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmCallbackPayloadProtection
|
||||
dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmContactPointProtector
|
||||
dev.caskeleton.adapter.outbound.notification.platform.security.AesGcmNotificationPayloadProtection
|
||||
@@ -147,105 +145,9 @@ dev.caskeleton.adapter.outbound.notification.platform.template.ThymeleafStringTe
|
||||
dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackClient
|
||||
dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackNotificationAdapterConfig
|
||||
dev.caskeleton.adapter.outbound.notification.slack.webhook.SlackWebhookProvider
|
||||
dev.caskeleton.application.notification.ApplyNotificationReceiptCommand
|
||||
dev.caskeleton.application.notification.ApplyNotificationReceiptResult
|
||||
dev.caskeleton.application.notification.ApplyNotificationReceiptUseCase
|
||||
dev.caskeleton.application.notification.ConsentCheckMode
|
||||
dev.caskeleton.application.notification.EmailRecipientReference
|
||||
dev.caskeleton.application.notification.InitializeNotificationWriterFencesCommand
|
||||
dev.caskeleton.application.notification.InitializeNotificationWriterFencesOperation
|
||||
dev.caskeleton.application.notification.InitializeNotificationWriterFencesResult
|
||||
dev.caskeleton.application.notification.InitializeNotificationWriterFencesUseCase
|
||||
dev.caskeleton.application.notification.InlineNotificationAttemptPort
|
||||
dev.caskeleton.application.notification.NormalizedNotificationReceiptCommand
|
||||
dev.caskeleton.application.notification.Notification
|
||||
dev.caskeleton.application.notification.NotificationAdmissionClass
|
||||
dev.caskeleton.application.notification.NotificationAdmissionGateCommand
|
||||
dev.caskeleton.application.notification.NotificationAdmissionGateUseCase
|
||||
dev.caskeleton.application.notification.NotificationAdmissionReadinessPort
|
||||
dev.caskeleton.application.notification.NotificationAppendResult
|
||||
dev.caskeleton.application.notification.NotificationApplicationException
|
||||
dev.caskeleton.application.notification.NotificationAttemptId
|
||||
dev.caskeleton.application.notification.NotificationCanonicalWriterFenceGuard
|
||||
dev.caskeleton.application.notification.NotificationCanonicalWriterFencePort
|
||||
dev.caskeleton.application.notification.NotificationCanonicalWriterRouteSet
|
||||
dev.caskeleton.application.notification.NotificationCapabilityCompatibilityValidator
|
||||
dev.caskeleton.application.notification.NotificationChannel
|
||||
dev.caskeleton.application.notification.NotificationDeliveryId
|
||||
dev.caskeleton.application.notification.NotificationDeliveryStorePort
|
||||
dev.caskeleton.application.notification.NotificationDispatchCommand
|
||||
dev.caskeleton.application.notification.NotificationDispatchResult
|
||||
dev.caskeleton.application.notification.NotificationDispatchUseCase
|
||||
dev.caskeleton.application.notification.NotificationEvidenceTrustSnapshot
|
||||
dev.caskeleton.application.notification.NotificationFaultScope
|
||||
dev.caskeleton.application.notification.NotificationFrozenPlan
|
||||
dev.caskeleton.application.notification.NotificationIntentAppendPort
|
||||
dev.caskeleton.application.notification.NotificationIntentDraft
|
||||
dev.caskeleton.application.notification.NotificationIntentId
|
||||
dev.caskeleton.application.notification.NotificationKindId
|
||||
dev.caskeleton.application.notification.NotificationKindPolicy
|
||||
dev.caskeleton.application.notification.NotificationLegacyWriterPermitCommand
|
||||
dev.caskeleton.application.notification.NotificationLegacyWriterPermitResult
|
||||
dev.caskeleton.application.notification.NotificationLegacyWriterPermitUseCase
|
||||
dev.caskeleton.application.notification.NotificationMaintenanceCommand
|
||||
dev.caskeleton.application.notification.NotificationMaintenanceResult
|
||||
dev.caskeleton.application.notification.NotificationMaintenanceStorePort
|
||||
dev.caskeleton.application.notification.NotificationMaintenanceUseCase
|
||||
dev.caskeleton.application.notification.NotificationMode
|
||||
dev.caskeleton.application.notification.NotificationOperationsSnapshot
|
||||
dev.caskeleton.application.notification.NotificationOperationsSnapshotPort
|
||||
dev.caskeleton.application.notification.NotificationOperationsSnapshotQuery
|
||||
dev.caskeleton.application.notification.NotificationOperationsSnapshotUseCase
|
||||
dev.caskeleton.application.notification.NotificationPlanPort
|
||||
dev.caskeleton.application.notification.NotificationPlanningResult
|
||||
dev.caskeleton.application.notification.NotificationPort
|
||||
dev.caskeleton.application.notification.NotificationProviderAttemptPort
|
||||
dev.caskeleton.application.notification.NotificationProviderCapabilityDescriptor
|
||||
dev.caskeleton.application.notification.NotificationReasonCode
|
||||
dev.caskeleton.application.notification.NotificationReceiptEventId
|
||||
dev.caskeleton.application.notification.NotificationReceiptFact
|
||||
dev.caskeleton.application.notification.NotificationReceiptIngressCapabilityDescriptor
|
||||
dev.caskeleton.application.notification.NotificationReceiptProjection
|
||||
dev.caskeleton.application.notification.NotificationReceiptStorePort
|
||||
dev.caskeleton.application.notification.NotificationRecipientReference
|
||||
dev.caskeleton.application.notification.NotificationReconciliationPort
|
||||
dev.caskeleton.application.notification.NotificationRequestResult
|
||||
dev.caskeleton.application.notification.NotificationRouteId
|
||||
dev.caskeleton.application.notification.NotificationRouteStrategy
|
||||
dev.caskeleton.application.notification.NotificationSignedEvidenceHeader
|
||||
dev.caskeleton.application.notification.NotificationStoreCapabilityDescriptor
|
||||
dev.caskeleton.application.notification.NotificationTechnicalSuppressionPort
|
||||
dev.caskeleton.application.notification.NotificationTemplateParameters
|
||||
dev.caskeleton.application.notification.NotificationTemplateRef
|
||||
dev.caskeleton.application.notification.NotificationTemplateValue
|
||||
dev.caskeleton.application.notification.NotificationWriterCutoverPort
|
||||
dev.caskeleton.application.notification.NotificationWriterInventoryEvidence
|
||||
dev.caskeleton.application.notification.NotificationWriterInventoryEvidenceVerifierPort
|
||||
dev.caskeleton.application.notification.NotificationWriterOwnership
|
||||
dev.caskeleton.application.notification.NotificationWriterQuiescenceAttestationPort
|
||||
dev.caskeleton.application.notification.NotificationWriterRouteSet
|
||||
dev.caskeleton.application.notification.ProviderAttemptOutcome
|
||||
dev.caskeleton.application.notification.ReconcileNotificationDeliveriesCommand
|
||||
dev.caskeleton.application.notification.ReconcileNotificationDeliveriesResult
|
||||
dev.caskeleton.application.notification.ReconcileNotificationDeliveriesUseCase
|
||||
dev.caskeleton.application.notification.RecordNotificationWriterQuiescenceAttestationCommand
|
||||
dev.caskeleton.application.notification.RecordNotificationWriterQuiescenceAttestationOperation
|
||||
dev.caskeleton.application.notification.RecordNotificationWriterQuiescenceAttestationResult
|
||||
dev.caskeleton.application.notification.RecordNotificationWriterQuiescenceAttestationUseCase
|
||||
dev.caskeleton.application.notification.RetryDisposition
|
||||
dev.caskeleton.application.notification.SignedNotificationWriterInventoryManifest
|
||||
dev.caskeleton.application.notification.SignedNotificationWriterQuiescenceManifest
|
||||
dev.caskeleton.application.notification.SlackAudienceReference
|
||||
dev.caskeleton.application.notification.SubmissionCertainty
|
||||
dev.caskeleton.application.notification.SwitchNotificationWriterOwnershipCommand
|
||||
dev.caskeleton.application.notification.SwitchNotificationWriterOwnershipOperation
|
||||
dev.caskeleton.application.notification.SwitchNotificationWriterOwnershipResult
|
||||
dev.caskeleton.application.notification.SwitchNotificationWriterOwnershipUseCase
|
||||
dev.caskeleton.application.notification.TargetAttemptOutcome
|
||||
dev.caskeleton.application.notification.TerminalizeExpiredNotificationWriterPermitsCommand
|
||||
dev.caskeleton.application.notification.TerminalizeExpiredNotificationWriterPermitsOperation
|
||||
dev.caskeleton.application.notification.TerminalizeExpiredNotificationWriterPermitsResult
|
||||
dev.caskeleton.application.notification.TerminalizeExpiredNotificationWriterPermitsUseCase
|
||||
dev.caskeleton.application.notification.platform.admin.AdminAccessDeniedException
|
||||
dev.caskeleton.application.notification.platform.admin.AdminActor
|
||||
dev.caskeleton.application.notification.platform.admin.AdminAuthorizationGuard
|
||||
@@ -280,7 +182,6 @@ dev.caskeleton.application.notification.platform.api.NormalizedEventType
|
||||
dev.caskeleton.application.notification.platform.api.NormalizedProviderEvent
|
||||
dev.caskeleton.application.notification.platform.api.NotificationAcceptance
|
||||
dev.caskeleton.application.notification.platform.api.NotificationId
|
||||
dev.caskeleton.application.notification.platform.api.NotificationOrchestrator
|
||||
dev.caskeleton.application.notification.platform.api.NotificationPlan
|
||||
dev.caskeleton.application.notification.platform.api.NotificationReceipt
|
||||
dev.caskeleton.application.notification.platform.api.NotificationSnapshot
|
||||
@@ -311,31 +212,19 @@ dev.caskeleton.application.notification.platform.api.delivery.DeliveryOutcome
|
||||
dev.caskeleton.application.notification.platform.api.delivery.EvidenceLevel
|
||||
dev.caskeleton.application.notification.platform.api.delivery.RecipientDeliveryState
|
||||
dev.caskeleton.application.notification.platform.api.delivery.SubmissionOutcome
|
||||
dev.caskeleton.application.notification.platform.api.error.AmbiguousSubmissionException
|
||||
dev.caskeleton.application.notification.platform.api.error.AttachmentIntegrityException
|
||||
dev.caskeleton.application.notification.platform.api.error.AttachmentUnavailableException
|
||||
dev.caskeleton.application.notification.platform.api.error.CallbackProjectionException
|
||||
dev.caskeleton.application.notification.platform.api.error.CallbackValidationException
|
||||
dev.caskeleton.application.notification.platform.api.error.FailureCategory
|
||||
dev.caskeleton.application.notification.platform.api.error.IdempotencyConflictException
|
||||
dev.caskeleton.application.notification.platform.api.error.InvalidContactPointException
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationCapacityException
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationException
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationExpiredException
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationFailureCode
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationFailureDescriptor
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationSuppressedException
|
||||
dev.caskeleton.application.notification.platform.api.error.NotificationValidationException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderAuthenticationException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderAuthorizationException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderConfigurationException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderPayloadLimitException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderPermanentException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderRejectedException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderThrottledException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderTransientException
|
||||
dev.caskeleton.application.notification.platform.api.error.ProviderUnavailableException
|
||||
dev.caskeleton.application.notification.platform.api.error.ReconciliationException
|
||||
dev.caskeleton.application.notification.platform.api.error.TemplateNotFoundException
|
||||
dev.caskeleton.application.notification.platform.api.error.TemplateRenderingException
|
||||
dev.caskeleton.application.notification.platform.api.error.TemplateVariableValidationException
|
||||
@@ -378,7 +267,6 @@ dev.caskeleton.application.notification.platform.contact.MobilePushTarget
|
||||
dev.caskeleton.application.notification.platform.contact.PhoneNumber
|
||||
dev.caskeleton.application.notification.platform.contact.WebPushSubscriptionValue
|
||||
dev.caskeleton.application.notification.platform.dispatch.AcceptNotificationApplicationUseCase
|
||||
dev.caskeleton.application.notification.platform.dispatch.ApplicationReceiptServiceImpl
|
||||
dev.caskeleton.application.notification.platform.dispatch.AttachmentIntegrityGuard
|
||||
dev.caskeleton.application.notification.platform.dispatch.CancelNotificationApplicationUseCase
|
||||
dev.caskeleton.application.notification.platform.dispatch.CanonicalNotificationPlanEncoder
|
||||
@@ -393,6 +281,7 @@ dev.caskeleton.application.notification.platform.dispatch.DispatchOutcomeRecorde
|
||||
dev.caskeleton.application.notification.platform.dispatch.DispatchPipeline
|
||||
dev.caskeleton.application.notification.platform.dispatch.DuplicateIdempotencyKeyException
|
||||
dev.caskeleton.application.notification.platform.dispatch.GetNotificationApplicationUseCase
|
||||
dev.caskeleton.application.notification.platform.dispatch.LeaseRecoveryService
|
||||
dev.caskeleton.application.notification.platform.dispatch.MessageDigestPort
|
||||
dev.caskeleton.application.notification.platform.dispatch.NotificationDispatchService
|
||||
dev.caskeleton.application.notification.platform.dispatch.NotificationIdGeneratorPort
|
||||
@@ -423,8 +312,6 @@ dev.caskeleton.application.notification.platform.dispatch.SubmitNotificationAppl
|
||||
dev.caskeleton.application.notification.platform.dispatch.SyntheticEventFingerprint
|
||||
dev.caskeleton.application.notification.platform.dispatch.TemplateRendererRegistry
|
||||
dev.caskeleton.application.notification.platform.dispatch.TenantContextPort
|
||||
dev.caskeleton.application.notification.platform.email.EmailNotification
|
||||
dev.caskeleton.application.notification.platform.email.EmailNotifier
|
||||
dev.caskeleton.application.notification.platform.inbox.CreateInboxItemCommand
|
||||
dev.caskeleton.application.notification.platform.inbox.InboxContentCodecPort
|
||||
dev.caskeleton.application.notification.platform.inbox.InboxCursor
|
||||
@@ -512,35 +399,14 @@ dev.caskeleton.application.notification.platform.provider.ReconciliationCapabili
|
||||
dev.caskeleton.application.notification.platform.provider.ReconciliationResult
|
||||
dev.caskeleton.application.notification.platform.provider.ResolvedAttachment
|
||||
dev.caskeleton.application.notification.platform.provider.TraceContext
|
||||
dev.caskeleton.application.notification.platform.push.ApplicationIdentity
|
||||
dev.caskeleton.application.notification.platform.push.ApplicationReceipt
|
||||
dev.caskeleton.application.notification.platform.push.ApplicationReceiptService
|
||||
dev.caskeleton.application.notification.platform.push.MobilePushNotification
|
||||
dev.caskeleton.application.notification.platform.push.MobilePushNotifier
|
||||
dev.caskeleton.application.notification.platform.push.ReceiptAuthorizationException
|
||||
dev.caskeleton.application.notification.platform.push.ReceiptKind
|
||||
dev.caskeleton.application.notification.platform.push.ReceiptResult
|
||||
dev.caskeleton.application.notification.platform.security.AccessContext
|
||||
dev.caskeleton.application.notification.platform.security.ContactPointProtector
|
||||
dev.caskeleton.application.notification.platform.security.NotificationPayloadProtection
|
||||
dev.caskeleton.application.notification.platform.security.NotificationPayloadUnreadableException
|
||||
dev.caskeleton.application.notification.platform.security.NotificationRedactor
|
||||
dev.caskeleton.application.notification.platform.security.ProtectedContactPoint
|
||||
dev.caskeleton.application.notification.platform.security.SafeDiagnosticContext
|
||||
dev.caskeleton.application.notification.platform.security.SecretKeyMaterial
|
||||
dev.caskeleton.application.notification.platform.security.SecretMaterialProvider
|
||||
dev.caskeleton.application.notification.platform.security.SecretPurpose
|
||||
dev.caskeleton.application.notification.platform.security.SensitiveValueClassifier
|
||||
dev.caskeleton.application.notification.platform.security.SensitiveValueKind
|
||||
dev.caskeleton.application.notification.platform.security.UnsafeDiagnosticFieldException
|
||||
dev.caskeleton.application.notification.platform.sms.E164PhoneNumberParser
|
||||
dev.caskeleton.application.notification.platform.sms.GsmAlphabet
|
||||
dev.caskeleton.application.notification.platform.sms.InvalidPhoneNumberException
|
||||
dev.caskeleton.application.notification.platform.sms.SmsEncoding
|
||||
dev.caskeleton.application.notification.platform.sms.SmsEstimate
|
||||
dev.caskeleton.application.notification.platform.sms.SmsNotification
|
||||
dev.caskeleton.application.notification.platform.sms.SmsNotifier
|
||||
dev.caskeleton.application.notification.platform.sms.SmsSegmentEstimator
|
||||
dev.caskeleton.application.notification.platform.template.NotificationTemplateRenderer
|
||||
dev.caskeleton.application.notification.platform.template.NotificationTemplateVersion
|
||||
dev.caskeleton.application.notification.platform.template.RenderCommand
|
||||
@@ -553,5 +419,3 @@ dev.caskeleton.application.notification.platform.template.TemplateStatus
|
||||
dev.caskeleton.application.notification.platform.template.TemplateVariableValidator
|
||||
dev.caskeleton.application.notification.platform.template.TemplateVersionConflictException
|
||||
dev.caskeleton.application.notification.platform.template.VariableSchema
|
||||
dev.caskeleton.application.notification.platform.webpush.WebPushNotification
|
||||
dev.caskeleton.application.notification.platform.webpush.WebPushNotifier
|
||||
|
||||
@@ -104,7 +104,7 @@ the three they achieved.
|
||||
one thing — `AesGcmCallbackPayloadProtection`, which protects raw callback bodies — and by nothing on
|
||||
the accept path. Demanding it would make a deployment supply a key that protects nothing while the
|
||||
payload it appears to be about stays in plaintext. The repository already has one defect of that
|
||||
exact shape: `backend.graphql.cursor.key-ids`, which production refuses to start without and which no
|
||||
exact shape: `backend.graphql.cursor.key-ids` (key removed 2026-09-25), which production refuses to start without and which no
|
||||
code signs a cursor with (GQL-INT-003). Adding a second would make the pattern a habit.
|
||||
|
||||
## Consequence
|
||||
|
||||
@@ -1,20 +1,25 @@
|
||||
# Configuration reference
|
||||
|
||||
The notification delivery platform binds under `ca-skeleton.notification.platform`. The tree lives in
|
||||
`src/app-bootstrap/src/main/resources/application.yml`, disabled by default, and every value carries
|
||||
an inline default so a deployment that leaves the platform off supplies nothing.
|
||||
`src/composition/notification-platform/src/main/resources/config/module-defaults/notification.yml`,
|
||||
which the support leaf's `ModuleDefaultsEnvironmentPostProcessor` loads at the lowest precedence,
|
||||
so an application without the module carries none of it. The module is in no default composition: a
|
||||
service selects it with `runtimeOnly project(':composition:notification-platform')` (plus the
|
||||
persistence-jpa line) in `app-bootstrap/build.gradle`, and it is on when present. Every value carries
|
||||
an inline default, so a deployment that switches the platform off supplies nothing.
|
||||
|
||||
Until 2026-08-15 this page named properties the binding did not have — `max-retry-concurrency`,
|
||||
`scheduler-poll-interval`, `callback-worker-concurrency` — and omitted three it did. There was no
|
||||
tree in `application.yml` at all, so the only way to configure the platform was to guess environment
|
||||
variable names from Boot's relaxed binding. `./gradlew verifyNotificationConfiguration` now fails
|
||||
when this page, the YAML tree and `docs/registries/env-keys.yaml` disagree.
|
||||
variable names from Boot's relaxed binding. `NotificationEnvironmentRegistryTest`
|
||||
(`:composition:notification-platform:test`) now fails when the shipped YAML and
|
||||
`docs/registries/env-keys.yaml` disagree.
|
||||
|
||||
## Master switch
|
||||
|
||||
| Property | Environment variable | Default | Meaning |
|
||||
|---|---|---|---|
|
||||
| `enabled` | `APP_NOTIFICATION_PLATFORM_ENABLED` | `false` | Binds nothing at all while false: no runtime, no schema check, no scheduler thread, no secret required |
|
||||
| `enabled` | `APP_NOTIFICATION_PLATFORM_ENABLED` | `true` | On while the module is present. `false` binds nothing at all: no runtime, no schema check, no scheduler thread, no secret required |
|
||||
| `mode` | `APP_NOTIFICATION_PLATFORM_MODE` | `SERVING` | `SERVING` refuses to start without a working provider; `INGEST_ONLY` stores requests and does not dispatch |
|
||||
|
||||
## Dispatch
|
||||
@@ -40,7 +45,7 @@ still waiting on gets claimed by a second worker, and the recipient receives the
|
||||
|---|---|---|---|
|
||||
| `callbacks.enabled` | `APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED` | `false` | boolean |
|
||||
| `callbacks.max-body-bytes` | `APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES` | `65508` | 1..65508 |
|
||||
| `callbacks.replay-skew` | `APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW` | `5m` | positive |
|
||||
| `callbacks.replay-skew` | `APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW` | `5m` | positive; SNS messages whose `Timestamp` is further than this from receipt, either way, are rejected |
|
||||
| `callbacks.trusted-proxies` | `APP_NOTIFICATION_PLATFORM_CALLBACK_TRUSTED_PROXIES` | *(empty)* | CSV of peer addresses |
|
||||
|
||||
여러 provider가 요청 URL에 서명하므로, 그 URL을 잘못 재구성하면 정상 webhook이 전부 서명 실패가 된다.
|
||||
@@ -87,6 +92,7 @@ An enabled SES profile adds a typed `ses` block:
|
||||
| `ses.sender-identity` | verified SES From identity |
|
||||
| `ses.access-key-id` | AWS access key id; identifier only, not secret material |
|
||||
| `ses.configuration-set` | optional SES configuration-set name |
|
||||
| `ses.allowed-topic-arns` | SNS topic ARNs whose SES events this profile accepts (`APP_NOTIFICATION_PLATFORM_SES_ALLOWED_TOPIC_ARNS`, comma-separated). Required when `callbacks.enabled=true`: binding fails without it, because a valid SNS signature only proves AWS sent the message and anyone can own a topic |
|
||||
| `credential-profile` | key id for the secret access-key material; generation 1 is activated at assembly |
|
||||
|
||||
The shipped reference profile is `providers.ses` and is disabled by default. It is controlled by
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
"ran no restart, and a provider sandbox job whose entire body was two echo statements behind",
|
||||
"continue-on-error. So the strongest claim in the document rested on the weakest evidence in",
|
||||
"the pipeline, and nothing connected the two.",
|
||||
"verifyNotificationEvidence reads this file, checks that every claim marked satisfied names",
|
||||
"NotificationEvidenceVerifierTest reads this file, checks that every claim marked satisfied names",
|
||||
"test classes that exist, and refuses a grade whose claims are not all satisfied."
|
||||
],
|
||||
"claims": {
|
||||
|
||||
@@ -37,11 +37,9 @@ R1 public type 100개를 어떻게 할 것인지 다루지 않았다. 그래서
|
||||
문서 어디에도 답이 없었다.
|
||||
|
||||
- **canonical은 `..notification.platform..`이다.** NOTIF-ADR-005가 근거와 함께 정한다.
|
||||
- **application R1 public contract는 남지만 새 production consumer를 받지 않는다.** 삭제 계획은
|
||||
별개이며, R0 삭제와 함께 사라지지 않는다.
|
||||
- **application R1 public type은 2026-09-25에 삭제했다.** production consumer가 0건이었다. 남은 것은
|
||||
단순 알림 포트 `NotificationPort`·`Notification`·`NotificationChannel`뿐이다.
|
||||
- R1을 따라 만들어졌지만 composition root에서 한 번도 조립되지 않았던 outbound adapter의
|
||||
`catalog/`, `provider/`, `template/` 실험 구현은 제거했다. 실제 runtime은
|
||||
`catalog/`, `provider/`, `template/` 실험 구현도 제거했다. 실제 runtime은
|
||||
`dev.caskeleton.adapter.outbound.notification.platform..`만 사용한다.
|
||||
- **전수 분류표는 `docs/notification/module-mapping.md`에 있다** (replace / bridge / retain / delete).
|
||||
- **두 namespace 간 production dependency는 0건이며 ArchUnit이 강제한다.** 변환이 필요하면
|
||||
`dev.caskeleton.application.notification.compatibility.r1` 한 곳에만 둔다.
|
||||
- 삭제 목록과 마지막 커밋은 `docs/capability-status.md`의 「제거된 코드」 표에 있다.
|
||||
|
||||
@@ -30,13 +30,9 @@ that owns its responsibility. No public contract, evidence rule, or reliability
|
||||
| `notification-policy` | `application-core` | `…platform.policy` |
|
||||
| `notification-provider-spi` | `application-core` | `…platform.provider` |
|
||||
| `notification-callback-api` | `application-core` | `…platform.callback` |
|
||||
| `notification-email-api` | `application-core` | `…platform.email` |
|
||||
| `notification-sms-api` | `application-core` | `…platform.sms` |
|
||||
| `notification-push-api` | `application-core` | `…platform.push` |
|
||||
| `notification-webpush` (API half) | `application-core` | `…platform.webpush` |
|
||||
| `notification-inbox-api` | `application-core` | `…platform.inbox` |
|
||||
| `notification-admin-api` | `application-core` | `…platform.admin` |
|
||||
| `notification-security` (ports + redaction) | `application-core` | `…platform.security` |
|
||||
| `notification-security` (ports) | `application-core` | `…platform.security` |
|
||||
| `notification-observability` (ports) | `application-core` | `…platform.observation` |
|
||||
| `notification-dispatch-runtime` | `adapter:outbound:notification` | `dev.caskeleton.adapter.outbound.notification.platform.dispatch` |
|
||||
| `notification-security` (AES-GCM/HMAC impl) | `adapter:outbound:notification` | `…platform.security` |
|
||||
@@ -50,12 +46,12 @@ that owns its responsibility. No public contract, evidence rule, or reliability
|
||||
| `notification-webhook-extension` | `adapter:outbound:notification` | `…platform.provider.webhook` |
|
||||
| `notification-observability` (Micrometer impl) | `adapter:outbound:notification` | `…platform.observation` |
|
||||
| `notification-admin-runtime` | `adapter:outbound:notification` | `…platform.admin` |
|
||||
| `notification-reactor` | `adapter:outbound:notification` | `…platform.reactor` |
|
||||
| `notification-spring-boot-starter` | `adapter:outbound:notification` | `…platform.autoconfigure` |
|
||||
| `notification-persistence-jpa` | `adapter:outbound:persistence-jpa` | `dev.caskeleton.adapter.outbound.persistence.notification.platform` |
|
||||
| `notification-inbox-jpa` | `adapter:outbound:persistence-jpa` | `…persistence.notification.platform.inbox` |
|
||||
| `notification-callback-mvc` | `adapter:inbound:web` | `dev.caskeleton.adapter.inbound.web.notification.platform.callback` |
|
||||
| `notification-callback-webflux` | `adapter:inbound:web` | `…callback.reactive` |
|
||||
| `notification-callback-mvc` | `adapter:inbound:web-notification` | `dev.caskeleton.adapter.inbound.web.notification.platform.callback` |
|
||||
| `notification-submission-mvc` | `adapter:inbound:web-notification` | `dev.caskeleton.adapter.inbound.web.notification.platform.submission` |
|
||||
| application composition (use cases, callback bridge, `config/module-defaults/notification.yml`) | `composition:notification-platform` | `dev.caskeleton.composition.notification` |
|
||||
| `notification-testkit` | test source sets of the owning leaves | `…platform.testkit` |
|
||||
|
||||
## Dependency-direction consequences
|
||||
@@ -66,9 +62,11 @@ by the leaf DAG that the registry already enforces:
|
||||
```text
|
||||
application-core (all *-api, provider SPI, policy, callback contracts)
|
||||
↑ ↑ ↑
|
||||
adapter:outbound:notification adapter:outbound:persistence-jpa adapter:inbound:web
|
||||
↑ ↑ ↑
|
||||
app-bootstrap
|
||||
adapter:outbound:notification adapter:outbound:persistence-jpa adapter:inbound:web-notification
|
||||
↑ ↑ (→ adapter:inbound:web)
|
||||
└──────────── composition:notification-platform ────┘
|
||||
↑
|
||||
app-bootstrap (one line)
|
||||
```
|
||||
|
||||
Two plan edges cannot be expressed as project edges in this repository, and are replaced by ports:
|
||||
@@ -111,24 +109,11 @@ reachability is SMTP and SES for dispatch, with SES also available for callback
|
||||
provider packages are extension assets until a composition contributes a `ProviderRuntimeAssembler`
|
||||
with the settings and secret sources that family requires. See `support-matrix.md` for the explicit table.
|
||||
|
||||
## R1 public type disposition (NOTIF-ADR-005)
|
||||
## R1 public types (NOTIF-ADR-005)
|
||||
|
||||
NOTIF-ADR-005 makes `..notification.platform..` canonical and keeps the R1 namespace in place
|
||||
without new consumers. The ADR owns the rule; this table owns the list, so the two do not drift
|
||||
apart by being written twice.
|
||||
|
||||
`NOTIFICATION_R1_AND_PLATFORM_DO_NOT_DEPEND_ON_EACH_OTHER` in `ApplicationBoundaryArchitectureTest` enforces the
|
||||
boundary: production dependencies between the two namespaces are zero, and the only permitted
|
||||
exception is `dev.caskeleton.application.notification.compatibility.r1`.
|
||||
|
||||
| Disposition | Meaning | Types |
|
||||
| --- | --- | --- |
|
||||
| `replace` (27) | the platform has an equivalent; new consumers use it | `ApplyNotificationReceiptCommand`, `ApplyNotificationReceiptResult`, `ApplyNotificationReceiptUseCase`, `Channel`, `InlineNotificationAttemptPort`, `NormalizedNotificationReceiptCommand`, `NotificationAttemptId`, `NotificationDeliveryId`, `NotificationDeliveryStorePort`, `NotificationDispatchCommand`, `NotificationDispatchResult`, `NotificationDispatchUseCase`, `NotificationEvidenceTrustSnapshot`, `NotificationFrozenPlan`, `NotificationPlanPort`, `NotificationPlanningResult`, `NotificationProviderAttemptPort`, `NotificationReceiptEventId`, `NotificationReceiptFact`, `NotificationReceiptIngressCapabilityDescriptor`, `NotificationReceiptProjection`, `NotificationReceiptStorePort`, `NotificationSignedEvidenceHeader`, `NotificationWriterInventoryEvidence`, `NotificationWriterInventoryEvidenceVerifierPort`, `ProviderAttemptOutcome`, `TargetAttemptOutcome` |
|
||||
| `bridge` (28) | conversion needed if an R1 caller remains; conversion lives only in the ACL | `InitializeNotificationWriterFencesCommand`, `InitializeNotificationWriterFencesOperation`, `InitializeNotificationWriterFencesResult`, `InitializeNotificationWriterFencesUseCase`, `NotificationAdmissionGateCommand`, `NotificationAdmissionGateUseCase`, `NotificationAppendResult`, `NotificationLegacyWriterPermitCommand`, `NotificationLegacyWriterPermitResult`, `NotificationLegacyWriterPermitUseCase`, `NotificationMaintenanceCommand`, `NotificationMaintenanceResult`, `NotificationMaintenanceUseCase`, `NotificationOperationsSnapshot`, `NotificationOperationsSnapshotQuery`, `NotificationOperationsSnapshotUseCase`, `NotificationRequestResult`, `ReconcileNotificationDeliveriesCommand`, `ReconcileNotificationDeliveriesResult`, `ReconcileNotificationDeliveriesUseCase`, `SwitchNotificationWriterOwnershipCommand`, `SwitchNotificationWriterOwnershipOperation`, `SwitchNotificationWriterOwnershipResult`, `SwitchNotificationWriterOwnershipUseCase`, `TerminalizeExpiredNotificationWriterPermitsCommand`, `TerminalizeExpiredNotificationWriterPermitsOperation`, `TerminalizeExpiredNotificationWriterPermitsResult`, `TerminalizeExpiredNotificationWriterPermitsUseCase` |
|
||||
| `retain` (45) | a concern the platform does not cover; left as it is | `ConsentCheckMode`, `EmailRecipientReference`, `Notification`, `NotificationAdmissionClass`, `NotificationAdmissionReadinessPort`, `NotificationApplicationException`, `NotificationCanonicalWriterFenceGuard`, `NotificationCanonicalWriterFencePort`, `NotificationCanonicalWriterRouteSet`, `NotificationCapabilityCompatibilityValidator`, `NotificationChannel`, `NotificationFaultScope`, `NotificationIntentAppendPort`, `NotificationIntentDraft`, `NotificationIntentId`, `NotificationKindId`, `NotificationKindPolicy`, `NotificationMaintenanceStorePort`, `NotificationMode`, `NotificationOperationsSnapshotPort`, `NotificationPort`, `NotificationProviderCapabilityDescriptor`, `NotificationReasonCode`, `NotificationRecipientReference`, `NotificationReconciliationPort`, `NotificationRouteId`, `NotificationRouteStrategy`, `NotificationStoreCapabilityDescriptor`, `NotificationTechnicalSuppressionPort`, `NotificationTemplateParameters`, `NotificationTemplateRef`, `NotificationTemplateValue`, `NotificationWriterCutoverPort`, `NotificationWriterOwnership`, `NotificationWriterQuiescenceAttestationPort`, `NotificationWriterRouteSet`, `RecordNotificationWriterQuiescenceAttestationCommand`, `RecordNotificationWriterQuiescenceAttestationOperation`, `RecordNotificationWriterQuiescenceAttestationResult`, `RecordNotificationWriterQuiescenceAttestationUseCase`, `RetryDisposition`, `SignedNotificationWriterInventoryManifest`, `SignedNotificationWriterQuiescenceManifest`, `SlackAudienceReference`, `SubmissionCertainty` |
|
||||
|
||||
Total: 100 public types, every one classified.
|
||||
|
||||
No type carries `@Deprecated(forRemoval = true)`: no removal release is fixed, and
|
||||
`forRemoval` without a date is a promise the codebase cannot keep. The boundary is
|
||||
enforced by the ArchUnit rule instead.
|
||||
NOTIF-ADR-005 made `..notification.platform..` canonical. The R1 types directly under
|
||||
`dev.caskeleton.application.notification` had no production consumer and were removed on
|
||||
2026-09-25, together with the ArchUnit rule that kept the two namespaces apart. What remains there
|
||||
is the simple notification port the adapter core implements — `NotificationPort`, `Notification`,
|
||||
`NotificationChannel`. The removed types and their last commit are listed in
|
||||
`docs/capability-status.md` under "제거된 코드".
|
||||
|
||||
@@ -28,10 +28,8 @@ would turn every historical row into a tag failure at read time.
|
||||
Addresses, tokens, Web Push endpoints and keys, message bodies, template variables, provider
|
||||
credentials, unsubscribe tokens, attachment URLs, raw callback payloads and raw provider request ids.
|
||||
|
||||
Two mechanisms enforce this rather than convention:
|
||||
|
||||
- `CardinalityGuard` validates every metric tag against a closed allowlist.
|
||||
- `SafeDiagnosticContext` rejects any structured-diagnostic field outside its allowlist.
|
||||
`CardinalityGuard` enforces this for metrics rather than convention: it validates every metric tag
|
||||
against a closed allowlist.
|
||||
|
||||
An allowlist rather than a denylist, because the failure mode of a denylist is that the one field
|
||||
nobody thought of is the one that leaks.
|
||||
|
||||
@@ -4,8 +4,8 @@ What each channel can actually prove, and what the platform refuses to claim.
|
||||
|
||||
The grade column is not an opinion. `docs/notification/evidence-manifest.json` declares which claims
|
||||
each grade requires and which executable artifact proves each claim, and
|
||||
`./gradlew verifyNotificationEvidence` refuses a grade whose claims are not all backed by a file that
|
||||
exists. Raising a grade means adding the artifact first.
|
||||
`NotificationEvidenceVerifierTest` (in `:adapter:outbound:notification:test`) refuses a grade whose
|
||||
claims are not all backed by a file that exists. Raising a grade means adding the artifact first.
|
||||
|
||||
Five channels read `Stable` until 2026-08-15. Nothing in the pipeline had ever sent a request to a
|
||||
provider — the sandbox job's whole body was two `echo` statements behind `continue-on-error` — and
|
||||
@@ -32,7 +32,7 @@ implementation is selectable in the default composition. Dispatch reachability i
|
||||
| Provider family | Dispatch assembler in shipped composition | Callback assembler | Current use |
|
||||
|---|---|---|---|
|
||||
| SMTP | **yes** | no | EMAIL dispatch reference family |
|
||||
| SES | **yes** | **yes** | EMAIL dispatch + SNS callback ingestion; disabled reference profile ships in `config/notification.yml` |
|
||||
| SES | **yes** | **yes** | EMAIL dispatch + SNS callback ingestion; disabled reference profile ships in `config/module-defaults/notification.yml` (`composition:notification-platform`) |
|
||||
| Twilio | no | no | contract implementation / extension wiring |
|
||||
| FCM | no | no | contract implementation / extension wiring |
|
||||
| APNs | no | no | contract implementation / extension wiring |
|
||||
|
||||
Reference in New Issue
Block a user