#Progettazione Dettagliata del Sistema CRM 2.0

#1. Panoramica del sistema e filosofia di progettazione

#1.1 Posizionamento del sistema

Questo sistema è una Piattaforma di gestione delle vendite CRM 2.0 costruita sulla piattaforma no-code NocoBase. L'obiettivo principale è:

Permettere ai venditori di concentrarsi sulla costruzione di relazioni con i clienti, anziché sull'inserimento dei dati e sull'analisi ripetitiva.

Il sistema automatizza le attività di routine attraverso flussi di lavoro e utilizza l'IA per assistere nel punteggio dei lead, nell'analisi delle opportunità e in altre attività, aiutando i team di vendita a migliorare l'efficienza.

#1.2 Filosofia di progettazione

#Filosofia 1: Imbuto di vendita completo

Processo di vendita end-to-end:

Perché progettarlo in questo modo?

#Filosofia 2: Pipeline di vendita configurabile

Settori diversi possono personalizzare le fasi della pipeline di vendita senza modificare il codice.

#Filosofia 3: Design modulare

• I moduli principali (Clienti + Opportunità) sono obbligatori; altri moduli possono essere abilitati secondo necessità.
• La disattivazione dei moduli non richiede modifiche al codice; si effettua tramite la configurazione dell'interfaccia di NocoBase.
• Ogni modulo è progettato in modo indipendente per ridurre l'accoppiamento.

#2. Architettura dei moduli e personalizzazione

#2.1 Panoramica dei moduli

Il sistema CRM adotta un design ad architettura modulare: ogni modulo può essere abilitato o disabilitato indipendentemente in base ai requisiti aziendali.

#2.2 Dipendenze dei moduli

#2.3 Versioni preconfigurate

#2.4 Mappatura Modulo-Collezione

#Collezioni dei moduli principali (Sempre richieste)

#2.5 Come disattivare i moduli

È sufficiente nascondere la voce di menu per il modulo nell'interfaccia di amministrazione di NocoBase; non è necessario modificare il codice o eliminare le collezioni.

#3. Entità principali e modello dati

#3.1 Panoramica delle relazioni tra entità

#3.2 Dettagli delle collezioni principali

#3.2.1 Lead (nb_crm_leads)

Gestione dei lead tramite un flusso di lavoro semplificato a 4 fasi.

Processo delle fasi:

Nuovo → In lavorazione → Qualificato → Convertito in Cliente/Opportunità
           ↓               ↓
     Non qualificato  Non qualificato

Campi chiave:

#3.2.2 Clienti (nb_crm_customers)

Gestione Clienti/Aziende che supporta il commercio internazionale.

Campi chiave:

#3.2.3 Opportunità (nb_crm_opportunities)

Gestione delle opportunità di vendita con fasi della pipeline configurabili.

Campi chiave:

#3.2.4 Preventivi (nb_crm_quotations)

Gestione dei preventivi con supporto multi-valuta e flussi di lavoro di approvazione.

Flusso degli stati:

Bozza → In attesa di approvazione → Approvato → Inviato → Accettato/Rifiutato/Scaduto
                   ↓
               Rifiutato → Modifica → Bozza

Campi chiave:

#3.2.5 Ordini (nb_crm_orders)

Gestione degli ordini incluso il monitoraggio dei pagamenti.

Campi chiave:

#3.3 Riepilogo delle collezioni

#Collezioni aziendali CRM

#Collezioni dati di base (Moduli comuni)

#3.4 Collezioni ausiliarie

#3.4.1 Commenti (nb_crm_comments)

Collezione generica di commenti/note che può essere associata a vari oggetti aziendali.

#3.4.2 Condivisioni clienti (nb_crm_customer_shares)

Consente la collaborazione tra più persone e la condivisione dei permessi per i clienti.

#3.4.3 Collaboratori opportunità (nb_crm_opportunity_users)

Supporta la collaborazione del team di vendita sulle opportunità.

