🚀 [Kotlin Migration] 전체 백엔드 코틀린 마이그레이션 마스터 트래킹 이슈

[ImNM]

🚀 DuDoong Backend - Java → Kotlin 전체 마이그레이션

개요

Java 17 + Spring Boot 2.7.7 기반의 DuDoong 백엔드를 Kotlin으로 전환합니다.
Lombok 제거, Kotlin DSL 빌드 스크립트 전환, 각 모듈별 순차 마이그레이션을 진행합니다.

현재 기술 스택

항목	현재	전환 후
언어	Java 17	Kotlin 1.9.x (JVM 17)
빌드 스크립트	Gradle Groovy DSL	Gradle Kotlin DSL
코드 간소화	Lombok	Kotlin data class / extension
QueryDSL	Java APT	Kotlin KAPT
직렬화	Jackson	Jackson + kotlin-module

아키텍처 (멀티모듈)

DuDoong-Backend
├── DuDoong-Common        # JWT, 어노테이션, 예외처리, DTO, 유틸
├── DuDoong-Domain        # JPA 엔티티, QueryDSL, 도메인 서비스, AOP
├── DuDoong-Infrastructure # Redis, S3, SES, Toss Payments, Feign, Slack, NCP
├── DuDoong-Api           # REST API, Spring Security, SpringDoc/Swagger
├── DuDoong-Socket        # WebSocket 서버
└── DuDoong-Batch         # Spring Batch (정산, 엑셀, 알림)

도메인 영역

• user / host / auth
• event / ticket_item
• order / cart / coupon
• issuedTicket / settlement
• comment / statistic

마이그레이션 전략

Bottom-up 방식 (의존성 낮은 모듈 → 높은 모듈 순서)

Phase 0 (설정) → Phase 1 (Common) → Phase 2 (Infrastructure)
→ Phase 3 (Domain) → Phase 4 (Api) → Phase 5 (Socket) → Phase 6 (Batch)

작업 이슈 목록

Phase 0: 빌드 설정

• 🔨 [Kotlin Migration] Phase 0: Gradle Kotlin DSL 전환 & Kotlin 플러그인 설정 #583 Gradle Kotlin DSL 전환 & Kotlin 플러그인 설정

Phase 1: DuDoong-Common

• 🔨 [Kotlin Migration] Phase 1-1: DuDoong-Common 어노테이션 & 유틸리티 클래스 변환 #584 Phase 1-1: 어노테이션 & 유틸리티 클래스 변환
• 🔨 [Kotlin Migration] Phase 1-2: DuDoong-Common 예외처리 & DTO 클래스 변환 #585 Phase 1-2: 예외처리 & DTO 클래스 변환
• 🔨 [Kotlin Migration] Phase 1-3: DuDoong-Common JWT Provider & Properties 변환 #586 Phase 1-3: JWT Provider & Properties 변환

Phase 2: DuDoong-Infrastructure

• 🔨 [Kotlin Migration] Phase 2-1: DuDoong-Infrastructure Redis & Redisson 변환 #587 Phase 2-1: Redis 설정 & Redisson 변환
• 🔨 [Kotlin Migration] Phase 2-2: DuDoong-Infrastructure AWS S3 & SES 변환 #588 Phase 2-2: AWS S3 & SES 변환
• 🔨 [Kotlin Migration] Phase 2-3: DuDoong-Infrastructure Toss Payments Feign 클라이언트 변환 #589 Phase 2-3: Toss Payments Feign 클라이언트 변환
• 🔨 [Kotlin Migration] Phase 2-4: DuDoong-Infrastructure Slack & AlimTalk (NCP) 변환 #590 Phase 2-4: Slack & AlimTalk (NCP) 변환

Phase 3: DuDoong-Domain

• 🔨 [Kotlin Migration] Phase 3-1: DuDoong-Domain 공통 AOP & 도메인 이벤트 변환 #591 Phase 3-1: 공통 AOP & 도메인 이벤트 변환
• 🔨 [Kotlin Migration] Phase 3-2: DuDoong-Domain User & Host 도메인 엔티티 변환 #592 Phase 3-2: User & Host 도메인 변환
• 🔨 [Kotlin Migration] Phase 3-3: DuDoong-Domain Event & TicketItem 도메인 변환 #593 Phase 3-3: Event & TicketItem 도메인 변환
• 🔨 [Kotlin Migration] Phase 3-4: DuDoong-Domain Order & Cart 도메인 변환 #594 Phase 3-4: Order & Cart 도메인 변환
• 🔨 [Kotlin Migration] Phase 3-5: DuDoong-Domain IssuedTicket & Coupon 도메인 변환 #595 Phase 3-5: IssuedTicket & Coupon 도메인 변환
• 🔨 [Kotlin Migration] Phase 3-6: DuDoong-Domain Settlement & Comment 도메인 변환 #596 Phase 3-6: Settlement & Comment 도메인 변환

Phase 4: DuDoong-Api

• 🔨 [Kotlin Migration] Phase 4-1: DuDoong-Api Spring Security & Auth 레이어 변환 #597 Phase 4-1: Spring Security & Auth 레이어 변환
• 🔨 [Kotlin Migration] Phase 4-2: DuDoong-Api User, Host, Event API 컨트롤러 변환 #598 Phase 4-2: User, Host, Event API 컨트롤러 변환
• 🔨 [Kotlin Migration] Phase 4-3: DuDoong-Api Order, Cart, Coupon API 컨트롤러 변환 #599 Phase 4-3: Order, Cart, Coupon API 컨트롤러 변환
• 🔨 [Kotlin Migration] Phase 4-4: DuDoong-Api IssuedTicket, TicketItem API 컨트롤러 변환 #600 Phase 4-4: IssuedTicket, TicketItem API 컨트롤러 변환
• 🔨 [Kotlin Migration] Phase 4-5: DuDoong-Api Image, Statistic, 공통 글로벌 설정 변환 #601 Phase 4-5: Image, Statistic, 공통 글로벌 설정 변환

Phase 5: DuDoong-Socket

• 🔨 [Kotlin Migration] Phase 5: DuDoong-Socket WebSocket 서버 변환 #602 Phase 5: WebSocket 서버 변환

Phase 6: DuDoong-Batch

• 🔨 [Kotlin Migration] Phase 6-1: DuDoong-Batch 정산 Job 변환 (Settlement) #603 Phase 6-1: 정산 Job 변환 (Settlement)
• 🔨 [Kotlin Migration] Phase 6-2: DuDoong-Batch 이벤트 만료 & 엑셀 & Slack 통계 Job 변환 #604 Phase 6-2: 이벤트 만료 & 엑셀 & Slack 통계 Job 변환

Kotlin 마이그레이션 핵심 원칙

1. Lombok → Kotlin 네이티브: @Data → data class, @Builder → named parameters + copy()
2. Null Safety: @Nullable / @NonNull → Kotlin nullable/non-null 타입 시스템
3. KAPT: QueryDSL Q클래스 생성을 KAPT로 전환
4. data class JPA 주의: JPA 엔티티는 @Entity + open class (allOpen plugin 적용)
5. Jackson kotlin-module: ObjectMapper에 KotlinModule 등록
6. Spring Security: 설정 클래스를 Kotlin lambda DSL로 전환

주의사항

• 각 Phase별로 독립 브랜치 생성 후 PR
• 모든 기존 테스트 통과 확인 후 머지
• Java ↔ Kotlin 혼재 허용 (마이그레이션 기간 중)
• CI (GitHub Actions) 빌드 유지