feat(Inventory): 實作批號溯源完整功能與 UI 呈現，包含文字敘述卡片與更完整的關聯屬性

resources/js/Pages/Inventory/Traceability/Components/TraceabilitySummary.tsx

@@ -0,0 +1,150 @@
+import { Info } from "lucide-react";
+import { TraceabilityNode } from "./TreeView";
+
+interface TraceabilitySummaryProps {
+    data: TraceabilityNode;
+    direction: 'forward' | 'backward';
+}
+
+export function TraceabilitySummary({ data, direction }: TraceabilitySummaryProps) {
+    if (!data) return null;
+
+    // --- Helper to extract unqiue names/codes from children ---
+    const getUniqueLabels = (nodes: TraceabilityNode[], prefixToStrip: string = '') => {
+        const labels = nodes
+            .map(n => n.label.replace(prefixToStrip, '').trim())
+            .filter(Boolean);
+        return Array.from(new Set(labels));
+    };
+
+    // --- Logic for Backward Tracing ---
+    if (direction === 'backward') {
+        const poNodes = data.children?.filter(c => c.type === 'production_order') || [];
+        const poNames = getUniqueLabels(poNodes, '生產工單:');
+
+        let materialNodes: TraceabilityNode[] = [];
+        let grNodes: TraceabilityNode[] = [];
+
+        poNodes.forEach(po => {
+            const materials = po.children?.filter(c => c.type === 'material_batch') || [];
+            materialNodes = [...materialNodes, ...materials];
+
+            materials.forEach(mat => {
+                const grs = mat.children?.filter(c => c.type === 'goods_receipt') || [];
+                grNodes = [...grNodes, ...grs];
+            });
+        });
+
+        const materialNames = getUniqueLabels(materialNodes, '原料批號:');
+        const grNames = getUniqueLabels(grNodes, '進貨單:');
+
+        // Handle case where batch is directly from Goods Receipt (no PO)
+        const directGrNodes = data.children?.filter(c => c.type === 'goods_receipt') || [];
+        if (directGrNodes.length > 0) {
+            grNodes = [...grNodes, ...directGrNodes];
+            const directGrNames = getUniqueLabels(directGrNodes, '進貨單:');
+
+            return (
+                <div className="bg-blue-50/50 border border-blue-100 rounded-xl p-4 mb-6 flex gap-3 text-gray-700 leading-relaxed shadow-sm">
+                    <Info className="w-5 h-5 text-blue-500 shrink-0 mt-0.5" />
+                    <div>
+                        <p>
+                            查詢的批號 <strong className="text-gray-900">{data.batch_number}</strong>
+                            {data.product_name && <span> ({data.product_name})</span>}
+                            主要是由進貨單 {directGrNames.map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)} 採購進貨。
+                        </p>
+                    </div>
+                </div>
+            );
+        }
+
+        return (
+            <div className="bg-blue-50/50 border border-blue-100 rounded-xl p-4 mb-6 flex gap-3 text-gray-700 leading-relaxed shadow-sm">
+                <Info className="w-5 h-5 text-blue-500 shrink-0 mt-0.5" />
+                <div className="space-y-1.5">
+                    <p>
+                        查詢的成品批號 <strong className="text-gray-900">{data.batch_number}</strong>
+                        {data.product_name && <span> ({data.product_name})</span>} 是由
+                        {poNames.length > 0 ? (
+                            <>
+                                生產工單 {poNames.slice(0, 3).map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)}
+                                {poNames.length > 3 && ` 等 ${poNames.length} 張工單`} 產出。
+                            </>
+                        ) : (
+                            '未知的生產工單產出。'
+                        )}
+                    </p>
+                    {materialNodes.length > 0 && (
+                        <p>
+                            這些工單總共使用了 <strong className="text-gray-900">{materialNodes.length}</strong> 批原料
+                            （包含原料批號 {materialNames.slice(0, 3).map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)}
+                            {materialNames.length > 3 && ' 等'}）。
+                        </p>
+                    )}
+                    {grNodes.length > 0 && (
+                        <p>
+                            而這些原料主要來自於進貨單 {grNames.slice(0, 3).map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)}
+                            {grNames.length > 3 && ` 等 ${grNames.length} 張單據`}。
+                        </p>
+                    )}
+                </div>
+            </div>
+        );
+    }
+
+    // --- Logic for Forward Tracing ---
+    if (direction === 'forward') {
+        const poNodes = data.children?.filter(c => c.type === 'production_order') || [];
+        const poNames = getUniqueLabels(poNodes, '投入工單:');
+
+        let targetNodes: TraceabilityNode[] = [];
+        let outNodes: TraceabilityNode[] = [];
+
+        poNodes.forEach(po => {
+            const targets = po.children?.filter(c => c.type === 'target_batch') || [];
+            targetNodes = [...targetNodes, ...targets];
+
+            targets.forEach(tgt => {
+                const outs = tgt.children?.filter(c => c.type === 'outbound_transaction') || [];
+                outNodes = [...outNodes, ...outs];
+            });
+        });
+
+        const targetNames = getUniqueLabels(targetNodes, '產出成品:');
+        const outNames = getUniqueLabels(outNodes, '出庫單據:');
+
+        return (
+            <div className="bg-blue-50/50 border border-blue-100 rounded-xl p-4 mb-6 flex gap-3 text-gray-700 leading-relaxed shadow-sm">
+                <Info className="w-5 h-5 text-blue-500 shrink-0 mt-0.5" />
+                <div className="space-y-1.5">
+                    <p>
+                        查詢的原料批號 <strong className="text-gray-900">{data.batch_number}</strong>
+                        {data.product_name && <span> ({data.product_name})</span>} 被投入了
+                        {poNames.length > 0 ? (
+                            <>
+                                生產工單 {poNames.slice(0, 3).map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)}
+                                {poNames.length > 3 && ` 等 ${poNames.length} 張工單`}。
+                            </>
+                        ) : (
+                            ' 未知的生產工單。'
+                        )}
+                    </p>
+                    {targetNodes.length > 0 && (
+                        <p>
+                            這些工單隨後產出了成品批號 {targetNames.slice(0, 3).map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)}
+                            {targetNames.length > 3 && ` 等 ${targetNodes.length} 批成品`}。
+                        </p>
+                    )}
+                    {outNodes.length > 0 && (
+                        <p>
+                            最終，這些成品透過 {outNames.slice(0, 3).map(n => <strong key={n} className="text-gray-900 mx-1">{n}</strong>).reduce((prev, curr) => [prev, '、', curr] as any)}
+                            {outNames.length > 3 && ` 等 ${outNodes.length} 張單據`} 離開了倉庫。
+                        </p>
+                    )}
+                </div>
+            </div>
+        );
+    }
+
+    return null;
+}

