merge: (#798) 모범학생 후보 리스트 조회 기능 추가

dms-core/src/main/kotlin/team/aliens/dms/domain/student/service/GetStudentService.kt

@@ -8,6 +8,8 @@ import team.aliens.dms.domain.point.spi.vo.StudentWithPointVO
 import team.aliens.dms.domain.room.model.Room
 import team.aliens.dms.domain.student.model.Student
 import team.aliens.dms.domain.student.spi.vo.AllStudentsVO
+import team.aliens.dms.domain.vote.dto.response.ModelStudentResponse
+import java.time.LocalDate
 import java.util.UUID
 
 interface GetStudentService {
@@ -54,4 +56,7 @@ interface GetStudentService {
     fun getAllStudentsByName(name: String?, schoolId: UUID): List<AllStudentsVO>
 
     fun isApplicant(studentId: UUID): Boolean
+
+    fun getModelStudentList(date: LocalDate): List<ModelStudentResponse>
+
 }

dms-core/src/main/kotlin/team/aliens/dms/domain/student/service/GetStudentServiceImpl.kt

@@ -12,6 +12,9 @@ import team.aliens.dms.domain.student.exception.StudentNotFoundException
 import team.aliens.dms.domain.student.exception.StudentUpdateInfoNotFoundException
 import team.aliens.dms.domain.student.model.Student
 import team.aliens.dms.domain.student.spi.QueryStudentPort
+import team.aliens.dms.domain.vote.dto.response.ModelStudentResponse
+import team.aliens.dms.domain.vote.exception.validateStudentList
+import java.time.LocalDate
 import java.util.UUID
 import java.util.function.Function
 
@@ -136,4 +139,30 @@ class GetStudentServiceImpl(
             }
         }
     }
+
+    override fun getModelStudentList(date: LocalDate): List<ModelStudentResponse> {
+        val firstDayOfMonth = date.withDayOfMonth(1)
+        val lastDayOfMonth = date.withDayOfMonth(date.lengthOfMonth())
+
+        val startOfDay = firstDayOfMonth.atStartOfDay()
+        val endOfDay = lastDayOfMonth.atTime(23, 59, 59)
+
+        val modelStudentList = queryStudentPort.queryModelStudents(startOfDay, endOfDay)
+
+        if (modelStudentList.isEmpty()) {
+            throw StudentNotFoundException
+        }
+
+        validateStudentList(modelStudentList)
+
+        return modelStudentList.map { student ->
+            ModelStudentResponse(
+                id = student.id,
+                gcn = student.studentGcn,
+                name = student.studentName,
+                profileImageUrl = student.studentProfile
+            )
+        }
+    }
+
 }

dms-core/src/main/kotlin/team/aliens/dms/domain/student/spi/QueryStudentPort.kt

@@ -6,6 +6,8 @@ import team.aliens.dms.domain.manager.spi.vo.StudentWithTag
 import team.aliens.dms.domain.point.spi.vo.StudentWithPointVO
 import team.aliens.dms.domain.student.model.Student
 import team.aliens.dms.domain.student.spi.vo.AllStudentsVO
