feature/36-pdf-and-excel-merge-to-application

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/status/aggregates/Status.kt

@@ -1,13 +1,13 @@
 package hs.kr.entrydsm.domain.status.aggregates
 
+import hs.kr.entrydsm.domain.status.values.ApplicationStatus
 import hs.kr.entrydsm.global.annotation.aggregates.Aggregate
 
 @Aggregate(context = "status")
 data class Status(
     val id: Long? = 0,
-    val isPrintsArrived: Boolean = false,
-    val isSubmitted: Boolean = false,
     val examCode: String? = null,
+    val applicationStatus: ApplicationStatus,
     val isFirstRoundPass: Boolean = false,
     val isSecondRoundPass: Boolean = false,
     val receiptCode: Long,

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/status/aggregates/StatusCache.kt

@@ -0,0 +1,12 @@
+package hs.kr.entrydsm.domain.status.aggregates
+
+import hs.kr.entrydsm.domain.status.values.ApplicationStatus
+
+data class StatusCache(
+    val receiptCode: Long,
+    val examCode: String?,
+    val applicationStatus: ApplicationStatus,
+    val isFirstRoundPass: Boolean,
+    val isSecondRoundPass: Boolean,
+    val ttl: Long
+)

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/status/interfaces/ApplicationCommandStatusContract.kt

@@ -0,0 +1,5 @@
+package hs.kr.entrydsm.domain.status.interfaces
+
+interface ApplicationCommandStatusContract {
+    fun updateExamCode(receiptCode: Long, examCode: String)
+}

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/status/interfaces/ApplicationQueryStatusContract.kt

@@ -0,0 +1,9 @@
+package hs.kr.entrydsm.domain.status.interfaces
+
+import hs.kr.entrydsm.domain.status.aggregates.Status
+import hs.kr.entrydsm.domain.status.aggregates.StatusCache
+
+interface ApplicationQueryStatusContract {
+    fun queryStatusByReceiptCode(receiptCode: Long): Status?
+    fun queryStatusByReceiptCodeInCache(receiptCode: Long): StatusCache?
+}

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/status/interfaces/StatusContract.kt

@@ -1,4 +1,3 @@
 package hs.kr.entrydsm.domain.status.interfaces
 
-interface StatusContract :
-        SaveExamCodeContract
+interface StatusContract : ApplicationQueryStatusContract, ApplicationCommandStatusContract

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/status/values/ApplicationStatus.kt

@@ -1,24 +1,42 @@
 package hs.kr.entrydsm.domain.status.values
 
+/**
+ * 지원서 상태를 나타내는 열거형 클래스입니다.
+ * gRPC 프로토콜과 매핑되는 지원 상태를 정의합니다.
+ */
 enum class ApplicationStatus {
-    /** 미지원 - 지원자가 원서를 작성하지 않은 상태 */
+    /**
+     * 미지원 - 지원자가 원서를 작성하지 않은 상태
+     */
     NOT_APPLIED,
 
-    /** 원서 작성 중 - 원서가 저장되었으나 제출되지 않은 상태 */
+    /**
+     * 원서 작성 중 - 원서가 저장되었으나 제출되지 않은 상태
+     */
     WRITING,
 
-    /** 지원 완료 - 온라인 원서 접수 완료 상태 */
+    /**
+     * 지원 완료 - 온라인 원서 접수 완료 상태
+     */
     SUBMITTED,
 
-    /** 서류 도착 대기 - 원서 제출 후 학교에서 접수 확인 전 상태 */
+    /**
+     * 서류 도착 대기 - 원서 제출 후 학교에서 접수 확인 전 상태
+     */
     WAITING_DOCUMENTS,
 
-    /** 서류 접수 완료 - 학교에서 원서 및 증빙 서류가 정상적으로 도착하여 검토 완료된 상태 */
+    /**
+     * 서류 접수 완료 - 학교에서 원서 및 증빙 서류가 정상적으로 도착하여 검토 완료된 상태
+     */
     DOCUMENTS_RECEIVED,
 
-    /** 전형 진행 중 - 1차 또는 2차 전형이 진행 중인 상태 */
+    /**
+     * 전형 진행 중 - 1차 또는 2차 전형이 진행 중인 상태
+     */
     SCREENING_IN_PROGRESS,
 
-    /** 합격 여부 확인 - 최종 합격자 발표 완료 상태 */
-    RESULT_ANNOUNCED
+    /**
+     * 합격 여부 확인 - 최종 합격자 발표 완료 상태
+     */
+    RESULT_ANNOUNCED,
 }

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/user/aggregates/User.kt

@@ -0,0 +1,12 @@
+package hs.kr.entrydsm.domain.user.aggregates
+
+import hs.kr.entrydsm.global.annotation.aggregates.Aggregate
+import java.util.UUID
+
+@Aggregate(context = "user")
+data class User(
+    val id: UUID,
+    val phoneNumber: String,
+    val name: String,
+    val isParent: Boolean
+)

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/user/interfaces/ApplicationQueryUserContract.kt

@@ -0,0 +1,8 @@
+package hs.kr.entrydsm.domain.user.interfaces
+
+import hs.kr.entrydsm.domain.user.aggregates.User
+import java.util.UUID
+
+interface ApplicationQueryUserContract {
+    fun queryUserByUserId(userId: UUID): User
+}

casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/user/interfaces/UserContract.kt

@@ -0,0 +1,4 @@
+package hs.kr.entrydsm.domain.user.interfaces
+
+interface UserContract : ApplicationQueryUserContract {
+}

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/global/grpc/dto/user/UserRole.kt → casper-application-domain/src/main/kotlin/hs/kr/entrydsm/domain/user/value/UserRole.kt

@@ -1,4 +1,4 @@
-package hs.kr.entrydsm.application.global.grpc.dto.user
+package hs.kr.entrydsm.domain.user.value
 
 /**
  * 사용자 역할을 나타내는 열거형 클래스입니다.
@@ -19,4 +19,4 @@ enum class UserRole {
      * 관리자 권한
      */
     ADMIN,
-}
+}

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/domain/examcode/usecase/GrantExamCodesUseCase.kt

