feat(inventory): 開放倉庫編號編輯、優化調撥單條碼搜尋與庫存匯入範本雙分頁說明

resources/js/Components/Warehouse/Inventory/InventoryImportDialog.tsx

@@ -0,0 +1,203 @@
+import React from "react";
+import { useForm } from "@inertiajs/react";
+import {
+    Dialog,
+    DialogContent,
+    DialogDescription,
+    DialogFooter,
+    DialogHeader,
+    DialogTitle,
+} from "@/Components/ui/dialog";
+import { Button } from "@/Components/ui/button";
+import { Input } from "@/Components/ui/input";
+import { Label } from "@/Components/ui/label";
+import { Download, FileUp, Loader2, AlertCircle, FileSpreadsheet, Info } from "lucide-react";
+import { toast } from "sonner";
+import { Alert, AlertDescription } from "@/Components/ui/alert";
+import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/Components/ui/accordion";
+
+interface Props {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    warehouseId: string;
+}
+
+export default function InventoryImportDialog({ open, onOpenChange, warehouseId }: Props) {
+    const { data, setData, post, processing, errors, reset, clearErrors } = useForm({
+        file: null as File | null,
+        inboundDate: new Date().toISOString().split('T')[0],
+        notes: "Excel 匯入",
+    });
+
+    const handleSubmit = (e: React.FormEvent) => {
+        e.preventDefault();
+
+        post(route("warehouses.inventory.import", warehouseId), {
+            forceFormData: true,
+            onSuccess: () => {
+                toast.success("庫存匯入完成");
+                onOpenChange(false);
+                reset();
+            },
+            onError: (err) => {
+                console.error("Import error:", err);
+                toast.error("匯入失敗，請檢查檔案格式");
+            }
+        });
+    };
+
+    const handleDownloadTemplate = () => {
+        window.location.href = route("warehouses.inventory.template");
+    };
+
+    return (
+        <Dialog open={open} onOpenChange={(val) => {
+            onOpenChange(val);
+            if (!val) {
+                reset();
+                clearErrors();
+            }
+        }}>
+            <DialogContent className="sm:max-w-[550px]">
+                <DialogHeader>
+                    <DialogTitle>匯入庫存資料</DialogTitle>
+                    <DialogDescription>
+                        請先下載範本，填寫完畢後上傳檔案進行批次入庫。
+                    </DialogDescription>
+                </DialogHeader>
+
+                <form onSubmit={handleSubmit} className="space-y-6">
+                    {/* 步驟 1: 下載範本 */}
+                    <div className="space-y-2 p-4 bg-gray-50 rounded-lg border border-gray-100">
+                        <Label className="font-medium flex items-center gap-2">
+                            <FileSpreadsheet className="w-4 h-4 text-green-600" />
+                            步驟 1：取得匯入範本
+                        </Label>
+                        <div className="text-sm text-gray-500 mb-2">
+                            下載標準範本以確保資料格式正確。請勿修改標題欄位。
+                        </div>
+                        <Button
+                            type="button"
+                            variant="outline"
+                            size="sm"
+                            onClick={handleDownloadTemplate}
+                            className="w-full sm:w-auto button-outlined-primary"
+                        >
+                            <Download className="w-4 h-4 mr-2" />
+                            下載庫存匯入範本 (.xlsx)
+                        </Button>
+                    </div>
+
+                    {/* 步驟 2: 設定資訊 */}
+                    <div className="space-y-2">
+                        <Label className="font-medium flex items-center gap-2">
+                            <Info className="w-4 h-4 text-primary-main" />
+                            步驟 2：設定入庫資訊
+                        </Label>
+
+                        <div className="grid grid-cols-2 gap-4">
+                            <div className="space-y-2">
+                                <Label htmlFor="inboundDate" className="text-sm text-gray-700 flex items-center gap-1.5 align-middle">
+                                    入庫日期 <span className="text-red-500">*</span>
+                                </Label>
+                                <Input
+                                    id="inboundDate"
+                                    type="date"
+                                    value={data.inboundDate}
+                                    onChange={e => setData('inboundDate', e.target.value)}
+                                    required
+                                    className="cursor-pointer"
+                                />
+                            </div>
+                            <div className="space-y-2">
+                                <Label htmlFor="notes" className="text-sm text-gray-700 flex items-center gap-1.5">
+                                    入庫備註
+                                </Label>
+                                <Input
+                                    id="notes"
+                                    placeholder="選填備註"
+                                    value={data.notes}
+                                    onChange={e => setData('notes', e.target.value)}
+                                />
+                            </div>
+                        </div>
+                    </div>
+
+                    {/* 步驟 3: 上傳檔案 */}
+                    <div className="space-y-2">
+                        <Label className="font-medium flex items-center gap-2">
+                            <FileUp className="w-4 h-4 text-blue-600" />
+                            步驟 3：上傳填寫後的檔案
+                        </Label>
+                        <div className="grid w-full max-w-sm items-center gap-1.5">
+                            <Input
+                                id="file"
+                                type="file"
+                                accept=".xlsx,.xls,.csv"
+                                onChange={e => setData('file', e.target.files ? e.target.files[0] : null)}
+                                required
+                                className="cursor-pointer"
+                            />
+                        </div>
+                        {errors.file && (
+                            <Alert variant="destructive" className="mt-2">
+                                <AlertCircle className="h-4 w-4" />
+                                <AlertDescription className="whitespace-pre-wrap">
+                                    {errors.file}
+                                </AlertDescription>
+                            </Alert>
+                        )}
+                    </div>
+
+                    {/* 欄位說明 */}
+                    <Accordion type="single" collapsible className="w-full border rounded-lg px-2">
+                        <AccordionItem value="rules" className="border-b-0">
+                            <AccordionTrigger className="text-sm text-gray-500 hover:no-underline py-3">
+                                <div className="flex items-center gap-2">
+                                    <Info className="h-4 w-4" />
+                                    庫存匯入規則與提示
+                                </div>
+                            </AccordionTrigger>
+                            <AccordionContent>
+                                <div className="text-sm text-gray-600 space-y-2 pb-2 pl-6">
+                                    <ul className="list-disc space-y-1">
+                                        <li><span className="font-medium text-gray-700">商品匹配</span>：優先使用「商品條碼」匹配，其次為「商品代號」。</li>
+                                        <li><span className="font-medium text-gray-700">無批號模式</span>：若 Excel 中的「批號」欄位<span className="underline">保持空白</span>，系統將自動累加至該商品的「通用紀錄」。</li>
+                                        <li><span className="font-medium text-gray-700">效期設定</span>：若商品無效期概念可留空，或輸入格式如：2026/12/31。</li>
+                                        <li><span className="font-medium text-gray-700">入庫單價</span>：未填寫時將預設使用商品的「採購成本價」。</li>
+                                    </ul>
+                                </div>
+                            </AccordionContent>
+                        </AccordionItem>
+                    </Accordion>
+
+                    <DialogFooter>
+                        <Button
+                            type="button"
+                            variant="outline"
+                            onClick={() => onOpenChange(false)}
+                            disabled={processing}
+                            className="button-outlined-primary"
+                        >
+                            取消
+                        </Button>
+                        <Button
+                            type="submit"
+                            disabled={processing || !data.file}
+                            className="button-filled-primary"
+                        >
+                            {processing ? (
+                                <>
+                                    <Loader2 className="mr-2 h-4 w-4 animate-spin" />
+                                    上傳中...
+                                </>
+                            ) : (
+                                "開始匯入"
+                            )}
+                        </Button>
+                    </DialogFooter>
+                </form>
+            </DialogContent>
+        </Dialog>
+    );
+}

