[FEAT] 동아리 추가 기능 구현

composeApp/src/commonMain/kotlin/org/whosin/client/data/dto/response/AddClubResponseDto.kt

@@ -0,0 +1,16 @@
+package org.whosin.client.data.dto.response
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class AddClubResponseDto(
+    @SerialName("success")
+    val success: Boolean,
+    @SerialName("status")
+    val status: Int,
+    @SerialName("message")
+    val message: String,
+    @SerialName("data")
+    val data: String? = null
+)

composeApp/src/commonMain/kotlin/org/whosin/client/data/dto/response/ClubCodeConfirmResponseDto.kt

@@ -0,0 +1,24 @@
+package org.whosin.client.data.dto.response
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class ClubCodeConfirmResponseDto(
+    @SerialName("success")
+    val success: Boolean,
+    @SerialName("status")
+    val status: Int,
+    @SerialName("message")
+    val message: String,
+    @SerialName("data")
+    val data: ClubCodeConfirmData
+)
+
+@Serializable
+data class ClubCodeConfirmData(
+    @SerialName("clubId")
+    val clubId: Int,
+    @SerialName("clubName")
+    val clubName: String
+)

composeApp/src/commonMain/kotlin/org/whosin/client/data/dto/response/ErrorResponseDto.kt

@@ -0,0 +1,16 @@
+package org.whosin.client.data.dto.response
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class ErrorResponseDto(
+    @SerialName("success")
+    val success: Boolean,
+    @SerialName("status")
+    val status: Int,
+    @SerialName("message")
+    val message: String,
+    @SerialName("timestamp")
+    val timestamp: String? = null
+)

composeApp/src/commonMain/kotlin/org/whosin/client/data/remote/RemoteClubDataSource.kt

@@ -4,11 +4,16 @@ import io.ktor.client.HttpClient
 import io.ktor.client.call.body
 import io.ktor.client.request.delete
 import io.ktor.client.request.get
+import io.ktor.client.request.parameter
 import io.ktor.client.request.post
 import io.ktor.client.statement.HttpResponse
 import io.ktor.http.isSuccess
+import io.ktor.http.parameters
 import org.whosin.client.core.network.ApiResult
+import org.whosin.client.data.dto.response.AddClubResponseDto
+import org.whosin.client.data.dto.response.ClubCodeConfirmResponseDto
 import org.whosin.client.data.dto.response.ClubPresencesResponseDto
+import org.whosin.client.data.dto.response.ErrorResponseDto
 import org.whosin.client.data.dto.response.MyClubResponseDto
 
 class RemoteClubDataSource(
@@ -93,4 +98,68 @@ class RemoteClubDataSource(
             ApiResult.Error(message = t.message, cause = t)
         }
     }
+
+    // 동아리 번호 확인
+    suspend fun confirmClubCode(clubCode: String): ApiResult<ClubCodeConfirmResponseDto>{
+        return try {
+            val response: HttpResponse = client.get(urlString = "clubs"){
+                parameter("clubNumber", clubCode)
+            }
+
+            if (response.status.isSuccess()) {
+                ApiResult.Success(
+                    data = response.body(),
+                    statusCode = response.status.value
+                )
+            } else {
+                // 에러 응답 파싱 시도
+                try {
+                    val errorResponse: ErrorResponseDto = response.body()
+                    ApiResult.Error(
+                        code = response.status.value,
+                        message = errorResponse.message
+                    )
+                } catch (e: Exception) {
+                    // 파싱 실패 시 기본 에러 메시지
+                    ApiResult.Error(
+                        code = response.status.value,
+                        message = "HTTP Error: ${response.status.value}"
+                    )
+                }
+            }
+        } catch (t: Throwable){
+            ApiResult.Error(message = t.message, cause = t)
+        }
+    }
+
+    // 동아리 추가 함수
+    suspend fun addClub(clubId: Int): ApiResult<AddClubResponseDto> {
+        return try {
+            val response: HttpResponse = client.post(urlString = "clubs/$clubId")
+
+            if (response.status.isSuccess()) {
+                ApiResult.Success(
+                    data = response.body(),
+                    statusCode = response.status.value
+                )
+            } else {
+                // 에러 응답 파싱 시도
+                try {
+                    val errorResponse: ErrorResponseDto = response.body()
+                    ApiResult.Error(
+                        code = response.status.value,
+                        message = errorResponse.message
+                    )
+                } catch (e: Exception) {
+                    // 파싱 실패 시 기본 에러 메시지
+                    ApiResult.Error(
+                        code = response.status.value,
+                        message = "HTTP Error: ${response.status.value}"
+                    )
+                }
+            }
+        } catch (t: Throwable){
+            ApiResult.Error(message = t.message, cause = t)
+        }
+    }
 }

composeApp/src/commonMain/kotlin/org/whosin/client/data/repository/ClubRepository.kt

@@ -1,6 +1,8 @@
 package org.whosin.client.data.repository
 
 import org.whosin.client.core.network.ApiResult
