refactor(platforms)!: 메시징 플랫폼을 messaging-library 1.0.0으로 받고 지운다 #8

Merged
donghyeon.kang merged 4 commits from claude/x3-messaging-library-1aa3fa into main 2026-11-08 13:19:46 +00:00
Owner

무엇을, 왜

소유자 결정(2026-11-07): 템플릿 안에 프로젝트 계층이 아닌 라이브러리를 두지 않는다. 별도 repo로 관리하고 템플릿은 버전으로 받는다. gRPC는 앞 PR(#6)에서 옮겼고, 이번은 메시징이다.

  • 메시징 플랫폼(src/platforms/messaging, 19개 모듈)은 이력째 messaging-library로 옮겨 dev.cakit.messaging 1.0.0으로 Gitea Packages에 게시했다(태그 v1.0.0, release run 28).
  • 템플릿은 그 버전을 받는다: src/settings.gradle의 exclusiveContent 저장소(group dev.cakit와 그 아래만), 카탈로그 messagingLibrary = "1.0.0"과 모듈 여섯, 쓰는 leaf의 project(':messaging:…')을 좌표로, import dev.caskeleton.messaging → dev.cakit.messaging.
  • 지운 것: src/platforms/messaging과 빈 src/platforms/, registry 19행, messaging-certification.yml, 카탈로그의 메시징 전용 항목(avro, cloudevents, protobuf 4.33.2), SpotBugs 제외의 메시징 줄, docs/messaging/, check-repo-layout.py의 platforms. 지운 경로는 docs/upgrade/2026-11-maturity-review.md B-57~B-59.
  • registry가 라이브러리 edge를 계속 막게 했다: 맨 위 library_groups, 행마다 allowed_libraries(설계 Q11 T2). 분리 전 프로젝트 edge 검사가 지키던 약속(bridge는 core-api만, Kafka capability는 starter-kafka를 runtimeOnly로만, 계층 leaf는 메시징을 모름)이 그대로 검사된다.
  • 경로로 읽던 결합 셋을 풀었다: persistence-jpa migration 시험(라이브러리 jar의 db/migration을 풀어 읽는다), SpotBugs 제외, app.messaging 주인 계약 테스트(repo마다 자기 쪽 하나).

고른 방법과 버린 대안

  • migration 결합: 소스 폴더를 경로로 읽던 것을, 카탈로그가 고른 버전의 jar를 전용 configuration messagingMigrations(non-transitive)로 받아 Sync로 풀고 system property로 넘긴다. 버린 대안: jar를 testRuntimeOnly로 올려 classpath에서 읽기 — persistence-jpa 시험 컨텍스트의 Flyway가 classpath:db/migration 아래 메시징 migration까지 볼 위험.
  • registry 칸(T2): 방향 검사가 운영 선언(runtimeOnly 포함)과 compile-visible 소유 group 모듈을 대조한다. --include-build로 끼운 라이브러리 프로젝트는 그 좌표로 본다(같이 고치는 흐름에서도 같은 판정). 버린 대안: ArchUnit 패키지 규칙(T1) — runtimeOnly로 싣는 starter를 못 본다.
  • 계약 테스트 나누기: MessagingPublicSurfaceContractTest는 라이브러리 repo(messaging-testkit의 repositoryContractTest lane)로 이력째 옮겼다. MessagingAuthorityContractTest는 이 repo의 주인 하나만 보고, 라이브러리 쪽 하나는 그 repo의 MessagingSettingsOwnerContractTest가 본다.
  • 기록 문서: 메시징 설계서·계획서·납품 패키지(기록 8개)는 본문을 두고 머리 블록 「현재 정본」만 고쳤다(gRPC 때와 같은 이유: 기록은 그때 템플릿 코드를 두고 쓴 것).
  • auto-configuration 이름: 순서 제약(afterName/beforeName)이 플랫폼 root를 이름으로 부르므로 그 문자열도 dev.cakit.messaging…으로 바꿨다. 시험 stand-in도 같은 FQCN으로 옮겼다.

위험과 영향

  • 파생 서비스: 메시징 코드를 import하거나 project(':messaging:…')을 쓴 서비스는 빌드가 깨진다(B-57·B-58에 옮기는 법). tech-log-backend는 플랫폼을 받은 적이 없어 해당 없음(설계 12절).
  • 빌드가 Gitea에 기댄다: 캐시가 빈 빌드(새 기계, 이미지 builder의 verifyDependencyLocks)는 git.learn.hyeonworks.com에 닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인).
  • 동작: 같은 소스의 1.0.0이라 바뀌는 동작은 없다. 설정 키 app.messaging.*, env 키, Flyway 위치·파일, 표 이름은 그대로다.
  • 라이브러리 쪽: 인증 manifest의 gitCommit을 라이브러리 커밋으로 갱신한 PR #1을 총괄이 병합한 뒤 그 커밋(8c6045e)에 v1.0.0을 달았다. 게시한 testkit jar의 증거가 템플릿 SHA를 가리키지 않는다.

