====== SALES-001 ====== Créer un prospect ===== 1. Objectif ===== 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. ---- ===== 2. Acteurs ===== 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. ---- ===== 3. Préconditions ===== L'utilisateur doit : * être authentifié * disposer du rôle PLATFORM_SALES * avoir accès au Workspace Commercial * disposer de la permission SALES_CREATE_PROSPECT ---- ===== 4. Déclencheur ===== 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 ---- ===== 5. Objectifs métier ===== 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. ---- ===== 6. Menus ===== Workspace : Commercial Menu : Prospects Sous-menu : Tous les prospects Bouton : Créer un prospect Raccourci clavier : CTRL + K Commande : Créer un prospect ---- ===== 7. Écran ===== L'écran est constitué de quatre zones. ===== En-tête ===== Titre Créer un prospect Actions : * Enregistrer * Enregistrer et qualifier * Annuler ---- ===== Informations générales ===== 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 ---- ===== Contact principal ===== Civilité Prénom * Nom * Fonction Téléphone Mobile Email * LinkedIn Préférence de contact ---- ===== Notes ===== Commentaires libres Pièces jointes Documents Historique ---- ===== UX attendue ===== 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. ---- ===== 8. Règles métier ===== 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) ---- ===== 9. Procédure détaillée ===== É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" ---- ===== 10. Statuts ===== NEW CONTACTED QUALIFIED PROPOSAL NEGOTIATION WON LOST ARCHIVED ---- ===== 11. Automatisations ===== 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 ---- ===== 12. Notifications ===== Notifier : Commercial responsable Afficher : Nouvelle opportunité créée Si le prospect provient du site marketing : Notifier également Marketing. ---- ===== 13. Audit ===== Journaliser : Utilisateur Date Adresse IP Navigateur Anciennes valeurs Nouvelles valeurs Origine API utilisée ---- ===== 14. Sécurité ===== Permissions : SALES_CREATE SALES_READ Le commercial ne peut modifier que ses propres prospects sauf permission spécifique. Toutes les modifications sont historisées. ---- ===== 15. Modèle de données ===== Entités : Prospect ProspectContact LeadSource Campaign Activity TimelineEvent Tag Attachment CustomFieldValue ---- ===== 16. Événements ===== LeadCreated ActivityCreated TimelineUpdated SearchIndexed NotificationQueued AuditLogged ---- ===== 17. API ===== 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 ---- ===== 18. Permissions RBAC ===== Créer Modifier Supprimer Fusionner Exporter Importer Convertir Attribuer ---- ===== 19. Cockpit ===== Après création : Le Cockpit Commercial affiche : * Prospect créé aujourd'hui * Tâche à effectuer * Score * Pipeline * Dernières activités ---- ===== 20. KPI ===== Nombre de prospects Prospects créés Prospects qualifiés Temps moyen avant qualification Origine des prospects Répartition par commercial Taux de conversion ---- ===== 21. Cas d'erreur ===== 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 ---- ===== 22. Critères d'acceptation ===== ✓ 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. ---- ===== 23. Tests QA ===== 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 ---- ===== 24. Prompt IA ===== 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.