feat: 설문 생성 API

project/taehwan-onboarding/.editorconfig

@@ -0,0 +1,13 @@
+root = true
+
+[*]
+charset=utf-8
+end_of_line=lf
+indent_style=space
+indent_size=4
+insert_final_newline=true
+
+[*.{kt,kts}]
+insert_final_newline=false
+disabled_rules=no-wildcard-imports
+ktlint_standard_no-blank-line-in-list = disabled

project/taehwan-onboarding/README.md

@@ -156,7 +156,7 @@ Apply
 
 ```
 2. 플러그인 설치 후 build를 수행하면 로컬 설정에 따라 에러가 발생할 수 있다.
-   ![img.png](img.png)
+![img.png](img.png)
 3. 아래 명령어로 lint 설정에 맞도록 자동 수정할 수 있다
 ```shell
 ./gradlew ktlintFormat

project/taehwan-onboarding/build.gradle.kts

@@ -47,4 +47,4 @@ kotlin {
 
 tasks.withType<Test> {
     useJUnitPlatform()
-}
+}

project/taehwan-onboarding/settings.gradle.kts

@@ -1 +1 @@
-rootProject.name = "taehwan-onboarding"
+rootProject.name = "taehwan-onboarding"

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/TaehwanOnboardingApplication.kt

@@ -8,4 +8,4 @@ class TaehwanOnboardingApplication
 
 fun main(args: Array<String>) {
     runApplication<TaehwanOnboardingApplication>(*args)
-}
+}

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/api/dto/SurveyDto.kt

@@ -0,0 +1,34 @@
+package org.survey.taehwanonboarding.api.dto
+
+data class SurveyCreateRequest(
+    val title: String,
+    val description: String? = null,
+    val questions: List<QuestionRequest>
+)
+
+data class QuestionRequest(
+    val title: String,
+    val description: String? = null,
+    val required: Boolean = false,
+    val orderNumber: Int = 0,
+    val type: QuestionType,
+    val options: List<String>? = null,
+    val maxLength: Int? = null,
+    val minSelections: Int? = null,
+    val maxSelections: Int? = null
+)
+
+enum class QuestionType {
+    SHORT_ANSWER,
+    LONG_ANSWER,
+    SINGLE_SELECTION,
+    MULTI_SELECTION
+}
+
+data class SurveyCreateResponse(
+    val id: Long,
+    val title: String,
+    val description: String?,
+    val status: String,
+    val createdAt: String
+)

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/domain/entity/response/SurveyResponse.kt

@@ -0,0 +1,61 @@
+package org.survey.taehwanonboarding.domain.entity.response
+
+import jakarta.persistence.Column
+import jakarta.persistence.Entity
+import jakarta.persistence.EntityListeners
+import jakarta.persistence.EnumType
+import jakarta.persistence.Enumerated
+import jakarta.persistence.FetchType
+import jakarta.persistence.GeneratedValue
+import jakarta.persistence.GenerationType
+import jakarta.persistence.Id
+import jakarta.persistence.JoinColumn
+import jakarta.persistence.ManyToOne
+import jakarta.persistence.OneToMany
+import jakarta.persistence.Table
+import jakarta.persistence.Version
+import org.springframework.data.annotation.CreatedDate
+import org.springframework.data.jpa.domain.support.AuditingEntityListener
+import org.survey.taehwanonboarding.domain.entity.survey.Survey
+import java.time.LocalDateTime
+
+@EntityListeners(AuditingEntityListener::class)
+@Entity
+@Table(name = "survey_response")
+class SurveyResponse(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    val id: Long? = null,
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "survey_id", nullable = false)
+    val survey: Survey,
+
+    // todo: 익명 응답 고려
+    @Column
+    var respondentId: String? = null,
+
+    @Version
+    var version: Long = 0,
+
+    @CreatedDate
+    @Column(updatable = false)
+    var responseAt: LocalDateTime? = null,
+
+    @Enumerated(EnumType.STRING)
+    var status: ResponseStatus = ResponseStatus.SUBMITTED,
+
+    // todo: cascade 고려
+    @OneToMany(mappedBy = "response")
+    var items: MutableList<SurveyResponseItem> = mutableListOf(),
+) {
+    enum class ResponseStatus {
+        PENDING,
+        SUBMITTED,
+    }
+
+    fun addResponseItem(item: SurveyResponseItem) {
+        items.add(item)
+        item.response = this
+    }
+}

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/domain/entity/response/SurveyResponseItem.kt

@@ -0,0 +1,34 @@
+package org.survey.taehwanonboarding.domain.entity.response
+
+import jakarta.persistence.Column
+import jakarta.persistence.Entity
+import jakarta.persistence.FetchType
+import jakarta.persistence.GeneratedValue
+import jakarta.persistence.GenerationType
+import jakarta.persistence.Id
+import jakarta.persistence.JoinColumn
+import jakarta.persistence.ManyToOne
+import jakarta.persistence.Table
+import org.survey.taehwanonboarding.domain.entity.survey.SurveyItem
+
+@Entity
+@Table(name = "response_item")
+class SurveyResponseItem(
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    val id: Long? = null,
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "survey_response_id")
+    var response: SurveyResponse? = null,
+
+    @ManyToOne(fetch = FetchType.LAZY)
+    @JoinColumn(name = "survey_item_id", nullable = false)
+    val surveyItem: SurveyItem,
+
+    // todo: 단일 값 또는 쉼표로 구분된 다중 값으로 우선 고려
+    @Column
+    var value: String? = null,
+) {
+    fun isValid(): Boolean = surveyItem.validateResponse(value)
+}

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/domain/entity/survey/LongAnswerItem.kt

