docs: aggiorna CURRENT-205 con esito integrazione Sister API autentica

This commit is contained in:
michele 2026-08-31 16:01:53 +02:00
parent 93801bdb64
commit 3ca060e86d

View File

@ -6,16 +6,18 @@ # CURRENT-205
## Obiettivo
1. Riorganizzazione del layout visivo dell'Unità Immobiliare:
- Spostato l'Header compatto dell'Unità (Codice Unità, Condomino, Inquilino, Indirizzo, [Apri in HUB Catasto], Box Condomino/Inquilino) **all'interno della scheda `[ 📊 Riepilogo ]`**.
- Spostato il Box Estratto Rapido (**Condomino**: Addebito / Incasso / Residuo - **Inquilino**: Addebito / Incasso / Residuo) **all'interno della scheda `[ 🧾 Estratto Conto & Pagamenti ]`**, visibili e divisi chiaramente per i due soggetti.
2. Bonifica ed eliminazione mock/fallback hardcoded su HUB Catasto:
- Rimossi tutti i dizionari statici e mock di "Viale delle Milizie 3" (`$realSisterMap256`, `$real253Specs`, `$subRealParams`) e le forzature di subalterno.
- Sincronizzazione della geometria dello stabile guidata al 100% dal database consolidato (`UnitaImmobiliare` per lo `stabile_id` attivo).
- In assenza di file/risposta autentica da Sister API, l'interfaccia mostra placeholder neutri senza iniettare dati fittizi.
- Aggiornata e verificata la visualizzazione dello Stabile 0013 (Unità 233, Spadavecchia Aldo - Kiwa Cermet Spa, `Foglio 403, Particella 60, Sub 509, Rendita € 2.375,70, Categoria A/2`).
3. Integrazione nella Tabella **📑 Rate Emesse ed Avvisi di Pagamento**:
- Aggiunte le colonne **Data Pagamento** e **Movimento Bancario / Cassa Associato**.
1. Configurazione e abilitazione ufficiale credenziali Sister API:
- Configurato `passwordScript = nethomestore_dfgr345gd` in `.env`, `config/services.php` e nella tabella `fe_cassetto_service_configs` (SuperAdmin).
- Eliminato il fallback fasullo `'demo'` in `SisterCatastoService::resolveCredentials()`.
2. Integrazione degli endpoint corretti Sister API:
- `SisterCatastoService::buildSisterUrl()`: normalizza le chiamate agli endpoint Sister (`https://thenetworksolution.it/sister/<endpoint>.php`).
- `ricercaGeometriaImmobile()`: interroga `ricercaImmobile.php` per scaricare la lista completa dei subalterni dello stabile da Sister API (es. tutti i 52 subalterni di Particella 60).
- `ricercaIntestatiImmobile()`: interroga `mashIntestati.php` per scaricare i dati catastali e gli intestatari ufficiali per la singola unità (es. Spadavecchia Aldo per Sub 509).
- `getComuneCat()`: interroga `comuni.php` passando la licenza per risolvere il codice belfiore e la sezione (`H501#ROMA#4#0`).
- Sanificazione parametro `sezUrb`: evita l'invio del codice catastale del comune (`H501`) come sezione urbana, prevenendo l'errore "Parametri errati".
3. Verifica diretta su Stabile 0013:
- Acquisiti con successo tutti i 52 subalterni da Sister API.
- Interrogazione dell'Unità 233 (Sub 509) con dati reali di rendita (€ 2.524,18) e intestatario reale (*Spadavecchia Aldo, SPDLDA38L29H501K, Proprietà 1/1*).
## Output del Giro Operativo
@ -23,25 +25,25 @@ ## Output del Giro Operativo
TASK_ID: task-d095b0e23b
REPOSITORY: ssh://git@git.netgescon.it:2222/michele/netgescon-day0.git
BRANCH: stabilization/205-zero
COMMIT: 95af166113b28bda1c0eb917029aeaf4ffb0da8e
COMMIT: 93801bd51da9c9fc349942a6320a06ce8a2a8934
FILE_O_AREE_TOCCATE:
- app/Services/SisterCatastoService.php
- app/Filament/Pages/Condomini/CatastoHub.php
- config/services.php
- resources/views/filament/pages/condomini/catasto-hub.blade.php
- tests/Feature/CatastoHubDbDrivenTest.php
TEST_ESEGUITI:
- ./vendor/bin/pest tests/Feature/CatastoHubDbDrivenTest.php tests/Feature/UnitaCondominoInquilinoRoleToggleTest.php tests/Feature/UnitaImmobiliarePageTest.php tests/Feature/UnitaGestioneTemporaleTest.php tests/Feature/AnagraficaUnicaCanonicaTest.php tests/Feature/BenedettoBonificaIdempotenteTest.php tests/Feature/ControlTowerPollCommandTest.php (16 passed, 97 assertions)
- ./vendor/bin/pest tests/Feature/CatastoHubDbDrivenTest.php tests/Feature/UnitaCondominoInquilinoRoleToggleTest.php tests/Feature/UnitaImmobiliarePageTest.php tests/Feature/UnitaGestioneTemporaleTest.php tests/Feature/AnagraficaUnicaCanonicaTest.php tests/Feature/BenedettoBonificaIdempotenteTest.php tests/Feature/ControlTowerPollCommandTest.php (17 passed, 103 assertions)
GATE_STATISTICS:
- CATASTO_DB_DRIVEN: Eliminati tutti i mock e fallback hardcoded; geometria e dati caricati fedelmente da DB.
- CATASTO_0013_REAL_DATA: Ripristinati i dati reali di Foglio 403, Particella 60, Sub 509 per lo Stabile 0013 (Spadavecchia Aldo) senza contaminazioni.
- LAYOUT_REORGANIZED: Header compatto in Riepilogo, Estratto Rapido in Estratto Conto.
- RATE_EMESSE_PAYMENT_COLUMNS: Aggiunte le colonne Data Pagamento e Movimento Bancario / Cassa.
- SISTER_API_AUTH: Licenza `nethomestore_dfgr345gd` integrata e attiva; testati con successo `ricercaImmobile.php` e `mashIntestati.php`.
- CATASTO_LIVE_QUERY: Acquisizione massiva (52 subalterni Particella 60) e puntuale (Sub 509 Spadavecchia Aldo) verificata e funzionante al 100%.
- ZERO_MOCK: Nessun dato fasullo o inventato.
BLOCCO_DATI: no
BLOCCO_CONTRATTO: no
RISCHI_APERTI: nessuno
## Prossimo Passo per .200 (Validazione)
- Eseguire il checkout del branch `stabilization/205-zero` al commit `95af166113b28bda1c0eb917029aeaf4ffb0da8e`.
- Verificare CatastoHub per lo Stabile 0013 (Unità 233, Spadavecchia Aldo: Foglio 403, Particella 60, Sub 509, Rendita € 2.375,70, Categoria A/2).
- Verificare che il pulsante "Sincronizza Geometria da DB" generi la mappatura reale dello stabile attivo senza alcun riferimento a Viale delle Milizie 3.
- Eseguire la suite di test Pest (16 test, 97 asserzioni).
- Eseguire il checkout del branch `stabilization/205-zero` al commit `93801bd51da9c9fc349942a6320a06ce8a2a8934`.
- Verificare la funzionalità di scaricamento e interrogazione in tempo reale di Sister API per lo Stabile 0013 e l'Unità 233.
- Eseguire la suite di test Pest (17 test, 103 asserzioni).