+import team.aliens.dms.domain.student.spi.vo.ModelStudentVO
+import java.time.LocalDateTime
 import java.util.UUID
 
 interface QueryStudentPort {
@@ -41,4 +43,7 @@ interface QueryStudentPort {
     fun queryAllStudentsByIdsIn(studentIds: List<UUID>): List<Student>
 
     fun queryAllStudentsByName(name: String?, schoolId: UUID): List<AllStudentsVO>
+
+    fun queryModelStudents(startOfDay: LocalDateTime, endOfDay: LocalDateTime): List<ModelStudentVO>
+
 }

dms-core/src/main/kotlin/team/aliens/dms/domain/student/spi/vo/ModelStudentVO.kt

@@ -0,0 +1,11 @@
+package team.aliens.dms.domain.student.spi.vo
+
+import java.util.UUID
+
+data class ModelStudentVO(
+    val id: UUID,
+    val studentGcn: String,
+    val studentName: String,
+    val studentProfile: String?
+
+)

dms-core/src/main/kotlin/team/aliens/dms/domain/student/usecase/GetModelStudentsUseCase.kt

@@ -0,0 +1,17 @@
+package team.aliens.dms.domain.student.usecase
+
+import org.springframework.beans.factory.annotation.Qualifier
+import team.aliens.dms.common.annotation.ReadOnlyUseCase
+import team.aliens.dms.domain.student.service.GetStudentService
+import team.aliens.dms.domain.vote.dto.response.ModelStudentResponse
+import java.time.LocalDate
+
+@ReadOnlyUseCase
+class GetModelStudentsUseCase(
+    @Qualifier("getStudentServiceImpl") private val getStudentService: GetStudentService
+) {
+    fun execute(date: LocalDate): List<ModelStudentResponse> {
+        return getStudentService.getModelStudentList(date)
+    }
+
+}

dms-core/src/main/kotlin/team/aliens/dms/domain/vote/dto/request/ModelStudentListRequest.kt

@@ -0,0 +1,8 @@
+package team.aliens.dms.domain.vote.dto.request
+
+import java.time.LocalDate
+
+data class ModelStudentListRequest(
+    val date: LocalDate
+
+)

dms-core/src/main/kotlin/team/aliens/dms/domain/vote/dto/response/ModelStudentResponse.kt

@@ -0,0 +1,11 @@
+package team.aliens.dms.domain.vote.dto.response
+
+import java.util.UUID
+
+data class ModelStudentResponse(
+    val id: UUID,
+    val gcn: String,
+    val name: String,
+    val profileImageUrl: String?
+
+)

dms-core/src/main/kotlin/team/aliens/dms/domain/vote/dto/response/ModelStudentsResponse.kt

@@ -0,0 +1,6 @@
+package team.aliens.dms.domain.vote.dto.response
+
+data class ModelStudentsResponse(
+    val students: List<ModelStudentResponse>
+
+)

dms-core/src/main/kotlin/team/aliens/dms/domain/vote/exception/VoteErrorCode.kt

@@ -0,0 +1,19 @@
+package team.aliens.dms.domain.vote.exception
+
+import team.aliens.dms.common.error.ErrorProperty
+import team.aliens.dms.common.error.ErrorStatus
+
+enum class VoteErrorCode(
+    private val status: Int,
+    private val message: String,
+    private val sequence: Int
+) : ErrorProperty {
+
+    STUDENT_NOT_FOUND(ErrorStatus.NOT_FOUND, "Student Not Found", 1),
+    STUDENT_ID_NOT_FOUND(ErrorStatus.BAD_REQUEST, "Student ID Not Found", 2)
+    ;
+
+    override fun status(): Int = status
+    override fun message(): String = message
+    override fun code(): String = "Vote-$status-$sequence"
+}

dms-core/src/main/kotlin/team/aliens/dms/domain/vote/exception/VoteExceptions.kt

@@ -0,0 +1,18 @@
+package team.aliens.dms.domain.vote.exception
+
+import team.aliens.dms.common.error.DmsException
+import team.aliens.dms.domain.student.spi.vo.ModelStudentVO
+
+object StudentNotFoundException : DmsException(
+    VoteErrorCode.STUDENT_NOT_FOUND
+)
+
+object StudentIdNotFoundException : DmsException(
+    VoteErrorCode.STUDENT_ID_NOT_FOUND
+)
+
+fun validateStudentList(modelStudentList: List<ModelStudentVO>) {
+    if (modelStudentList.isEmpty()) {
+        throw StudentNotFoundException
+    }
+}

dms-infrastructure/src/main/kotlin/team/aliens/dms/global/security/SecurityConfig.kt

@@ -1,5 +1,6 @@
 package team.aliens.dms.global.security
 
+import org.apache.http.protocol.HTTP
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration
 import org.springframework.http.HttpMethod
@@ -223,6 +224,10 @@ class SecurityConfig(
                     .requestMatchers(HttpMethod.GET, "/volunteers").hasAuthority(STUDENT.name)
                     .requestMatchers(HttpMethod.GET, "/volunteers/my/application").hasAuthority(STUDENT.name)
 
+                authorize
+                    // /vote
+                    .requestMatchers(HttpMethod.GET, "/vote/candidate-list/{requestDate}").hasAnyAuthority(MANAGER.name)
+
                 .anyRequest().denyAll()
             }
         http

dms-persistence/src/main/kotlin/team/aliens/dms/persistence/student/StudentPersistenceAdapter.kt

@@ -17,10 +17,13 @@ import team.aliens.dms.domain.manager.dto.PointFilter
 import team.aliens.dms.domain.manager.dto.PointFilterType
 import team.aliens.dms.domain.manager.dto.Sort
 import team.aliens.dms.domain.manager.spi.vo.StudentWithTag
+import team.aliens.dms.domain.point.model.PointType
 import team.aliens.dms.domain.point.spi.vo.StudentWithPointVO
 import team.aliens.dms.domain.student.model.Student
 import team.aliens.dms.domain.student.spi.StudentPort
 import team.aliens.dms.domain.student.spi.vo.AllStudentsVO
+import team.aliens.dms.domain.student.spi.vo.ModelStudentVO
+import team.aliens.dms.persistence.point.entity.QPointHistoryJpaEntity
 import team.aliens.dms.persistence.point.entity.QPointHistoryJpaEntity.pointHistoryJpaEntity
 import team.aliens.dms.persistence.room.entity.QRoomJpaEntity.roomJpaEntity
 import team.aliens.dms.persistence.student.entity.QStudentJpaEntity.studentJpaEntity
@@ -32,6 +35,7 @@ import team.aliens.dms.persistence.student.repository.vo.QQueryStudentsWithTagVO
 import team.aliens.dms.persistence.tag.entity.QStudentTagJpaEntity.studentTagJpaEntity
 import team.aliens.dms.persistence.tag.entity.QTagJpaEntity.tagJpaEntity
 import team.aliens.dms.persistence.tag.mapper.TagMapper
+import java.time.LocalDateTime
 import java.util.UUID
 
 @Component
@@ -40,6 +44,7 @@ class StudentPersistenceAdapter(
     private val tagMapper: TagMapper,
     private val studentRepository: StudentJpaRepository,
     private val queryFactory: JPAQueryFactory,
+    private val studentJpaRepository: StudentJpaRepository,
 ) : StudentPort {
 
     override fun queryStudentBySchoolIdAndGcn(
@@ -385,4 +390,45 @@ class StudentPersistenceAdapter(
             )
             .fetch()
     }
+
+    override fun queryModelStudents(startOfDay: LocalDateTime, endOfDay: LocalDateTime): List<ModelStudentVO> {
+
+        val penalizedStudentGcn = findPenalizedStudentGcn(startOfDay, endOfDay)
+
+        val students = studentJpaRepository.findAll()
+
+        return students
+            .mapNotNull { student ->
+                student.id?.let {
+                    val gcn = createGcn(student.grade, student.classRoom, student.number)
+                    ModelStudentVO(
+                        id = it,
+                        studentGcn = gcn,
+                        studentName = student.name,
+                        studentProfile = student.profileImageUrl
+                    )
+                }
+            }
+            .filter { it.studentGcn !in penalizedStudentGcn }
+    }
+
+    private fun findPenalizedStudentGcn(startOfDay: LocalDateTime, endOfDay: LocalDateTime): List<String> {
+        return queryFactory
+            .select(
+                QPointHistoryJpaEntity.pointHistoryJpaEntity.studentGcn
+            )
+            .from(QPointHistoryJpaEntity.pointHistoryJpaEntity)
+            .where(
+                QPointHistoryJpaEntity.pointHistoryJpaEntity.isCancel.isFalse,
+                QPointHistoryJpaEntity.pointHistoryJpaEntity.pointType.eq(PointType.MINUS),
+                QPointHistoryJpaEntity.pointHistoryJpaEntity.createdAt.between(startOfDay, endOfDay)
+            )
+            .fetch()
+    }
+
+    private fun createGcn(grade: Int, classRoom: Int, number: Int): String {
+        val formattedNumber = String.format("%02d", number)
+        return "$grade$classRoom$formattedNumber"
+    }
+
 }

dms-presentation/src/main/kotlin/team/aliens/dms/domain/student/StudentWebAdapter.kt

@@ -5,6 +5,7 @@ import jakarta.validation.Valid
 import jakarta.validation.constraints.Email
 import jakarta.validation.constraints.NotBlank
 import jakarta.validation.constraints.NotNull
+import org.springframework.format.annotation.DateTimeFormat
 import org.springframework.http.HttpStatus
 import org.springframework.validation.annotation.Validated
 import org.springframework.web.bind.annotation.DeleteMapping
@@ -40,20 +41,23 @@ import team.aliens.dms.domain.student.dto.request.UpdateStudentProfileWebRequest
 import team.aliens.dms.domain.student.usecase.CheckDuplicatedAccountIdUseCase
 import team.aliens.dms.domain.student.usecase.CheckDuplicatedEmailUseCase
 import team.aliens.dms.domain.student.usecase.CheckStudentGcnUseCase
-import team.aliens.dms.domain.student.usecase.ExportStudentUseCase
+import team.aliens.dms.domain.student.usecase.SignUpUseCase
 import team.aliens.dms.domain.student.usecase.FindStudentAccountIdUseCase
-import team.aliens.dms.domain.student.usecase.ImportStudentUseCase
-import team.aliens.dms.domain.student.usecase.ManagerGetAllStudentsUseCase
-import team.aliens.dms.domain.student.usecase.QueryStudentDetailsUseCase
-import team.aliens.dms.domain.student.usecase.RemoveStudentUseCase
 import team.aliens.dms.domain.student.usecase.ResetStudentPasswordUseCase
-import team.aliens.dms.domain.student.usecase.SignUpUseCase
-import team.aliens.dms.domain.student.usecase.StudentGetAllStudentsUseCase
+import team.aliens.dms.domain.student.usecase.UpdateStudentProfileUseCase
 import team.aliens.dms.domain.student.usecase.StudentMyPageUseCase
 import team.aliens.dms.domain.student.usecase.StudentWithdrawalUseCase
+import team.aliens.dms.domain.student.usecase.ExportStudentUseCase
+import team.aliens.dms.domain.student.usecase.ManagerGetAllStudentsUseCase
+import team.aliens.dms.domain.student.usecase.QueryStudentDetailsUseCase
+import team.aliens.dms.domain.student.usecase.RemoveStudentUseCase
 import team.aliens.dms.domain.student.usecase.UpdateStudentGcnByFileUseCase
-import team.aliens.dms.domain.student.usecase.UpdateStudentProfileUseCase
 import team.aliens.dms.domain.student.usecase.UpdateStudentRoomByFileUseCase
+import team.aliens.dms.domain.student.usecase.ImportStudentUseCase
+import team.aliens.dms.domain.student.usecase.StudentGetAllStudentsUseCase
+import team.aliens.dms.domain.student.usecase.GetModelStudentsUseCase
+import team.aliens.dms.domain.vote.dto.response.ModelStudentsResponse
+import java.time.LocalDate
 import java.util.UUID
 
 @Validated
@@ -76,7 +80,8 @@ class StudentWebAdapter(
     private val updateStudentGcnByFileUseCase: UpdateStudentGcnByFileUseCase,
     private val updateStudentRoomByFileUseCase: UpdateStudentRoomByFileUseCase,
     private val importStudentUseCase: ImportStudentUseCase,
-    private val studentGetAllStudentsUseCase: StudentGetAllStudentsUseCase
+    private val studentGetAllStudentsUseCase: StudentGetAllStudentsUseCase,
+    private val getModelStudentsUseCase: GetModelStudentsUseCase
 ) {
 
     @ResponseStatus(HttpStatus.CREATED)
@@ -237,4 +242,15 @@ class StudentWebAdapter(
     fun studentGetAllStudents(@RequestParam(required = false) name: String?): StudentsResponse {
         return studentGetAllStudentsUseCase.execute(name)
     }
+
+    @GetMapping("/candidate-list")
+    fun getModelStudents(
+        @RequestParam
+        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
+        date: LocalDate
+    ): ModelStudentsResponse {
+        val students = getModelStudentsUseCase.execute(date)
+        return ModelStudentsResponse(students = students)
+    }
+
 }