feat: [hr] 근태등록 + 휴가관리 통합 시스템 구현

- Leave 모델 확장: 6개 유형 추가 (출장/재택/외근/조퇴/지각사유서/결근사유서)
- LeaveService: 유형별 결재양식 자동 선택, 유형별 Attendance 반영 분기
- ApprovalService: 콜백 3개 결재양식코드로 확장
- AttendanceIntegratedController: 통합 화면 컨트롤러
- 통합 UI: 근태현황/신청결재/연차잔여 3탭 + 신규 신청 드롭다운
- AttendanceRequest 모델/서비스/컨트롤러/뷰 삭제 (Leave로 일원화)
- AttendanceService: deductLeaveBalance 제거 (Leave 시스템으로 일원화)
This commit is contained in:
김보곤
2026-03-03 23:50:27 +09:00
parent 896446f388
commit 6cdcc293cf
16 changed files with 826 additions and 592 deletions

View File

@@ -1,141 +0,0 @@
<?php
namespace App\Http\Controllers\Api\Admin\HR;
use App\Http\Controllers\Controller;
use App\Services\HR\AttendanceRequestService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
class AttendanceRequestController extends Controller
{
public function __construct(
private AttendanceRequestService $requestService
) {}
/**
* 신청 목록 (HTMX → HTML / 일반 → JSON)
*/
public function index(Request $request): JsonResponse|Response
{
$requests = $this->requestService->getRequests(
$request->all(),
$request->integer('per_page', 20)
);
if ($request->header('HX-Request')) {
return response(view('hr.attendances.partials.requests', compact('requests')));
}
return response()->json([
'success' => true,
'data' => $requests->items(),
'meta' => [
'current_page' => $requests->currentPage(),
'last_page' => $requests->lastPage(),
'per_page' => $requests->perPage(),
'total' => $requests->total(),
],
]);
}
/**
* 신청 등록
*/
public function store(Request $request): JsonResponse
{
$validated = $request->validate([
'user_id' => 'required|integer|exists:users,id',
'request_type' => 'required|string|in:vacation,businessTrip,remote,fieldWork',
'start_date' => 'required|date',
'end_date' => 'required|date|after_or_equal:start_date',
'reason' => 'nullable|string|max:1000',
'json_details' => 'nullable|array',
]);
try {
$attendanceRequest = $this->requestService->storeRequest($validated);
return response()->json([
'success' => true,
'message' => '근태 신청이 등록되었습니다.',
'data' => $attendanceRequest,
], 201);
} 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 {
$attendanceRequest = $this->requestService->approve($id);
if (! $attendanceRequest) {
return response()->json([
'success' => false,
'message' => '대기 중인 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => '승인 처리되었습니다. 근태 레코드가 자동 생성되었습니다.',
'data' => $attendanceRequest,
]);
} 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 {
$attendanceRequest = $this->requestService->reject($id, $validated['reject_reason'] ?? null);
if (! $attendanceRequest) {
return response()->json([
'success' => false,
'message' => '대기 중인 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => '반려 처리되었습니다.',
'data' => $attendanceRequest,
]);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '반려 처리 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
}

View File

@@ -48,7 +48,7 @@ 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',
'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',
@@ -176,6 +176,36 @@ public function cancel(Request $request, int $id): JsonResponse
}
}
/**
* pending 상태 신청 삭제
*/
public function destroy(Request $request, int $id): JsonResponse
{
try {
$leave = $this->leaveService->deletePendingLeave($id);
if (! $leave) {
return response()->json([
'success' => false,
'message' => '삭제 가능한 신청을 찾을 수 없습니다.',
], 404);
}
return response()->json([
'success' => true,
'message' => '신청이 삭제되었습니다.',
]);
} catch (\Throwable $e) {
report($e);
return response()->json([
'success' => false,
'message' => '삭제 중 오류가 발생했습니다.',
'error' => config('app.debug') ? $e->getMessage() : null,
], 500);
}
}
/**
* 잔여연차 목록 (HTMX → HTML)
*/

View File

@@ -0,0 +1,54 @@
<?php
namespace App\Http\Controllers\HR;
use App\Http\Controllers\Controller;
use App\Models\HR\Attendance;
use App\Models\HR\Leave;
use App\Services\HR\AttendanceService;
use App\Services\HR\LeaveService;
use Illuminate\Contracts\View\View;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
class AttendanceIntegratedController extends Controller
{
public function __construct(
private AttendanceService $attendanceService,
private LeaveService $leaveService
) {}
/**
* 근태관리 통합 화면
*/
public function index(Request $request): View|Response
{
// JS 필요 페이지 → HTMX 시 전체 리로드
if ($request->header('HX-Request')) {
return response('', 200)->header('HX-Redirect', route('hr.attendance.index'));
}
$stats = $this->attendanceService->getMonthlyStats();
$departments = $this->leaveService->getDepartments();
$employees = $this->leaveService->getActiveEmployees();
$statusMap = Attendance::STATUS_MAP;
$leaveTypeMap = Leave::TYPE_MAP;
$leaveStatusMap = Leave::STATUS_MAP;
// 결재선 목록
$approvalLines = \App\Models\Approvals\ApprovalLine::query()
->where('tenant_id', session('selected_tenant_id'))
->orderBy('name')
->get(['id', 'name', 'is_default']);
return view('hr.attendance-integrated.index', [
'stats' => $stats,
'departments' => $departments,
'employees' => $employees,
'statusMap' => $statusMap,
'leaveTypeMap' => $leaveTypeMap,
'leaveStatusMap' => $leaveStatusMap,
'approvalLines' => $approvalLines,
]);
}
}