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

58 lines
4.1 KiB
Markdown

# CURRENT-205
TASK_ID: task-nominativi-affitti-adminer-db
MACHINE: .205
STATO: completato
## Obiettivo Completato
1. **Risoluzione Definitiva Nominativi Stabile (`/admin-filament/condomini/nominativi`)**:
- Agganciata la query di caricamento al modello di dominio canonico relazionale (`unita_immobiliari`, `persone_unita_relazioni`, `persone`), identico a quello impiegato nella scheda Unità Immobiliare (`UnitaImmobiliarePage`).
- Risolto il matching per `anno_gestione_attivo`, eliminando qualsiasi divergenza tra l'elenco nominativi e le singole unità immobiliari.
- Corretto il metodo di risoluzione rubrica/persona e i filtri di ricerca per condomino e inquilino.
- Link diretti operativi per saltare alla Scheda Unità o alla Scheda Persona in Anagrafica Unica.
2. **Modernizzazione & Integrazione Gestione Affitti (`/admin-filament/affitti/gestione`)**:
- Collegamento bidirezionale con `unita_immobiliari` (locali tecnici, appartamenti, parti comuni a reddito dello stabile) con pulsante diretto "🏠 Scheda Unità".
- Sincronizzazione automatica 1-click dei dati catastali consolidati (`foglio`, `particella`, `subalterno`, `categoria_catastale`, `rendita_catastale`, `classe`, `consistenza`, `piano`, `interno`, `superficie_catastale_mq`, `destinazione_uso`).
- Collegamento diretto con **Anagrafica Unica** (`persone`) per la selezione del conduttore e gestione multi-inquilino/co-intestatari con link "🪪 Anagrafica Conduttore".
- Nuova interfaccia grafica moderna con barra dei pulsanti iconici coordinata, 5 KPI Summary Cards (Locazioni Totali, Canoni Dovuti, Canoni Incassati, Saldo Pendenze, Avvisi & Scadenze) e navigazione a pill-tabs responsive.
3. **Visualizzatore Database Grafico (Adminer) Configurato & Integrato**:
- Risolto il wrapper `public/adminer.php` con credenziali pre-configurate per accesso automatico alle 256 tabelle di MariaDB/MySQL (`netgescon` e `gescon_import`) e PostgreSQL.
- Aggiunto link diretto "Visualizza Database (Adminer)" nella navigazione Filament (gruppo Impostazioni) e nel menu utente in alto a destra.
## Output del Giro Operativo
ESITO_205: riuscito
TASK_ID: task-nominativi-affitti-adminer-db
REPOSITORY: ssh://git@git.netgescon.it:2222/michele/netgescon-day0.git
BRANCH: stabilization/205-zero
COMMIT: 98e841b
FILE_O_AREE_TOCCATE:
- app/Filament/Pages/Condomini/NominativiStabile.php
- app/Filament/Pages/Affitti/GestioneAffitti.php
- resources/views/filament/pages/affitti/gestione-affitti.blade.php
- app/Providers/Filament/AdminFilamentPanelProvider.php
- public/adminer.php
- skill-netgescon/control-tower/CURRENT-205.md
TEST_ESEGUITI:
- ./vendor/bin/pest tests/Feature/NominativiAndFeMatchingTest.php tests/Feature/PostaImapWebmailAndProtocolloTest.php tests/Feature/ContabilitaRelazionaleOrdinarieTest.php tests/Feature/BpmBankParserAndImporterTest.php tests/Feature/UnitaGestioneTemporaleTest.php tests/Feature/CatastoHubDbDrivenTest.php tests/Feature/UnitaCondominoInquilinoRoleToggleTest.php tests/Feature/UnitaImmobiliarePageTest.php tests/Feature/BenedettoBonificaIdempotenteTest.php tests/Feature/ControlTowerPollCommandTest.php (32 passed, 213 assertions)
GATE_STATISTICS:
- NOMINATIVI_CANONICAL_ALIGNMENT: 100% allineato all'archivio canonico unita_immobiliari/persone_unita_relazioni.
- AFFITTI_UNITA_CATASTO_LINKAGE: Sincronizzazione automatica 1-click dei dati catastali e deep link a Scheda Unità.
- AFFITTI_ANAGRAFICA_UNICA_LINKAGE: Selezione conduttore da persone/anagrafica unica con deep link.
- AFFITTI_MODERN_UI: KPI summary cards, pill tabs e design uniforme.
- ADMINER_DB_VISUALIZER: Autenticazione automatica e navigazione integrata in Filament.
- TEST_SUITE: 32 test Feature passati (213 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 (32 passed, 213 assertions).
- Verificare la visualizzazione dei Nominativi (`/admin-filament/condomini/nominativi`), la Gestione Affitti (`/admin-filament/affitti/gestione`) e l'accesso al Visualizzatore Database (`/adminer.php` o voce di menu in Impostazioni).