feat: [stock] 재고 조정 API 추가

- GET /stocks/{id}/adjustments: 조정 이력 조회
- POST /stocks/{id}/adjustments: 조정 등록 (증감 수량 + 사유)
- StockTransaction에 adjustment reason 추가
- StoreStockAdjustmentRequest 검증 추가

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);
+        }
+    }
 }

app/Http/Requests/V1/Stock/StoreStockAdjustmentRequest.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Requests\V1\Stock;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreStockAdjustmentRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'quantity' => ['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'),
+        ];
+    }
+}

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 = [

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 기준)
      */

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 (출하 관리)