[Chore/#111] JVM 기본 시간대 서울로 고정 및 메인 클래스 bootstrap 패키지로 이동

bootstrap/src/main/java/kr/ac/kookmin/stream/bootstrap/StreamServerApplication.java

@@ -0,0 +1,20 @@
+package kr.ac.kookmin.stream.bootstrap;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.AutoConfigurationPackage;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
+
+// 메인 클래스는 bootstrap 패키지에 두지만, 빈·JPA 엔티티와 레포지토리·설정 바인딩은 모든 모듈이 있는 루트 패키지에서 찾는다
+@SpringBootApplication(scanBasePackages = StreamServerApplication.BASE_PACKAGE)
+@AutoConfigurationPackage(basePackages = StreamServerApplication.BASE_PACKAGE)
+@ConfigurationPropertiesScan(StreamServerApplication.BASE_PACKAGE)
+public class StreamServerApplication {
+
+    static final String BASE_PACKAGE = "kr.ac.kookmin.stream";
+
+    public static void main(String[] args) {
+        SpringApplication.run(StreamServerApplication.class, args);
+    }
+
+}

bootstrap/src/main/java/kr/ac/kookmin/stream/bootstrap/config/TimezoneConfig.java

@@ -0,0 +1,18 @@
+package kr.ac.kookmin.stream.bootstrap.config;
+
+import jakarta.annotation.PostConstruct;
+import java.util.TimeZone;
+import kr.ac.kookmin.stream.common.DateUtil;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * JVM 기본 시간대를 서울로 고정한다. 컨테이너 시간대(UTC)와 관계없이 {@code LocalDateTime.now()} 등이 한국 시간을 쓰게 한다.
+ */
+@Configuration
+public class TimezoneConfig {
+
+    @PostConstruct
+    void setDefaultTimeZone() {
+        TimeZone.setDefault(TimeZone.getTimeZone(DateUtil.KST));
+    }
+}

bootstrap/src/test/java/kr/ac/kookmin/stream/DomainImplAccessTests.java → bootstrap/src/test/java/kr/ac/kookmin/stream/bootstrap/DomainImplAccessTests.java

@@ -1,4 +1,4 @@
-package kr.ac.kookmin.stream;
+package kr.ac.kookmin.stream.bootstrap;
 
 import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.classes;
 import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;

bootstrap/src/test/java/kr/ac/kookmin/stream/ModularityTests.java → bootstrap/src/test/java/kr/ac/kookmin/stream/bootstrap/ModularityTests.java

@@ -1,12 +1,13 @@
-package kr.ac.kookmin.stream;
+package kr.ac.kookmin.stream.bootstrap;
 
 import org.junit.jupiter.api.Test;
 import org.springframework.modulith.core.ApplicationModules;
 import org.springframework.modulith.docs.Documenter;
 
 class ModularityTests {
 
-    private final ApplicationModules modules = ApplicationModules.of(StreamServerApplication.class);
+    // 메인 클래스 패키지(bootstrap)가 아니라 루트 패키지를 기준으로 모듈을 나눈다
+    private final ApplicationModules modules = ApplicationModules.of(StreamServerApplication.BASE_PACKAGE);
 
     @Test
     void verify() {

bootstrap/src/test/java/kr/ac/kookmin/stream/MySqlIntegrationTest.java → bootstrap/src/test/java/kr/ac/kookmin/stream/bootstrap/MySqlIntegrationTest.java

@@ -1,4 +1,4 @@
-package kr.ac.kookmin.stream;
+package kr.ac.kookmin.stream.bootstrap;
 
 import java.util.Map;
 import org.springframework.boot.test.context.SpringBootTest;

bootstrap/src/test/java/kr/ac/kookmin/stream/RentalApplyConcurrencyTest.java → bootstrap/src/test/java/kr/ac/kookmin/stream/bootstrap/RentalApplyConcurrencyTest.java

@@ -1,4 +1,4 @@
-package kr.ac.kookmin.stream;
+package kr.ac.kookmin.stream.bootstrap;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertTrue;

docs/conventions/architecture.md

@@ -201,7 +201,11 @@ Gradle 모듈 분리가 도메인 간 경계를 컴파일 타임에 막고, Spri
 
 ### 4-2. 패키지 컨벤션 (탐지 규칙)
 
-- `@Modulithic` 메인 클래스는 `bootstrap`의 `{basePackage}`에 둔다.
+- 메인 클래스는 `{basePackage}.bootstrap`에 두고, 탐색 범위는 `{basePackage}`로 넓힌다. 기본값(메인 클래스 패키지)으로 두면 다른 모듈의 빈·JPA 엔티티·레포지토리·`@ConfigurationProperties`를 찾지 못한다.
+  - 빈: `@SpringBootApplication(scanBasePackages = ...)`
+  - JPA 엔티티·레포지토리: `@AutoConfigurationPackage(basePackages = ...)`
+  - 설정 바인딩: `@ConfigurationPropertiesScan(...)`
+  - Modulith 모듈 탐지: `ApplicationModules.of("{basePackage}")` (클래스를 넘기면 그 패키지가 루트가 된다)
 - **Gradle 경로와 Java 패키지는 별개다.** 도메인은 Gradle 상 `:core:domain:{도메인}`이지만 패키지는 루트 직속 형제로 둔다.
 
 ```
@@ -262,7 +266,7 @@ import org.springframework.modulith.ApplicationModule;
 // bootstrap/src/test/.../ModularityTests.java
 class ModularityTests {
 
-    private final ApplicationModules modules = ApplicationModules.of(Application.class);
+    private final ApplicationModules modules = ApplicationModules.of("{basePackage}");   // 메인 클래스 패키지(bootstrap)가 아닌 루트 기준
 
     @Test
     void verify() {