Files
sam-api/app/Services/ReceivingService.php
권혁성 7eb5825d41 fix(WEB): 입고관리 저장 오류 3건 수정
- FormRequest에 manufacturer, material_no 규칙 추가 (validated()에서 누락 방지)
- store() 시 lot_no 자동 생성 (generateLotNo() 폴백)
- getOrCreateStock()에서 item_code 기반 2차 검색 추가 (unique key 충돌 방지)
  - 동일 item_code, 다른 item_id인 Stock 존재 시 item_id 업데이트
  - SoftDeletes 복원 로직 포함

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 04:19:48 +09:00

538 lines
19 KiB
PHP

<?php
namespace App\Services;
use App\Models\Tenants\Receiving;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Support\Facades\DB;
class ReceivingService extends Service
{
/**
* 입고 목록 조회
*/
public function index(array $params): LengthAwarePaginator
{
$tenantId = $this->tenantId();
$query = Receiving::query()
->with(['creator:id,name', 'item:id,item_type,code,name'])
->where('tenant_id', $tenantId);
// 검색어 필터
if (! empty($params['search'])) {
$search = $params['search'];
$query->where(function ($q) use ($search) {
$q->where('order_no', 'like', "%{$search}%")
->orWhere('item_code', 'like', "%{$search}%")
->orWhere('item_name', 'like', "%{$search}%")
->orWhere('supplier', 'like', "%{$search}%");
});
}
// 상태 필터
if (! empty($params['status'])) {
if ($params['status'] === 'receiving_pending') {
// 입고대기: receiving_pending + inspection_pending
$query->whereIn('status', ['receiving_pending', 'inspection_pending']);
} elseif ($params['status'] === 'completed') {
$query->where('status', 'completed');
} else {
$query->where('status', $params['status']);
}
}
// 날짜 범위 필터 (작성일 기준)
if (! empty($params['start_date'])) {
$query->whereDate('created_at', '>=', $params['start_date']);
}
if (! empty($params['end_date'])) {
$query->whereDate('created_at', '<=', $params['end_date']);
}
// 정렬
$sortBy = $params['sort_by'] ?? 'created_at';
$sortDir = $params['sort_dir'] ?? 'desc';
$query->orderBy($sortBy, $sortDir);
// 페이지네이션
$perPage = $params['per_page'] ?? 20;
$paginator = $query->paginate($perPage);
// 수입검사 템플릿 연결 여부 계산
$itemIds = $paginator->pluck('item_id')->filter()->unique()->values()->toArray();
$itemsWithInspection = $this->getItemsWithInspectionTemplate($itemIds);
// has_inspection_template 필드 추가
$paginator->getCollection()->transform(function ($receiving) use ($itemsWithInspection) {
$receiving->has_inspection_template = $receiving->item_id
? in_array($receiving->item_id, $itemsWithInspection)
: false;
return $receiving;
});
return $paginator;
}
/**
* 수입검사 템플릿에 연결된 품목 ID 조회
*
* DocumentService::resolve()와 동일한 조건 사용:
* - category: 영문 코드('incoming_inspection'), 한글('수입검사'), 부분 매칭 모두 지원
* - linked_item_ids: int/string 타입 모두 매칭
*/
private function getItemsWithInspectionTemplate(array $itemIds): array
{
if (empty($itemIds)) {
return [];
}
$tenantId = $this->tenantId();
// DocumentService::resolve()와 동일한 category 매칭 조건
$categoryCode = 'incoming_inspection';
$categoryName = '수입검사';
$templates = DB::table('document_templates')
->where('tenant_id', $tenantId)
->where('is_active', true)
->whereNotNull('linked_item_ids')
->where(function ($q) use ($categoryCode, $categoryName) {
$q->where('category', $categoryCode)
->orWhere('category', $categoryName)
->orWhere('category', 'LIKE', "%{$categoryName}%");
})
->get(['linked_item_ids']);
$linkedItemIds = [];
foreach ($templates as $template) {
$ids = json_decode($template->linked_item_ids, true) ?? [];
// int/string 타입 모두 매칭되도록 정수로 통일
foreach ($ids as $id) {
$linkedItemIds[] = (int) $id;
}
}
// 요청된 품목 ID도 정수로 통일하여 교집합
$intItemIds = array_map('intval', $itemIds);
return array_values(array_intersect($intItemIds, array_unique($linkedItemIds)));
}
/**
* 입고 통계 조회
*/
public function stats(): array
{
$tenantId = $this->tenantId();
$today = now()->toDateString();
$receivingPendingCount = Receiving::where('tenant_id', $tenantId)
->where('status', 'receiving_pending')
->count();
$shippingCount = Receiving::where('tenant_id', $tenantId)
->where('status', 'shipping')
->count();
$inspectionPendingCount = Receiving::where('tenant_id', $tenantId)
->where('status', 'inspection_pending')
->count();
$todayReceivingCount = Receiving::where('tenant_id', $tenantId)
->where('status', 'completed')
->whereDate('receiving_date', $today)
->count();
return [
'receiving_pending_count' => $receivingPendingCount,
'shipping_count' => $shippingCount,
'inspection_pending_count' => $inspectionPendingCount,
'today_receiving_count' => $todayReceivingCount,
];
}
/**
* 입고 상세 조회
*/
public function show(int $id): Receiving
{
$tenantId = $this->tenantId();
return Receiving::query()
->where('tenant_id', $tenantId)
->with(['creator:id,name', 'item:id,item_type,code,name'])
->findOrFail($id);
}
/**
* 입고 등록
*/
public function store(array $data): Receiving
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($data, $tenantId, $userId) {
// 입고번호 자동 생성
$receivingNumber = $this->generateReceivingNumber($tenantId);
// item_id 조회 (전달되지 않은 경우 item_code로 조회)
$itemId = $data['item_id'] ?? null;
if (! $itemId && ! empty($data['item_code'])) {
$itemId = $this->findItemIdByCode($tenantId, $data['item_code']);
}
$receiving = new Receiving;
$receiving->tenant_id = $tenantId;
$receiving->receiving_number = $receivingNumber;
$receiving->order_no = $data['order_no'] ?? null;
$receiving->order_date = $data['order_date'] ?? null;
$receiving->item_id = $itemId;
$receiving->item_code = $data['item_code'];
$receiving->item_name = $data['item_name'];
$receiving->specification = $data['specification'] ?? null;
$receiving->supplier = $data['supplier'];
$receiving->order_qty = $data['order_qty'] ?? null;
$receiving->order_unit = $data['order_unit'] ?? 'EA';
$receiving->due_date = $data['due_date'] ?? null;
$receiving->receiving_qty = $data['receiving_qty'] ?? null;
$receiving->receiving_date = $data['receiving_date'] ?? null;
$receiving->lot_no = $data['lot_no'] ?? $this->generateLotNo();
$receiving->status = $data['status'] ?? 'receiving_pending';
$receiving->remark = $data['remark'] ?? null;
// options 필드 처리 (제조사, 수입검사 등 확장 필드)
$receiving->options = $this->buildOptions($data);
$receiving->created_by = $userId;
$receiving->updated_by = $userId;
$receiving->save();
return $receiving;
});
}
/**
* 입고 수정
*/
public function update(int $id, array $data): Receiving
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($id, $data, $tenantId, $userId) {
$receiving = Receiving::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
if (! $receiving->canEdit()) {
throw new \Exception(__('error.receiving.cannot_edit'));
}
if (isset($data['order_no'])) {
$receiving->order_no = $data['order_no'];
}
if (isset($data['order_date'])) {
$receiving->order_date = $data['order_date'];
}
if (isset($data['item_code'])) {
$receiving->item_code = $data['item_code'];
// item_code 변경 시 item_id도 업데이트
if (! isset($data['item_id'])) {
$receiving->item_id = $this->findItemIdByCode($tenantId, $data['item_code']);
}
}
if (isset($data['item_id'])) {
$receiving->item_id = $data['item_id'];
}
if (isset($data['item_name'])) {
$receiving->item_name = $data['item_name'];
}
if (array_key_exists('specification', $data)) {
$receiving->specification = $data['specification'];
}
if (isset($data['supplier'])) {
$receiving->supplier = $data['supplier'];
}
if (isset($data['order_qty'])) {
$receiving->order_qty = $data['order_qty'];
}
if (isset($data['order_unit'])) {
$receiving->order_unit = $data['order_unit'];
}
if (array_key_exists('due_date', $data)) {
$receiving->due_date = $data['due_date'];
}
if (array_key_exists('remark', $data)) {
$receiving->remark = $data['remark'];
}
// 상태 변경 감지
$oldStatus = $receiving->status;
$newStatus = $data['status'] ?? $oldStatus;
$wasCompleted = $oldStatus === 'completed';
// 입고완료(completed) 상태로 신규 전환
$isCompletingReceiving = $newStatus === 'completed' && ! $wasCompleted;
if ($isCompletingReceiving) {
// 입고수량 설정 (없으면 발주수량 사용)
$receiving->receiving_qty = $data['receiving_qty'] ?? $receiving->order_qty;
$receiving->receiving_date = $data['receiving_date'] ?? now()->toDateString();
$receiving->lot_no = $data['lot_no'] ?? $this->generateLotNo();
$receiving->status = 'completed';
} else {
// 일반 필드 업데이트
if (isset($data['receiving_qty'])) {
$receiving->receiving_qty = $data['receiving_qty'];
}
if (isset($data['receiving_date'])) {
$receiving->receiving_date = $data['receiving_date'];
}
if (isset($data['lot_no'])) {
$receiving->lot_no = $data['lot_no'];
}
if (isset($data['status'])) {
$receiving->status = $data['status'];
}
}
// options 필드 업데이트 (제조사, 수입검사 등 확장 필드)
$receiving->options = $this->mergeOptions($receiving->options, $data);
$receiving->updated_by = $userId;
$receiving->save();
// 재고 연동
if ($receiving->item_id) {
$stockService = app(StockService::class);
if ($isCompletingReceiving) {
// 대기 → 완료: 전량 재고 증가
$stockService->increaseFromReceiving($receiving);
} elseif ($wasCompleted) {
// 기존 완료 상태에서 수정: 차이만큼 조정
// 완료→완료(수량변경): newQty = 변경된 수량
// 완료→대기: newQty = 0 (전량 차감)
$newQty = $newStatus === 'completed'
? (float) $receiving->receiving_qty
: 0;
$stockService->adjustFromReceiving($receiving, $newQty);
}
}
return $receiving->fresh();
});
}
/**
* 입고 삭제
*/
public function destroy(int $id): bool
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($id, $tenantId, $userId) {
$receiving = Receiving::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
if (! $receiving->canDelete()) {
throw new \Exception(__('error.receiving.cannot_delete'));
}
$receiving->deleted_by = $userId;
$receiving->save();
$receiving->delete();
return true;
});
}
/**
* 입고처리 (상태 변경 + 입고 정보 입력 + 재고 연동)
*/
public function process(int $id, array $data): Receiving
{
$tenantId = $this->tenantId();
$userId = $this->apiUserId();
return DB::transaction(function () use ($id, $data, $tenantId, $userId) {
$receiving = Receiving::query()
->where('tenant_id', $tenantId)
->findOrFail($id);
if (! $receiving->canProcess()) {
throw new \Exception(__('error.receiving.cannot_process'));
}
// LOT번호 생성 (없으면 자동 생성)
$lotNo = $data['lot_no'] ?? $this->generateLotNo();
$receiving->receiving_qty = $data['receiving_qty'];
$receiving->receiving_date = $data['receiving_date'] ?? now()->toDateString();
$receiving->lot_no = $lotNo;
$receiving->supplier_lot = $data['supplier_lot'] ?? null;
$receiving->receiving_location = $data['receiving_location'] ?? null;
$receiving->receiving_manager = $data['receiving_manager'] ?? null;
$receiving->status = 'completed';
$receiving->remark = $data['remark'] ?? $receiving->remark;
$receiving->updated_by = $userId;
$receiving->save();
// 🆕 재고 연동: Stock + StockLot 생성/갱신
if ($receiving->item_id) {
app(StockService::class)->increaseFromReceiving($receiving);
}
return $receiving->fresh();
});
}
/**
* 입고번호 자동 생성
*/
private function generateReceivingNumber(int $tenantId): string
{
$prefix = 'RV'.date('Ymd');
$lastReceiving = Receiving::query()
->where('tenant_id', $tenantId)
->where('receiving_number', 'like', $prefix.'%')
->orderBy('receiving_number', 'desc')
->first();
if ($lastReceiving) {
$lastSeq = (int) substr($lastReceiving->receiving_number, -4);
$newSeq = $lastSeq + 1;
} else {
$newSeq = 1;
}
return $prefix.str_pad($newSeq, 4, '0', STR_PAD_LEFT);
}
/**
* LOT번호 자동 생성
*/
private function generateLotNo(): string
{
$now = now();
$year = $now->format('y');
$month = $now->format('m');
$day = $now->format('d');
$seq = str_pad(rand(1, 99), 2, '0', STR_PAD_LEFT);
return "{$year}{$month}{$day}-{$seq}";
}
/**
* 품목코드로 품목 ID 조회
*/
private function findItemIdByCode(int $tenantId, string $itemCode): ?int
{
$item = DB::table('items')
->where('tenant_id', $tenantId)
->where('code', $itemCode)
->whereNull('deleted_at')
->first(['id']);
return $item?->id;
}
/**
* options 필드 빌드 (등록 시)
*/
private function buildOptions(array $data): ?array
{
$options = [];
// 제조사
if (isset($data['manufacturer'])) {
$options[Receiving::OPTION_MANUFACTURER] = $data['manufacturer'];
}
// 거래처 자재번호
if (isset($data['material_no'])) {
$options[Receiving::OPTION_MATERIAL_NO] = $data['material_no'];
}
// 수입검사 상태 (적/부적/-)
if (isset($data['inspection_status'])) {
$options[Receiving::OPTION_INSPECTION_STATUS] = $data['inspection_status'];
}
// 검사일
if (isset($data['inspection_date'])) {
$options[Receiving::OPTION_INSPECTION_DATE] = $data['inspection_date'];
}
// 검사결과 (합격/불합격)
if (isset($data['inspection_result'])) {
$options[Receiving::OPTION_INSPECTION_RESULT] = $data['inspection_result'];
}
// 추가 확장 필드가 있으면 여기에 계속 추가 가능
return ! empty($options) ? $options : null;
}
/**
* options 필드 병합 (수정 시)
*/
private function mergeOptions(?array $existing, array $data): ?array
{
$options = $existing ?? [];
// 제조사
if (array_key_exists('manufacturer', $data)) {
if ($data['manufacturer'] === null || $data['manufacturer'] === '') {
unset($options[Receiving::OPTION_MANUFACTURER]);
} else {
$options[Receiving::OPTION_MANUFACTURER] = $data['manufacturer'];
}
}
// 거래처 자재번호
if (array_key_exists('material_no', $data)) {
if ($data['material_no'] === null || $data['material_no'] === '') {
unset($options[Receiving::OPTION_MATERIAL_NO]);
} else {
$options[Receiving::OPTION_MATERIAL_NO] = $data['material_no'];
}
}
// 수입검사 상태
if (array_key_exists('inspection_status', $data)) {
if ($data['inspection_status'] === null || $data['inspection_status'] === '') {
unset($options[Receiving::OPTION_INSPECTION_STATUS]);
} else {
$options[Receiving::OPTION_INSPECTION_STATUS] = $data['inspection_status'];
}
}
// 검사일
if (array_key_exists('inspection_date', $data)) {
if ($data['inspection_date'] === null || $data['inspection_date'] === '') {
unset($options[Receiving::OPTION_INSPECTION_DATE]);
} else {
$options[Receiving::OPTION_INSPECTION_DATE] = $data['inspection_date'];
}
}
// 검사결과
if (array_key_exists('inspection_result', $data)) {
if ($data['inspection_result'] === null || $data['inspection_result'] === '') {
unset($options[Receiving::OPTION_INSPECTION_RESULT]);
} else {
$options[Receiving::OPTION_INSPECTION_RESULT] = $data['inspection_result'];
}
}
return ! empty($options) ? $options : null;
}
}