SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 급여 관리 API 구현 (Phase 2: 3.2)

Browse Source 
- 마이그레이션: payrolls, payroll_settings 테이블 생성
- 모델: Payroll (상태관리 draft→confirmed→paid), PayrollSetting
- 서비스: PayrollService (4대보험 계산, 급여명세서)
- 컨트롤러: PayrollController + FormRequest 5개
- API 엔드포인트 13개:
  - 급여 CRUD + confirm/pay/payslip
  - 일괄 계산/확정 (calculate, bulk-confirm)
  - 설정 관리 (settings/payroll)
- Swagger 문서: PayrollApi.php
- i18n: error.php, message.php, validation.php 키 추가
This commit is contained in:
권혁성
2025-12-18 10:56:16 +09:00
parent b43796a558
commit 7089dd1e46
16 changed files with 2350 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
app/Http/Requests/V1/Payroll/CalculatePayrollRequest.php Normal file
View File

@@ -0,0 +1,32 @@
<?php
namespace App\Http\Requests\V1\Payroll;
use Illuminate\Foundation\Http\FormRequest;
class CalculatePayrollRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'year' => ['required', 'integer', 'min:2000', 'max:2100'],
'month' => ['required', 'integer', 'min:1', 'max:12'],
'user_ids' => ['nullable', 'array'],
'user_ids.*' => ['integer', 'exists:users,id'],
];
}
public function attributes(): array
{
return [
'year' => __('validation.attributes.pay_year'),
'month' => __('validation.attributes.pay_month'),
'user_ids' => __('validation.attributes.user_ids'),
];
}
}

27
app/Http/Requests/V1/Payroll/PayPayrollRequest.php Normal file
View File

@@ -0,0 +1,27 @@
<?php
namespace App\Http\Requests\V1\Payroll;
use Illuminate\Foundation\Http\FormRequest;
class PayPayrollRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'withdrawal_id' => ['nullable', 'integer', 'exists:withdrawals,id'],
];
}
public function attributes(): array
{
return [
'withdrawal_id' => __('validation.attributes.withdrawal_id'),
];
}
}

57
app/Http/Requests/V1/Payroll/StorePayrollRequest.php Normal file
View File

@@ -0,0 +1,57 @@
<?php
namespace App\Http\Requests\V1\Payroll;
use Illuminate\Foundation\Http\FormRequest;
class StorePayrollRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'user_id' => ['required', 'integer', 'exists:users,id'],
'pay_year' => ['required', 'integer', 'min:2000', 'max:2100'],
'pay_month' => ['required', 'integer', 'min:1', 'max:12'],
'base_salary' => ['required', 'numeric', 'min:0'],
'overtime_pay' => ['nullable', 'numeric', 'min:0'],
'bonus' => ['nullable', 'numeric', 'min:0'],
'allowances' => ['nullable', 'array'],
'allowances.*.name' => ['required_with:allowances', 'string', 'max:50'],
'allowances.*.amount' => ['required_with:allowances', 'numeric', 'min:0'],
'income_tax' => ['nullable', 'numeric', 'min:0'],
'resident_tax' => ['nullable', 'numeric', 'min:0'],
'health_insurance' => ['nullable', 'numeric', 'min:0'],
'pension' => ['nullable', 'numeric', 'min:0'],
'employment_insurance' => ['nullable', 'numeric', 'min:0'],
'deductions' => ['nullable', 'array'],
'deductions.*.name' => ['required_with:deductions', 'string', 'max:50'],
'deductions.*.amount' => ['required_with:deductions', 'numeric', 'min:0'],
'note' => ['nullable', 'string', 'max:1000'],
];
}
public function attributes(): array
{
return [
'user_id' => __('validation.attributes.user_id'),
'pay_year' => __('validation.attributes.pay_year'),
'pay_month' => __('validation.attributes.pay_month'),
'base_salary' => __('validation.attributes.base_salary'),
'overtime_pay' => __('validation.attributes.overtime_pay'),
'bonus' => __('validation.attributes.bonus'),
'allowances' => __('validation.attributes.allowances'),
'income_tax' => __('validation.attributes.income_tax'),
'resident_tax' => __('validation.attributes.resident_tax'),
'health_insurance' => __('validation.attributes.health_insurance'),
'pension' => __('validation.attributes.pension'),
'employment_insurance' => __('validation.attributes.employment_insurance'),
'deductions' => __('validation.attributes.deductions'),
'note' => __('validation.attributes.note'),
];
}
}

57
app/Http/Requests/V1/Payroll/UpdatePayrollRequest.php Normal file
View File

