Créer un prospect

Cette procédure permet à un commercial de créer un nouveau prospect dans la plateforme afin de débuter un cycle de vente.

Le prospect représente une organisation susceptible de devenir un futur tenant de la plateforme.

La création d'un prospect constitue toujours le point d'entrée du processus commercial.

Un prospect ne possède encore :

• aucun abonnement
• aucun tenant
• aucun utilisateur actif
• aucune facturation

Le prospect est uniquement un dossier commercial.

Rôles autorisés :

• PLATFORM_SALES
• PLATFORM_OWNER

Lecture seule :

• PLATFORM_VIEWER

Interdit :

• PLATFORM_SUPPORT
• PLATFORM_BILLING

SUPER_ADMIN hérite automatiquement de cette procédure.

L'utilisateur doit :

• être authentifié
• disposer du rôle PLATFORM_SALES
• avoir accès au Workspace Commercial
• disposer de la permission SALES_CREATE_PROSPECT

Cette procédure est déclenchée lorsque :

• un prospect remplit un formulaire marketing
• un prospect contacte les équipes commerciales
• un commercial reçoit une recommandation
• une campagne marketing génère un lead
• un salon professionnel fournit un contact
• une importation CSV crée un nouveau lead
• une API externe crée automatiquement un prospect

Créer un dossier commercial complet.

Centraliser toutes les informations.

Éviter les doublons.

Permettre la qualification ultérieure.

Préparer la création du futur tenant.

Workspace :

Commercial

Menu :

Prospects

Sous-menu :

Tous les prospects

Bouton :

Créer un prospect

Raccourci clavier :

CTRL + K

Commande :

Créer un prospect

L'écran est constitué de quatre zones.

Titre

Créer un prospect

Actions :

• Enregistrer
• Enregistrer et qualifier
• Annuler

Organisation

Nom de la société *

Secteur d'activité

Nombre de collaborateurs

Site web

SIREN

TVA intracommunautaire

Pays

Langue

Fuseau horaire

Origine du lead

Campagne marketing

Source

Commercial responsable

Priorité

Tags

Civilité

Prénom *

Nom *

Fonction

Téléphone

Mobile

Email *

LinkedIn

Préférence de contact

Commentaires libres

Pièces jointes

Documents

Historique

Tous les champs obligatoires sont identifiés.

La sauvegarde est automatique toutes les 30 secondes.

Les erreurs apparaissent sous les champs.

La progression est conservée même après fermeture du navigateur.

Les suggestions de sociétés sont affichées pendant la saisie.

Le système détecte les doublons en temps réel.

Le nom de la société est obligatoire.

Le contact principal est obligatoire.

L'adresse email est obligatoire.

Deux prospects ne peuvent pas partager :

• même société
• même email principal

sauf validation explicite.

Si un tenant existe déjà :

interdire la création.

Si un prospect existe déjà :

proposer :

• ouvrir la fiche existante
• fusionner
• créer malgré tout (permission spéciale)

Étape 1

Ouvrir :

Commercial

↓

Prospects

↓

Créer un prospect

Le formulaire vierge apparaît.

Étape 2

Saisir :

Nom société

Étape 3

Le système vérifie automatiquement :

• doublons
• domaine email
• société existante
• tenant existant

Étape 4

Compléter :

Secteur

Effectif

Pays

Site web

Étape 5

Créer le contact principal.

Étape 6

Associer :

Campagne

Source

Commercial

Priorité

Étape 7

Ajouter des notes.

Étape 8

Cliquer :

Enregistrer

Le prospect reçoit automatiquement :

• un identifiant
• une date de création
• un propriétaire
• un statut “Nouveau”

NEW

CONTACTED

QUALIFIED

PROPOSAL

NEGOTIATION

WON

LOST

ARCHIVED

Lors de la création :

Créer automatiquement :

• activité CRM
• journal d'audit
• timeline
• score initial

Déclencher :

LeadCreated

Indexer :

Recherche globale

Mettre à jour :

Dashboard Sales

Créer :

première tâche de suivi

Notifier :

Commercial responsable

Afficher :

Nouvelle opportunité créée

Si le prospect provient du site marketing :

Notifier également Marketing.

Journaliser :

Utilisateur

Date

Adresse IP

Navigateur

Anciennes valeurs

Nouvelles valeurs

Origine

API utilisée

Permissions :

SALES_CREATE

SALES_READ

Le commercial ne peut modifier que ses propres prospects sauf permission spécifique.

Toutes les modifications sont historisées.

Entités :

Prospect

ProspectContact

LeadSource

Campaign

Activity

TimelineEvent

Tag

Attachment

CustomFieldValue

LeadCreated

ActivityCreated

TimelineUpdated

SearchIndexed

NotificationQueued

AuditLogged

POST /api/v1/prospects

GET /api/v1/prospects/{id}

PATCH /api/v1/prospects/{id}

GET /api/v1/prospects/search

POST /api/v1/prospects/{id}/attachments

Créer

Modifier

Supprimer

Fusionner

Exporter

Importer

Convertir

Attribuer

Après création :

Le Cockpit Commercial affiche :

• Prospect créé aujourd'hui
• Tâche à effectuer
• Score
• Pipeline
• Dernières activités

Nombre de prospects

Prospects créés

Prospects qualifiés

Temps moyen avant qualification

Origine des prospects

Répartition par commercial

Taux de conversion

Nom société absent

Adresse email invalide

Prospect déjà existant

Tenant déjà existant

Adresse email déjà utilisée

Erreur réseau

Perte de connexion

Conflit de sauvegarde

✓ Le prospect est créé.

✓ Les doublons sont détectés.

✓ La recherche globale retrouve immédiatement le prospect.

✓ Une activité CRM est créée.

✓ Le journal d'audit est alimenté.

✓ Une notification est envoyée.

✓ Le Dashboard est mis à jour.

✓ La Timeline est créée.

✓ Les permissions sont respectées.

TC-001 Création valide

TC-002 Société existante

TC-003 Email invalide

TC-004 Création sans permission

TC-005 Doublon

TC-006 Sauvegarde automatique

TC-007 Création API

TC-008 Création depuis formulaire Marketing

TC-009 Recherche globale

TC-010 Audit

Objectif :

Développer le module complet “Création de prospect” de la Platform Console.

Le développement devra inclure :

• page React (Tenant UX Platform)
• formulaire dynamique
• validation Zod
• React Hook Form
• autosave
• détection de doublons
• Timeline
• Audit
• RBAC
• API NestJS
• DTO
• Prisma
• événements de domaine
• notifications
• indexation dans la recherche globale
• tests unitaires
• tests e2e
• composants conformes à la UX Platform
• compatibilité Responsive Desktop / Tablet / Mobile
• intégration complète avec les Cockpits et le Workspace Commercial.