From bba8f6c0a0201428586672f7272c343e670a9dfd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Tue, 17 Mar 2026 20:42:53 +0900 Subject: [PATCH] =?UTF-8?q?feat:=20[stock]=20=EC=9E=AC=EA=B3=A0=20?= =?UTF-8?q?=EC=A1=B0=EC=A0=95=20API=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - GET /stocks/{id}/adjustments: 조정 이력 조회 - POST /stocks/{id}/adjustments: 조정 등록 (증감 수량 + 사유) - StockTransaction에 adjustment reason 추가 - StoreStockAdjustmentRequest 검증 추가 --- .../Controllers/Api/V1/StockController.php | 29 ++++++++ .../V1/Stock/StoreStockAdjustmentRequest.php | 29 ++++++++ app/Models/Tenants/StockTransaction.php | 3 + app/Services/StockService.php | 71 +++++++++++++++++++ routes/api/v1/inventory.php | 2 + 5 files changed, 134 insertions(+) create mode 100644 app/Http/Requests/V1/Stock/StoreStockAdjustmentRequest.php diff --git a/app/Http/Controllers/Api/V1/StockController.php b/app/Http/Controllers/Api/V1/StockController.php index d2aebc87..c19e6eb8 100644 --- a/app/Http/Controllers/Api/V1/StockController.php +++ b/app/Http/Controllers/Api/V1/StockController.php @@ -4,6 +4,7 @@ use App\Helpers\ApiResponse; use App\Http\Controllers\Controller; +use App\Http\Requests\V1\Stock\StoreStockAdjustmentRequest; use App\Services\StockService; use Illuminate\Http\JsonResponse; use Illuminate\Http\Request; @@ -71,4 +72,32 @@ public function statsByItemType(): JsonResponse return ApiResponse::success($stats, __('message.fetched')); } + + /** + * 재고 조정 이력 조회 + */ + public function adjustments(int $id): JsonResponse + { + try { + $adjustments = $this->service->adjustments($id); + + return ApiResponse::success($adjustments, __('message.fetched')); + } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) { + return ApiResponse::error(__('error.stock.not_found'), 404); + } + } + + /** + * 재고 조정 등록 + */ + public function storeAdjustment(int $id, StoreStockAdjustmentRequest $request): JsonResponse + { + try { + $result = $this->service->createAdjustment($id, $request->validated()); + + return ApiResponse::success($result, __('message.created')); + } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) { + return ApiResponse::error(__('error.stock.not_found'), 404); + } + } } diff --git a/app/Http/Requests/V1/Stock/StoreStockAdjustmentRequest.php b/app/Http/Requests/V1/Stock/StoreStockAdjustmentRequest.php new file mode 100644 index 00000000..85ac254a --- /dev/null +++ b/app/Http/Requests/V1/Stock/StoreStockAdjustmentRequest.php @@ -0,0 +1,29 @@ + ['required', 'numeric', 'not_in:0'], + 'remark' => ['nullable', 'string', 'max:500'], + ]; + } + + public function messages(): array + { + return [ + 'quantity.required' => __('error.stock.adjustment_qty_required'), + 'quantity.not_in' => __('error.stock.adjustment_qty_zero'), + ]; + } +} diff --git a/app/Models/Tenants/StockTransaction.php b/app/Models/Tenants/StockTransaction.php index 4c13c119..ea018c54 100644 --- a/app/Models/Tenants/StockTransaction.php +++ b/app/Models/Tenants/StockTransaction.php @@ -50,6 +50,8 @@ class StockTransaction extends Model public const REASON_PRODUCTION_OUTPUT = 'production_output'; + public const REASON_ADJUSTMENT = 'adjustment'; + public const REASONS = [ self::REASON_RECEIVING => '입고', self::REASON_WORK_ORDER_INPUT => '생산투입', @@ -57,6 +59,7 @@ class StockTransaction extends Model self::REASON_ORDER_CONFIRM => '수주확정', self::REASON_ORDER_CANCEL => '수주취소', self::REASON_PRODUCTION_OUTPUT => '생산입고', + self::REASON_ADJUSTMENT => '재고조정', ]; protected $fillable = [ diff --git a/app/Services/StockService.php b/app/Services/StockService.php index 9cd1475d..65820ed6 100644 --- a/app/Services/StockService.php +++ b/app/Services/StockService.php @@ -191,6 +191,77 @@ public function show(int $id): Item ->findOrFail($id); } + /** + * 재고 조정 이력 조회 + */ + public function adjustments(int $stockId): array + { + $tenantId = $this->tenantId(); + + $stock = Stock::where('tenant_id', $tenantId)->findOrFail($stockId); + + $transactions = StockTransaction::where('tenant_id', $tenantId) + ->where('stock_id', $stock->id) + ->where('reason', StockTransaction::REASON_ADJUSTMENT) + ->with('creator:id,name') + ->orderByDesc('created_at') + ->get(); + + return $transactions->map(fn ($t) => [ + 'id' => $t->id, + 'adjusted_at' => $t->created_at->format('Y-m-d H:i'), + 'quantity' => (float) $t->qty, + 'balance_qty' => (float) $t->balance_qty, + 'remark' => $t->remark, + 'inspector' => $t->creator?->name ?? '-', + ])->toArray(); + } + + /** + * 재고 조정 등록 + */ + public function createAdjustment(int $stockId, array $data): array + { + $tenantId = $this->tenantId(); + $userId = $this->apiUserId(); + + return DB::transaction(function () use ($stockId, $data, $tenantId, $userId) { + $stock = Stock::where('tenant_id', $tenantId)->findOrFail($stockId); + + $qty = (float) $data['quantity']; + + // 재고량 직접 조정 + $stock->stock_qty += $qty; + $stock->available_qty += $qty; + $stock->status = $stock->calculateStatus(); + $stock->updated_by = $userId; + $stock->save(); + + // 거래 유형: 양수 → IN, 음수 → OUT + $type = $qty >= 0 ? StockTransaction::TYPE_IN : StockTransaction::TYPE_OUT; + + // 거래 이력 기록 + $this->recordTransaction( + stock: $stock, + type: $type, + qty: $qty, + reason: StockTransaction::REASON_ADJUSTMENT, + referenceType: 'stock', + referenceId: $stock->id, + remark: $data['remark'] ?? null + ); + + return [ + 'id' => $stock->id, + 'adjusted_at' => now()->format('Y-m-d H:i'), + 'quantity' => $qty, + 'balance_qty' => (float) $stock->stock_qty, + 'remark' => $data['remark'] ?? null, + 'inspector' => \App\Models\Members\User::find($userId)?->name ?? '-', + ]; + }); + } + /** * 품목코드로 재고 조회 (Item 기준) */ diff --git a/routes/api/v1/inventory.php b/routes/api/v1/inventory.php index f148d757..ff0bdc60 100644 --- a/routes/api/v1/inventory.php +++ b/routes/api/v1/inventory.php @@ -108,6 +108,8 @@ Route::get('/stats', [StockController::class, 'stats'])->name('v1.stocks.stats'); Route::get('/stats-by-type', [StockController::class, 'statsByItemType'])->name('v1.stocks.stats-by-type'); Route::get('/{id}', [StockController::class, 'show'])->whereNumber('id')->name('v1.stocks.show'); + Route::get('/{id}/adjustments', [StockController::class, 'adjustments'])->whereNumber('id')->name('v1.stocks.adjustments'); + Route::post('/{id}/adjustments', [StockController::class, 'storeAdjustment'])->whereNumber('id')->name('v1.stocks.adjustments.store'); }); // Shipment API (출하 관리)