Files
sam-api/app/Http/Controllers/Api/V1/ShipmentController.php
kent aca0902c26 feat: H-3 출하 관리 API 구현
- ShipmentController: 출하 CRUD 및 상태 관리 API
- ShipmentService: 출하 비즈니스 로직
- Shipment, ShipmentItem 모델
- FormRequest 검증 클래스
- Swagger 문서화
- shipments, shipment_items 테이블 마이그레이션

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-26 15:46:07 +09:00

165 lines
4.3 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\Shipment\ShipmentStoreRequest;
use App\Http\Requests\Shipment\ShipmentUpdateRequest;
use App\Http\Requests\Shipment\ShipmentUpdateStatusRequest;
use App\Services\ShipmentService;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
class ShipmentController extends Controller
{
public function __construct(
private readonly ShipmentService $service
) {}
/**
* 출하 목록 조회
*/
public function index(Request $request): JsonResponse
{
$params = $request->only([
'search',
'status',
'priority',
'delivery_method',
'scheduled_from',
'scheduled_to',
'can_ship',
'deposit_confirmed',
'sort_by',
'sort_dir',
'per_page',
'page',
]);
$shipments = $this->service->index($params);
return ApiResponse::success($shipments, __('message.fetched'));
}
/**
* 출하 통계 조회
*/
public function stats(): JsonResponse
{
$stats = $this->service->stats();
return ApiResponse::success($stats, __('message.fetched'));
}
/**
* 상태별 통계 조회 (탭용)
*/
public function statsByStatus(): JsonResponse
{
$stats = $this->service->statsByStatus();
return ApiResponse::success($stats, __('message.fetched'));
}
/**
* 출하 상세 조회
*/
public function show(int $id): JsonResponse
{
try {
$shipment = $this->service->show($id);
return ApiResponse::success($shipment, __('message.fetched'));
} catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
return ApiResponse::error(__('error.shipment.not_found'), 404);
}
}
/**
* 출하 생성
*/
public function store(ShipmentStoreRequest $request): JsonResponse
{
$shipment = $this->service->store($request->validated());
return ApiResponse::success($shipment, __('message.created'), 201);
}
/**
* 출하 수정
*/
public function update(ShipmentUpdateRequest $request, int $id): JsonResponse
{
try {
$shipment = $this->service->update($id, $request->validated());
return ApiResponse::success($shipment, __('message.updated'));
} catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
return ApiResponse::error(__('error.shipment.not_found'), 404);
}
}
/**
* 출하 상태 변경
*/
public function updateStatus(ShipmentUpdateStatusRequest $request, int $id): JsonResponse
{
try {
$shipment = $this->service->updateStatus(
$id,
$request->validated('status'),
$request->validated()
);
return ApiResponse::success($shipment, __('message.updated'));
} catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
return ApiResponse::error(__('error.shipment.not_found'), 404);
}
}
/**
* 출하 삭제
*/
public function destroy(int $id): JsonResponse
{
try {
$this->service->delete($id);
return ApiResponse::success(null, __('message.deleted'));
} catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
return ApiResponse::error(__('error.shipment.not_found'), 404);
}
}
/**
* LOT 옵션 조회
*/
public function lotOptions(): JsonResponse
{
$options = $this->service->getLotOptions();
return ApiResponse::success($options, __('message.fetched'));
}
/**
* 물류사 옵션 조회
*/
public function logisticsOptions(): JsonResponse
{
$options = $this->service->getLogisticsOptions();
return ApiResponse::success($options, __('message.fetched'));
}
/**
* 차량 톤수 옵션 조회
*/
public function vehicleTonnageOptions(): JsonResponse
{
$options = $this->service->getVehicleTonnageOptions();
return ApiResponse::success($options, __('message.fetched'));
}
}