netgescon-day0/skill-netgescon/control-tower/CURRENT-205.md

CURRENT-205

TASK_ID: task-estratto-conto-inquilino-stabili-pdf MACHINE: .205 STATO: completato

Obiettivo Completato

1. Rettifica Rigida Estratto Conto Inquilino (I) - Stabile 0013:

   • Esclusione Totale Spese Straordinarie: all'inquilino non appare alcuna gestione o spesa straordinaria (gestioni_straordinarie = [], totale_straordinarie_residuo = 0.00). Nella Blade viene visualizzato un banner informativo chiarificatore (artt. 1576 e 1609 c.c.).
   • Gestione Ordinaria 2026 Atomica per l'Inquilino (Kiwa Cermet SpA, entrato nel 2025):
     • Rata 1 (rif. 2, 05/01/2026): 280,00 € dovuti, pagati 280,00 € il 16/01/2026 (residuo 0,00 € - Saldata)
     • Rata 2 (rif. 61, 31/03/2026): 280,00 € dovuti, pagati 280,00 € il 13/04/2026 (residuo 0,00 € - Saldata)
     • Rata 3 (rif. 181, 21/05/2026): 334,00 € dovuti (residuo 334,00 € - Da Pagare)
     • Rata 4 (rif. 120, 24/06/2026 Conguaglio es. precedente): 63,30 € dovuti (residuo 63,30 € - Da Pagare)
     • Rata 5 (rif. 241, 05/07/2026): 334,00 € dovuti (residuo 334,00 € - Da Pagare)
     • Totale Gestione Ordinaria 2026: Dovuto 1.291,30 €, Pagato 560,00 €, Residuo da Pagare € 731,30.
     • Totale Dovuto Globale Inquilino: € 731,30 esatto al centesimo (riscontro identico con documento ufficiale EC_553.pdf).

2. Integrazione e Supporto Completo Stabile 0021 (SUPERCONDOMINIO MILIZIE 3):

   • Riscaldamento Centralizzato: abilitato con flag has_riscaldamento = true, KPI card dedicata e tabella temporale dei movimenti (4 rate da 45,00 € di cui Rata 1 Gennaio pagata 30/01/2026, residuo € 135,00).
   • Aggregazione Pertinenze della Proprietà: include sia l'appartamento A/1 che la cantina CAN/01 appartenenti alla medesima intestazione CEFALONI M.CONCETTA - ROSSI PAOLA.
   • Ripartizione Contabile al Centesimo:
     • Gestione Ordinaria 2026: Rata 1 pagata 130,00 €, Rata 2 residuo 130,00 €, Quota pertinenza cantina CAN/01 9,21 € -> € 139,21
     • Riscaldamento Centralizzato 2025-26: 3 rate da 45,00 € -> € 135,00
     • Gestioni Straordinarie: Lavori Str. 5/2025 (381,06 €) + Causa Scillia 1/2026 (quote A/1 e CAN/01: 92,88 + 92,88 + 3,33 + 3,33 = 192,42 €) -> € 573,48
     • Totale Dovuto Globale Stabile 0021: 139,21 + 135,00 + 573,48 = € 847,69 esatto al centesimo.

3. Archivio Storico Documenti ed Estratti Conto PDF Gescon (Protoc_EC):

   • Integrazione lettura tabella Protoc_EC in generale_stabile.mdb.
   • Nuova Sezione 4 nella Blade con tabella cronologica degli estratti conto emessi: Protocollo, Data, Canale (PEC/E-Mail), Destinatario, Oggetto, Importo Totale.
   • Nuova rotta protetta admin.gescon.ec.pdf (admin/gescon-ec-pdf/{stabile}/{file}) che verifica i percorsi su disco sia in minuscolo e_c/ (0013) che in maiuscolo E_C/ (0021) con protezione anti path-traversal (basename).
   • Pulsante diretto "Apri / Scarica PDF" con anteprima in nuova scheda (EC_553.pdf, EC_552.pdf, EC_005.pdf, ecc.).