+import org.whosin.client.data.dto.response.AddClubResponseDto
+import org.whosin.client.data.dto.response.ClubCodeConfirmResponseDto
 import org.whosin.client.data.dto.response.ClubPresencesResponseDto
 import org.whosin.client.data.dto.response.MyClubResponseDto
 import org.whosin.client.data.remote.RemoteClubDataSource
@@ -19,4 +21,10 @@ class ClubRepository(
 
     suspend fun checkOut(clubId: Int): ApiResult<Unit> =
         dataSource.checkOut(clubId)
+
+    suspend fun confirmClubCode(clubCode: String): ApiResult<ClubCodeConfirmResponseDto> =
+        dataSource.confirmClubCode(clubCode)
+
+    suspend fun addClub(clubId: Int): ApiResult<AddClubResponseDto> =
+        dataSource.addClub(clubId)
 }

composeApp/src/commonMain/kotlin/org/whosin/client/di/DIModules.kt

@@ -10,6 +10,7 @@ import org.whosin.client.data.remote.RemoteMemberDataSource
 import org.whosin.client.data.repository.DummyRepository
 import org.whosin.client.data.repository.ClubRepository
 import org.whosin.client.data.repository.MemberRepository
+import org.whosin.client.presentation.auth.clubcode.AddClubViewModel
 import org.whosin.client.presentation.dummy.DummyViewModel
 import org.whosin.client.presentation.dummy.TokenTestViewModel
 import org.whosin.client.presentation.auth.login.viewmodel.LoginViewModel
@@ -49,4 +50,5 @@ val viewModelModule = module {
     viewModelOf(::MyPageViewModel)
     viewModelOf(::DummyViewModel) // TODO: 이후에 삭제 예정
     viewModelOf(::TokenTestViewModel) // TODO: 이후에 삭제 예정
+    viewModelOf(::AddClubViewModel)
 }

composeApp/src/commonMain/kotlin/org/whosin/client/presentation/auth/clubcode/AddClubViewModel.kt

@@ -0,0 +1,96 @@
+package org.whosin.client.presentation.auth.clubcode
+
+import androidx.lifecycle.ViewModel
+import androidx.lifecycle.viewModelScope
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.flow.update
+import kotlinx.coroutines.launch
+import org.whosin.client.core.network.ApiResult
+import org.whosin.client.data.repository.ClubRepository
+
+data class AddClubUiState(
+    val isLoading: Boolean = false,
+    val verificationState: ClubCodeState = ClubCodeState.INPUT,
+    val clubName: String? = null,
+    val clubId: Int? = null,
+    val errorMessage: String? = null,
+    val isAddClubSuccess: Boolean = false
+)
+
+class AddClubViewModel(
+    private val repository: ClubRepository
+) : ViewModel() {
+    private val _uiState = MutableStateFlow(AddClubUiState())
+    val uiState: StateFlow<AddClubUiState> = _uiState.asStateFlow()
+
+    fun confirmClubCode(clubCode: String) {
+        viewModelScope.launch {
+            _uiState.update { it.copy(isLoading = true) }
+            when (val result = repository.confirmClubCode(clubCode = clubCode)) {
+                is ApiResult.Success -> {
+                    val response = result.data.data
+                    _uiState.update {
+                        it.copy(
+                            isLoading = false,
+                            verificationState = ClubCodeState.SUCCESS,
+                            clubName = response.clubName,
+                            clubId = response.clubId,
+                            errorMessage = null
+                        )
+                    }
+                    println("AddClubViewModel : 조회 성공")
+                }
+                is ApiResult.Error -> {
+                    _uiState.update {
+                        it.copy(
+                            isLoading = false,
+                            verificationState = ClubCodeState.ERROR,
+                            errorMessage = result.message?: "동아리 이름 조회에 오류가 발생했습니다."
+                        )
+                    }
+                    println("AddClubViewModel : 조회 실패")
+                }
+            }
+        }
+    }
+
+    // 에러 상태 리셋 함수
+    fun resetErrorState() {
+        _uiState.update {
+            it.copy(
+                verificationState = ClubCodeState.INPUT,
+                errorMessage = null,
+                clubName = null,
+                clubId = null
+            )
+        }
+    }
+
+    // 동아리 추가 함수
+    fun addClub(clubId: Int) {
+        viewModelScope.launch {
+            _uiState.update { it.copy(isLoading = true) }
+            when (val result = repository.addClub(clubId = clubId)) {
+                is ApiResult.Success -> {
+                    _uiState.update {
+                        it.copy(
+                            isLoading = false,
+                            errorMessage = null,
+                            isAddClubSuccess = true
+                        )
+                    }
+                }
+                is ApiResult.Error -> {
+                    _uiState.update {
+                        it.copy(
+                            isLoading = false,
+                            errorMessage = result.message ?: "동아리 추가에 오류가 발생했습니다."
+                        )
+                    }
+                }
+            }
+        }
+    }
+}