hskwon
71123128ff
- 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개
113 lines
2.6 KiB
PHP
113 lines
2.6 KiB
PHP
<?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'));
|
|
}
|
|
}
|