review-followup Wave 3 라운드 2(P25): core 죽은 표면·web·GraphQL·WebSocket·sample 구조, 소유자 결정 32 기록

- 삭제: core 죽은 계약 타입·opstore·rate-limit disabled·GraphQL 병렬 HTTP envelope·sample legacy 포스터 업로드 모드
- durable operation이 `CommandUseCase` 구현, 알림 템플릿 버전·locale 기본값을 설정으로(`APP_NOTIFICATION_PLATFORM_DEFAULT_LOCALE`=ko-KR),
  `GraphQlPlatformAutoConfiguration` 기능별 분해, STOMP broker executor, startup 예외 하나, profile reader ArchUnit 확대
- web 보안 root 분리, sample scan을 sample 패키지로(NEW-10d·S6-#8 — 새 web controller가 sample에 등록되지 않음)
- sample 정렬 이름·요청 파싱 helper·게시 파라미터 record·reconcile은 명시 명령(P14-new-3)
- 통합: P24와 겹친 sample 포스터 설정은 P24 쪽(`PosterImageApiSettings` DISABLED/PUBLICATION 검증) 유지
- 현황표: 소유자 결정 32(fileserver 권한 추가), S1-#6b·S1-#18b·S6-#10a를 P28로

검증: ./gradlew check architectureCheck verifyDependencyLocks verifyPublicPathSnapshot :app-bootstrap:verifyEnvKeys
:sample-portfolio:integrationTest :sample-portfolio:systemTest :app-bootstrap:integrationTest --continue 통과(657 task)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
donghyeon-ka
2026-09-28 17:33:10 +09:00
co-authored by Claude Opus 5.5
parent 64a8391889
commit 25de288ab4
169 changed files with 2410 additions and 2257 deletions
@@ -56,7 +56,7 @@ runtimeOnly project(':composition:notification-platform') // 알림
| 항상 (키 7종과 각 키 id, 32바이트 이상 base64, 서로 달라야 함) | `APP_NOTIFICATION_PLATFORM_{CONTACT_ENCRYPTION,CONTACT_LOOKUP_HMAC,CALLBACK_SIGNING,PROVIDER_CREDENTIAL,PAYLOAD_ENCRYPTION,PROVIDER_REQUEST_LOOKUP_HMAC,CALLBACK_FINGERPRINT_HMAC}_KEY`, 같은 이름 + `_ID` |
| SMTP provider | `APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true`, `APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY`, `SPRING_MAIL_HOST`, `SPRING_MAIL_PORT`, `SPRING_MAIL_USERNAME`, `SPRING_MAIL_PASSWORD` |
| SES provider | `APP_NOTIFICATION_PLATFORM_SES_ENABLED=true`, `APP_NOTIFICATION_PLATFORM_SES_SENDER_IDENTITY`, `APP_NOTIFICATION_PLATFORM_SES_ACCESS_KEY_ID`, `APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID`, `APP_NOTIFICATION_PLATFORM_SES_REGION` |
| provider 콜백 | `APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED=true`, SES는 `APP_NOTIFICATION_PLATFORM_SES_ALLOWED_TOPIC_ARNS`, 프록시 뒤라면 `APP_NOTIFICATION_PLATFORM_CALLBACK_TRUSTED_PROXIES` |
| provider 콜백 | `APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED=true`, SES는 `APP_NOTIFICATION_PLATFORM_SES_ALLOWED_TOPIC_ARNS`, 프록시 뒤라면 `APP_SERVER_FORWARD_HEADERS_STRATEGY=native` + `server.tomcat.remoteip.internal-proxies`(콜백 전용 프록시 목록은 없다) |
나머지(발송 배치 크기, lease, 준비 상태 임계값 등)는 기본값으로 동작한다. 설명은
`docs/notification/configuration-reference.md`.
@@ -28,6 +28,8 @@ import dev.caskeleton.application.notification.platform.security.ContactPointPro
import dev.caskeleton.application.notification.platform.template.TemplateRegistry;
import dev.caskeleton.application.transaction.TransactionPort;
import java.time.Clock;
import java.util.Locale;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@@ -86,9 +88,18 @@ class NotificationSubmissionConfiguration {
NotificationIdGeneratorPort ids,
RequestFingerprint fingerprints,
TransactionPort transactions,
Clock clock) {
Clock clock,
@Value("${ca-skeleton.notification.platform.default-locale:ko-KR}") String defaultLocale) {
return new AcceptNotificationApplicationUseCase(
submit, contactPoints, protector, tenants, ids, fingerprints, transactions, clock);
submit,
contactPoints,
protector,
tenants,
ids,
fingerprints,
transactions,
clock,
Locale.forLanguageTag(defaultLocale.trim()));
}
/**
@@ -28,6 +28,9 @@ ca-skeleton:
# SERVING | INGEST_ONLY. SERVING refuses to start without a working provider; INGEST_ONLY
# stores requests and does not dispatch, which is the shape a migration or a drain wants.
mode: ${APP_NOTIFICATION_PLATFORM_MODE:SERVING}
# BCP 47 tag a submission that names no locale is rendered in. A deployment setting rather
# than the host JVM's default, so the same request renders the same on every node.
default-locale: ${APP_NOTIFICATION_PLATFORM_DEFAULT_LOCALE:ko-KR}
dispatch:
claim-batch-size: ${APP_NOTIFICATION_PLATFORM_CLAIM_BATCH_SIZE:50}
# The lease must outlast a provider call plus its timeout, or a live worker's delivery is
@@ -59,12 +62,9 @@ ca-skeleton:
# is refused at binding rather than at the database, after the callback was acknowledged.
max-body-bytes: ${APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES:65508}
replay-skew: ${APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW:5m}
# Peers whose Forwarded/X-Forwarded-* headers may be believed when reconstructing the URL a
# provider signed. Empty by default, and that is the safe default rather than the convenient
# one: with no entry the resolver uses what the container observed, so no caller can choose
# the URL its own signature is checked against. A deployment behind a load balancer lists its
# proxies here.
trusted-proxies: ${APP_NOTIFICATION_PLATFORM_CALLBACK_TRUSTED_PROXIES:}
# The URL a provider signed is rebuilt from what the container reports. Behind a load
# balancer set APP_SERVER_FORWARD_HEADERS_STRATEGY=native and name the proxies in
# server.tomcat.remoteip.internal-proxies; there is no callback-specific proxy list.
# Provider profiles, keyed by profile id. None by default: an empty map with mode=SERVING is
# refused at startup, which is the intended outcome for "enabled but not configured".
#