Files
sam-api/app/Http/Controllers/Api/V1/AttendanceController.php
hskwon f1f4c52c31 feat: 근태관리/직원관리 API 구현
- AttendanceController, AttendanceService 추가
- EmployeeController, EmployeeService 추가
- Attendance 모델 및 마이그레이션 추가
- TenantUserProfile에 employee_status 컬럼 추가
- DepartmentService 트리 조회 기능 개선
- Swagger 문서 추가 (AttendanceApi, EmployeeApi)
- API 라우트 등록
2025-12-09 20:27:44 +09:00

125 lines
3.5 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\Attendance\CheckInRequest;
use App\Http\Requests\Attendance\CheckOutRequest;
use App\Http\Requests\Attendance\IndexRequest;
use App\Http\Requests\Attendance\MonthlyStatsRequest;
use App\Http\Requests\Attendance\StoreRequest;
use App\Http\Requests\Attendance\UpdateRequest;
use App\Services\AttendanceService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class AttendanceController extends Controller
{
public function __construct(private AttendanceService $service) {}
/**
* 근태 목록 조회
* GET /v1/attendances
*/
public function index(IndexRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->index($request->validated());
}, __('message.fetched'));
}
/**
* 근태 상세 조회
* GET /v1/attendances/{id}
*/
public function show(int $id): JsonResponse
{
return ApiResponse::handle(function () use ($id) {
return $this->service->show($id);
}, __('message.fetched'));
}
/**
* 근태 등록
* POST /v1/attendances
*/
public function store(StoreRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->store($request->validated());
}, __('message.created'));
}
/**
* 근태 수정
* PATCH /v1/attendances/{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/attendances/{id}
*/
public function destroy(int $id): JsonResponse
{
return ApiResponse::handle(function () use ($id) {
return $this->service->destroy($id);
}, __('message.deleted'));
}
/**
* 근태 일괄 삭제
* POST /v1/attendances/bulk-delete
*/
public function bulkDelete(Request $request): JsonResponse
{
$request->validate([
'ids' => 'required|array|min:1',
'ids.*' => 'integer|min:1',
]);
return ApiResponse::handle(function () use ($request) {
return $this->service->bulkDelete($request->input('ids'));
}, __('message.bulk_deleted'));
}
/**
* 출근 기록 (체크인)
* POST /v1/attendances/check-in
*/
public function checkIn(CheckInRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->checkIn($request->validated());
}, __('message.created'));
}
/**
* 퇴근 기록 (체크아웃)
* POST /v1/attendances/check-out
*/
public function checkOut(CheckOutRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->checkOut($request->validated());
}, __('message.updated'));
}
/**
* 월간 통계 조회
* GET /v1/attendances/monthly-stats
*/
public function monthlyStats(MonthlyStatsRequest $request): JsonResponse
{
return ApiResponse::handle(function () use ($request) {
return $this->service->monthlyStats($request->validated());
}, __('message.fetched'));
}
}