jigumulmi/
	├── admin/
	│   ├── src/
	│   │   ├── main/
	│   │   ├── test/
	│   ├── build.gradle
	├── core/
	│   ├── src/
	│   │   ├── main/
	│   │   ├── test/
	│   │   ├── testFixtures/
	│   ├── build.gradle
	├── monitor/
	├── build.gradle
	├── gradle.properties
	├── settings.gradle

모듈 의존관계

상황

src/
├── main/
│   └── java/com/jigumulmi/
│       ├── admin/
│       │   ├── banner/
│       │   ├── member/
│       │   └── place/
│       ├── aws/
│       ├── banner/
│       ├── common/
│       ├── config/
│       ├── member/
│       ├── place/
│       └── JigumulmiApplication.java
│   └── resources/
└── test/
    └── java/com/jigumulmi/
        ├── admin/
        │   ├── banner/
        │   └── place/
        ├── common/
        ├── config/security/
        ├── member/
        ├── place/
    └── resources/

• 기능 별 모듈을 분리하여 기능 간 코드 오염 방지 및 디렉토리 구조 통일

모듈 구조 설계

모듈 격리 수준

<aside> ⚙

사용자 기능을 담당하는 core와 관리자 기능을 담당하는 admin 모듈로 분리할 때, 격리 수준을 어느 정도로 할 것인지

</aside>

1. 완전한 격리: 컴파일할 때 서로를 인식하지 못해 import 불가능
   1. 엔티티까지 admin 용으로 분리하여 완전 격리를 시도해보았는데,
   2. 매니저 계층에서 이루어지는 JPA Entity → DTO 변환 작업 로직을 admin 모듈에도 전부 재작성이 필요하여 보류
2. 느슨한 격리: admin은 core에 존재하는 utils 객체, JPA 엔티티 등 공통 자원 사용 가능

코드 계층 반영 여부

<aside> ⚙

core 모듈 내에서 api, domain, storage 등 모듈 격리 여부

• support 모듈 추가 분리하여 logging, monitoring, swagger 기능 적재

</aside>

• 모듈 분리의 이점

  • api 모듈이 의존하는 Spring MVC, storage 모듈이 의존하는 JPA 등 변할 수 있는 라이브러리에 유연하게 대응
  • domain 모듈에서는 외부 의존성을 최소화하고 비즈니스 로직 수행에 집중
  • 구현 코드 뿐 아니라 .properties 등의 설정 파일도 모듈별로 관리

  → 기능별 응집도를 높여 유연성, 유지 보수성 향상

• 학습 차원에서 시도하는 것도 괜찮아 보였지만, admin과 core 분리로도 충분한 실습이 될 것으로 판단

• 프로젝트의 규모나 성숙도가 세부 모듈을 구분할 정도로 충분히 크지 않아 보류

모듈 분리 Gradle 설정

<aside> 💡

멀티모듈 구조는 루트 모듈 안에 서브 모듈들이 존재하는 형태이다

</aside>

plugins {
		// 루트에 적용할 플러그인 지정
	  id 'java'
	  id 'org.springframework.boot' apply false
	  id 'io.spring.dependency-management' apply false
}

java {
		// java 플러그인 설정 (버전 등)
	  sourceCompatibility = project.findProperty("javaVersion")
}

allprojects {
		// 루트 모듈 포함 모든 모듈의 공통 설정
		// 프로젝트 그룹명, 버전 등
    group = project.findProperty("projectGroup")
    version = project.findProperty("applicationVersion") + '-SNAPSHOT'

    repositories {
        mavenCentral()
    }
}

subprojects {
		// 루트 모듈 제외 서브 모듈들의 공통 설정
		// 플로그인, 의존성, 태스크 등
}

pluginManagement {  // 공통 플러그인 버전 관리 (gradle.properties 활용)
    plugins {
        id 'org.springframework.boot' version "${springBootVersion}"
        id 'io.spring.dependency-management' version "${springDependencyManagementVersion}"
    }
}

rootProject.name = 'jigumulmi'

// 서브 모듈 등록
include(
        "core",
        "admin"
)

// 공통 설정값 응집
// .gradle 파일에서 사용

applicationVersion=0.0.1

projectGroup=com.jigumulmi

javaVersion=21

springBootVersion=3.2.4
springDependencyManagementVersion=1.1.4

• 각 서브 모듈의 build.gradle에서 플러그인, 의존성, 태스크 등의 추가 설정 가능