@@ -0,0 +1,57 @@
<?php
namespace App\Http\Requests\V1\Payroll;
use Illuminate\Foundation\Http\FormRequest;
class UpdatePayrollRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'user_id' => ['sometimes', 'integer', 'exists:users,id'],
'pay_year' => ['sometimes', 'integer', 'min:2000', 'max:2100'],
'pay_month' => ['sometimes', 'integer', 'min:1', 'max:12'],
'base_salary' => ['sometimes', 'numeric', 'min:0'],
'overtime_pay' => ['nullable', 'numeric', 'min:0'],
'bonus' => ['nullable', 'numeric', 'min:0'],
'allowances' => ['nullable', 'array'],
'allowances.*.name' => ['required_with:allowances', 'string', 'max:50'],
'allowances.*.amount' => ['required_with:allowances', 'numeric', 'min:0'],
'income_tax' => ['nullable', 'numeric', 'min:0'],
'resident_tax' => ['nullable', 'numeric', 'min:0'],
'health_insurance' => ['nullable', 'numeric', 'min:0'],
'pension' => ['nullable', 'numeric', 'min:0'],
'employment_insurance' => ['nullable', 'numeric', 'min:0'],
'deductions' => ['nullable', 'array'],
'deductions.*.name' => ['required_with:deductions', 'string', 'max:50'],
'deductions.*.amount' => ['required_with:deductions', 'numeric', 'min:0'],
'note' => ['nullable', 'string', 'max:1000'],
];
}
public function attributes(): array
{
return [
'user_id' => __('validation.attributes.user_id'),
'pay_year' => __('validation.attributes.pay_year'),
'pay_month' => __('validation.attributes.pay_month'),
'base_salary' => __('validation.attributes.base_salary'),
'overtime_pay' => __('validation.attributes.overtime_pay'),
'bonus' => __('validation.attributes.bonus'),
'allowances' => __('validation.attributes.allowances'),
'income_tax' => __('validation.attributes.income_tax'),
'resident_tax' => __('validation.attributes.resident_tax'),
'health_insurance' => __('validation.attributes.health_insurance'),
'pension' => __('validation.attributes.pension'),
'employment_insurance' => __('validation.attributes.employment_insurance'),
'deductions' => __('validation.attributes.deductions'),
'note' => __('validation.attributes.note'),
];
}
}

54
app/Http/Requests/V1/Payroll/UpdatePayrollSettingRequest.php Normal file
View File

@@ -0,0 +1,54 @@
<?php
namespace App\Http\Requests\V1\Payroll;
use Illuminate\Foundation\Http\FormRequest;
class UpdatePayrollSettingRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'income_tax_rate' => ['nullable', 'numeric', 'min:0', 'max:100'],
'resident_tax_rate' => ['nullable', 'numeric', 'min:0', 'max:100'],
'health_insurance_rate' => ['nullable', 'numeric', 'min:0', 'max:100'],
'long_term_care_rate' => ['nullable', 'numeric', 'min:0', 'max:100'],
'pension_rate' => ['nullable', 'numeric', 'min:0', 'max:100'],
'employment_insurance_rate' => ['nullable', 'numeric', 'min:0', 'max:100'],
'pension_max_salary' => ['nullable', 'numeric', 'min:0'],
'pension_min_salary' => ['nullable', 'numeric', 'min:0'],
'pay_day' => ['nullable', 'integer', 'min:1', 'max:31'],
'auto_calculate' => ['nullable', 'boolean'],
'allowance_types' => ['nullable', 'array'],
'allowance_types.*.code' => ['required_with:allowance_types', 'string', 'max:20'],
'allowance_types.*.name' => ['required_with:allowance_types', 'string', 'max:50'],
'allowance_types.*.is_taxable' => ['nullable', 'boolean'],
'deduction_types' => ['nullable', 'array'],
'deduction_types.*.code' => ['required_with:deduction_types', 'string', 'max:20'],
'deduction_types.*.name' => ['required_with:deduction_types', 'string', 'max:50'],
];
}
public function attributes(): array
{
return [
'income_tax_rate' => __('validation.attributes.income_tax_rate'),
'resident_tax_rate' => __('validation.attributes.resident_tax_rate'),
'health_insurance_rate' => __('validation.attributes.health_insurance_rate'),
'long_term_care_rate' => __('validation.attributes.long_term_care_rate'),
'pension_rate' => __('validation.attributes.pension_rate'),
'employment_insurance_rate' => __('validation.attributes.employment_insurance_rate'),
'pension_max_salary' => __('validation.attributes.pension_max_salary'),
'pension_min_salary' => __('validation.attributes.pension_min_salary'),
'pay_day' => __('validation.attributes.pay_day'),
'auto_calculate' => __('validation.attributes.auto_calculate'),
'allowance_types' => __('validation.attributes.allowance_types'),
'deduction_types' => __('validation.attributes.deduction_types'),
];
}
}