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

feat: H-1 입고 관리 API 구현

Browse Source 
- ReceivingController: CRUD 및 목록 조회 API
- ReceivingService: 입고 비즈니스 로직
- Receiving 모델: 다중 테넌트 지원
- FormRequest 검증 클래스
- Swagger 문서화
- receivings 테이블 마이그레이션

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
권혁성
2025-12-26 15:45:33 +09:00
parent 84cce6742e
commit 43ccd1e6e0
8 changed files with 1039 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

99
app/Http/Controllers/Api/V1/ReceivingController.php Normal file
View File

@@ -0,0 +1,99 @@
<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Receiving\ProcessReceivingRequest;
use App\Http\Requests\V1\Receiving\StoreReceivingRequest;
use App\Http\Requests\V1\Receiving\UpdateReceivingRequest;
use App\Services\ReceivingService;
use Illuminate\Http\Request;
class ReceivingController extends Controller
{
public function __construct(
private readonly ReceivingService $service
) {}
/**
* 입고 목록
*/
public function index(Request $request)
{
$params = $request->only([
'search',
'status',
'start_date',
'end_date',
'sort_by',
'sort_dir',
'per_page',
'page',
]);
$receivings = $this->service->index($params);
return ApiResponse::success($receivings, __('message.fetched'));
}
/**
* 입고 통계
*/
public function stats()
{
$stats = $this->service->stats();
return ApiResponse::success($stats, __('message.fetched'));
}
/**
* 입고 등록
*/
public function store(StoreReceivingRequest $request)
{
$receiving = $this->service->store($request->validated());
return ApiResponse::success($receiving, __('message.created'), [], 201);
}
/**
* 입고 상세
*/
public function show(int $id)
{
$receiving = $this->service->show($id);
return ApiResponse::success($receiving, __('message.fetched'));
}
/**
* 입고 수정
*/
public function update(int $id, UpdateReceivingRequest $request)
{
$receiving = $this->service->update($id, $request->validated());
return ApiResponse::success($receiving, __('message.updated'));
}
/**
* 입고 삭제
*/
public function destroy(int $id)
{
$this->service->destroy($id);
return ApiResponse::success(null, __('message.deleted'));
}
/**
* 입고처리 (상태 변경 + 입고 정보 입력)
*/
public function process(int $id, ProcessReceivingRequest $request)
{
$receiving = $this->service->process($id, $request->validated());
return ApiResponse::success($receiving, __('message.receiving.processed'));
}
}

36
app/Http/Requests/V1/Receiving/ProcessReceivingRequest.php Normal file
View File

@@ -0,0 +1,36 @@
<?php
namespace App\Http\Requests\V1\Receiving;
use Illuminate\Foundation\Http\FormRequest;
class ProcessReceivingRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'receiving_qty' => ['required', 'numeric', 'min:0'],
'receiving_date' => ['nullable', 'date'],
'lot_no' => ['nullable', 'string', 'max:50'],
'supplier_lot' => ['nullable', 'string', 'max:50'],
'receiving_location' => ['required', 'string', 'max:100'],
'receiving_manager' => ['nullable', 'string', 'max:50'],
'remark' => ['nullable', 'string', 'max:1000'],
];
}
public function messages(): array
{
return [
'receiving_qty.required' => __('validation.required', ['attribute' => '입고수량']),
'receiving_qty.numeric' => __('validation.numeric', ['attribute' => '입고수량']),
'receiving_qty.min' => __('validation.min.numeric', ['attribute' => '입고수량', 'min' => 0]),
'receiving_location.required' => __('validation.required', ['attribute' => '입고위치']),
];
}
}

43
app/Http/Requests/V1/Receiving/StoreReceivingRequest.php Normal file
View File

@@ -0,0 +1,43 @@
<?php
namespace App\Http\Requests\V1\Receiving;
use Illuminate\Foundation\Http\FormRequest;
class StoreReceivingRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'order_no' => ['nullable', 'string', 'max:30'],
'order_date' => ['nullable', 'date'],
'item_id' => ['nullable', 'integer'],
'item_code' => ['required', 'string', 'max:50'],
'item_name' => ['required', 'string', 'max:200'],
'specification' => ['nullable', 'string', 'max:200'],
'supplier' => ['required', 'string', 'max:100'],
'order_qty' => ['required', 'numeric', 'min:0'],
'order_unit' => ['nullable', 'string', 'max:20'],
'due_date' => ['nullable', 'date'],
'status' => ['nullable', 'string', 'in:order_completed,shipping,inspection_pending,receiving_pending'],
'remark' => ['nullable', 'string', 'max:1000'],
];
}
public function messages(): array
{
return [
'item_code.required' => __('validation.required', ['attribute' => '품목코드']),
'item_name.required' => __('validation.required', ['attribute' => '품목명']),
'supplier.required' => __('validation.required', ['attribute' => '공급업체']),
'order_qty.required' => __('validation.required', ['attribute' => '발주수량']),
'order_qty.numeric' => __('validation.numeric', ['attribute' => '발주수량']),
'order_qty.min' => __('validation.min.numeric', ['attribute' => '발주수량', 'min' => 0]),
];
}
}

38
app/Http/Requests/V1/Receiving/UpdateReceivingRequest.php Normal file
View File

@@ -0,0 +1,38 @@
<?php
namespace App\Http\Requests\V1\Receiving;
use Illuminate\Foundation\Http\FormRequest;
class UpdateReceivingRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'order_no' => ['nullable', 'string', 'max:30'],
'order_date' => ['nullable', 'date'],
'item_code' => ['sometimes', 'string', 'max:50'],
'item_name' => ['sometimes', 'string', 'max:200'],
'specification' => ['nullable', 'string', 'max:200'],
'supplier' => ['sometimes', 'string', 'max:100'],
'order_qty' => ['sometimes', 'numeric', 'min:0'],
'order_unit' => ['nullable', 'string', 'max:20'],
'due_date' => ['nullable', 'date'],
'status' => ['sometimes', 'string', 'in:order_completed,shipping,inspection_pending,receiving_pending'],
'remark' => ['nullable', 'string', 'max:1000'],
];
}
public function messages(): array
{
return [
'order_qty.numeric' => __('validation.numeric', ['attribute' => '발주수량']),
'order_qty.min' => __('validation.min.numeric', ['attribute' => '발주수량', 'min' => 0]),
];
}
}