Fix acqua views and expose millesimi ordering

app/Filament/Pages/Condomini/LettureServiziArchivio.php

@@ -69,6 +69,18 @@ public function mount(): void
         $scope                = strtolower(trim((string) request()->query('scope', 'active')));
         $this->archivioScope  = in_array($scope, ['active', 'all'], true) ? $scope : 'active';
 
+        $user = Auth::user();
+        if ($this->servizioFilter && $user instanceof User) {
+            $serviceStabileId = StabileServizio::query()
+                ->whereKey((int) $this->servizioFilter)
+                ->value('stabile_id');
+
+            $activeStabileId = StabileContext::resolveActiveStabileId($user);
+            if (is_numeric($serviceStabileId) && (int) $serviceStabileId > 0 && (int) $activeStabileId > 0 && (int) $serviceStabileId !== (int) $activeStabileId) {
+                $this->archivioScope = 'all';
+            }
+        }
+
         $this->mountInteractsWithTable();
     }
 
@@ -313,8 +325,8 @@ public function table(Table $table): Table
                     ->color(function ($state, StabileServizioLettura $record): string {
                         return match ((string) data_get($record->raw, 'consistency_check.status', '')) {
                             'warning' => 'warning',
-                            'danger' => 'danger',
-                            default => 'gray',
+                            'danger'  => 'danger',
+                            default   => 'gray',
                         };
                     })
                     ->wrap()
@@ -588,15 +600,15 @@ public function table(Table $table): Table
                         TextInput::make('rilevatore_nome')->label('Nominativo rilevatore')->maxLength(191),
                         Textarea::make('motivo')->label('Nota riassegnazione')->rows(3)->maxLength(1000),
                     ])
