HeuJung
04f1066e66
브라우저·SEO 실측(T1~T7 매트릭스 + 봇 렌더 스윕)에서 발견된 결함을 보완한다. - 코어: 회원 일괄 상태변경 응답 메시지의 :count 플레이스홀더 미치환 수정 - 게시판·페이지: 비밀글·삭제글·미발행 첨부 썸네일이 KVE-2026-1914 게이트로 깨진 것을 한시 서명 preview URL(게이트 통과 직렬화 발급 + 유효 서명 허용)로 복구 — 무서명·변조·만료 요청 게이트는 종전과 동일 - 페이지: 발행/미발행 전환(after_publish)에도 SEO 캐시·사이트맵 갱신 구독 - 게시판: 게시판 디렉토리(전체 목록 + 내장 최근글)에 열람 권한 필터 적용 - 검색 화면: searchResults 데이터소스 auth_mode=optional 선언으로 로그인 회원 검색 범위 복구 + data-sources.md 선언 의무 규정화(coverage 등록)
347 lines
13 KiB
PHP
347 lines
13 KiB
PHP
<?php
|
|
|
|
// audit:allow api-doc-coverage reason: 응답 계약 불변 — lang 키에서 :error 플레이스홀더가 제거되어 사문화된 messageParams 인자만 정리 (키·상태코드·payload 형태 무변경)
|
|
|
|
namespace App\Http\Controllers\Api\Admin;
|
|
|
|
use App\Exceptions\CannotDeleteSuperAdminException;
|
|
use App\Exceptions\CannotModifySuperAdminException;
|
|
use App\Exceptions\PermissionEscalationException;
|
|
use App\Http\Controllers\Api\Base\AdminBaseController;
|
|
use App\Http\Requests\User\BulkUpdateUserStatusRequest;
|
|
use App\Http\Requests\User\CheckEmailRequest;
|
|
use App\Http\Requests\User\CreateUserRequest;
|
|
use App\Http\Requests\User\DeleteUserRequest;
|
|
use App\Http\Requests\User\SearchUserRequest;
|
|
use App\Http\Requests\User\UpdateLanguageRequest;
|
|
use App\Http\Requests\User\UpdateUserRequest;
|
|
use App\Http\Requests\User\UserListRequest;
|
|
use App\Http\Resources\UserCollection;
|
|
use App\Http\Resources\UserResource;
|
|
use App\Models\User;
|
|
use App\Services\UserService;
|
|
use Exception;
|
|
use Illuminate\Http\JsonResponse;
|
|
use Illuminate\Validation\ValidationException;
|
|
|
|
/**
|
|
* 관리자용 사용자 관리 컨트롤러
|
|
*
|
|
* 관리자가 시스템 사용자들을 관리할 수 있는 기능을 제공합니다.
|
|
*/
|
|
class UserController extends AdminBaseController
|
|
{
|
|
public function __construct(
|
|
private UserService $userService
|
|
) {
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* 필터링된 사용자 목록을 조회합니다.
|
|
*
|
|
* @param UserListRequest $request 사용자 목록 요청 데이터
|
|
* @return JsonResponse 사용자 목록과 통계 정보를 포함한 JSON 응답
|
|
*/
|
|
public function index(UserListRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$filters = $request->validated();
|
|
|
|
$users = $this->userService->getPaginatedUsers($filters);
|
|
$statistics = $this->userService->getStatistics();
|
|
|
|
$collection = new UserCollection($users);
|
|
|
|
return $this->success(
|
|
'user.fetch_success',
|
|
$collection->withStatistics($statistics)
|
|
);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 새로운 사용자를 생성합니다.
|
|
*
|
|
* @param CreateUserRequest $request 사용자 생성 요청 데이터
|
|
* @return JsonResponse 생성된 사용자 정보를 포함한 JSON 응답
|
|
*/
|
|
public function store(CreateUserRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$user = $this->userService->createUser($request->validated());
|
|
|
|
return $this->successWithResource(
|
|
'user.create_success',
|
|
new UserResource($user),
|
|
201
|
|
);
|
|
} catch (PermissionEscalationException $e) {
|
|
return $this->error('exceptions.cannot_grant_unheld_permission', 403);
|
|
} catch (ValidationException $e) {
|
|
return $this->error('user.create_failed', 422, $e->errors());
|
|
} catch (Exception $e) {
|
|
return $this->error('user.create_failed', 500, $e, ['error' => $e->getMessage()]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 특정 사용자의 상세 정보를 조회합니다.
|
|
*
|
|
* @param User $user 조회할 사용자 모델
|
|
* @return JsonResponse 사용자 상세 정보를 포함한 JSON 응답
|
|
*/
|
|
public function show(User $user): JsonResponse
|
|
{
|
|
try {
|
|
// 관계형 데이터 로드
|
|
$user->load(['modules', 'plugins', 'menus', 'roles', 'consents']);
|
|
$user->loadCount(['modules', 'plugins', 'menus']);
|
|
|
|
// withAdminInfo()를 호출하여 관리자용 상세 정보 및 모듈 훅 데이터 포함
|
|
$resource = new UserResource($user);
|
|
|
|
return $this->success(
|
|
'user.fetch_success',
|
|
$resource->withAdminInfo()
|
|
);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 기존 사용자 정보를 수정합니다.
|
|
*
|
|
* @param UpdateUserRequest $request 사용자 수정 요청 데이터
|
|
* @param User $user 수정할 사용자 모델
|
|
* @return JsonResponse 수정된 사용자 정보를 포함한 JSON 응답
|
|
*/
|
|
public function update(UpdateUserRequest $request, User $user): JsonResponse
|
|
{
|
|
try {
|
|
$updatedUser = $this->userService->updateUser($user, $request->validated());
|
|
|
|
return $this->successWithResource(
|
|
'user.update_success',
|
|
new UserResource($updatedUser)
|
|
);
|
|
} catch (CannotModifySuperAdminException $e) {
|
|
return $this->error('exceptions.cannot_modify_super_admin', 403);
|
|
} catch (PermissionEscalationException $e) {
|
|
return $this->error('exceptions.cannot_grant_unheld_permission', 403);
|
|
} catch (ValidationException $e) {
|
|
return $this->error('user.update_failed', 422, $e->errors());
|
|
} catch (Exception $e) {
|
|
return $this->error('user.update_failed', 500, $e);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 사용자의 계정 잠금을 해제합니다.
|
|
*
|
|
* 로그인 실패 누적으로 잠긴 계정(특히 잠금 시간 0 = 무한대 설정으로 영구 잠긴 계정)을
|
|
* 관리자가 수동으로 풀어 줍니다. 이 경로가 없으면 영구 잠금 계정은 성공 로그인 자체가
|
|
* 불가하므로 복구 수단이 없습니다.
|
|
*
|
|
* @param User $user 잠금을 해제할 사용자 모델
|
|
* @return JsonResponse 갱신된 사용자 정보를 포함한 JSON 응답
|
|
*/
|
|
public function unlock(User $user): JsonResponse
|
|
{
|
|
try {
|
|
$unlocked = $this->userService->unlockAccount($user);
|
|
|
|
return $this->successWithResource(
|
|
'auth.account_unlocked',
|
|
new UserResource($unlocked)
|
|
);
|
|
} catch (CannotModifySuperAdminException $e) {
|
|
return $this->error('exceptions.cannot_modify_super_admin', 403);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.update_failed', 500, $e);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 사용자를 삭제합니다.
|
|
*
|
|
* @param DeleteUserRequest $request 사용자 삭제 요청 데이터
|
|
* @param User $user 삭제할 사용자 모델
|
|
* @return JsonResponse 삭제 결과 JSON 응답
|
|
*/
|
|
public function destroy(DeleteUserRequest $request, User $user): JsonResponse
|
|
{
|
|
try {
|
|
$result = $this->userService->deleteUser($user);
|
|
|
|
if ($result) {
|
|
return $this->success('user.delete_success');
|
|
} else {
|
|
return $this->error('user.delete_failed');
|
|
}
|
|
} catch (CannotDeleteSuperAdminException $e) {
|
|
return $this->error('exceptions.cannot_delete_super_admin', 422);
|
|
} catch (ValidationException $e) {
|
|
// UserService 가 던진 ValidationException 의 general[0] 에는 이미 `:error` 가
|
|
// 치환된 완성 메시지(예: "사용자 삭제에 실패했습니다: <상세 사유>")가 들어있다.
|
|
// 이를 최상위 message 로도 노출해 토스트에 `:error` 가 그대로 보이지 않게 한다
|
|
// (에러 상세 표시 기능 유지). errors 배열도 함께 전달.
|
|
$detail = $e->errors()['general'][0] ?? null;
|
|
|
|
return $this->error($detail ?? 'user.delete_failed', 422, $e->errors());
|
|
} catch (Exception $e) {
|
|
return $this->error('user.delete_failed', 500, $e, ['error' => $e->getMessage()]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 사용자 관련 통계 정보를 조회합니다.
|
|
*
|
|
* @return JsonResponse 사용자 통계 데이터를 포함한 JSON 응답
|
|
*/
|
|
public function statistics(): JsonResponse
|
|
{
|
|
try {
|
|
$statistics = $this->userService->getStatistics();
|
|
$languageDistribution = $this->userService->getUserLanguageDistribution();
|
|
|
|
$data = array_merge($statistics, [
|
|
'language_distribution' => $languageDistribution,
|
|
]);
|
|
|
|
return $this->success('user.statistics_success', $data);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.statistics_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 최근 등록된 사용자들을 조회합니다.
|
|
*
|
|
* @return JsonResponse 최근 사용자 목록을 포함한 JSON 응답
|
|
*/
|
|
public function recent(): JsonResponse
|
|
{
|
|
try {
|
|
$users = $this->userService->getRecentUsers(10);
|
|
|
|
return $this->successWithResource(
|
|
'user.fetch_success',
|
|
UserResource::collection($users)
|
|
);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.fetch_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 키워드로 사용자를 검색합니다. (이름, 닉네임, 이메일)
|
|
*
|
|
* @param SearchUserRequest $request 사용자 검색 요청 데이터
|
|
* @return JsonResponse 검색된 사용자 목록을 포함한 JSON 응답
|
|
*/
|
|
public function search(SearchUserRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$validated = $request->validated();
|
|
|
|
if (isset($validated['uuid'])) {
|
|
$user = $this->userService->getUserByUuid($validated['uuid']);
|
|
$users = $user ? collect([$user]) : collect();
|
|
} elseif (isset($validated['id'])) {
|
|
$user = $this->userService->getUserById($validated['id']);
|
|
$users = $user ? collect([$user]) : collect();
|
|
} else {
|
|
$users = $this->userService->searchByKeyword($validated['keyword']);
|
|
}
|
|
|
|
return $this->successWithResource(
|
|
'user.search_success',
|
|
UserResource::collection($users)
|
|
);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.search_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 이메일 주소의 중복 여부를 확인합니다.
|
|
*
|
|
* @param CheckEmailRequest $request 이메일 중복 확인 요청 데이터
|
|
* @return JsonResponse 이메일 사용 가능 여부를 포함한 JSON 응답
|
|
*/
|
|
public function checkEmail(CheckEmailRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$validated = $request->validated();
|
|
$email = $validated['email'];
|
|
$excludeUserId = $validated['exclude_user_id'] ?? null;
|
|
|
|
$isAvailable = $this->userService->isEmailAvailable($email, $excludeUserId);
|
|
|
|
return $this->success(
|
|
$isAvailable ? 'user.email_available' : 'user.email_unavailable',
|
|
['available' => $isAvailable]
|
|
);
|
|
} catch (Exception $e) {
|
|
return $this->error('user.email_check_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 현재 로그인된 사용자의 언어 설정을 업데이트합니다.
|
|
*
|
|
* @param UpdateLanguageRequest $request 언어 변경 요청 데이터
|
|
* @return JsonResponse 변경된 사용자 정보를 포함한 JSON 응답
|
|
*/
|
|
public function updateMyLanguage(UpdateLanguageRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$user = $request->user();
|
|
$validated = $request->validated();
|
|
$oldLanguage = $user->language;
|
|
|
|
$updatedUser = $this->userService->updateUserLanguage($user, $validated['language']);
|
|
|
|
return $this->successWithResource(
|
|
'user.language_update_success',
|
|
new UserResource($updatedUser)
|
|
);
|
|
} catch (ValidationException $e) {
|
|
return $this->error('user.language_update_failed', 422, $e->errors());
|
|
} catch (Exception $e) {
|
|
return $this->error('user.language_update_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 여러 사용자의 상태를 일괄 변경합니다.
|
|
*
|
|
* @param BulkUpdateUserStatusRequest $request 일괄 상태 변경 요청 데이터
|
|
* @return JsonResponse 일괄 변경 결과를 포함한 JSON 응답
|
|
*/
|
|
public function bulkUpdateStatus(BulkUpdateUserStatusRequest $request): JsonResponse
|
|
{
|
|
try {
|
|
$validated = $request->validated();
|
|
$result = $this->userService->bulkUpdateStatus($validated['ids'], $validated['status']);
|
|
|
|
// 메시지 키(user.bulk_status_updated)가 :count 플레이스홀더를 가지므로
|
|
// 치환 파라미터를 함께 전달한다 (생략 시 원문 ":count명의 …" 이 그대로 노출)
|
|
return $this->success(
|
|
'user.bulk_status_updated',
|
|
$result,
|
|
200,
|
|
['count' => $result['updated_count'] ?? 0]
|
|
);
|
|
} catch (ValidationException $e) {
|
|
return $this->error('user.bulk_update_status_failed', 422, $e->errors());
|
|
} catch (Exception $e) {
|
|
return $this->error('user.bulk_update_status_failed', 500, $e->getMessage());
|
|
}
|
|
}
|
|
}
|