feat(package): 디렉토리 규칙 표준화 (#14)

[kangeunchan]

Summary

• Kotlin 서비스들의 모듈 네이밍을 Hexagonal Architecture 기반 명명 규칙으로 표준화
• Go 서비스들의 디렉토리 구조를 Standard Go Project Layout 기반으로 표준화
• module-a, module-b → {service}-adapter-in, {service}-adapter-out, {service}-application, {service}-bootstrap, {service}-domain
• Go 서비스에 internal/{handler,service,repository,model,config}, pkg 디렉토리 추가

Related Issue

• Closes MSA 서비스 아키텍처 구조 표준화 및, 아키텍처 설정 #14

Scope

• In scope:
  • Kotlin 서비스 (admission, application, configuration, document, gateway, identity, notification, schedule) 모듈 디렉토리 리네이밍
  • Go 서비스 (analytics, evaluation, observability) 표준 디렉토리 구조 생성
  • BUILD.bazel 파일의 alias 경로 업데이트
  • 각 모듈의 BUILD.bazel 내부 참조 경로 수정
• Out of scope:
  • 실제 코드 로직 변경 없음 (순수 구조 변경)
  • 비즈니스 로직 구현은 향후 이슈에서 처리

Implementation

• High-level design / approach

  Kotlin 서비스 (Hexagonal Architecture):

  • adapter-in: 외부 요청을 받는 인바운드 어댑터 (REST Controller 등)
  • adapter-out: 외부 시스템과 통신하는 아웃바운드 어댑터 (Repository,
    External API 등)
  • application: 유스케이스 구현 레이어
  • domain: 비즈니스 로직 및 도메인 모델
  • bootstrap: 애플리케이션 진입점 및 설정

  Go 서비스 (Standard Go Project Layout):

  • internal/handler: HTTP 핸들러 (Gin)
  • internal/service: 비즈니스 로직
  • internal/repository: 데이터 접근 레이어
  • internal/model: 도메인 모델
  • internal/config: 설정
  • pkg: 외부에서 import 가능한 공개 패키지

Testing

• Unit tests
• Integration tests
• Manual verification
  • bazel build //systems/admission/admission-adapter-in:main 등 빌드 경로 확인
  • 각 서비스별 alias 동작 확인 (bazel build admission, bazel build analytics)
  • Go 서비스 디렉토리 구조 확인

Deployment Notes

• Feature flag: N/A
• Migration required: No (디렉토리 구조 변경만 해당, 빌드 산출물 동일)
• Rollout considerations:
  • 다른 브랜치 작업 중인 팀원은 리베이스 시 경로 충돌 발생 가능
  • 머지 후 로컬 Bazel 캐시 클리어 권장: bazel clean
  • Go 서비스 개발 시 표준 디렉토리 구조 활용

Checklist

• Matches product/tech requirements
• Backward compatibility considered
• Docs updated if applicable

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}