✨ feat: 회원 탈퇴 API 구현 (API-028) (#57)

* ✨ feat: 회원 탈퇴 API 구현 (API-028)

- DELETE /api/v1/members/me 엔드포인트 추가
- 회원 삭제 시 연관 데이터(답변, 회고 등) 유지 (ON DELETE SET NULL)
- member_id를 Option<i64>로 변경하여 탈퇴 멤버 처리
- 트랜잭션으로 refresh_token과 member 삭제 원자적 처리
- Terraform S3 backend 마이그레이션 (v2)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

* 🎨 style: cargo fmt 적용

* 🔀 merge: dev 병합 및 member_response Option 처리

* 🐛 fix: PDF에 탈퇴 멤버 표시 및 AI 분석 빈 데이터 검증 추가

* 🐛 fix: 탈퇴 멤버로 인한 카테고리 필터링 fallback 추가

---------

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: catturtle123

ci/terraform/backend.tf

@@ -16,14 +16,14 @@
 #
 # =============================================================================
 
-# 1단계 완료 후 주석 해제하세요
+# S3 Backend 활성화됨
 terraform {
   backend "s3" {
-    bucket         = "web-team-3-terraform-state"
+    bucket         = "web-team-3-tf-state-v2"
     key            = "terraform.tfstate"
     region         = "ap-northeast-2"
     encrypt        = true
-    dynamodb_table = "web-team-3-terraform-lock"
+    dynamodb_table = "web-team-3-tf-lock-v2"
   }
 }
 
@@ -32,10 +32,10 @@ terraform {
 # =============================================================================
 
 resource "aws_s3_bucket" "terraform_state" {
-  bucket = "${var.project_name}-terraform-state"
+  bucket = "web-team-3-tf-state-v2"
 
   tags = {
-    Name = "${var.project_name}-terraform-state"
+    Name = "web-team-3-tf-state-v2"
   }
 }
 
@@ -65,7 +65,7 @@ resource "aws_s3_bucket_public_access_block" "terraform_state" {
 }
 
 resource "aws_dynamodb_table" "terraform_lock" {
-  name         = "${var.project_name}-terraform-lock"
+  name         = "web-team-3-tf-lock-v2"
   billing_mode = "PAY_PER_REQUEST"
   hash_key     = "LockID"
 
@@ -75,6 +75,6 @@ resource "aws_dynamodb_table" "terraform_lock" {
   }
 
   tags = {
-    Name = "${var.project_name}-terraform-lock"
+    Name = "web-team-3-tf-lock-v2"
   }
 }

ci/terraform/rds.tf

@@ -77,8 +77,8 @@ resource "aws_db_instance" "main" {
   publicly_accessible    = false
   multi_az               = var.db_multi_az
 
-  # 백업 설정
-  backup_retention_period = 7
+  # 백업 설정 (프리티어: 0으로 설정)
+  backup_retention_period = 0
   backup_window           = "03:00-04:00"
   maintenance_window      = "Mon:04:00-Mon:05:00"
 

codes/server/src/domain/member/dto.rs

@@ -0,0 +1,25 @@
+use serde::Serialize;
+use utoipa::ToSchema;
+
+use crate::utils::BaseResponse;
+
+/// 회원 탈퇴 성공 응답 (Swagger 문서용)
+#[derive(Debug, Serialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct SuccessWithdrawResponse {
+    pub is_success: bool,
+    pub code: String,
+    pub message: String,
+    pub result: Option<()>,
+}
+
+impl From<BaseResponse<()>> for SuccessWithdrawResponse {
+    fn from(res: BaseResponse<()>) -> Self {
+        Self {
+            is_success: res.is_success,
+            code: res.code,
+            message: res.message,
+            result: res.result,
+        }
+    }
+}

codes/server/src/domain/member/entity/member_response.rs

@@ -6,7 +6,7 @@ use serde::{Deserialize, Serialize};
 pub struct Model {
     #[sea_orm(primary_key)]
     pub member_response_id: i64,
-    pub member_id: i64,
+    pub member_id: Option<i64>,
     pub response_id: i64,
 }
 
@@ -17,7 +17,7 @@ pub enum Relation {
         from = "Column::MemberId",
         to = "super::member::Column::MemberId",
         on_update = "NoAction",
-        on_delete = "Cascade"
+        on_delete = "SetNull"
     )]
     Member,
     #[sea_orm(

codes/server/src/domain/member/entity/member_retro.rs

@@ -26,7 +26,7 @@ pub struct Model {
     #[sea_orm(primary_key)]
     pub member_retro_id: i64,
     pub personal_insight: Option<String>,
-    pub member_id: i64,
+    pub member_id: Option<i64>,
     pub retrospect_id: i64,
     pub status: RetrospectStatus,
     pub submitted_at: Option<DateTime>,
@@ -39,7 +39,7 @@ pub enum Relation {
         from = "Column::MemberId",
         to = "super::member::Column::MemberId",
         on_update = "NoAction",
-        on_delete = "Cascade"
+        on_delete = "SetNull"
     )]
     Member,
     #[sea_orm(

codes/server/src/domain/member/entity/member_retro_room.rs

@@ -15,7 +15,7 @@ pub enum RoomRole {
 pub struct Model {
     #[sea_orm(primary_key)]
     pub member_retrospect_room_id: i64,
-    pub member_id: i64,
+    pub member_id: Option<i64>,
     pub retrospect_room_id: i64,
     pub role: RoomRole,
     #[sea_orm(default_value = "1")]
@@ -29,7 +29,7 @@ pub enum Relation {
         from = "Column::MemberId",
         to = "super::member::Column::MemberId",
         on_update = "NoAction",
-        on_delete = "Cascade"
+        on_delete = "SetNull"
     )]
     Member,
     #[sea_orm(

codes/server/src/domain/member/handler.rs

@@ -0,0 +1,45 @@
+use axum::{extract::State, Json};
+
+use super::service::MemberService;
+use crate::state::AppState;
+use crate::utils::auth::AuthUser;
+use crate::utils::error::AppError;
+use crate::utils::BaseResponse;
+
+/// [API-028] 서비스 탈퇴
+///
+/// 현재 로그인한 사용자의 계정을 삭제하고 서비스를 탈퇴 처리합니다.
+/// - 탈퇴 시 해당 사용자와 연결된 모든 개인 정보 및 데이터는 즉시 파기되며, 이는 복구가 불가능합니다.
+#[utoipa::path(
+    delete,
+    path = "/api/v1/members/me",
+    security(
+        ("bearer_auth" = [])
+    ),
+    responses(
+        (status = 200, description = "회원 탈퇴 성공", body = SuccessWithdrawResponse),
+        (status = 401, description = "인증 실패", body = ErrorResponse),
+        (status = 404, description = "존재하지 않는 사용자", body = ErrorResponse),
+        (status = 500, description = "서버 내부 오류", body = ErrorResponse)
+    ),
+    tag = "Member"
+)]
+pub async fn withdraw(
+    State(state): State<AppState>,
+    user: AuthUser,
+) -> Result<Json<BaseResponse<()>>, AppError> {
+    let member_id: i64 = user
+        .0
+        .sub
+        .parse()
+        .map_err(|_| AppError::Unauthorized("잘못된 인증 정보입니다.".into()))?;
+
+    MemberService::withdraw(state, member_id).await?;
+
+    Ok(Json(BaseResponse {
+        is_success: true,
+        code: "COMMON200".to_string(),
+        message: "회원 탈퇴가 성공적으로 완료되었습니다.".to_string(),
+        result: None,
+    }))
+}

