donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Files
fc2366087117efb0acff4bbd2e4c3d684fa7253f
document-haness/docs/clean-architecture-backend-template/final/evidence/raw/018-adapter-outbound-support-duplicate-mechanisms.txt
T
DongHyeonkaandClaude Opus 5 b2963105a8 docs(keycloak-session-store): import the session-storage lab as a new project 
The keycloak project ended with four open questions that design could not
settle. A two-VM lab was built to answer them by measurement, and this is
that material: 26 experiments, 125 raw command outputs, 22 browser captures.

Follows the import procedure in README.md.

  source/     the originating repository verbatim — 78 documents, 28 SVGs,
              8 manifests, plus .source-revision recording the commit
  final/      the SSOT
    document.md   729 lines written from the 29 experiment documents, not
                  concatenated: what was predicted, what was measured, and
                  where the measurement itself was wrong
    evidence/raw    125 outputs, flattened to <experiment>__<file> because
                    the originals collided (01-baseline.txt appeared three
                    times) and the audit only globs the top level
    evidence/meta   one per raw file; command and exitCode are null and the
                    README says why rather than inventing them
    evidence/browser  22 captures
    assets/       three diagrams through techviz
    .techviz/     their VizSpecs

A separate project rather than an addition to keycloak: the B-layer answers
that project's four questions, but the A, C and D layers are about cluster
failure, SSO and operations, and one document.md should hold one subject.
The four question records there can point here through 관계.

Recorded rather than papered over: only three of the 28 diagrams were
remade. The repository forbids hand-drawn SVG and forbids titles inside the
canvas; all 28 originals carry both, so converting them is redrawing, not
reformatting. They stay in source/ and the gap is written into the document.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 22:51:59 +09:00

88 lines
14 KiB
Plaintext
Raw Blame History

