Merge branch 'dev' into demo

[STYLE] 移除冗餘的簡報生成腳本，改由全域技能處理
2026-03-13 16:23:37 +08:00 · 2026-03-13 16:23:02 +08:00 · 2026-03-13 16:19:57 +08:00 · 2026-03-13 16:19:56 +08:00 · 2026-03-13 16:19:00 +08:00 · 2026-03-13 16:18:13 +08:00
20 changed files with 7687 additions and 6751 deletions
--- a/.agents/skills/ui-consistency/SKILL.md
+++ b/.agents/skills/ui-consistency/SKILL.md
@@ -781,7 +781,38 @@ import { SearchableSelect } from "@/Components/ui/searchable-select";
 - **Select / SearchableSelect**: 必須確保 Trigger 按鈕高度為 `h-9`
 - **禁止使用**: 除非有特殊設計需求，否則避免使用 `h-10` (40px) 或其他非標準高度。

-## 11.6 日期顯示規範 (Date Display)
+## 11.6 數字輸入框規範 (Numeric Inputs)
+
+當需求為輸入**整數**數量（例如：實際產出數量、標準產出量）時，**嚴禁自行開發組合 `Plus` (+) 與 `Minus` (-) 按鈕的複合元件**。
+
+**必須使用原生 HTML5 數字輸入與屬性**：
+1.  使用 `<Input type="number" />` 確保預設渲染瀏覽器原生的上下調整小箭頭 (Spinner)。
+2.  針對整數需求，固定加上 `step="1"` 屬性。
+3.  視需求加上 `min` 與 `max` 控制上下限。
+
+這樣既能保持與現有「新增配方」等模組的「標準產出量」欄位行為高度一致，亦能維持畫面的極簡風格。
+
+```tsx
+// ✅ 正確：依賴原生行為
+<Input
+    type="number"
+    step="1"
+    min="0"
+    max={outputQuantity}
+    value={actualOutputQuantity}
+    onChange={(e) => setActualOutputQuantity(e.target.value)}
+    className="h-9 w-24 text-center"
+/>
+
+// ❌ 錯誤：過度設計、浪費空間與破壞一致性
+<div className="flex">
+    <Button><Minus /></Button>
+    <Input type="number" />
+    <Button><Plus /></Button>
+</div>
+```
+
+## 11.7 日期顯示規範 (Date Display)

 前端顯示日期時**禁止直接顯示原始 ISO 字串**（如 `2024-03-06T08:30:00.000000Z`），必須使用 `resources/js/lib/date.ts` 提供的工具函式。

--- a/.agents/workflows/now-push.md
+++ b/.agents/workflows/now-push.md
@@ -19,9 +19,17 @@ description: 將目前的變更提交並推送至指定的遠端分支 (遵守
 3. **目標分支安全檢查**
   - 嚴格遵守 **SKILL.md** 中的「分支架構」、「發布時段」與「強制分支明確指定」規則。
   - 若未指明目標分支，主動詢問使用者，不可私自預設為 `main`。
+   - **【最嚴格限制】**：`main` 分支的程式碼**只能**, **必須**從 `demo` 分支合併而來。絕對禁止將 `dev` (或 `feature/*`) 直接合併進 `main`。

-4. **執行推送 (Push)**
-   - 通過安全檢查後，執行：`git push origin [目前分支]:[目標分支]`。
+4. **執行推送 (Push) 與嚴格合併鏈路**
+   - **若目標為 `dev`**：直接 `git push origin [目前分支]:dev` 或 commit 後 merge 到 dev。
+   - **若目標為 `demo`**：必須先確保變更已在 `dev` 且無衝突，然後 `git checkout demo && git merge dev && git push origin demo`。
+   - **若目標為 `main`**：
+     必須確保變更已經依照順序通過前置環境，嚴格執行以下流程（缺一不可）：
+     1. `git checkout dev && git merge [目前分支] && git push origin dev`
+     2. `git checkout demo && git merge dev && git push origin demo`
+     3. `git checkout main && git merge demo && git push origin main`
+     *(就算遭遇衝突，也必須在對應的分支上解衝突，絕對不可略過 `demo` 直接 `dev -> main`)*

-5. **後續同步**
-   - 依照 **SKILL.md** 的「緊急修復流程(Hotfix)」評估是否需要同步回 `demo` 或 `dev` 分支。
+5. **後續同步 (針對 Hotfix)**
+   - 依照 **SKILL.md** 的「緊急修復流程(Hotfix)」：若有從 main 開出來的 hotfix 分支直接併回 main 的例外情況（需使用者明確指示），**必須**同步將 main 分支 merge 回 `demo` 與 `dev` 分支，維持全環境版本一致。
--- a/app/Modules/Integration/Actions/SyncOrderAction.php
+++ b/app/Modules/Integration/Actions/SyncOrderAction.php
@@ -133,7 +133,10 @@ class SyncOrderAction
                        $warehouseId,
                        $qty,
                        "POS Order: " . $order->external_order_id,
-                        true
+                        true,
+                        null,
+                        \App\Modules\Integration\Models\SalesOrder::class,
+                        $order->id
                    );
                }

--- a/app/Modules/Integration/Actions/SyncVendingOrderAction.php
+++ b/app/Modules/Integration/Actions/SyncVendingOrderAction.php
@@ -130,7 +130,10 @@ class SyncVendingOrderAction
                        $warehouseId,
                        $qty,
                        "Vending Order: " . $order->external_order_id,
-                        true
+                        true,
+                        null,
+                        \App\Modules\Integration\Models\SalesOrder::class,
+                        $order->id
                    );
                }

--- a/app/Modules/Inventory/Contracts/InventoryServiceInterface.php
+++ b/app/Modules/Inventory/Contracts/InventoryServiceInterface.php
@@ -23,7 +23,7 @@ interface InventoryServiceInterface
     * @param string|null $slot
     * @return void
     */
