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

69 lines
4.8 KiB
Markdown

# CURRENT-205
TASK_ID: task-nethome-imap-webmail-protocollo
MACHINE: .205
STATO: completato
## Obiettivo Completato
1. **Gestione Posta Studio & 16 Stabili (IMAP, Webmail, Scheda Amministratore)**:
- Sviluppato supporto per caselle di posta e PEC dello **Studio Amministratore** (`stabile_id = null`, storage in `storage/app/private/amministratori/{cod_adm}/studio/posta_{ordinaria|pec}/{anno}/`).
- Webmail Posta Ordinaria e PEC dotate di filtro rapido per Stabile o Studio, pulsante per configurazione diretta IMAP e gestione stati cartelle vuote.
- Nella Scheda Amministratore (Tab Posta / API): implementata la tabella di monitoraggio live di tutti i 16 stabili con conteggi messaggi `.eml`, stato configurazione IMAP/PEC, link diretti alla configurazione e pulsanti di test/sincronizzazione per le caselle di studio.
2. **Risoluzione Multi-Allegato & Timeline Protocollo (`ArchiveFileResolver`)**:
- Creato il resolver euristico `ArchiveFileResolver` per individuare file legacy e moderni tra radici storage e cartelle (`E_C/`, `INC_EC/`, `WA/`, `XML/`, `allegati/`, `posta/`, `documenti/`).
- Aggiornata la scheda Unità Immobiliare (Tab Comunicazioni & Protocollo) con supporto a `posta_dett`, `corrisp_inviata`, `protoc_ec` e `communication_messages`, con rendering di chip allegati dedicati con icone, badge di presenza ed anteprima modale istantanea.
3. **Modernizzazione Ticket Gestione & Hub Documentale**:
- `TicketGestione`: KPI statistiche in testata, selettore filtri pill-bar, gestione rapida categorie, badge priorità/stato, filtri per fornitore operativo e gestione pratiche assicurative.
- `DocumentiArchivio`: Hub documentale centralizzato digitale e fisico, con anteprime QR, gestione template Drive e codici mnemonici `DOC-XXXX` / `AF-X-XXXX`.
4. **Fornitore Nethome SAS (`10055221005`) & Codici Stabili**:
- Censito e associato trasversalmente per compensi e fatturazione su tutti i 16 stabili.
- Codici mnemonici `cod_stabile` sincronizzati da `Stabili.mdb`.
## Output del Giro Operativo
ESITO_205: riuscito
TASK_ID: task-nethome-imap-webmail-protocollo
REPOSITORY: ssh://git@git.netgescon.it:2222/michele/netgescon-day0.git
BRANCH: stabilization/205-zero
COMMIT: 3265562
FILE_O_AREE_TOCCATE:
- app/Services/Documenti/ArchiveFileResolver.php
- app/Services/Posta/EmlParser.php
- app/Services/Posta/ImapClient.php
- app/Services/Posta/ImapMailboxService.php
- app/Console/Commands/FetchMailboxesCommand.php
- app/Filament/Pages/Posta/PostaOrdinariaWebmail.php
- app/Filament/Pages/Posta/PostaPecWebmail.php
- resources/views/filament/pages/posta/webmail.blade.php
- app/Filament/Pages/Impostazioni/SchedaAmministratore.php
- resources/views/filament/pages/impostazioni/partials/scheda-amministratore-posta-operativita.blade.php
- app/Filament/Pages/Condomini/StabilePage.php
- resources/views/filament/pages/condomini/tabs/posta-ufficiale.blade.php
- app/Filament/Pages/UnitaImmobiliarePage.php
- resources/views/filament/pages/unita-immobiliare.blade.php
- resources/views/filament/pages/supporto/ticket-gestione.blade.php
- tests/Feature/PostaImapWebmailAndProtocolloTest.php
- skill-netgescon/control-tower/CURRENT-205.md
TEST_ESEGUITI:
- ./vendor/bin/pest tests/Feature/PostaImapWebmailAndProtocolloTest.php tests/Feature/NominativiAndFeMatchingTest.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/AnagraficaUnicaCanonicaTest.php tests/Feature/BenedettoBonificaIdempotenteTest.php tests/Feature/ControlTowerPollCommandTest.php (35 passed, 223 assertions)
GATE_STATISTICS:
- STUDIO_MAILBOX_INGESTION: Gestione caselle posta/PEC studio e storage locale dedicato.
- STABILI_MAILBOX_MONITORING: Monitoraggio tabellare dei 16 stabili nella Scheda Amministratore con link diretti.
- MULTI_ATTACHMENT_RESOLVER: `ArchiveFileResolver` operativo su 7 cartelle e storage.
- WEBMAIL_UI_QUICK_ACTIONS: Bottone Configura IMAP, badge e filtri responsive.
- TICKET_GESTIONE_MODERNIZATION: KPI cards, filtri di stato, gestione categorie e assegnazioni.
- TEST_SUITE: 35 test Feature passati con successo (223 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 (35 passed, 223 assertions).
- Verificare la Webmail Posta Ordinaria (`/admin-filament/comunicazioni/posta-ordinaria`), PEC (`/admin-filament/comunicazioni/posta-pec`), Scheda Amministratore (`/admin-filament/impostazioni/amministratore?tab=posta-api`), Ticket Gestione (`/admin-filament/supporto/ticket-gestione`) e Scheda Unità (tab Comunicazioni & Protocollo).