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

70 lines
2.7 KiB
Markdown

# 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