resources/js/Components/Warehouse/WarehouseDialog.tsx

@@ -143,14 +143,15 @@ export default function WarehouseDialog({
                   {/* 倉庫編號 */}
                   <div className="space-y-2">
                     <Label htmlFor="code">
-                      倉庫編號
+                      倉庫編號 <span className="text-red-500">*</span>
                     </Label>
                     <Input
                       id="code"
-                      value={warehouse ? formData.code : ""}
-                      disabled={true}
-                      placeholder={warehouse ? "" : "系統自動產生"}
-                      className="bg-gray-100"
+                      value={formData.code}
+                      onChange={(e) => setFormData({ ...formData, code: e.target.value })}
+                      placeholder="請輸入倉庫編號"
+                      required
+                      className="h-9"
                     />
                   </div>
 

resources/js/Pages/Inventory/Transfer/Show.tsx

@@ -84,7 +84,8 @@ export default function Show({ order }: any) {
     const toggleSelectAll = () => {
         const filtered = availableInventory.filter(inv =>
             inv.product_name.toLowerCase().includes(searchQuery.toLowerCase()) ||
-            inv.product_code.toLowerCase().includes(searchQuery.toLowerCase())
+            inv.product_code.toLowerCase().includes(searchQuery.toLowerCase()) ||
+            (inv.product_barcode && inv.product_barcode.toLowerCase().includes(searchQuery.toLowerCase()))
         );
         const filteredKeys = filtered.map(inv => `${inv.product_id}-${inv.batch_number}`);
 
@@ -338,10 +339,10 @@ export default function Show({ order }: any) {
                                 <DialogContent className="max-w-4xl max-h-[85vh] flex flex-col p-6">
                                     <DialogHeader className="flex flex-row items-center justify-between space-y-0 pb-4">
                                         <DialogTitle className="text-xl">選擇來源庫存 ({order.from_warehouse_name})</DialogTitle>
-                                        <div className="relative w-64">
+                                        <div className="relative w-72">
                                             <Search className="absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-grey-3" />
                                             <Input
-                                                placeholder="搜尋品名或代號..."
+                                                placeholder="搜尋品名、代號或條碼..."
                                                 className="pl-9 h-9 border-2 border-grey-3 focus:ring-primary-main"
                                                 value={searchQuery}
                                                 onChange={(e) => setSearchQuery(e.target.value)}
@@ -364,7 +365,8 @@ export default function Show({ order }: any) {
                                                                     checked={availableInventory.length > 0 && (() => {
                                                                         const filtered = availableInventory.filter(inv =>
                                                                             inv.product_name.toLowerCase().includes(searchQuery.toLowerCase()) ||
-                                                                            inv.product_code.toLowerCase().includes(searchQuery.toLowerCase())
+                                                                            inv.product_code.toLowerCase().includes(searchQuery.toLowerCase()) ||
+                                                                            (inv.product_barcode && inv.product_barcode.toLowerCase().includes(searchQuery.toLowerCase()))
                                                                         );
                                                                         const filteredKeys = filtered.map(inv => `${inv.product_id}-${inv.batch_number}`);
                                                                         return filteredKeys.length > 0 && filteredKeys.every(k => selectedInventory.includes(k));
@@ -383,7 +385,8 @@ export default function Show({ order }: any) {
                                                         {(() => {
                                                             const filtered = availableInventory.filter(inv =>
                                                                 inv.product_name.toLowerCase().includes(searchQuery.toLowerCase()) ||
-                                                                inv.product_code.toLowerCase().includes(searchQuery.toLowerCase())
+                                                                inv.product_code.toLowerCase().includes(searchQuery.toLowerCase()) ||
+                                                                (inv.product_barcode && inv.product_barcode.toLowerCase().includes(searchQuery.toLowerCase()))
                                                             );
 
                                                             if (filtered.length === 0) {

resources/js/Pages/Warehouse/Inventory.tsx

@@ -1,5 +1,5 @@
 import { useState, useMemo } from "react";
-import { ArrowLeft, PackagePlus, AlertTriangle, Shield, Boxes } from "lucide-react";
+import { ArrowLeft, PackagePlus, AlertTriangle, Shield, Boxes, FileUp } from "lucide-react";
 import { Button } from "@/Components/ui/button";
 import AuthenticatedLayout from "@/Layouts/AuthenticatedLayout";
 import { Head, Link, router } from "@inertiajs/react";
@@ -20,6 +20,7 @@ import {
     AlertDialogTitle,
 } from "@/Components/ui/alert-dialog";
 import { Can } from "@/Components/Permission/Can";
+import InventoryImportDialog from "@/Components/Warehouse/Inventory/InventoryImportDialog";
 
 // 庫存頁面 Props
 interface Props {
@@ -38,6 +39,7 @@ export default function WarehouseInventoryPage({
     const [searchTerm, setSearchTerm] = useState("");
     const [typeFilter, setTypeFilter] = useState<string>("all");
     const [deleteId, setDeleteId] = useState<string | null>(null);
+    const [importDialogOpen, setImportDialogOpen] = useState(false);
 
     // 篩選庫存列表
     const filteredInventories = useMemo(() => {
@@ -157,6 +159,18 @@ export default function WarehouseInventoryPage({
                         庫存警告：{lowStockItems} 項
                     </Button>
 
+                    {/* 匯入入庫按鈕 */}
+                    <Can permission="inventory.adjust">
+                        <Button
+                            variant="outline"
+                            className="button-outlined-primary"
+                            onClick={() => setImportDialogOpen(true)}
+                        >
+                            <FileUp className="mr-2 h-4 w-4" />
+                            匯入入庫
+                        </Button>
+                    </Can>
+
                     {/* 新增庫存按鈕 */}
                     <Can permission="inventory.adjust">
                         <Link href={route('warehouses.inventory.create', warehouse.id)}>
@@ -210,6 +224,13 @@ export default function WarehouseInventoryPage({
                         </AlertDialogFooter>
                     </AlertDialogContent>
                 </AlertDialog>
+
+                {/* 匯入對話框 */}
+                <InventoryImportDialog
+                    open={importDialogOpen}
+                    onOpenChange={setImportDialogOpen}
+                    warehouseId={warehouse.id}
+                />
             </div>
         </AuthenticatedLayout>
     );