Command: printf '%s\n' '--- support imports in production ---'; git grep -n 'dev\.caskeleton\.adapter\.outbound\.support' -- 'src/**/src/main/java/**/*.java' ':!src/adapter/outbound/support/**'; echo "support-import-exit=$?"; printf '%s\n' '--- dependency logger names ---'; git grep -n -E 'FailOpenDependencyLogger|OutboundHttpDependencyLogger|DependencyLogger|dependency_name=' -- 'src/adapter/outbound/**' ':!src/adapter/outbound/support/build/**'; echo "logger-search-exit=$?"; printf '%s\n' '--- correlation implementations/usages ---'; git grep -n -E 'OutboundCorrelation|MDC\.get\(|correlation_id' -- 'src/adapter/outbound/**/src/main/java/**/*.java'; echo "correlation-search-exit=$?"
Working directory: /shared/codebase/clean-architecture-backend-template
Executed at: 2026-08-29T07:19:26Z
Source revision: a24ece9cf797f7ea647e33bf846b115208ed1ba5
Observation boundary: Searches current outbound production sources and docs for dependency-logger/correlation/fail-open mechanisms and direct support imports; matches require semantic comparison before being called duplicates.
--- stdout/stderr ---
--- support imports in production ---
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/MessagingConfig.java:10:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisher.java:3:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationConfig.java:6:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java:3:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
support-import-exit=0
--- dependency logger names ---
src/adapter/outbound/messaging/CLAUDE.md:71: `FailOpenDependencyLogger`.
src/adapter/outbound/messaging/README.md:42:로깅하고 삼켜(→ `:adapter:outbound:support` 의 `FailOpenDependencyLogger`) outbox/retry 로
src/adapter/outbound/messaging/README.md:68:`dependency_name=disabled`를 쓴다. 이 adapter는 confirmed FAILED/DEAD report 하나를 SLF4J 2 fluent
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/MessagingConfig.java:10:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/MessagingConfig.java:33: FailOpenDependencyLogger dependencyLogger) {
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisher.java:3:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisher.java:19: private final FailOpenDependencyLogger dependencyLogger;
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisher.java:21: public OutboundMessagePublisher(MessageBroker broker, FailOpenDependencyLogger dependencyLogger) {
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/MessagingConfigTest.java:11:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/MessagingConfigTest.java:21: .withBean(FailOpenDependencyLogger.class, FailOpenDependencyLogger::new)
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisherTest.java:9:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisherTest.java:28: private FailOpenDependencyLogger dependencyLogger;
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisherTest.java:37: dependencyLogger = new FailOpenDependencyLogger(logbackLogger);
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisherTest.java:106: .contains("dependency_name=\"kafka\"")
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/core/OutboundMessagePublisherTest.java:138: new OutboundMessagePublisher(broker, new FailOpenDependencyLogger(throwingLogger));
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapterTest.java:11:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/messaging/src/test/java/dev/caskeleton/adapter/outbound/messaging/outbox/OutboxMessagePublishAdapterTest.java:143: (ch.qos.logback.classic.Logger) LoggerFactory.getLogger(FailOpenDependencyLogger.class);
src/adapter/outbound/notification/README.md:51:`:adapter:outbound:support` 의 `FailOpenDependencyLogger` 로 WARN 로깅). 라우팅은
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationConfig.java:6:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationConfig.java:33: FailOpenDependencyLogger failOpenDependencyLogger) {
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/NotificationConfig.java:36: .map(p -> new FailOpenNotificationProvider(p, failOpenDependencyLogger))
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java:3:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java:17: private final FailOpenDependencyLogger dependencyLogger;
src/adapter/outbound/notification/src/main/java/dev/caskeleton/adapter/outbound/notification/core/FailOpenNotificationProvider.java:20: NotificationProvider delegate, FailOpenDependencyLogger dependencyLogger) {
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java:10:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java:47: private FailOpenDependencyLogger dependencyLogger;
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java:56: dependencyLogger = new FailOpenDependencyLogger(logbackLogger);
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java:113: .contains("dependency_name=\"google-email\"")
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/NotificationAdapterTest.java:145: .contains("dependency_name=\"slack-webhook\"")
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java:10:import dev.caskeleton.adapter.outbound.support.FailOpenDependencyLogger;
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java:55: private FailOpenDependencyLogger dependencyLogger;
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java:64: dependencyLogger = new FailOpenDependencyLogger(logbackLogger);
src/adapter/outbound/notification/src/test/java/dev/caskeleton/adapter/outbound/notification/core/RoutingNotifierTest.java:169: .contains("dependency_name=\"google-email\"")
src/adapter/outbound/support/README.md:19:## FailOpenDependencyLogger — WARN, ERROR 아님
src/adapter/outbound/support/README.md:24:`OutboundHttpDependencyLogger` 와 명확히 구분된다. 메서드 시그니처가 본문·수신자·페이로드를
src/adapter/outbound/support/README.md:34:`FailOpenDependencyLogger` 빈을 `@ConditionalOnMissingBean` 으로 무조건 등록하는 단일
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:13:public final class FailOpenDependencyLogger {
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:17: public FailOpenDependencyLogger() {
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:18: this(LoggerFactory.getLogger(FailOpenDependencyLogger.class));
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:22: public FailOpenDependencyLogger(Logger log) {
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:28: "dependency_name=\"{}\" dependency_type=\"{}\" operation=\"{}\" "
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:40: "dependency_name=\"{}\" dependency_type=\"{}\" operation=\"{}\" "
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundSupportConfig.java:8: * Unconditionally registers the shared log/error contract bean ({@link FailOpenDependencyLogger})
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundSupportConfig.java:17: public FailOpenDependencyLogger failOpenDependencyLogger() {
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundSupportConfig.java:18: return new FailOpenDependencyLogger();
src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:14:class FailOpenDependencyLoggerTest {
src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:18: private FailOpenDependencyLogger dependencyLogger;
src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:28: dependencyLogger = new FailOpenDependencyLogger(logbackLogger);
src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:48: .contains("dependency_name=\"kafka\"")
src/adapter/outbound/support/src/test/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLoggerTest.java:84: .contains("dependency_name=\"slack\"")
logger-search-exit=0
--- correlation implementations/usages ---
src/adapter/outbound/messaging/src/main/java/dev/caskeleton/adapter/outbound/messaging/outbox/Slf4jOutboxRelayFailureReportAdapter.java:52: .addKeyValue("correlation_id", report.correlationId())
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/NotificationRequestEntity.java:73: @Column(name = "correlation_id", length = 160)
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/notification/platform/NotificationRequestJpaRepository.java:53: + " schedule_at, not_before, expires_at, request_status, correlation_id,"
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/outbox/entity/OutboxEventEntity.java:49: @Column(name = "correlation_id", nullable = false, length = 64, updatable = false)
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java:103: correlation_id,
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java:128: event.correlation_id,
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlImmutableOutboxAppendAdapter.java:286: resultSet.getString("correlation_id"),
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java:148: event.correlation_id,
src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/postgresql/outbox/PostgreSqlPollingDeliveryAdapter.java:413: resultSet.getString("correlation_id"),
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:29: + "outcome=\"SUCCESS\" correlation_id=\"{}\"",
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:33: OutboundCorrelation.current());
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:41: + "outcome=\"FAILURE\" correlation_id=\"{}\" error=\"{}: {}\"",
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/FailOpenDependencyLogger.java:45: OutboundCorrelation.current(),
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundCorrelation.java:6: * Reads the {@code correlation_id} from the SLF4J MDC for outbound adapter logging. The MDC key
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundCorrelation.java:11:public final class OutboundCorrelation {
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundCorrelation.java:13: /** MDC key SSOT (docs/registries/mdc-keys.yaml — key: correlation_id). */
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundCorrelation.java:14: public static final String MDC_KEY = "correlation_id";
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundCorrelation.java:19: private OutboundCorrelation() {}
src/adapter/outbound/support/src/main/java/dev/caskeleton/adapter/outbound/support/OutboundCorrelation.java:23: String value = MDC.get(MDC_KEY);
correlation-search-exit=0
Exit code: 0
Reference in New Issue View Git Blame Copy Permalink