Files
DongHyeonka dd194784c3
main / main-check (push) Successful in 8m35s
docs: 별도 repo 라이브러리로서의 지침·작업 문서·릴리스 절차를 쓴다
옮겨 온 문서는 템플릿 안의 family를 전제로 쓰였다. 루트 지침은
하네스 뼈대의 빈 양식이고, 모듈 지침·제품 문서는 템플릿 경로
(src/platforms/messaging, src/config/…, cd src)와 템플릿 소비자
(app-bootstrap, adapter:*, composition:*)를 이 repo 안의 것처럼 부른다.

- AGENTS.md(38줄)·CLAUDE.md: 꼭 지킬 것 일곱(api 모듈 순수성, 템플릿
  타입·경로 금지, 배포 버전·적용된 migration 불변, 인증 manifest 손으로
  고치지 않기 등), 지도, 맡은 일, 검증 진입점.
- README.md: 받는 법(exclusiveContent dev.cakit), migration 위치, 지원 표
  (Boot 4.0.9, kafka-clients 4.1.2, apache/kafka:4.1.0, PostgreSQL 16,
  Java 21), 구조, 문서 지도, 서명 공개 키(지문 …A1C936D7F791F8AB,
  grpc-library와 같은 키), 이력(템플릿 2959eff0에서 filter-repo).
- CHANGELOG.md: 1.0.0 절과 템플릿 안 코드에서 옮기는 법(패키지,
  Kafka 설정 키, Gradle 좌표, 바뀌지 않는 것).
- docs/README.md, docs/work/{README,gates,release}.md,
  docs/problem-statement.md: grpc-library와 같은 모양으로, 메시징의
  인증 증거 게이트·migration 규칙·템플릿과 같이 고치는 경로를 넣었다.
  docs/vision.md는 소유자가 쓸 자리라 비워 둔다.
- messaging/AGENTS.md, docs/messaging/*, starter README: registry 경로를
  이 repo 기준으로, 템플릿 쪽 경로·타입은 「백엔드 템플릿의」로 밝혔다.
  시험이 읽는 문장(지원 표의 broker·버전, 설정 참조의 YAML)은 바꾸지
  않았다.

검증: scripts/verify.sh docs rc=0(vision.md 자리 알림만). desktop
mainCheck는 이 커밋 직전 트리에서 rc=0이었다. 문서가 시험에 읽히는
부분은 다음 desktop 실행으로 다시 본다.

Refs: design-docs repo-structure/05-library-repos.md 14.2절
2026-11-08 16:16:38 +09:00

1.3 KiB

바뀐 것

버전마다 바뀐 것과, 깨지는 변경이면 옮기는 법을 쓴다. 버전 규칙은 docs/work/release.md 2절이다.

1.0.0 — 아직 내지 않음

백엔드 템플릿 안에 있던 메시징 플랫폼(src/platforms/messaging)의 첫 배포 버전이다. 동작은 템플릿 main 2959eff0의 그 코드와 같다.

템플릿 안에서 쓰던 코드에서 옮기는 법

템플릿 안 코드를 직접 썼다면(템플릿 기준 커밋 2959eff0 이전):

  • Java 패키지: dev.caskeleton.messaging.* → dev.cakit.messaging.*. import를 바꾼다. 템플릿 재사용 체크리스트의 dev.caskeleton 일괄 바꾸기와 겹치지 않게 다른 이름을 쓴다.
  • Kafka 클라이언트 설정 키 caskeleton.messaging.credential.registry·.id → cakit.messaging.credential.registry·.id. 라이브러리가 스스로 넣고 읽는 키라, 상수(KafkaCredentialCallbackHandler.REGISTRY·CREDENTIAL_ID)를 쓴 코드는 바꿀 것이 없다.
  • Gradle: project(':messaging:<모듈>') → dev.cakit.messaging:<모듈>:1.0.0(저장소 선언은 README 「받는 법」).
  • 그대로인 것: 설정 키 app.messaging.*, Flyway 위치 db/migration/messaging과 migration 파일(V1001~V1005, V1101), 표 이름(messaging_outbox, messaging_inbox, admin journal), Spring auto-configuration 등록.