회원 탈퇴 화면 (US-04)

[i3months]

왜

#198 을 작업하며 발견한 공백이다. DELETE /api/users/me 는 동작하는데 사용자가 도달할 경로가 없었다 — 프론트에서 '탈퇴' 문자열이 자동 생성 타입에만 존재했다. US-04 가 백엔드만 구현된 상태였다.

무엇

/workspace/account (계정 설정) — 사이드바에 항목 추가.

• 계정 정보 (이름·이메일)
• 로그아웃
• 회원 탈퇴 (danger 영역 + 확인 다이얼로그)

안내 문구를 공들인 이유

docs/security.md §5.3 이 약속한 처리를 그대로 나열한다.

• 모든 데이터에 더 이상 접근할 수 없음
• 발급했던 공유 링크가 즉시 만료 (UserDeletionShareRevokeListener)
• 보관 중이던 GitHub 접근 권한 즉시 폐기 (탈퇴 시 보관 중이던 GitHub access token 을 폐기 #198)
• 같은 계정 재가입은 가능하나 이전 데이터 복구 불가 (V3·V22 부분 유니크 인덱스)

특히 GitHub 앱 승인 해제 경로(github.com/settings/applications)를 함께 안내한다. 우리가 지우는 건 우리가 가진 사본뿐이고 승인 자체는 사용자만 취소할 수 있다. 이걸 알려주지 않으면 사용자는 탈퇴했는데도 권한이 남아 있다는 사실 자체를 모른다.

"정말 삭제할까요?" 만 묻고 넘어가는 확인창은 동의를 받은 게 아니라 클릭을 받은 것이다.

엣지 케이스

useDeleteAccount 는 410(이미 탈퇴)을 실패로 다루지 않는다. 다른 탭에서 먼저 탈퇴한 경우인데, 사용자가 원한 결과는 이미 이뤄졌으므로 에러 토스트 대신 로그아웃까지 마무리한다.

탈퇴 직후 로그아웃 API 는 계정이 사라져 실패할 수 있다. AuthProvider.logout 이 finally 에서 로컬 상태를 정리하므로 화면은 정상적으로 로그아웃된다 — 이 동작에 의존한다는 걸 훅 주석에 남겼다.

테스트

AccountView.test.tsx 5 케이스

• 탈퇴 버튼만 눌러서는 탈퇴되지 않는다 (확인 다이얼로그 필수)
• 다이얼로그에서 확인해야 실행된다
• 취소하면 아무 일도 일어나지 않는다
• GitHub 앱 권한 해제 경로를 안내한다 (href 까지 검증)
• 무엇이 사라지는지 미리 알려준다

프론트 전체 134 tests / 33 files 통과, 타입체크·빌드 정상.

함께 갱신

• UserController 의 @Operation 설명이 탈퇴 시 보관 중이던 GitHub access token 을 폐기 #198 이후 낡아 있어 갱신 (토큰 폐기·공유 토큰 revoke 반영) → backend/openapi.json 재생성 → npm run openapi 로 프론트 타입 재생성
• docs/security.md §5.3 의 "미구현" 표기를 화면 경로로 교체