-    public function decreaseStock(int $productId, int $warehouseId, float $quantity, ?string $reason = null, bool $force = false, ?string $slot = null): void;
+    public function decreaseStock(int $productId, int $warehouseId, float $quantity, ?string $reason = null, bool $force = false, ?string $slot = null, ?string $referenceType = null, $referenceId = null): void;

    /**
     * Get all active warehouses.
--- a/app/Modules/Inventory/Services/AdjustService.php
+++ b/app/Modules/Inventory/Services/AdjustService.php
@@ -49,7 +49,7 @@ class AdjustService
                if (abs($item->diff_qty) < 0.0001) continue;

                $itemsToInsert[] = [
-                    'inventory_adjust_doc_id' => $adjDoc->id,
+                    'adjust_doc_id' => $adjDoc->id,
                    'product_id' => $item->product_id,
                    'batch_number' => $item->batch_number,
                    'qty_before' => $item->system_qty,
@@ -108,7 +108,7 @@ class AdjustService
                $qtyBefore = $inventory ? $inventory->quantity : 0;

                $itemsToInsert[] = [
-                    'inventory_adjust_doc_id' => $doc->id,
+                    'adjust_doc_id' => $doc->id,
                    'product_id' => $data['product_id'],
                    'batch_number' => $data['batch_number'] ?? null,
                    'qty_before' => $qtyBefore,
--- a/app/Modules/Inventory/Services/InventoryService.php
+++ b/app/Modules/Inventory/Services/InventoryService.php
@@ -87,9 +87,9 @@ class InventoryService implements InventoryServiceInterface
        return $stock >= $quantity;
    }

-    public function decreaseStock(int $productId, int $warehouseId, float $quantity, ?string $reason = null, bool $force = false, ?string $slot = null): void
+    public function decreaseStock(int $productId, int $warehouseId, float $quantity, ?string $reason = null, bool $force = false, ?string $slot = null, ?string $referenceType = null, $referenceId = null): void
    {
-        DB::transaction(function () use ($productId, $warehouseId, $quantity, $reason, $force, $slot) {
+        DB::transaction(function () use ($productId, $warehouseId, $quantity, $reason, $force, $slot, $referenceType, $referenceId) {
            $query = Inventory::where('product_id', $productId)
                ->where('warehouse_id', $warehouseId)
                ->where('quantity', '>', 0);
@@ -108,7 +108,7 @@ class InventoryService implements InventoryServiceInterface
                if ($remainingToDecrease <= 0) break;

                $decreaseAmount = min($inventory->quantity, $remainingToDecrease);
-                $this->decreaseInventoryQuantity($inventory->id, $decreaseAmount, $reason);
+                $this->decreaseInventoryQuantity($inventory->id, $decreaseAmount, $reason, $referenceType, $referenceId);
                $remainingToDecrease -= $decreaseAmount;
            }

@@ -139,7 +139,7 @@ class InventoryService implements InventoryServiceInterface
                        ]);
                    }
                    
-                    $this->decreaseInventoryQuantity($inventory->id, $remainingToDecrease, $reason);
+                    $this->decreaseInventoryQuantity($inventory->id, $remainingToDecrease, $reason, $referenceType, $referenceId);
                } else {
                    throw new \Exception("庫存不足，無法扣除所有請求的數量。");
                }
--- a/app/Modules/Inventory/Services/TurnoverService.php
+++ b/app/Modules/Inventory/Services/TurnoverService.php
@@ -69,6 +69,12 @@ class TurnoverService
            ->select('inventories.product_id', DB::raw('ABS(SUM(inventory_transactions.quantity)) as sales_qty_30d'))
            ->join('inventories', 'inventory_transactions.inventory_id', '=', 'inventories.id')
            ->where('inventory_transactions.type', '出庫') // Adjust type as needed based on actual data
+            ->where(function ($q) {
+                $q->whereIn('inventory_transactions.reference_type', [
+                    \App\Modules\Integration\Models\SalesOrder::class,
+                    \App\Modules\Sales\Models\SalesImportBatch::class,
+                ])->orWhereNull('inventory_transactions.reference_type');
+            })
            ->where('inventory_transactions.actual_time', '>=', $thirtyDaysAgo)
            ->groupBy('inventories.product_id');
            
@@ -87,6 +93,12 @@ class TurnoverService
            ->select('inventories.product_id', DB::raw('MAX(actual_time) as last_sale_date'))
            ->join('inventories', 'inventory_transactions.inventory_id', '=', 'inventories.id')
            ->where('inventory_transactions.type', '出庫')
+            ->where(function ($q) {
+                $q->whereIn('inventory_transactions.reference_type', [
+                    \App\Modules\Integration\Models\SalesOrder::class,
+                    \App\Modules\Sales\Models\SalesImportBatch::class,
+                ])->orWhereNull('inventory_transactions.reference_type');
+            })
            ->groupBy('inventories.product_id');

        if ($warehouseId) {
@@ -199,6 +211,12 @@ class TurnoverService
         // Get IDs of products sold in last 90 days
         $soldProductIds = InventoryTransaction::query()
             ->where('type', '出庫')
+             ->where(function ($q) {
+                 $q->whereIn('reference_type', [
+                     \App\Modules\Integration\Models\SalesOrder::class,
+                     \App\Modules\Sales\Models\SalesImportBatch::class,
+                 ])->orWhereNull('reference_type');
+             })
             ->where('actual_time', '>=', $ninetyDaysAgo)
             ->distinct()
             ->pluck('inventory_id') // Wait, transaction links to inventory, inventory links to product.
@@ -214,6 +232,12 @@ class TurnoverService
         $soldProductIdsQuery = DB::table('inventory_transactions')
             ->join('inventories', 'inventory_transactions.inventory_id', '=', 'inventories.id')
             ->where('inventory_transactions.type', '出庫')
+             ->where(function ($q) {
+                 $q->whereIn('inventory_transactions.reference_type', [
+                     \App\Modules\Integration\Models\SalesOrder::class,
+                     \App\Modules\Sales\Models\SalesImportBatch::class,
+                 ])->orWhereNull('inventory_transactions.reference_type');
+             })
             ->where('inventory_transactions.actual_time', '>=', $ninetyDaysAgo)
             ->select('inventories.product_id')
             ->distinct();
@@ -236,6 +260,12 @@ class TurnoverService
              ->join('inventories', 'inventory_transactions.inventory_id', '=', 'inventories.id')
              ->join('products', 'inventories.product_id', '=', 'products.id')
              ->where('inventory_transactions.type', '出庫')
+              ->where(function ($q) {
+                  $q->whereIn('inventory_transactions.reference_type', [
+                      \App\Modules\Integration\Models\SalesOrder::class,
+                      \App\Modules\Sales\Models\SalesImportBatch::class,
+                  ])->orWhereNull('inventory_transactions.reference_type');
+              })
              ->where('inventory_transactions.actual_time', '>=', Carbon::now()->subDays($analysisDays))
              ->when($warehouseId, fn($q) => $q->where('inventories.warehouse_id', $warehouseId))
              ->when($categoryId, fn($q) => $q->where('products.category_id', $categoryId))
--- a/app/Modules/Production/Controllers/ProductionOrderController.php
+++ b/app/Modules/Production/Controllers/ProductionOrderController.php
@@ -134,15 +134,15 @@ class ProductionOrderController extends Controller
    public function store(Request $request)
    {
        $status = $request->input('status', 'draft');
-
+                                
        $rules = [
            'product_id' => 'required',
-            'status' => 'nullable|in:draft,completed',
-            'warehouse_id' => $status === 'completed' ? 'required' : 'nullable',
-            'output_quantity' => $status === 'completed' ? 'required|numeric|min:0.01' : 'nullable|numeric',
+            'status' => 'nullable|in:draft,pending,completed',
+            'warehouse_id' => 'required',
+            'output_quantity' => 'required|numeric|min:0.01',
            'items' => 'nullable|array',
-            'items.*.inventory_id' => $status === 'completed' ? 'required' : 'nullable',
-            'items.*.quantity_used' => $status === 'completed' ? 'required|numeric|min:0.0001' : 'nullable|numeric',
+            'items.*.inventory_id' => 'required',
+            'items.*.quantity_used' => 'required|numeric|min:0.0001',
        ];

        $validated = $request->validate($rules);
@@ -159,7 +159,7 @@ class ProductionOrderController extends Controller
                'production_date' => $request->production_date,
                'expiry_date' => $request->expiry_date,
                'user_id' => auth()->id(),
-                'status' => ProductionOrder::STATUS_DRAFT, // 一律存為草稿
+                'status' => $status ?: ProductionOrder::STATUS_DRAFT,
                'remark' => $request->remark,
            ]);

@@ -414,6 +414,19 @@ class ProductionOrderController extends Controller
            return response()->json(['error' => '不合法的狀態轉移或權限不足'], 403);
        }

+        // 送審前的資料完整性驗證
+        if ($productionOrder->status === ProductionOrder::STATUS_DRAFT && $newStatus === ProductionOrder::STATUS_PENDING) {
+            if (!$productionOrder->output_quantity || $productionOrder->output_quantity <= 0) {
+                return back()->with('error', '送審工單前，必須先編輯填寫「生產數量」');
+            }
+            if (!$productionOrder->warehouse_id) {
+                return back()->with('error', '送審工單前，必須先編輯選擇「預計入庫倉庫」');
+            }
+            if ($productionOrder->items()->count() === 0) {
+                return back()->with('error', '送審工單前，請至少新增一項原物料明細');
+            }
+        }
+
        DB::transaction(function () use ($newStatus, $productionOrder, $request) {
            // 使用鎖定重新獲取單據，防止併發狀態修改
            $productionOrder = ProductionOrder::where('id', $productionOrder->id)->lockForUpdate()->first();
@@ -444,6 +457,8 @@ class ProductionOrderController extends Controller
                $warehouseId = $request->input('warehouse_id'); // 由前端 Modal 傳來
                $batchNumber = $request->input('output_batch_number'); // 由前端 Modal 傳來
                $expiryDate = $request->input('expiry_date'); // 由前端 Modal 傳來
+                $actualOutputQuantity = $request->input('actual_output_quantity'); // 實際產出數量
+                $lossReason = $request->input('loss_reason'); // 耗損原因
                
                if (!$warehouseId) {
                    throw new \Exception('必須選擇入庫倉庫');
@@ -451,8 +466,14 @@ class ProductionOrderController extends Controller
                if (!$batchNumber) {
                    throw new \Exception('必須提供成品批號');
                }
+                if (!$actualOutputQuantity || $actualOutputQuantity <= 0) {
+                    throw new \Exception('實際產出數量必須大於 0');
+                }
+                if ($actualOutputQuantity > $productionOrder->output_quantity) {
+                    throw new \Exception('實際產出數量不可大於預計產量');
+                }

-                // --- 新增：計算原物料投入總成本 ---
+                // --- 計算原物料投入總成本 ---
                $totalCost = 0;
                $items = $productionOrder->items()->with('inventory')->get();
                foreach ($items as $item) {
@@ -461,23 +482,25 @@ class ProductionOrderController extends Controller
                    }
                }
                
-                // 計算單位成本 (若產出數量為 0 則設為 0 避免除以零錯誤)
-                $unitCost = $productionOrder->output_quantity > 0 
-                    ? $totalCost / $productionOrder->output_quantity 
+                // 單位成本以「實際產出數量」為分母，反映真實生產效率
+                $unitCost = $actualOutputQuantity > 0 
+                    ? $totalCost / $actualOutputQuantity 
                    : 0;
-                // --------------------------------

-                // 更新單據資訊：批號、效期與自動記錄生產日期
+                // 更新單據資訊：批號、效期、實際產量與耗損原因
                $productionOrder->output_batch_number = $batchNumber;
                $productionOrder->expiry_date = $expiryDate;
                $productionOrder->production_date = now()->toDateString();
                $productionOrder->warehouse_id = $warehouseId;
+                $productionOrder->actual_output_quantity = $actualOutputQuantity;
+                $productionOrder->loss_reason = $lossReason;

+                // 成品入庫數量改用「實際產出數量」
                $this->inventoryService->createInventoryRecord([
                    'warehouse_id' => $warehouseId,
                    'product_id' => $productionOrder->product_id,
-                    'quantity' => $productionOrder->output_quantity,
-                    'unit_cost' => $unitCost, // 傳入計算後的單位成本
+                    'quantity' => $actualOutputQuantity,
+                    'unit_cost' => $unitCost,
                    'batch_number' => $batchNumber,
                    'box_number' => $productionOrder->output_box_count,
                    'arrival_date' => now()->toDateString(),
--- a/app/Modules/Production/Models/ProductionOrder.php
+++ b/app/Modules/Production/Models/ProductionOrder.php
@@ -24,6 +24,8 @@ class ProductionOrder extends Model
        'product_id',
        'warehouse_id',
        'output_quantity',
+        'actual_output_quantity',
+        'loss_reason',
        'output_batch_number',
        'output_box_count',
        'production_date',
@@ -82,6 +84,7 @@ class ProductionOrder extends Model
        'production_date' => 'date',
        'expiry_date' => 'date',
        'output_quantity' => 'decimal:2',
+        'actual_output_quantity' => 'decimal:2',
    ];

    public function getActivitylogOptions(): LogOptions
@@ -91,6 +94,8 @@ class ProductionOrder extends Model
                'code',
                'status',
                'output_quantity',
+                'actual_output_quantity',
+                'loss_reason',
                'output_batch_number',
                'production_date',
                'remark'
--- a/app/Modules/Sales/Controllers/SalesImportController.php
+++ b/app/Modules/Sales/Controllers/SalesImportController.php
@@ -157,7 +157,9 @@ class SalesImportController extends Controller
                    $deduction['quantity'],
                    $reason,
                    true, // Force deduction
-                    $deduction['slot'] // Location/Slot
+                    $deduction['slot'], // Location/Slot
+                    \App\Modules\Sales\Models\SalesImportBatch::class,
+                    $import->id
                );
            }

--- a/database/migrations/tenant/2026_03_10_140000_add_actual_output_to_production_orders.php
+++ b/database/migrations/tenant/2026_03_10_140000_add_actual_output_to_production_orders.php
@@ -0,0 +1,37 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * 為生產工單新增「實際產出數量」與「耗損原因」欄位。
+     * 實際產出數量用於記錄完工時的真實產量（可能因耗損低於預計產量）。
+     */
+    public function up(): void
+    {
+        Schema::table('production_orders', function (Blueprint $table) {
+            $table->decimal('actual_output_quantity', 10, 2)
+                ->nullable()
+                ->after('output_quantity')
+                ->comment('實際產出數量（預設等於 output_quantity，可於完工時調降）');
+            
+            $table->string('loss_reason', 255)
+                ->nullable()
+                ->after('actual_output_quantity')
+                ->comment('耗損原因說明');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('production_orders', function (Blueprint $table) {
+            $table->dropColumn(['actual_output_quantity', 'loss_reason']);
+        });
+    }
+};
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -54,7 +54,8 @@
    "react-markdown": "^10.1.0",
    "recharts": "^3.7.0",
    "remark-gfm": "^4.0.1",
+    "sharp": "^0.34.5",
    "sonner": "^2.0.7",
    "tailwind-merge": "^3.4.0"
  }
