++ gruppi di servizio: sorvegliante con utenza limitata, pacchetto di territori, assegnazione ai membri

Il gruppo ha un sorvegliante (proclamatore con utenza: email e password
temporanea, senza conferma dell'email) e dei membri; l'amministratore
mette in blocco dei territori nel pacchetto del gruppo. Il pacchetto non
e' un'assegnazione e non tocca le statistiche; quando il sorvegliante da'
un territorio a un membro nasce un'assegnazione normale con
gruppo_servizio_id. Al rientro il territorio torna in reparto. Sciogliere
il gruppo libera pacchetto e membri e disattiva l'utenza.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

app/Models/GruppoServizio.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Spatie\Activitylog\LogOptions;
+use Spatie\Activitylog\Traits\LogsActivity;
+
+/**
+ * Gruppo di servizio: un sorvegliante (proclamatore con un'utenza limitata
+ * al gruppo), i membri (proclamatori, un solo gruppo a testa) e un pacchetto
+ * di territori che il sorvegliante distribuisce ai membri.
+ *
+ * Il pacchetto non è un'assegnazione: un territorio del pacchetto non ancora
+ * dato a nessuno è "in carico al gruppo" e non entra nelle statistiche. Quando
+ * il sorvegliante lo dà a un membro nasce un'assegnazione normale, con
+ * gruppo_servizio_id per dire da dove viene. Al rientro il territorio torna in
+ * reparto ed esce dal pacchetto.
+ *
+ * Un gruppo sciolto (sciolto_at) non ha più membri né pacchetto, ma resta: le
+ * assegnazioni nate da lui continuano a citarlo. Logica in
+ * App\Services\GruppiServizio.
+ */
+class GruppoServizio extends Model
+{
+    use LogsActivity;
+
+    protected $table = 'gruppi_servizio';
+
+    protected $fillable = ['nome', 'sorvegliante_id', 'sciolto_at'];
+
+    protected function casts(): array
+    {
+        return ['sciolto_at' => 'datetime', 'sorvegliante_id' => 'integer'];
+    }
+
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()
+            ->logOnly(['nome', 'sorvegliante_id', 'sciolto_at'])
+            ->logOnlyDirty()
+            ->dontSubmitEmptyLogs();
+    }
+
+    public function sorvegliante()
+    {
+        return $this->belongsTo(Proclamatore::class, 'sorvegliante_id')->withTrashed();
+    }
+
+    public function membri()
+    {
+        return $this->hasMany(Proclamatore::class, 'gruppo_servizio_id');
+    }
+
+    /** Il pacchetto: i territori in carico al gruppo, dati o non ancora dati. */
+    public function territori()
+    {
+        return $this->hasMany(Territorio::class, 'gruppo_servizio_id');
+    }
+
+    public function assegnazioni()
+    {
+        return $this->hasMany(Assegnazione::class, 'gruppo_servizio_id');
+    }
+
+    public function getScioltoAttribute(): bool
+    {
+        return $this->sciolto_at !== null;
+    }
+
+    public function scopeAttivi($query)
+    {
+        return $query->whereNull('sciolto_at');
+    }
+}