feat: 근태관리/직원관리 API 구현
- AttendanceController, AttendanceService 추가 - EmployeeController, EmployeeService 추가 - Attendance 모델 및 마이그레이션 추가 - TenantUserProfile에 employee_status 컬럼 추가 - DepartmentService 트리 조회 기능 개선 - Swagger 문서 추가 (AttendanceApi, EmployeeApi) - API 라우트 등록
This commit is contained in:
124
app/Http/Controllers/Api/V1/AttendanceController.php
Normal file
124
app/Http/Controllers/Api/V1/AttendanceController.php
Normal file
@@ -0,0 +1,124 @@
|
||||
<?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'));
|
||||
}
|
||||
}
|
||||
@@ -19,6 +19,14 @@ public function index(Request $request)
|
||||
}, '부서 목록 조회');
|
||||
}
|
||||
|
||||
// GET /v1/departments/tree
|
||||
public function tree(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->tree($request->all());
|
||||
}, '부서 트리 조회');
|
||||
}
|
||||
|
||||
// POST /v1/departments
|
||||
public function store(Request $request)
|
||||
{
|
||||
|
||||
114
app/Http/Controllers/Api/V1/EmployeeController.php
Normal file
114
app/Http/Controllers/Api/V1/EmployeeController.php
Normal file
@@ -0,0 +1,114 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\V1;
|
||||
|
||||
use App\Helpers\ApiResponse;
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\Employee\IndexRequest;
|
||||
use App\Http\Requests\Employee\StoreRequest;
|
||||
use App\Http\Requests\Employee\UpdateRequest;
|
||||
use App\Services\EmployeeService;
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
class EmployeeController extends Controller
|
||||
{
|
||||
public function __construct(private EmployeeService $service) {}
|
||||
|
||||
/**
|
||||
* 사원 목록 조회
|
||||
* GET /v1/employees
|
||||
*/
|
||||
public function index(IndexRequest $request): JsonResponse
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->index($request->validated());
|
||||
}, __('message.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 사원 상세 조회
|
||||
* GET /v1/employees/{id}
|
||||
*/
|
||||
public function show(int $id): JsonResponse
|
||||
{
|
||||
return ApiResponse::handle(function () use ($id) {
|
||||
return $this->service->show($id);
|
||||
}, __('message.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 사원 등록
|
||||
* POST /v1/employees
|
||||
*/
|
||||
public function store(StoreRequest $request): JsonResponse
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->store($request->validated());
|
||||
}, __('message.created'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 사원 수정
|
||||
* PATCH /v1/employees/{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/employees/{id}
|
||||
*/
|
||||
public function destroy(int $id): JsonResponse
|
||||
{
|
||||
return ApiResponse::handle(function () use ($id) {
|
||||
return $this->service->destroy($id);
|
||||
}, __('message.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 사원 일괄 삭제
|
||||
* POST /v1/employees/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'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 사원 통계
|
||||
* GET /v1/employees/stats
|
||||
*/
|
||||
public function stats(): JsonResponse
|
||||
{
|
||||
return ApiResponse::handle(function () {
|
||||
return $this->service->stats();
|
||||
}, __('message.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 시스템 계정 생성
|
||||
* POST /v1/employees/{id}/create-account
|
||||
*/
|
||||
public function createAccount(int $id, Request $request): JsonResponse
|
||||
{
|
||||
$request->validate([
|
||||
'password' => 'required|string|min:8',
|
||||
]);
|
||||
|
||||
return ApiResponse::handle(function () use ($id, $request) {
|
||||
return $this->service->createAccount($id, $request->input('password'));
|
||||
}, __('message.updated'));
|
||||
}
|
||||
}
|
||||
@@ -30,8 +30,10 @@ public function show($userNo)
|
||||
|
||||
public function me(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->getMyInfo($request);
|
||||
return ApiResponse::handle(function () {
|
||||
$userId = (int) app('api_user');
|
||||
|
||||
return MemberService::getUserInfoForLogin($userId);
|
||||
}, __('message.user.me_fetched'));
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user