hskwon
cbed92a95c
- 매출(Sale) 및 매입(Purchase) CRUD API 구현
- 문서번호 자동 생성 (SL/PU + YYYYMMDD + 시퀀스)
- 상태 관리 (draft → confirmed → invoiced)
- 확정(confirm) 및 요약(summary) 기능 추가
- BelongsToTenant, SoftDeletes 적용
- Swagger API 문서 작성 완료
추가된 파일:
- 마이그레이션: sales, purchases 테이블
- 모델: Sale, Purchase
- 서비스: SaleService, PurchaseService
- 컨트롤러: SaleController, PurchaseController
- FormRequest: Store/Update 4개
- Swagger: SaleApi.php, PurchaseApi.php
API 엔드포인트 (14개):
- GET/POST /v1/sales, /v1/purchases
- GET/PUT/DELETE /v1/{sales,purchases}/{id}
- POST /v1/{sales,purchases}/{id}/confirm
- GET /v1/{sales,purchases}/summary
107 lines
2.3 KiB
PHP
107 lines
2.3 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Controllers\Api\V1;
|
|
|
|
use App\Http\Controllers\Controller;
|
|
use App\Http\Requests\V1\Sale\StoreSaleRequest;
|
|
use App\Http\Requests\V1\Sale\UpdateSaleRequest;
|
|
use App\Http\Responses\ApiResponse;
|
|
use App\Services\SaleService;
|
|
use Illuminate\Http\Request;
|
|
|
|
class SaleController extends Controller
|
|
{
|
|
public function __construct(
|
|
private readonly SaleService $service
|
|
) {}
|
|
|
|
/**
|
|
* 매출 목록
|
|
*/
|
|
public function index(Request $request)
|
|
{
|
|
$params = $request->only([
|
|
'search',
|
|
'start_date',
|
|
'end_date',
|
|
'client_id',
|
|
'status',
|
|
'sort_by',
|
|
'sort_dir',
|
|
'per_page',
|
|
'page',
|
|
]);
|
|
|
|
$sales = $this->service->index($params);
|
|
|
|
return ApiResponse::handle(__('message.fetched'), $sales);
|
|
}
|
|
|
|
/**
|
|
* 매출 등록
|
|
*/
|
|
public function store(StoreSaleRequest $request)
|
|
{
|
|
$sale = $this->service->store($request->validated());
|
|
|
|
return ApiResponse::handle(__('message.created'), $sale, 201);
|
|
}
|
|
|
|
/**
|
|
* 매출 상세
|
|
*/
|
|
public function show(int $id)
|
|
{
|
|
$sale = $this->service->show($id);
|
|
|
|
return ApiResponse::handle(__('message.fetched'), $sale);
|
|
}
|
|
|
|
/**
|
|
* 매출 수정
|
|
*/
|
|
public function update(int $id, UpdateSaleRequest $request)
|
|
{
|
|
$sale = $this->service->update($id, $request->validated());
|
|
|
|
return ApiResponse::handle(__('message.updated'), $sale);
|
|
}
|
|
|
|
/**
|
|
* 매출 삭제
|
|
*/
|
|
public function destroy(int $id)
|
|
{
|
|
$this->service->destroy($id);
|
|
|
|
return ApiResponse::handle(__('message.deleted'));
|
|
}
|
|
|
|
/**
|
|
* 매출 확정
|
|
*/
|
|
public function confirm(int $id)
|
|
{
|
|
$sale = $this->service->confirm($id);
|
|
|
|
return ApiResponse::handle(__('message.sale.confirmed'), $sale);
|
|
}
|
|
|
|
/**
|
|
* 매출 요약 (기간별 합계)
|
|
*/
|
|
public function summary(Request $request)
|
|
{
|
|
$params = $request->only([
|
|
'start_date',
|
|
'end_date',
|
|
'client_id',
|
|
'status',
|
|
]);
|
|
|
|
$summary = $this->service->summary($params);
|
|
|
|
return ApiResponse::handle(__('message.fetched'), $summary);
|
|
}
|
|
}
|