@@ -3,7 +3,6 @@ package hs.kr.entrydsm.application.domain.examcode.usecase
 import hs.kr.entrydsm.domain.application.interfaces.ApplicationContract
 import hs.kr.entrydsm.domain.examcode.interfaces.GrantExamCodesContract
 import hs.kr.entrydsm.domain.examcode.values.ExamCodeInfo
-import hs.kr.entrydsm.domain.status.interfaces.StatusContract
 import hs.kr.entrydsm.application.global.annotation.usecase.UseCase
 import hs.kr.entrydsm.domain.application.aggregates.Application
 import hs.kr.entrydsm.domain.application.values.ApplicationType
@@ -12,6 +11,7 @@ import hs.kr.entrydsm.domain.examcode.interfaces.BaseLocationContract
 import hs.kr.entrydsm.domain.examcode.interfaces.KakaoGeocodeContract
 import hs.kr.entrydsm.domain.examcode.values.DistanceGroup
 import hs.kr.entrydsm.application.domain.examcode.util.DistanceUtil
+import hs.kr.entrydsm.domain.status.interfaces.SaveExamCodeContract
 import kotlinx.coroutines.async
 import kotlinx.coroutines.coroutineScope
 
@@ -27,9 +27,9 @@ import kotlinx.coroutines.coroutineScope
 @UseCase
 class GrantExamCodesUseCase(
     private val applicationContract: ApplicationContract,
+    private val saveExamCodeContract: SaveExamCodeContract,
     private val kakaoGeocodeContract: KakaoGeocodeContract,
     private val baseLocationContract: BaseLocationContract,
-    private val statusContract: StatusContract,
     private val distanceUtil: DistanceUtil,
 ) : GrantExamCodesContract {
 
@@ -145,7 +145,7 @@ class GrantExamCodesUseCase(
     private suspend fun saveExamCodes(examCodeInfos: List<ExamCodeInfo>) {
         examCodeInfos.forEach { info ->
             info.examCode?.let { examCode ->
-                statusContract.updateExamCode(info.receiptCode, examCode)
+                saveExamCodeContract.updateExamCode(info.receiptCode, examCode)
             }
         }
     }

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/domain/status/domain/StatusPersistenceAdapter.kt

@@ -0,0 +1,47 @@
+package hs.kr.entrydsm.application.domain.status.domain
+
+import hs.kr.entrydsm.application.domain.status.domain.repository.StatusCacheRepository
+import hs.kr.entrydsm.application.global.grpc.client.status.StatusGrpcClient
+import hs.kr.entrydsm.domain.status.aggregates.Status
+import hs.kr.entrydsm.domain.status.aggregates.StatusCache
+import hs.kr.entrydsm.domain.status.interfaces.StatusContract
+import kotlinx.coroutines.runBlocking
+import org.springframework.stereotype.Component
+
+@Component
+class StatusPersistenceAdapter(
+    private val statusGrpcClient: StatusGrpcClient,
+    private val statusCacheRepository: StatusCacheRepository
+) : StatusContract {
+
+    override fun queryStatusByReceiptCode(receiptCode: Long): Status? = runBlocking {
+        statusGrpcClient.getStatusByReceiptCode(receiptCode)?.let {
+            Status(
+                id = it.id,
+                examCode = it.examCode,
+                applicationStatus = it.applicationStatus,
+                isFirstRoundPass = it.isFirstRoundPass,
+                isSecondRoundPass = it.isSecondRoundPass,
+                receiptCode = it.receiptCode
+            )
+        }
+    }
+
+    override fun queryStatusByReceiptCodeInCache(receiptCode: Long): StatusCache? {
+        return statusCacheRepository.findById(receiptCode)
+            .map {
+                StatusCache(
+                    receiptCode = it.receiptCode,
+                    applicationStatus = it.applicationStatus,
+                    examCode = it.examCode,
+                    isFirstRoundPass = it.isFirstRoundPass,
+                    isSecondRoundPass = it.isSecondRoundPass,
+                    ttl = it.ttl
+                )
+            }.orElse(null)
+    }
+
+    override fun updateExamCode(receiptCode: Long, examCode: String) = runBlocking {
+        statusGrpcClient.updateExamCode(receiptCode, examCode)
+    }
+}

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/domain/status/domain/entity/StatusCacheRedisEntity.kt

@@ -0,0 +1,18 @@
+package hs.kr.entrydsm.application.domain.status.domain.entity
+
+import hs.kr.entrydsm.domain.status.values.ApplicationStatus
+import org.springframework.data.annotation.Id
+import org.springframework.data.redis.core.RedisHash
+import org.springframework.data.redis.core.TimeToLive
+
+@RedisHash("status_cache")
+class StatusCacheRedisEntity(
+    @Id
+    val receiptCode: Long,
+    val examCode: String?,
+    val applicationStatus: ApplicationStatus,
+    val isFirstRoundPass: Boolean,
+    val isSecondRoundPass: Boolean,
+    @TimeToLive
+    val ttl: Long
+)

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/domain/status/domain/repository/StatusCacheRepository.kt

@@ -0,0 +1,7 @@
+package hs.kr.entrydsm.application.domain.status.domain.repository
+
+import hs.kr.entrydsm.application.domain.status.domain.entity.StatusCacheRedisEntity
+import org.springframework.data.repository.CrudRepository
+
+interface StatusCacheRepository : CrudRepository<StatusCacheRedisEntity, Long>{
+}

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/domain/user/domain/UserPersistenceAdapter.kt

@@ -0,0 +1,26 @@
+package hs.kr.entrydsm.application.domain.user.domain
+
+import hs.kr.entrydsm.application.global.grpc.client.user.UserGrpcClient
+import hs.kr.entrydsm.domain.user.aggregates.User
+import hs.kr.entrydsm.domain.user.interfaces.UserContract
+import kotlinx.coroutines.runBlocking
+import org.springframework.stereotype.Component
+import java.util.UUID
+
+@Component
+class UserPersistenceAdapter(
+    private val userGrpcClient: UserGrpcClient
+) : UserContract {
+
+    override fun queryUserByUserId(userId: UUID): User = runBlocking {
+        userGrpcClient.getUserInfoByUserId(userId).run {
+            User(
+                id = id,
+                phoneNumber = phoneNumber,
+                name = name,
+                isParent = isParent,
+            )
+        }
+
+    }
+}

casper-application-infrastructure/src/main/kotlin/hs/kr/entrydsm/application/global/document/pdf/config/ConverterPropertiesCreator.kt

@@ -6,10 +6,23 @@ import com.itextpdf.io.font.FontProgramFactory
 import org.springframework.stereotype.Component
 import java.io.IOException
 
+/**
+ * PDF 변환을 위한 변환 속성을 생성하는 클래스입니다.
+ *
+ * iText PDF 라이브러리에서 HTML을 PDF로 변환할 때 필요한 설정을 관리합니다.
+ * 특히 한글 폰트 설정을 담당하여 PDF에서 한글이 정상적으로 표시되도록 합니다.
+ */
 @Component
 class ConverterPropertiesCreator {
     private var fontPath: String = "/fonts/"
 
+    /**
+     * PDF 변환을 위한 ConverterProperties를 생성합니다.
+     * 한글 폰트 설정을 포함하여 PDF 생성 시 필요한 모든 속성을 구성합니다.
+     *
+     * @return 설정된 ConverterProperties 객체
+     * @throws IllegalStateException 폰트 파일을 찾을 수 없는 경우
+     */
     fun createConverterProperties(): ConverterProperties {
         val properties = ConverterProperties()
         val fontProvider = DefaultFontProvider(false, false, false)