# README 가 적은 세 문장 README.md:7 허용/금지 의존 정책은 `src/build.gradle` 의 README.md:8 `allowedProjectDependencies['adapter:outbound:support']` 항목이 SSOT 다(이 모듈은 아직 별도 README.md:9 CLAUDE.md 를 두지 않았다). 이 문서는 코드 주석에서 덜어낸 **설계 결정의 근거**를 모아둔 참조용 README.md:10 기록이다 — 코드를 읽다 "왜 이렇게 했나"가 궁금할 때 본다. README.md:11 README.md:20 README.md:21 실패를 ERROR 가 아니라 WARN 으로 로깅한다: cache/messaging/notification 선택형 어댑터는 README.md:22 fail-open 이라 의존성 실패가 나도 use case 는 성공한 것이다 — 관측은 하되 escalate 하지 않는다. README.md:23 이는 호출자에게 직접 노출되는 hard failure 를 ERROR 로 올리는 `httpclient` 모듈의 README.md:24 `OutboundHttpDependencyLogger` 와 명확히 구분된다. 메서드 시그니처가 본문·수신자·페이로드를 README.md:25 받지 않아 PII 가 로그에 닿지 않는다. README 의 커밋 이력 : 821fe00c 2026-07-24 init: 클린 아키텍처 백엔드 # 두 파일이 언제 태어났는가 C b3add016 2026-07-28 feat: redis, fileserver, httpclient 런타임 시점 구현 추가 M src/adapter/outbound/support/CLAUDE.md C 821fe00c 2026-07-24 init: 클린 아키텍처 백엔드 A src/adapter/outbound/support/CLAUDE.md A src/adapter/outbound/support/README.md README 가 쓰인 커밋의 레지스트리 위치 : build.gradle@821fe00c:558 File moduleRegistryFile = new File(rootProject.projectDir.parentFile, '.harness/project/modules.yaml') modules.json 이 들어온 커밋 : b3add016 2026-07-28 feat: redis, fileserver, httpclient 런타임 시점 구현 추가 # 1. 의존 정책의 정본이 어디인가 src/build.gradle 에서 그 이름이 나오는 줄 : 3 개 (전부) src/build.gradle:1419 Map> allowedProjectDependencies = registry.modules.collectEntries { module -> src/build.gradle:1430 Set governedModules = allowedProjectDependencies.keySet() src/build.gradle:1448 allowedProjectDependencies.each { moduleName, allowed -> modules.json:41 "id": "adapter-outbound-support", modules.json:42 "gradle_path": ":adapter:outbound:support", modules.json:43 "source_path": "src/adapter/outbound/support", modules.json:44 "allowed_dependencies": [ modules.json:45 "domain-core", modules.json:46 "application-core", modules.json:47 "shared-contract" modules.json:48 ], modules.json:49 "runtime_memberships": [ modules.json:50 "app-bootstrap" modules.json:51 ] modules.json:52 }, # 2. 이 모듈에 CLAUDE.md 가 있는가 src/adapter/outbound/support/CLAUDE.md src/adapter/outbound/support/README.md support/CLAUDE.md:1 # adapter:outbound:support — shared outbound support support/CLAUDE.md:2 support/CLAUDE.md:3 ## Registered identity support/CLAUDE.md:4 support/CLAUDE.md:5 - Module ID: `adapter-outbound-support` support/CLAUDE.md:6 - Gradle path: `:adapter:outbound:support` support/CLAUDE.md:7 - Focused test (derived from Gradle path): `./gradlew :adapter:outbound:support:test --console=plain` support/CLAUDE.md:8 - Runtime baseline: Java 21; repository framework baseline: Spring Boot 4.0.0. support/CLAUDE.md:9 - Registry SSOT: `src/config/architecture/modules.json`. support/CLAUDE.md:10 CLAUDE.md 의 커밋 이력 : b3add016 2026-07-28 feat: redis, fileserver, httpclient 런타임 시점 구현 추가 821fe00c 2026-07-24 init: 클린 아키텍처 백엔드 # 3. httpclient 쪽 로거의 이름 OutboundHttpDependencyLogger 를 가진 파일 : 0 개 httpclient main 의 이름에 Logger 가 든 파일 : 0 개 httpclient main 에서 org.slf4j 를 import 하는 파일 : 0 개 httpclient main 의 log.error 호출 : 0 줄 [자기시험] 없는 이름 OutboundHttpDependencyLoggerZZZ : 0 개 [대조] FailOpenDependencyLogger : 12 개 그 이름의 이력 : C 5f10b791 2026-08-11 chore: record pre-existing uncommitted repository state D src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/diagnostics/OutboundHttpDependencyLogger.java D src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/diagnostics/OutboundHttpDependencyLoggerTest.java C 821fe00c 2026-07-24 init: 클린 아키텍처 백엔드 A src/adapter/outbound/httpclient/src/main/java/dev/caskeleton/adapter/outbound/httpclient/diagnostics/OutboundHttpDependencyLogger.java A src/adapter/outbound/httpclient/src/test/java/dev/caskeleton/adapter/outbound/httpclient/diagnostics/OutboundHttpDependencyLoggerTest.java # 4. README 가 PII 에 대해 적은 것과 로거가 실제로 적는 것 README.md:24 `OutboundHttpDependencyLogger` 와 명확히 구분된다. 메서드 시그니처가 본문·수신자·페이로드를 README.md:25 받지 않아 PII 가 로그에 닿지 않는다. FailOpenDependencyLogger.java:36 /** WARN: fail-open adapter — the use case still succeeded, so this is not an ERROR. */ FailOpenDependencyLogger.java:37 public void logFailure( FailOpenDependencyLogger.java:38 String dependencyName, String dependencyType, String operation, Throwable cause) { FailOpenDependencyLogger.java:39 log.warn( FailOpenDependencyLogger.java:40 "dependency_name=\"{}\" dependency_type=\"{}\" operation=\"{}\" " FailOpenDependencyLogger.java:41 + "outcome=\"FAILURE\" correlation_id=\"{}\" error=\"{}: {}\"", FailOpenDependencyLogger.java:42 dependencyName, FailOpenDependencyLogger.java:43 dependencyType, FailOpenDependencyLogger.java:44 operation, FailOpenDependencyLogger.java:45 OutboundCorrelation.current(), FailOpenDependencyLogger.java:46 cause.getClass().getSimpleName(), FailOpenDependencyLogger.java:47 cause.getMessage()); FailOpenDependencyLogger.java:48 }