@@ -0,0 +1,28 @@
+package org.survey.taehwanonboarding.domain.entity.survey
+
+import jakarta.persistence.Column
+import jakarta.persistence.DiscriminatorValue
+import jakarta.persistence.Entity
+
+@Entity
+@DiscriminatorValue("LONG_ANSWER")
+class LongAnswerItem(
+    title: String,
+    description: String? = null,
+    required: Boolean = false,
+    orderNumber: Int = 0,
+    @Column
+    var maxLength: Int? = 1000,
+
+) : SurveyItem(
+        title = title,
+        description = description,
+        required = required,
+        orderNumber = orderNumber,
+    ) {
+    override fun validateResponse(responseValue: String?): Boolean {
+        if (required && responseValue.isNullOrBlank()) return false
+        return responseValue == null ||
+            (maxLength == null || responseValue.length <= maxLength!!)
+    }
+}

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/domain/entity/survey/MultiSelectionItem.kt

@@ -0,0 +1,57 @@
+package org.survey.taehwanonboarding.domain.entity.survey
+
+import jakarta.persistence.CollectionTable
+import jakarta.persistence.Column
+import jakarta.persistence.DiscriminatorValue
+import jakarta.persistence.ElementCollection
+import jakarta.persistence.Entity
+import jakarta.persistence.JoinColumn
+import jakarta.persistence.OrderColumn
+
+@Entity
+@DiscriminatorValue("MULTI_SELECTION")
+class MultiSelectionItem(
+    title: String,
+    description: String? = null,
+    required: Boolean = false,
+    orderNumber: Int = 0,
+
+    @ElementCollection
+    @CollectionTable(
+        name = "item_option",
+        joinColumns = [JoinColumn(name = "survey_item_id")],
+    )
+    @OrderColumn(name = "order")
+    var options: MutableList<String> = mutableListOf(),
+
+    @Column
+    var minSelections: Int? = null,
+
+    @Column
+    var maxSelections: Int? = null,
+) : SurveyItem(
+        title = title,
+        description = description,
+        required = required,
+        orderNumber = orderNumber,
+    ) {
+    override fun validateResponse(responseValue: String?): Boolean {
+        if (responseValue.isNullOrBlank()) {
+            return !required
+        }
+
+        val selectedOptions = responseValue.split(",").map { it.trim() }
+
+        // 선택한 옵션 검증
+        if (!selectedOptions.all { options.contains(it) }) {
+            return false
+        }
+
+        val count = selectedOptions.size
+        if (required && count == 0) return false
+        if (minSelections != null && count < minSelections!!) return false
+        if (maxSelections != null && count > maxSelections!!) return false
+
+        return true
+    }
+}

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/domain/entity/survey/ShortAnswerItem.kt

@@ -0,0 +1,28 @@
+package org.survey.taehwanonboarding.domain.entity.survey
+
+import jakarta.persistence.Column
+import jakarta.persistence.DiscriminatorValue
+import jakarta.persistence.Entity
+
+@Entity
+@DiscriminatorValue("SHORT_ANSWER")
+class ShortAnswerItem(
+    title: String,
+    description: String? = null,
+    required: Boolean = false,
+    orderNumber: Int = 0,
+
+    @Column
+    var maxLength: Int? = 255,
+) : SurveyItem(
+        title = title,
+        description = description,
+        required = required,
+        orderNumber = orderNumber,
+    ) {
+    override fun validateResponse(responseValue: String?): Boolean {
+        if (required && responseValue.isNullOrBlank()) return false
+        return responseValue == null ||
+            (maxLength == null || responseValue.length <= maxLength!!)
+    }
+}

project/taehwan-onboarding/src/main/kotlin/org/survey/taehwanonboarding/domain/entity/survey/SingleSelectionItem.kt

@@ -0,0 +1,35 @@
+package org.survey.taehwanonboarding.domain.entity.survey
+
+import jakarta.persistence.CollectionTable
+import jakarta.persistence.DiscriminatorValue
+import jakarta.persistence.ElementCollection
+import jakarta.persistence.Entity
+import jakarta.persistence.JoinColumn
+import jakarta.persistence.OrderColumn
+
+@Entity
+@DiscriminatorValue("SINGLE_SELECTION")
+class SingleSelectionItem(
+    title: String,
+    description: String? = null,
+    required: Boolean = false,
+    orderNumber: Int = 0,
+
+    @ElementCollection
+    @CollectionTable(
+        name = "survey_item_options",
+        joinColumns = [JoinColumn(name = "survey_item_id")],
+    )
+    @OrderColumn(name = "order")
+    var options: MutableList<String> = mutableListOf(),
+) : SurveyItem(
+        title = title,
+        description = description,
+        required = required,
+        orderNumber = orderNumber,
+    ) {
+    override fun validateResponse(responseValue: String?): Boolean {
+        if (required && responseValue.isNullOrBlank()) return false
+        return responseValue == null || options.contains(responseValue)
+    }
+}