feat(inventory): 新增庫存分析模組
- 實作 InventoryAnalysisController 與 TurnoverService - 新增庫存分析前端頁面 (Inventory/Analysis/Index.tsx) - 整合路由與選單 - 統一分頁邏輯與狀態顯示 - 更新 UI Consistency Skill 文件
This commit is contained in:
@@ -569,6 +569,7 @@ const handlePerPageChange = (value: string) => {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
## 7. Badge 與狀態顯示
|
## 7. Badge 與狀態顯示
|
||||||
|
|
||||||
### 7.1 基本 Badge
|
### 7.1 基本 Badge
|
||||||
@@ -614,6 +615,48 @@ import { Badge } from "@/Components/ui/badge";
|
|||||||
</div>
|
</div>
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### 7.3 統一狀態標籤 (StatusBadge)
|
||||||
|
|
||||||
|
系統提供統一的 `StatusBadge` 元件來顯示各種業務狀態,確保顏色與樣式的一致性。
|
||||||
|
|
||||||
|
**引入方式**:
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
import { StatusBadge, StatusVariant } from "@/Components/shared/StatusBadge";
|
||||||
|
```
|
||||||
|
|
||||||
|
**支援的變體 (Variant)**:
|
||||||
|
|
||||||
|
| Variant | 顏色 | 適用情境 |
|
||||||
|
|---|---|---|
|
||||||
|
| `neutral` | 灰色 | 草稿、取消、關閉、缺貨 |
|
||||||
|
| `info` | 藍色 | 處理中、啟用中 |
|
||||||
|
| `warning` | 黃色 | 待審核、庫存預警、週轉慢 |
|
||||||
|
| `success` | 綠色 | 已完成、已核准、正常 |
|
||||||
|
| `destructive` | 紅色 | 作廢、駁回、滯銷、異常 |
|
||||||
|
|
||||||
|
**實作模式**:
|
||||||
|
|
||||||
|
建議定義一個 `getStatusVariant` 函式將業務狀態對應到 UI 變體,保持程式碼整潔。
|
||||||
|
|
||||||
|
```tsx
|
||||||
|
// 1. 定義狀態映射函式
|
||||||
|
const getStatusVariant = (status: string): StatusVariant => {
|
||||||
|
switch (status) {
|
||||||
|
case 'normal': return 'success'; // 正常 -> 綠色
|
||||||
|
case 'slow': return 'warning'; // 週轉慢 -> 黃色
|
||||||
|
case 'dead': return 'destructive'; // 滯銷 -> 紅色
|
||||||
|
case 'out_of_stock': return 'neutral';// 缺貨 -> 灰色
|
||||||
|
default: return 'neutral';
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
// 2. 在表格中使用
|
||||||
|
<StatusBadge variant={getStatusVariant(item.status)}>
|
||||||
|
{item.status_label}
|
||||||
|
</StatusBadge>
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 8. 頁面佈局規範
|
## 8. 頁面佈局規範
|
||||||
|
|||||||
@@ -0,0 +1,38 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Modules\Inventory\Controllers;
|
||||||
|
|
||||||
|
use App\Http\Controllers\Controller;
|
||||||
|
use App\Modules\Inventory\Models\Category;
|
||||||
|
use App\Modules\Inventory\Models\Warehouse;
|
||||||
|
use App\Modules\Inventory\Services\TurnoverService;
|
||||||
|
use Illuminate\Http\Request;
|
||||||
|
use Inertia\Inertia;
|
||||||
|
|
||||||
|
class InventoryAnalysisController extends Controller
|
||||||
|
{
|
||||||
|
protected $turnoverService;
|
||||||
|
|
||||||
|
public function __construct(TurnoverService $turnoverService)
|
||||||
|
{
|
||||||
|
$this->turnoverService = $turnoverService;
|
||||||
|
}
|
||||||
|
|
||||||
|
public function index(Request $request)
|
||||||
|
{
|
||||||
|
$filters = $request->only([
|
||||||
|
'warehouse_id', 'category_id', 'search', 'per_page', 'sort_by', 'sort_order', 'status'
|
||||||
|
]);
|
||||||
|
|
||||||
|
$analysisData = $this->turnoverService->getAnalysisData($filters, $request->input('per_page', 10));
|
||||||
|
$kpis = $this->turnoverService->getKPIs($filters);
|
||||||
|
|
||||||
|
return Inertia::render('Inventory/Analysis/Index', [
|
||||||
|
'analysisData' => $analysisData,
|
||||||
|
'kpis' => $kpis,
|
||||||
|
'warehouses' => Warehouse::select('id', 'name')->get(),
|
||||||
|
'categories' => Category::select('id', 'name')->get(),
|
||||||
|
'filters' => $filters,
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -14,6 +14,7 @@ use App\Modules\Inventory\Controllers\AdjustDocController;
|
|||||||
use App\Modules\Inventory\Controllers\InventoryReportController;
|
use App\Modules\Inventory\Controllers\InventoryReportController;
|
||||||
|
|
||||||
use App\Modules\Inventory\Controllers\StockQueryController;
|
use App\Modules\Inventory\Controllers\StockQueryController;
|
||||||
|
use App\Modules\Inventory\Controllers\InventoryAnalysisController;
|
||||||
|
|
||||||
Route::middleware('auth')->group(function () {
|
Route::middleware('auth')->group(function () {
|
||||||
|
|
||||||
@@ -32,6 +33,11 @@ Route::middleware('auth')->group(function () {
|
|||||||
Route::get('/inventory/report/{product}', [InventoryReportController::class, 'show'])->name('inventory.report.show');
|
Route::get('/inventory/report/{product}', [InventoryReportController::class, 'show'])->name('inventory.report.show');
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// 庫存分析 (Inventory Analysis)
|
||||||
|
Route::middleware('permission:inventory_report.view')->group(function () {
|
||||||
|
Route::get('/inventory/analysis', [InventoryAnalysisController::class, 'index'])->name('inventory.analysis.index');
|
||||||
|
});
|
||||||
|
|
||||||
// 類別管理 (用於商品對話框) - 需要商品權限
|
// 類別管理 (用於商品對話框) - 需要商品權限
|
||||||
Route::middleware('permission:products.view')->group(function () {
|
Route::middleware('permission:products.view')->group(function () {
|
||||||
Route::get('/categories', [CategoryController::class, 'index'])->name('categories.index');
|
Route::get('/categories', [CategoryController::class, 'index'])->name('categories.index');
|
||||||
|
|||||||
247
app/Modules/Inventory/Services/TurnoverService.php
Normal file
247
app/Modules/Inventory/Services/TurnoverService.php
Normal file
@@ -0,0 +1,247 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Modules\Inventory\Services;
|
||||||
|
|
||||||
|
use App\Modules\Inventory\Models\InventoryTransaction;
|
||||||
|
use App\Modules\Inventory\Models\Product;
|
||||||
|
use Illuminate\Support\Facades\DB;
|
||||||
|
use Carbon\Carbon;
|
||||||
|
|
||||||
|
class TurnoverService
|
||||||
|
{
|
||||||
|
/**
|
||||||
|
* Get inventory turnover analysis data
|
||||||
|
*/
|
||||||
|
public function getAnalysisData(array $filters, int $perPage = 20)
|
||||||
|
{
|
||||||
|
$warehouseId = $filters['warehouse_id'] ?? null;
|
||||||
|
$categoryId = $filters['category_id'] ?? null;
|
||||||
|
$search = $filters['search'] ?? null;
|
||||||
|
$statusFilter = $filters['status'] ?? null; // 'dead', 'slow', 'normal'
|
||||||
|
|
||||||
|
// Base query for products with their current inventory sum
|
||||||
|
$query = Product::query()
|
||||||
|
->select([
|
||||||
|
'products.id',
|
||||||
|
'products.code',
|
||||||
|
'products.name',
|
||||||
|
'categories.name as category_name',
|
||||||
|
'products.cost_price', // Assuming cost_price exists for value calculation
|
||||||
|
])
|
||||||
|
->leftJoin('categories', 'products.category_id', '=', 'categories.id')
|
||||||
|
->leftJoin('inventories', 'products.id', '=', 'inventories.product_id')
|
||||||
|
->groupBy(['products.id', 'products.code', 'products.name', 'categories.name', 'products.cost_price']);
|
||||||
|
|
||||||
|
// Filter by Warehouse (Current Inventory)
|
||||||
|
if ($warehouseId) {
|
||||||
|
$query->where('inventories.warehouse_id', $warehouseId);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Filter by Category
|
||||||
|
if ($categoryId) {
|
||||||
|
$query->where('products.category_id', $categoryId);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Filter by Search
|
||||||
|
if ($search) {
|
||||||
|
$query->where(function($q) use ($search) {
|
||||||
|
$q->where('products.name', 'like', "%{$search}%")
|
||||||
|
->orWhere('products.code', 'like', "%{$search}%");
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add Aggregated Columns
|
||||||
|
|
||||||
|
// 1. Current Inventory Quantity
|
||||||
|
$query->addSelect(DB::raw('COALESCE(SUM(inventories.quantity), 0) as current_stock'));
|
||||||
|
|
||||||
|
// 2. Sales in last 30 days (Outbound)
|
||||||
|
// We need a subquery or join for this to be efficient, or we use a separate query and map.
|
||||||
|
// Given potentially large data, subquery per row might be slow, but for pagination it's okay-ish.
|
||||||
|
// Better approach: Join with a subquery of aggregated transactions.
|
||||||
|
|
||||||
|
$thirtyDaysAgo = Carbon::now()->subDays(30);
|
||||||
|
|
||||||
|
// Subquery for 30-day sales
|
||||||
|
$salesSubquery = InventoryTransaction::query()
|
||||||
|
->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('inventory_transactions.actual_time', '>=', $thirtyDaysAgo)
|
||||||
|
->groupBy('inventories.product_id');
|
||||||
|
|
||||||
|
if ($warehouseId) {
|
||||||
|
$salesSubquery->where('inventories.warehouse_id', $warehouseId);
|
||||||
|
}
|
||||||
|
|
||||||
|
$query->leftJoinSub($salesSubquery, 'sales_30d', function ($join) {
|
||||||
|
$join->on('products.id', '=', 'sales_30d.product_id');
|
||||||
|
});
|
||||||
|
$query->addSelect(DB::raw('COALESCE(sales_30d.sales_qty_30d, 0) as sales_30d'));
|
||||||
|
|
||||||
|
// 3. Last Sale Date
|
||||||
|
// Use max actual_time from outbound transactions
|
||||||
|
$lastSaleSubquery = InventoryTransaction::query()
|
||||||
|
->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', '出庫')
|
||||||
|
->groupBy('inventories.product_id');
|
||||||
|
|
||||||
|
if ($warehouseId) {
|
||||||
|
$lastSaleSubquery->where('inventories.warehouse_id', $warehouseId);
|
||||||
|
}
|
||||||
|
|
||||||
|
$query->leftJoinSub($lastSaleSubquery, 'last_sales', function ($join) {
|
||||||
|
$join->on('products.id', '=', 'last_sales.product_id');
|
||||||
|
});
|
||||||
|
$query->addSelect('last_sales.last_sale_date');
|
||||||
|
|
||||||
|
// Apply Status Filter (Dead Stock etc) requires having clauses or wrapper query.
|
||||||
|
// Dead Stock: stock > 0 AND (last_sale_date < 90 days ago OR last_sale_date IS NULL)
|
||||||
|
// Slow Moving: turnover days > X?
|
||||||
|
|
||||||
|
// Let's modify query to handle ordering and filtering on calculated fields if possible.
|
||||||
|
// For simplicity in Laravel, we might fetch and transform, but pagination breaks.
|
||||||
|
// We'll use HAVING for status filtering if needed.
|
||||||
|
|
||||||
|
// Order by
|
||||||
|
$sortBy = $filters['sort_by'] ?? 'turnover_days'; // Default sort
|
||||||
|
$sortOrder = $filters['sort_order'] ?? 'desc';
|
||||||
|
|
||||||
|
// Turnover Days Calculation in SQL: (stock / (sales_30d / 30)) => (stock * 30) / sales_30d
|
||||||
|
// Handle division by zero: if sales_30d is 0, turnover is 'Inf' (or very high number like 9999)
|
||||||
|
$turnoverDaysSql = "CASE WHEN COALESCE(sales_30d.sales_qty_30d, 0) > 0
|
||||||
|
THEN (COALESCE(SUM(inventories.quantity), 0) * 30) / sales_30d.sales_qty_30d
|
||||||
|
ELSE 9999 END";
|
||||||
|
|
||||||
|
$query->addSelect(DB::raw("$turnoverDaysSql as turnover_days"));
|
||||||
|
|
||||||
|
// Only show items with stock > 0 ? User might want to see out of stock items too?
|
||||||
|
// Usually analysis focuses on what IS in stock. But Dead Stock needs items with stock.
|
||||||
|
// Stock-out analysis needs items with 0 stock.
|
||||||
|
// Let's filter stock > 0 by default for "Turnover Analysis".
|
||||||
|
// $query->havingRaw('current_stock > 0');
|
||||||
|
// Wait, better to let user filter?
|
||||||
|
// For dead stock, definitive IS stock > 0.
|
||||||
|
|
||||||
|
if ($statusFilter === 'dead') {
|
||||||
|
$ninetyDaysAgo = Carbon::now()->subDays(90);
|
||||||
|
$query->havingRaw("current_stock > 0 AND (last_sale_date < ? OR last_sale_date IS NULL)", [$ninetyDaysAgo]);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Apply Sorting
|
||||||
|
if ($sortBy === 'turnover_days') {
|
||||||
|
$query->orderByRaw("$turnoverDaysSql $sortOrder");
|
||||||
|
} else if (in_array($sortBy, ['current_stock', 'sales_30d', 'last_sale_date'])) {
|
||||||
|
$query->orderBy($sortBy, $sortOrder);
|
||||||
|
} else {
|
||||||
|
$query->orderBy('products.code', 'asc');
|
||||||
|
}
|
||||||
|
|
||||||
|
return $query->paginate($perPage)->withQueryString()->through(function($item) {
|
||||||
|
// Post-processing for display
|
||||||
|
$item->turnover_days_display = $item->turnover_days >= 9999 ? '∞' : number_format($item->turnover_days, 1);
|
||||||
|
|
||||||
|
// Determine Status Label
|
||||||
|
$lastSale = $item->last_sale_date ? Carbon::parse($item->last_sale_date) : null;
|
||||||
|
$daysSinceSale = $lastSale ? $lastSale->diffInDays(Carbon::now()) : 9999;
|
||||||
|
|
||||||
|
if ($item->current_stock > 0 && $daysSinceSale > 90) {
|
||||||
|
$item->status = 'dead'; // 滯銷
|
||||||
|
$item->status_label = '滯銷';
|
||||||
|
} elseif ($item->current_stock > 0 && $item->turnover_days > 60) {
|
||||||
|
$item->status = 'slow'; // 週轉慢
|
||||||
|
$item->status_label = '週轉慢';
|
||||||
|
} elseif ($item->current_stock == 0) {
|
||||||
|
$item->status = 'out_of_stock';
|
||||||
|
$item->status_label = '缺貨';
|
||||||
|
} else {
|
||||||
|
$item->status = 'normal';
|
||||||
|
$item->status_label = '正常';
|
||||||
|
}
|
||||||
|
|
||||||
|
return $item;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
public function getKPIs(array $filters)
|
||||||
|
{
|
||||||
|
// Calculates aggregate KPIs
|
||||||
|
$warehouseId = $filters['warehouse_id'] ?? null;
|
||||||
|
$categoryId = $filters['category_id'] ?? null;
|
||||||
|
|
||||||
|
// Helper to build base inv query
|
||||||
|
$buildInvQuery = function() use ($warehouseId, $categoryId) {
|
||||||
|
$q = DB::table('inventories')
|
||||||
|
->join('products', 'inventories.product_id', '=', 'products.id')
|
||||||
|
->where('inventories.quantity', '>', 0);
|
||||||
|
if ($warehouseId) $q->where('inventories.warehouse_id', $warehouseId);
|
||||||
|
if ($categoryId) $q->where('products.category_id', $categoryId);
|
||||||
|
return $q;
|
||||||
|
};
|
||||||
|
|
||||||
|
// 1. Total Inventory Value (Cost)
|
||||||
|
$totalValue = (clone $buildInvQuery())
|
||||||
|
->sum(DB::raw('inventories.quantity * COALESCE(products.cost_price, 0)'));
|
||||||
|
|
||||||
|
// 2. Dead Stock Value (No sale in 90 days)
|
||||||
|
// Need last sale date for each product-location or just product?
|
||||||
|
// Assuming dead stock is product-level logic for simplicity.
|
||||||
|
|
||||||
|
$ninetyDaysAgo = Carbon::now()->subDays(90);
|
||||||
|
|
||||||
|
// Get IDs of products sold in last 90 days
|
||||||
|
$soldProductIds = InventoryTransaction::query()
|
||||||
|
->where('type', '出庫')
|
||||||
|
->where('actual_time', '>=', $ninetyDaysAgo)
|
||||||
|
->distinct()
|
||||||
|
->pluck('inventory_id') // Wait, transaction links to inventory, inventory links to product.
|
||||||
|
// We need product_id.
|
||||||
|
->map(function($id) {
|
||||||
|
return DB::table('inventories')->where('id', $id)->value('product_id');
|
||||||
|
})
|
||||||
|
->filter()
|
||||||
|
->unique()
|
||||||
|
->toArray();
|
||||||
|
// Optimization: Use join in subquery
|
||||||
|
|
||||||
|
$soldProductIdsQuery = DB::table('inventory_transactions')
|
||||||
|
->join('inventories', 'inventory_transactions.inventory_id', '=', 'inventories.id')
|
||||||
|
->where('inventory_transactions.type', '出庫')
|
||||||
|
->where('inventory_transactions.actual_time', '>=', $ninetyDaysAgo)
|
||||||
|
->select('inventories.product_id')
|
||||||
|
->distinct();
|
||||||
|
|
||||||
|
$deadStockQuery = (clone $buildInvQuery())
|
||||||
|
->whereNotIn('products.id', $soldProductIdsQuery);
|
||||||
|
|
||||||
|
$deadStockValue = $deadStockQuery->sum(DB::raw('inventories.quantity * COALESCE(products.cost_price, 0)'));
|
||||||
|
$deadStockCount = $deadStockQuery->count('products.id'); // Count of inventory records (batches) or products?
|
||||||
|
// Let's count distinct products
|
||||||
|
$deadStockProductCount = $deadStockQuery->distinct('products.id')->count('products.id');
|
||||||
|
|
||||||
|
// 3. Average Turnover Days (Company wide)
|
||||||
|
// Formula: (Avg Inventory / COGS) * 365 ?
|
||||||
|
// Simplified: (Total Stock / Total Sales 30d) * 30
|
||||||
|
|
||||||
|
$totalStock = (clone $buildInvQuery())->sum('inventories.quantity');
|
||||||
|
|
||||||
|
$totalSales30d = DB::table('inventory_transactions')
|
||||||
|
->join('inventories', 'inventory_transactions.inventory_id', '=', 'inventories.id')
|
||||||
|
->join('products', 'inventories.product_id', '=', 'products.id')
|
||||||
|
->where('inventory_transactions.type', '出庫')
|
||||||
|
->where('inventory_transactions.actual_time', '>=', Carbon::now()->subDays(30))
|
||||||
|
->when($warehouseId, fn($q) => $q->where('inventories.warehouse_id', $warehouseId))
|
||||||
|
->when($categoryId, fn($q) => $q->where('products.category_id', $categoryId))
|
||||||
|
->sum(DB::raw('ABS(inventory_transactions.quantity)'));
|
||||||
|
|
||||||
|
$avgTurnoverDays = $totalSales30d > 0 ? ($totalStock * 30) / $totalSales30d : 0;
|
||||||
|
|
||||||
|
return [
|
||||||
|
'total_stock_value' => $totalValue,
|
||||||
|
'dead_stock_value' => $deadStockValue,
|
||||||
|
'dead_stock_count' => $deadStockProductCount,
|
||||||
|
'avg_turnover_days' => round($avgTurnoverDays, 1),
|
||||||
|
];
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -249,6 +249,13 @@ export default function AuthenticatedLayout({
|
|||||||
route: "/inventory/report",
|
route: "/inventory/report",
|
||||||
permission: "inventory_report.view",
|
permission: "inventory_report.view",
|
||||||
},
|
},
|
||||||
|
{
|
||||||
|
id: "inventory-analysis",
|
||||||
|
label: "庫存分析",
|
||||||
|
icon: <BarChart3 className="h-4 w-4" />,
|
||||||
|
route: "/inventory/analysis",
|
||||||
|
permission: "inventory_report.view",
|
||||||
|
},
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
|||||||
442
resources/js/Pages/Inventory/Analysis/Index.tsx
Normal file
442
resources/js/Pages/Inventory/Analysis/Index.tsx
Normal file
@@ -0,0 +1,442 @@
|
|||||||
|
import { useState, useCallback } from "react";
|
||||||
|
import { Button } from "@/Components/ui/button";
|
||||||
|
import { Input } from "@/Components/ui/input";
|
||||||
|
import { Label } from "@/Components/ui/label";
|
||||||
|
import {
|
||||||
|
Filter,
|
||||||
|
Package,
|
||||||
|
RotateCcw,
|
||||||
|
BarChart3,
|
||||||
|
AlertTriangle,
|
||||||
|
CheckCircle2,
|
||||||
|
Clock,
|
||||||
|
ArrowUpDown,
|
||||||
|
ArrowUp,
|
||||||
|
ArrowDown,
|
||||||
|
XCircle
|
||||||
|
} from 'lucide-react';
|
||||||
|
import AuthenticatedLayout from "@/Layouts/AuthenticatedLayout";
|
||||||
|
import { Head, router } from "@inertiajs/react";
|
||||||
|
import {
|
||||||
|
Table,
|
||||||
|
TableBody,
|
||||||
|
TableCell,
|
||||||
|
TableHead,
|
||||||
|
TableHeader,
|
||||||
|
TableRow,
|
||||||
|
} from "@/Components/ui/table";
|
||||||
|
import Pagination from "@/Components/shared/Pagination";
|
||||||
|
import { SearchableSelect } from "@/Components/ui/searchable-select";
|
||||||
|
import { PageProps } from "@/types/global";
|
||||||
|
|
||||||
|
import {
|
||||||
|
Tooltip,
|
||||||
|
TooltipContent,
|
||||||
|
TooltipProvider,
|
||||||
|
TooltipTrigger,
|
||||||
|
} from "@/Components/ui/tooltip";
|
||||||
|
import { StatusBadge, StatusVariant } from "@/Components/shared/StatusBadge";
|
||||||
|
|
||||||
|
interface AnalysisItem {
|
||||||
|
id: number;
|
||||||
|
code: string;
|
||||||
|
name: string;
|
||||||
|
category_name: string;
|
||||||
|
current_stock: string; // decimal string from DB
|
||||||
|
sales_30d: string;
|
||||||
|
last_sale_date: string | null;
|
||||||
|
turnover_days: number;
|
||||||
|
turnover_days_display: string;
|
||||||
|
status: 'dead' | 'slow' | 'normal' | 'out_of_stock';
|
||||||
|
status_label: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface KPIProps {
|
||||||
|
total_stock_value: number;
|
||||||
|
dead_stock_value: number;
|
||||||
|
dead_stock_count: number;
|
||||||
|
avg_turnover_days: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface PagePropsWithData extends PageProps {
|
||||||
|
analysisData: {
|
||||||
|
data: AnalysisItem[];
|
||||||
|
links: any[];
|
||||||
|
total: number;
|
||||||
|
from: number;
|
||||||
|
to: number;
|
||||||
|
current_page: number;
|
||||||
|
};
|
||||||
|
kpis: KPIProps;
|
||||||
|
warehouses: { id: number; name: string }[];
|
||||||
|
categories: { id: number; name: string }[];
|
||||||
|
filters: {
|
||||||
|
warehouse_id?: string;
|
||||||
|
category_id?: string;
|
||||||
|
search?: string;
|
||||||
|
per_page?: string;
|
||||||
|
sort_by?: string;
|
||||||
|
sort_order?: 'asc' | 'desc';
|
||||||
|
status?: string;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// Define status mapping
|
||||||
|
const getStatusVariant = (status: string): StatusVariant => {
|
||||||
|
switch (status) {
|
||||||
|
case 'dead': return 'destructive';
|
||||||
|
case 'slow': return 'warning';
|
||||||
|
case 'normal': return 'success';
|
||||||
|
case 'out_of_stock': return 'neutral';
|
||||||
|
default: return 'neutral';
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const getStatusLabel = (status: string): string => {
|
||||||
|
switch (status) {
|
||||||
|
case 'dead': return '滯銷';
|
||||||
|
case 'slow': return '週轉慢';
|
||||||
|
case 'normal': return '正常';
|
||||||
|
case 'out_of_stock': return '缺貨';
|
||||||
|
default: return status;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
const statusOptions = [
|
||||||
|
{ label: "全部狀態", value: "all" },
|
||||||
|
{ label: "滯銷 (>90天)", value: "dead" },
|
||||||
|
{ label: "週轉慢 (>60天)", value: "slow" },
|
||||||
|
{ label: "正常", value: "normal" }
|
||||||
|
];
|
||||||
|
|
||||||
|
export default function InventoryAnalysisIndex({ analysisData, kpis, warehouses, categories, filters }: PagePropsWithData) {
|
||||||
|
const [warehouseId, setWarehouseId] = useState(filters.warehouse_id || "all");
|
||||||
|
const [categoryId, setCategoryId] = useState(filters.category_id || "all");
|
||||||
|
const [search, setSearch] = useState(filters.search || "");
|
||||||
|
const [status, setStatus] = useState(filters.status || "all");
|
||||||
|
const [perPage, setPerPage] = useState(filters.per_page?.toString() || "10");
|
||||||
|
|
||||||
|
const handleFilter = useCallback(() => {
|
||||||
|
router.get(
|
||||||
|
route("inventory.analysis.index"),
|
||||||
|
{
|
||||||
|
warehouse_id: warehouseId === "all" ? "" : warehouseId,
|
||||||
|
category_id: categoryId === "all" ? "" : categoryId,
|
||||||
|
status: status === "all" ? "" : status,
|
||||||
|
search: search,
|
||||||
|
per_page: perPage,
|
||||||
|
sort_by: filters.sort_by,
|
||||||
|
sort_order: filters.sort_order,
|
||||||
|
},
|
||||||
|
{ preserveState: true, preserveScroll: true }
|
||||||
|
);
|
||||||
|
}, [warehouseId, categoryId, status, search, perPage, filters.sort_by, filters.sort_order]);
|
||||||
|
|
||||||
|
const handleClearFilters = () => {
|
||||||
|
setWarehouseId("all");
|
||||||
|
setCategoryId("all");
|
||||||
|
setStatus("all");
|
||||||
|
setSearch("");
|
||||||
|
setPerPage("10");
|
||||||
|
router.get(route("inventory.analysis.index"));
|
||||||
|
};
|
||||||
|
|
||||||
|
const handleSort = (field: string) => {
|
||||||
|
let newSortBy: string | undefined = field;
|
||||||
|
let newSortOrder: 'asc' | 'desc' | undefined = 'asc';
|
||||||
|
|
||||||
|
if (filters.sort_by === field) {
|
||||||
|
if (filters.sort_order === 'asc') {
|
||||||
|
newSortOrder = 'desc';
|
||||||
|
} else {
|
||||||
|
newSortBy = undefined;
|
||||||
|
newSortOrder = undefined;
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Default sort order for numeric fields might be desc
|
||||||
|
if (['turnover_days', 'current_stock', 'sales_30d'].includes(field)) {
|
||||||
|
newSortOrder = 'desc';
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
router.get(
|
||||||
|
route("inventory.analysis.index"),
|
||||||
|
{
|
||||||
|
warehouse_id: warehouseId === "all" ? "" : warehouseId,
|
||||||
|
category_id: categoryId === "all" ? "" : categoryId,
|
||||||
|
status: status === "all" ? "" : status,
|
||||||
|
search: search,
|
||||||
|
per_page: perPage,
|
||||||
|
sort_by: newSortBy,
|
||||||
|
sort_order: newSortOrder,
|
||||||
|
},
|
||||||
|
{ preserveState: true, preserveScroll: true }
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
const handlePerPageChange = (value: string) => {
|
||||||
|
setPerPage(value);
|
||||||
|
// Trigger filter immediately
|
||||||
|
router.get(
|
||||||
|
route("inventory.analysis.index"),
|
||||||
|
{
|
||||||
|
warehouse_id: warehouseId === "all" ? "" : warehouseId,
|
||||||
|
category_id: categoryId === "all" ? "" : categoryId,
|
||||||
|
status: status === "all" ? "" : status,
|
||||||
|
search: search,
|
||||||
|
per_page: value,
|
||||||
|
sort_by: filters.sort_by,
|
||||||
|
sort_order: filters.sort_order,
|
||||||
|
},
|
||||||
|
{ preserveState: true, preserveScroll: true }
|
||||||
|
);
|
||||||
|
};
|
||||||
|
|
||||||
|
const SortIcon = ({ field }: { field: string }) => {
|
||||||
|
if (filters.sort_by !== field) {
|
||||||
|
return <ArrowUpDown className="h-4 w-4 text-gray-300 ml-1" />;
|
||||||
|
}
|
||||||
|
if (filters.sort_order === "asc") {
|
||||||
|
return <ArrowUp className="h-4 w-4 text-primary-main ml-1" />;
|
||||||
|
}
|
||||||
|
return <ArrowDown className="h-4 w-4 text-primary-main ml-1" />;
|
||||||
|
};
|
||||||
|
|
||||||
|
return (
|
||||||
|
<AuthenticatedLayout breadcrumbs={[{ label: "報表管理", href: "#" }, { label: "庫存分析", href: route("inventory.analysis.index"), isPage: true }]}>
|
||||||
|
<Head title="庫存分析" />
|
||||||
|
|
||||||
|
<div className="container mx-auto p-6 max-w-7xl">
|
||||||
|
{/* Header */}
|
||||||
|
<div className="flex flex-col md:flex-row md:items-center justify-between gap-4 mb-6">
|
||||||
|
<div>
|
||||||
|
<h1 className="text-2xl font-bold text-grey-0 flex items-center gap-2">
|
||||||
|
<BarChart3 className="h-6 w-6 text-primary-main" />
|
||||||
|
庫存分析
|
||||||
|
</h1>
|
||||||
|
<p className="text-gray-500 mt-1">
|
||||||
|
分析商品庫存週轉率、滯銷品項與庫存健康度
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* KPI Cards */}
|
||||||
|
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4 mb-6">
|
||||||
|
<div className="bg-white p-4 rounded-xl shadow-sm border border-gray-100 flex items-center gap-4">
|
||||||
|
<div className="p-3 bg-blue-50 rounded-lg text-blue-600">
|
||||||
|
<Clock className="w-6 h-6" />
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<p className="text-sm text-gray-500 font-medium">平均週轉天數</p>
|
||||||
|
<p className="text-2xl font-bold text-gray-900">{kpis.avg_turnover_days} <span className="text-sm font-normal text-gray-500">天</span></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="bg-white p-4 rounded-xl shadow-sm border border-gray-100 flex items-center gap-4">
|
||||||
|
<div className="p-3 bg-red-50 rounded-lg text-red-600">
|
||||||
|
<AlertTriangle className="w-6 h-6" />
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<p className="text-sm text-gray-500 font-medium">滯銷品項數</p>
|
||||||
|
<p className="text-2xl font-bold text-gray-900">{kpis.dead_stock_count} <span className="text-sm font-normal text-gray-500">項</span></p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="bg-white p-4 rounded-xl shadow-sm border border-gray-100 flex items-center gap-4">
|
||||||
|
<div className="p-3 bg-orange-50 rounded-lg text-orange-600">
|
||||||
|
<XCircle className="w-6 h-6" />
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<p className="text-sm text-gray-500 font-medium">滯銷庫存成本</p>
|
||||||
|
<TooltipProvider>
|
||||||
|
<Tooltip>
|
||||||
|
<TooltipTrigger>
|
||||||
|
<p className="text-2xl font-bold text-gray-900 cursor-help">${Number(kpis.dead_stock_value).toLocaleString()}</p>
|
||||||
|
</TooltipTrigger>
|
||||||
|
<TooltipContent>
|
||||||
|
<p>在此定義為庫存大於 0 且超過 90 天未銷售的商品成本總和</p>
|
||||||
|
</TooltipContent>
|
||||||
|
</Tooltip>
|
||||||
|
</TooltipProvider>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="bg-white p-4 rounded-xl shadow-sm border border-gray-100 flex items-center gap-4">
|
||||||
|
<div className="p-3 bg-emerald-50 rounded-lg text-emerald-600">
|
||||||
|
<CheckCircle2 className="w-6 h-6" />
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<p className="text-sm text-gray-500 font-medium">庫存總成本</p>
|
||||||
|
<p className="text-2xl font-bold text-gray-900">${Number(kpis.total_stock_value).toLocaleString()}</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Filters */}
|
||||||
|
<div className="bg-white rounded-xl shadow-sm border border-grey-4 p-5 mb-6">
|
||||||
|
<div className="grid grid-cols-1 md:grid-cols-12 gap-4 items-end">
|
||||||
|
{/* Search */}
|
||||||
|
<div className="md:col-span-3 space-y-1">
|
||||||
|
<Label className="text-xs text-grey-2 font-medium">關鍵字</Label>
|
||||||
|
<Input
|
||||||
|
placeholder="搜尋商品代碼或名稱..."
|
||||||
|
value={search}
|
||||||
|
onChange={(e) => setSearch(e.target.value)}
|
||||||
|
className="h-9 bg-white"
|
||||||
|
onKeyDown={(e) => e.key === 'Enter' && handleFilter()}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Warehouse & Category */}
|
||||||
|
<div className="md:col-span-2 space-y-1">
|
||||||
|
<Label className="text-xs text-grey-2 font-medium">倉庫</Label>
|
||||||
|
<SearchableSelect
|
||||||
|
value={warehouseId}
|
||||||
|
onValueChange={setWarehouseId}
|
||||||
|
options={[{ label: "全部倉庫", value: "all" }, ...warehouses.map(w => ({ label: w.name, value: w.id.toString() }))]}
|
||||||
|
className="w-full h-9"
|
||||||
|
placeholder="選擇倉庫..."
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
<div className="md:col-span-2 space-y-1">
|
||||||
|
<Label className="text-xs text-grey-2 font-medium">分類</Label>
|
||||||
|
<SearchableSelect
|
||||||
|
value={categoryId}
|
||||||
|
onValueChange={setCategoryId}
|
||||||
|
options={[{ label: "全部分類", value: "all" }, ...categories.map(c => ({ label: c.name, value: c.id.toString() }))]}
|
||||||
|
className="w-full h-9"
|
||||||
|
placeholder="選擇分類..."
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="md:col-span-2 space-y-1">
|
||||||
|
<Label className="text-xs text-grey-2 font-medium">狀態</Label>
|
||||||
|
<SearchableSelect
|
||||||
|
value={status}
|
||||||
|
onValueChange={setStatus}
|
||||||
|
options={statusOptions}
|
||||||
|
className="w-full h-9"
|
||||||
|
placeholder="選擇狀態..."
|
||||||
|
showSearch={false}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
{/* Action Buttons Integrated */}
|
||||||
|
<div className="md:col-span-3 flex items-center gap-2">
|
||||||
|
<Button
|
||||||
|
variant="outline"
|
||||||
|
onClick={handleClearFilters}
|
||||||
|
className="flex-1 items-center gap-2 button-outlined-primary h-9"
|
||||||
|
>
|
||||||
|
<RotateCcw className="h-4 w-4" />
|
||||||
|
重置
|
||||||
|
</Button>
|
||||||
|
<Button
|
||||||
|
onClick={handleFilter}
|
||||||
|
className="flex-1 button-filled-primary h-9 gap-2"
|
||||||
|
>
|
||||||
|
<Filter className="h-4 w-4" /> 查詢
|
||||||
|
</Button>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Results Table */}
|
||||||
|
<div className="bg-white rounded-xl border border-gray-200 shadow-sm overflow-hidden">
|
||||||
|
<Table>
|
||||||
|
<TableHeader className="bg-gray-50">
|
||||||
|
<TableRow>
|
||||||
|
<TableHead className="w-[120px] cursor-pointer" onClick={() => handleSort('products.code')}>
|
||||||
|
<div className="flex items-center">商品代碼 <SortIcon field="products.code" /></div>
|
||||||
|
</TableHead>
|
||||||
|
<TableHead className="cursor-pointer" onClick={() => handleSort('products.name')}>
|
||||||
|
<div className="flex items-center">商品名稱 <SortIcon field="products.name" /></div>
|
||||||
|
</TableHead>
|
||||||
|
<TableHead className="w-[100px]">分類</TableHead>
|
||||||
|
<TableHead className="text-right w-[100px] cursor-pointer" onClick={() => handleSort('current_stock')}>
|
||||||
|
<div className="flex items-center justify-end">現有庫存 <SortIcon field="current_stock" /></div>
|
||||||
|
</TableHead>
|
||||||
|
<TableHead className="text-right w-[100px] cursor-pointer" onClick={() => handleSort('sales_30d')}>
|
||||||
|
<div className="flex items-center justify-end">30天銷量 <SortIcon field="sales_30d" /></div>
|
||||||
|
</TableHead>
|
||||||
|
<TableHead className="text-right w-[120px] cursor-pointer" onClick={() => handleSort('turnover_days')}>
|
||||||
|
<div className="flex items-center justify-end">週轉天數 <SortIcon field="turnover_days" /></div>
|
||||||
|
</TableHead>
|
||||||
|
<TableHead className="text-right w-[120px] cursor-pointer" onClick={() => handleSort('last_sale_date')}>
|
||||||
|
<div className="flex items-center justify-end">最後銷售 <SortIcon field="last_sale_date" /></div>
|
||||||
|
</TableHead>
|
||||||
|
<TableHead className="w-[100px] text-center">狀態</TableHead>
|
||||||
|
</TableRow>
|
||||||
|
</TableHeader>
|
||||||
|
<TableBody>
|
||||||
|
{analysisData.data.length === 0 ? (
|
||||||
|
<TableRow>
|
||||||
|
<TableCell colSpan={8}>
|
||||||
|
<div className="flex flex-col items-center justify-center space-y-2 py-8 text-gray-400">
|
||||||
|
<Package className="h-10 w-10 opacity-20" />
|
||||||
|
<p>無符合條件的資料</p>
|
||||||
|
</div>
|
||||||
|
</TableCell>
|
||||||
|
</TableRow>
|
||||||
|
) : (
|
||||||
|
analysisData.data.map((row) => (
|
||||||
|
<TableRow key={row.id} className="hover:bg-gray-50/50 transition-colors">
|
||||||
|
<TableCell className="font-medium text-gray-900">
|
||||||
|
{row.code}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-gray-700">
|
||||||
|
{row.name}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-gray-500">{row.category_name || '-'}</TableCell>
|
||||||
|
<TableCell className="text-right font-medium">
|
||||||
|
{Number(row.current_stock).toLocaleString()}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-right text-gray-600">
|
||||||
|
{Number(row.sales_30d).toLocaleString()}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-right font-bold text-gray-800">
|
||||||
|
{row.turnover_days_display}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-right text-gray-500 text-sm">
|
||||||
|
{row.last_sale_date ? row.last_sale_date.split(' ')[0] : '從未銷售'}
|
||||||
|
</TableCell>
|
||||||
|
<TableCell className="text-center">
|
||||||
|
<StatusBadge variant={getStatusVariant(row.status)}>
|
||||||
|
{getStatusLabel(row.status)}
|
||||||
|
</StatusBadge>
|
||||||
|
</TableCell>
|
||||||
|
</TableRow>
|
||||||
|
))
|
||||||
|
)}
|
||||||
|
</TableBody>
|
||||||
|
</Table>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Pagination Footer */}
|
||||||
|
<div className="mt-6 flex flex-col sm:flex-row items-start sm:items-center justify-between gap-4">
|
||||||
|
<div className="flex items-center gap-2 text-sm text-gray-500">
|
||||||
|
<span>每頁顯示</span>
|
||||||
|
<SearchableSelect
|
||||||
|
value={perPage}
|
||||||
|
onValueChange={handlePerPageChange}
|
||||||
|
options={[
|
||||||
|
{ label: "10", value: "10" },
|
||||||
|
{ label: "20", value: "20" },
|
||||||
|
{ label: "50", value: "50" },
|
||||||
|
{ label: "100", value: "100" }
|
||||||
|
]}
|
||||||
|
className="w-[100px] h-8"
|
||||||
|
showSearch={false}
|
||||||
|
/>
|
||||||
|
<span>筆</span>
|
||||||
|
</div>
|
||||||
|
<div className="w-full sm:w-auto flex justify-center sm:justify-end">
|
||||||
|
<Pagination links={analysisData.links} />
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</AuthenticatedLayout>
|
||||||
|
);
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user