-}
+}
--- a/resources/js/Components/ProductionOrder/WarehouseSelectionModal.tsx
+++ b/resources/js/Components/ProductionOrder/WarehouseSelectionModal.tsx
@@ -1,5 +1,6 @@
 /**
 * 生產工單完工入庫 - 選擇倉庫彈窗
+ * 含產出確認與耗損記錄功能
 */

 import React from 'react';
@@ -8,7 +9,8 @@ import { Button } from "@/Components/ui/button";
 import { SearchableSelect } from "@/Components/ui/searchable-select";
 import { Input } from "@/Components/ui/input";
 import { Label } from "@/Components/ui/label";
-import { Warehouse as WarehouseIcon, Calendar as CalendarIcon, Tag, X, CheckCircle2 } from "lucide-react";
+import { Warehouse as WarehouseIcon, AlertTriangle, Tag, CalendarIcon, CheckCircle2, X } from "lucide-react";
+import { formatQuantity } from "@/lib/utils";

 interface Warehouse {
    id: number;
@@ -22,12 +24,18 @@ interface WarehouseSelectionModalProps {
        warehouseId: number;
        batchNumber: string;
        expiryDate: string;
+        actualOutputQuantity: number;
+        lossReason: string;
    }) => void;
    warehouses: Warehouse[];
    processing?: boolean;
