100 lines
2.6 KiB
PHP
100 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace App\Models\Lists;
|
|
|
|
use App\Enums\LicenseKind;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use OwenIt\Auditing\Auditable as AuditableTrait;
|
|
use OwenIt\Auditing\Contracts\Auditable;
|
|
|
|
/**
|
|
* Vocabolario delle licenze per record (artifact/model) e media.
|
|
*
|
|
* Tabella controllata, popolata dal LicenseSeeder in installazione (non
|
|
* dall'ETL). Gli id 1-3 sono FISSI e coincidono con il DB legacy (v1:
|
|
* 1=Public Domain, 2=CC0, 3=CC BY) così l'ETL mapperà le FK dei contenuti
|
|
* 1:1 senza tradurre.
|
|
*
|
|
* Il ritiro di una licenza si fa con `active = false` (le select dei form la
|
|
* nascondono), mai cancellando la riga: i contenuti già licenziati la
|
|
* referenziano.
|
|
*/
|
|
class License extends Model implements Auditable
|
|
{
|
|
use AuditableTrait;
|
|
use HasFactory;
|
|
|
|
protected $fillable = [
|
|
'name',
|
|
'acronym',
|
|
'spdx_id',
|
|
'kind',
|
|
'description',
|
|
'uri',
|
|
'file',
|
|
'for_record',
|
|
'for_media',
|
|
'sort_order',
|
|
'active',
|
|
];
|
|
|
|
/**
|
|
* @return array<string, string>
|
|
*/
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'kind' => LicenseKind::class,
|
|
'for_record' => 'boolean',
|
|
'for_media' => 'boolean',
|
|
'sort_order' => 'integer',
|
|
'active' => 'boolean',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Licenze ammesse per i record (artifact/model): solo quelle aperte.
|
|
*
|
|
* @param Builder<License> $query
|
|
*/
|
|
public function scopeForRecord(Builder $query): void
|
|
{
|
|
$query->where('for_record', true);
|
|
}
|
|
|
|
/**
|
|
* Licenze ammesse per i media (immagini, documenti, video, modelli 3D).
|
|
*
|
|
* @param Builder<License> $query
|
|
*/
|
|
public function scopeForMedia(Builder $query): void
|
|
{
|
|
$query->where('for_media', true);
|
|
}
|
|
|
|
/**
|
|
* Solo le licenze attive (proposte nei form di inserimento/modifica).
|
|
*
|
|
* @param Builder<License> $query
|
|
*/
|
|
public function scopeActive(Builder $query): void
|
|
{
|
|
$query->where('active', true);
|
|
}
|
|
|
|
/**
|
|
* La licenza è assegnata ad almeno un contenuto.
|
|
*
|
|
* NB: oggi nessuna tabella referenzia `licenses`, quindi nessuna riga
|
|
* risulta in uso; quando arriveranno le tabelle di artifact/model/media
|
|
* (con FK su `licenses`) questo metodo dovrà controllarne l'esistenza,
|
|
* come fa InstitutionCategory::isInUse().
|
|
*/
|
|
public function isInUse(): bool
|
|
{
|
|
return false;
|
|
}
|
|
}
|