feat: integrate Draco compression for 3D models in backoffice

- Added support for uploading and compressing GLB models using Draco in the backoffice.
- Implemented commands for importing and re-compressing 3D models.
- Updated model resource to handle 3D model uploads and validations.
- Introduced a new script for compressing GLB files with Draco.
- Modified Vite configuration to remove GLB files from the build output.
- Updated package dependencies to include GLTF-transform libraries for handling 3D models.
- Added tests to ensure proper functionality of 3D model handling and compression.

backoffice/tests/Feature/CatalogoAdminTest.php

@@ -26,7 +26,7 @@ class CatalogoAdminTest extends TestCase
 
         Storage::fake('public');
         $this->seed(CatalogoSeeder::class);
-        $this->actingAs(User::factory()->create());
+        $this->actingAs(User::factory()->create(['is_superadmin' => true]));
     }
 
     public function test_le_pagine_admin_del_catalogo_si_aprono(): void
@@ -94,7 +94,7 @@ class CatalogoAdminTest extends TestCase
         Livewire::test(CreateModello::class)
             ->fillForm(['sistema_id' => $sistema, 'codice' => 'nuovo', 'nome' => 'Nuovo', 'attivo' => true])
             ->call('create')
-            ->assertHasFormErrors(['cartella' => 'required', 'file_modello' => 'required', 'categoria' => 'required']);
+            ->assertHasFormErrors(['cartella' => 'required', 'modello_3d_upload' => 'required', 'categoria' => 'required']);
 
         Livewire::test(CreateModello::class)
             ->fillForm(['sistema_id' => $sistema, 'codice' => 'finestra_1_anta', 'nome' => 'Doppione', 'attivo' => false])

backoffice/tests/Feature/CatalogoApiTest.php

@@ -53,6 +53,9 @@ class CatalogoApiTest extends TestCase
         // Senza listino il bilico non compare nel configuratore.
         Modello::where('codice', '!=', 'bilico')->each(fn (Modello $m) => ListinoPrezzo::create(['modello_id' => $m->id, 'larghezza' => 1000, 'altezza' => 1000, 'prezzo' => 100]));
         Sistema::create(['codice' => 'legno', 'nome' => 'Legno', 'attivo' => false]);
+        $this->conModelli3d();
+        // Senza modello 3D la finestra a 2 ante non compare nel configuratore.
+        Modello::where('codice', 'finestra_2_ante')->update(['modello_3d_draco' => null]);
 
         $response = $this->getJson('/api/sistemi')->assertOk();
 
@@ -60,12 +63,13 @@ class CatalogoApiTest extends TestCase
         $response->assertJsonPath('0.codice', 'pvc');
 
         $modelli = collect($response->json('0.modelli'));
-        $this->assertSame(25, $modelli->count());
+        $this->assertSame(24, $modelli->count());
         $this->assertNotContains('bilico', $modelli->pluck('id'));
+        $this->assertNotContains('finestra_2_ante', $modelli->pluck('id'));
         $this->assertSame('finestra_1_anta', $modelli->first()['id']);
         $this->assertNotContains('scorrevole_hst_4_ante', $modelli->pluck('id'));
         $this->assertStringEndsWith('/storage/modelli/icone/pvc/finestra_1_anta.jpg', $modelli->first()['icona']);
-        $this->assertSame('finestra_1_anta.glb', $modelli->first()['modello']);
+        $this->assertStringEndsWith('/api/media/modelli-3d/draco/test.glb', $modelli->first()['modello_url']);
     }
 
     public function test_configurazione_di_un_modello_senza_listino_restituisce_404(): void

backoffice/tests/Feature/ConfiguratoreAdminTest.php

@@ -37,7 +37,7 @@ class ConfiguratoreAdminTest extends TestCase
 
         Storage::fake('public');
         $this->seed([CatalogoSeeder::class, ConfiguratoreSeeder::class, ProfiliExtraSeeder::class, NuoveOpzioniSeeder::class]);
-        $this->actingAs(User::factory()->create());
+        $this->actingAs(User::factory()->create(['is_superadmin' => true]));
     }
 
     public function test_le_pagine_del_configuratore_si_aprono(): void

backoffice/tests/Feature/ConfiguratorePrezzoTest.php

@@ -30,6 +30,7 @@ class ConfiguratorePrezzoTest extends TestCase
 
         Storage::fake('public');
         $this->seed([CatalogoSeeder::class, ConfiguratoreSeeder::class, ProfiliExtraSeeder::class, NuoveOpzioniSeeder::class]);
+        $this->conModelli3d();
     }
 
     /** Listino 1000-1400 x 1200-1400 mm: la cella 1200 x 1400 vale BASE. */

backoffice/tests/Feature/ImportazioneListiniTest.php

