Ruoli e Servizi¶

Scopo¶

Questa guida descrive il modello operativo dei ruoli per i servizi gestiti in SafeOps, con focus su:

Admin
Rete di Gestione
Rete Commerciale / Commerciale
Cliente
Tecnico / Fornitore Tecnico

Il riferimento vale in particolare per i flussi:

RAS
Offerta semplice
Ticket diretto
Richiesta documentale

Approfondimenti collegati:

Regola base¶

La piattaforma non usa un albero rigido di visibilita. Usa invece:

anagrafiche del tenant,
tipologie cliente,
collegamenti per servizio,
incarichi tecnici,
consensi di visibilita.

Questo permette di gestire:

clienti collegati a piu reti commerciali,
servizi diversi per lo stesso cliente,
tecnici incaricati solo su un perimetro specifico,
reti di gestione che vedono solo i dati consentiti.

Livelli organizzativi¶

1. Admin¶

L'Admin interno ha visione di controllo e configurazione.

Responsabilita principali:

crea e mantiene anagrafiche e tipologie;
definisce reti di gestione e reti commerciali;
configura servizi, listini e regole;
controlla permessi, policy menu e perimetri;
usa le viste di diagnostica e matrice permessi.

Visibilita:

non e limitato dal perimetro commerciale/tecnico se non viene collegato a un profilo scoped;
usa il control plane per verifiche e manutenzione.

Voci chiave:

Commerciale -> Matrice Permessi
Commerciale -> Diagnostica Visibilita'
Commerciale -> Impostazioni

Cosa fanno:

Commerciale -> Matrice Permessi: mostra i permessi FAB minimi consigliati per i profili operativi.
Commerciale -> Diagnostica Visibilita': mostra il perimetro reale e i permessi effettivi dell'utente.
Commerciale -> Impostazioni: raccoglie le configurazioni operative e di supporto del modulo commerciale.

2. Rete di Gestione¶

La Rete di Gestione e il livello di coordinamento sopra una o piu reti commerciali.

Responsabilita principali:

supervisiona i clienti e i servizi nel perimetro consentito;
controlla stato richieste, trattative e offerte;
monitora consuntivi e documenti solo dove esiste consenso;
coordina il flusso operativo, senza sovrapporsi alla rete commerciale.

Visibilita:

vede solo i clienti collegati tramite Clienti per Servizio e Rete;
vede solo i servizi per cui la rete commerciale ha dato consenso;
il consenso puo essere separato per:
consuntivi,
documenti,
economics.

Voci chiave:

Commerciale -> Reti di Gestione
Commerciale -> Clienti per Servizio e Rete
Commerciale -> Richieste Servizio

Cosa fanno:

Commerciale -> Reti di Gestione: governa il livello di coordinamento sopra le reti commerciali.
Commerciale -> Clienti per Servizio e Rete: mostra come clienti, servizi e reti sono collegati.
Commerciale -> Richieste Servizio: consente di leggere le richieste nel perimetro consentito.

3. Rete Commerciale / Commerciale¶

La Rete Commerciale gestisce acquisizione, trattativa, offerta e relazione commerciale.

Responsabilita principali:

gestisce le richieste in ingresso;
prende in carico e lavora le richieste;
crea offerte e rinnovi;
collega clienti, reti e servizi;
assegna i servizi tecnici ai soggetti operativi.

Visibilita:

vede solo i clienti collegati alla propria rete commerciale;
vede solo i servizi assegnati su quel collegamento;
non vede i dati di altre reti commerciali.

Voci chiave:

Commerciale -> Aziende Commerciali
Commerciale -> Reti Commerciali
Commerciale -> Richieste Servizio
Commerciale -> Trattative
Commerciale -> Offerte
Commerciale -> Servizi Attivi

Cosa fanno:

Commerciale -> Aziende Commerciali: raccoglie i soggetti commerciali coinvolti nel flusso.
Commerciale -> Reti Commerciali: definisce il perimetro delle reti commerciali operative.
Commerciale -> Richieste Servizio: e il punto di ingresso delle richieste in carico al commerciale.
Commerciale -> Trattative: segue la fase commerciale intermedia.
Commerciale -> Offerte: gestisce consultazione e verifica delle offerte.
Commerciale -> Servizi Attivi: mostra i servizi gia attivi sul perimetro cliente.

4. Cliente¶

Il Cliente vede solo il proprio perimetro.

Nel modello attuale il cliente puo essere:

un condominio,
uno studio,
un prospect,
una anagrafica collegata a una rete commerciale o a un amministratore.

Responsabilita principali:

consulta i propri dati;
interagisce sul proprio servizio;
riceve documenti, note e richieste;
puo essere collegato a piu reti commerciali, ma per servizi diversi.

Visibilita:

solo i propri dati;
solo le anagrafiche esplicitamente collegate;
nessuna visione su altri clienti o su altri servizi fuori perimetro.

5. Tecnico / Fornitore Tecnico¶

