39a246d3c5
1. 實作「目前庫存」矩陣化視圖：將商品作為行、倉庫作為列，支援跨倉庫水位分析與自動加總。 2. 優化矩陣 UI：實作固定欄位 (Sticky Columns) 以應對多倉庫場景，並修正深色模式下的背景色對齊問題。 3. 強化倉儲操作驗證：實作調撥與補貨單的 Alpine.js 前端欄位驗證與 AJAX 提交邏輯，提升操作流暢度。 4. 優化機台地址定位：實作結構化地址解析與 Nominatim API 對接，提升經緯度自動獲取的準確性。 5. 標準化 UI 組件：更新 Breadcrumbs、刪除確認彈窗與搜尋下拉選單，確保全站視覺一致性。 6. 完善多語系支援：補全倉儲管理、機台設定與 UI 提示的繁體中文翻譯。 7. 增加 Product Model 的 stocks() 關聯，支援高效率的庫存矩陣查詢。
102 lines
2.5 KiB
PHP
102 lines
2.5 KiB
PHP
<?php
|
|
|
|
namespace App\Models\Product;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\SoftDeletes;
|
|
use App\Traits\TenantScoped;
|
|
|
|
class Product extends Model
|
|
{
|
|
use HasFactory, SoftDeletes, TenantScoped;
|
|
|
|
/**
|
|
* Scope a query to only include active products.
|
|
*/
|
|
public function scopeActive($query)
|
|
{
|
|
return $query->where('is_active', true);
|
|
}
|
|
|
|
protected $fillable = [
|
|
'company_id',
|
|
'category_id',
|
|
'name',
|
|
'name_dictionary_key',
|
|
'barcode',
|
|
'spec',
|
|
'manufacturer',
|
|
'description',
|
|
'price',
|
|
'member_price',
|
|
'cost',
|
|
'track_limit',
|
|
'spring_limit',
|
|
'type',
|
|
'image_url',
|
|
'status',
|
|
'is_active',
|
|
'metadata',
|
|
];
|
|
|
|
protected $casts = [
|
|
'price' => 'decimal:2',
|
|
'member_price' => 'decimal:2',
|
|
'cost' => 'decimal:2',
|
|
'track_limit' => 'integer',
|
|
'spring_limit' => 'integer',
|
|
'is_active' => 'boolean',
|
|
'metadata' => 'array',
|
|
];
|
|
|
|
public function category()
|
|
{
|
|
return $this->belongsTo(ProductCategory::class, 'category_id');
|
|
}
|
|
|
|
/**
|
|
* 自動附加到 JSON/陣列輸出的屬性（供 Alpine.js 等前端使用）
|
|
*/
|
|
protected $appends = ['localized_name'];
|
|
|
|
/**
|
|
* 取得當前語系的商品名稱。
|
|
* 回退順序：當前語系 → zh_TW → name 欄位
|
|
*/
|
|
public function getLocalizedNameAttribute(): string
|
|
{
|
|
if ($this->relationLoaded('translations') && $this->translations->isNotEmpty()) {
|
|
$locale = app()->getLocale();
|
|
// 先找當前語系
|
|
$translation = $this->translations->firstWhere('locale', $locale);
|
|
if ($translation) {
|
|
return $translation->value;
|
|
}
|
|
// 回退至 zh_TW
|
|
$fallback = $this->translations->firstWhere('locale', 'zh_TW');
|
|
if ($fallback) {
|
|
return $fallback->value;
|
|
}
|
|
}
|
|
return $this->name ?? '';
|
|
}
|
|
|
|
/**
|
|
* Get the translations for the product name.
|
|
*/
|
|
public function translations()
|
|
{
|
|
return $this->hasMany(\App\Models\System\Translation::class, 'key', 'name_dictionary_key')
|
|
->where('group', 'product');
|
|
}
|
|
|
|
/**
|
|
* 倉庫庫存紀錄
|
|
*/
|
|
public function stocks()
|
|
{
|
|
return $this->hasMany(\App\Models\Warehouse\WarehouseStock::class);
|
|
}
|
|
}
|