codes/server/src/domain/member/mod.rs

@@ -1 +1,4 @@
+pub mod dto;
 pub mod entity;
+pub mod handler;
+pub mod service;

codes/server/src/domain/member/service.rs

@@ -0,0 +1,59 @@
+use sea_orm::{ColumnTrait, EntityTrait, QueryFilter, TransactionTrait};
+use tracing::info;
+
+use crate::domain::member::entity::member;
+use crate::domain::member::entity::refresh_token;
+use crate::state::AppState;
+use crate::utils::error::AppError;
+
+pub struct MemberService;
+
+impl MemberService {
+    /// 회원 탈퇴 처리
+    ///
+    /// 사용자 계정 정보만 삭제하고, 연관 데이터(답변, 회고 등)는 유지합니다.
+    /// - refresh_token: 삭제 (세션 정보)
+    /// - member: 삭제 (계정 정보)
+    /// - member_response, member_retro, member_retro_room: FK가 NULL로 설정됨 (ON DELETE SET NULL)
+    pub async fn withdraw(state: AppState, member_id: i64) -> Result<(), AppError> {
+        // 사용자 존재 여부 확인
+        let member = member::Entity::find_by_id(member_id)
+            .one(&state.db)
+            .await
+            .map_err(|e| AppError::InternalError(e.to_string()))?;
+
+        if member.is_none() {
+            return Err(AppError::MemberNotFound(
+                "존재하지 않는 사용자입니다.".to_string(),
+            ));
+        }
+
+        // 트랜잭션으로 refresh_token과 member 삭제를 원자적으로 처리
+        let txn = state
+            .db
+            .begin()
+            .await
+            .map_err(|e| AppError::InternalError(e.to_string()))?;
+
+        // 1. refresh_token 삭제
+        refresh_token::Entity::delete_many()
+            .filter(refresh_token::Column::MemberId.eq(member_id))
+            .exec(&txn)
+            .await
+            .map_err(|e| AppError::InternalError(e.to_string()))?;
+
+        // 2. member 삭제 (연관 테이블의 member_id는 ON DELETE SET NULL로 자동 NULL 처리)
+        member::Entity::delete_by_id(member_id)
+            .exec(&txn)
+            .await
+            .map_err(|e| AppError::InternalError(e.to_string()))?;
+
+        txn.commit()
+            .await
+            .map_err(|e| AppError::InternalError(e.to_string()))?;
+
+        info!("Member {} has been withdrawn successfully", member_id);
+
+        Ok(())
+    }
+}