Principio cardine: un dato si inserisce una volta sola ed è disponibile in tutte le aree senza duplicazioni. Il diagramma mostra le relazioni logiche tra i moduli e il ciclo di vita del prodotto.
Prezzi per cliente o categoria prodotto, sconti, condizioni
↔ Cliente, ↔ Prodotto, ↔ Agente
Fornitori
Dati societari, contatti, referenti
↔ Ordini fornitore, ↔ Prodotti
Regole di business
Ogni cliente appartiene a un e un solo agente di riferimento (assegnazione 1:N)
Listino dedicato = prezzi personalizzati per singolo cliente o per categoria
Modifica listino si propaga in tempo reale su Portale B2B e Area Agenti
Eliminazione logica (soft delete) su tutte le anagrafiche per mantenere storico
Attori:Backoffice Quixxt/Evya
2Area Agenti — Priorità Massima
Gli agenti operano in completa autonomia dal proprio portale dedicato. Ogni agente vede solo i propri clienti, i propri listini e le proprie provvigioni.
flowchart TD
A[Login Agente] --> B[Dashboard Agente]
B --> C[Seleziona Cliente dal proprio elenco]
C --> D{Azione}
D --> E[Consulta Listino Assegnato]
D --> F[Crea Preventivo]
D --> G[Inserisci Ordine per conto Cliente]
D --> H[Visualizza Provvigioni Maturate]
D --> I[Gestione Subagenti]
F --> F1[Preventivo → Ordine confermato]
G --> J[Ordine Inviato]
F1 --> J
J --> K[Storico Ordini]
H --> L[Calcolo Automatico Regole · Scaglioni · Obiettivi]
I --> M[Visualizza Subagenti e loro provvigioni]
L --> N[Report Provvigioni]
Stato/Fase
Descrizione
Attore
Login
Autenticazione con credenziali dedicate. Ogni agente vede solo i propri dati.
Agente
Dashboard
KPI: ordini del mese, provvigioni maturate, clienti attivi, subagenti
Il preventivo confermato dal cliente diventa ordine ufficiale con numero progressivo
Agente / Cliente
Ordine Inviato
Ordine trasmesso al backoffice. Stato iniziale: "In attesa"
Sistema
Calcolo Provvigioni
Automatico su ordini consegnati. Regole personalizzabili: % fissa, scaglioni per fatturato, obiettivi mensili/trimestrali
Sistema
Subagenti
Agente principale visualizza i propri subagenti, i loro clienti e le provvigioni generate a cascata
Agente
Regole di business critiche
Isolamento dati: Agente X non vede mai clienti/listini/provvigioni dell'Agente Y
Calcolo provvigioni: include regole, scaglioni e obiettivi per agente. Deve essere retroattivo su storico ordini
Subagenti: provvigione calcolata su ordini del subagente con % dedicata, scalata da quella dell'agente principale
Nessun limite utente: il numero di agenti/subagenti non è vincolato da licenze
Preventivi: hanno numero interno, data validità, e possono essere duplicati o convertiti in ordine
Attori:AgenteSubagenteSistema
3Portale B2B — Area Riservata Clienti
Area riservata per i clienti finali di Evya. Ogni cliente vede solo i propri dati, il proprio listino e il proprio storico.
flowchart TD
A[Login Cliente] --> B[Catalogo Riservato]
B --> C[Listino Dedicato Prezzi visibili solo post-login]
C --> D[Condizioni Commerciali Personalizzate]
D --> E{Azione}
E --> F[Inserimento Ordine Flusso Guidato]
E --> G[Storico Ordini]
E --> H[Documentazione Tecnica Download Schede / Manuali]
E --> I[Anagrafica Self-Service]
F --> F1[Cliente → Prodotti → Quantità → Conferma]
F1 --> F2[Ordine Inviato Stato: In Attesa]
F2 --> G
I --> I1[Modifica Dati / Contatti]
Stato/Fase
Descrizione
Attore
Login
Autenticazione cliente. Prezzi nascosti fino al login.
Cliente
Catalogo
Visualizzazione prodotti con immagini, descrizioni, disponibilità. Prezzi personalizzati per cliente.
Cliente
Flusso Ordine
Step 1: selezione prodotti da catalogo. Step 2: riepilogo con prezzi/sconti. Step 3: conferma con riepilogo finale. Step 4: invio ordine.
Cliente
Storico
Elenco ordini con stato, data, importo. Dettaglio singolo ordine con prodotti e tracking.
Cliente
Documentazione
Area download: schede tecniche, manuali d'uso, certificati per prodotto. Filtrabile per categoria.
Cliente
Self-Service
Il cliente può aggiornare i propri dati anagrafici (indirizzo, contatti, referenti). Modifiche in attesa di approvazione backoffice.
Cliente
Regole di business critiche
Prezzi nascosti: finché il cliente non effettua il login, i prezzi non sono visibili nel catalogo
Listino dedicato: ogni cliente ha prezzi e sconti personalizzati. Se non esiste listino dedicato, applica listino standard
Condizioni commerciali: sconto fisso o percentuale, modalità di pagamento, note — applicate automaticamente in fase d'ordine
Isolamento: Cliente A non vede ordini, prezzi né documenti del Cliente B
Ordine guidato: il flusso deve impedire l'invio se il carrello è vuoto o se i prodotti non sono disponibili
Attori:Cliente FinaleSistema
4Gestione Ordini Cliente — Backoffice
Centro di raccolta e gestione di tutti gli ordini provenienti dal Portale B2B e dall'Area Agenti. Include gestione stati, scontistiche e assegnazione.
flowchart TD
A[Ordine Ricevuto] --> B{Origine?}
B -->|Portale B2B| C1[Cliente]
B -->|Area Agenti| C2[Agente per conto Cliente]
C1 --> D[Stato: In Attesa]
C2 --> D
D --> E[Verifica Backoffice]
E --> F{Approvato?}
F -->|Sì| G[Applica Scontistiche e Condizioni Commerciali]
F -->|No| H[Stato: Rifiutato / Annullato]
G --> I[Stato: Confermato]
I --> J[Preparazione / Spedizione]
J --> K[Stato: Spedito]
K --> L[Stato: Consegnato]
L --> M[Attivazione Garanzia su Matricole]
L --> N[Calcolo Provvigione se da Agente]
Stato
Significato
Transizione possibile da
In Attesa
Ordine appena ricevuto, in coda di verifica
— (stato iniziale)
Confermato
Ordine approvato dal backoffice, pronto per evasione
In Attesa
Spedito
Ordine evaso e spedito al cliente
Confermato
Consegnato
Ordine ricevuto dal cliente, chiusura logistica
Spedito
Rifiutato / Annullato
Ordine rifiutato per motivi commerciali o tecnici
In Attesa
Regole di business critiche
Assegnazione automatica: ogni ordine eredita l'agente di riferimento dal cliente. Se il cliente non ha agente, va in coda "da assegnare"
Provvigione: calcolata solo su ordini "Consegnati". Se l'ordine viene annullato dopo la conferma, la provvigione viene stornata
Storico immutabile: una volta in stato "Consegnato" l'ordine non è più modificabile (solo note aggiuntive)
Notifica: il cliente e l'agente ricevono notifica email ad ogni cambio di stato (incluso in base, notifiche semplici)
Attori:BackofficeSistema
5Gestione Ordini Fornitore
Tracciamento manuale degli ordini effettuati ai fornitori (produttori in Cina). Ogni ordine ha uno stato di avanzamento e documenti allegati.
flowchart TD
A[Creazione Manuale Ordine] --> B[Selezione Fornitore + Prodotti + Quantità]
B --> C[Stato: Inviato]
C --> D[Fornitore Conferma]
D --> E[Stato: Confermato]
E --> F[Stato: In Produzione]
F --> G[Stato: Spedito]
G --> H[Arrivo in Italia]
H --> I[Stato: Arrivato]
I --> J[Registrazione Matricole Carico Logico]
C --> K[Allegati Documentali]
D --> K
G --> K
K --> L[Packing List Conferme Ordine Certificati]
Stato
Significato
Azione richiesta
Inviato
Ordine trasmesso al fornitore
Attesa conferma fornitore
Confermato
Fornitore ha accettato l'ordine
Monitoraggio produzione
In Produzione
Ordine in lavorazione presso il fornitore
Monitoraggio
Spedito
Fornitore ha spedito la merce
Registrazione documenti di trasporto
Arrivato
Merce ricevuta in Italia
Registrazione matricole, allegati doganali
Regole di business critiche
Gestione manuale stati: il backoffice aggiorna lo stato in base a comunicazioni con il fornitore (email, WeChat, portale fornitore)
Documenti allegati: ogni stato può avere file allegati (PDF, immagini). Obbligatori: packing list a stato "Spedito", certificati a stato "Arrivato"
Relazione con matricole: allo stato "Arrivato" si procede alla registrazione delle matricole fisiche ricevute
Ordine fornitore → ordine cliente: possibile collegamento N:M (un ordine fornitore può soddisfare più ordini cliente, e viceversa)
Attori:BackofficeFornitore (esterno)
6Tracciabilità Matricole
Ogni prodotto fisico è identificato da una matricola univoca. Il sistema traccia l'intero ciclo di vita: dall'arrivo dal fornitore fino al ticket di assistenza post-vendita.
flowchart TD
A[Prodotto Arrivato da Fornitore] --> B[Registrazione Matricola Codice Univoco Generato]
B --> C[Associazione Ordine Fornitore FK reale nel DB]
C --> D[Stato: Disponibile / In Magazzino]
D --> E{Vendita?}
E -->|Sì| F[Vendita a Cliente Finale]
F --> G[Associazione Cliente FK reale nel DB]
G --> H[Attivazione Automatica Garanzia]
H --> I[Associazione Garanzia FK reale nel DB]
I --> J{Ticket Aperto?}
J -->|Sì| K[Associazione Ticket FK reale nel DB]
J -->|No| L[Storico Completo]
K --> L
L --> M[Ricezione → Cliente → Garanzia → Ticket]
E -->|No| D
ogni ticket punta alla matricola per risalire al prodotto
Regole di business critiche
Relazioni reali: le associazioni devono essere foreign key nel database, non solo campi testuali o visualizzazioni UI
Storico immutabile: una volta venduta, la matricola non può essere riassegnata. Evento di reso = nuova matricola o flag "reso" con motivazione
Generazione codice: il codice matricola può essere inserito manualmente (lettura etichetta fisica) o generato automaticamente con pattern configurabile
Visibilità: il cliente vede le proprie matricole nel portale B2B; l'agente vede quelle dei propri clienti; il backoffice vede tutte
Garanzia automatica: alla vendita, il sistema crea automaticamente il record garanzia con data inizio = data vendita e durata = parametro da anagrafica prodotto
Attori:BackofficeSistema
7Gestione Garanzie
Attivazione automatica alla vendita della matricola. Tracciamento stato e scadenza.
flowchart TD
A[Vendita Matricola] --> B[Registrazione Automatica Garanzia]
B --> C[Data Inizio = Data Vendita]
C --> D[Durata da Anagrafica Prodotto]
D --> E[Calcolo Scadenza Automatico]
E --> F[Stato: Attiva]
F --> G[Stato: In Scadenza alert 30gg prima]
G --> H[Stato: Scaduta]
B --> I[Associazione Cliente e Matricola]
F --> J[Storico Garanzie per Cliente / Prodotto]
H --> J
Stato
Condizione
Azione
Attiva
Data corrente compresa tra inizio e scadenza
Ticket assistenza abilitato su questa matricola
In Scadenza
Data corrente a meno di 30 giorni dalla scadenza
Visibile in report/scadenzario (notifica futura)
Scaduta
Data corrente > data scadenza
Ticket assistenza ancora aperto ma con flag "garanzia scaduta"
Regole di business critiche
Attivazione automatica: nessun intervento manuale alla vendita. Il sistema crea il record garanzia
Durata: letta dall'anagrafica prodotto (campo "mesi_garanzia"). Se assente, default configurabile
Scadenza calcolata: data_inizio + durata. Aggiornata automaticamente se la data inizio viene modificata (caso raro, log di audit)
Storico: ogni matricola ha una e una sola garanzia attiva. Rinnovi = nuovo record con nuova data inizio
Attori:Sistema (automatico)Backoffice
8Gestione Assistenza / Ticket
Gestione post-vendita. Ogni ticket è collegato a un cliente e, quando possibile, a una matricola specifica per tracciabilità completa.
flowchart TD
A[Apertura Ticket] --> B{Autore?}
B -->|Cliente| C1[Portale B2B]
B -->|Agente| C2[Area Agenti]
B -->|Backoffice| C3[Backend]
C1 --> D[Collegamento Cliente]
C2 --> D
C3 --> D
D --> E[Collegamento Matricola se nota]
E --> F[Stato: Aperto]
F --> G[Assegnazione Operatore / Tecnico]
G --> H[Stato: In Lavorazione]
H --> I{Esito}
I -->|Risolto| J[Stato: Risolto]
I -->|Non risolvibile| K[Stato: Chiuso con nota]
J --> L[Stato: Chiuso]
L --> M[Storico Ticket per Cliente / Matricola]
K --> M
Stato
Significato
Permessi
Aperto
Ticket appena creato, in attesa di assegnazione
Visualizzabile da cliente, agente, backoffice
In Lavorazione
Ticket preso in carico da un operatore
Cliente vede stato; operatore può aggiungere note interne
Risolto
Problema risolto, in attesa di conferma chiusura
Cliente può riaprire entro X giorni (configurabile)
Chiuso
Ticket definitivamente chiuso
Solo lettura per tutti. Note interne visibili solo a backoffice
Regole di business critiche
Collegamento matricola: se il ticket è aperto dal cliente dal suo portale, il sistema suggerisce le matricole associate al cliente. Se aperto senza matricola, il backoffice può collegarla in seguito
Note interne vs note visibili: l'operatore può scrivere note interne (visibili solo backoffice) e risposte visibili al cliente
Priorità: default "Normale". Il backoffice può impostare "Alta" o "Urgente"
Storico: ogni ticket ha un log completo di tutte le azioni (cambio stato, assegnazione, note) con timestamp e autore
Attori:ClienteAgenteBackofficeTecnico
9Contabilità Base
Sostituisce il modulo magazzino nello scope iniziale. Gestione manuale dei movimenti e scadenzario clienti.
flowchart TD
subgraph PN["PRIMA NOTA"]
A1[Registrazione Manuale] --> A2[Entrata / Uscita]
A2 --> A3[Causale + Importo + Data + Cliente/Fornitore]
A3 --> A4[Salvataggio Movimento]
end
subgraph SC["SCADENZARIO"]
B1[Fatture Emesse] --> B2[Da Incassare]
B3[Fatture Ricevute] --> B4[Da Pagare]
B2 --> B5[Data Scadenza + Stato Pagamento]
B4 --> B5
B5 --> B6[Pagata / Non Pagata / Parziale]
end
subgraph DA["DARE / AVERE"]
C1[Calcolo Automatico] --> C2[Saldo per Cliente]
C2 --> C3[Totale Fatturato - Totale Incassato]
end
A4 --> C1
B6 --> C1
Funzione
Input
Output
Prima Nota
Movimento manuale: data, causale, importo (+/-), controparte (cliente/fornitore/generico)
Elenco scadenze per data, stato pagamento, alert ritardi
Dare/Avere
Ordini consegnati (fatturato) e pagamenti registrati
Situazione saldo aggiornata per ogni cliente
Regole di business critiche
Manuale: nessuna integrazione automatica con banche o fatturazione elettronica in questa fase. Tutti i movimenti sono inseriti a mano dal backoffice
Collegamento ordini: lo scadenzario può fare riferimento a un ordine cliente (opzionale FK) ma non è obbligatorio
Dare/avere: calcolato come (totale ordini consegnati del cliente) - (totale pagamenti registrati a suo nome). Aggiornato in tempo reale
Non è contabilità doppia: è una gestione semplificata di cassa. Non genera registri IVA né bilanci
Attori:Backoffice
10Reportistica Base
Viste filtrabili ed esportazioni per il backoffice. Dashboard riepilogativa con KPI chiave.
flowchart TD
A[Accesso Reportistica] --> B{Filtri}
B --> C1[Per Data]
B --> C2[Per Cliente]
B --> C3[Per Agente]
B --> C4[Per Stato Ordine]
B --> C5[Per Prodotto / Categoria]
C1 --> D[Viste Elenco]
C2 --> D
C3 --> D
C4 --> D
C5 --> D
D --> E[Esportazione CSV / Excel]
D --> F[Dashboard Riepilogativa]
F --> G[Ordini del Periodo]
F --> H[Fatturato]
F --> I[Agenti Attivi]
F --> J[Provvigioni Maturate]
F --> K[Scadenze Imminenti]
Report
Contenuto
Formato
Ordini
Elenco filtrabile con cliente, agente, stato, importo, data
Vista web + CSV/Excel
Clienti
Anagrafica, agente di riferimento, fatturato anno, saldo dare/avere
Vista web + CSV/Excel
Matricole
Stato (disponibile/venduta), cliente, garanzia, ticket associati
Vista web + CSV/Excel
Provvigioni
Dettaglio per agente: ordine, importo, % applicata, provvigione calcolata
Vista web + CSV/Excel
Dashboard
Numeri riepilogativi: ordini periodo, fatturato, agenti attivi, scadenze prossime
Vista web (non esportabile)
Regole di business critiche
Filtri combinabili: tutti i filtri sono combinabili tra loro (es. "ordini del mese corrente per l'agente X in stato Confermato")
Esportazione: CSV (UTF-8, separatore ;) e Excel (.xlsx). Le esportazioni rispettano i filtri attivi
Dashboard: semplice pagina di riepilogo con contatori e liste "top 5". Non è BI avanzata né grafici interattivi complessi
Permessi: l'agente vede solo i report relativi ai propri clienti. Il cliente non ha accesso alla reportistica