@@ -33,7 +33,7 @@ class ImportazioneListiniTest extends TestCase
         Storage::fake('public');
         $this->seed(CatalogoSeeder::class);
         $this->pvc = Sistema::where('codice', 'pvc')->firstOrFail();
-        $this->actingAs(User::factory()->create());
+        $this->actingAs(User::factory()->create(['is_superadmin' => true]));
     }
 
     /** Due tabelle nel formato del listino, separate da una riga vuota. */
@@ -220,6 +220,7 @@ class ImportazioneListiniTest extends TestCase
     {
         $finestra = Modello::where('codice', 'finestra_1_anta')->firstOrFail();
         ListinoImporter::importa($this->pvc, ListinoExcelParser::parseRighe($this->righe()), ['finestra_1_anta' => $finestra->id]);
+        $this->conModelli3d();
 
         $this->getJson('/api/sistemi/pvc/modelli/finestra_1_anta/listino')
             ->assertOk()

backoffice/tests/Feature/Modelli3dTest.php

@@ -0,0 +1,186 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Filament\Resources\ModelloResource\Pages\EditModello;
+use App\Models\ListinoPrezzo;
+use App\Models\Modello;
+use App\Models\User;
+use App\Support\Configuratore\CompressoreGlb;
+use App\Support\Configuratore\Modelli3d;
+use Database\Seeders\CatalogoSeeder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Storage;
+use Livewire\Livewire;
+use Tests\TestCase;
+
+class Modelli3dTest extends TestCase
+{
+    use RefreshDatabase;
+
+    private Modello $finestra;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        Storage::fake('public');
+        Storage::fake('local');
+        $this->seed(CatalogoSeeder::class);
+        $this->actingAs(User::factory()->create(['is_superadmin' => true]));
+
+        $this->finestra = Modello::where('codice', 'finestra_1_anta')->firstOrFail();
+        ListinoPrezzo::create(['modello_id' => $this->finestra->id, 'larghezza' => 1000, 'altezza' => 1000, 'prezzo' => 100]);
+
+        // Niente Node nei test: la "compressione" tiene i primi 16 byte del file.
+        $this->app->instance(CompressoreGlb::class, new class extends CompressoreGlb
+        {
+            public function comprimi(string $sorgente, string $destinazione): void
+            {
+                file_put_contents($destinazione, substr(file_get_contents($sorgente), 0, 16));
+            }
+        });
+    }
+
+    /** Intestazione GLB valida (magic, versione 2, lunghezza) seguita da $corpo. */
+    private function glb(string $corpo = 'geometria di prova'): string
+    {
+        return 'glTF'.pack('V', 2).pack('V', 12 + strlen($corpo)).$corpo;
+    }
+
+    private function carica(UploadedFile $file)
+    {
+        return Livewire::test(EditModello::class, ['record' => $this->finestra->getRouteKey()])
+            ->fillForm(['modello_3d_upload' => $file])
+            ->call('save');
+    }
+
+    public function test_il_caricamento_salva_originale_e_copia_draco(): void
+    {
+        $this->carica(UploadedFile::fake()->createWithContent('finestra.glb', $this->glb()))
+            ->assertHasNoFormErrors();
+
+        $this->finestra->refresh();
+        $this->assertSame('finestra.glb', $this->finestra->modello_3d_nome);
+        $this->assertStringStartsWith('modelli-3d/originali/pvc/finestra_1_anta-', $this->finestra->modello_3d);
+        $this->assertStringStartsWith('modelli-3d/draco/pvc/finestra_1_anta-', $this->finestra->modello_3d_draco);
+        $this->assertSame($this->glb(), Storage::disk('local')->get($this->finestra->modello_3d));
+        $this->assertSame(substr($this->glb(), 0, 16), Storage::disk('public')->get($this->finestra->modello_3d_draco));
+        $this->assertSame(strlen($this->glb()), $this->finestra->modello_3d_dimensione);
+        $this->assertSame(16, $this->finestra->modello_3d_draco_dimensione);
+
+        // La scheda mostra il modello attuale con le dimensioni prima/dopo.
+        Livewire::test(EditModello::class, ['record' => $this->finestra->getRouteKey()])
+            ->assertOk()
+            ->assertSee('finestra.glb')
+            ->assertSee('con Draco')
+            ->assertSee('Sostituisci modello 3D')
+            // callFormComponentAction() cerca la chiave sotto "data.", che un Placeholder non ha.
+            // Senza modale, il mount esegue subito l'azione.
+            ->call('mountFormComponentAction', 'modello_3d_attuale', 'scarica_originale')
+            ->assertFileDownloaded('finestra.glb');
+
+        // L'originale non è sul disco pubblico.
+        Storage::disk('public')->assertMissing($this->finestra->modello_3d);
+
+        // Il configuratore riceve l'URL della copia Draco, servita con CORS e cache lunga.
+        $modello = collect($this->getJson('/api/sistemi')->json('0.modelli'))->firstWhere('id', 'finestra_1_anta');
+        $this->assertSame($this->finestra->modello_3d_url, $modello['modello_url']);
+
+        $this->get($modello['modello_url'])
+            ->assertOk()
+            ->assertHeader('Content-Type', 'model/gltf-binary')
+            ->assertHeader('Cache-Control', 'immutable, max-age=31536000, public');
+    }
+
+    public function test_un_file_non_glb_e_rifiutato_senza_toccare_il_modello(): void
+    {
+        $this->carica(UploadedFile::fake()->createWithContent('finestra.glb', 'non sono un glb'))
+            ->assertHasFormErrors(['modello_3d_upload']);
+
+        $this->assertNull($this->finestra->refresh()->modello_3d);
+        $this->assertEmpty(Storage::disk('local')->allFiles('modelli-3d'));
+    }
+
+    public function test_una_compressione_fallita_annulla_il_salvataggio(): void
+    {
+        $this->app->instance(CompressoreGlb::class, new class extends CompressoreGlb
+        {
+            public function comprimi(string $sorgente, string $destinazione): void
+            {
+                throw new \App\Support\Configuratore\Modello3dNonValido('Compressione Draco non riuscita: test.');
+            }
+        });
+
+        Livewire::test(EditModello::class, ['record' => $this->finestra->getRouteKey()])
+            ->fillForm(['nome' => 'Nome cambiato', 'modello_3d_upload' => UploadedFile::fake()->createWithContent('f.glb', $this->glb())])
+            ->call('save')
+            ->assertHasFormErrors(['modello_3d_upload']);
+
+        $this->finestra->refresh();
+        $this->assertNull($this->finestra->modello_3d);
+        $this->assertNotSame('Nome cambiato', $this->finestra->nome);
+    }
+
+    public function test_sostituzione_ed_eliminazione_rimuovono_i_file_precedenti(): void
+    {
+        $servizio = app(Modelli3d::class);
+        $sorgente = tempnam(sys_get_temp_dir(), 'glb');
+
+        file_put_contents($sorgente, $this->glb('primo'));
+        $servizio->carica($this->finestra, $sorgente);
+        [$originale, $draco] = [$this->finestra->modello_3d, $this->finestra->modello_3d_draco];
+
+        file_put_contents($sorgente, $this->glb('secondo, diverso nei primi byte'));
+        $servizio->carica($this->finestra, $sorgente);
+        unlink($sorgente);
+
+        Storage::disk('local')->assertMissing($originale);
+        Storage::disk('public')->assertMissing($draco);
+        Storage::disk('local')->assertExists($this->finestra->modello_3d);
+
+        $this->finestra->delete();
+        Storage::disk('local')->assertMissing($this->finestra->modello_3d);
+        Storage::disk('public')->assertMissing($this->finestra->modello_3d_draco);
+    }
+
+    public function test_senza_modello_3d_il_modello_non_e_nel_configuratore(): void
+    {
+        $this->getJson('/api/sistemi/pvc/modelli/finestra_1_anta/configurazione')->assertNotFound();
+    }
+
+    public function test_il_comando_importa_i_glb_del_configuratore(): void
+    {
+        $cartella = sys_get_temp_dir().'/modelli-'.uniqid();
+        File::ensureDirectoryExists("{$cartella}/pvc");
+        file_put_contents("{$cartella}/pvc/finestra_1_anta.glb", $this->glb());
+
+        $this->artisan('modelli3d:importa', ['cartella' => $cartella])->assertSuccessful();
+        File::deleteDirectory($cartella);
+
+        $this->finestra->refresh();
+        $this->assertSame('finestra_1_anta.glb', $this->finestra->modello_3d_nome);
+        Storage::disk('public')->assertExists($this->finestra->modello_3d_draco);
+    }
+
+    public function test_compressione_draco_reale_con_node(): void
+    {
+        $script = config('configuratore.modelli_3d.script');
+        $celino = base_path('../src/assets/models/pvc/celino.glb');
+        if (! is_dir(dirname($script, 2).'/node_modules/@gltf-transform/core') || ! is_file($celino)) {
+            $this->markTestSkipped('Dipendenze Node o modello di prova non installati.');
+        }
+
+        $this->app->forgetInstance(CompressoreGlb::class);
+        $this->app->offsetUnset(CompressoreGlb::class);
+
+        app(Modelli3d::class)->carica($this->finestra, $celino);
+
+        $draco = Storage::disk('public')->get($this->finestra->modello_3d_draco);
+        $this->assertStringStartsWith('glTF', $draco);
+        $this->assertStringContainsString('KHR_draco_mesh_compression', $draco);
+        $this->assertLessThan(filesize($celino), strlen($draco));
+    }
+}