sky121113
c343df34ee
All checks were successful
star-cloud-deploy-demo / deploy-demo (push) Successful in 58s
1. 實作 B012 API：新增 /api/v1/app/machine/products/B012 端點，支援 GET (全量) 與 PATCH (增量) 同步邏輯。 2. 統一圖片 URL：在 B005 與 B012 API 中使用 asset() 確保回傳絕對網址 (Absolute URL)，解決 App 端下載相對路徑的問題。 3. 文件更新：同步更新 SKILL.md 的欄位定義，並在 api-docs.php 補上 B012 的正式規格說明。 4. 資料庫變更：新增 machine_slots 表的 type 欄位與相關註解遷移。 5. 格式優化：為技術規格文件中的 API 欄位與狀態碼加上反引號，提升文件中心可讀性。
94 lines
2.4 KiB
PHP
94 lines
2.4 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');
|
|
}
|
|
}
|