Runbook Setup Tenant Commerciale

Scopo

Questo runbook descrive il setup iniziale di un tenant per attivare il modulo commerciale in modo coerente.

Prerequisiti

• tenant attivo e raggiungibile;
• utente admin operativo;
• anagrafiche base gia disponibili;
• servizi listino configurabili.
• nomenclatura route/menu allineata: Convenzioni Tenant e Route.

Nota tenant attuali:

• Besant usa tenant_besant
• Safecondo usa attualmente tenant_extra come chiave tecnica

Fase 1. Anagrafiche e tipologie

1. creare o verificare le anagrafiche cliente coinvolte;
2. assegnare tipologie coerenti:
3. Commerciale
4. Condominio
5. Amministratore
6. Studio Amministrativo
7. Prospect
8. verificare che il tenant_key sia coerente per tutti i record.

Controllo:

• una anagrafica commerciale deve essere selezionabile in:
• Commerciale -> Aziende Commerciali

Fase 2. Struttura organizzativa

1. creare Reti di Gestione;
2. creare Aziende Commerciali collegate alle anagrafiche cliente;
3. creare Reti Commerciali;
4. collegare le reti commerciali alla rete di gestione corretta.

Controllo:

• la select Azienda commerciale in Reti Commerciali deve essere popolata.

Fase 3. Utenti e ruoli

1. creare gli utenti interni;
2. assegnare il ruolo FAB coerente:
3. rete commerciale
4. rete di gestione
5. tecnico
6. usare Commerciale -> Matrice Permessi come riferimento.
7. usare Commerciale -> Onboarding Utenti per assegnare il profilo tenant:
8. commerciale
9. gestione
10. tecnico
11. amministratore_condominio
12. utente_condominio
13. da Onboarding Utenti usare azione Applica permessi per allineare il ruolo FAB standard.
14. usare Commerciale -> Utenti Tenant per:
15. creare nuovi utenti del tenant;
16. disabilitare/riabilitare utenti;
17. rimuovere utenti dal tenant (disattivazione controllata).

Controllo:

• login riuscito;
• menu coerente col ruolo.

Fase 4. Collegamenti business

1. collegare l'utente commerciale a Commerciale -> Commerciali;
2. collegare l'utente gestione a Commerciale -> Reti di Gestione;
3. collegare il tecnico tramite:
4. Commerciale -> Incarichi Tecnici per Servizio

Controllo:

• Commerciale -> Diagnostica Visibilita' deve mostrare un perimetro coerente.

Fase 5. Servizi e listini

1. creare o verificare il Listino;
2. creare o verificare i Servizi Listino;
3. associare i listini alle reti in Commerciale -> Listini per Rete;
4. per RAS, configurare:
5. pricing mode
6. fasce
7. regole
8. equivalenze
9. preset tenant
10. impostare il workflow_type corretto per ogni servizio;
11. in Commerciale -> Impostazioni, impostare Servizi attivi (codici):
12. solo RAS: RAS_CONDOMINIO.

Controllo:

• RAS deve essere calcolabile in:
• Commerciale -> Calcolo RAS

Fase 6. Collegamenti cliente-servizio-rete

1. creare Clienti per Servizio e Rete;
2. impostare i consensi:
3. consuntivi
4. documenti
5. economics
6. verificare il perimetro della rete di gestione.

Controllo:

• l'utente gestione deve vedere solo i record consentiti.

Fase 6-bis. Scope utenti condominio

Per profili amministratore_condominio e utente_condominio:

1. aprire Commerciale -> Utenti -> Condomini;
2. associare ogni utente ai soli condomini autorizzati;
3. opzionale: marcare il condominio principale.

Effetto:

• in Anagrafiche -> Clienti l'utente vede solo i condomini assegnati;
• nelle viste commerciali (Richieste, Trattative, Offerte) vede solo il perimetro assegnato.

Fase 7. Portale amministratore

1. creare o verificare gli Amministratori Condominio;
2. collegare i condomini in:
3. Condomini per Amministratore
4. generare il link portale;
5. testare una richiesta servizio.

Controllo:

• il portale deve mostrare i condomini corretti;
• la richiesta deve comparire in Richieste Servizio.

Fase 8. Validazione finale

Testare:

1. Commerciale -> Richieste Servizio
2. Commerciale -> Trattative
3. Commerciale -> Offerte
4. Servizi -> Ticket
5. Documentale -> Documenti
6. download allegato richiesta
7. download documento offerta

To-Do operativi per gestori/reti:

• eseguire seed base:
• flask --app app seed_productivity_defaults --force
• verificare in Produttivita -> My To-Do la presenza task scope:
• rete_gestione
• rete_commerciale
• tecnico
• amministratore_condominio

Errori comuni

Select vuote

Cause tipiche:

• tipologia mancante;
• record ponte non creato;
• tenant key incoerente.

Perimetro sbagliato

Cause tipiche:

• utente non collegato al record business;
• Clienti per Servizio e Rete non configurato;
• incarico tecnico mancante;
• consensi rete di gestione non impostati.

RAS non calcola correttamente

Cause tipiche:

• pricing mode errato;
• fasce incomplete;
• equivalenze non coerenti;
• preset tenant sbagliato.