교촌, 자담 등 여러 프랜차이즈 서비스를 운영하다 보면, 각 프로젝트에서 공통으로 사용하는 코드(도메인, 유틸, 설정 등) 가 생깁니다.

그래서 저희 팀은 하나의 저장소 안에 여러 브랜드의 모듈을 함께 관리하는 구조로 시작했습니다.

server-repo/             # 저장소 루트
├─ domain/                      # 공통 도메인 모듈
│  └─ 여러 공통 도메인 클래스들
├─ service-kyochon/             # 교촌 서비스 모듈
│  ├─ user/
│  ├─ external/
│  └─ admin/
├─ service-jadam/               # 자담 서비스 모듈
│  ├─ user/
│  ├─ external/
│  └─ admin/

이 구조에서는 domain 모듈을 공통으로 참조해 각 서비스가 동일한 도메인 로직을 쉽게 재사용할 수 있습니다.

하지만, “레포를 나누거나 다른 레포에서 해당 모듈 사용” 시점에서 문제가 발생합니다

처음에는 monorepo 형태로 관리하기 편하지만, 브랜드별 레포지토리를 분리해야 하는 시점이 오면 문제가 생깁니다.

• 공통 모듈(domain)을 복사해야 함
• 각 프로젝트에서 버전 관리가 따로 이루어짐
• 수정 내용이 서로 다른 저장소에 중복 반영됨

결국 코드가 중복되고, “어느 버전이 최신인지” 관리하기 어려운 상황이 발생합니다 ㅜㅜ.

그래서 선택한 방법은? GitHub Packages !

공통 모듈을 GitHub Packages로 배포하여 따로 버전 관리할 수 있고 각 서비스에서 버전만 지정해 쉽게 사용 할 수 있습니다.

https://github.com/ghkdqhrbals/personal-module

• github-actions 로 pr 테스트 결과 코멘트 및 수동 publish 가능하도록 설정

• 배포완료 시 tagging + release + slack alert

이렇게 하면 각 서비스 프로젝트에서는 단순히 아래처럼 의존성만 추가하면 됩니다.

repositories {
    mavenCentral()
    maven {
        url = uri("https://maven.pkg.github.com/ghkdqhrbals/personal-module")
        credentials {
            username = "<github_username>"
            password = "<personal_access_token>"
        }
    }
}

dependencies {
    implementation("com.github.ghkdqhrbals:personal-module:0.2.0")
}

이제 각 프랜차이즈 서비스는 domain이나 common-module을 직접 포함하지 않고도, 필요한 공통 기능만 명확히 버전으로 관리하면서 사용할 수 있습니다. 덕분에 코드 중복이 줄고, 모듈별 독립성도 강화되었습니다!

When operating several franchise services such as Kyochon and Jadam, code that is shared across projects naturally appears. This includes domains, utilities, configuration, and similar pieces.

So our team started with a structure where modules for several brands were managed together inside one repository.

server-repo/             # repository root
|- domain/               # shared domain module
|  `- shared domain classes
|- service-kyochon/      # Kyochon service module
|  |- user/
|  |- external/
|  `- admin/
`- service-jadam/        # Jadam service module
   |- user/
   |- external/
   `- admin/

In this structure, each service can easily reuse the same domain logic by referencing the shared domain module.

But a problem appears when “splitting repositories or using that module from another repository”.

At first, managing it as a monorepo is convenient. But once the time comes to split repositories by brand, problems appear.

• The shared module, domain, needs to be copied.
• Each project manages its version separately.
• The same modification gets duplicated across different repositories.

Eventually, the code gets duplicated, and it becomes hard to manage “which version is the latest”.

So the method I chose was GitHub Packages.

By publishing the shared module to GitHub Packages, it can be versioned separately, and each service can use it easily by specifying only the version.

https://github.com/ghkdqhrbals/personal-module

• Configured GitHub Actions to comment PR test results and support manual publishing.

• When publishing is complete, tagging + release + Slack alert.

With this setup, each service project only needs to add the dependency like below.

repositories {
    mavenCentral()
    maven {
        url = uri("https://maven.pkg.github.com/ghkdqhrbals/personal-module")
        credentials {
            username = "<github_username>"
            password = "<personal_access_token>"
        }
    }
}

dependencies {
    implementation("com.github.ghkdqhrbals:personal-module:0.2.0")
}

Now each franchise service can use only the shared functionality it needs, with clear version management, without directly including domain or common-module. This reduced code duplication and strengthened module independence.