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

feat: 어음 관리(Bill Management) API 추가

Browse Source 
- BillController: 어음 CRUD + 상태변경 + 요약 API
- BillService: 비즈니스 로직 (멀티테넌트 지원)
- Bill, BillInstallment 모델: 날짜 포맷(Y-m-d) toArray 오버라이드
- FormRequest: Store/Update/UpdateStatus 유효성 검사
- Swagger 문서: BillApi.php
- 마이그레이션: bills, bill_installments 테이블
- DummyBillSeeder: 테스트 데이터 30건 + 차수 12건
- API Routes: /api/v1/bills 엔드포인트 7개
This commit is contained in:
권혁성
2025-12-23 23:42:02 +09:00
parent d6d004f32b
commit 71123128ff
11 changed files with 1442 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

112
app/Http/Controllers/Api/V1/BillController.php Normal file
View File

@@ -0,0 +1,112 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Bill\StoreBillRequest;
use App\Http\Requests\V1\Bill\UpdateBillRequest;
use App\Http\Requests\V1\Bill\UpdateBillStatusRequest;
use App\Services\BillService;
use Illuminate\Http\Request;
class BillController extends Controller
{
public function __construct(
private readonly BillService $service
) {}
/**
* 어음 목록
*/
public function index(Request $request)
{
$params = $request->only([
'search',
'bill_type',
'status',
'client_id',
'is_electronic',
'issue_start_date',
'issue_end_date',
'maturity_start_date',
'maturity_end_date',
'sort_by',
'sort_dir',
'per_page',
'page',
]);
$bills = $this->service->index($params);
return ApiResponse::success($bills, __('message.fetched'));
}
/**
* 어음 등록
*/
public function store(StoreBillRequest $request)
{
$bill = $this->service->store($request->validated());
return ApiResponse::success($bill, __('message.created'), [], 201);
}
/**
* 어음 상세
*/
public function show(int $id)
{
$bill = $this->service->show($id);
return ApiResponse::success($bill, __('message.fetched'));
}
/**
* 어음 수정
*/
public function update(int $id, UpdateBillRequest $request)
{
$bill = $this->service->update($id, $request->validated());
return ApiResponse::success($bill, __('message.updated'));
}
/**
* 어음 삭제
*/
public function destroy(int $id)
{
$this->service->destroy($id);
return ApiResponse::success(null, __('message.deleted'));
}
/**
* 어음 상태 변경
*/
public function updateStatus(int $id, UpdateBillStatusRequest $request)
{
$bill = $this->service->updateStatus($id, $request->validated()['status']);
return ApiResponse::success($bill, __('message.updated'));
}
/**
* 어음 요약 (기간별 합계)
*/
public function summary(Request $request)
{
$params = $request->only([
'bill_type',
'issue_start_date',
'issue_end_date',
'maturity_start_date',
'maturity_end_date',
]);
$summary = $this->service->summary($params);
return ApiResponse::success($summary, __('message.fetched'));
}
}

67
app/Http/Requests/V1/Bill/StoreBillRequest.php Normal file
View File

@@ -0,0 +1,67 @@
<?php
namespace App\Http\Requests\V1\Bill;
use Illuminate\Foundation\Http\FormRequest;
class StoreBillRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'bill_number' => ['nullable', 'string', 'max:50'],
'bill_type' => ['required', 'string', 'in:received,issued'],
'client_id' => ['nullable', 'integer', 'exists:clients,id'],
'client_name' => ['nullable', 'string', 'max:100'],
'amount' => ['required', 'numeric', 'min:0'],
'issue_date' => ['required', 'date'],
'maturity_date' => ['required', 'date', 'after_or_equal:issue_date'],
'status' => ['nullable', 'string', 'in:stored,maturityAlert,maturityResult,paymentComplete,dishonored,collectionRequest,collectionComplete,suing'],
'reason' => ['nullable', 'string', 'max:255'],
'installment_count' => ['nullable', 'integer', 'min:0'],
'note' => ['nullable', 'string', 'max:1000'],
'is_electronic' => ['nullable', 'boolean'],
'bank_account_id' => ['nullable', 'integer', 'exists:bank_accounts,id'],
'installments' => ['nullable', 'array'],
'installments.*.date' => ['required_with:installments', 'date'],
'installments.*.amount' => ['required_with:installments', 'numeric', 'min:0'],
'installments.*.note' => ['nullable', 'string', 'max:255'],
];
}
public function messages(): array
{
return [
'bill_type.required' => __('validation.required', ['attribute' => __('validation.attributes.bill_type')]),
'bill_type.in' => __('validation.in', ['attribute' => __('validation.attributes.bill_type')]),
'amount.required' => __('validation.required', ['attribute' => __('validation.attributes.amount')]),
'amount.min' => __('validation.min.numeric', ['attribute' => __('validation.attributes.amount'), 'min' => 0]),
'issue_date.required' => __('validation.required', ['attribute' => __('validation.attributes.issue_date')]),
'maturity_date.required' => __('validation.required', ['attribute' => __('validation.attributes.maturity_date')]),
'maturity_date.after_or_equal' => __('validation.after_or_equal', ['attribute' => __('validation.attributes.maturity_date'), 'date' => __('validation.attributes.issue_date')]),
];
}
public function attributes(): array
{
return [
'bill_number' => __('validation.attributes.bill_number'),
'bill_type' => __('validation.attributes.bill_type'),
'client_id' => __('validation.attributes.client_id'),
'client_name' => __('validation.attributes.client_name'),
'amount' => __('validation.attributes.amount'),
'issue_date' => __('validation.attributes.issue_date'),
'maturity_date' => __('validation.attributes.maturity_date'),
'status' => __('validation.attributes.status'),
'reason' => __('validation.attributes.reason'),
'note' => __('validation.attributes.note'),
'is_electronic' => __('validation.attributes.is_electronic'),
'bank_account_id' => __('validation.attributes.bank_account_id'),
];
}
}

