Repo rebuild

2026-09-15 12:33:28 +01:00
commit be28c4feec
5629 changed files with 317074 additions and 0 deletions
@@ -0,0 +1,126 @@
+<?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\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Country extends Model
+{
+    use HasFactory;
+    use SoftDeletes;
+
+    /** @var list<string> */
+    protected $fillable = [
+        'alpha2',
+        'alpha3',
+        'numeric',
+        'name',
+        'official_name',
+        'common_name',
+        'display_name',
+        'native_name',
+        'capital',
+        'flag_emoji',
+        'calling_code',
+        'tld',
+        'currency_code',
+        'currency_name',
+        'currency_symbol',
+        'languages',
+        'timezones',
+        'latitude',
+        'longitude',
+        'flag_svg_url',
+        'flag_png_url',
+        'ioc_code',
+        'fifa_code',
+        'postal_code_format',
+        'address_format',
+        'is_active',
+        'iso_status',
+        'independent',
+        'sovereignty_status',
+        'un_member',
+        'continent',
+        'region',
+        'subregion',
+        'intermediate_region',
+        'sort_order',
+        'last_synced_at',
+        'source',
+        'source_version',
+        'metadata',
+    ];
+
+    /** @var array<string, string> */
+    protected $casts = [
+        'is_active' => 'boolean',
+        'independent' => 'boolean',
+        'un_member' => 'boolean',
+        'sort_order' => 'integer',
+        'last_synced_at' => 'datetime',
+        'languages' => 'array',
+        'timezones' => 'array',
+        'metadata' => 'array',
+        'latitude' => 'decimal:7',
+        'longitude' => 'decimal:7',
+    ];
+
+    /**
+     * Use ISO 3166-1 alpha-2 for route model binding.
+     */
+    public function getRouteKeyName(): string
+    {
+        return 'alpha2';
+    }
+
+    /**
+     * Effective display name used throughout WMS selectors and pages.
+     */
+    public function getEffectiveNameAttribute(): string
+    {
+        return $this->display_name ?: $this->common_name ?: $this->name;
+    }
+
+    /**
+     * ISO 3166-2 subdivisions belonging to this country.
+     */
+    public function subdivisions(): HasMany
+    {
+        return $this->hasMany(CountrySubdivision::class);
+    }
+
+    /**
+     * Resolve a country from alpha-2, alpha-3 or numeric ISO 3166-1 code.
+     */
+    public function scopeForIsoCode(Builder $query, string $code): Builder
+    {
+        $normalised = strtoupper(trim($code));
+
+        return $query->where(function (Builder $nested) use ($normalised): void {
+            $nested->where('alpha2', $normalised)
+                ->orWhere('alpha3', $normalised)
+                ->orWhere('numeric', str_pad($normalised, 3, '0', STR_PAD_LEFT));
+        });
+    }
+
+    /**
+     * Scope active countries for business selectors.
+     */
+    public function scopeActive(Builder $query): Builder
+    {
+        return $query->where('is_active', true);
+    }
+
+    /**
+     * Scope ordered countries for UI lists.
+     */
+    public function scopeOrdered(Builder $query): Builder
+    {
+        return $query->orderBy('sort_order')->orderBy('name');
+    }
+}