검증

desktop(~/x3-template, 합친 트리 = 이 브랜치 head 7dc5725f(게이트) / 96836a64(장부 더함), --no-build-cache), 로그 ~/x3-messaging-library-logs/template/:

단계 게이트 rc 시험(XML)
PR :ci :verifyDependencyLocks --warning-mode=fail 0 6,724(실패 0, skip 28)
PR :verifyStrictLaneStages --dry-run, verify-compose-profile-contracts.sh, check-repo-layout.py, 문서 자기 시험·check-docs.py·work-docs·링크·리뷰 색인 모두 0 —
PR(경로) build-logic test(183)·check javadoc, fileserver 다섯, MinIO(19), jpa pg16(432)·pg18(432)·migration(45) 모두 0
PR(도구) trivy fs HIGH·CRITICAL(메시징 leaf lockfile 포함 0건) 0 —
PR(도구) lychee 첫 실행 2(github.com 504 넷, 기록 문서의 외부 링크), 다시 돌려 0(648 OK) —
main :mainCheck --continue --warning-mode=fail 0 417
main configuration-cache 셋, :integrationCheck(879), :performanceCheck(26), http3(360), notification-platform pr 일곱 모두 0
main compose smoke(18 lane 통과), 빠른 시작 bootstrap-local.sh(health 200/UP) 0 —
태그 :releaseCheck -PgitRevision=<head> 0 1
  • 캐시: 모든 Gradle 명령에 --no-build-cache. 바깥 빌드 FROM-CACHE 0. mainCheck 로그의 FROM-CACHE 10은 verifyFeatureScaffold의 중첩 빌드 것이다.
  • 숫자 대조: 앞 PR(#6) 대비 ci 시험이 665개, integrationCheck가 79개 줄었다. 라이브러리 repo로 간 메시징 모듈의 단위 시험 665개와 integration lane 79개(인증 37 + 신뢰성·starter 42)와 같다.
  • 실행 위치: desktop 새 worktree ~/x3-gates(head 7dc5725f, 17:12~20:12 KST, 직전 부하는 summary 파일). 그 뒤 커밋 96836a64는 장부 줄 두 개뿐이다(문서 검사만 다시 돌렸다).
  • 이 브랜치에서 RED→GREEN을 본 시험: build-logic functional 시험(runtimeOnly·compile-visible·--include-build), system caller 고정 시험 둘, 순서 시험 둘(제약을 지우면 실패), 편집 훅 N1 시험.

라이브러리: messaging-library runner main run 23·pr run 24·signing-check run 25·release run 28 success, desktop ci --rerun-tasks·mainCheck(인증 lane 37, integration 42)·releaseRehearsal 1.0.0 rc=0.

리뷰어가 볼 곳

  • src/build-logic/src/main/java/dev/caskeleton/buildlogic/{ModuleRegistry.java,architecture/VerifyModuleDependencyDirectionTask.java,architecture/ArchitecturePlugin.java}와 새 시험(ModuleRegistryTest 4, CleanArchitectureResolvedClasspathFunctionalTest 5).
  • src/adapter/outbound/persistence-jpa/build.gradle(messagingMigrations), MigrationTrees.java.
  • src/config/architecture/modules.json의 allowed_libraries 세 행.
  • 기계적으로 만든 부분: 메시징 폴더 삭제(git rm -r src/platforms), import 바꾸기(dev.caskeleton.messaging → dev.cakit.messaging 문자열 치환 15파일), SpotBugs 줄 정리(메시징 Class/Source를 가진 Match만 지움), lockfile(resolveAndLockAll --write-locks).

관련

  • design-docs repo-structure/05-library-repos.md 4·8·10·13·14절, 15절 결정과 「변경(2026-11-08)」
  • messaging-library CHANGELOG.md 1.0.0, docs/work/release.md
  • docs/work/reference/related-repos.md(관련 저장소), docs/upgrade/2026-11-maturity-review.md 3.9절
## 무엇을, 왜 소유자 결정(2026-11-07): 템플릿 안에 프로젝트 계층이 아닌 라이브러리를 두지 않는다. 별도 repo로 관리하고 템플릿은 버전으로 받는다. gRPC는 앞 PR(#6)에서 옮겼고, 이번은 메시징이다. - 메시징 플랫폼(`src/platforms/messaging`, 19개 모듈)은 이력째 [messaging-library](https://git.learn.hyeonworks.com/donghyeon.kang/messaging-library)로 옮겨 `dev.cakit.messaging` **1.0.0**으로 Gitea Packages에 게시했다(태그 `v1.0.0`, release run 28). - 템플릿은 그 버전을 받는다: `src/settings.gradle`의 `exclusiveContent` 저장소(group `dev.cakit`와 그 아래만), 카탈로그 `messagingLibrary = "1.0.0"`과 모듈 여섯, 쓰는 leaf의 `project(':messaging:…')`을 좌표로, import `dev.caskeleton.messaging` → `dev.cakit.messaging`. - 지운 것: `src/platforms/messaging`과 빈 `src/platforms/`, registry 19행, `messaging-certification.yml`, 카탈로그의 메시징 전용 항목(avro, cloudevents, protobuf 4.33.2), SpotBugs 제외의 메시징 줄, `docs/messaging/`, `check-repo-layout.py`의 `platforms`. 지운 경로는 `docs/upgrade/2026-11-maturity-review.md` B-57~B-59. - registry가 라이브러리 edge를 계속 막게 했다: 맨 위 `library_groups`, 행마다 `allowed_libraries`(설계 Q11 T2). 분리 전 프로젝트 edge 검사가 지키던 약속(bridge는 core-api만, Kafka capability는 starter-kafka를 `runtimeOnly`로만, 계층 leaf는 메시징을 모름)이 그대로 검사된다. - 경로로 읽던 결합 셋을 풀었다: persistence-jpa migration 시험(라이브러리 jar의 `db/migration`을 풀어 읽는다), SpotBugs 제외, `app.messaging` 주인 계약 테스트(repo마다 자기 쪽 하나). ## 고른 방법과 버린 대안 - **migration 결합**: 소스 폴더를 경로로 읽던 것을, 카탈로그가 고른 버전의 jar를 전용 configuration `messagingMigrations`(non-transitive)로 받아 `Sync`로 풀고 system property로 넘긴다. 버린 대안: jar를 `testRuntimeOnly`로 올려 classpath에서 읽기 — persistence-jpa 시험 컨텍스트의 Flyway가 `classpath:db/migration` 아래 메시징 migration까지 볼 위험. - **registry 칸(T2)**: 방향 검사가 운영 선언(`runtimeOnly` 포함)과 compile-visible 소유 group 모듈을 대조한다. `--include-build`로 끼운 라이브러리 프로젝트는 그 좌표로 본다(같이 고치는 흐름에서도 같은 판정). 버린 대안: ArchUnit 패키지 규칙(T1) — `runtimeOnly`로 싣는 starter를 못 본다. - **계약 테스트 나누기**: `MessagingPublicSurfaceContractTest`는 라이브러리 repo(`messaging-testkit`의 `repositoryContractTest` lane)로 이력째 옮겼다. `MessagingAuthorityContractTest`는 이 repo의 주인 하나만 보고, 라이브러리 쪽 하나는 그 repo의 `MessagingSettingsOwnerContractTest`가 본다. - **기록 문서**: 메시징 설계서·계획서·납품 패키지(기록 8개)는 본문을 두고 머리 블록 「현재 정본」만 고쳤다(gRPC 때와 같은 이유: 기록은 그때 템플릿 코드를 두고 쓴 것). - **auto-configuration 이름**: 순서 제약(`afterName`/`beforeName`)이 플랫폼 root를 이름으로 부르므로 그 문자열도 `dev.cakit.messaging…`으로 바꿨다. 시험 stand-in도 같은 FQCN으로 옮겼다. ## 위험과 영향 - **파생 서비스**: 메시징 코드를 import하거나 `project(':messaging:…')`을 쓴 서비스는 빌드가 깨진다(B-57·B-58에 옮기는 법). `tech-log-backend`는 플랫폼을 받은 적이 없어 해당 없음(설계 12절). - **빌드가 Gitea에 기댄다**: 캐시가 빈 빌드(새 기계, 이미지 builder의 `verifyDependencyLocks`)는 `git.learn.hyeonworks.com`에 닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인). - **동작**: 같은 소스의 1.0.0이라 바뀌는 동작은 없다. 설정 키 `app.messaging.*`, env 키, Flyway 위치·파일, 표 이름은 그대로다. - **라이브러리 쪽**: 인증 manifest의 gitCommit을 라이브러리 커밋으로 갱신한 PR #1을 총괄이 병합한 뒤 그 커밋(`8c6045e`)에 `v1.0.0`을 달았다. 게시한 testkit jar의 증거가 템플릿 SHA를 가리키지 않는다. ## 검증 desktop(`~/x3-template`, 합친 트리 = 이 브랜치 head `7dc5725f`(게이트) / `96836a64`(장부 더함), `--no-build-cache`), 로그 `~/x3-messaging-library-logs/template/`: | 단계 | 게이트 | rc | 시험(XML) | | --- | --- | --- | --- | | PR | `:ci :verifyDependencyLocks --warning-mode=fail` | 0 | 6,724(실패 0, skip 28) | | PR | `:verifyStrictLaneStages --dry-run`, `verify-compose-profile-contracts.sh`, `check-repo-layout.py`, 문서 자기 시험·`check-docs.py`·work-docs·링크·리뷰 색인 | 모두 0 | — | | PR(경로) | build-logic `test`(183)·`check javadoc`, fileserver 다섯, MinIO(19), jpa pg16(432)·pg18(432)·migration(45) | 모두 0 | | | PR(도구) | trivy fs HIGH·CRITICAL(메시징 leaf lockfile 포함 0건) | 0 | — | | PR(도구) | lychee | 첫 실행 2(github.com 504 넷, 기록 문서의 외부 링크), 다시 돌려 0(648 OK) | — | | main | `:mainCheck --continue --warning-mode=fail` | 0 | 417 | | main | configuration-cache 셋, `:integrationCheck`(879), `:performanceCheck`(26), http3(360), notification-platform pr 일곱 | 모두 0 | | | main | compose smoke(18 lane 통과), 빠른 시작 `bootstrap-local.sh`(health 200/UP) | 0 | — | | 태그 | `:releaseCheck -PgitRevision=<head>` | 0 | 1 | - 캐시: 모든 Gradle 명령에 `--no-build-cache`. 바깥 빌드 FROM-CACHE 0. `mainCheck` 로그의 FROM-CACHE 10은 `verifyFeatureScaffold`의 중첩 빌드 것이다. - 숫자 대조: 앞 PR(#6) 대비 `ci` 시험이 665개, `integrationCheck`가 79개 줄었다. 라이브러리 repo로 간 메시징 모듈의 단위 시험 665개와 integration lane 79개(인증 37 + 신뢰성·starter 42)와 같다. - 실행 위치: desktop 새 worktree `~/x3-gates`(head `7dc5725f`, 17:12~20:12 KST, 직전 부하는 summary 파일). 그 뒤 커밋 `96836a64`는 장부 줄 두 개뿐이다(문서 검사만 다시 돌렸다). - 이 브랜치에서 RED→GREEN을 본 시험: build-logic functional 시험(runtimeOnly·compile-visible·--include-build), system caller 고정 시험 둘, 순서 시험 둘(제약을 지우면 실패), 편집 훅 N1 시험. 라이브러리: messaging-library runner main run 23·pr run 24·signing-check run 25·release run 28 success, desktop `ci --rerun-tasks`·`mainCheck`(인증 lane 37, integration 42)·`releaseRehearsal 1.0.0` rc=0. ## 리뷰어가 볼 곳 - `src/build-logic/src/main/java/dev/caskeleton/buildlogic/{ModuleRegistry.java,architecture/VerifyModuleDependencyDirectionTask.java,architecture/ArchitecturePlugin.java}`와 새 시험(`ModuleRegistryTest` 4, `CleanArchitectureResolvedClasspathFunctionalTest` 5). - `src/adapter/outbound/persistence-jpa/build.gradle`(`messagingMigrations`), `MigrationTrees.java`. - `src/config/architecture/modules.json`의 `allowed_libraries` 세 행. - 기계적으로 만든 부분: 메시징 폴더 삭제(`git rm -r src/platforms`), import 바꾸기(`dev.caskeleton.messaging` → `dev.cakit.messaging` 문자열 치환 15파일), SpotBugs 줄 정리(메시징 `Class`/`Source`를 가진 Match만 지움), lockfile(`resolveAndLockAll --write-locks`). ## 관련 - design-docs `repo-structure/05-library-repos.md` 4·8·10·13·14절, 15절 결정과 「변경(2026-11-08)」 - messaging-library `CHANGELOG.md` 1.0.0, `docs/work/release.md` - `docs/work/reference/related-repos.md`(관련 저장소), `docs/upgrade/2026-11-maturity-review.md` 3.9절
donghyeon.kang added 4 commits 2026-11-08 12:57:25 +00:00
방향 검사(verifyModuleDependencyDirection)는 프로젝트 edge만 센다.
라이브러리가 별도 repo로 나가 외부 좌표가 되면, 지금 registry가
지키는 약속(메시징 bridge는 core-api만 본다, Kafka capability는
starter-kafka를 runtimeOnly로만 싣는다, 계층 leaf는 메시징을 모른다)을
아무것도 검사하지 않게 된다.

registry에 칸 둘을 더한다(설계 10.2절 T2, 소유자 승인 Q11).

- 맨 위 선택 칸 library_groups: 다스릴 Maven group 접두사.
- 행마다 선택 칸 allowed_libraries: group:artifact 목록. 꼴이 틀리거나,
  library_groups 밖 group이거나, 겹치면 registry를 읽을 때 거절한다.
  계층 leaf(domain-core, shared-contract, application-*) 행이 칸을
  채우면 registry 위반이다. purity 검사가 비프로젝트 선언을 막는 것과
  따로 registry 자체가 막는다.
- 방향 검사는 프로젝트 edge와 같은 방식으로 본다: 운영 선언
  (api·implementation·compileOnly·runtimeOnly)의 소유 group 좌표와,
  compileClasspath에서 보이는 소유 group 모듈(라이브러리 모듈이 api로
  내보낸 것 포함)이 모두 칸에 있어야 한다. --include-build로 끼운
  라이브러리 프로젝트는 프로젝트 edge가 아니라 그 좌표로 본다. 그래야
  같이 고치는 흐름(composite build)에서도 같은 판정이 나온다. 「자기
  빌드」는 ":"로 짐작하지 않고 해석 root의 build path로 읽는다(이 빌드가
  다른 빌드에 끼워 돌아도 검사가 꺼지지 않게).

버린 대안: app-bootstrap ArchUnit 패키지 규칙(T1). import만 보고
runtimeOnly로 싣는 starter를 못 본다. 「어떤 모듈을 싣는가」는 빌드
사실이라 빌드 검사가 맞다.

위험: 시험 구성(testImplementation 등)은 프로젝트 edge처럼 보지 않는다.
이 빌드 자체를 다른 빌드에 끼우는 경우는 시험이 없다.

검증: desktop ./gradlew -p build-logic test rc=0. 새 시험: ModuleRegistryTest
4, CleanArchitectureResolvedClasspathFunctionalTest 7. functional 시험은
구현 전 RED였다(runtimeOnly·compile-visible 두 건은 게이트가 통과해
버렸고, --include-build 건은 「forbidden project dependencies
[demo-included]」로 실패).

Refs: design-docs repo-structure/05-library-repos.md 10.2절
템플릿 안에 프로젝트 계층이 아닌 메시징 플랫폼(src/platforms/messaging,
19개 모듈)이 있다. 소유자 결정(2026-11-07)은 라이브러리를 별도 repo에서
관리하고 템플릿은 버전으로 받는 것이다. 라이브러리는 이력째
messaging-library로 옮겨 dev.cakit.messaging 1.0.0으로 Gitea Packages에
게시했다(태그 v1.0.0 = 8c6045e, release run 28).

- 받는 법: src/settings.gradle에 exclusiveContent 저장소(group dev.cakit와
  그 아래는 Gitea에서만, 나머지는 Maven Central에서만). 카탈로그
  messagingLibrary = "1.0.0"과 쓰는 모듈 여섯.
- 쓰는 leaf: adapter:outbound:messaging, adapter:outbound:messaging-kafka,
  adapter:inbound:messaging(admin exclude 좌표를 새 group으로), 시험만
  composition:outbox-relay와 app-bootstrap architectureTest. import와
  auto-configuration 이름 문자열 dev.caskeleton.messaging →
  dev.cakit.messaging, 시험 stand-in도 같은 FQCN으로.
- persistence-jpa migration 시험이 라이브러리 소스 폴더를 경로
  (../../../platforms/…)로 읽던 것을, 카탈로그 버전의 jar를 전용 구성
  messagingMigrations(non-transitive)로 받아 db/migration을 풀어 읽게
  했다. classpath에 올리면 그 leaf 시험의 Flyway가 메시징 migration까지
  볼 수 있어 버렸다.
- registry: 메시징 19행을 지우고 library_groups ["dev.cakit"]와 쓰는 세
  행의 allowed_libraries. 분리 전 프로젝트 edge 검사가 지키던 약속이
  앞 커밋의 라이브러리 edge 검사로 그대로 남는다.
- 계약 테스트: MessagingPublicSurfaceContractTest는 라이브러리로 옮겼고,
  MessagingAuthorityContractTest는 이 repo의 app.messaging 주인 하나만
  본다(라이브러리 쪽 하나는 그 repo가 본다).
- system caller 규칙(ApplicationBoundaryArchitectureTest)의 「프로젝트
  타입」에 dev.cakit.을 더했다. 메시지 handler가 구현하는 MessageHandler가
  라이브러리 타입이 되면서, 그대로 두면 manual 09의 handler가
  SYSTEM_CALLERS_HAVE_ONLY_PROJECT_SUPERTYPES에 걸리고 MessageHandler로
  주입받는 endpoint를 USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS가
  따라가지 못한다(구조 리뷰가 찾음).
- 순서 시험: 이름 정렬로도 라이브러리 root가 먼저 오게 되어 bridge 시험이
  afterName을 지키지 못했다. stand-in을 맨 뒤 순서로 두고, inbox 쪽
  beforeName을 지키는 시험을 더했다.
- 지움: src/platforms(와 빈 폴더), messaging-certification.yml, 카탈로그의
  avro·cloudevents·protobuf 4.33.2, SpotBugs 제외의 메시징 줄,
  check-repo-layout.py의 platforms. 편집 훅이 계층 leaf의 dev.cakit import를
  알린다.
- lockfile: 바뀐 줄은 dev.cakit.messaging 좌표 추가 45줄뿐이다(외부
  의존성 집합은 그대로, 설계 16절 H6).

버린 대안: 라이브러리 jar를 persistence-jpa testRuntimeOnly로 올려
classpath에서 읽기(위 이유). 템플릿에 docs/messaging 사본을 남기기
(라이브러리 문서와 갈라진다. 다음 커밋이 문서를 그 repo로 가리킨다).

위험: 캐시가 빈 빌드(새 기계, 이미지 builder)는 git.learn.hyeonworks.com에
닿아야 한다. 공개 owner라 토큰은 필요 없다(익명 200 확인). 이 커밋만으로는
살아 있는 문서가 지운 경로를 부른다(check-docs는 다음 커밋에서 통과).

검증: desktop에서 이 트리로 RED·GREEN(system caller 고정 시험 2건, 순서
시험 2건은 수정 전·제약 제거 시 실패, 수정 후 통과). 전체 게이트는
PR 본문.

BREAKING CHANGE: src/platforms/messaging과 project(':messaging:…') 경로가
없어졌다. dev.cakit.messaging:<모듈>:1.0.0 좌표로 받고 import를
dev.caskeleton.messaging → dev.cakit.messaging으로 바꾼다
(docs/upgrade/2026-11-maturity-review.md B-57~B-59).

Refs: design-docs repo-structure/05-library-repos.md 4·8·10·13절
앞 커밋이 메시징 플랫폼을 지웠지만 살아 있는 문서는 아직 src/platforms
경로와 docs/messaging/을 부른다. 기록 8개의 머리 블록 「현재 정본」도
지운 docs/messaging/support-matrix.md를 가리킨다.

- docs/messaging/(10개)을 지운다. 같은 이름의 파일이 이력째
  messaging-library에 있다. 이 repo에서 그 내용을 부르던 문서(manual 09,
  messaging-kafka README·AGENTS)는 그 repo 파일로 링크한다.
- 기록(설계서 3, 계획서 3, 납품 패키지 2): 본문은 두고 머리 블록만
  고쳤다. 플랫폼을 다룬 것은 「없음 — messaging-library로 옮겼다」, 앱
  쪽 발행·소비를 다룬 것은 docs/manual/09-outbox-events.md.
- docs/work/reference/related-repos.md: 관련 저장소 표(메시징 줄 채움),
  라이브러리를 고치는 법, 템플릿에서 버전 올리는 법, 같이 고칠 때
  composite build(Gradle 루트가 src/라 ../../messaging-library), registry
  라이브러리 칸. 설계 14절이 근거다.
- src/config/architecture/README.md: library_groups·allowed_libraries 설명.
- docs/upgrade/2026-11-maturity-review.md 3.9절: B-57(지운 것), B-58(받는
  법·패키지·auto-config 이름), B-59(registry 칸).
- 진입 문서와 지역 지침(AGENTS.md, README.md, delegate, decisions,
  review-criteria, defect-patterns, gates, capability-status, manual 07,
  build-logic·persistence-jpa·inbound messaging·shared-contract 지침,
  env-keys 주석)에서 「들여온 제품」·src/platforms 문장을 별도 repo
  라이브러리 문장으로 바꿨다.

위험: 다른 repo 파일을 가리키는 링크는 lychee가 외부 URL로 본다(공개
repo라 익명으로 읽힌다).

검증: python3 scripts/check-docs.py OK, check-work-docs.py OK(상대 링크
깨짐 0), check-repo-layout.py OK, python3 -m unittest discover -s
scripts/tests OK.

BREAKING CHANGE: docs/messaging/이 없어졌다. 메시징 문서는
messaging-library repo의 docs/messaging/에 있다.

Refs: design-docs repo-structure/05-library-repos.md 4.3·14절
docs(ledger): 메시징 라이브러리 분리 작업의 예측과 실측을 남긴다
build-logic / included-builds (pull_request) Failing after 7s
ci-quality-gates / quality-gates (pull_request) Failing after 3s
dependency-vulnerability / dependency-review (pull_request) Skipped
dependency-vulnerability / dependency-submission (pull_request) Skipped
dependency-vulnerability / trivy-fs (pull_request) Successful in 34s
docs-check / docs (pull_request) Successful in 9s
fileserver-pr / fileserver-unit-and-architecture (pull_request) Failing after 5s
fileserver-pr / fileserver-local-ext4-contract (pull_request) Failing after 4s
fileserver-pr / fileserver-http-contract (pull_request) Failing after 4s
fileserver-pr / fileserver-security-suite (pull_request) Failing after 3s
fileserver-pr / fileserver-bounded-memory (pull_request) Failing after 5s
link-check / lychee (pull_request) Failing after 6s
notification-platform / contract (Java 21, no external provider) (pull_request) Failing after 4s
notification-platform / chaos (ambiguity, restart recovery, callback burst) (pull_request) Skipped
object-storage-qualification / minio-managed-contract (pull_request) Failing after 3s
object-storage-qualification / minio-managed-fault (pull_request) Skipped
pr-adapters / changes (pull_request) Successful in 5s
pr-adapters / web-servlet-containers (pull_request) Skipped
pr-adapters / websocket-container-matrix (pull_request) Skipped
pr-adapters / websocket-nginx-contract (pull_request) Skipped
pr-adapters / httpclient-stable-contract (apache) (pull_request) Skipped
pr-adapters / httpclient-stable-contract (jdk) (pull_request) Skipped
pr-adapters / httpclient-security-and-compatibility (pull_request) Skipped
object-storage-qualification / aws-managed-common-subset (pull_request) Skipped
ci-quality-gates / release-gate (pull_request) Failing after 1s
pr-adapters / jpa-postgresql-contract (16) (pull_request) Failing after 5s
pr-adapters / jpa-postgresql-contract (18) (pull_request) Failing after 5s
pr-adapters / jpa-migration-smoke (pull_request) Failing after 5s
96836a64b6
착수 때 공유 노트에 쓴 예측(p30·p50·p80)과 끝날 때 세션 기록에서
뽑은 실측(작업 중 110분, 호출 346, 출력 27.2만)을 한 줄씩 더한다.
모든 값이 p30 안이었고, 틀린 이유와 다음 예측에 더할 몫을 why에 적었다.
donghyeon.kang merged commit 1272a5e4d8 into main 2026-11-08 13:19:46 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#8