-    // 新增商品資訊以利產生批號
+    // 商品資訊用於產生批號
    productCode?: string;
    productId?: number;
+    // 預計產量（用於耗損計算）
+    outputQuantity: number;
+    // 成品單位名稱
+    unitName?: string;
 }

 export default function WarehouseSelectionModal({
@@ -38,10 +46,22 @@ export default function WarehouseSelectionModal({
    processing = false,
    productCode,
    productId,
+    outputQuantity,
+    unitName = '',
 }: WarehouseSelectionModalProps) {
    const [selectedId, setSelectedId] = React.useState<number | null>(null);
    const [batchNumber, setBatchNumber] = React.useState<string>("");
    const [expiryDate, setExpiryDate] = React.useState<string>("");
+    const [actualOutputQuantity, setActualOutputQuantity] = React.useState<string>("");
+    const [lossReason, setLossReason] = React.useState<string>("");
+
+    // 當開啟時，初始化實際產出數量為預計產量
+    React.useEffect(() => {
+        if (isOpen) {
+            setActualOutputQuantity(String(outputQuantity));
+            setLossReason("");
+        }
+    }, [isOpen, outputQuantity]);

    // 當開啟時，嘗試產生成品批號 (若有資訊)
    React.useEffect(() => {
@@ -62,26 +82,37 @@ export default function WarehouseSelectionModal({
        }
    }, [isOpen, productCode, productId]);

+    // 計算耗損數量
+    const actualQty = parseFloat(actualOutputQuantity) || 0;
+    const lossQuantity = outputQuantity - actualQty;
+    const hasLoss = lossQuantity > 0;
+
    const handleConfirm = () => {
-        if (selectedId && batchNumber) {
+        if (selectedId && batchNumber && actualQty > 0) {
            onConfirm({
                warehouseId: selectedId,
                batchNumber,
-                expiryDate
+                expiryDate,
+                actualOutputQuantity: actualQty,
+                lossReason: hasLoss ? lossReason : '',
            });
        }
    };

+    // 驗證：實際產出不可大於預計產量，也不可小於等於 0
+    const isActualQtyValid = actualQty > 0 && actualQty <= outputQuantity;
+
    return (
        <Dialog open={isOpen} onOpenChange={(open) => !open && onClose()}>
-            <DialogContent className="sm:max-w-[425px]">
+            <DialogContent className="sm:max-w-[480px]">
                <DialogHeader>
                    <DialogTitle className="flex items-center gap-2 text-primary-main">
                        <WarehouseIcon className="h-5 w-5" />
-                        選擇完工入庫倉庫
+                        完工入庫確認
                    </DialogTitle>
                </DialogHeader>
                <div className="py-6 space-y-6">
+                    {/* 倉庫選擇 */}
                    <div className="space-y-1">
                        <Label className="text-xs font-medium text-grey-2 flex items-center gap-1">
                            <WarehouseIcon className="h-3 w-3" />
@@ -96,6 +127,7 @@ export default function WarehouseSelectionModal({
                        />
                    </div>

+                    {/* 成品批號 */}
                    <div className="space-y-1">
                        <Label className="text-xs font-medium text-grey-2 flex items-center gap-1">
                            <Tag className="h-3 w-3" />
@@ -109,6 +141,7 @@ export default function WarehouseSelectionModal({
                        />
                    </div>

+                    {/* 成品效期 */}
                    <div className="space-y-1">
                        <Label className="text-xs font-medium text-grey-2 flex items-center gap-1">
                            <CalendarIcon className="h-3 w-3" />
@@ -121,6 +154,64 @@ export default function WarehouseSelectionModal({
                            className="h-9"
                        />
                    </div>
+
+                    {/* 分隔線 - 產出確認區 */}
+                    <div className="border-t border-grey-4 pt-4">
+                        <p className="text-xs font-bold text-grey-2 uppercase tracking-wider mb-4">產出確認</p>
+
+                        {/* 預計產量（唯讀） */}
+                        <div className="flex items-center justify-between mb-3 px-3 py-2 bg-grey-5 rounded-lg border border-grey-4">
+                            <span className="text-sm text-grey-2">預計產量</span>
+                            <span className="font-bold text-grey-0">
+                                {formatQuantity(outputQuantity)} {unitName}
+                            </span>
+                        </div>
+
+                        {/* 實際產出數量 */}
+                        <div className="space-y-1 mb-3">
+                            <Label className="text-xs font-medium text-grey-2">
+                                實際產出數量 *
+                            </Label>
+                            <div className="flex items-center gap-2">
+                                <Input
+                                    type="number"
+                                    step="1"
+                                    min="0"
+                                    max={outputQuantity}
+                                    value={actualOutputQuantity}
+                                    onChange={(e) => setActualOutputQuantity(e.target.value)}
+                                    className={`h-9 font-bold ${!isActualQtyValid && actualOutputQuantity !== '' ? 'border-red-400 focus:ring-red-400' : ''}`}
+                                />
+                                {unitName && <span className="text-sm text-grey-2 whitespace-nowrap">{unitName}</span>}
+                            </div>
+                            {actualQty > outputQuantity && (
+                                <p className="text-xs text-red-500 mt-1">實際產出不可超過預計產量</p>
+                            )}
+                        </div>
+
+                        {/* 耗損顯示 */}
+                        {hasLoss && (
+                            <div className="bg-orange-50 border border-orange-200 rounded-lg p-3 space-y-2 animate-in fade-in duration-300">
+                                <div className="flex items-center gap-2">
+                                    <AlertTriangle className="h-4 w-4 text-orange-500" />
+                                    <span className="text-sm font-bold text-orange-700">
+                                        耗損數量：{formatQuantity(lossQuantity)} {unitName}
+                                    </span>
+                                </div>
+                                <div className="space-y-1">
+                                    <Label className="text-xs font-medium text-orange-600">
+                                        耗損原因 (選填)
+                                    </Label>
+                                    <Input
+                                        value={lossReason}
+                                        onChange={(e) => setLossReason(e.target.value)}
+                                        placeholder="例如：製作過程損耗、品質不合格..."
+                                        className="h-9 border-orange-200 focus:ring-orange-400"
+                                    />
+                                </div>
+                            </div>
+                        )}
+                    </div>
                </div>
                <DialogFooter>
                    <Button
@@ -134,7 +225,7 @@ export default function WarehouseSelectionModal({
                    </Button>
                    <Button
                        onClick={handleConfirm}
-                        disabled={!selectedId || !batchNumber || processing}
+                        disabled={!selectedId || !batchNumber || !isActualQtyValid || processing}
                        className="gap-2 button-filled-primary"
                    >
                        <CheckCircle2 className="h-4 w-4" />
--- a/resources/js/Components/ui/searchable-select.tsx
+++ b/resources/js/Components/ui/searchable-select.tsx
@@ -38,6 +38,8 @@ interface SearchableSelectProps {
    showSearch?: boolean;
    /** 是否可清除選取 */
    isClearable?: boolean;
+    /** 是否為無效狀態（顯示紅色邊框） */
+    "aria-invalid"?: boolean;
 }

 export function SearchableSelect({
@@ -52,6 +54,7 @@ export function SearchableSelect({
    searchThreshold = 10,
    showSearch,
    isClearable = false,
+    "aria-invalid": ariaInvalid,
 }: SearchableSelectProps) {
    const [open, setOpen] = React.useState(false);

@@ -79,12 +82,15 @@ export function SearchableSelect({
                        !selectedOption && "text-grey-3",
                        // Focus state - primary border with ring
                        "focus-visible:border-primary-main focus-visible:ring-primary-main/20 focus-visible:ring-[3px]",
+                        // Error state
+                        ariaInvalid && "border-destructive ring-destructive/20",
                        // Disabled state
                        "disabled:border-grey-4 disabled:bg-background-light-grey disabled:text-grey-2 disabled:cursor-not-allowed disabled:opacity-50",
                        // Height
                        "h-9",
                        className
                    )}
+                    aria-invalid={ariaInvalid}
                >
                    <span className="truncate">
                        {selectedOption ? selectedOption.label : placeholder}
--- a/resources/js/Pages/Production/Create.tsx
+++ b/resources/js/Pages/Production/Create.tsx
@@ -96,11 +96,11 @@ export default function Create({ products, warehouses }: Props) {
    const [recipes, setRecipes] = useState<any[]>([]);
    const [selectedRecipeId, setSelectedRecipeId] = useState<string>("");

-    const { data, setData, processing, errors } = useForm({
+    // 提交表單
+    const { data, setData, processing, errors, setError, clearErrors } = useForm({
        product_id: "",
        warehouse_id: "",
        output_quantity: "",
-        // 移除成品批號、生產日期、有效日期，這些欄位改在完工時處理或自動記錄
        remark: "",
        items: [] as { inventory_id: number; quantity_used: number; unit_id: number | null }[],
    });
@@ -108,7 +108,6 @@ export default function Create({ products, warehouses }: Props) {
    // 獲取特定商品在各倉庫的庫存分佈
    const fetchProductInventories = async (productId: string) => {
        if (!productId) return;
-        // 如果已經在載入中，則跳過，但如果已經有資料，還是可以考慮重新抓取以確保最新，這裡保持現狀或增加強制更新參數
        if (loadingProducts[productId]) return;

        setLoadingProducts(prev => ({ ...prev, [productId]: true }));
@@ -159,7 +158,6 @@ export default function Create({ products, warehouses }: Props) {
            item.unit_id = "";
            item.ui_input_quantity = "";
            item.ui_selected_unit = "base";
-            // 清除 cache 資訊
            delete item.ui_product_name;
            delete item.ui_batch_number;
            delete item.ui_available_qty;
@@ -180,21 +178,13 @@ export default function Create({ products, warehouses }: Props) {
            }
        }

-        // 2. 當選擇來源倉庫變更時 -> 重置批號與相關資訊 (保留數量)
        if (field === 'ui_warehouse_id') {
            item.inventory_id = "";
-            // 不重置數量
-            // item.quantity_used = "";
-            // item.ui_input_quantity = "";
-            // item.ui_selected_unit = "base";
-
-            // 清除某些 cache
            delete item.ui_batch_number;
            delete item.ui_available_qty;
            delete item.ui_expiry_date;
        }

-        // 3. 當選擇批號 (Inventory ID) 變更時 -> 載入該批號資訊
        if (field === 'inventory_id' && value) {
            const currentOptions = productInventoryMap[item.ui_product_id] || [];
            const inv = currentOptions.find(i => String(i.id) === value);
@@ -203,45 +193,31 @@ export default function Create({ products, warehouses }: Props) {
                item.ui_batch_number = inv.batch_number;
                item.ui_available_qty = inv.quantity;
                item.ui_expiry_date = inv.expiry_date || '';
-
-                // 單位與轉換率
                item.ui_base_unit_name = inv.unit_name || '';
                item.ui_base_unit_id = inv.base_unit_id;
                item.ui_large_unit_id = inv.large_unit_id;
                item.ui_purchase_unit_id = inv.purchase_unit_id;
                item.ui_conversion_rate = inv.conversion_rate || 1;
                item.ui_unit_cost = inv.unit_cost || 0;
-
-                // 預設單位
                item.ui_selected_unit = 'base';
                item.unit_id = String(inv.base_unit_id || '');
-
-                // 不重置數量，但如果原本沒數量可以從庫存帶入 (選填，通常配方已帶入則保留配方)
                if (!item.ui_input_quantity) {
                    item.ui_input_quantity = formatQuantity(inv.quantity);
                }
            }
        }

-        // 4. 計算最終數量 (Base Quantity)
        if (field === 'ui_input_quantity' || field === 'ui_selected_unit' || field === 'inventory_id') {
            const inputQty = parseFloat(item.ui_input_quantity || '0');
            const rate = item.ui_conversion_rate || 1;
-
-            if (item.ui_selected_unit === 'large') {
-                item.quantity_used = String(inputQty * rate);
-                item.unit_id = String(item.ui_base_unit_id || '');
-            } else {
-                item.quantity_used = String(inputQty);
-                item.unit_id = String(item.ui_base_unit_id || '');
-            }
+            item.quantity_used = item.ui_selected_unit === 'large' ? String(inputQty * rate) : String(inputQty);
+            item.unit_id = String(item.ui_base_unit_id || '');
        }

        updated[index] = item;
        setBomItems(updated);
    };

-    // 同步 BOM items 到表單 data
    useEffect(() => {
        setData('items', bomItems.map(item => ({
            inventory_id: Number(item.inventory_id),
@@ -250,33 +226,22 @@ export default function Create({ products, warehouses }: Props) {
        })));
    }, [bomItems]);

-    // 應用配方到表單 (獨立函式)
    const applyRecipe = (recipe: any) => {
        if (!recipe || !recipe.items) return;
-
        const yieldQty = parseFloat(recipe.yield_quantity || "0") || 1;
-        // 自動帶入配方標準產量
        setData('output_quantity', formatQuantity(yieldQty));
-
        const newBomItems: BomItem[] = recipe.items.map((item: any) => {
-            const baseQty = parseFloat(item.quantity || "0");
-            const calculatedQty = baseQty; // 保持精度
-
-            // 若有配方商品，預先載入庫存分佈
-            if (item.product_id) {
-                fetchProductInventories(String(item.product_id));
-            }
-
+            if (item.product_id) fetchProductInventories(String(item.product_id));
            return {
                inventory_id: "",
-                quantity_used: String(calculatedQty),
+                quantity_used: String(item.quantity || "0"),
                unit_id: String(item.unit_id),
                ui_warehouse_id: "",
                ui_product_id: String(item.product_id),
                ui_product_name: item.product_name,
                ui_batch_number: "",
                ui_available_qty: 0,
-                ui_input_quantity: formatQuantity(calculatedQty),
+                ui_input_quantity: formatQuantity(item.quantity || "0"),
                ui_selected_unit: 'base',
                ui_base_unit_name: item.unit_name,
                ui_base_unit_id: item.unit_id,
@@ -284,45 +249,30 @@ export default function Create({ products, warehouses }: Props) {
            };
        });
        setBomItems(newBomItems);
-
-        toast.success(`已自動載入配方: ${recipe.name}`, {
-            description: `標準產量: ${formatQuantity(yieldQty)} 份`
-        });
+        toast.success(`已自動載入配方: ${recipe.name}`);
    };

-    // 當手動切換配方時
    useEffect(() => {
        if (!selectedRecipeId) return;
        const targetRecipe = recipes.find(r => String(r.id) === selectedRecipeId);
-        if (targetRecipe) {
-            applyRecipe(targetRecipe);
-        }
+        if (targetRecipe) applyRecipe(targetRecipe);
    }, [selectedRecipeId]);

-    // 自動產生成品批號與載入配方
    useEffect(() => {
        if (!data.product_id) return;
-
-        // 2. 自動載入配方列表
        const fetchRecipes = async () => {
            try {
-                // 改為抓取所有配方
                const res = await fetch(route('api.production.recipes.by-product', data.product_id));
                const recipesData = await res.json();
-
                if (Array.isArray(recipesData) && recipesData.length > 0) {
                    setRecipes(recipesData);
-                    // 預設選取最新的 (第一個)
-                    const latest = recipesData[0];
-                    setSelectedRecipeId(String(latest.id));
+                    setSelectedRecipeId(String(recipesData[0].id));
                } else {
-                    // 若無配方
                    setRecipes([]);
                    setSelectedRecipeId("");
-                    setBomItems([]); // 清空 BOM
+                    setBomItems([]);
                }
            } catch (e) {
-                console.error("Failed to fetch recipes", e);
                setRecipes([]);
                setBomItems([]);
            }
@@ -330,61 +280,74 @@ export default function Create({ products, warehouses }: Props) {
        fetchRecipes();
    }, [data.product_id]);

-    // 當生產數量變動時，如果是從配方載入的，則按比例更新用量
+    // 當有驗證錯誤時，自動聚焦到第一個錯誤欄位
    useEffect(() => {
-        if (bomItems.length > 0 && data.output_quantity) {
-            // 這個部位比較複雜，因為使用者可能已經手動修改過或是選了批號
-            // 目前先保持簡單：如果使用者改了產出量，我們不強行覆蓋已經選好批號的明細，避免困擾
-            // 但如果是剛載入（inventory_id 為空），可以考慮連動？暫時先不處理以維護操作穩定性
+        const errorKeys = Object.keys(errors);
+        if (errorKeys.length > 0) {
+            // 延遲一下確保 DOM 已更新（例如 BOM 明細行渲染）
+            setTimeout(() => {
+                const firstInvalid = document.querySelector('[aria-invalid="true"]');
+                if (firstInvalid instanceof HTMLElement) {
+                    firstInvalid.focus();
+                    firstInvalid.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                }
+            }, 100);
        }
-    }, [data.output_quantity]);
+    }, [errors]);

-    // 提交表單
-    const submit = (status: 'draft' | 'completed') => {
-        // 驗證（簡單前端驗證，完整驗證在後端）
-        if (status === 'completed') {
-            const missingFields = [];
-            if (!data.product_id) missingFields.push('成品商品');
-            if (!data.output_quantity) missingFields.push('生產數量');
-            if (!selectedWarehouse) missingFields.push('預計入庫倉庫');
-            if (bomItems.length === 0) missingFields.push('原物料明細');
+    const submit = (status: 'draft') => {
+        clearErrors();
+        let hasError = false;

-            if (missingFields.length > 0) {
-                toast.error("請填寫必要欄位", {
-                    description: `缺漏：${missingFields.join('、')}`
-                });
-                return;
+        // 草稿建立時也要求必填生產數量與預計入庫倉庫
+        if (!data.product_id) { setError('product_id', '請選擇成品商品'); hasError = true; }
+        if (!data.output_quantity) { setError('output_quantity', '請輸入生產數量'); hasError = true; }
+        if (!selectedWarehouse) { setError('warehouse_id', '請選擇預計入庫倉庫'); hasError = true; }
+        if (bomItems.length === 0) { toast.error("請至少新增一項原物料明細"); hasError = true; }
+
+        // 驗證 BOM 明細
+        bomItems.forEach((item, index) => {
+            if (!item.ui_product_id) {
+                setError(`items.${index}.ui_product_id` as any, '請選擇商品');
+                hasError = true;
+            } else {
+                if (!item.inventory_id) {
+                    setError(`items.${index}.inventory_id` as any, '請選擇批號');
+                    hasError = true;
+                }
+                if (!item.quantity_used || parseFloat(item.quantity_used) <= 0) {
+                    setError(`items.${index}.quantity_used` as any, '請輸入數量');
+                    hasError = true;
+                }
            }
+        });
+
+        if (hasError) {
+            toast.error("建立失敗，請檢查標單內紅框欄位");
+            return;
        }

-        // 轉換 BOM items 格式
-        const formattedItems = bomItems
-            .filter(item => status === 'draft' || (item.inventory_id && item.quantity_used))
-            .map(item => ({
-                inventory_id: item.inventory_id ? parseInt(item.inventory_id) : null,
-                quantity_used: item.quantity_used ? parseFloat(item.quantity_used) : 0,
-                unit_id: item.unit_id ? parseInt(item.unit_id) : null,
-            }));
+        const formattedItems = bomItems.map(item => ({
+            inventory_id: parseInt(item.inventory_id),
+            quantity_used: parseFloat(item.quantity_used),
+            unit_id: item.unit_id ? parseInt(item.unit_id) : null,
+        }));

-        // 使用 router.post 提交完整資料
        router.post(route('production-orders.store'), {
            ...data,
            warehouse_id: selectedWarehouse ? parseInt(selectedWarehouse) : null,
            items: formattedItems,
            status: status,
        }, {
-            onError: (errors) => {
-                const errorCount = Object.keys(errors).length;
-                toast.error("建立失敗，請檢查表單", {
-                    description: `共有 ${errorCount} 個欄位有誤，請修正後再試`
-                });
+            onError: () => {
+                toast.error("建立失敗，請檢查表單");
            }
        });
    };

    const handleSubmit = (e: React.FormEvent) => {
        e.preventDefault();
-        submit('completed');
+        submit('draft');
    };

    const getBomItemUnitCost = (item: BomItem) => {
@@ -423,7 +386,7 @@ export default function Create({ products, warehouses }: Props) {

                    <div className="flex items-center justify-between">
                        <div>
-                            <h1 className="text-2xl font-bold text-grey-0 flex items-center gap-2">
+                            <h1 className="text-2xl font-bold text-gray-900 flex items-center gap-2">
                                <Factory className="h-6 w-6 text-primary-main" />
                                建立生產工單
                            </h1>
@@ -431,14 +394,18 @@ export default function Create({ products, warehouses }: Props) {
                                建立新的生產排程，選擇原物料並記錄產出
                            </p>
                        </div>
-                        <Button
-                            onClick={() => submit('draft')}
-                            disabled={processing}
-                            className="gap-2 button-filled-primary"
-                        >
-                            <Save className="h-4 w-4" />
-                            儲存工單 (草稿)
-                        </Button>
+                        <div className="flex items-center gap-3">
+                            <Button
+                                type="button"
+                                variant="default"
+                                onClick={() => submit('draft')}
+                                disabled={processing}
+                                className="button-filled-primary gap-2"
+                            >
+                                <Save className="h-4 w-4" />
+                                儲存工單 (草稿)
+                            </Button>
+                        </div>
                    </div>
                </div>

@@ -458,6 +425,7 @@ export default function Create({ products, warehouses }: Props) {
                                    }))}
                                    placeholder="選擇成品"
                                    className="w-full h-9"
+                                    aria-invalid={!!errors.product_id}
                                />
                                {errors.product_id && <p className="text-red-500 text-xs mt-1">{errors.product_id}</p>}

@@ -493,6 +461,7 @@ export default function Create({ products, warehouses }: Props) {
                                    onChange={(e) => setData('output_quantity', e.target.value)}
                                    placeholder="例如: 50"
                                    className="h-9 font-mono"
+                                    aria-invalid={!!errors.output_quantity}
                                />
                                {errors.output_quantity && <p className="text-red-500 text-xs mt-1">{errors.output_quantity}</p>}
                            </div>
@@ -508,6 +477,7 @@ export default function Create({ products, warehouses }: Props) {
                                    }))}
                                    placeholder="選擇倉庫"
                                    className="w-full h-9"
+                                    aria-invalid={!!errors.warehouse_id}
                                />
                                {errors.warehouse_id && <p className="text-red-500 text-xs mt-1">{errors.warehouse_id}</p>}
                            </div>
@@ -600,6 +570,7 @@ export default function Create({ products, warehouses }: Props) {
                                                            options={productOptions}
                                                            placeholder="選擇商品"
                                                            className="w-full"
+                                                            aria-invalid={!!errors[`items.${index}.ui_product_id` as any]}
                                                        />
                                                    </TableCell>

@@ -628,6 +599,7 @@ export default function Create({ products, warehouses }: Props) {
                                                            placeholder={item.ui_warehouse_id ? "選擇批號" : "請先選倉庫"}
                                                            className="w-full"
                                                            disabled={!item.ui_warehouse_id}
+                                                            aria-invalid={!!errors[`items.${index}.inventory_id` as any]}
                                                        />
                                                        {item.inventory_id && (() => {
                                                            const selectedInv = currentInventories.find((i: InventoryOption) => String(i.id) === item.inventory_id);
@@ -655,6 +627,7 @@ export default function Create({ products, warehouses }: Props) {
                                                            placeholder="0"
                                                            className="h-9 text-right"
                                                            disabled={!item.inventory_id}
+                                                            aria-invalid={!!errors[`items.${index}.quantity_used` as any]}
                                                        />
                                                    </TableCell>

--- a/resources/js/Pages/Production/Show.tsx
+++ b/resources/js/Pages/Production/Show.tsx
@@ -56,6 +56,8 @@ interface ProductionOrder {
    output_batch_number: string;
    output_box_count: string | null;
    output_quantity: number;
+    actual_output_quantity: number | null;
+    loss_reason: string | null;
    production_date: string;
    expiry_date: string | null;
    status: ProductionOrderStatus;
@@ -88,12 +90,16 @@ export default function ProductionShow({ productionOrder, warehouses, auth }: Pr
        warehouseId?: number;
        batchNumber?: string;
        expiryDate?: string;
+        actualOutputQuantity?: number;
+        lossReason?: string;
    }) => {
        router.patch(route('production-orders.update-status', productionOrder.id), {
            status: newStatus,
            warehouse_id: extraData?.warehouseId,
            output_batch_number: extraData?.batchNumber,
            expiry_date: extraData?.expiryDate,
+            actual_output_quantity: extraData?.actualOutputQuantity,
+            loss_reason: extraData?.lossReason,
        }, {
            onSuccess: () => {
                setIsWarehouseModalOpen(false);
@@ -129,6 +135,8 @@ export default function ProductionShow({ productionOrder, warehouses, auth }: Pr
                processing={processing}
                productCode={productionOrder.product?.code}
                productId={productionOrder.product?.id}
+                outputQuantity={Number(productionOrder.output_quantity)}
+                unitName={productionOrder.product?.base_unit?.name}
            />

            <div className="container mx-auto p-6 max-w-7xl animate-in fade-in duration-500">
@@ -276,7 +284,7 @@ export default function ProductionShow({ productionOrder, warehouses, auth }: Pr
                                    </p>
                                </div>
                                <div className="space-y-1.5">
-                                    <p className="text-xs font-semibold text-grey-2 uppercase tracking-wider">預計/實際產量</p>
+                                    <p className="text-xs font-semibold text-grey-2 uppercase tracking-wider">預計產量</p>
                                    <div className="flex items-baseline gap-1.5">
                                        <p className="font-bold text-grey-0 text-xl">
                                            {formatQuantity(productionOrder.output_quantity)}
@@ -289,6 +297,28 @@ export default function ProductionShow({ productionOrder, warehouses, auth }: Pr
                                        )}
                                    </div>
                                </div>
+                                {/* 實際產量與耗損（僅完成狀態顯示） */}
+                                {productionOrder.status === PRODUCTION_ORDER_STATUS.COMPLETED && productionOrder.actual_output_quantity != null && (
+                                    <div className="space-y-1.5">
+                                        <p className="text-xs font-semibold text-grey-2 uppercase tracking-wider">實際產量</p>
+                                        <div className="flex items-baseline gap-1.5">
+                                            <p className="font-bold text-grey-0 text-xl">
+                                                {formatQuantity(productionOrder.actual_output_quantity)}
+                                            </p>
+                                            {productionOrder.product?.base_unit?.name && (
+                                                <span className="text-grey-2 font-medium">{productionOrder.product.base_unit.name}</span>
+                                            )}
+                                            {Number(productionOrder.output_quantity) > Number(productionOrder.actual_output_quantity) && (
+                                                <span className="ml-2 inline-flex items-center gap-1 px-2 py-0.5 rounded-full bg-orange-100 text-orange-700 text-xs font-bold border border-orange-200">
+                                                    耗損 {formatQuantity(Number(productionOrder.output_quantity) - Number(productionOrder.actual_output_quantity))}
+                                                </span>
+                                            )}
+                                        </div>
+                                        {productionOrder.loss_reason && (
+                                            <p className="text-xs text-orange-600 mt-1">原因：{productionOrder.loss_reason}</p>
+                                        )}
+                                    </div>
+                                )}
                                <div className="space-y-1.5">
                                    <p className="text-xs font-semibold text-grey-2 uppercase tracking-wider">入庫倉庫</p>
                                    <div className="flex items-center gap-2 bg-grey-5 p-2 rounded-lg border border-grey-4">
--- a/resources/markdown/manual/api-integration.md
+++ b/resources/markdown/manual/api-integration.md
@@ -85,7 +85,7 @@ Star ERP 系統提供外部整合 API (Integration API) 供電商前台、POS

 | 參數名稱 | 類型 | 必填 | 說明 |
 | :--- | :--- | :---: | :--- |
-| `warehouse_code` | String | **是** | 要查詢的倉庫代碼 (例如：`STORE-001`) |
+| `warehouse_code` | String | **是** | 要查詢的倉庫代碼 (例如：`STORE-001`，測試可使用預設建立之 `api-test-01`) |

 ### Response

@@ -94,7 +94,7 @@ Star ERP 系統提供外部整合 API (Integration API) 供電商前台、POS
 ```json
 {
    "status": "success",
-    "warehouse_code": "STORE-001",
+    "warehouse_code": "api-test-01",
    "data": [
        {
            "external_pos_id": "POS-ITEM-001",
@@ -136,7 +136,7 @@ Star ERP 系統提供外部整合 API (Integration API) 供電商前台、POS
 | 欄位名稱 | 型態 | 必填 | 說明 |
 | :--- | :--- | :---: | :--- |
 | `external_order_id` | String | **是** | 第三方系統中的唯一訂單編號，不可重複 (Unique) |
-| `warehouse_code` | String | **是** | 指定扣除庫存的倉庫代碼 (例如：`STORE-001`)。若找不到對應倉庫將直接拒絕請求 |
+| `warehouse_code` | String | **是** | 指定扣除庫存的倉庫代碼 (例如：`api-test-01` 測試倉)。若找不到對應倉庫將直接拒絕請求 |
 | `payment_method` | String | 否 | 付款方式，僅接受：`cash`, `credit_card`, `line_pay`, `ecpay`, `transfer`, `other`。預設為 `cash` |
 | `sold_at` | String(Date) | 否 | 交易發生時間，預設為當下時間 (格式: YYYY-MM-DD HH:mm:ss) |
 | `items` | Array | **是** | 訂單明細陣列，至少需包含一筆商品 |
@@ -153,7 +153,7 @@ Star ERP 系統提供外部整合 API (Integration API) 供電商前台、POS
 ```json
 {
    "external_order_id": "ORD-20231026-0001",
-    "warehouse_code": "STORE-001",
+    "warehouse_code": "api-test-01",
    "payment_method": "credit_card",
    "sold_at": "2023-10-26 14:30:00",
    "items": [
--- a/tests/Feature/Integration/PosApiTest.php
+++ b/tests/Feature/Integration/PosApiTest.php
@@ -175,6 +175,9 @@ class PosApiTest extends TestCase
            'Accept' => 'application/json',
        ])->postJson('/api/v1/integration/orders', $payload);

+        $response->assertStatus(201)
+                 ->assertJsonPath('message', 'Order synced and stock deducted successfully');
+
        $response->assertStatus(201)
                 ->assertJsonPath('message', 'Order synced and stock deducted successfully');

@@ -196,6 +199,14 @@ class PosApiTest extends TestCase
            'warehouse_id' => $warehouseId,
            'quantity' => 95,
        ]);
+
+        $order = \App\Modules\Integration\Models\SalesOrder::where('external_order_id', 'ORD-001')->first();
+        $this->assertDatabaseHas('inventory_transactions', [
+            'reference_type' => \App\Modules\Integration\Models\SalesOrder::class,
+            'reference_id' => $order->id,
+            'quantity' => -5,
+            'type' => '出庫',
+        ]);
        
        tenancy()->end();
    }
Author	SHA1	Message	Date
sky121113	dfd0a047f2	Merge branch 'dev' into demo All checks were successful ERP-Deploy-Demo / deploy-demo (push) Successful in 59s Details ERP-Deploy-Production / deploy-production (push) Successful in 1m15s Details	2026-03-13 16:23:37 +08:00
sky121113	e3ceedc579	[STYLE] 移除冗餘的簡報生成腳本，改由全域技能處理	2026-03-13 16:23:02 +08:00
sky121113	f2e5ef121e	Merge branch 'dev' into demo All checks were successful ERP-Deploy-Demo / deploy-demo (push) Successful in 1m9s Details	2026-03-13 16:19:57 +08:00
sky121113	7a1fc02dfc	[REFACTOR] 移除 package.json 中不使用的 pptxgenjs 套件	2026-03-13 16:19:56 +08:00
sky121113	5f34855233	Merge branch 'dev' into demo Some checks failed ERP-Deploy-Demo / deploy-demo (push) Has been cancelled Details	2026-03-13 16:19:00 +08:00
sky121113	bee8ecb55b	[FIX] 修正盤調單明細插入時的欄位名稱錯誤並更新簡報/圖片處理套件	2026-03-13 16:18:13 +08:00
sky121113	0198b7de90	[FIX] 嚴格限制 now-push 工作流的 main 合併鏈路 All checks were successful ERP-Deploy-Demo / deploy-demo (push) Successful in 1m6s Details - 修改 now-push.md 確保 main 只能從 demo 合併 - 明列 dev -> demo -> main 的強制合併順序	2026-03-10 15:41:31 +08:00
sky121113	b57a4feeab	[FIX] 嚴格限制 now-push 工作流的 main 合併鏈路 - 修改 now-push.md 確保 main 只能從 demo 合併 - 明列 dev -> demo -> main 的強制合併順序	2026-03-10 15:39:37 +08:00
sky121113	55a806051d	Merge branch 'dev' into main for hotfix All checks were successful ERP-Deploy-Production / deploy-production (push) Successful in 1m11s Details ERP-Deploy-Demo / deploy-demo (push) Successful in 55s Details	2026-03-10 15:33:27 +08:00
sky121113	6ca0bafd60	[FEAT] 新增生產工單實際產量欄位與 UI 規範 - 新增 database/migrations/tenant 實際產量與耗損原因 - ProductionOrder API 狀態推進與實際產量計算 - 完工入庫新增實際產出數量原生數字輸入框 (step=1) - Create.tsx 補上前端資料驗證與狀態保護 - 建立並更新 UI 數字輸入框設計規範	2026-03-10 15:32:52 +08:00
sky121113	adf13410ba	[DOCS] 更新 API 文件，補充 api-test-01 測試倉說明 All checks were successful ERP-Deploy-Demo / deploy-demo (push) Successful in 55s Details	2026-03-10 11:57:34 +08:00
sky121113	d52a215916	[FEAT] 優化庫存分析邏輯，增加銷售 Reference Type 追蹤並修正 InventoryService 閉包變數問題 All checks were successful ERP-Deploy-Demo / deploy-demo (push) Successful in 1m20s Details	2026-03-10 11:15:55 +08:00
sky121113	2fd5de96b2	[Merge] Merge demo into main All checks were successful ERP-Deploy-Production / deploy-production (push) Successful in 1m11s Details	2026-03-06 11:08:59 +08:00