Commit Graph
6 Commits
Author SHA1 Message Date
DongHyeonka c8f87215a1 refactor(grpc)!: Java·proto 패키지를 dev.cakit.grpc로 바꾼다
41d73a1이 패키지를 com.hyeonworks.grpc로 바꿨다. 소유자(2026-11-08)가
개인 도메인 이름을 공용 라이브러리에 쓰지 않기로 했다. 원래 이름
dev.caskeleton.grpc로 되돌리면 템플릿 재사용 체크리스트(「dev.caskeleton을
자기 패키지로 바꾼다」)가 파생 서비스의 라이브러리 import까지 깨뜨린다
(설계 05 NS1의 단점). 그래서 개인 도메인도 템플릿 자리표시 이름도 아닌
중립 이름 cakit을 쓴다(총괄 결정, 소유자가 맡김).

- Java: com.hyeonworks.grpc → dev.cakit.grpc(폴더도 옮김)
- proto: package hyeonworks.grpc.common.v1 → cakit.grpc.common.v1,
  생성 Java 패키지 → cakit.grpc.common.v1.generated. proto 폴더도 Buf
  PACKAGE_DIRECTORY_MATCH에 맞게 옮겼다
- 시험의 가짜 서비스 이름(hyeonworks.document.v1 등)과 SpotBugs 제외의
  클래스 이름, AutoConfiguration.imports

생성 Java 패키지를 dev.cakit.grpc 아래로 두지 않은 이유: 「생성 코드는
손으로 쓴 루트와 겹치지 않는다」는 규칙을 GrpcContractGeneratedCodeTest가
고정한다. 이름만 바꾸는 이 커밋에서 그 규칙까지 바꾸지 않는다.

만든 법: git mv로 폴더를 옮기고 grpc·grpc-advanced·config/spotbugs의 추적
파일에서 com.hyeonworks → dev.cakit, 그 밖의 hyeonworks → cakit(Gitea 주소
git.learn.hyeonworks.com은 제외)으로 바꾼 뒤 desktop spotlessApply(rc=0)로
import 순서만 맞췄다.

위험: proto 패키지는 wire 이름이다. 아직 배포 전이라 깨질 소비자가 없다.

BREAKING CHANGE: Java 패키지 com.hyeonworks.grpc.* → dev.cakit.grpc.*,
proto 패키지 hyeonworks.grpc.common.v1 → cakit.grpc.common.v1. 배포한 버전이
없어 옮길 소비자는 없다.
Refs: design-docs repo-structure/05-library-repos.md 6.3절(Q3·Q4 정정은 총괄)
2026-11-08 14:06:58 +09:00
DongHyeonka 41d73a174e refactor(grpc)!: Java·proto 패키지를 com.hyeonworks.grpc로 바꾼다
패키지 dev.caskeleton.grpc와 proto 조직 이름 caskeleton은 백엔드 템플릿의
자리표시 이름이다. 템플릿 재사용 체크리스트는 파생 서비스에게
dev.caskeleton을 자기 패키지로 바꾸라고 한다. 라이브러리 패키지가 같은
이름이면 그 일괄 바꾸기가 라이브러리 import까지 바꿔 클래스를 못 찾게
된다. Maven group(com.hyeonworks.grpc)과 패키지가 다른 말을 하는 것도
같은 문제다.

첫 배포(1.0.0) 전에 한 번 바꾼다(설계 Q4 NS3). 지금 이 패키지를 쓰는
소비자는 템플릿에도 파생 서비스에도 없다.

- Java: dev.caskeleton.grpc → com.hyeonworks.grpc(폴더도 옮김)
- proto: package caskeleton.grpc.common.v1 → hyeonworks.grpc.common.v1,
  생성 Java 패키지 → hyeonworks.grpc.common.v1.generated. 손으로 쓴
  com.hyeonworks와 겹치지 않는다는 기존 규칙(생성 코드 시험)을 그대로
  지킨다. proto 폴더도 Buf PACKAGE_DIRECTORY_MATCH에 맞게 옮겼다.
- 테스트의 가짜 서비스 이름 caskeleton.document.v1 등도 hyeonworks로.
  두 이름의 글자 수가 같아 길이·한도 시험에 영향이 없다.
- SpotBugs 제외 목록의 클래스 이름, AutoConfiguration.imports.

만든 법: git mv로 폴더를 옮기고, grpc·grpc-advanced·config의 추적
파일에서 dev.caskeleton → com.hyeonworks, caskeleton → hyeonworks를
바꾼 뒤 spotlessApply로 import 순서만 다시 맞췄다. build-logic(배포하지
않는 빌드 도구)과 결정 기록 본문은 바꾸지 않았다.

위험: proto 패키지는 wire 이름이다. 지금 쓰는 곳이 없어 깨질 상대가
없지만, 이 커밋 앞의 schema와 buf breaking으로 비교하면 깨짐으로 나온다.
1.0.0 전 한 번의 변경으로 받아들인다.

검증(desktop): spotlessApply rc=0. ci·mainCheck·releaseRehearsal은 이
커밋 위 트리에서 돌렸다(다음 커밋들 본문).

BREAKING CHANGE: Java 패키지 dev.caskeleton.grpc.* → com.hyeonworks.grpc.*,
proto 패키지 caskeleton.grpc.common.v1 → hyeonworks.grpc.common.v1. import와
proto import를 새 이름으로 바꾼다.
Refs: design-docs repo-structure/05-library-repos.md 6.3절 NS3
2026-11-08 11:12:58 +09:00
donghyeon-kaandClaude Opus 5.5 3e2cbd54f1 review-followup Wave 2.5·Wave 3 라운드 1(P14·P17): 정합성 잔여 12행, gRPC 플랫폼 9 leaf·protobuf 플러그인+Buf
- P14(W2): inbox archive 종단 상태 보존, GraphQL platform context 누락 경고, fileserver 전이·quota·진행 중 upload 삭제,
  알림 profile 소실 재시도·lease fencing·body 읽기 기한, Mongo bulk write concern, Dynamic Target cross-origin 헤더(결정 23),
  S3 profile CONDITIONAL_RETIREMENT 주장 거부, sample 포스터 abort·reconcile 경합(결정 22)
- P17(W3): gRPC 18→9 leaf(registry), .proto는 protobuf Gradle 플러그인 + Buf CI(결정 18), hyeonworks→caskeleton,
  인증 식별자 Context 전달, 한계값 정합 검사, P5-new-2·3 결함 수정
- 오케스트레이터: 현황표 적용(완료 395·남음 359), 새 결함 행 9개, capability-status 「제거된 코드」 17행,
  계획서 Wave 3 상세 Task, by_area.py NEW-15+ KeyError 수정

검증: ./gradlew check architectureCheck verifyDependencyLocks --continue 통과(597 task),
./gradlew -p optional-platforms ci 통과, CapabilityStatusDocumentTest 통과

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 15:45:58 +09:00
donghyeon-ka 2702232830 refactor: 리펙토링 진행중 의존성 gradle은 얇게 유지, 각 모듈에서 처리하고 있는 부분에 대해서 리펙토링 2026-09-24 11:15:10 +09:00
donghyeon-ka f578ab859a refactor: 리펙토링 진행중 의존성 gradle은 얇게 유지, 각 모듈에서 처리하고 있는 부분에 대해서 리펙토링 2026-09-23 17:27:09 +09:00
DongHyeonka 41c2c5ac34 feat: grpc 기능 deep 구현 2026-08-31 07:28:39 +09:00