feat(piatti): add custom display order support

Co-authored-by: Cursor <cursoragent@cursor.com>

app/DataTables/PiattoDataTable.php

             ->addColumn('prezzo_display', function ($entity) {
                 return '€ ' . number_format($entity->prezzo, 2, ',', '.');
             })
+            ->addColumn('ordine_visualizzazione_display', function ($entity) {
+                return Piatto::ordineVisualizzazioneImpostato($entity->ordine_visualizzazione)
+                    ? (string) (int) $entity->ordine_visualizzazione
+                    : '';
+            })
             ->setRowId('id');
     }
 
 
         if (isset($this->cucina_id)) {
             return $model->where('cucina_id', $this->cucina_id)
-                ->with('cucina', 'elencoAllergeni');
+                ->with('cucina', 'elencoAllergeni')
+                ->ordinatiInCassa();
         }
 
-        return $model->with('cucina', 'elencoAllergeni');
+        return $model->with('cucina', 'elencoAllergeni')->ordinatiInCassa();
     }
 
     /**
                     ->ajax(route('piatto.store'))
                     ->fields([
                         Fields\Hidden::make('attivita_id')->label('Attività')->default((int) $this->attivita_id),
+                        Fields\Number::make('ordine_visualizzazione')->label('Ordine visualizzazione'),
                         Fields\Text::make('nome')->label('Nome'),
                         Fields\Text::make('descrizione')->label('Descrizione'),
-                        Fields\Select2::make('cucina_id')->label('cucina')
+                        Fields\Select2::make('cucina_id')->label('Cucina')
                         ->options(Cucina::where('is_attiva', true)->where('attivita_id', (int) $this->attivita_id)->pluck('id', 'nome'))
                         ->default(isset($this->cucina_id) ? $this->cucina_id : ''),
                         Fields\Text::make('prezzo')->label('Prezzo (€)'),
         $columns = array_merge($columns, [
 
             Column::make('nome')->title('Nome')->searchable()->responsivePriority(1),
+            Column::make('ordine_visualizzazione')->data('ordine_visualizzazione_display')->title('Ordine')->addClass('text-center')->width('8%'),
             Column::make('prezzo')->data('prezzo_display')->title('Prezzo')->addClass('text-center'),
             // Column::computed('cucina_id')->data('cucina_id_display')->title('Cucina')->addClass('text-center')->responsivePriority(2), // icona in tabella
             Column::make('allergeni')->title('Allergeni')->visible(false), // valore grezzo per l'editor (array ID)

app/DataTables/PiattoDataTableEditor.php

 use App\Models\Cucina;
 use App\Models\Piatto;
 use App\Models\PiattoHasAllergene;
+use App\Models\RigaOrdine;
+use App\Models\SaltacodaRigaOrdine;
 use App\Services\Attivita\AttivitaService;
 use Illuminate\Database\Eloquent\Model;
 use Yajra\DataTables\DataTablesEditor;
 use Illuminate\Support\Facades\Session;
+use Illuminate\Validation\ValidationException;
 
 class PiattoDataTableEditor extends DataTablesEditor
 {
     'bacheca_id.required' => 'Indicare una delle due opzioni',
     'in_evidenza.required' => 'Indicare una delle due opzioni',
     'cucina_id.required' => 'La cucina è richiesta',
+    'ordine_visualizzazione.required' => 'Per ordine alfabetico scrivi 0 altrimenti imposta posizione ',
   ];
 
   /**
       'allergeni.*' => 'integer|exists:allergene,id',
       'bacheca_id' => 'nullable|boolean',
       'in_evidenza' => 'nullable|boolean',
+      'ordine_visualizzazione' => 'required|integer',
     ];
   }
 
       'allergeni.*' => 'integer|exists:allergene,id',
       'bacheca_id' => 'nullable|boolean',
       'in_evidenza' => 'nullable|boolean',
+      'ordine_visualizzazione' => 'nullable|integer',
     ];
   }
 
     $data['bacheca_id'] = isset($data['bacheca_id']) ? true : false;
     $data['in_evidenza'] = isset($data['in_evidenza']) ? true : false;
     $data['is_attivo'] = isset($data['is_attivo']) ? true : false;
+    $data['ordine_visualizzazione'] = $this->normalizeOrdineVisualizzazione($data['ordine_visualizzazione'] ?? null);
     return $data;
   }
 
     $data['bacheca_id'] = isset($data['bacheca_id']) ? true : false;
     $data['in_evidenza'] = isset($data['in_evidenza']) ? true : false;
     $data['is_attivo'] = isset($data['is_attivo']) ? true : false;
+    $data['ordine_visualizzazione'] = $this->normalizeOrdineVisualizzazione($data['ordine_visualizzazione'] ?? null);
 
     return $data;
   }
   {
     AttivitaService::garantisciAttivita($model->attivita_id);
 
-    return $data;
+      $usatoInOrdini = RigaOrdine::where('piatto_id', $model->id)->exists();
+      $usatoInSaltacoda = SaltacodaRigaOrdine::where('piatto_id', $model->id)->exists();
+        if ($usatoInOrdini || $usatoInSaltacoda) {
+            throw ValidationException::withMessages([
+                'piatto' => 'Non puoi eliminare questo piatto: è già presente in ordini o preordini. Modifica la disponiblità invece.',
+            ]);
+        }
+        return $data;
+  }
+
+  private function normalizeOrdineVisualizzazione(mixed $value): ?int
+  {
+    if ($value === null || $value === '' || (int) $value === 0) {
+      return null;
+    }
+
+    return (int) $value;
   }
 
   private function garantisciCucinaDiQuestaAttivita($cucinaId, $attivitaId): void

app/Models/AbstractModels/AbstractPiatto.php

         'allergeni' => 'string',
         'bacheca_id' => 'boolean',
         'in_evidenza' => 'boolean',
+        'ordine_visualizzazione' => 'integer',
         'created_at' => 'datetime',
         'updated_at' => 'datetime'
     ];
         'allergeni',
         'bacheca_id',
         'in_evidenza',
+        'ordine_visualizzazione',
         'created_at',
         'updated_at'
     ];

app/Models/Piatto.php

             'allergene_id'
         );
     }
+
+    /**
+     * NULL e 0 = non impostato. Il cast integer trasforma NULL in 0 in lettura.
+     */
+    public static function ordineVisualizzazioneImpostato(mixed $valore): bool
+    {
+        return $valore !== null && $valore !== '' && (int) $valore !== 0;
+    }
+
+    public function scopeOrdinatiInCassa($query)
+    {
+        return $query
+            ->orderByRaw('(ordine_visualizzazione IS NULL OR ordine_visualizzazione = 0) ASC')
+            ->orderBy('ordine_visualizzazione')
+            ->orderBy('nome');
+    }
+
+    /**
+     * Tutti i piatti numerati → ordine in cassa. Altrimenti alfabetico.
+     */
+    public static function ordinaCollezioneInCassa($piatti)
+    {
+        $piatti = collect($piatti);
+        $tuttiNumerati = $piatti->isNotEmpty()
+            && $piatti->every(fn ($piatto) => static::ordineVisualizzazioneImpostato($piatto->ordine_visualizzazione));
+
+        if ($tuttiNumerati) {
+            return $piatti->sortBy([
+                ['ordine_visualizzazione', 'asc'],
+                ['nome', 'asc'],
+            ])->values();
+        }
+
+        return $piatti
+            ->sortBy(fn ($piatto) => mb_strtolower((string) ($piatto->nome ?? '')), SORT_NATURAL)
+            ->values();
+    }
 }

database/migrations/2026_09_01_223138_add_ordine_visualizzazione_to_piatto_table.php

+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('piatto', function (Blueprint $table) {
+            $table->integer('ordine_visualizzazione')
+                ->default(0)
+                ->nullable()
+                ->after('in_evidenza');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('piatto', function (Blueprint $table) {
+            $table->dropColumn('ordine_visualizzazione');
+        });
+    }
+};