Vai al contenuto

Moduli e Flussi

Moduli principali

  • anagrafiche: clienti, tipologie, ATECO, geo alias, dipendenti, contesto.
  • documentale: categorie, upload documenti, versioni, checklist.
  • tickets: ticket intervento/bugfix/variazione, chat ticket.
  • commerciale: reti di gestione, reti commerciali, richieste servizio, trattative, offerte, rinnovi, perimetro visibilita.
  • multitenancy: tenant registry, provisioning, upgrade tenant.
  • storage: integrazione MinIO/S3, quote.
  • access_control: template permessi, gruppi utente, policy.
  • service_catalog: catalogo servizi e sottoscrizioni tenant.
  • formazione: corsi, date/orari, iscrizioni, presenze, attestati, survey qualità.

Flussi core

1) Cliente

  1. creazione cliente su tenant;
  2. eventuale allineamento globale;
  3. gestione dati contesto dinamici per tipologia;
  4. documenti, ticket, dipendenti collegati.

2) Documento cliente

  1. scelta cliente e categoria;
  2. upload master + allegati;
  3. aggiornamento/versioning;
  4. vista checklist per stato copertura documentale.

3) Ticket

  1. apertura ticket (cliente, tipo, priorita);
  2. assegnazione e stato lavorazione;
  3. chat operativa;
  4. chiusura e storico.

4) Dipendenti

  1. anagrafica dipendente;
  2. associazione cliente-dipendente;
  3. visibilita in cliente show (related).

5) Mappa clienti/interventi

  1. marker clienti geolocalizzati (lat/lon comune);
  2. overlay stato ticket/interventi aperti;
  3. popup con link rapido a cliente e ticket.

6) Formazione (date -> ruoli)

  1. operatore crea corso e imposta Date e Orari;
  2. operatore iscrive discenti;
  3. docente gestisce presenze (mattina/pomeriggio) e completamento;
  4. operatore genera/carica attestati e scadenze;
  5. invio survey e consolidamento KPI qualità.

Evoluzione architetturale consigliata:

7) Commerciale e Perimetro Servizi

Oggetti principali

  • CommercialeReteGestione
  • CommercialeReteCommerciale
  • CommercialeClienteServizioLink
  • CommercialeRichiestaServizio
  • CommercialeTrattativa
  • CommercialeOfferta
  • CommercialeTecnicoIncarico

Regola di modello

Il sistema non usa solo gerarchia tenant. Usa:

  • anagrafiche del tenant;
  • tipologie cliente;
  • collegamenti per singolo servizio;
  • incarichi tecnici;
  • consensi separati.

Questo permette:

  • un cliente collegato a piu reti commerciali per servizi diversi;
  • una rete di gestione che vede solo i dati consentiti;
  • un tecnico limitato ai clienti con incarico attivo.

Flussi applicativi

  • ras_quote
  • richiesta -> trattativa -> offerta RAS -> ticket/documento/servizio attivo
  • quote_simple
  • richiesta -> trattativa -> offerta semplice
  • ticket_only
  • richiesta -> ticket diretto
  • document_request
  • richiesta -> documento / gestione documentale
  • generic_request
  • richiesta generica instradata internamente

Enforcement visibilita

Il perimetro viene calcolato nel modulo commerciale e poi applicato anche a:

  • Commerciale -> Richieste Servizio
  • Commerciale -> Trattative
  • Commerciale -> Offerte
  • Servizi -> Ticket
  • Documentale -> Documenti

L'enforcement si attiva per utenti collegati a:

  • CommercialeAgente.user_id
  • CommercialeReteGestione.user_id
  • CommercialeTecnicoIncarico.user_id

Se un utente non e collegato a nessun profilo scoped:

  • il comportamento resta non restrittivo
  • utile per utenti amministrativi interni.

Diagnostica

Per il debug operativo:

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

Queste due viste servono a verificare:

  • permessi FAB minimi per ruolo;
  • clienti e record visibili;
  • coerenza del perimetro prima di stringere ulteriormente i permessi.