앞 커밋이 메시징 플랫폼을 지웠지만 살아 있는 문서는 아직 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절
70 lines
3.5 KiB
Markdown
70 lines
3.5 KiB
Markdown
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
|
> **기록 · 납품 패키지** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다.
|
|
|
|
- 상태: 보관
|
|
- 작성일: 2026-08-13
|
|
- 요약: 메시징 설계 패키지가 처음 납품됐을 때의 안내다. 본문 문서는 docs/design과 docs/history/plans에 있다.
|
|
- 현재 정본: 없음 — 메시징 플랫폼은 2026-11-08에 별도 repo messaging-library(Maven group dev.cakit.messaging)로 옮겼다. 지금 동작은 그 repo의 docs/messaging/support-matrix.md다
|
|
<!-- 머리 블록 끝 -->
|
|
|
|
> **보존 안내** — 이 파일은 저장소 루트 `messaging-superpowers-package/` 에 있던 납품 패키지의 README다.
|
|
> 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고,
|
|
> `validate_messaging_docs.py` 와 `MANIFEST.sha256` 은 제거했다.
|
|
> 아래 본문은 납품 시점의 기록이므로 제거된 파일을 가리키는 문장은 더 이상 유효하지 않다.
|
|
|
|
# Messaging Platform Superpowers Package
|
|
|
|
이 패키지는 `Java/Spring Messaging 플랫폼 심층 리서치`를 구현 기준으로 변환한 설계서와 구현 계획서다.
|
|
|
|
## 포함 파일
|
|
|
|
```text
|
|
docs/superpowers/specs/2026-08-10-messaging-platform-design.md
|
|
docs/superpowers/plans/2026-08-10-messaging-platform-implementation-plan.md
|
|
VALIDATION.md
|
|
validate_messaging_docs.py
|
|
MANIFEST.sha256
|
|
```
|
|
|
|
## 설계 경계
|
|
|
|
- 자체 `messaging-core`가 공개 계약을 소유한다.
|
|
- Kafka 4.2+/4.3.x와 RabbitMQ 4.3.x는 Stable Adapter다.
|
|
- Kafka Share Group, Pulsar 4.0 LTS·4.2, NATS JetStream 2.14.x는 Experimental Adapter다.
|
|
- 공통 `EXACTLY_ONCE` 또는 전역 순서 옵션을 제공하지 않는다.
|
|
- publish 결과는 `CONFIRMED`, `REJECTED`, `AMBIGUOUS`와 broker evidence로 표현한다.
|
|
- M1 Typed, M2 Advanced, M3 Native Capability, M4 Admin Plane을 분리한다.
|
|
- retry·DLQ·redrive에서 logical `messageId`를 유지한다.
|
|
- DLQ publish 확인 전에 source message를 settlement하지 않는다.
|
|
- Transactional Outbox, Inbox, Idempotent Consumer, Claim Check를 Reliability 모듈로 분리한다.
|
|
|
|
## 구현 가정
|
|
|
|
실제 Backend Skeleton 저장소가 입력에 포함되지 않았기 때문에 계획은 다음 기준을 사용한다.
|
|
|
|
- Java 21
|
|
- Gradle Kotlin DSL
|
|
- root package: `io.backend.skeleton.messaging`
|
|
- module root: `modules/messaging`
|
|
- PostgreSQL 16, Flyway, Spring JDBC/JPA
|
|
- JUnit 5, AssertJ, ArchUnit, Testcontainers, Toxiproxy
|
|
- Spring Framework 6.2 공통 호환선과 Spring 7.0 호환성 job
|
|
|
|
실제 저장소 구조가 다르면 파일 경로와 dependency catalog만 매핑한다. 공개 계약, 모듈 의존 방향, 신뢰성 상태 모델과 검증 기준은 그대로 유지한다.
|
|
|
|
## 문서 검증
|
|
|
|
패키지 루트에서 다음 명령을 실행한다.
|
|
|
|
```bash
|
|
./validate_messaging_docs.py \
|
|
docs/superpowers/specs/2026-08-10-messaging-platform-design.md \
|
|
docs/superpowers/plans/2026-08-10-messaging-platform-implementation-plan.md
|
|
```
|
|
|
|
`VALIDATION.md`는 문서 구조, Task 1~44 연속성, TDD 단계, 필수 설계 계약, placeholder, 중복 파일 경로를 확인한 정적 검증 결과다.
|
|
|
|
## 검증 한계
|
|
|
|
현재 검증은 설계·계획 문서에 대한 정적 검증이다. 실제 저장소가 제공되지 않아 Gradle compile, broker 통합 테스트, chaos test, 성능 인증은 실행하지 않았다. 구현 계획의 각 Task가 해당 실행 검증을 추가하도록 구성되어 있다.
|