Salta al contenuto principale

Domain Knowledge Base - Customer Relationship Management

Come funziona il dominio, prima di scrivere una riga di codice? Scegli un documento dall'albero a sinistra: ogni pagina spiega una parte del modello.

Regole di Business - CRM

Questo documento elenca le regole di business fondamentali del dominio CRM, identificate con codice univoco BR-NNN. Ogni regola è technology-independent e descrive un vincolo invariante sul comportamento del dominio.

---

BR-001 - Un'opportunità appartiene sempre a un cliente o prospect

Codice: BR-001 Nome: Ogni Opportunità è collegata a un Cliente (o prospect) identificato Descrizione: Non può esistere un'Opportunità senza un Cliente o prospect di riferimento. L'anagrafica cliente è il punto di aggancio di tutte le attività commerciali e delle opportunità di vendita. Motivazione: Garantire la tracciabilità commerciale e l'attribuzione corretta delle opportunità. Priorità: ALTA Attori: Sales Rep, Account Manager Tracciabilità: glossary.md Opportunità, Cliente; state-machines/opportunita-lifecycle.md.

---

BR-002 - Avanzamento di fase secondo criteri di qualificazione

Codice: BR-002 Nome: L'Opportunità avanza di fase solo se soddisfa i criteri della fase successiva Descrizione: Il passaggio di un'Opportunità da una fase alla successiva (prospect → qualificata → proposta → negoziazione → chiusa) richiede il soddisfacimento di criteri di qualificazione espliciti (es. budget, autorità, bisogno, tempistica). Nessun salto di fase non giustificato. Motivazione: Assicurare una pipeline pulita e previsioni di vendita affidabili. Priorità: ALTA Attori: Sales Rep, Account Manager Tracciabilità: BR; events/domain-events.md OpportunitàQualificata; glossary.md Pipeline di vendita.

---

BR-003 - MQL e SQL distinti nella qualificazione del lead

Codice: BR-003 Nome: La conversione del lead distingue qualificazione marketing (MQL) e vendite (SQL) Descrizione: Un lead qualificato dal marketing (MQL) diventa lead qualificato dalle vendite (SQL) solo dopo accettazione del team vendite. La conversione a Cliente/Opportunità avviene a valle della qualificazione SQL. Motivazione: Allineare marketing e vendite ed evitare di lavorare lead non pronti. Priorità: MEDIA Attori: Marketing Team, Sales Rep Tracciabilità: glossary.md MQL, SQL; events/domain-events.md LeadConvertito.

---

BR-004 - Ogni opportunità persa registra un motivo

Codice: BR-004 Nome: Un'Opportunità chiusa-persa registra sempre un motivo di perdita Descrizione: Quando un'Opportunità è chiusa come persa, deve essere registrato un motivo strutturato (prezzo, concorrenza, tempistica, no-decision). Senza motivo l'opportunità non può essere chiusa-persa. Motivazione: Permettere analisi delle perdite e miglioramento del processo commerciale. Priorità: MEDIA Attori: Sales Rep, Account Manager Tracciabilità: events/domain-events.md OpportunitàPersa; glossary.md.

---

BR-005 - Attività commerciali tracciate sull'opportunità

Codice: BR-005 Nome: Ogni AttivitàCommerciale è collegata a un'Opportunità o a un Cliente Descrizione: Chiamate, email, demo e follow-up devono essere registrati come AttivitàCommerciale collegata all'Opportunità o al Cliente pertinente, con data e esito. Motivazione: Costruire uno storico relazionale affidabile e abilitare i follow-up programmati. Priorità: MEDIA Attori: Sales Rep, Account Manager Tracciabilità: events/domain-events.md FollowUpProgrammato; glossary.md.

---

BR-006 - Segmentazione coerente dei clienti

Codice: BR-006 Nome: Ogni Cliente è assegnato a un Segmento secondo criteri definiti Descrizione: I clienti sono assegnati a Segmento (per settore, dimensione, valore, comportamento) secondo criteri coerenti che orientano campagne e priorità commerciali. Un cliente appartiene a una segmentazione tracciabile. Motivazione: Indirizzare le azioni commerciali e di marketing in modo mirato e misurabile. Priorità: MEDIA Attori: Marketing Team, Account Manager Tracciabilità: glossary.md Segmento; events/domain-events.md CampagnaLanciata.

---

BR-007 - Contratto firmato chiude l'opportunità come vinta

Codice: BR-007 Nome: La firma del contratto porta l'Opportunità a chiusa-vinta Descrizione: Quando il contratto è firmato (ContrattoFirmato), l'Opportunità passa a chiusa-vinta e il prospect/contatto diventa Cliente attivo (ClienteAcquisito). Il valore dell'opportunità è consolidato nelle metriche di vendita. Motivazione: Allineare il funnel commerciale con l'effettiva acquisizione del cliente. Priorità: ALTA Attori: Account Manager, Sales Rep Tracciabilità: BR-001; events/domain-events.md ContrattoFirmato, ClienteAcquisito.

---

BR-008 - Churn rilevato attiva un processo di retention

Codice: BR-008 Nome: Il rilevamento di churn su un Cliente attiva un'azione di retention Descrizione: Quando si rileva il rischio o l'evento di churn su un Cliente (ChurnRilevato), si attiva un processo di retention (contatto, offerta, escalation all'Account Manager) prima di considerare il cliente perso. Motivazione: Ridurre la perdita di clienti e proteggere il valore della base installata. Priorità: MEDIA Attori: Account Manager, CRM System Tracciabilità: glossary.md (churn); events/domain-events.md ChurnRilevato.

---