Admin 사용자 삭제 API 엔드포인트 추가

[donghyuck]

Type

• Feature
• Bug
• Refactor
• Docs
• Chore

Size

• Small (1): 단순 수정 / 단일 파일
• Medium (2): 기능 단위 변경 / 다중 파일
• Large (3): 구조 변경 / 복수 모듈

Summary

• Admin 회원 목록에서 사용자 삭제 기능을 연결할 수 있도록 사용자 삭제 API를 노출해야 합니다.

Background

• 프론트엔드 Admin 회원 목록에는 사용자 삭제 액션이 있지만 현재 비활성 상태입니다.
• 서버 ApplicationUserService에는 delete(Long userId) 기능이 존재하지만 UserMgmtController에는 DELETE /api/mgmt/users/{id} 엔드포인트가 없습니다.
• 그룹과 역할은 DELETE /api/mgmt/groups/{id}, DELETE /api/mgmt/roles/{id}가 있어 클라이언트 연결이 가능하지만, 사용자는 동일 기준으로 연결할 수 없습니다.

Scope

• DELETE /api/mgmt/users/{id} 엔드포인트를 추가합니다.
• 기존 권한 체계에 맞춰 features:user admin 권한을 적용합니다.
• 삭제 불가 정책이 있다면 물리 삭제 대신 비활성화/soft delete 정책을 API 명세로 명확히 정리합니다.

Acceptance Criteria

• 인증된 admin 권한 사용자가 DELETE /api/mgmt/users/{id}를 호출할 수 있습니다.
• 성공 시 204 또는 표준 ApiResponse 성공 응답을 반환합니다.
• 삭제 불가 대상 또는 정책 위반 시 명확한 4xx 응답을 반환합니다.
• 프론트엔드에서 사용자 삭제 액션을 서버 API에 연결할 수 있습니다.

Validation Plan

• build
• test
• smoke / manual check
• analysis only (no code change)

AI-Assisted

• Yes
• No

AI Usage

• Usage type: Admin 메뉴 기능 점검과 서버/클라이언트 결함 분리
• Subagent used: No
• Delegated scope: 없음
• Main author validation: 서버 엔드포인트 추가 후 /admin/users 사용자 삭제 액션 수동 확인

Notes

• 관련 서버 코드: UserMgmtController, ApplicationUserService.delete(Long userId)
• 관련 클라이언트 화면: http://localhost:3000/admin/users

[donghyuck]

이슈 #376 처리 PR을 등록했습니다: #378

조치 내용:

• DELETE /api/mgmt/users/{id} 엔드포인트를 기본 UserMgmtController에 추가했습니다.
• 기존 권한 체계와 맞춰 features:user admin 권한을 적용했습니다.
• 성공 응답은 204 No Content로 반환합니다.
• UserMgmtApi는 default delete 메서드로 확장해 커스텀 컨트롤러 구현체의 컴파일 호환성을 유지했습니다.
• 기본 서비스 삭제 후 user cache 정리를 보강했습니다.
• README에 삭제 API를 문서화했습니다.

검증:

• ./gradlew :studio-platform-user:compileJava :studio-platform-user-default:test :starter:studio-platform-starter-user:test 성공
• ./gradlew test 성공
• git diff --check 성공

참고:

• 현재 기본 구현은 기존 ApplicationUserService.delete(Long userId)의 물리 삭제 정책을 그대로 사용합니다.
• user property, role, group membership은 스키마상 cascade 삭제됩니다.
• soft delete나 last-admin/self-delete 방지 정책이 필요하면 별도 정책 이슈로 분리하는 편이 맞습니다.

[donghyuck]

PR #378 재리뷰 결과를 반영했습니다.

결론:

• 현재 이슈 범위에서 추가 코드 수정 필요 없음
• features:user/admin 권한 적용 확인
• UserMgmtApi default method로 커스텀 구현체 호환성 유지 확인
• 삭제 후 user cache eviction 확인
• user schema cascade 범위 확인
• targeted tests, full ./gradlew test, git diff --check, gitleaks 통과 확인

남는 정책 판단:

• self-delete 방지
• last-admin 보호
• soft delete 전환

위 항목은 현재 코드에 기존 정책이 없으므로, 필요하면 별도 정책 이슈로 분리하는 것이 맞습니다.

[donghyuck]

PR #378 병합으로 DELETE /api/mgmt/users/{id} 엔드포인트가 2.x에 반영되어 이슈를 닫습니다.

반영 내용:

• features:user/admin 권한의 사용자 삭제 API 추가
• 성공 시 204 No Content 반환
• 삭제 후 user cache 정리
• user/starter README 문서화

검증:

• targeted tests 성공
• full ./gradlew test 성공
• gitleaks check 통과