resources/js/Pages/Inventory/Traceability/Components/TreeView.tsx

@@ -0,0 +1,168 @@
+import { cn } from '@/lib/utils';
+import { Package, Truck, Factory, CornerDownRight, Box, ShoppingCart } from 'lucide-react';
+import { formatDate } from '@/lib/date';
+
+export interface TraceabilityNode {
+    id: string;
+    type: 'target_batch' | 'source_batch' | 'production_order' | 'material_batch' | 'goods_receipt' | 'outbound_transaction';
+    label: string;
+    batch_number?: string;
+    date?: string;
+    vendor_id?: number | string;
+    product_name?: string;
+    spec?: string;
+    quantity?: number | string;
+    unit?: string;
+    warehouse_name?: string;
+    children?: TraceabilityNode[];
+}
+
+interface TreeViewProps {
+    data: TraceabilityNode;
+}
+
+const getNodeIcon = (type: TraceabilityNode['type']) => {
+    switch (type) {
+        case 'target_batch':
+        case 'source_batch':
+            return <Package className="h-5 w-5 text-primary-main" />;
+        case 'production_order':
+            return <Factory className="h-5 w-5 text-other-warning" />;
+        case 'material_batch':
+            return <Box className="h-5 w-5 text-primary-main" />;
+        case 'goods_receipt':
+            return <Truck className="h-5 w-5 text-other-info" />;
+        case 'outbound_transaction':
+            return <ShoppingCart className="h-5 w-5 text-other-success" />;
+        default:
+            return <Box className="h-5 w-5 text-gray-400" />;
+    }
+};
+
+const getNodeColor = (type: TraceabilityNode['type']) => {
+    switch (type) {
+        case 'target_batch':
+        case 'source_batch':
+            return 'border-primary-light bg-primary-lightest';
+        case 'production_order':
+            return 'border-orange-200 bg-orange-50';
+        case 'material_batch':
+            return 'border-primary-light bg-primary-lightest';
+        case 'goods_receipt':
+            return 'border-blue-200 bg-blue-50';
+        case 'outbound_transaction':
+            return 'border-emerald-200 bg-emerald-50';
+        default:
+            return 'border-gray-200 bg-gray-50';
+    }
+};
+
+const TreeNode = ({ node, isLast, level = 0 }: { node: TraceabilityNode; isLast: boolean; level?: number }) => {
+    const hasChildren = node.children && node.children.length > 0;
+
+    return (
+        <div className="relative">
+            {/* 連接線 (上層到此節點) */}
+            {level > 0 && (
+                <div
+                    className={cn(
+                        "absolute border-l-2 border-gray-200",
+                        isLast ? "h-6 top-0" : "h-full top-0"
+                    )}
+                    style={{ left: '-1.5rem' }}
+                />
+            )}
+
+            {/* 橫向連接線 */}
+            {level > 0 && (
+                <div
+                    className="absolute border-t-2 border-gray-200 w-6 top-6"
+                    style={{ left: '-1.5rem' }}
+                />
+            )}
+
+            <div className="flex items-start mb-6">
+                {level > 0 && (
+                    <div className="w-6 h-12 shrink-0 flex items-center justify-end pr-2 text-gray-400">
+                        <CornerDownRight className="h-4 w-4" />
+                    </div>
+                )}
+
+                <div className={cn(
+                    "relative flex flex-col p-4 rounded-xl border shadow-sm min-w-[320px] max-w-md",
+                    getNodeColor(node.type)
+                )}>
+                    <div className="flex items-center gap-3">
+                        <div className="p-2 bg-white rounded-lg shadow-sm shrink-0">
+                            {getNodeIcon(node.type)}
+                        </div>
+                        <div className="flex-1 min-w-0">
+                            <h4 className="font-semibold text-gray-900 truncate">{node.label}</h4>
+                            {node.date && (
+                                <div className="mt-0.5">
+                                    <span className="text-xs text-gray-500">{formatDate(node.date)}</span>
+                                </div>
+                            )}
+                        </div>
+                    </div>
+
+                    {(node.product_name || node.warehouse_name || (node.quantity !== undefined && node.quantity !== null)) && (
+                        <div className="mt-3 pt-3 border-t border-gray-200/60 flex flex-wrap gap-4">
+                            {node.product_name && (
+                                <div className="flex-1 min-w-[120px]">
+                                    <span className="text-[11px] text-gray-500 font-medium block mb-0.5">品名 / 規格</span>
+                                    <span className="text-sm font-medium text-gray-800 leading-tight block truncate" title={`${node.product_name} ${node.spec ? `(${node.spec})` : ''}`}>
+                                        {node.product_name}
+                                        {node.spec && <span className="text-gray-400 text-xs ml-1">({node.spec})</span>}
+                                    </span>
+                                </div>
+                            )}
+
+                            {node.warehouse_name && (
+                                <div className="shrink-0 min-w-[80px]">
+                                    <span className="text-[11px] text-gray-500 font-medium block mb-0.5">倉庫</span>
+                                    <span className="text-sm font-medium text-gray-800 leading-tight block truncate" title={node.warehouse_name}>
+                                        {node.warehouse_name}
+                                    </span>
+                                </div>
+                            )}
+
+                            {node.quantity !== undefined && node.quantity !== null && (
+                                <div className="shrink-0 text-right min-w-[60px]">
+                                    <span className="text-[11px] text-gray-500 font-medium block mb-0.5">數量</span>
+                                    <span className="text-sm font-bold text-gray-900 block truncate">
+                                        {Number(node.quantity).toLocaleString()}
+                                        <span className="text-[10px] ml-0.5 text-gray-500 font-normal">{node.unit || 'PCS'}</span>
+                                    </span>
+                                </div>
+                            )}
+                        </div>
+                    )}
+                </div>
+            </div>
+
+            {hasChildren && (
+                <div className="pl-12 relative">
+                    {node.children!.map((child, index) => (
+                        <TreeNode
+                            key={`${child.id} -${index} `}
+                            node={child}
+                            isLast={index === node.children!.length - 1}
+                            level={level + 1}
+                        />
+                    ))}
+                </div>
+            )}
+        </div>
+    );
+};
+
+export default function TreeView({ data }: TreeViewProps) {
+    if (!data) return null;
+
+    return (
+        <div className="p-4 md:p-8 bg-gray-50/50 rounded-2xl border border-gray-100 overflow-x-auto">
+            <TreeNode node={data} isLast={true} level={0} />
+        </div>
+    );
+}

