회원 탈퇴와 덱 일괄 삭제 추가

docs/changelog.md

@@ -1,5 +1,17 @@
 # 변경사항
 
+## v4.0.16
+
+### 회원 탈퇴
+
+프로필 화면 가장 아래의 `회원 탈퇴`를 눌러 직접 탈퇴할 수 있습니다. 확인란에 `DELETE`를 입력한 뒤 `YES`를 누르면 계정과 개인 정보가 삭제됩니다.
+
+기존에 저장한 덱은 다른 사용자가 계속 참고할 수 있도록 작성자만 `익명`으로 변경되어 유지됩니다.
+
+### 관리자 회원·덱 정리
+
+관리자는 회원 정보 화면에서 회원을 탈퇴 처리할 수 있습니다. 덱 관리에서는 여러 덱을 체크하거나 현재 목록을 전체 선택해 썸네일과 함께 일괄 삭제할 수 있습니다.
+
 ## v4.0.15
 
 ### 인증 메일 재발송 동선 개선

docs/deploy.md

@@ -75,7 +75,7 @@ Docker 실행: `docker compose -f docker-compose.prod.yml up -d --build`
 
 API 확인: `curl -fsS http://localhost:44082/api/v1/health`
 
-정상이면 `{"ok":true,"version":"4.0.15"}`이 표시된다.
+정상이면 `{"ok":true,"version":"4.0.16"}`이 표시된다.
 
 이메일 기능 확인:
 
@@ -87,6 +87,15 @@ API 확인: `curl -fsS http://localhost:44082/api/v1/health`
 6. 같은 계정에서 인증·재설정 메일을 합산해 월 3회 초과 시 관리자 문의 안내가 표시되는지 확인한다.
 7. 관리자 화면에서 미인증 회원의 `이메일 인증 승인` 버튼으로 수동 승인 후 로그인되는지 확인한다.
 
+회원 탈퇴 확인:
+
+1. 일반 회원 프로필 최하단의 작은 `회원 탈퇴` 문구를 눌러 모달이 열리는지 확인한다.
+2. `DELETE`를 정확히 입력하기 전에는 `YES` 버튼이 비활성화되는지 확인한다.
+3. 탈퇴 후 로그아웃되고 같은 계정으로 로그인할 수 없는지 확인한다.
+4. 탈퇴 회원의 덱은 삭제되지 않고 작성자가 `익명`으로 표시되는지 확인한다.
+5. 관리자 회원 수정 모달에서 다른 회원을 탈퇴 처리할 수 있고, 자신의 관리자 계정은 삭제할 수 없는지 확인한다.
+6. 관리자 덱 관리에서 복수 선택·현재 목록 전체 선택·일괄 삭제와 썸네일 정리가 동작하는지 확인한다.
+
 NAS 리버스 프록시는 `https://uniare.sori.studio`을 `http://<NAS_IP>:44082`로 연결한다.
 
 ## 3. 정적 파일 업데이트

docs/history.md

@@ -1,5 +1,10 @@
 # 의사결정 이력
 
+## 2026-06-25 v4.0.16 — 탈퇴 계정의 덱은 익명 콘텐츠로 보존
+
+💡 공개 덱을 참고하거나 즐겨찾기한 다른 사용자의 이용 흐름을 탈퇴로 끊지 않기 위함.
+🔧 계정·개인 인증정보·아바타만 삭제하고 덱은 익명 유지, 관리자는 필요 시 복수 선택해 별도 삭제.
+
 ## 2026-06-25 v4.0.15 — 미인증 복구 동선은 로그인 화면에서 제공
 
 💡 인증 메일을 잃어버린 사용자가 별도 화면을 찾아가지 않고 로그인 실패 지점에서 바로 복구하게 하기 위함.

docs/map.md

