20260102 #1 프로젝트 멀티모듈 구조 도입

.coderabbit.yaml

@@ -0,0 +1,18 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+language: "ko-KR"
+ignored_branch: ""
+early_access: false
+reviews:
+  profile: "chill"
+  request_changes_workflow: false
+  high_level_summary: true
+  poem: true
+  review_status: true
+  collapse_walkthrough: false
+  auto_review:
+    enabled: true
+    drafts: false
+    base_branches:
+      - test
+chat:
+  auto_reply: true

.github/workflows/spring-boot-cicd.yml

@@ -43,13 +43,13 @@ jobs:
       - name: Gradle Wrapper 실행권한 부여
         run: chmod +x gradlew
 
-      # application-prod.yml 파일을 빌드 전에 생성
-      - name: Create application-prod.yml from secret
+      - name: application-prod.yml 파일 생성
         run: |
-          mkdir -p src/main/resources
-          cat << 'EOF' > ./src/main/resources/application-prod.yml
-          ${{ secrets.APPLICATION_PROD_YML }}
-          EOF
+          echo "${{ secrets.APPLICATION_PROD_YML }}" > CT-web/src/main/resources/application-prod.yml
+
+      - name: config-imports.yml 파일 생성
+        run: |
+          echo "${{ secrets.CONFIG_IMPORTS_YML }}" > CT-web/src/main/resources/config-imports.yml
 
       # 브랜치 별 active profile 설정
       - name: Decide active profile

.gitignore

@@ -40,4 +40,6 @@ out/
 .kotlin
 
 ### ENV ###
-application-*.yml
+CT-web/src/main/resources/application-*.yml
+CT-web/src/main/resources/config-imports.yml
+CT-web/src/main/resources/springdoc.yml

CT-auth/build.gradle.kts

@@ -0,0 +1,20 @@
+plugins {
+  id("java-library")
+}
+
+tasks.bootJar {
+  enabled = false
+}
+
+tasks.jar {
+  enabled = true
+  archiveClassifier.set("")
+}
+
+dependencies {
+  implementation(project(":CT-common"))
+
+  api(libs.spring.boot.starter.security)
+  api(libs.spring.security.test)
+}
+

CT-common/build.gradle.kts

@@ -0,0 +1,31 @@
+plugins {
+  id("java-library")
+}
+
+tasks.bootJar {
+  enabled = false
+}
+
+tasks.jar {
+  enabled = true
+  archiveClassifier.set("")
+}
+
+// common 모듈 api 의존성은 모든 모듈에 적용
+dependencies {
+  // Spring Starter Web
+  api(libs.spring.boot.starter.web)
+
+  // JPA
+  api(libs.spring.boot.starter.data.jpa)
+
+  // Validation
+  api(libs.spring.boot.starter.validation)
+
+  // Jackson
+  api(libs.jackson.module.kotlin)
+
+  api(libs.kotlin.reflect)
+  api(libs.kotlin.stdlib)
+}
+

CT-common/src/main/kotlin/com/chuseok22/ctcommon/core/util/CommonUtil.kt

@@ -0,0 +1,13 @@
+package com.chuseok22.ctcommon.core.util
+
+/**
+ * null 또는 빈 문자열을 기본값으로 대체
+ */
+fun String?.nvl(fallback: String): String {
+  return when {
+    this == null -> fallback
+    this == "null" -> fallback
+    this.isBlank() -> fallback
+    else -> this
+  }
+}

CT-member/build.gradle.kts

@@ -0,0 +1,19 @@
+plugins {
+  id("java-library")
+}
+
+tasks.bootJar {
+  enabled = false
+}
+
+tasks.jar {
+  enabled = true
+  archiveClassifier.set("")
+}
+
+dependencies {
+  implementation(project(":CT-common"))
+
+  // Postgres
+  api(libs.postgresql)
+}

CT-web/build.gradle.kts

@@ -0,0 +1,15 @@
+plugins {
+  id("java-library")
+  id("org.springframework.boot")
+}
+
+dependencies {
+  implementation(project(":CT-auth"))
+  implementation(project(":CT-common"))
+  implementation(project(":CT-member"))
+
+  implementation(libs.swagger.ui)
+  implementation(libs.http.logging)
+  implementation(libs.api.change.log)
+}
+

src/main/kotlin/com/chuseok22/campustableserver/CampusTableServerApplication.kt → CT-web/src/main/kotlin/com/chuseok22/ctweb/CampusTableServerApplication.kt

@@ -1,4 +1,4 @@
-package com.chuseok22.campustableserver
+package com.chuseok22.ctweb
 
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.runApplication

CT-web/src/main/kotlin/com/chuseok22/ctweb/infrastructure/config/ComponentScanConfig.kt

