Files
WMS/Modules/Countries/Models/CountrySubdivision.php
2026-09-21 10:14:57 +01:00

72 lines
1.5 KiB
PHP
Executable File

<?php
namespace Modules\Countries\Models;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
class CountrySubdivision extends Model
{
use HasFactory;
/** @var list<string> */
protected $fillable = [
'country_id',
'country_alpha2',
'code',
'subdivision_code',
'name',
'local_name',
'type',
'is_active',
'iso_status',
'sort_order',
'last_synced_at',
'source',
'source_version',
'metadata',
];
/** @var array<string, string> */
protected $casts = [
'is_active' => 'boolean',
'sort_order' => 'integer',
'last_synced_at' => 'datetime',
'metadata' => 'array',
];
/**
* Use the ISO 3166-2 code for route model binding.
*/
public function getRouteKeyName(): string
{
return 'code';
}
/**
* Parent ISO 3166-1 country.
*/
public function country(): BelongsTo
{
return $this->belongsTo(Country::class);
}
/**
* Scope active subdivisions.
*/
public function scopeActive(Builder $query): Builder
{
return $query->where('is_active', true);
}
/**
* Scope ordered subdivisions for selectors and administration screens.
*/
public function scopeOrdered(Builder $query): Builder
{
return $query->orderBy('sort_order')->orderBy('name');
}
}