netgescon-day0/skill-netgescon/control-tower/CURRENT-205.md
michele 6543dcc19e feat(estratto-conto): rettifica inquilino 0013, supporto stabile 0021 e archivio pdf gescon
- Inquilino 0013: escluse spese straordinarie (residuo 0,00 €), ripartizione atomica ordinaria 2026 su 5 rate con pagamenti 560,00 € e residuo esatto 731,30 € (match EC_553.pdf)
- Stabile 0021: abilitato riscaldamento centralizzato (135,00 €), aggregazione cantina CAN/01 con A/1 e calcolo totale esatto 847,69 € (match EC_005.pdf)
- Archivio PDF: integrata tabella Protoc_EC e rotta admin.gescon.ec.pdf per visualizzazione/download documenti originali
- Livewire: preservato tab attivo in loadUnita durante cambi ruolo e refresh MDB
2026-09-12 17:41:41 +02:00

78 lines
5.9 KiB
Markdown

# 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`.