4. Preservazione Stato Navigazione Livewire (UnitaImmobiliarePage):

   • Risolto reset forzato della proprietà $this->tab in loadUnita(): ora preserva il tab attivo durante le chiamate Livewire (es. toggle Condòmino/Inquilino e refresh MDB).

Output del Giro Operativo

ESITO_205: riuscito TASK_ID: task-estratto-conto-inquilino-stabili-pdf REPOSITORY: ssh://git@git.netgescon.it:2222/michele/netgescon-day0.git BRANCH: stabilization/205-zero COMMIT: 1ed8ae1 FILE_O_AREE_TOCCATE:

• app/Filament/Pages/UnitaImmobiliarePage.php
• app/Services/Gescon/GesconEstrattoContoService.php
• resources/views/filament/pages/unita-immobiliare.blade.php
• routes/web.php
• skill-netgescon/control-tower/CURRENT-205.md
• tests/Feature/UnitaEstrattoContoAtomicoTest.php TEST_ESEGUITI:
• ./vendor/bin/pest tests/Feature/UnitaEstrattoContoAtomicoTest.php (4 passed, 87 assertions, 100% pass)
• ./vendor/bin/pest tests/Feature/UnitaCondominoInquilinoRoleToggleTest.php tests/Feature/UnitaGestioneTemporaleTest.php tests/Feature/UnitaImmobiliarePageTest.php tests/Feature/UnitaEstrattoContoAtomicoTest.php (14 passed, 158 assertions, 100% pass)
• php artisan view:clear && php artisan view:cache (successo, 100% template compilati senza errori) GATE_STATISTICS:
• BLADE_COMPILATION: 100% pulita senza errori di sintassi.
• BENCHMARK_VERIFICATION:
  • 0013 Condòmino Spadavecchia A-1 = € 1.267,96 esatto (Passerella 965,60 + Cornicione 302,36).
  • 0013 Inquilino Kiwa Cermet A-1 = € 731,30 esatto (0 straordinarie, 5 rate ordinarie 2026 con 560 € pagati e 731,30 € residuo).
  • 0021 Condòmino Cefaloni Milizie 3 = € 847,69 esatto (Ordinaria 139,21 + Riscaldamento 135,00 + Straordinarie 573,48).
• TEST_SUITE: 14 test Feature passati (158 asserzioni, 100% pass). BLOCCO_DATI: no BLOCCO_CONTRATTO: no RISCHI_APERTI: nessuno

Prossimo Passo per .200 (Validazione)

• Eseguire il checkout del branch stabilization/205-zero.
• Eseguire la suite di test Pest (./vendor/bin/pest tests/Feature/UnitaEstrattoContoAtomicoTest.php).
• Verificare su http://192.168.0.205:8000/admin-filament/unita-immobiliare:
  1. Stabile 0013, Unità A-1:
     • In modalità 🏢 Condòmino (C): Totale Dovuto = € 1.267,96, straordinarie attive € 1.267,96, ordinaria corrente € 0,00.
     • In modalità 👤 Inquilino (I): Totale Dovuto = € 731,30, straordinarie = € 0,00 con banner chiarificatore, ordinaria 2026 con 5 rate (rate 1 e 2 saldate per 560 €, rate 3, 4, 5 da pagare per 731,30 €).
     • Nella sezione "Archivio Documenti & Estratti Conto Emessi (PDF Gescon)": verificare la presenza di EC_553.pdf e EC_552.pdf con pulsante per visualizzare il PDF originale.
  2. Stabile 0021, Unità A-1:
     • In modalità 🏢 Condòmino (C): Totale Dovuto = € 847,69, con sezione e KPI Riscaldamento Centralizzato (€ 135,00), Ordinaria (€ 139,21), Straordinarie Causa Scillia e Lavori (€ 573,48), e PDF EC_005.pdf.