101 lines
2.5 KiB
PHP
101 lines
2.5 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use App\Models\Lists\InstitutionCategory;
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
use Illuminate\Database\Eloquent\SoftDeletes;
|
|
use Illuminate\Support\Str;
|
|
use OwenIt\Auditing\Auditable as AuditableTrait;
|
|
use OwenIt\Auditing\Contracts\Auditable;
|
|
|
|
class Institution extends Model implements Auditable
|
|
{
|
|
use AuditableTrait;
|
|
use HasFactory;
|
|
use SoftDeletes;
|
|
|
|
protected $fillable = [
|
|
'category_id',
|
|
'name',
|
|
'abbreviation',
|
|
'address',
|
|
'city',
|
|
'lat',
|
|
'lon',
|
|
'logo',
|
|
'color',
|
|
'is_storage_place',
|
|
'legacy_id',
|
|
];
|
|
|
|
/**
|
|
* Identificatore esterno stabile, esposto nelle rotte pubbliche/LOD e usato
|
|
* come token nei canonical URI Linked Art. NON fillable: generato qui sotto
|
|
* (o impostato esplicitamente dall'ETL), mai via mass assignment.
|
|
*/
|
|
protected static function booted(): void
|
|
{
|
|
static::creating(function (Institution $institution): void {
|
|
if (empty($institution->uuid)) {
|
|
$institution->uuid = (string) Str::orderedUuid();
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @return array<string, string>
|
|
*/
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'category_id' => 'integer',
|
|
'lat' => 'float',
|
|
'lon' => 'float',
|
|
'is_storage_place' => 'boolean',
|
|
'legacy_id' => 'integer',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* La rotta pubblica risolve per uuid, non per id auto-increment.
|
|
*/
|
|
public function getRouteKeyName(): string
|
|
{
|
|
return 'uuid';
|
|
}
|
|
|
|
/**
|
|
* Categoria dell'istituzione.
|
|
*
|
|
* @return BelongsTo<InstitutionCategory, $this>
|
|
*/
|
|
public function category(): BelongsTo
|
|
{
|
|
return $this->belongsTo(InstitutionCategory::class, 'category_id');
|
|
}
|
|
|
|
/**
|
|
* Risorse web collegate (sito ufficiale, ticketing, social, ...).
|
|
*
|
|
* @return HasMany<InstitutionLink, $this>
|
|
*/
|
|
public function links(): HasMany
|
|
{
|
|
return $this->hasMany(InstitutionLink::class);
|
|
}
|
|
|
|
/**
|
|
* Storico delle affiliazioni (staff) di questa istituzione.
|
|
*
|
|
* @return HasMany<UserAffiliation, $this>
|
|
*/
|
|
public function affiliations(): HasMany
|
|
{
|
|
return $this->hasMany(UserAffiliation::class);
|
|
}
|
|
}
|