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:
2025-12-17 20:46:37 +09:00
parent e81e5d7084
commit ca5618be98
19 changed files with 1523 additions and 6 deletions

View 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);
}
}

View 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);
}
}