Files
sam-manage/app/Http/Controllers/Api/Admin/HR/LeaveController.php
김보곤 be35f7ba49 feat: [hr] 연차잔여 탭에 재직상태 필터 추가 (전체/재직자/퇴직자)
- 필터 기본값: 재직자 (active + leave)
- 퇴직자 선택 시 resigned만 표시
- 전체 선택 시 모든 상태 표시
2026-03-05 15:16:54 +09:00

320 lines
10 KiB
PHP

<?php
namespace App\Http\Controllers\Api\Admin\HR;
use App\Http\Controllers\Controller;
use App\Services\HR\LeaveService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Symfony\Component\HttpFoundation\StreamedResponse;
class LeaveController extends Controller
{
public function __construct(
private LeaveService $leaveService
) {}
/**
* 휴가 목록 (HTMX → HTML / 일반 → JSON)
*/
public function index(Request $request): JsonResponse|Response
{
$leaves = $this->leaveService->getLeaves(
$request->all(),
$request->integer('per_page', 20)
);
if ($request->header('HX-Request')) {
return response(view('hr.leaves.partials.table', compact('leaves')));
}
return response()->json([
'success' => true,
'data' => $leaves->items(),
'meta' => [
'current_page' => $leaves->currentPage(),
'last_page' => $leaves->lastPage(),
'per_page' => $leaves->perPage(),
'total' => $leaves->total(),
],
]);
}
/**
* 휴가 신청 등록
*/
public function store(Request $request): JsonResponse
{
$validated = $request->validate([
'user_id' => 'required|integer|exists:users,id',
'leave_type' => 'required|string|in:annual,half_am,half_pm,sick,family,maternity,parental,business_trip,remote,field_work,early_leave,late_reason,absent_reason',
'start_date' => 'required|date',
'end_date' => 'required|date|after_or_equal:start_date',
'reason' => 'nullable|string|max:1000',
'approval_line_id' => 'nullable|integer|exists:approval_lines,id',
]);
try {
$leave = $this->leaveService->storeLeave($validated);
return response()->json([
'success' => true,
'message' => '휴가 신청이 등록되었습니다.',
'data' => $leave,
], 201);
} catch (\RuntimeException $e) {
return response()->json([
'success' => false,
'message' => $e->getMessage(),
], 422);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '휴가 등록 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
/**
* 승인
*/
public function approve(Request $request, int $id): JsonResponse
{
try {
$leave = $this->leaveService->approve($id);
if (! $leave) {
return response()->json([
'success' => false,
'message' => '대기 중인 휴가 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => '승인 처리되었습니다.',
'data' => $leave,
]);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '승인 처리 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
/**
* 반려
*/
public function reject(Request $request, int $id): JsonResponse
{
$validated = $request->validate([
'reject_reason' => 'nullable|string|max:1000',
]);
try {
$leave = $this->leaveService->reject($id, $validated['reject_reason'] ?? null);
if (! $leave) {
return response()->json([
'success' => false,
'message' => '대기 중인 휴가 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => '반려 처리되었습니다.',
'data' => $leave,
]);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '반려 처리 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
/**
* 취소
*/
public function cancel(Request $request, int $id): JsonResponse
{
try {
$leave = $this->leaveService->cancel($id);
if (! $leave) {
return response()->json([
'success' => false,
'message' => '승인된 휴가 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => '취소 처리되었습니다. 연차가 복원되었습니다.',
'data' => $leave,
]);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '취소 처리 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
/**
* 신청 삭제 (일반: pending만 / 슈퍼관리자: 모든 상태, force 영구삭제)
*/
public function destroy(Request $request, int $id): JsonResponse
{
try {
$force = $request->boolean('force');
$isSuperAdmin = auth()->user()->isSuperAdmin();
if ($force) {
if (! $isSuperAdmin) {
return response()->json(['success' => false, 'message' => '권한이 없습니다.'], 403);
}
$leave = $this->leaveService->forceDeleteLeave($id);
$message = '신청이 영구 삭제되었습니다.';
} elseif ($isSuperAdmin) {
$leave = $this->leaveService->deleteLeave($id);
$message = '신청이 삭제되었습니다.';
} else {
$leave = $this->leaveService->deletePendingLeave($id);
$message = '신청이 삭제되었습니다.';
}
if (! $leave) {
return response()->json([
'success' => false,
'message' => '삭제 가능한 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => $message,
]);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '삭제 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
/**
* 잔여연차 목록 (HTMX → HTML)
*/
public function balance(Request $request): JsonResponse|Response
{
$year = $request->integer('year', now()->year);
$sort = $request->input('sort', 'hire_date');
$direction = $request->input('direction', 'asc');
$empStatus = $request->input('emp_status');
$balances = $this->leaveService->getBalanceSummary($year, $sort, $direction, $empStatus);
if ($request->header('HX-Request')) {
return response(view('hr.leaves.partials.balance', compact('balances', 'year', 'sort', 'direction', 'empStatus')));
}
return response()->json([
'success' => true,
'data' => $balances,
]);
}
/**
* 개별 사원 잔여연차 (JSON)
*/
public function userBalance(Request $request, int $userId): JsonResponse
{
$year = $request->integer('year', now()->year);
$balance = $this->leaveService->getUserBalance($userId, $year);
return response()->json([
'success' => true,
'data' => $balance ? [
'total_days' => $balance->total_days,
'used_days' => $balance->used_days,
'remaining_days' => $balance->remaining,
] : null,
]);
}
/**
* 사용현황 통계 (HTMX → HTML)
*/
public function stats(Request $request): JsonResponse|Response
{
$year = $request->integer('year', now()->year);
$stats = $this->leaveService->getUsageStats($year);
if ($request->header('HX-Request')) {
return response(view('hr.leaves.partials.stats', compact('stats')));
}
return response()->json([
'success' => true,
'data' => $stats,
]);
}
/**
* CSV 내보내기
*/
public function export(Request $request): StreamedResponse
{
$filters = $request->all();
$leaves = $this->leaveService->getExportData($filters);
$headers = [
'Content-Type' => 'text/csv; charset=UTF-8',
'Content-Disposition' => 'attachment; filename="leaves_'.now()->format('Ymd_His').'.csv"',
];
return response()->stream(function () use ($leaves) {
$output = fopen('php://output', 'w');
fprintf($output, chr(0xEF).chr(0xBB).chr(0xBF)); // BOM
fputcsv($output, ['사원', '부서', '유형', '시작일', '종료일', '일수', '사유', '상태', '승인자', '신청일']);
foreach ($leaves as $leave) {
$profile = $leave->user?->tenantProfiles?->first();
fputcsv($output, [
$leave->user?->name ?? '-',
$profile?->department?->name ?? '-',
$leave->type_label,
$leave->start_date->format('Y-m-d'),
$leave->end_date->format('Y-m-d'),
$leave->days,
$leave->reason ?? '-',
$leave->status_label,
$leave->approver?->name ?? '-',
$leave->created_at->format('Y-m-d H:i'),
]);
}
fclose($output);
}, 200, $headers);
}
}