Files
DongHyeonka 75df7615e5 fix(logging)!: 로그 줄이 원본 경로·SQL을 싣지 않고 감사 줄을 버리지 않게 한다
로그 줄이 남기지 말아야 할 값을 싣고, 남겨야 할 줄을 버린다. 401·403
보안 WARN, route를 못 찾은 요청 로그, 처리하지 못한 예외 ERROR가 원본
request URI(식별자·토큰이 든 경로)를 싣는다. outbox relay·파일 서버 정리
스케줄러는 실패를 통째로 남겨 SQL·제약 이름·값이 원인 사슬로 따라간다.
SamplingTurboFilter는 INFO 이하를 logger 구분 없이 표본으로 버려 감사
logger의 INFO 줄도 사라진다. JSON 로그 profile 칸은 Logback이 처음 읽은
환경 변수 값이라 Spring이 해석한 profile과 다를 수 있다. HeaderSanitizer는
운영 코드가 부르지 않는 공개 유틸리티로 남아 있다.

- LoggedPath: route template이 있으면 그것, 없으면 식별자가 들 수 있는
  마디를 {}로 가린 경로. 세 줄이 모두 쓴다. 버린 안: 원본 URI 그대로 두고
  문서로 경고(로그 수집기가 이미 받는다).
- 스케줄러 실패는 새 ServerFailureLog.forBackgroundTask로 남긴다: 분류된
  persistence 실패는 원인 사슬 없이, 그 밖의 carrier는 client 쪽 코드여도
  stack과 함께(요청이 없으니 결함이다). composition:outbox-relay에
  shared-contract edge를 더한다(gradle/modules.json).
- SamplingTurboFilter는 AUDIT marker와 이름 끝 마디가 audit·security인
  logger를 표본에서 뺀다(이름별 판정은 캐시).
- ResolvedProfileJsonProvider가 줄을 쓸 때의 해석된 profile을 쓴다.
- HeaderSanitizer와 시험을 지우고 capability-status 제거 표에 적는다.

위험: 경로를 보던 로그 검색이 가린 경로를 본다. 감사 줄이 표본에서 빠져
양이 늘 수 있다. docs/upgrade/2026-11-round9-observability.md 1~5행.

검증: desktop에서 바뀐 leaf check·:app-bootstrap:test·systemTest·
documentContractTest·repositoryContractTest, scripts/verify.sh pr rc=0
(묶음 셋을 합친 트리). 새 시험은 고치기 전 트리에서 실패했다(RED).

Refs: RR9-02-09, RR9-02-15, RR9-02-21, RR9-02-22, RR9-02-26
BREAKING CHANGE: 보안·요청·예외 로그 줄의 경로 값과 JSON profile 칸의 출처,
  HeaderSanitizer 삭제. docs/upgrade/2026-11-round9-observability.md 1~5행.
2026-11-13 13:12:09 +09:00
..

gradle/ — 빌드가 고정하는 것

이 폴더에는 빌드가 버전과 목록을 고정하는 파일만 둔다. Gradle 루트(저장소 루트)의 표준 자리다.

파일 고정하는 것 읽는 곳
wrapper/ Gradle 버전과 배포본 해시 gradlew
libs.versions.toml 프로젝트 밖 의존: 라이브러리·플러그인 버전 Gradle 버전 카탈로그(libs.*), build-logic/settings.gradle
modules.json 프로젝트 안 의존: leaf 목록(id, Gradle 경로, 폴더)과 허용 edge settings 플러그인 ca.architecture-registry, 방향 검사, scripts/ 검사
container-images.properties 시험이 띄우는 컨테이너 이미지(digest 고정) ca.java-conventions가 시험 JVM에 ca.test.image.*로 넘긴다

registry와 이미지 목록은 버전 카탈로그와 같은 종류라 여기에 둔다: 카탈로그가 밖에서 받는 것을, registry가 안에서 서로 쓰는 것을, 이미지 목록이 시험이 띄우는 것을 고정한다. config/는 코드 검사 도구 설정(checkstyle, spotbugs)만 둔다.

이력: 2026-11-11 저장소 재배치 전에는 registry가 src/config/architecture/, 이미지 목록이 src/config/testing/에 있었다(docs/upgrade/2026-11-relayout.md).

아키텍처 모듈 registry(modules.json)

Gradle 경로와 폴더는 다르다. :app-bootstrap은 src/bootstrap/app, :application-core는 src/application/core, :composition:outbox-relay는 src/bootstrap/outbox-relay에 있다. 폴더를 찾을 때는 source_path를, 명령을 쓸 때는 gradle_path를 읽는다.

modules.json은 Gradle 프로젝트의 정체(id, Gradle 경로, 소스 경로)와 각 leaf가 볼 수 있는 운영 프로젝트 edge를 정확히 적는다. 빈 allowed_dependencies 목록에도 뜻이 있다: 그 leaf가 일부러 다른 프로젝트에 기대지 않는다는 뜻이지, registry 항목을 덜 채웠다는 뜻이 아니다.

domain-core, shared-contract가 그 예다. 빈 목록은 분명한 경계이고, 실제 프로젝트 edge를 들여와 리뷰하기 전까지 비어 있어야 한다. 반대로 목록에 적힌 edge는 빌드가 실제로 쓰는 것과 맞아야 한다. 예를 들어 adapter-outbound-persistence-mongo의 목록은 ["application-core", "shared-contract"]이고 MongoRegistryPermissionParityTest가 두 방향을 모두 본다.

런타임 조립 구성원은 빌드 로직이 해석된 runtime classpath에서 얻는다. 이 registry에 모듈마다 칸으로 다시 적지 않는다.

별도 repo 라이브러리: library_groups와 allowed_libraries

소유자가 다른 repo에서 배포하는 라이브러리(메시징 dev.cakit.messaging, gRPC dev.cakit.grpc)는 이 빌드의 프로젝트가 아니라 외부 좌표다. 그래서 프로젝트 edge 규칙(allowed_dependencies)이 보지 못한다. 그 빈자리를 두 칸이 메운다(설계 design-docs repo-structure/05-library-repos.md 10.2절 T2, 소유자 승인 2026-11-07).

  • 맨 위 library_groups: 다스릴 라이브러리의 Maven group 접두사. 지금 ["dev.cakit"]이다. 이 접두사와 같거나 그 아래(dev.cakit. 다음) group만 다스린다. 다른 group(Spring, Kafka client 등)은 이 칸과 상관없다.
  • 행마다 선택 칸 allowed_libraries: 그 leaf가 쓸 수 있는 라이브러리 모듈의 group:artifact 목록. 없으면 빈 목록과 같다. 값은 library_groups 안의 group이어야 하고 겹치면 안 된다(registry를 읽을 때 거절).
  • 방향 검사(verifyModuleDependencyDirection, verifyCleanArchitectureDependencies 아래)는 프로젝트 edge와 같은 방식으로 대조한다: 운영 선언(api·implementation·compileOnly·runtimeOnly)의 소유 group 좌표와, compileClasspath에서 보이는 소유 group 모듈(라이브러리 모듈이 api로 내보낸 것 포함)이 모두 칸에 있어야 한다. 시험 구성은 보지 않는다.
  • 그래서 지금 지키는 약속 셋이 검사로 남는다: bridge(adapter-outbound-messaging)는 messaging-core-api만 본다. Kafka capability(adapter-outbound-messaging-kafka)는 starter-kafka를 runtimeOnly로만 싣는다. 계층 leaf는 칸이 비어 있으니 라이브러리를 쓸 수 없다.