@@ -100,10 +100,10 @@ script/ads.js
 
 ```text
 관리자·로그인·회원가입
-admin.html (회원 2열·덱 공개/전체 통계·마지막 접속·역할 변경·미인증 이메일 승인), login.html (로그인 유지·미인증 메일 재발송·비밀번호 찾기), signup.html — Tailwind 유틸리티
+admin.html (회원 2열·역할 변경·이메일 승인·회원 탈퇴·덱 복수 선택 삭제), login.html (로그인 유지·미인증 메일 재발송·비밀번호 찾기), signup.html — Tailwind 유틸리티
 
 내 덱·공개 덱·프로필
-deckHistory.html, preset.html, profile.html — HTML 클래스 + components.css
+deckHistory.html, preset.html, profile.html (프로필 최하단 회원 탈퇴 모달) — HTML 클래스 + components.css
 
 Tailwind 입력·산출물
 style/input.css
@@ -125,6 +125,9 @@ api/src/db.js (`email_send_logs`)
 계정 삭제 후 사용자명 재사용 회귀 테스트
 api/test/account-deletion.test.js
 
+회원 탈퇴·개인 데이터 삭제·덱 익명 보존
+api/src/services/accountDeletion.js
+
 JWT 인증·권한
 api/src/middleware/auth.js
 
@@ -137,7 +140,7 @@ api/src/services/emailService.js
 덱 저장·조회·공개 목록
 api/src/routes/decks.js
 
-회원·이메일 인증 승인·덱 관리자 API
+회원·이메일 인증 승인·회원 탈퇴·덱 일괄 삭제 관리자 API
 api/src/routes/admin.js
 
 카드 메타 합성

docs/spec.md

@@ -3,7 +3,7 @@
 ## 프로젝트 개요
 
 - 서비스명: `UNIARE - Union Arena Deck Builder`
-- 현재 버전: `v4.0.15`
+- 현재 버전: `v4.0.16`
 - 프론트: 정적 HTML, CSS, JavaScript
 - 백엔드: Express, SQLite(`better-sqlite3`)
 - 운영: Docker Compose 기반 Nginx + API
@@ -23,7 +23,7 @@
 | `/verify-email.html` | 가입 이메일 인증·인증 메일 재전송 |
 | `/forgot-password.html` | 비밀번호 재설정 메일 요청 |
 | `/reset-password.html?token=<token>` | 1회용 토큰으로 비밀번호 재설정 |
-| `/profile.html` | 이메일·사용자명·아바타·비밀번호·덱 공개 기본값 관리 |
+| `/profile.html` | 이메일·사용자명·아바타·비밀번호·덱 공개 기본값·회원 탈퇴 관리 |
 | `/deckHistory.html` | 내 덱 검색·필터·이름 변경·공개 설정·삭제·불러오기 |
 | `/preset.html` | 공개 사용자 덱 검색·필터·즐겨찾기·불러오기 |
 | `/admin.html` | 회원과 덱 관리 |
@@ -104,14 +104,17 @@
 - 로그인 유지 선택 시 브라우저를 닫아도 인증 정보를 유지하고, 미선택 시 현재 브라우저 세션에서만 유지한다.
 - 인증된 화면 진입 시 `/auth/me` 검증과 함께 `last_login_at`을 갱신한다.
 - `user`는 자신의 프로필과 덱만 수정·삭제할 수 있다.
-- `admin`은 회원 상태·역할·비밀번호와 전체 덱을 관리할 수 있다.
+- 일반 회원은 프로필 최하단에서 `DELETE` 확인 입력 후 직접 탈퇴할 수 있다.
+- `admin`은 회원 상태·역할·비밀번호·탈퇴와 전체 덱을 관리할 수 있다.
 - 관리자는 자신의 관리자 역할을 해제하거나 자신의 계정을 비활성화할 수 없다.
+- 관리자는 현재 로그인한 자신의 계정을 관리자 화면에서 탈퇴시킬 수 없다.
 - 비공개 덱은 소유자와 관리자만 조회할 수 있다.
 - 비회원은 덱을 서버에 저장하거나 공개 링크를 생성할 수 없다.
 - 로그인 사용자의 즐겨찾기는 계정 DB에 저장되어 브라우저와 기기가 달라도 유지된다.
 - 비로그인 즐겨찾기는 브라우저에 저장하고 로그인 시 유효한 덱만 계정으로 이전한다.
-- 관리자 화면은 회원 비활성화만 제공하며 계정 영구 삭제 UI는 제공하지 않는다.
-- 계정이 DB에서 삭제되면 인증 토큰·메일 기록·즐겨찾기는 연쇄 삭제되고, 기존 덱의 `user_id`는 `null`이 된다. 같은 사용자명으로 새로 가입해도 새 사용자 ID가 부여되어 기존 정보와 연결되지 않는다.
+- 계정 탈퇴 시 사용자·인증 토큰·메일 기록·즐겨찾기·아바타를 삭제한다.
+- 탈퇴 회원의 저장 덱과 썸네일은 다른 사용자가 계속 참고할 수 있도록 유지하고 `user_id`만 `null`로 변경해 작성자를 익명 처리한다.
+- 같은 사용자명으로 새로 가입해도 새 사용자 ID가 부여되어 기존 익명 덱이나 개인정보와 연결되지 않는다.
 
 ## 덱 저장 정책
 
@@ -209,6 +212,7 @@
 | GET | `/api/v1/auth/me` | 회원 | 내 정보와 인증 세션 확인, `last_login_at` 갱신 |
 | PUT | `/api/v1/auth/me` | 회원 | 프로필·덱 저장 설정 변경 |
 | POST | `/api/v1/auth/me/password` | 회원 | 비밀번호 변경 |
+| DELETE | `/api/v1/auth/me` | 회원 | `DELETE` 확인 후 본인 계정 탈퇴 |
 | GET | `/api/v1/auth/avatar/:userId` | 공개 | PNG 아바타 |
 
 ### 덱
@@ -236,7 +240,9 @@
 | PUT | `/api/v1/admin/users/:id` | 회원 정보·역할·활성 상태 변경 |
 | POST | `/api/v1/admin/users/:id/verify-email` | 미인증 회원 이메일 수동 승인 |
 | POST | `/api/v1/admin/users/:id/reset-password` | 비밀번호 초기화 |
+| DELETE | `/api/v1/admin/users/:id` | `DELETE` 확인 후 회원 탈퇴 처리 |
 | GET | `/api/v1/admin/decks` | 전체 덱 목록 |
+| POST | `/api/v1/admin/decks/bulk-delete` | 선택한 덱 최대 100개와 썸네일 일괄 삭제 |
 | DELETE | `/api/v1/admin/decks/:shareCode` | 덱 삭제 |
 | GET | `/api/v1/admin/previews/orphans` | 미참조 덱 미리보기 목록 |
 | DELETE | `/api/v1/admin/previews/orphans` | 미참조 덱 미리보기 일괄 삭제 |

docs/update.md

@@ -1,5 +1,16 @@
 # 업데이트 이력
 
+## 2026-06-25 / v4.0.16 — 회원 탈퇴·관리자 덱 일괄 삭제
+
+### 수행 작업
+- 프로필 최하단에 10px 연회색 일반 텍스트 형태의 `회원 탈퇴` 진입점 추가
+- 탈퇴 모달에서 `DELETE` 확인 입력과 `YES`·`NO` 버튼 제공
+- 본인 탈퇴 및 관리자 회원 탈퇴 API 추가, 현재 로그인한 관리자 본인 삭제 차단
+- 탈퇴 시 계정·인증 토큰·메일 기록·즐겨찾기·아바타 삭제
+- 탈퇴 회원의 저장 덱과 썸네일은 유지하고 작성자 연결만 제거해 익명 처리
+- 관리자 덱 관리에 복수 체크·현재 목록 전체 선택·최대 100개 일괄 삭제 추가
+- 계정 탈퇴 후 동일 사용자명 재가입과 익명 덱 분리, 본인·관리자 탈퇴 API 회귀 테스트 보강
+
 ## 2026-06-25 / v4.0.15 — 미인증 로그인 복구·인증 화면 다국어
 
 ### 수행 작업