-                    ->fillForm(fn(StabileServizioLettura $record): array => [
+                    ->fillForm(fn(StabileServizioLettura $record): array=> [
                         'unita_immobiliare_id' => $record->unita_immobiliare_id,
                         'rilevatore_tipo'      => (string) ($record->rilevatore_tipo ?? ''),
                         'rilevatore_nome'      => (string) ($record->rilevatore_nome ?? ''),
                         'motivo'               => '',
                     ])
                     ->action(function (StabileServizioLettura $record, array $data): void {
-                        $raw = is_array($record->raw ?? null) ? $record->raw : [];
-                        $reassignments = is_array($raw['reassignments'] ?? null) ? $raw['reassignments'] : [];
+                        $raw             = is_array($record->raw ?? null) ? $record->raw : [];
+                        $reassignments   = is_array($raw['reassignments'] ?? null) ? $raw['reassignments'] : [];
                         $reassignments[] = [
                             'from_unita_immobiliare_id' => (int) ($record->getOriginal('unita_immobiliare_id') ?? 0) ?: null,
                             'to_unita_immobiliare_id'   => (int) ($data['unita_immobiliare_id'] ?? 0) ?: null,
@@ -606,7 +618,7 @@ public function table(Table $table): Table
                             'changed_by'                => Auth::id(),
                             'changed_at'                => now()->toIso8601String(),
                         ];
-                        $raw['reassignments'] = $reassignments;
+                        $raw['reassignments']     = $reassignments;
                         $raw['reader_assignment'] = [
                             'user_id' => null,
                             'name'    => trim((string) ($data['rilevatore_nome'] ?? '')) ?: null,
@@ -614,12 +626,12 @@ public function table(Table $table): Table
                         ];
 
                         $record->fill([
-                            'unita_immobiliare_id' => (int) ($data['unita_immobiliare_id'] ?? 0) ?: null,
-                            'rilevatore_tipo'      => trim((string) ($data['rilevatore_tipo'] ?? '')) ?: null,
-                            'rilevatore_nome'      => trim((string) ($data['rilevatore_nome'] ?? '')) ?: null,
-                            'lettura_precedente_valore' => null,
+                            'unita_immobiliare_id'         => (int) ($data['unita_immobiliare_id'] ?? 0) ?: null,
+                            'rilevatore_tipo'              => trim((string) ($data['rilevatore_tipo'] ?? '')) ?: null,
+                            'rilevatore_nome'              => trim((string) ($data['rilevatore_nome'] ?? '')) ?: null,
+                            'lettura_precedente_valore'    => null,
                             'lettura_precedente_foto_path' => null,
-                            'raw'                  => $raw,
+                            'raw'                          => $raw,
                         ]);
                         $record->save();
                         $this->hydrateReadingWithPreviousData($record);
@@ -647,7 +659,7 @@ public function table(Table $table): Table
                         TextInput::make('rilevatore_nome')->label('Nominativo rilevatore')->maxLength(191),
                         Textarea::make('motivo')->label('Motivo spostamento')->rows(3)->maxLength(1000),
                     ])
-                    ->fillForm(fn(StabileServizioLettura $record): array => [
+                    ->fillForm(fn(StabileServizioLettura $record): array=> [
                         'stabile_servizio_id' => $record->stabile_servizio_id,
                         'rilevatore_tipo'     => (string) ($record->rilevatore_tipo ?? ''),
                         'rilevatore_nome'     => (string) ($record->rilevatore_nome ?? ''),
@@ -656,7 +668,7 @@ public function table(Table $table): Table
                     ->visible(fn(StabileServizioLettura $record): bool => strtolower(trim((string) ($record->servizio?->tipo ?? ''))) === 'acqua')
                     ->action(function (StabileServizioLettura $record, array $data): void {
                         $targetServiceId = (int) ($data['stabile_servizio_id'] ?? 0);
-                        $targetService = StabileServizio::query()
+                        $targetService   = StabileServizio::query()
                             ->where('id', $targetServiceId)
                             ->where('stabile_id', (int) $record->stabile_id)
                             ->where('tipo', 'acqua')
@@ -667,20 +679,20 @@ public function table(Table $table): Table
                             return;
                         }
 
-                        $raw = is_array($record->raw ?? null) ? $record->raw : [];
-                        $movements = is_array($raw['common_meter_movements'] ?? null) ? $raw['common_meter_movements'] : [];
+                        $raw         = is_array($record->raw ?? null) ? $record->raw : [];
+                        $movements   = is_array($raw['common_meter_movements'] ?? null) ? $raw['common_meter_movements'] : [];
                         $movements[] = [
-                            'from_stabile_servizio_id' => (int) ($record->getOriginal('stabile_servizio_id') ?? 0) ?: null,
-                            'to_stabile_servizio_id'   => (int) $targetService->id,
-                            'from_unita_immobiliare_id'=> (int) ($record->getOriginal('unita_immobiliare_id') ?? 0) ?: null,
-                            'to_unita_immobiliare_id'  => null,
-                            'note'                     => trim((string) ($data['motivo'] ?? '')),
-                            'changed_by'               => Auth::id(),
-                            'changed_at'               => now()->toIso8601String(),
+                            'from_stabile_servizio_id'  => (int) ($record->getOriginal('stabile_servizio_id') ?? 0) ?: null,
+                            'to_stabile_servizio_id'    => (int) $targetService->id,
+                            'from_unita_immobiliare_id' => (int) ($record->getOriginal('unita_immobiliare_id') ?? 0) ?: null,
+                            'to_unita_immobiliare_id'   => null,
+                            'note'                      => trim((string) ($data['motivo'] ?? '')),
+                            'changed_by'                => Auth::id(),
+                            'changed_at'                => now()->toIso8601String(),
                         ];
 
                         $raw['common_meter_movements'] = $movements;
-                        $raw['reader_assignment'] = [
+                        $raw['reader_assignment']      = [
                             'user_id' => null,
                             'name'    => trim((string) ($data['rilevatore_nome'] ?? '')) ?: (trim((string) ($record->rilevatore_nome ?? '')) ?: null),
                             'type'    => trim((string) ($data['rilevatore_tipo'] ?? '')) ?: (trim((string) ($record->rilevatore_tipo ?? '')) ?: null),
@@ -693,15 +705,15 @@ public function table(Table $table): Table
                         ];
 
                         $record->fill([
-                            'stabile_servizio_id'        => (int) $targetService->id,
-                            'unita_immobiliare_id'       => null,
-                            'fornitore_id'               => $targetService->fornitore_id,
-                            'rilevatore_tipo'            => trim((string) ($data['rilevatore_tipo'] ?? '')) ?: $record->rilevatore_tipo,
-                            'rilevatore_nome'            => trim((string) ($data['rilevatore_nome'] ?? '')) ?: $record->rilevatore_nome,
-                            'tipologia_lettura'          => 'autolettura_contatore_generale',
-                            'lettura_precedente_valore'  => null,
+                            'stabile_servizio_id'          => (int) $targetService->id,
+                            'unita_immobiliare_id'         => null,
+                            'fornitore_id'                 => $targetService->fornitore_id,
+                            'rilevatore_tipo'              => trim((string) ($data['rilevatore_tipo'] ?? '')) ?: $record->rilevatore_tipo,
+                            'rilevatore_nome'              => trim((string) ($data['rilevatore_nome'] ?? '')) ?: $record->rilevatore_nome,
+                            'tipologia_lettura'            => 'autolettura_contatore_generale',
+                            'lettura_precedente_valore'    => null,
                             'lettura_precedente_foto_path' => null,
-                            'raw'                        => $raw,
+                            'raw'                          => $raw,
                         ]);
                         $record->save();
                         $this->hydrateReadingWithPreviousData($record);
@@ -862,9 +874,9 @@ private function getServiziOptions(): array
             ->orderBy('nome')
             ->get(['id', 'tipo', 'nome', 'contatore_matricola', 'meta'])
             ->mapWithKeys(function (StabileServizio $s): array {
-                $tipo = strtoupper(trim((string) ($s->tipo ?? '')));
-                $nome = trim((string) ($s->nome ?? ''));
-                $matr = trim((string) ($s->contatore_matricola ?? ''));
+                $tipo  = strtoupper(trim((string) ($s->tipo ?? '')));
+                $nome  = trim((string) ($s->nome ?? ''));
+                $matr  = trim((string) ($s->contatore_matricola ?? ''));
                 $asset = trim((string) data_get($s->meta, 'common_asset_label', ''));
 
                 $label = $nome !== '' ? $nome : ($tipo !== '' ? $tipo : ('Servizio #' . $s->id));
@@ -1072,11 +1084,11 @@ private function getCommonWaterServiceOptions(int $stabileId): array
             ->orderBy('contatore_matricola')
             ->get(['id', 'nome', 'contatore_matricola', 'meta'])
             ->mapWithKeys(function (StabileServizio $service): array {
-                $name = trim((string) ($service->nome ?? '')) ?: ('Servizio #' . (int) $service->id);
-                $asset = trim((string) data_get($service->meta, 'common_asset_label', ''));
-                $servedArea = trim((string) data_get($service->meta, 'served_area_label', ''));
+                $name         = trim((string) ($service->nome ?? '')) ?: ('Servizio #' . (int) $service->id);
+                $asset        = trim((string) data_get($service->meta, 'common_asset_label', ''));
+                $servedArea   = trim((string) data_get($service->meta, 'served_area_label', ''));
                 $counterScope = trim((string) data_get($service->meta, 'counter_scope', ''));
-                $matricola = trim((string) ($service->contatore_matricola ?? ''));
+                $matricola    = trim((string) ($service->contatore_matricola ?? ''));
 
                 $parts = array_filter([
                     $name,

app/Filament/Pages/Condomini/ServiziStabileArchivio.php

@@ -637,16 +637,16 @@ private function getServiceTypeOptions(): array
     private function getCommonAssetScopeOptions(): array
     {
         return [
-            'locale'        => 'Locale',
-            'spazio'        => 'Spazio comune',
-            'impianto'      => 'Impianto',
-            'area_esterna'  => 'Area esterna / giardino',
-            'copertura'     => 'Terrazzo / copertura',
-            'accesso'       => 'Portone / accesso',
-            'servizio'      => 'Servizio comune',
-            'sicurezza'     => 'Sicurezza / antincendio',
-            'amministrativo'=> 'Privacy / assicurazione / studio',
-            'altro'         => 'Altro',
+            'locale'         => 'Locale',
+            'spazio'         => 'Spazio comune',
+            'impianto'       => 'Impianto',
+            'area_esterna'   => 'Area esterna / giardino',
+            'copertura'      => 'Terrazzo / copertura',
+            'accesso'        => 'Portone / accesso',
+            'servizio'       => 'Servizio comune',
+            'sicurezza'      => 'Sicurezza / antincendio',
+            'amministrativo' => 'Privacy / assicurazione / studio',
+            'altro'          => 'Altro',
         ];
     }
 
@@ -657,12 +657,12 @@ private function getAllocationScopeOptions(): array
     {
         return [
             'tutti_millesimi'                  => 'Tutti per millesimi',
-            'condomini_utilizzatori'          => 'Condomini utilizzatori',
-            'inquilini_utilizzatori'          => 'Inquilini utilizzatori',
-            'condomini_inquilini_utilizzatori'=> 'Condomini + inquilini utilizzatori',
-            'rimborso_spese'                  => 'Rimborso spese uso bene comune',
-            'gestione_studio'                 => 'Gestione studio / amministrazione',
-            'altro'                           => 'Altro criterio',
+            'condomini_utilizzatori'           => 'Condomini utilizzatori',
+            'inquilini_utilizzatori'           => 'Inquilini utilizzatori',
+            'condomini_inquilini_utilizzatori' => 'Condomini + inquilini utilizzatori',
+            'rimborso_spese'                   => 'Rimborso spese uso bene comune',
+            'gestione_studio'                  => 'Gestione studio / amministrazione',
+            'altro'                            => 'Altro criterio',
         ];
     }
 
@@ -672,11 +672,11 @@ private function getAllocationScopeOptions(): array
     private function getFiscalScopeOptions(): array
     {
         return [
-            'spesa_condominiale'         => 'Spesa condominiale',
-            'rimborso_non_fiscale'       => 'Rimborso spese non fiscale',
-            'da_fatturare'               => 'Da fatturare',
-            'polizza_o_servizio'         => 'Polizza / servizio',
-            'non_applicabile'            => 'Non applicabile',
+            'spesa_condominiale'   => 'Spesa condominiale',
+            'rimborso_non_fiscale' => 'Rimborso spese non fiscale',
+            'da_fatturare'         => 'Da fatturare',
+            'polizza_o_servizio'   => 'Polizza / servizio',
+            'non_applicabile'      => 'Non applicabile',
         ];
     }
 

app/Filament/Pages/Condomini/TabelleMillesimaliArchivio.php

@@ -177,9 +177,9 @@ protected function getTableQuery(): Builder
             return TabellaMillesimale::query()->whereRaw('1 = 0');
         }
 
-        $orderColumn = Schema::hasColumn('tabelle_millesimali', 'ordine_visualizzazione')
-            ? 'ordine_visualizzazione'
-            : (Schema::hasColumn('tabelle_millesimali', 'nord') ? 'nord' : (Schema::hasColumn('tabelle_millesimali', 'ordinamento') ? 'ordinamento' : 'id'));
+        $orderColumn = Schema::hasColumn('tabelle_millesimali', 'nord')
+            ? 'nord'
+            : (Schema::hasColumn('tabelle_millesimali', 'ordine_visualizzazione') ? 'ordine_visualizzazione' : (Schema::hasColumn('tabelle_millesimali', 'ordinamento') ? 'ordinamento' : 'id'));
 
         return TabellaMillesimale::query()
             ->where('stabile_id', $activeStabileId)
@@ -326,13 +326,13 @@ public function table(Table $table): Table
             ])
             ->columns([
                 TextColumn::make(
-                    Schema::hasColumn('tabelle_millesimali', 'ordine_visualizzazione')
-                        ? 'ordine_visualizzazione'
-                        : 'ordinamento'
+                    Schema::hasColumn('tabelle_millesimali', 'nord')
+                        ? 'nord'
+                        : (Schema::hasColumn('tabelle_millesimali', 'ordine_visualizzazione') ? 'ordine_visualizzazione' : 'ordinamento')
                 )
-                    ->label('Ord.')
+                    ->label('Nord')
                     ->sortable()
-                    ->toggleable(isToggledHiddenByDefault: true),
+                    ->toggleable(),
 
                 TextColumn::make('codice_tabella')
                     ->label('Codice')
@@ -614,7 +614,7 @@ protected function loadTabelle(): void
             ->ordinato();
 
         $this->tabelle = $q
-            ->get(['id', 'codice_tabella', 'nome_tabella', 'denominazione', 'tipo_tabella', 'tipo_calcolo', 'totale_millesimi', 'ordinamento', 'meta_legacy'])
+            ->get(['id', 'codice_tabella', 'nome_tabella', 'denominazione', 'tipo_tabella', 'tipo_calcolo', 'totale_millesimi', 'ordinamento', 'ordine_visualizzazione', 'nord', 'meta_legacy'])
             ->map(function (TabellaMillesimale $t) {
                 $codice = $t->codice_tabella ?: ($t->nome_tabella ?: ('TAB ' . $t->id));
                 $nome = $t->denominazione ?: ($t->nome_tabella_millesimale ?: ($t->nome_tabella ?: 'Tabella'));
@@ -634,11 +634,12 @@ protected function loadTabelle(): void
                     'id' => (int) $t->id,
                     'codice' => $codice,
                     'nome' => $nome,
+                    'nord' => $this->resolveNordValue($t),
                     'tipo' => $tipoLabel,
                     'calcolo' => $calcoloLabel,
                     'is_consumo' => $isConsumo,
                     'totale' => is_numeric($t->totale_millesimi) ? (float) $t->totale_millesimi : null,
-                    'ordinamento' => (int) ($t->ordinamento ?? 999999),
+                    'ordinamento' => $this->resolveNordValue($t) ?? (int) ($t->ordine_visualizzazione ?? $t->ordinamento ?? 999999),
                     'is_bilanciata' => (bool) ($t->is_bilanciata ?? false),
                     'preventivo' => is_numeric($prev) ? (float) $prev : null,
                     'consuntivo' => is_numeric($cons) ? (float) $cons : null,
@@ -646,6 +647,23 @@ protected function loadTabelle(): void
             })
             ->values()
             ->all();
+
+        usort($this->tabelle, static function (array $left, array $right): int {
+            $leftNord = is_numeric($left['ordinamento'] ?? null) ? (int) $left['ordinamento'] : 999999;
+            $rightNord = is_numeric($right['ordinamento'] ?? null) ? (int) $right['ordinamento'] : 999999;
+
+            if ($leftNord !== $rightNord) {
+                return $leftNord <=> $rightNord;
+            }
+
+            $leftTipo = (string) ($left['tipo'] ?? '');
+            $rightTipo = (string) ($right['tipo'] ?? '');
+            if ($leftTipo !== $rightTipo) {
+                return strnatcasecmp($leftTipo, $rightTipo);
+            }
+
+            return strnatcasecmp((string) ($left['codice'] ?? ''), (string) ($right['codice'] ?? ''));
+        });
     }
 
     protected function pickTabellaId(?int $candidate): ?int
@@ -1075,7 +1093,6 @@ private function formatCodiceUnita(?string $codice): ?string
             return null;
         }
 
-        $prefix = is_string($this->codiceStabile) ? trim($this->codiceStabile) : '';
         if ($prefix !== '') {
             $pattern = '/^' . preg_quote($prefix, '/') . '[\s\-\/]+/';
             $codice = preg_replace($pattern, '', $codice) ?? $codice;
@@ -1338,4 +1355,16 @@ private function isConsumoCalcolo(?string $calcolo): bool
         $c = strtolower(trim((string) ($calcolo ?? '')));
         return in_array($c, ['acqua', 'a', 'consumo', 'c', 'a_consumo'], true);
     }
+
+    private function resolveNordValue(TabellaMillesimale $t): ?int
+    {
+        foreach (['nord', 'ordine_visualizzazione', 'ordinamento'] as $field) {
+            $value = $t->{$field} ?? null;
+            if (is_numeric($value)) {
+                return (int) $value;
+            }
+        }
+
+        return null;
+    }
 }

app/Filament/Pages/Contabilita/FattureElettronicheP7mRicevute.php

@@ -66,6 +66,32 @@ public function getActiveStabileLabelProperty(): string
         return $parts !== [] ? implode(' - ', $parts) : ('Stabile #' . (int) $stabile->id);
     }
 
+    public function getActiveStabileDestinationSummaryProperty(): string
+    {
+        $user = Auth::user();
+        if (! $user instanceof User) {
+            return 'Stabile non selezionato';
+        }
+
+        $stabile = StabileContext::getActiveStabile($user);
+        if (! $stabile instanceof Stabile) {
+            return 'Stabile non selezionato';
+        }
+
+        $summary = $this->getActiveStabileLabelProperty();
+        $cf      = $this->resolveStabileSoggettoCf($stabile);
+
+        if ($cf !== '') {
+            $summary .= "\nCodice fiscale soggetto usato per lo scarico: {$cf}";
+        }
+
+        if ($this->isLikelyTechnicalFeShell($stabile)) {
+            $summary .= "\nATTENZIONE: lo stabile attivo sembra uno shell tecnico FE separato. Per scaricare le fatture del condominio cambia lo stabile in topbar prima di procedere.";
+        }
+
+        return $summary;
+    }
+
     private function safeUtf8(string $value): string
     {
         $value = preg_replace('/^\xEF\xBB\xBF/', '', $value) ?? $value;
@@ -230,6 +256,12 @@ public function downloadCassettoQuarter(string $quarter, string $dal, string $al
             return;
         }
 
+        if ($this->isLikelyTechnicalFeShell($stabile)) {
+            $this->notifyTechnicalFeShellBlocked();
+            $this->quarterDownloads[$key] = false;
+            return;
+        }
+
         $amministratoreId = (int) ($stabile->amministratore_id ?? 0);
         if ($amministratoreId <= 0) {
             Notification::make()->title('Amministratore non valido')->danger()->send();
@@ -240,7 +272,7 @@ public function downloadCassettoQuarter(string $quarter, string $dal, string $al
         if ($this->isCassettoQuarterCompleteFor($amministratoreId, (int) $stabile->id, $dal, $al)) {
             Notification::make()
                 ->title('Trimestre già completo')
-                ->body($this->safeUtf8("{$quarter} {$anno} risulta già scaricato (COMPLETO)."))
+                ->body($this->safeUtf8("{$quarter} {$anno} risulta già scaricato (COMPLETO). Per rieseguire lo stesso periodo usa 'Scarica da Cassetto Fiscale' e abilita 'Reimport / completa' oppure 'Non saltare'."))
                 ->warning()
                 ->send();
             return;
@@ -305,6 +337,44 @@ private function isCassettoQuarterCompleteFor(int $amministratoreId, int $stabil
         return $errors === 0 && $filesTotal > 0 && ($imported + $duplicates) >= $filesTotal;
     }
 
+    private function resolveStabileSoggettoCf(Stabile $stabile): string
+    {
+        $cf = trim((string) ($stabile->codice_fiscale ?? ''));
+
+        if ($cf === '') {
+            try {
+                $stabile->loadMissing('rubrica');
+                $cf = trim((string) ($stabile->rubrica?->codice_fiscale ?? ''));
+            } catch (\Throwable) {
+                // ignore
+            }
+        }
+
+        return strtoupper(trim($cf));
+    }
+
+    private function isLikelyTechnicalFeShell(Stabile $stabile): bool
+    {
+        $stabileCf  = $this->resolveStabileSoggettoCf($stabile);
+        $adminCf    = strtoupper(trim((string) ($stabile->amministratore?->codice_fiscale_studio ?? '')));
+        $code       = strtoupper(trim((string) ($stabile->codice_stabile ?? '')));
+        $legacyCode = trim((string) ($stabile->cod_stabile ?? ''));
+
+        return $stabileCf !== ''
+            && $adminCf !== ''
+            && $stabileCf === $adminCf
+            && (str_starts_with($code, 'FE') || $legacyCode === '');
+    }
+
+    private function notifyTechnicalFeShellBlocked(): void
+    {
+        Notification::make()
+            ->title('Stabile tecnico FE separato')
+            ->body('Lo scarico è bloccato perché lo stabile attivo usa il codice fiscale dello studio/amministratore. Se devi scaricare le fatture del condominio, cambia lo stabile attivo in topbar e seleziona il condominio reale.')
+            ->warning()
+            ->send();
+    }
+
     public function getArchivioRigheVisteCount(): int
     {
         $records = $this->getTableRecords();
@@ -602,7 +672,7 @@ protected function getHeaderActions(): array
                 ->form([
                     Placeholder::make('stabile_attivo_info')
                         ->label('Stabile di destinazione')
-                        ->content(fn(): string => $this->getActiveStabileLabelProperty()),
+                        ->content(fn(): string => $this->getActiveStabileDestinationSummaryProperty()),
 
                     Select::make('anno')
                         ->label('Anno')
@@ -665,6 +735,9 @@ protected function getHeaderActions(): array
                     Toggle::make('force_update')
                         ->label('Reimport / completa anche se già presente')
                         ->default(false),
+                    Toggle::make('no_skip')
+                        ->label('Non saltare se lo stesso periodo ha già un log OK')
+                        ->default(false),
                     Select::make('importa_righe')
                         ->label('Import righe')
                         ->options([
@@ -691,6 +764,11 @@ protected function getHeaderActions(): array
                         return;
                     }
 
+                    if ($this->isLikelyTechnicalFeShell($stabile)) {
+                        $this->notifyTechnicalFeShellBlocked();
+                        return;
+                    }
+
                     $amministratore = $stabile->amministratore;
                     if (! $amministratore) {
                         Notification::make()->title('Amministratore non trovato')->danger()->send();
@@ -707,11 +785,13 @@ protected function getHeaderActions(): array
                     }
 
                     $forceUpdate = (bool) ($data['force_update'] ?? false);
+                    $noSkip      = (bool) ($data['no_skip'] ?? false);
+                    $allowRerun  = $forceUpdate || $noSkip;
 
                     // Blocco trimestri: se il trimestre è già completo, evita ri-scarico (salvo force_update).
                     $periodo = (string) ($data['periodo'] ?? '');
                     $anno    = is_numeric($data['anno'] ?? null) ? (int) $data['anno'] : (int) $dal->format('Y');
-                    if (! $forceUpdate && in_array($periodo, ['Q1', 'Q2', 'Q3', 'Q4'], true)) {
+                    if (! $allowRerun && in_array($periodo, ['Q1', 'Q2', 'Q3', 'Q4'], true)) {
                         [$expectedDal, $expectedAl] = match ($periodo) {
                             'Q2'    => [$anno . '-04-01', $anno . '-06-30'],
                             'Q3'    => [$anno . '-07-01', $anno . '-09-30'],
@@ -732,7 +812,7 @@ protected function getHeaderActions(): array
                     }
 
                     // Anti-duplicati veloce: se esiste già un OK per lo stesso periodo, non avviamo niente.
-                    if (! $forceUpdate) {
+                    if (! $allowRerun) {
                         $cf = trim((string) ($stabile->codice_fiscale ?? ''));
                         if ($cf === '') {
                             try {
@@ -797,6 +877,7 @@ protected function getHeaderActions(): array
                                 (int) $user->id,
                                 [
                                     'force_update'                => (bool) ($data['force_update'] ?? false),
+                                    'no_skip'                     => (bool) ($data['no_skip'] ?? false),
                                     'importa_righe'               => (string) ($data['importa_righe'] ?? 'auto'),
                                     'create_fornitore_if_missing' => (bool) ($data['create_fornitore_if_missing'] ?? true),
                                 ],
@@ -810,7 +891,7 @@ protected function getHeaderActions(): array
 
                     Notification::make()
                         ->title('Scarico avviato')
-                        ->body("Operazione avviata in background. Se già scaricato, verrà saltato automaticamente.\nAggiorna tra poco e controlla la sezione 'Ultimi scarichi'.")
+                        ->body("Operazione avviata in background. Se hai abilitato 'Reimport / completa' o 'Non saltare', lo stesso periodo verrà rieseguito.\nAggiorna tra poco e controlla la sezione 'Ultimi scarichi'.")
                         ->success()
                         ->send();
                 }),

app/Filament/Pages/Supporto/TicketAcqua.php

@@ -128,6 +128,24 @@ public function updatedUnitaId(): void
         $this->syncSuggestedReaderName();
     }
 
+    public function updatedUnitaSearch(): void
+    {
+        $needle = trim($this->unitaSearch);
+        if ($needle === '') {
+            return;
+        }
+
+        $filtered = $this->getFilteredUnitaOptionsProperty();
+        if (count($filtered) === 1) {
+            $this->applySelectedUnita((int) ($filtered[0]['id'] ?? 0));
+        }
+    }
+
+    public function selectUnita(int $unitaId): void
+    {
+        $this->applySelectedUnita($unitaId, true);
+    }
+
     public function updatedPendingWaterPhotos(): void
     {
         $this->appendPendingWaterPhotos();
@@ -567,6 +585,14 @@ public function getFilteredUnitaOptionsProperty(): array
         return array_values(array_filter($this->unitaOptions, fn(array $option): bool => str_contains((string) ($option['search_text'] ?? ''), $needle)));
     }
 
+    /**
+     * @return array<int,array{id:int,label:string,reader_label:string,folder_prefix:string,search_text:string}>
+     */
+    public function getLightUnitaSearchResultsProperty(): array
+    {
+        return array_slice($this->getFilteredUnitaOptionsProperty(), 0, 10);
+    }
+
     private function loadPreviousReading(): void
     {
         $this->previousReading = null;
@@ -875,12 +901,7 @@ private function resolveUnitReaderLabel(UnitaImmobiliare $unita): string
             }
         }
 
-        $historic = $unita->nominativiStorici
-        ?->sortByDesc(fn($item) => (string) ($item->data_fine ?? '9999-12-31'))
-            ->sortByDesc(fn($item) => (string) ($item->data_inizio ?? ''))
-            ->first();
-
-        $historicLabel = trim((string) ($historic->nominativo ?? ''));
+        $historicLabel = $this->resolveRelevantHistoricNames($unita)[0] ?? '';
         if ($historicLabel !== '') {
             return $historicLabel;
         }
@@ -907,12 +928,7 @@ private function resolveUnitSearchNames(UnitaImmobiliare $unita): array
             }
         }
 
-        foreach (($unita->nominativiStorici ?? collect()) as $historic) {
-            $label = trim((string) ($historic->nominativo ?? ''));
-            if ($label !== '') {
-                $names[] = $label;
-            }
-        }
+        $names = array_merge($names, $this->resolveRelevantHistoricNames($unita));
 
         $fallback = trim((string) ($unita->denominazione ?? ''));
         if ($fallback !== '') {
@@ -922,6 +938,70 @@ private function resolveUnitSearchNames(UnitaImmobiliare $unita): array
         return array_values(array_unique(array_filter($names)));
     }
 
+    /**
+     * @return array<int,string>
+     */
+    private function resolveRelevantHistoricNames(UnitaImmobiliare $unita): array
+    {
+        $today    = now()->toDateString();
+        $historic = collect($unita->nominativiStorici ?? []);
+
+        $current = $historic
+            ->filter(function ($item) use ($today): bool {
+                $start = trim((string) ($item->data_inizio ?? ''));
+                $end   = trim((string) ($item->data_fine ?? ''));
+
+                return ($start === '' || $start <= $today)
+                    && ($end === '' || $end >= $today);
+            })
+            ->map(fn($item): string => trim((string) ($item->nominativo ?? '')))
+            ->filter()
+            ->unique()
+            ->values()
+            ->all();
+
+        if ($current !== []) {
+            return $current;
+        }
+
+        return $historic
+            ->sortByDesc(fn($item): string => sprintf(
+                '%s|%s|%010d',
+                (string) ($item->data_fine ?? '9999-12-31'),
+                (string) ($item->data_inizio ?? ''),
+                (int) ($item->id ?? 0)
+            ))
+            ->map(fn($item): string => trim((string) ($item->nominativo ?? '')))
+            ->filter()
+            ->unique()
+            ->take(1)
+            ->values()
+            ->all();
+    }
+
+    private function applySelectedUnita(int $unitaId, bool $syncSearchLabel = false): void
+    {
+        if ($unitaId <= 0) {
+            return;
+        }
+
+        foreach ($this->unitaOptions as $option) {
+            if ((int) ($option['id'] ?? 0) !== $unitaId) {
+                continue;
+            }
+
+            $this->unitaId = $unitaId;
+            if ($syncSearchLabel) {
+                $this->unitaSearch = (string) ($option['label'] ?? '');
+            }
+
+            $this->loadPreviousReading();
+            $this->syncSuggestedReaderName();
+
+            return;
+        }
+    }
+
     private function buildUnitNaturalSortKey(UnitaImmobiliare $unita, string $readerLabel): string
     {
         $parts = array_filter([

app/Filament/Pages/Supporto/TicketAcquaGenerale.php

@@ -920,10 +920,10 @@ private function buildReadingConsistencyCheck(int $servizioId, ?int $unitaId, fl
     private function formatCounterScopeLabel(string $value): string
     {
         return match (strtolower(trim($value))) {
-            'generale' => 'generale',
+            'generale'    => 'generale',
             'particolare' => 'particolare',
-            'assente' => 'senza contatore',
-            default => trim($value) !== '' ? trim($value) : 'n/d',
+            'assente'     => 'senza contatore',
+            default       => trim($value) !== '' ? trim($value) : 'n/d',
         };
     }
 

app/Filament/Pages/Supporto/TicketAcquaLight.php

@@ -1,7 +1,9 @@
 <?php
 namespace App\Filament\Pages\Supporto;
 
+use App\Models\User;
 use BackedEnum;
+use Illuminate\Support\Facades\Auth;
 use UnitEnum;
 
 class TicketAcquaLight extends TicketAcqua
@@ -19,4 +21,32 @@ class TicketAcquaLight extends TicketAcqua
     protected static ?string $slug = 'supporto/ticket-acqua-light';
 
     protected string $view = 'filament.pages.supporto.ticket-acqua-light';
+
+    public function mount(): void
+    {
+        parent::mount();
+
+        $this->resetLightUnitSelection();
+    }
+
+    public function updatedStabileId(): void
+    {
+        parent::updatedStabileId();
+
+        $this->resetLightUnitSelection();
+    }
+
+    private function resetLightUnitSelection(): void
+    {
+        $user = Auth::user();
+
+        $this->unitaId             = null;
+        $this->unitaSearch         = '';
+        $this->previousReading     = null;
+        $this->suggestedReaderName = null;
+
+        if ($user instanceof User) {
+            $this->rilevatoreNome = trim((string) $user->name) ?: $this->rilevatoreNome;
+        }
+    }
 }

app/Providers/Filament/AdminFilamentPanelProvider.php

@@ -51,7 +51,6 @@ public function panel(Panel $panel): Panel
             ->renderHook(PanelsRenderHook::HEAD_END, fn() => view('filament.components.legacy-admin-assets'))
             ->renderHook(PanelsRenderHook::TOPBAR_LOGO_AFTER, fn() => view('filament.components.topbar-context'))
             ->renderHook(PanelsRenderHook::USER_MENU_BEFORE, fn() => view('filament.components.topbar-icons'))
-            ->renderHook(PanelsRenderHook::FOOTER, fn() => view('filament.components.footer'))
             ->navigationItems([
                 NavigationItem::make('Rubrica Unica')
                     ->group('NetGescon')
@@ -133,7 +132,7 @@ public function panel(Panel $panel): Panel
             ]);
     }
 
-    private function resolveSupplierCatalogUrl(): string
+    protected function resolveSupplierCatalogUrl(): string
     {
         $user = Auth::user();
 

app/Services/Consumi/ConsumiAcquaIngestionService.php

@@ -1,5 +1,4 @@
 <?php
-
 namespace App\Services\Consumi;
 
 use App\Models\CategoriaTicket;
@@ -32,13 +31,32 @@ public function ingest(
             return ['status' => 'error', 'message' => 'Stabile non disponibile'];
         }
 
-        $codici = is_array($parsed['codici'] ?? null) ? $parsed['codici'] : [];
+        $storedPayload = [];
+        $storedRaw     = is_string($fattura->consumo_raw ?? null) ? trim((string) $fattura->consumo_raw) : '';
+        if ($storedRaw !== '') {
+            $decoded = json_decode($storedRaw, true);
+            if (is_array($decoded) && (($decoded['type'] ?? null) === 'acqua')) {
+                $storedPayload = $decoded;
+            }
+        }
+
+        if ((empty($parsed['codici']) || ! is_array($parsed['codici'])) && is_array($storedPayload['codici'] ?? null)) {
+            $parsed['codici'] = $storedPayload['codici'];
+        }
+        if ((empty($parsed['contatore']) || ! is_array($parsed['contatore'])) && is_array($storedPayload['contatore'] ?? null)) {
+            $parsed['contatore'] = $storedPayload['contatore'];
+        }
+        if ((empty($parsed['consumi']) || ! is_array($parsed['consumi'])) && is_array($storedPayload['consumi'] ?? null)) {
+            $parsed['consumi'] = $storedPayload['consumi'];
+        }
+
+        $codici    = is_array($parsed['codici'] ?? null) ? $parsed['codici'] : [];
         $contatore = is_array($parsed['contatore'] ?? null) ? $parsed['contatore'] : [];
-        $consumi = is_array($parsed['consumi'] ?? null) ? $parsed['consumi'] : [];
+        $consumi   = is_array($parsed['consumi'] ?? null) ? $parsed['consumi'] : [];
 
         $matricola = is_string($contatore['matricola'] ?? null) ? trim((string) $contatore['matricola']) : '';
-        $utenza = is_string($codici['utenza'] ?? null) ? trim((string) $codici['utenza']) : '';
-        $cliente = is_string($codici['cliente'] ?? null) ? trim((string) $codici['cliente']) : '';
+        $utenza    = is_string($codici['utenza'] ?? null) ? trim((string) $codici['utenza']) : '';
+        $cliente   = is_string($codici['cliente'] ?? null) ? trim((string) $codici['cliente']) : '';
         $contratto = is_string($codici['contratto'] ?? null) ? trim((string) $codici['contratto']) : '';
 
         $norm = static function (?string $value): string {
@@ -63,13 +81,13 @@ public function ingest(
                     (int) ($fattura->fornitore_id ?: 0) ?: null,
                     'Parser acqua: dati non trovati',
                     'FE #' . (int) $fattura->id . ' (' . ($fattura->sdi_file ?? 'n/d') . ")\n"
-                        . ($error !== '' ? ('Errore: ' . $error . "\n") : '')
-                        . 'Nessun codice utenza/cliente/contratto, nessuna matricola contatore e nessun periodo consumo rilevato.',
+                    . ($error !== '' ? ('Errore: ' . $error . "\n") : '')
+                    . 'Nessun codice utenza/cliente/contratto, nessuna matricola contatore e nessun periodo consumo rilevato.',
                 ) ? 1 : 0;
             }
 
             return [
-                'status' => 'no-data',
+                'status'  => 'no-data',
                 'tickets' => $tickets,
                 'message' => $error !== '' ? $error : 'Dati acqua non trovati nel PDF',
             ];
@@ -88,22 +106,22 @@ public function ingest(
 
             // Mismatch detection: se il servizio ha già un identificativo e il PDF ne porta un altro, apri ticket e non agganciare.
             $mismatch = false;
-            $why = [];
+            $why      = [];
             if (is_string($servizio->contatore_matricola) && $servizio->contatore_matricola !== '' && $matricola !== '' && $servizio->contatore_matricola !== $matricola) {
                 $mismatch = true;
-                $why[] = 'matricola diversa (servizio ' . $servizio->contatore_matricola . ' vs PDF ' . $matricola . ')';
+                $why[]    = 'matricola diversa (servizio ' . $servizio->contatore_matricola . ' vs PDF ' . $matricola . ')';
             }
             if (is_string($servizio->codice_utenza) && $servizio->codice_utenza !== '' && $utenza !== '' && $servizio->codice_utenza !== $utenza) {
                 $mismatch = true;
-                $why[] = 'utenza diversa (servizio ' . $servizio->codice_utenza . ' vs PDF ' . $utenza . ')';
+                $why[]    = 'utenza diversa (servizio ' . $servizio->codice_utenza . ' vs PDF ' . $utenza . ')';
             }
             if (is_string($servizio->codice_cliente) && $servizio->codice_cliente !== '' && $cliente !== '' && $servizio->codice_cliente !== $cliente) {
                 $mismatch = true;
-                $why[] = 'cliente diverso (servizio ' . $servizio->codice_cliente . ' vs PDF ' . $cliente . ')';
+                $why[]    = 'cliente diverso (servizio ' . $servizio->codice_cliente . ' vs PDF ' . $cliente . ')';
             }
             if (is_string($servizio->codice_contratto) && $servizio->codice_contratto !== '' && $contratto !== '' && $servizio->codice_contratto !== $contratto) {
                 $mismatch = true;
-                $why[] = 'contratto diverso (servizio ' . $servizio->codice_contratto . ' vs PDF ' . $contratto . ')';
+                $why[]    = 'contratto diverso (servizio ' . $servizio->codice_contratto . ' vs PDF ' . $contratto . ')';
             }
             if ($mismatch && $createTicketOnMismatch) {
                 $tickets += $this->openTicket(
@@ -128,20 +146,20 @@ public function ingest(
                 ->get();
 
             $targetMatricola = $norm($matricola);
-            $targetUtenza = $norm($utenza);
-            $targetCliente = $norm($cliente);
+            $targetUtenza    = $norm($utenza);
+            $targetCliente   = $norm($cliente);
             $targetContratto = $norm($contratto);
 
-            $best = null;
+            $best      = null;
             $bestScore = 0;
-            $bestTie = 0;
+            $bestTie   = 0;
 
             foreach ($candidates as $cand) {
                 $score = 0;
 
                 $candMatricola = $norm(is_string($cand->contatore_matricola) ? $cand->contatore_matricola : null);
-                $candUtenza = $norm(is_string($cand->codice_utenza) ? $cand->codice_utenza : null);
-                $candCliente = $norm(is_string($cand->codice_cliente) ? $cand->codice_cliente : null);
+                $candUtenza    = $norm(is_string($cand->codice_utenza) ? $cand->codice_utenza : null);
+                $candCliente   = $norm(is_string($cand->codice_cliente) ? $cand->codice_cliente : null);
                 $candContratto = $norm(is_string($cand->codice_contratto) ? $cand->codice_contratto : null);
 
                 if ($targetMatricola !== '' && $candMatricola !== '' && $targetMatricola === $candMatricola) {
@@ -158,9 +176,9 @@ public function ingest(
                 }
 
                 if ($score > $bestScore) {
-                    $best = $cand;
+                    $best      = $cand;
                     $bestScore = $score;
-                    $bestTie = 0;
+                    $bestTie   = 0;
                 } elseif ($score > 0 && $score === $bestScore) {
                     $bestTie++;
                 }
@@ -174,8 +192,8 @@ public function ingest(
                         (int) ($fattura->fornitore_id ?: 0) ?: null,
                         'Parser acqua: utenza ambigua',
                         'FE #' . (int) $fattura->id . ' (' . ($fattura->sdi_file ?? 'n/d') . ")\n"
-                            . 'Più utenze acqua compatibili con gli identificativi del PDF. ' .
-                            'Matricola=' . ($matricola !== '' ? $matricola : 'n/d') . ', Utenza=' . ($utenza !== '' ? $utenza : 'n/d') . ', Cliente=' . ($cliente !== '' ? $cliente : 'n/d') . ', Contratto=' . ($contratto !== '' ? $contratto : 'n/d'),
+                        . 'Più utenze acqua compatibili con gli identificativi del PDF. ' .
+                        'Matricola=' . ($matricola !== '' ? $matricola : 'n/d') . ', Utenza=' . ($utenza !== '' ? $utenza : 'n/d') . ', Cliente=' . ($cliente !== '' ? $cliente : 'n/d') . ', Contratto=' . ($contratto !== '' ? $contratto : 'n/d'),
                     ) ? 1 : 0;
                 }
 
@@ -197,16 +215,16 @@ public function ingest(
                         (int) ($fattura->fornitore_id ?: 0) ?: null,
                         'Parser acqua: utenza non riconosciuta',
                         'FE #' . (int) $fattura->id . ' (' . ($fattura->sdi_file ?? 'n/d') . ")\n"
-                            . 'Identificativi PDF non agganciati a nessuna utenza acqua esistente. ' .
-                            'Matricola=' . ($matricola !== '' ? $matricola : 'n/d') . ', Utenza=' . ($utenza !== '' ? $utenza : 'n/d') . ', Cliente=' . ($cliente !== '' ? $cliente : 'n/d') . ', Contratto=' . ($contratto !== '' ? $contratto : 'n/d'),
+                        . 'Identificativi PDF non agganciati a nessuna utenza acqua esistente. ' .
+                        'Matricola=' . ($matricola !== '' ? $matricola : 'n/d') . ', Utenza=' . ($utenza !== '' ? $utenza : 'n/d') . ', Cliente=' . ($cliente !== '' ? $cliente : 'n/d') . ', Contratto=' . ($contratto !== '' ? $contratto : 'n/d'),
                     ) ? 1 : 0;
                 }
 
                 $servizio = new StabileServizio([
                     'stabile_id' => $stabileId,
-                    'tipo' => 'acqua',
-                    'nome' => $name,
-                    'attivo' => true,
+                    'tipo'       => 'acqua',
+                    'nome'       => $name,
+                    'attivo'     => true,
                 ]);
             }
         }
@@ -244,36 +262,36 @@ public function ingest(
         }
 
         foreach ($consumi as $c) {
-            $dal = is_string($c['dal'] ?? null) ? (string) $c['dal'] : null;
-            $al = is_string($c['al'] ?? null) ? (string) $c['al'] : null;
-            $val = isset($c['valore']) && is_numeric($c['valore']) ? (float) $c['valore'] : null;
+            $dal   = is_string($c['dal'] ?? null) ? (string) $c['dal'] : null;
+            $al    = is_string($c['al'] ?? null) ? (string) $c['al'] : null;
+            $val   = isset($c['valore']) && is_numeric($c['valore']) ? (float) $c['valore'] : null;
             $unita = is_string($c['unita'] ?? null) ? trim((string) $c['unita']) : '';
-            $tipo = is_string($c['tipologia_lettura'] ?? null) ? trim((string) $c['tipologia_lettura']) : null;
+            $tipo  = is_string($c['tipologia_lettura'] ?? null) ? trim((string) $c['tipologia_lettura']) : null;
 
             $lettura = StabileServizioLettura::query()->firstOrNew([
-                'stabile_id' => $stabileId,
-                'stabile_servizio_id' => (int) $servizio->id,
+                'stabile_id'             => $stabileId,
+                'stabile_servizio_id'    => (int) $servizio->id,
                 'fattura_elettronica_id' => (int) $fattura->id,
-                'periodo_dal' => $dal,
-                'periodo_al' => $al,
+                'periodo_dal'            => $dal,
+                'periodo_al'             => $al,
             ]);
 
             $isNew = ! $lettura->exists;
 
             $lettura->fill([
-                'fornitore_id' => (int) ($fattura->fornitore_id ?: 0) ?: null,
-                'voce_spesa_id' => $voceSpesaId ?: ($servizio->voce_spesa_id ? (int) $servizio->voce_spesa_id : null),
+                'fornitore_id'      => (int) ($fattura->fornitore_id ?: 0) ?: null,
+                'voce_spesa_id'     => $voceSpesaId ?: ($servizio->voce_spesa_id ? (int) $servizio->voce_spesa_id : null),
                 'tipologia_lettura' => $tipo,
-                'consumo_valore' => $val,
-                'consumo_unita' => $unita !== '' ? $unita : 'mc',
-                'importo_totale' => $importo,
-                'raw' => [
-                    'source' => 'pdf_ocr',
-                    'codici' => $parsed['codici'] ?? null,
+                'consumo_valore'    => $val,
+                'consumo_unita'     => $unita !== '' ? $unita : 'mc',
+                'importo_totale'    => $importo,
+                'raw'               => [
+                    'source'    => 'pdf_ocr',
+                    'codici'    => $parsed['codici'] ?? null,
                     'contatore' => $parsed['contatore'] ?? null,
-                    'consumo' => $c,
+                    'consumo'   => $c,
                 ],
-                'created_by' => $userId > 0 ? $userId : null,
+                'created_by'        => $userId > 0 ? $userId : null,
             ]);
 
             $lettura->save();
@@ -286,11 +304,11 @@ public function ingest(
         }
 
         return [
-            'status' => 'ok',
-            'servizio_id' => (int) $servizio->id,
+            'status'          => 'ok',
+            'servizio_id'     => (int) $servizio->id,
             'created_letture' => $created,
             'updated_letture' => $updated,
-            'tickets' => $tickets,
+            'tickets'         => $tickets,
         ];
     }
 
@@ -327,14 +345,14 @@ private function openTicket(int $stabileId, int $userId, ?int $fornitoreId, stri
             }
 
             Ticket::query()->create([
-                'stabile_id' => $stabileId,
-                'aperto_da_user_id' => $userId > 0 ? $userId : 1,
-                'categoria_ticket_id' => (int) $cat->id,
+                'stabile_id'               => $stabileId,
+                'aperto_da_user_id'        => $userId > 0 ? $userId : 1,
+                'categoria_ticket_id'      => (int) $cat->id,
                 'assegnato_a_fornitore_id' => $fornitoreId,
-                'titolo' => $title,
-                'descrizione' => $body,
-                'stato' => 'Aperto',
-                'priorita' => 'Media',
+                'titolo'                   => $title,
+                'descrizione'              => $body,
+                'stato'                    => 'Aperto',
+                'priorita'                 => 'Media',
             ]);
 
             return true;

docs/ai/SESSION_HANDOFF.md

@@ -1,3 +1,73 @@
+# SESSION HANDOFF - 2026-04-13 / 2026-04-14
+
+## Stato operativo reale alla chiusura sessione
+
+- Repository: `/home/michele/netgescon/netgescon-day0`
+- Focus stabile utente: `0021`, con attenzione anche allo shell tecnico FE `FE221005` (`stabili.id=29`)
+- Obiettivo operativo chiuso in questa sessione:
+  - rendere esplicito e sicuro il CF soggetto nello scarico FE
+  - semplificare il flusso `ticket-acqua-light`
+  - rimuovere il footer Filament invasivo su mobile
+  - riallineare pagina `tabelle-millesimali` a `nord`, `tipo`, `calcolo`
+  - eliminare i blocchi Blade fragili nelle viste `ticket-acqua` e `ticket-acqua-generale`
+
+## Verifiche fatte e confermate
+
+- `php artisan view:clear && php artisan view:cache` eseguito con esito OK dopo gli ultimi fix.
+- `php artisan route:list` carica `755` route.
+- Il service FE usa il CF dello stabile, non il CF studio dell'amministratore:
+  - `stabili.id=25 / codice_stabile=0021 / CF=97487690584`
+  - `stabili.id=29 / codice_stabile=FE221005 / CF=10055221005`
+- Il problema operativo dello scarico FE nasceva dal contesto dello stabile attivo in topbar/sessione, non dalla chiamata HTTP finale.
+- Nella pagina FE è stato aggiunto un riepilogo esplicito del `Codice fiscale soggetto usato per lo scarico`.
+- Le due Blade acqua sono state semplificate spostando il rendering metadati foto in partial condivisa, per evitare parse error residui in staging dovuti a blocchi Blade annidati.
+
+## File toccati in questa fase
+
+- `app/Providers/Filament/AdminFilamentPanelProvider.php`
+  - chain Filament riparata
+  - footer hook rimosso dal panel
+- `app/Filament/Pages/Condomini/TabelleMillesimaliArchivio.php`
+  - preferenza a `tabelle_millesimali.nord` per ordinamento archivio
+  - `nord` portato nel payload usato dalla Blade
+  - lista tabelle ordinata per `nord`, poi `tipo`, poi codice
+- `resources/views/filament/pages/condomini/tabelle-millesimali.blade.php`
+  - badge visivo `Ord. {nord}`
+  - `tipo` e `calcolo` mantenuti visibili nelle liste `prospetto` e `voci`
+- `resources/views/filament/pages/supporto/ticket-acqua.blade.php`
+- `resources/views/filament/pages/supporto/ticket-acqua-generale.blade.php`
+  - blocchi metadati foto sostituiti con partial condivisa
+- `resources/views/filament/pages/supporto/partials/photo-metadata.blade.php`
+  - nuova partial minima in PHP/HTML, senza direttive Blade annidate
+
+## Comandi rapidi per ripartenza domani
+
+```bash
+cd /home/michele/netgescon/netgescon-day0
+git status --short
+php artisan view:clear
+php artisan view:cache
+php artisan route:list | tail -n 2
+php artisan netgescon:qa-millesimi-spese --stabile=0021 --show-missing=20
+tail -n 120 storage/logs/laravel.log
+```
+
+## Punti ancora aperti da riprendere
+
+1. QA millesimi/voci da rendere piu accurato per le gestioni straordinarie legate all'anno/esercizio.
+2. Validazione staging reale dopo `git push` + update staging:
+   - `/admin-filament/condomini/tabelle-millesimali`
+   - `/admin-filament/supporto/ticket-acqua`
+   - `/admin-filament/supporto/ticket-acqua-generale`
+3. Controllo del bug `fornitore Livewire root` ancora aperto nel tracker.
+4. Diagnosi separata dei nominativi rumorosi per `0023`.
+
+## Prompt consigliato per un altro agent
+
+"Riparti da `docs/ai/SESSION_HANDOFF.md`. Prima verifica `git status`, poi esegui `php artisan view:clear && php artisan view:cache`. Controlla staging su `tabelle-millesimali`, `ticket-acqua` e `ticket-acqua-generale`. Se il deploy e allineato, passa al raffinamento del QA millesimi/voci per gestioni straordinarie con anno/esercizio, senza fare bonifiche contabili distruttive." 
+
+---
+
 # SESSION HANDOFF - 2026-04-08
 
 ## Contesto operativo attuale

resources/views/filament/components/footer.blade.php

@@ -1,48 +1 @@
-@php
-    $user = \Illuminate\Support\Facades\Auth::user();
-    $version = config('netgescon.version') ?? config('app.version');
-@endphp
 
-@once
-    <style>
-        /* Ensure the Filament layout behaves like a full-height flex column,
-           so this footer is pushed to the bottom even on short pages.
-           This is a safe fallback when the Vite theme CSS isn't loaded. */
-        .fi-main-ctn {
-            min-height: 100vh;
-            min-height: 100dvh;
-            height: auto !important;
-            display: flex !important;
-            flex-direction: column !important;
-        }
-        .fi-main {
-            flex: 1 1 auto;
-            min-height: 0;
-            height: auto !important;
-        }
-        .netgescon-footer {
-            flex: none;
-            margin-top: auto;
-            width: 100% !important;
-            position: sticky !important;
-            bottom: 0 !important;
-            z-index: 10 !important;
-        }
-    </style>
-@endonce
-
-<div class="netgescon-footer px-6 py-3 text-xs text-gray-500 border-t bg-white">
-    <div class="mx-auto max-w-7xl flex flex-wrap items-center justify-between gap-2">
-        <div class="flex flex-wrap items-center gap-x-3 gap-y-1">
-            <div>NetGescon{{ $version ? ' · v' . $version : '' }}</div>
-            <div class="text-gray-400">|</div>
-            <div>{{ now()->format('d/m/Y H:i') }}</div>
-        </div>
-
-        <div class="flex items-center gap-3">
-            <a href="{{ \App\Filament\Pages\Supporto\RichiestaHelp::getUrl(panel: 'admin-filament') }}" class="text-primary-600 hover:underline">
-                Richiedi help / segnala bug
-            </a>
-        </div>
-    </div>
-</div>

resources/views/filament/pages/condomini/tabelle-millesimali.blade.php

@@ -70,8 +70,13 @@ class="block rounded-xl border p-3 transition
                                 >
                                     <div class="flex items-start justify-between gap-3">
                                         <div>
-                                            <div class="text-sm font-semibold {{ $selected ? 'text-primary-700' : 'text-gray-900' }}">
-                                                {{ $t['codice'] }}
+                                            <div class="flex flex-wrap items-center gap-2">
+                                                <div class="text-sm font-semibold {{ $selected ? 'text-primary-700' : 'text-gray-900' }}">
+                                                    {{ $t['codice'] }}
+                                                </div>
+                                                @if(isset($t['nord']) && $t['nord'] !== null)
+                                                    <span class="inline-flex items-center rounded-full bg-slate-100 px-2 py-0.5 text-[10px] font-semibold text-slate-700">Ord. {{ $t['nord'] }}</span>
+                                                @endif
                                             </div>
                                             <div class="text-xs text-gray-600">{{ $t['nome'] }}</div>
                                             @if(!empty($t['tipo']) || !empty($t['calcolo']))
@@ -241,8 +246,13 @@ class="block rounded-xl border p-3 transition
                                 >
                                     <div class="flex items-start justify-between gap-3">
                                         <div>
-                                            <div class="text-sm font-semibold {{ $selected ? 'text-primary-700' : 'text-gray-900' }}">
-                                                {{ $t['codice'] }}
+                                            <div class="flex flex-wrap items-center gap-2">
+                                                <div class="text-sm font-semibold {{ $selected ? 'text-primary-700' : 'text-gray-900' }}">
+                                                    {{ $t['codice'] }}
+                                                </div>
+                                                @if(isset($t['nord']) && $t['nord'] !== null)
+                                                    <span class="inline-flex items-center rounded-full bg-slate-100 px-2 py-0.5 text-[10px] font-semibold text-slate-700">Ord. {{ $t['nord'] }}</span>
+                                                @endif
                                             </div>
                                             <div class="text-xs text-gray-600">{{ $t['nome'] }}</div>
                                             @if(!empty($t['tipo']) || !empty($t['calcolo']))

resources/views/filament/pages/supporto/partials/photo-metadata.blade.php

@@ -0,0 +1,20 @@
+<?php
+$badgeRows = is_array($badgeRows ?? null) ? $badgeRows : [];
+$detailRows = is_array($detailRows ?? null) ? $detailRows : [];
+?>
+
+<?php if ($badgeRows !== []): ?>
+    <div class="mt-2 flex flex-wrap gap-1">
+        <?php foreach ($badgeRows as $badge): ?>
+            <span class="inline-flex items-center rounded-full px-2 py-0.5 text-[10px] font-semibold <?= e((string) ($badge['class'] ?? '')) ?>"><?= e((string) ($badge['label'] ?? '')) ?></span>
+        <?php endforeach; ?>
+    </div>
+<?php endif; ?>
+
+<?php if ($detailRows !== []): ?>
+    <div class="mt-2 rounded-lg border border-slate-200 bg-white p-2 text-[11px] text-slate-700">
+        <?php foreach ($detailRows as $detail): ?>
+            <div><span class="font-medium"><?= e((string) ($detail['label'] ?? '')) ?>:</span> <?= e((string) ($detail['value'] ?? '')) ?></div>
+        <?php endforeach; ?>
+    </div>
+<?php endif; ?>

resources/views/filament/pages/supporto/ticket-acqua-generale.blade.php

@@ -63,7 +63,9 @@
                     </div>
                 </div>
 
-                @php($service = $this->selectedServiceSnapshot)
+                @php
+                    $service = $this->selectedServiceSnapshot;
+                @endphp
                 @if($service)
                     <div class="rounded-2xl border border-emerald-200 bg-emerald-50 p-4 shadow-sm">
                         <div class="text-sm font-semibold text-emerald-900">Riferimenti contratto selezionato</div>
@@ -332,13 +334,7 @@
                                                 ];
                                             }
                                         @endphp
-                                        @if($detailRows !== [])
-                                            <div class="mt-2 rounded-lg border border-slate-200 bg-white p-2 text-[11px] text-slate-700">
-                                                @foreach($detailRows as $detail)
-                                                    <div><span class="font-medium">{{ $detail['label'] }}:</span> {{ $detail['value'] }}</div>
-                                                @endforeach
-                                            </div>
-                                        @endif
+                                        @include('filament.pages.supporto.partials.photo-metadata', ['badgeRows' => [], 'detailRows' => $detailRows])
                                         <label class="mt-2 block">
                                             <span class="mb-1 block text-[11px] font-medium">Nota foto</span>
                                             <input type="text" wire:model.defer="generalWaterPhotoDescriptions.{{ $upload['index'] }}" class="w-full rounded-lg border-gray-300" placeholder="Es. display principale, targhetta matricola, quadro contatori" />

resources/views/filament/pages/supporto/ticket-acqua-light.blade.php

@@ -46,19 +46,44 @@
                         </label>
 
                         <label class="block text-sm">
-                            <span class="mb-1 block font-medium">Cerca nominativo / unità</span>
-                            <input type="text" wire:model.live.debounce.250ms="unitaSearch" class="w-full rounded-lg border-gray-300" placeholder="Es. Maggiore, Int. 10, B_4..." />
+                            <span class="mb-1 block font-medium">Cerca unità / nominativo</span>
+                            <input type="text" wire:model.live.debounce.250ms="unitaSearch" class="w-full rounded-lg border-gray-300" placeholder="Es. Rossi, Int. 10, 0021-A-20..." />
+                            <div class="mt-1 text-[11px] text-slate-500">Un solo campo: cerca per codice unità, interno, piano o nominativo attuale dello stabile selezionato.</div>
                         </label>
 
-                        <label class="block text-sm">
-                            <span class="mb-1 block font-medium">Unità immobiliare</span>
-                            <select wire:model.live="unitaId" class="w-full rounded-lg border-gray-300">
-                                <option value="">Seleziona unità</option>
-                                @foreach($this->filteredUnitaOptions as $option)
-                                    <option value="{{ $option['id'] }}">{{ $option['label'] }}</option>
-                                @endforeach
-                            </select>
-                        </label>
+                        @php
+                            $searchResults = $this->lightUnitaSearchResults;
+                            $selectedUnit = collect($this->unitaOptions)->firstWhere('id', (int) ($unitaId ?? 0));
+                            $searchTerm = trim((string) $unitaSearch);
+                        @endphp
+                        <div class="rounded-2xl border border-slate-200 bg-slate-50 p-3">
+                            @if($selectedUnit)
+                                <div class="rounded-xl border border-emerald-200 bg-emerald-50 px-3 py-2 text-sm text-emerald-900">
+                                    <div class="font-semibold">Unità selezionata</div>
+                                    <div class="mt-1">{{ $selectedUnit['label'] }}</div>
+                                    @if(filled($selectedUnit['reader_label'] ?? null))
+                                        <div class="mt-1 text-[11px] text-emerald-800">Nominativo collegato: {{ $selectedUnit['reader_label'] }}</div>
+                                    @endif
+                                </div>
+                            @elseif($searchTerm === '')
+                                <div class="text-sm text-slate-500">Digita almeno parte del nominativo o del codice unità per selezionare rapidamente il destinatario corretto.</div>
+                            @endif
+
+                            @if($searchTerm !== '' && $searchResults !== [])
+                                <div class="mt-3 space-y-2">
+                                    @foreach($searchResults as $option)
+                                        <button type="button" wire:click="selectUnita({{ (int) $option['id'] }})" class="block w-full rounded-xl border border-slate-200 bg-white px-3 py-2 text-left text-sm shadow-sm transition hover:border-sky-300 hover:bg-sky-50">
+                                            <div class="font-medium text-slate-900">{{ $option['label'] }}</div>
+                                            @if(filled($option['reader_label'] ?? null))
+                                                <div class="mt-1 text-[11px] text-slate-500">{{ $option['reader_label'] }}</div>
+                                            @endif
+                                        </button>
+                                    @endforeach
+                                </div>
+                            @elseif($searchTerm !== '' && $searchResults === [])
+                                <div class="mt-3 rounded-xl border border-amber-200 bg-amber-50 px-3 py-2 text-sm text-amber-900">Nessuna unità trovata per questa ricerca nello stabile selezionato.</div>
+                            @endif
+                        </div>
 
                         <label class="block text-sm">
                             <span class="mb-1 block font-medium">Nominativo letturista</span>

resources/views/filament/pages/supporto/ticket-acqua.blade.php

@@ -244,7 +244,9 @@
                         <div wire:loading wire:target="pendingWaterPhotos" class="mt-2 text-xs font-medium text-amber-700">Caricamento foto in corso: preparo la coda della lettura acqua.</div>
 
                         @if(count($this->selectedWaterUploads) > 0)
-                            @php($focusUpload = $this->selectedWaterUploads[0] ?? null)
+                            @php
+                                $focusUpload = $this->selectedWaterUploads[0] ?? null;
+                            @endphp
                             @if($focusUpload)
                                 <div class="mt-4 rounded-2xl border border-sky-200 bg-sky-50 p-3">
                                     <div class="mb-2 text-xs font-semibold text-sky-900">Chicca lettura rapida</div>
@@ -318,22 +320,7 @@
                                                 ];
                                             }
                                         @endphp
-                                        @if($badgeRows !== [] || $detailRows !== [])
-                                            @if($badgeRows !== [])
-                                                <div class="mt-2 flex flex-wrap gap-1">
-                                                    @foreach($badgeRows as $badge)
-                                                        <span class="inline-flex items-center rounded-full px-2 py-0.5 text-[10px] font-semibold {{ $badge['class'] }}">{{ $badge['label'] }}</span>
-                                                    @endforeach
-                                                </div>
-                                            @endif
-                                            @if($detailRows !== [])
-                                                <div class="mt-2 rounded-lg border border-slate-200 bg-white p-2 text-[11px] text-slate-700">
-                                                    @foreach($detailRows as $detail)
-                                                        <div><span class="font-medium">{{ $detail['label'] }}:</span> {{ $detail['value'] }}</div>
-                                                    @endforeach
-                                                </div>
-                                            @endif
-                                        @endif
+                                        @include('filament.pages.supporto.partials.photo-metadata', ['badgeRows' => $badgeRows, 'detailRows' => $detailRows])
                                         <label class="mt-2 block">
                                             <span class="mb-1 block text-[11px] font-medium">Nota sotto la foto</span>
                                             <input type="text" wire:model.defer="waterPhotoDescriptions.{{ $upload['index'] }}" class="w-full rounded-lg border-gray-300" placeholder="Es. contatore cucina, cifra poco leggibile" />