Files
sam-api/app/Http/Controllers/Api/V1/LeaveController.php
hskwon e81e5d7084 feat: 휴가 관리 API 구현 (Phase 1)
- leaves, leave_balances 테이블 마이그레이션 추가
- Leave, LeaveBalance 모델 구현 (BelongsToTenant, SoftDeletes)
- LeaveService 서비스 구현 (CRUD, 승인/반려/취소, 잔여일수 관리)
- LeaveController 및 FormRequest 5개 생성
- API 엔드포인트 11개 등록 (/v1/leaves/*)
- Swagger 문서 (LeaveApi.php) 작성
- i18n 메시지 키 추가 (message.leave.*, error.leave.*)
2025-12-17 20:13:48 +09:00

147 lines
4.1 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\Leave\BalanceRequest;
use App\Http\Requests\Leave\IndexRequest;
use App\Http\Requests\Leave\RejectRequest;
use App\Http\Requests\Leave\StoreRequest;
use App\Http\Requests\Leave\UpdateRequest;
use App\Services\LeaveService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class LeaveController extends Controller
{
public function __construct(private LeaveService $service) {}
/**
* 휴가 목록 조회
* GET /v1/leaves
*/
public function index(IndexRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->index($request->validated());
}, __('message.fetched'));
}
/**
* 휴가 상세 조회
* GET /v1/leaves/{id}
*/
public function show(int $id): JsonResponse
{
return ApiResponse::handle(function () use ($id) {
return $this->service->show($id);
}, __('message.fetched'));
}
/**
* 휴가 신청
* POST /v1/leaves
*/
public function store(StoreRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->store($request->validated());
}, __('message.leave.created'));
}
/**
* 휴가 수정
* PATCH /v1/leaves/{id}
*/
public function update(int $id, UpdateRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->update($id, $request->validated());
}, __('message.updated'));
}
/**
* 휴가 삭제
* DELETE /v1/leaves/{id}
*/
public function destroy(int $id): JsonResponse
{
return ApiResponse::handle(function () use ($id) {
return $this->service->destroy($id);
}, __('message.deleted'));
}
/**
* 휴가 승인
* POST /v1/leaves/{id}/approve
*/
public function approve(int $id, Request $request): JsonResponse
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->approve($id, $request->input('comment'));
}, __('message.leave.approved'));
}
/**
* 휴가 반려
* POST /v1/leaves/{id}/reject
*/
public function reject(int $id, RejectRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->reject($id, $request->input('reason'));
}, __('message.leave.rejected'));
}
/**
* 휴가 취소
* POST /v1/leaves/{id}/cancel
*/
public function cancel(int $id, Request $request): JsonResponse
{
return ApiResponse::handle(function () use ($id, $request) {
return $this->service->cancel($id, $request->input('reason'));
}, __('message.leave.cancelled'));
}
/**
* 내 잔여 휴가 조회
* GET /v1/leaves/balance
*/
public function balance(Request $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->getMyBalance($request->input('year'));
}, __('message.fetched'));
}
/**
* 특정 사용자 잔여 휴가 조회
* GET /v1/leaves/balance/{userId}
*/
public function userBalance(int $userId, Request $request): JsonResponse
{
return ApiResponse::handle(function () use ($userId, $request) {
return $this->service->getUserBalance($userId, $request->input('year'));
}, __('message.fetched'));
}
/**
* 잔여 휴가 설정
* PUT /v1/leaves/balance
*/
public function setBalance(BalanceRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
$data = $request->validated();
return $this->service->setBalance(
$data['user_id'],
$data['year'],
$data['total_days']
);
}, __('message.updated'));
}
}