sam-manage/app/Http/Controllers/Api/Admin/RoleController.php

<?php

namespace App\Http\Controllers\Api\Admin;

use App\Http\Controllers\Controller;
use App\Http\Requests\StoreRoleRequest;
use App\Http\Requests\UpdateRoleRequest;
use App\Services\RoleService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;

class RoleController extends Controller
{
    public function __construct(
        private readonly RoleService $roleService
    ) {}

    /**
     * 역할 목록 조회
     */
    public function index(Request $request): JsonResponse|\Illuminate\Contracts\View\View
    {
        $roles = $this->roleService->getRoles(
            $request->all(),
            $request->integer('per_page', 10)
        );

        // HTMX 요청 시 HTML 반환
        if ($request->header('HX-Request')) {
            return view('roles.partials.table', compact('roles'));
        }

        // 일반 요청 시 JSON 반환
        return response()->json([
            'success' => true,
            'data' => $roles->items(),
            'meta' => [
                'current_page' => $roles->currentPage(),
                'last_page' => $roles->lastPage(),
                'per_page' => $roles->perPage(),
                'total' => $roles->total(),
            ],
        ]);
    }

    /**
     * 역할 생성
     */
    public function store(StoreRoleRequest $request): JsonResponse
    {
        $role = $this->roleService->createRole($request->validated());

        // HTMX 요청 시 성공 메시지와 리다이렉트 헤더 반환
        if ($request->header('HX-Request')) {
            return response()->json([
                'success' => true,
                'message' => '역할이 생성되었습니다.',
                'redirect' => route('roles.index'),
            ]);
        }

        return response()->json([
            'success' => true,
            'message' => '역할이 생성되었습니다.',
            'data' => $role,
        ], 201);
    }

    /**
     * 특정 역할 조회
     */
    public function show(Request $request, int $id): JsonResponse
    {
        $role = $this->roleService->getRoleById($id);

        if (! $role) {
            return response()->json([
                'success' => false,
                'message' => '역할을 찾을 수 없습니다.',
            ], 404);
        }

        // HTMX 요청 시 HTML 반환
        if ($request->header('HX-Request')) {
            return response()->json([
                'html' => view('roles.partials.detail', compact('role'))->render(),
            ]);
        }

        return response()->json([
            'success' => true,
            'data' => $role,
        ]);
    }

    /**
     * 역할 수정
     */
    public function update(UpdateRoleRequest $request, int $id): JsonResponse
    {
        $this->roleService->updateRole($id, $request->validated());

        // HTMX 요청 시 성공 메시지와 리다이렉트 헤더 반환
        if ($request->header('HX-Request')) {
            return response()->json([
                'success' => true,
                'message' => '역할이 수정되었습니다.',
                'redirect' => route('roles.index'),
            ]);
        }

        return response()->json([
            'success' => true,
            'message' => '역할이 수정되었습니다.',
        ]);
    }

    /**
     * 역할 삭제 (Soft Delete)
     */
    public function destroy(Request $request, int $id): JsonResponse
    {
        $this->roleService->deleteRole($id);

        // HTMX 요청 시 테이블 행 제거 트리거
        if ($request->header('HX-Request')) {
            return response()->json([
                'success' => true,
                'message' => '역할이 삭제되었습니다.',
                'action' => 'remove',
            ]);
        }

        return response()->json([
            'success' => true,
            'message' => '역할이 삭제되었습니다.',
        ]);
    }
}