#3.4.4 Regioni (nb_cbo_regions)

Dizionario dei dati di base per Paesi/Regioni.

#4. Ciclo di vita dei lead

La gestione dei lead utilizza un flusso di lavoro semplificato a 4 fasi. Quando viene creato un nuovo lead, un flusso di lavoro può attivare automaticamente il punteggio IA per aiutare i venditori a identificare rapidamente i lead di alta qualità.

#4.1 Definizioni degli stati

#4.2 Diagramma di flusso degli stati

#4.3 Processo di conversione dei lead

L'interfaccia di conversione fornisce tre opzioni simultaneamente; gli utenti possono scegliere di creare o associare:

• Cliente: Creare un nuovo cliente OPPURE associarlo a un cliente esistente.
• Contatto: Creare un nuovo contatto (associato al cliente).
• Opportunità: È obbligatorio creare un'opportunità.

Record post-conversione:

• converted_customer_id: ID Cliente associato
• converted_contact_id: ID Contatto associato
• converted_opportunity_id: ID Opportunità creata

#5. Ciclo di vita delle opportunità

La gestione delle opportunità utilizza fasi della pipeline di vendita configurabili. Quando una fase dell'opportunità cambia, può attivare automaticamente la previsione della probabilità di vincita tramite IA per aiutare i venditori a identificare rischi e opportunità.

#5.1 Fasi configurabili

Le fasi sono memorizzate nella collezione nb_crm_opportunity_stages e possono essere personalizzate:

#5.2 Flusso della pipeline

#5.3 Rilevamento della stagnazione

Le opportunità senza attività verranno contrassegnate:

-- Calcolo dei giorni di stagnazione
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 Gestione di vincite/perdite

In caso di vincita:

1. Aggiornare la fase a 'won'.
2. Registrare la data di chiusura effettiva.
3. Aggiornare lo stato del cliente in 'active'.
4. Attivare la creazione dell'ordine (se un preventivo è stato accettato).

In caso di perdita:

1. Aggiornare la fase a 'lost'.
2. Registrare il motivo della perdita.
3. Registrare l'ID del concorrente (se persa a favore di un concorrente).
4. Notificare il manager.

#6. Ciclo di vita dei preventivi

#6.1 Definizioni degli stati

#6.2 Regole di approvazione (da finalizzare)

I flussi di lavoro di approvazione vengono attivati in base alle seguenti condizioni:

#6.3 Supporto multi-valuta

#Filosofia di progettazione

Utilizzare l'USD come valuta di base unificata per tutti i report e le analisi. Ogni record di importo memorizza:

• Valuta e importo originali (ciò che vede il cliente)
• Tasso di cambio al momento della transazione
• Importo equivalente in USD (per confronti interni)

#Dizionario valute (nb_cbo_currencies)

La configurazione delle valute utilizza una collezione di dati di base comune, supportando la gestione dinamica. Il campo current_rate memorizza il tasso di cambio attuale, aggiornato da un'attività pianificata dall'ultimo record in nb_crm_exchange_rates.

#Cronologia tassi di cambio (nb_crm_exchange_rates)

Registra i dati storici dei tassi di cambio. Un'attività pianificata sincronizza gli ultimi tassi in nb_cbo_currencies.current_rate.

Nota: I preventivi sono associati alla collezione nb_cbo_currencies tramite la chiave esterna currency_id, e il tasso di cambio viene recuperato direttamente dal campo current_rate. Le opportunità e gli ordini utilizzano un campo VARCHAR currency per memorizzare il codice della valuta.

#Modello dei campi importo

Le collezioni contenenti importi seguono questo modello:

Applicato a:

• nb_crm_opportunities.amount → amount_usd
• nb_crm_quotations.total_amount → total_amount_usd

#Integrazione del flusso di lavoro

Logica di recupero del tasso di cambio:

1. Recuperare il tasso di cambio direttamente da nb_cbo_currencies.current_rate durante le operazioni aziendali.
2. Transazioni in USD: Tasso = 1.0, nessuna ricerca richiesta.
3. current_rate viene sincronizzato da un'attività pianificata dall'ultimo record di nb_crm_exchange_rates.

#6.4 Gestione delle versioni

Quando un preventivo viene rifiutato o scade, può essere duplicato come nuova versione:

QT-20260119-001 v1 → Rifiutato
QT-20260119-001 v2 → Inviato
QT-20260119-001 v3 → Accettato

#7. Ciclo di vita degli ordini

#7.1 Panoramica degli ordini

Gli ordini vengono creati quando un preventivo viene accettato, rappresentando un impegno aziendale confermato.

#7.2 Definizioni degli stati dell'ordine

#7.3 Modello dati dell'ordine

#nb_crm_orders

#nb_crm_order_items

#7.4 Monitoraggio dei pagamenti

#nb_crm_payments

#8. Ciclo di vita dei clienti

#8.1 Panoramica dei clienti

I clienti vengono creati durante la conversione dei lead o quando un'opportunità viene vinta. Il sistema traccia l'intero ciclo di vita, dall'acquisizione alla fidelizzazione (advocacy).

#8.2 Definizioni degli stati del cliente

#8.3 Punteggio di salute del cliente

La salute del cliente viene calcolata in base a molteplici fattori:

Soglie di salute:

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

#8.4 Segmentazione dei clienti

#Segmentazione automatizzata

#9. Integrazione e-mail

#9.1 Panoramica

NocoBase fornisce un plugin di integrazione e-mail integrato che supporta Gmail e Outlook. Una volta sincronizzate le e-mail, i flussi di lavoro possono attivare automaticamente l'analisi IA del sentiment e dell'intento delle e-mail, aiutando i venditori a comprendere rapidamente l'atteggiamento dei clienti.

#9.2 Sincronizzazione e-mail

Provider supportati:

• Gmail (tramite OAuth 2.0)
• Outlook/Microsoft 365 (tramite OAuth 2.0)

Comportamento della sincronizzazione:

• Sincronizzazione bidirezionale delle e-mail inviate e ricevute.
• Associazione automatica delle e-mail ai record CRM (Lead, Contatti, Opportunità).
• Allegati memorizzati nel file system di NocoBase.

#9.3 Associazione E-mail-CRM (da finalizzare)

#9.4 Modelli di e-mail

I venditori possono utilizzare modelli preimpostati:

#10. Funzionalità assistite dall'IA

#10.1 Team di dipendenti IA

Il sistema CRM integra il plugin NocoBase AI, utilizzando i seguenti dipendenti IA integrati configurati con compiti specifici per il CRM:

#10.2 Elenco dei compiti IA

Le funzionalità IA sono divise in due categorie indipendenti:

#I. Dipendenti IA (attivati da blocchi frontend)

Gli utenti interagiscono direttamente con l'IA tramite i blocchi frontend "Dipendente IA" per ottenere analisi e suggerimenti.

#II. Nodi LLM del flusso di lavoro (esecuzione automatizzata backend)

Nodi LLM inseriti nei flussi di lavoro, attivati automaticamente da eventi delle collezioni, eventi di azione o attività pianificate, indipendentemente dai Dipendenti IA.

Nota: I nodi LLM del flusso di lavoro utilizzano prompt e output Schema per JSON strutturato, che viene analizzato e scritto nei campi dati aziendali senza l'intervento dell'utente.

#10.3 Campi IA nel database

#11. Motore del flusso di lavoro

#11.1 Flussi di lavoro implementati

#11.2 Flussi di lavoro da implementare

#12. Design del menu e dell'interfaccia

#12.1 Struttura dell'amministrazione

#12.2 Viste della dashboard

#Vista Sales Manager

#Vista Sales Rep

#Vista Executive

Versione documento: v2.0 | Aggiornato il: 06-02-2026