feat: 근무/출퇴근 설정 및 현장 관리 API 구현
- 근무 설정 API (GET/PUT /settings/work) - 근무유형, 소정근로시간, 연장근로시간, 근무요일, 출퇴근시간, 휴게시간 - 출퇴근 설정 API (GET/PUT /settings/attendance) - GPS 출퇴근, 허용 반경, 본사 위치 설정 - 현장 관리 API (CRUD /sites) - 현장 등록/수정/삭제, 활성화된 현장 목록(셀렉트박스용) - GPS 좌표 기반 위치 관리 마이그레이션: work_settings, attendance_settings, sites 테이블 모델: WorkSetting, AttendanceSetting, Site (BelongsToTenant, SoftDeletes) 서비스: WorkSettingService, SiteService Swagger 문서 및 i18n 메시지 키 추가
This commit is contained in:
86
app/Http/Controllers/Api/V1/SiteController.php
Normal file
86
app/Http/Controllers/Api/V1/SiteController.php
Normal file
@@ -0,0 +1,86 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\V1;
|
||||
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\V1\Site\StoreSiteRequest;
|
||||
use App\Http\Requests\V1\Site\UpdateSiteRequest;
|
||||
use App\Http\Responses\ApiResponse;
|
||||
use App\Services\SiteService;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
class SiteController extends Controller
|
||||
{
|
||||
public function __construct(
|
||||
private readonly SiteService $service
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 현장 목록
|
||||
*/
|
||||
public function index(Request $request)
|
||||
{
|
||||
$params = $request->only([
|
||||
'search',
|
||||
'is_active',
|
||||
'sort_by',
|
||||
'sort_dir',
|
||||
'per_page',
|
||||
'page',
|
||||
]);
|
||||
|
||||
$sites = $this->service->index($params);
|
||||
|
||||
return ApiResponse::handle(__('message.fetched'), $sites);
|
||||
}
|
||||
|
||||
/**
|
||||
* 현장 등록
|
||||
*/
|
||||
public function store(StoreSiteRequest $request)
|
||||
{
|
||||
$site = $this->service->store($request->validated());
|
||||
|
||||
return ApiResponse::handle(__('message.created'), $site, 201);
|
||||
}
|
||||
|
||||
/**
|
||||
* 현장 상세
|
||||
*/
|
||||
public function show(int $id)
|
||||
{
|
||||
$site = $this->service->show($id);
|
||||
|
||||
return ApiResponse::handle(__('message.fetched'), $site);
|
||||
}
|
||||
|
||||
/**
|
||||
* 현장 수정
|
||||
*/
|
||||
public function update(int $id, UpdateSiteRequest $request)
|
||||
{
|
||||
$site = $this->service->update($id, $request->validated());
|
||||
|
||||
return ApiResponse::handle(__('message.updated'), $site);
|
||||
}
|
||||
|
||||
/**
|
||||
* 현장 삭제
|
||||
*/
|
||||
public function destroy(int $id)
|
||||
{
|
||||
$this->service->destroy($id);
|
||||
|
||||
return ApiResponse::handle(__('message.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 활성화된 현장 목록 (셀렉트박스용)
|
||||
*/
|
||||
public function active()
|
||||
{
|
||||
$sites = $this->service->getActiveSites();
|
||||
|
||||
return ApiResponse::handle(__('message.fetched'), $sites);
|
||||
}
|
||||
}
|
||||
56
app/Http/Controllers/Api/V1/WorkSettingController.php
Normal file
56
app/Http/Controllers/Api/V1/WorkSettingController.php
Normal file
@@ -0,0 +1,56 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\V1;
|
||||
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\V1\WorkSetting\UpdateAttendanceSettingRequest;
|
||||
use App\Http\Requests\V1\WorkSetting\UpdateWorkSettingRequest;
|
||||
use App\Http\Responses\ApiResponse;
|
||||
use App\Services\WorkSettingService;
|
||||
|
||||
class WorkSettingController extends Controller
|
||||
{
|
||||
public function __construct(
|
||||
private readonly WorkSettingService $service
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 근무 설정 조회
|
||||
*/
|
||||
public function showWorkSetting()
|
||||
{
|
||||
$setting = $this->service->getWorkSetting();
|
||||
|
||||
return ApiResponse::handle(__('message.fetched'), $setting);
|
||||
}
|
||||
|
||||
/**
|
||||
* 근무 설정 수정
|
||||
*/
|
||||
public function updateWorkSetting(UpdateWorkSettingRequest $request)
|
||||
{
|
||||
$setting = $this->service->updateWorkSetting($request->validated());
|
||||
|
||||
return ApiResponse::handle(__('message.updated'), $setting);
|
||||
}
|
||||
|
||||
/**
|
||||
* 출퇴근 설정 조회
|
||||
*/
|
||||
public function showAttendanceSetting()
|
||||
{
|
||||
$setting = $this->service->getAttendanceSetting();
|
||||
|
||||
return ApiResponse::handle(__('message.fetched'), $setting);
|
||||
}
|
||||
|
||||
/**
|
||||
* 출퇴근 설정 수정
|
||||
*/
|
||||
public function updateAttendanceSetting(UpdateAttendanceSettingRequest $request)
|
||||
{
|
||||
$setting = $this->service->updateAttendanceSetting($request->validated());
|
||||
|
||||
return ApiResponse::handle(__('message.updated'), $setting);
|
||||
}
|
||||
}
|
||||
34
app/Http/Requests/V1/Site/StoreSiteRequest.php
Normal file
34
app/Http/Requests/V1/Site/StoreSiteRequest.php
Normal file
@@ -0,0 +1,34 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\Site;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class StoreSiteRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'name' => ['required', 'string', 'max:100'],
|
||||
'address' => ['nullable', 'string', 'max:255'],
|
||||
'latitude' => ['nullable', 'numeric', 'between:-90,90'],
|
||||
'longitude' => ['nullable', 'numeric', 'between:-180,180'],
|
||||
'is_active' => ['sometimes', 'boolean'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'name.required' => __('error.site.name_required'),
|
||||
'name.max' => __('error.site.name_too_long'),
|
||||
'latitude.between' => __('error.site.invalid_latitude'),
|
||||
'longitude.between' => __('error.site.invalid_longitude'),
|
||||
];
|
||||
}
|
||||
}
|
||||
33
app/Http/Requests/V1/Site/UpdateSiteRequest.php
Normal file
33
app/Http/Requests/V1/Site/UpdateSiteRequest.php
Normal file
@@ -0,0 +1,33 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\Site;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class UpdateSiteRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'name' => ['sometimes', 'string', 'max:100'],
|
||||
'address' => ['nullable', 'string', 'max:255'],
|
||||
'latitude' => ['nullable', 'numeric', 'between:-90,90'],
|
||||
'longitude' => ['nullable', 'numeric', 'between:-180,180'],
|
||||
'is_active' => ['sometimes', 'boolean'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'name.max' => __('error.site.name_too_long'),
|
||||
'latitude.between' => __('error.site.invalid_latitude'),
|
||||
'longitude.between' => __('error.site.invalid_longitude'),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,34 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\WorkSetting;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class UpdateAttendanceSettingRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'use_gps' => ['sometimes', 'boolean'],
|
||||
'allowed_radius' => ['sometimes', 'integer', 'min:10', 'max:10000'],
|
||||
'hq_address' => ['nullable', 'string', 'max:255'],
|
||||
'hq_latitude' => ['nullable', 'numeric', 'between:-90,90'],
|
||||
'hq_longitude' => ['nullable', 'numeric', 'between:-180,180'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'allowed_radius.min' => __('error.attendance_setting.radius_too_small'),
|
||||
'allowed_radius.max' => __('error.attendance_setting.radius_too_large'),
|
||||
'hq_latitude.between' => __('error.attendance_setting.invalid_latitude'),
|
||||
'hq_longitude.between' => __('error.attendance_setting.invalid_longitude'),
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,41 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\WorkSetting;
|
||||
|
||||
use App\Models\Tenants\WorkSetting;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class UpdateWorkSettingRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'work_type' => ['sometimes', 'string', Rule::in(WorkSetting::WORK_TYPES)],
|
||||
'standard_hours' => ['sometimes', 'integer', 'min:1', 'max:168'],
|
||||
'overtime_hours' => ['sometimes', 'integer', 'min:0', 'max:52'],
|
||||
'overtime_limit' => ['sometimes', 'integer', 'min:0', 'max:100'],
|
||||
'work_days' => ['sometimes', 'array'],
|
||||
'work_days.*' => ['string', Rule::in(['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'])],
|
||||
'start_time' => ['sometimes', 'date_format:H:i:s'],
|
||||
'end_time' => ['sometimes', 'date_format:H:i:s', 'after:start_time'],
|
||||
'break_minutes' => ['sometimes', 'integer', 'min:0', 'max:180'],
|
||||
'break_start' => ['nullable', 'date_format:H:i:s'],
|
||||
'break_end' => ['nullable', 'date_format:H:i:s', 'after:break_start'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'work_type.in' => __('error.work_setting.invalid_work_type'),
|
||||
'end_time.after' => __('error.work_setting.end_time_after_start'),
|
||||
'break_end.after' => __('error.work_setting.break_end_after_start'),
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user