resources/js/Pages/Inventory/Traceability/Index.tsx

@@ -0,0 +1,154 @@
+import React, { useState } from 'react';
+import { Head, router } from '@inertiajs/react';
+import AuthenticatedLayout from '@/Layouts/AuthenticatedLayout';
+import { PageProps } from '@/types/global';
+import { Card, CardContent, CardHeader, CardTitle } from '@/Components/ui/card';
+import { Button } from '@/Components/ui/button';
+import { Input } from '@/Components/ui/input';
+import { Label } from '@/Components/ui/label';
+import { TrendingUp, Search, RotateCcw } from 'lucide-react';
+import { RadioGroup, RadioGroupItem } from '@/Components/ui/radio-group';
+import { cn } from '@/lib/utils';
+import TreeView, { TraceabilityNode } from './Components/TreeView';
+import { TraceabilitySummary } from './Components/TraceabilitySummary';
+import { Can } from '@/Components/Permission/Can';
+
+interface Props extends PageProps {
+    search: {
+        batch_number: string | null;
+        direction: 'backward' | 'forward';
+    };
+    result: TraceabilityNode | null;
+}
+
+export default function TraceabilityIndex({ search, result }: Props) {
+    const [batchNumber, setBatchNumber] = useState(search.batch_number || '');
+    const [direction, setDirection] = useState<'backward' | 'forward'>(search.direction || 'backward');
+    const [isSearching, setIsSearching] = useState(false);
+
+    const handleSearch = (e: React.FormEvent) => {
+        e.preventDefault();
+        if (!batchNumber.trim()) return;
+
+        setIsSearching(true);
+        router.get(
+            route('inventory.traceability.index'),
+            { batch_number: batchNumber.trim(), direction },
+            {
+                preserveState: true,
+                preserveScroll: true,
+                onFinish: () => setIsSearching(false)
+            }
+        );
+    };
+
+    return (
+        <AuthenticatedLayout
+            breadcrumbs={[
+                { label: '報表管理', href: '#' },
+                { label: '批號溯源', href: route('inventory.traceability.index'), isPage: true },
+            ]}
+        >
+            <Head title="批號溯源 - Star ERP" />
+
+            <div className="container mx-auto p-6 max-w-7xl">
+                <div className="mb-6">
+                    <div className="mb-4">
+                        <h1 className="text-2xl font-bold text-grey-0 flex items-center gap-2">
+                            <TrendingUp className="h-6 w-6 text-primary-main" />
+                            批號溯源
+                        </h1>
+                        <p className="text-gray-500 mt-1">
+                            透過批號追蹤產品的生產履歷，支援從成品追溯原料供應商（逆向），或從原料追查銷售去向（順向）。
+                        </p>
+                    </div>
+                </div>
+
+                <Can permission="inventory.traceability.view">
+                    <Card className="mb-6 bg-white shadow-sm border-gray-200">
+                        <CardHeader className="pb-3 border-b border-gray-100 bg-gray-50/50">
+                            <CardTitle className="text-lg flex items-center gap-2 text-gray-800">
+                                <Search className="h-5 w-5 text-primary-main" />
+                                查詢條件
+                            </CardTitle>
+                        </CardHeader>
+                        <CardContent className="pt-6">
+                            <form onSubmit={handleSearch} className="flex flex-col md:flex-row gap-6 items-start md:items-end">
+                                <div className="flex-1 w-full space-y-1.5">
+                                    <Label htmlFor="batchNumber" className="text-sm font-medium text-grey-1">查詢批號</Label>
+                                    <Input
+                                        id="batchNumber"
+                                        type="text"
+                                        placeholder="請輸入欲查詢的批號 (例如：PROD-TW-20240101-01)"
+                                        value={batchNumber}
+                                        onChange={(e) => setBatchNumber(e.target.value)}
+                                        className="max-w-md w-full"
+                                    />
+                                </div>
+
+                                <div className="space-y-3">
+                                    <Label className="text-gray-700 font-medium">追蹤方向</Label>
+                                    <RadioGroup
+                                        value={direction}
+                                        onValueChange={(val: 'backward' | 'forward') => setDirection(val)}
+                                        className="flex space-x-6"
+                                    >
+                                        <div
+                                            className={cn(
+                                                "flex items-center space-x-2 px-4 py-2 rounded-lg border cursor-pointer transition-colors",
+                                                direction === 'backward' ? "bg-primary-lightest border-primary-light" : "bg-gray-50 border-gray-200 hover:bg-gray-100"
+                                            )}
+                                        >
+                                            <RadioGroupItem value="backward" id="backward" />
+                                            <Label htmlFor="backward" className="cursor-pointer flex items-center gap-1.5 font-medium">
+                                                <RotateCcw className="h-4 w-4 text-primary-main" />
+                                                逆向溯源 (成品 ➔ 原料)
+                                            </Label>
+                                        </div>
+                                        <div
+                                            className={cn(
+                                                "flex items-center space-x-2 px-4 py-2 rounded-lg border cursor-pointer transition-colors",
+                                                direction === 'forward' ? "bg-primary-lightest border-primary-light" : "bg-gray-50 border-gray-200 hover:bg-gray-100"
+                                            )}
+                                        >
+                                            <RadioGroupItem value="forward" id="forward" />
+                                            <Label htmlFor="forward" className="cursor-pointer flex items-center gap-1.5 font-medium">
+                                                <TrendingUp className="h-4 w-4 text-primary-main" />
+                                                順向追蹤 (原料 ➔ 去向)
+                                            </Label>
+                                        </div>
+                                    </RadioGroup>
+                                </div>
+
+                                <Button
+                                    type="submit"
+                                    disabled={isSearching || !batchNumber.trim()}
+                                    className="button-filled-primary min-w-[120px]"
+                                >
+                                    {isSearching ? '查詢中...' : '開始查詢'}
+                                </Button>
+                            </form>
+                        </CardContent>
+                    </Card>
+
+                    {search.batch_number && (
+                        <div className="bg-white rounded-xl border border-gray-200 shadow-sm overflow-hidden p-6 md:p-8">
+                            {result ? (
+                                <>
+                                    <TraceabilitySummary data={result} direction={search.direction || 'backward'} />
+                                    <TreeView data={result} />
+                                </>
+                            ) : (
+                                <div className="py-16 flex flex-col items-center justify-center text-gray-500">
+                                    <Search className="h-12 w-12 text-gray-300 mb-4" />
+                                    <h3 className="text-lg font-medium text-gray-900 mb-1">找不到符合的批號資料</h3>
+                                    <p>請確認您輸入的批號「{search.batch_number}」是否正確存在於系統中。</p>
+                                </div>
+                            )}
+                        </div>
+                    )}
+                </Can>
+            </div>
+        </AuthenticatedLayout>
+    );
+}