From bbab57f4be0737e57ac093f711a06e546b35a631 Mon Sep 17 00:00:00 2001 From: michele Date: Thu, 27 Aug 2026 18:02:05 +0200 Subject: [PATCH] feat(acl): add extensible dynamic permission matrix, multi-channel contacts, mobile UI strategy, and legacy dual-run directives (task-d095b0e23b) --- directives/ANAGRAFICHE_MAPPING_LEGACY.md | 19 +++ .../ui-wireframes/utente-multi-ruolo.md | 113 ++++++++++++++---- 2 files changed, 109 insertions(+), 23 deletions(-) diff --git a/directives/ANAGRAFICHE_MAPPING_LEGACY.md b/directives/ANAGRAFICHE_MAPPING_LEGACY.md index 3e9a42b..1d3bf5d 100644 --- a/directives/ANAGRAFICHE_MAPPING_LEGACY.md +++ b/directives/ANAGRAFICHE_MAPPING_LEGACY.md @@ -71,4 +71,23 @@ ## 10. Importazione Automatica Amministratori da Legacy (`Stabili.mdb`) - **Comando di importazione**: `php artisan gescon:import-amministratori-legacy` - Esegue l'estrazione automatica degli amministratori dalla tabella `Stabili` dei file MDB (`Stabili.mdb`), popola la tabella `amministratori` e crea i relativi utenti di sistema con codice univoco canonico (es. `00000001`, `00000002`). +## 11. Matrice Permessi ACL Dinamica ed Estensibile per Moduli +- **Nessun Limite Rigido**: I permessi e le autorizzazioni applicative non sono cablati a codice ma gestiti in una matrice estensibile raggruppata per **Moduli Applicativi** (es. *Core, Contabilità, Assemblee, FE/Cassetto, Privacy, Catasto, Manutenzioni, CTI/PBX*). +- **Estensione Futura**: L'aggiunta di un nuovo modulo o ruolo registra automaticamente i nuovi permessi delegabili senza intaccare la struttura applicativa. + +## 12. Gestione Recapiti Multicanale Illimitati (`rubrica_contatti_canali`) +- **Architettura Multi-Canale**: Ogni anagrafica/utente può associare un numero illimitato di contatti multicanale: + - **Multi-Email**: Email Principale, Email Studio, Email Personale, PEC 1, PEC 2, ecc. + - **Multi-Cellulare**: Cellulare Principale, Reperibilità Urgenze H24, WhatsApp Studio, ecc. + - **Multi-Telefono Fisso**: Fisso Studio, Fisso Abitazione, Centralino VOIP (interno), Fax 1, Fax 2, ecc. +- **Materializzazione**: I recapiti aggiuntivi sono conservati nella tabella `rubrica_contatti_canali` specificando `tipo`, `etichetta`, `valore` e flag `is_principale`. + +## 13. Strategia Display Desktop (High-Density) & Mobile (Adaptive Responsive Cards) +- **Desktop (High-Density Grid)**: Layout multi-colonna ad elevata densità informativa per sfruttare la risoluzione monitor del PC ed analizzare griglie contabili, millesimi e badge recapiti. +- **Mobile (Responsive Adaptive Cards)**: Schede adattive collassabili per smartphone e tablet, ottimizzate con target touch per consultazione e gestione rapida in mobilità. + +## 14. Coesistenza Temporanea in Contemporanea (Legacy MDB <-> NetGescon) +- **Modalità Parallela (Dual-Run)**: Durante la fase di migrazione e transizione, il sistema supporta il lavoro in contemporanea tra il vecchio software Legacy MDB ed il nuovo NetGescon (MySQL / PostgreSQL). +- **Importazione Differenziale Incrementale**: Le pipeline di sincronizzazione (`php artisan gescon:load-mdb-staging --incremental`) importano le novità e le modifiche apportate sul legacy senza mai distruggere o resettare i dati già consolidati in NetGescon (il reset richiede l'opzione esplicita `--reset-temp`). + diff --git a/skill-netgescon/ui-wireframes/utente-multi-ruolo.md b/skill-netgescon/ui-wireframes/utente-multi-ruolo.md index 59e489f..dcee78a 100644 --- a/skill-netgescon/ui-wireframes/utente-multi-ruolo.md +++ b/skill-netgescon/ui-wireframes/utente-multi-ruolo.md @@ -1,37 +1,72 @@ -# ASCII Wireframe - Gestione Utenti Multi-Ruolo & ACL Impersonificazione (/admin-filament/superadmin/utenti) +# ASCII Wireframe - Gestione Utenti Multi-Ruolo, Multi-Recapiti & Matrice ACL Dinamica (/admin-filament/superadmin/utenti) + +## 1. VISUALIZZAZIONE DESKTOP (High-Density Multi-Column Grid) ```text +-------------------------------------------------------------------------------------------------------------------+ | NETGESCON - CENTRO STELLA SYSTEM MANAGEMENT [SuperAdmin: Michele] | +-------------------------------------------------------------------------------------------------------------------+ -| PATH: Home > Super Admin > Gestione Utenti & Matrice Ruoli ACL | +| PATH: Home > Super Admin > Gestione Utenti, Multi-Recapiti & Matrice Moduli ACL | +-------------------------------------------------------------------------------------------------------------------+ | | -| [ + NUOVO UTENTE MULTI-RUOLO ] [ 🔍 Cerca per Nome, Email, Ruoli... ] [ Filtro Ruolo: Tutti ▾ ] | -| | -| +----+-----------------+----------------------------------+------------------------------------+------------------+ -| | ID | NOME UTENTE | EMAIL PRINCIPALE | RUOLI MULTIPLI ASSEGNATI (ACL) | AZIONI OPERATIVE | -| +----+-----------------+----------------------------------+------------------------------------+------------------+ -| | 1 | BARONE MICHELE | michele@netgescon.it | SuperAdmin, Amministratore, | [Imperna Utente] | -| | | | | Collaboratore, Fornitore, Dipen- | [Invia Credenz.] | -| | | | | dente, Condomino | [Reset Password] | -| | 2 | Conforti Ignazio| ignaziovittorio.conforti@tin.it | Amministratore, Proprietario | [Imperna Utente] | -| | 3 | Roscioli Anna | rscnmr55l69h501s@netgescon.it | Amministratore, Collaboratore | [Imperna Utente] | -| +----+-----------------+----------------------------------+------------------------------------+------------------+ +| [ + NUOVO UTENTE MULTI-RUOLO ] [ 🔍 Cerca per Nome, Email, Tel, Ruoli... ] [ Filtro Ruolo / Modulo: Tutti ▾ ] | | | +| +----+-----------------+-----------------------------------+--------------------------------+---------------------+ +| | ID | NOME UTENTE | RECAPITI MULTICANALE (MULTI-CANALI)| RUOLI MULTIPLI ASSEGNATI (ACL) | AZIONI OPERATIVE | +| +----+-----------------+-----------------------------------+--------------------------------+---------------------+ +| | 1 | BARONE MICHELE | ✉ michele@netgescon.it (Princ) | • SuperAdmin | [⚡ Imperna Utente] | +| | | | ✉ studio@netgescon.it (Studio) | • Amministratore Stabile | [📧 Invia Credenz.] | +| | | | ✉ michele.barone@pec.it (PEC) | • Collaboratore Studio | [🔑 Reset Password] | +| | | | 📱 335-1234567 (Cell Princ) | • Fornitore Accreditato | [📱 Recapiti (12) ] | +| | | | 📱 340-9876543 (Reperibilità H24) | • Dipendente Studio | | +| | | | ☎ 06-12345678 (Fisso Studio) | • Condomino / Proprietario | | +| | 2 | Conforti Ignazio| ✉ ignazio.conforti@tin.it | • Amministratore Stabile | [⚡ Imperna Utente] | +| | | | 📱 335-295285 (Cell) | • Proprietario | [📱 Recapiti (4) ] | +| | 3 | Roscioli Anna | ✉ rscnmr55l69h501s@netgescon.it | • Amministratore Stabile | [⚡ Imperna Utente] | +| | | | ☎ 06-87654321 (Fisso Studio) | • Collaboratore Studio | [📱 Recapiti (3) ] | +| +----+-----------------+-----------------------------------+--------------------------------+---------------------+ +-------------------------------------------------------------------------------------------------------------------+ -| MASCHERA REGISTRAZIONE / EDITING UTENTE MULTI-RUOLO (#1) | +``` + +## 2. MASCHERA REGISTRAZIONE / SCHEDA DETTAGLIO UTENTE MULTI-RUOLO & MULTI-RECAPITI + +```text ++-------------------------------------------------------------------------------------------------------------------+ +| MASCHERA REGISTRAZIONE / EDITING UTENTE MULTI-RUOLO (#1 BARONE MICHELE) | ++-------------------------------------------------------------------------------------------------------------------+ +| DATI ANAGRAFICI BASE: | +| [ Nome Completo: BARONE MICHELE ] [ Codice Fiscale: BRNMHL69M11H501K ] | +| [ Scadenza Accesso: Nessuna / Illimitato ] [ Studio Riferimento: Studio Barone Michele ▾ ] | | | -| [ Nome Completo: BARONE MICHELE ] [ Email: michele@netgescon.it ] | -| [ Scadenza Accesso: Nessuna / Illimitato ] [ Studio di Riferimento: Studio Barone Michele ▾ ] | +| SEZIONE RECAPITI MULTICANALE DINAMICI (UNLIMITED MULTI-CHANNEL CONTACTS): | +| +-------------------------------------------------------------------------------------------------------------+ | +| | CANALE | ETICHETTA / USO | VALORE CONTATTO | PRINCIPALE | AZIONE | | +| +-------------------------------------------------------------------------------------------------------------+ | +| | Email | Principale | michele@netgescon.it | [X] | [Elimina] | | +| | Email | Studio Legale | studio.barone@netgescon.it | [ ] | [Elimina] | | +| | Email PEC | PEC Ufficiale | michele.barone@pec.it | [ ] | [Elimina] | | +| | Cellulare | Personale H24 | +39 335 1234567 | [X] | [Elimina] | | +| | Cellulare | Reperibilità Urgenze | +39 340 9876543 | [ ] | [Elimina] | | +| | Telefono Fisso | Studio Viale Milizie 9a | 06 12345678 | [X] | [Elimina] | | +| | Telefono Fisso | Centralino VOIP | 06 87654321 (Int. 101) | [ ] | [Elimina] | | +| +-------------------------------------------------------------------------------------------------------------+ | +| [ + AGGIUNGI NUOVO CANALE RECAPITO (EMAIL / CELLULARE / FISSO / PEC / VOIP / FAX) ] | | | -| SELEZIONE RUOLI CONTESTUALI MULTIPLI (ACL ROLE MATRIX): | -| [X] Super Admin (Accesso completo sistema e Centro Stella) | -| [X] Amministratore Stabile (Gestione contabile, fatture FE e stabili del proprio studio) | -| [X] Collaboratore Studio (Operatività limitata agli stabili delegati dallo studio) | -| [X] Fornitore Accreditato (Caricamento fatture, interventi ed albero lavorazioni) | -| [X] Dipendente Studio (Presenze, note spese e gestione task operative) | -| [X] Condomino / Proprietario(Consultazione rate, verbale assemblea ed estratti conto propri) | +| MATRICE RUOLI & PERMESSI MODULARI ESTENSIBILI (DYNAMIC ACL MODULE MATRIX): | +| +-------------------------------------------------------------------------------------------------------------+ | +| | MODULO CORE & AMMINISTRAZIONE | MODULO CONTABILITÀ & FATTURE ELETTRONICHE | | +| | [X] Super Admin (Centro Stella) | [X] Gestione Preventivi / Consuntivi | | +| | [X] Amministratore Stabile | [X] Scarico FE / Cassetto Fiscale | | +| | [X] Collaboratore Studio | [X] Gestione Incassi & Solleciti | | +| | | | | +| | MODULO FORNITORI & MANUTENZIONI | MODULO ASSEMBLEEE & COMUNICAZIONI CTI | | +| | [X] Accesso Portal Fornitore | [X] Convocazione / Verbale Assemblee | | +| | [X] Assegnazione Ticket / Interventi | [X] Integrazione Centralino PBX / CTI | | +| | | | | +| | MODULO CONDOMINI & PORTALE INQUILINI | MODULI ESTERNI & ESTENSIONI FUTURIBILI | | +| | [X] Portale Condomino / Estratto Conto | [X] Integrazione Catasto Sister | | +| | [X] Dipendente Studio (Note Spese/Pres.) | [ + CREA / ATTIVA NUOVO PERMESSO MODULO CUSTOM ] | | +| +-------------------------------------------------------------------------------------------------------------+ | | | | AZIONI DI SICUREZZA ED AUDIT: | | [ ⚡ IMPERNA SOGGETTO (TEST CONTESTO E AUDIT COMPLIANCE) ] | @@ -41,3 +76,35 @@ # ASCII Wireframe - Gestione Utenti Multi-Ruolo & ACL Impersonificazione (/admin | [ SALVA UTENTE E REGISTRA ACL ] [ ANNULLA ] | +-------------------------------------------------------------------------------------------------------------------+ ``` + +## 3. VISUALIZZATIONE RESPONSIVE MOBILE (Adaptive Collapsible Card View) + +```text ++--------------------------------------------------+ +| 📱 NETGESCON MOBILE [SuperAdmin: M] | ++--------------------------------------------------+ +| UTENTI & RECAPITI (3 Utenti Registrati) | +| [ + NUOVO UTENTE ] [ 🔍 Cerca... ] | ++--------------------------------------------------+ +| 👤 BARONE MICHELE (ID #1) | +| • Ruoli: SuperAdmin, Admin, Fornitore, Condomino | +| • Studio: Studio Barone Michele | +| ──────────────────────────────────────────────── | +| RECAPITI PRINCIPALI (12 Canali Registrati): | +| ✉ michele@netgescon.it (Principale) | +| ✉ michele.barone@pec.it (PEC) | +| 📱 335-1234567 (Cellulare H24) | +| ☎ 06-12345678 (Fisso Studio) | +| ──────────────────────────────────────────────── | +| AZIONI APPARATO MOBILE: | +| [ ⚡ Imperna Utente ] | +| [ 🔑 Reset Password ] [ 📧 Invia Credenziali ] | +| [ 📋 Gestisci Tutti i 12 Recapiti ▾ ] | +| [ 🛡️ Modifica Permessi Modulari ACL ▾ ] | ++--------------------------------------------------+ +| 👤 Conforti Ignazio (ID #2) | +| • Ruoli: Amministratore Stabile, Proprietario | +| ✉ ignazio.conforti@tin.it | 📱 335-295285 | +| [ ⚡ Imperna Utente ] [ 📱 Gestisci Recapiti ] | ++--------------------------------------------------+ +```