Files
sam-manage/app/Http/Controllers/Api/Admin/DepartmentController.php
hskwon 6738505106 feat: Phase 4-3 부서 관리 시스템 구현
- DepartmentService, DepartmentController (Blade/API) 생성
- 부서 CRUD 기능 완성 (목록/생성/수정/삭제)
- FormRequest 검증 (StoreDepartmentRequest, UpdateDepartmentRequest)
- HTMX 패턴 적용 (index, create, edit, partials/table)
- 계층 구조 지원 (parent-child relationships)
- 활성/비활성 상태 관리
- 정렬 순서 관리
- Tenant Selector 통합
- Sidebar 메뉴에 부서 관리 추가

주요 기능:
- 자기 참조 방지 (parent_id validation)
- 하위 부서 존재 시 삭제 방지
- Conditional tenant filtering 적용
- Active/Inactive 필터링
- HTMX 페이지네이션 (target, includeForm 파라미터 포함)

정책:
- 모든 리스트 화면은 1페이지만 있어도 페이지네이션 표시
2025-11-24 16:52:23 +09:00

157 lines
4.6 KiB
PHP

<?php
namespace App\Http\Controllers\Api\Admin;
use App\Http\Controllers\Controller;
use App\Http\Requests\StoreDepartmentRequest;
use App\Http\Requests\UpdateDepartmentRequest;
use App\Services\DepartmentService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class DepartmentController extends Controller
{
public function __construct(
private readonly DepartmentService $departmentService
) {}
/**
* 부서 목록 조회
*/
public function index(Request $request): JsonResponse
{
$departments = $this->departmentService->getDepartments(
$request->all(),
$request->integer('per_page', 15)
);
// HTMX 요청 시 HTML 반환
if ($request->header('HX-Request')) {
$html = view('departments.partials.table', compact('departments'))->render();
return response()->json([
'html' => $html,
]);
}
// 일반 요청 시 JSON 반환
return response()->json([
'success' => true,
'data' => $departments->items(),
'meta' => [
'current_page' => $departments->currentPage(),
'last_page' => $departments->lastPage(),
'per_page' => $departments->perPage(),
'total' => $departments->total(),
],
]);
}
/**
* 부서 생성
*/
public function store(StoreDepartmentRequest $request): JsonResponse
{
$department = $this->departmentService->createDepartment($request->validated());
// HTMX 요청 시 성공 메시지와 리다이렉트 헤더 반환
if ($request->header('HX-Request')) {
return response()->json([
'success' => true,
'message' => '부서가 생성되었습니다.',
'redirect' => route('departments.index'),
]);
}
return response()->json([
'success' => true,
'message' => '부서가 생성되었습니다.',
'data' => $department,
], 201);
}
/**
* 특정 부서 조회
*/
public function show(Request $request, int $id): JsonResponse
{
$department = $this->departmentService->getDepartmentById($id);
if (!$department) {
return response()->json([
'success' => false,
'message' => '부서를 찾을 수 없습니다.',
], 404);
}
// HTMX 요청 시 HTML 반환
if ($request->header('HX-Request')) {
return response()->json([
'html' => view('departments.partials.detail', compact('department'))->render(),
]);
}
return response()->json([
'success' => true,
'data' => $department,
]);
}
/**
* 부서 수정
*/
public function update(UpdateDepartmentRequest $request, int $id): JsonResponse
{
$result = $this->departmentService->updateDepartment($id, $request->validated());
if (!$result) {
return response()->json([
'success' => false,
'message' => '부서 수정에 실패했습니다.',
], 400);
}
// HTMX 요청 시 성공 메시지와 리다이렉트 헤더 반환
if ($request->header('HX-Request')) {
return response()->json([
'success' => true,
'message' => '부서가 수정되었습니다.',
'redirect' => route('departments.index'),
]);
}
return response()->json([
'success' => true,
'message' => '부서가 수정되었습니다.',
]);
}
/**
* 부서 삭제 (Soft Delete)
*/
public function destroy(Request $request, int $id): JsonResponse
{
$result = $this->departmentService->deleteDepartment($id);
if (!$result) {
return response()->json([
'success' => false,
'message' => '부서 삭제에 실패했습니다. (하위 부서가 존재할 수 있습니다)',
], 400);
}
// HTMX 요청 시 테이블 행 제거 트리거
if ($request->header('HX-Request')) {
return response()->json([
'success' => true,
'message' => '부서가 삭제되었습니다.',
'action' => 'remove',
]);
}
return response()->json([
'success' => true,
'message' => '부서가 삭제되었습니다.',
]);
}
}