feat: I-1 미지급비용 관리 API 개발
- ExpectedExpense 모델 및 마이그레이션 생성 - ExpectedExpenseService 구현 (CRUD, 일괄삭제, 지급일 변경, 요약) - ExpectedExpenseController REST API 구현 - FormRequest 검증 클래스 3개 생성 - Swagger API 문서 작성 - 라우트 추가 (8개 엔드포인트) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
127
app/Http/Controllers/Api/V1/ExpectedExpenseController.php
Normal file
127
app/Http/Controllers/Api/V1/ExpectedExpenseController.php
Normal file
@@ -0,0 +1,127 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\V1;
|
||||
|
||||
use App\Helpers\ApiResponse;
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\V1\ExpectedExpense\StoreExpectedExpenseRequest;
|
||||
use App\Http\Requests\V1\ExpectedExpense\UpdateExpectedExpenseRequest;
|
||||
use App\Http\Requests\V1\ExpectedExpense\UpdateExpectedPaymentDateRequest;
|
||||
use App\Services\ExpectedExpenseService;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
class ExpectedExpenseController extends Controller
|
||||
{
|
||||
public function __construct(
|
||||
private readonly ExpectedExpenseService $service
|
||||
) {}
|
||||
|
||||
/**
|
||||
* 미지급비용 목록
|
||||
*/
|
||||
public function index(Request $request)
|
||||
{
|
||||
$params = $request->only([
|
||||
'search',
|
||||
'start_date',
|
||||
'end_date',
|
||||
'client_id',
|
||||
'transaction_type',
|
||||
'payment_status',
|
||||
'approval_status',
|
||||
'sort_by',
|
||||
'sort_dir',
|
||||
'per_page',
|
||||
'page',
|
||||
]);
|
||||
|
||||
$expenses = $this->service->index($params);
|
||||
|
||||
return ApiResponse::success($expenses, __('message.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 미지급비용 등록
|
||||
*/
|
||||
public function store(StoreExpectedExpenseRequest $request)
|
||||
{
|
||||
$expense = $this->service->store($request->validated());
|
||||
|
||||
return ApiResponse::success($expense, __('message.created'), [], 201);
|
||||
}
|
||||
|
||||
/**
|
||||
* 미지급비용 상세
|
||||
*/
|
||||
public function show(int $id)
|
||||
{
|
||||
$expense = $this->service->show($id);
|
||||
|
||||
return ApiResponse::success($expense, __('message.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 미지급비용 수정
|
||||
*/
|
||||
public function update(int $id, UpdateExpectedExpenseRequest $request)
|
||||
{
|
||||
$expense = $this->service->update($id, $request->validated());
|
||||
|
||||
return ApiResponse::success($expense, __('message.updated'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 미지급비용 삭제
|
||||
*/
|
||||
public function destroy(int $id)
|
||||
{
|
||||
$this->service->destroy($id);
|
||||
|
||||
return ApiResponse::success(null, __('message.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 미지급비용 일괄 삭제
|
||||
*/
|
||||
public function destroyMany(Request $request)
|
||||
{
|
||||
$ids = $request->input('ids', []);
|
||||
|
||||
if (empty($ids)) {
|
||||
return ApiResponse::error(__('error.no_ids_provided'), 400);
|
||||
}
|
||||
|
||||
$count = $this->service->destroyMany($ids);
|
||||
|
||||
return ApiResponse::success(['deleted_count' => $count], __('message.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 예상 지급일 일괄 변경
|
||||
*/
|
||||
public function updateExpectedPaymentDate(UpdateExpectedPaymentDateRequest $request)
|
||||
{
|
||||
$count = $this->service->updateExpectedPaymentDate(
|
||||
$request->input('ids'),
|
||||
$request->input('expected_payment_date')
|
||||
);
|
||||
|
||||
return ApiResponse::success(['updated_count' => $count], __('message.updated'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 미지급비용 요약 (기간별 합계)
|
||||
*/
|
||||
public function summary(Request $request)
|
||||
{
|
||||
$params = $request->only([
|
||||
'start_date',
|
||||
'end_date',
|
||||
'payment_status',
|
||||
]);
|
||||
|
||||
$summary = $this->service->summary($params);
|
||||
|
||||
return ApiResponse::success($summary, __('message.fetched'));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,58 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\ExpectedExpense;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class StoreExpectedExpenseRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'expected_payment_date' => ['required', 'date'],
|
||||
'settlement_date' => ['nullable', 'date'],
|
||||
'transaction_type' => ['required', 'string', 'in:purchase,advance,suspense,rent,salary,insurance,tax,utilities,other'],
|
||||
'amount' => ['required', 'numeric', 'min:0'],
|
||||
'client_id' => ['nullable', 'integer', 'exists:clients,id'],
|
||||
'client_name' => ['nullable', 'string', 'max:100'],
|
||||
'bank_account_id' => ['nullable', 'integer', 'exists:bank_accounts,id'],
|
||||
'account_code' => ['nullable', 'string', 'max:50'],
|
||||
'payment_status' => ['nullable', 'string', 'in:pending,partial,paid,overdue'],
|
||||
'approval_status' => ['nullable', 'string', 'in:none,pending,approved,rejected'],
|
||||
'description' => ['nullable', 'string', 'max:1000'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'expected_payment_date.required' => __('validation.required', ['attribute' => '예상 지급일']),
|
||||
'transaction_type.required' => __('validation.required', ['attribute' => '거래유형']),
|
||||
'transaction_type.in' => __('validation.in', ['attribute' => '거래유형']),
|
||||
'amount.required' => __('validation.required', ['attribute' => '금액']),
|
||||
'amount.min' => __('validation.min.numeric', ['attribute' => '금액', 'min' => 0]),
|
||||
];
|
||||
}
|
||||
|
||||
public function attributes(): array
|
||||
{
|
||||
return [
|
||||
'expected_payment_date' => '예상 지급일',
|
||||
'settlement_date' => '결제일',
|
||||
'transaction_type' => '거래유형',
|
||||
'amount' => '금액',
|
||||
'client_id' => '거래처',
|
||||
'client_name' => '거래처명',
|
||||
'bank_account_id' => '계좌',
|
||||
'account_code' => '계정과목',
|
||||
'payment_status' => '지급상태',
|
||||
'approval_status' => '결재상태',
|
||||
'description' => '적요',
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\ExpectedExpense;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class UpdateExpectedExpenseRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'expected_payment_date' => ['sometimes', 'date'],
|
||||
'settlement_date' => ['nullable', 'date'],
|
||||
'transaction_type' => ['sometimes', 'string', 'in:purchase,advance,suspense,rent,salary,insurance,tax,utilities,other'],
|
||||
'amount' => ['sometimes', 'numeric', 'min:0'],
|
||||
'client_id' => ['nullable', 'integer', 'exists:clients,id'],
|
||||
'client_name' => ['nullable', 'string', 'max:100'],
|
||||
'bank_account_id' => ['nullable', 'integer', 'exists:bank_accounts,id'],
|
||||
'account_code' => ['nullable', 'string', 'max:50'],
|
||||
'payment_status' => ['sometimes', 'string', 'in:pending,partial,paid,overdue'],
|
||||
'approval_status' => ['sometimes', 'string', 'in:none,pending,approved,rejected'],
|
||||
'description' => ['nullable', 'string', 'max:1000'],
|
||||
];
|
||||
}
|
||||
|
||||
public function attributes(): array
|
||||
{
|
||||
return [
|
||||
'expected_payment_date' => '예상 지급일',
|
||||
'settlement_date' => '결제일',
|
||||
'transaction_type' => '거래유형',
|
||||
'amount' => '금액',
|
||||
'client_id' => '거래처',
|
||||
'client_name' => '거래처명',
|
||||
'bank_account_id' => '계좌',
|
||||
'account_code' => '계정과목',
|
||||
'payment_status' => '지급상태',
|
||||
'approval_status' => '결재상태',
|
||||
'description' => '적요',
|
||||
];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\V1\ExpectedExpense;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class UpdateExpectedPaymentDateRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'ids' => ['required', 'array', 'min:1'],
|
||||
'ids.*' => ['required', 'integer'],
|
||||
'expected_payment_date' => ['required', 'date'],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'ids.required' => __('validation.required', ['attribute' => '대상 ID']),
|
||||
'ids.min' => __('validation.min.array', ['attribute' => '대상 ID', 'min' => 1]),
|
||||
'expected_payment_date.required' => __('validation.required', ['attribute' => '예상 지급일']),
|
||||
];
|
||||
}
|
||||
|
||||
public function attributes(): array
|
||||
{
|
||||
return [
|
||||
'ids' => '대상 ID',
|
||||
'expected_payment_date' => '예상 지급일',
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user