license: built full stack, test and documentation

2026-07-03 12:47:47 +02:00
parent f8206b5840
commit 271acacb1d
39 changed files with 4078 additions and 57 deletions
--- a/backend/app/Models/Lists/License.php
+++ b/backend/app/Models/Lists/License.php
@@ -0,0 +1,99 @@
+<?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;
+    }
+}