# 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