netgescon-day0/docs/OPERATIVITA-STUDIO-COLLABORATORI-POSTA.md

Operativita Studio: Collaboratori, SMDR e Posta

Collaboratori studio da Rubrica Universale

Percorso operativo previsto:

1. Crea o aggiorna il nominativo in Rubrica Universale con email reale.
2. Apri la scheda rubrica del nominativo.
3. Usa la tab Collaboratore studio.
4. Abilita l'accesso collaboratore.
5. Assegna l'interno PBX.
6. Seleziona gli stabili del tenant da associare al collaboratore.
7. Salva interno e stabili.

Regole applicative:

• Se esiste gia un utente con la stessa email, il sistema riusa quell'utente.
• Viene aggiunto il solo ruolo collaboratore senza rimuovere eventuali altri ruoli gia presenti.
• La sincronizzazione degli stabili agisce solo sugli stabili dell'amministratore corrente.
• Gli stabili assegnati fuori tenant non vengono rimossi.

SMDR / Post-It tecnico

La tab tecnica Post-It ora distingue tre casi:

• Interno collaboratore: numero riconosciuto come users.pbx_extension.
• Numero studio gestito: numero esterno che coincide con uno dei numeri centralino configurati nella scheda amministratore.
• Numero esterno: tutto cio che non rientra nei due casi precedenti.

Filtri disponibili:

• vista chiamate: esterne, tutte, interne
• ambito numero: tutti, studio, interno, esterno
• direzione: inbound, outbound, internal
• ricerca libera su numero, interno o raw line

Nota tecnica:

• gli interni PBX non vengono piu risolti tramite Rubrica Universale come se fossero telefoni esterni.

Posta: stato reale e percorso consigliato

Stato attuale:

• configurazione SMTP presente
• configurazione Google OAuth presente
• configurazione caselle Gmail/IMAP/PEC presente
• archiviazione manuale EML su ticket presente
• polling automatico caselle non ancora implementato come flusso applicativo stabile

Percorso consigliato per rendere la posta pronta via web:

1. Attiva un dominio posta reale, ad esempio netgescon.it su Google Workspace.
2. Crea la casella operativa, ad esempio info@netgescon.it o studio@netgescon.it.
3. Mantieni netgescon@gmail.com solo come account storico o tecnico, non come casella principale di produzione.
4. Configura in Scheda Amministratore:
   • client id
   • client secret
   • redirect uri
   • workspace email
   • label/query Gmail
5. Usa il pulsante web Collega Google.
6. Usa il pulsante web Verifica Google OAuth per controllare APP_URL, redirect e credenziali.
7. Quando il check e pulito, il passo successivo di sviluppo da fare e un importer applicativo per Gmail/IMAP che trasformi i messaggi in communication_messages, ticket o documenti.

Indicazione architetturale:

• tutte le verifiche e le azioni operative vanno esposte da pagina web amministrativa
• la shell deve restare uno strumento di manutenzione, non il percorso operativo principale del prodotto ospitato