star-cloud/app/Models/System/UiElement.php

<?php

namespace App\Models\System;

use App\Traits\TenantScoped;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class UiElement extends Model
{
    use HasFactory, TenantScoped;

    protected $fillable = [
        'company_id',
        'part_key',
        'name',
        'type',
        'image_url',
        'is_active',
    ];

    protected $casts = [
        'is_active' => 'boolean',
    ];

    /**
     * 部位定義（來自 config/ui_parts.php）。
     */
    public function getPartAttribute(): ?array
    {
        return config("ui_parts.parts.{$this->part_key}");
    }

    /**
     * 部位顯示名稱。
     */
    public function getPartLabelAttribute(): string
    {
        return config("ui_parts.parts.{$this->part_key}.label", $this->part_key);
    }

    public function scopeActive($query)
    {
        return $query->where('is_active', true);
    }
}