Il Tecnico o il Fornitore Tecnico opera solo dove c'e un incarico attivo.

Ingresso operativo consigliato:

menu Tecnici
Cruscotto Tecnici
Fornitori Tecnici
Incarichi Tecnici per Servizio
Tecnici e Assegnazioni

Responsabilita principali:

esegue l'intervento tecnico;
consulta ticket, richieste e documenti del cliente assegnato;
lavora sui servizi per cui e stato incaricato.

Visibilita:

solo clienti presenti in Incarichi Tecnici per Servizio;
solo per il servizio assegnato;
l'incarico puo essere assegnato da:
rete di gestione,
rete commerciale,
cliente,
amministratore.

Voci chiave:

Commerciale -> Incarichi Tecnici per Servizio
Servizi -> Ticket
Documentale -> Documenti

Cosa fanno:

Commerciale -> Incarichi Tecnici per Servizio: mostra e governa gli incarichi tecnici attivi.
Servizi -> Ticket: raccoglie l'operativita tecnica su ticket e interventi.
Documentale -> Documenti: mostra i documenti del perimetro tecnico autorizzato.

Flussi servizio¶

Ogni servizio ha un workflow_type che decide il comportamento applicativo.

RAS / Offerta¶

Uso:

richieste strutturate per RAS
trattativa commerciale
offerta RAS dedicata

Passi:

richiesta dal portale amministratore o da backoffice;
creazione Richiesta Servizio;
creazione Trattativa;
conversione in Offerta RAS;
eventuale conversione in ticket, documento e servizio attivo.

Offerta semplice¶

Uso:

servizi che richiedono una proposta economica ma non il motore RAS.

Passi:

richiesta servizio;
creazione trattativa;
creazione offerta semplice in bozza;
gestione commerciale.

Ticket diretto¶

Uso:

interventi operativi,
richieste che non richiedono passaggio commerciale completo.

Passi:

richiesta servizio;
creazione ticket;
assegnazione operativa;
esecuzione e chiusura.

Richiesta documentale¶

Uso:

servizi che portano soprattutto a raccolta o produzione documenti.

Passi:

richiesta servizio;
creazione record interno;
generazione documento di appoggio;
gestione documentale.

Portale amministratore¶

L'amministratore lavora tramite portale leggero, non tramite il gestionale interno completo.

Funzioni attive:

vede i condomini collegati;
apre una richiesta per un condominio;
seleziona il servizio;
inserisce dati iniziali;
allega documenti;
legge note pubbliche del commerciale;
risponde dal dettaglio richiesta;
vede lo stato della richiesta.

Questo flusso mantiene il controllo interno:

l'amministratore apre la richiesta;
il commerciale la prende in carico;
il sistema instrada verso il flusso corretto.

Regole anagrafiche¶

Tipologie cliente¶

Le tipologie sono fondamentali e sono many-to-many (cliente_tipologia).

Servono per:

riconoscere i soggetti commerciali;
distinguere amministratori, condomini e prospect;
suggerire preset e comportamenti;
filtrare le anagrafiche nelle view Commerciale.

Per i soggetti commerciali, una tipologia utile e:

Commerciale

Senza tipologia coerente, il filtro delle select puo escludere il record.

Aziende commerciali¶

Aziende Commerciali e il ponte tra:

anagrafica cliente del tenant,
rete commerciale,
ruoli e visibilita del modulo commerciale.

Flusso corretto:

creare / verificare l'anagrafica cliente;
assegnare tipologia commerciale;
creare il record in Commerciale -> Aziende Commerciali;
collegarlo poi a Reti Commerciali.

Checklist operativa minima¶

Setup iniziale¶

creare o verificare le tipologie cliente;
creare la rete di gestione;
creare l'azienda commerciale;
creare la rete commerciale;
collegare cliente-servizio-rete;
creare eventuali incarichi tecnici.

Verifica perimetro¶

aprire Commerciale -> Diagnostica Visibilita';
verificare clienti, richieste, trattative e offerte visibili;
controllare i permessi FAB nella stessa pagina;
testare download allegati e documenti con utente reale.

Presa in carico richiesta¶

aprire Commerciale -> Richieste Servizio;
assegnare il commerciale;
usare:
Prendi in carico
In lavorazione
aggiungere, se serve, una nota pubblica all'amministratore.

Errori comuni¶

Non vedo un'anagrafica nella select¶

Controllare:

tenant coerente (tenant_besant, tenant_ids, ecc.);
tipologia cliente corretta;
presenza del record ponte (Azienda Commerciale, Cliente per Servizio e Rete, ecc.).

Vedo troppo o troppo poco¶

Controllare:

collegamento dell'utente interno al ruolo business;
permessi FAB del ruolo;
perimetro in Diagnostica Visibilita';
consensi sul link cliente-servizio.

Il tecnico vede dati non coerenti¶

Controllare:

Incarichi Tecnici per Servizio;
stato incarico (attivo);
cliente e servizio corretti;
origine incarico.