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

4.8 KiB

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).