@@ -0,0 +1,11 @@
+package com.chuseok22.ctweb.infrastructure.config
+
+import org.springframework.context.annotation.ComponentScan
+import org.springframework.context.annotation.Configuration
+
+@Configuration
+@ComponentScan(basePackages = [
+  "com.chuseok22.*"
+])
+class ComponentScanConfig {
+}

CT-web/src/main/kotlin/com/chuseok22/ctweb/infrastructure/config/DatabaseScanConfig.kt

@@ -0,0 +1,11 @@
+package com.chuseok22.ctweb.infrastructure.config
+
+import org.springframework.boot.autoconfigure.domain.EntityScan
+import org.springframework.context.annotation.Configuration
+import org.springframework.data.jpa.repository.config.EnableJpaRepositories
+
+@Configuration
+@EntityScan(basePackages = ["com.chuseok22.*"])
+@EnableJpaRepositories(basePackages = ["com.chuseok22.*"])
+class DatabaseScanConfig {
+}

CT-web/src/main/kotlin/com/chuseok22/ctweb/infrastructure/config/SwaggerConfig.kt

@@ -0,0 +1,53 @@
+package com.chuseok22.ctweb.infrastructure.config
+
+import com.chuseok22.ctweb.infrastructure.properties.SpringDocProperties
+import io.swagger.v3.oas.annotations.OpenAPIDefinition
+import io.swagger.v3.oas.annotations.info.Info
+import io.swagger.v3.oas.models.Components
+import io.swagger.v3.oas.models.OpenAPI
+import io.swagger.v3.oas.models.security.SecurityRequirement
+import io.swagger.v3.oas.models.security.SecurityScheme
+import io.swagger.v3.oas.models.servers.Server
+import org.springdoc.core.customizers.OpenApiCustomizer
+import org.springframework.boot.context.properties.EnableConfigurationProperties
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Configuration
+
+@OpenAPIDefinition(
+  info = Info(
+    title = "캠퍼스 테이블 CampusTable"
+  )
+)
+@Configuration
+@EnableConfigurationProperties(SpringDocProperties::class)
+class SwaggerConfig(
+  private val properties: SpringDocProperties
+) {
+
+  @Bean
+  fun OpenAPI(): OpenAPI {
+    val apiKey: SecurityScheme = SecurityScheme()
+      .type(SecurityScheme.Type.HTTP)
+      .scheme("bearer")
+      .bearerFormat("JWT")
+      .`in`(SecurityScheme.In.HEADER)
+      .name("Authorization")
+
+    return OpenAPI()
+      .components(Components().addSecuritySchemes("Bearer Token", apiKey))
+      .addSecurityItem(SecurityRequirement().addList("Bearer Token"))
+  }
+
+  @Bean
+  fun serverCustomizer(): OpenApiCustomizer {
+    return OpenApiCustomizer { openApi ->
+      properties.servers.forEach { server ->
+        openApi.addServersItem(
+          Server()
+            .url(server.url)
+            .description(server.description)
+        )
+      }
+    }
+  }
+}

CT-web/src/main/kotlin/com/chuseok22/ctweb/infrastructure/properties/SpringDocProperties.kt

@@ -0,0 +1,20 @@
+package com.chuseok22.ctweb.infrastructure.properties
+
+import jakarta.validation.Valid
+import jakarta.validation.constraints.NotBlank
+import org.springframework.boot.context.properties.ConfigurationProperties
+import org.springframework.validation.annotation.Validated
+
+@Validated
+@ConfigurationProperties(prefix = "springdoc")
+data class SpringDocProperties(
+  @field:Valid
+  val servers: List<Servers>
+) {
+  data class Servers(
+    @field:NotBlank
+    val url: String,
+    @field:NotBlank
+    val description: String
+  )
+}

CT-web/src/main/resources/application.yml

@@ -0,0 +1,30 @@
+spring:
+  profiles:
+    active: prod
+  config:
+    import: classpath:config-imports.yml
+  jpa:
+    open-in-view: false
+    properties:
+      hibernate:
+        jdbc:
+          time_zone: UTC
+        dialect: org.hibernate.dialect.PostgreSQLDialect
+        show_sql: false
+        format_sql: true
+        use_sql_comments: true
+  flyway:
+    enabled: true
+    locations: classpath:db/migration
+    baseline-on-migrate: false
+    validate-on-migrate: true
+    out-of-order: false # 과거 버전이 뒤늦게 들어오는 경우 방지
+    clean-disabled: true # 실수로 clean 되는 경우 방지
+  jackson:
+    time-zone: Asia/Seoul
+  servlet:
+    multipart:
+      enabled: true # 파일 업로드 허용
+      max-file-size: 200MB # 업로드 파일 최대 크기
+      max-request-size: 1000MB # 요청 전체 최대 크기
+      file-size-threshold: 10MB