63
app/Http/Requests/V1/Bill/UpdateBillRequest.php Normal file
View File

@@ -0,0 +1,63 @@
<?php
namespace App\Http\Requests\V1\Bill;
use Illuminate\Foundation\Http\FormRequest;
class UpdateBillRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'bill_number' => ['nullable', 'string', 'max:50'],
'bill_type' => ['nullable', 'string', 'in:received,issued'],
'client_id' => ['nullable', 'integer', 'exists:clients,id'],
'client_name' => ['nullable', 'string', 'max:100'],
'amount' => ['nullable', 'numeric', 'min:0'],
'issue_date' => ['nullable', 'date'],
'maturity_date' => ['nullable', 'date', 'after_or_equal:issue_date'],
'status' => ['nullable', 'string', 'in:stored,maturityAlert,maturityResult,paymentComplete,dishonored,collectionRequest,collectionComplete,suing'],
'reason' => ['nullable', 'string', 'max:255'],
'installment_count' => ['nullable', 'integer', 'min:0'],
'note' => ['nullable', 'string', 'max:1000'],
'is_electronic' => ['nullable', 'boolean'],
'bank_account_id' => ['nullable', 'integer', 'exists:bank_accounts,id'],
'installments' => ['nullable', 'array'],
'installments.*.date' => ['required_with:installments', 'date'],
'installments.*.amount' => ['required_with:installments', 'numeric', 'min:0'],
'installments.*.note' => ['nullable', 'string', 'max:255'],
];
}
public function messages(): array
{
return [
'bill_type.in' => __('validation.in', ['attribute' => __('validation.attributes.bill_type')]),
'amount.min' => __('validation.min.numeric', ['attribute' => __('validation.attributes.amount'), 'min' => 0]),
'maturity_date.after_or_equal' => __('validation.after_or_equal', ['attribute' => __('validation.attributes.maturity_date'), 'date' => __('validation.attributes.issue_date')]),
];
}
public function attributes(): array
{
return [
'bill_number' => __('validation.attributes.bill_number'),
'bill_type' => __('validation.attributes.bill_type'),
'client_id' => __('validation.attributes.client_id'),
'client_name' => __('validation.attributes.client_name'),
'amount' => __('validation.attributes.amount'),
'issue_date' => __('validation.attributes.issue_date'),
'maturity_date' => __('validation.attributes.maturity_date'),
'status' => __('validation.attributes.status'),
'reason' => __('validation.attributes.reason'),
'note' => __('validation.attributes.note'),
'is_electronic' => __('validation.attributes.is_electronic'),
'bank_account_id' => __('validation.attributes.bank_account_id'),
];
}
}

35
app/Http/Requests/V1/Bill/UpdateBillStatusRequest.php Normal file
View File

@@ -0,0 +1,35 @@
<?php
namespace App\Http\Requests\V1\Bill;
use Illuminate\Foundation\Http\FormRequest;
class UpdateBillStatusRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'status' => ['required', 'string', 'in:stored,maturityAlert,maturityResult,paymentComplete,dishonored,collectionRequest,collectionComplete,suing'],
];
}
public function messages(): array
{
return [
'status.required' => __('validation.required', ['attribute' => __('validation.attributes.status')]),
'status.in' => __('validation.in', ['attribute' => __('validation.attributes.status')]),
];
}
public function attributes(): array
{
return [
'status' => __('validation.attributes.status'),
];
}
}