Rapprochement automatique domaine → client CRM

Backlog #1394 — brique interne consommée par la reprise entrante des contacts Brevo.

À quoi ça sert

Quand un contact vient de l'extérieur (aujourd'hui : la reprise des contacts Brevo), il faut savoir à quel client CRM le rattacher. Le domaine de son adresse e-mail (jean@acme.fr → acme.fr) est le seul indice fiable disponible, mais il ne l'est que rarement de façon directe : sur les 37 106 clients du tenant mesuré, seuls 142 ont un domaine explicitement déclaré sur leur fiche. Cette brique élargit la couverture à trois sources, de la plus fiable à la moins fiable :

1. le domaine déclaré sur la fiche client (« Domaine principal ») ;
2. à défaut, le domaine déduit du site web renseigné sur la fiche (4 736 clients) ;
3. à défaut encore, les domaines observés sur les e-mails des contacts déjà saisis pour ce client (612 clients supplémentaires).

Comment ça marche

Pour chaque client, la source la plus fiable disponible est utilisée — jamais un mélange des trois. Un domaine de messagerie grand public (Gmail, Orange, Wanadoo…) n'est jamais retenu comme domaine d'un client, même s'il a été saisi par erreur comme domaine principal : dans ce cas, la recherche continue simplement sur la source suivante (le site web, puis les contacts).

Un domaine qui désigne plusieurs clients n'est jamais rattaché automatiquement. Deux exemples réels rencontrés : alged.com correspond à 2 clients différents dans le CRM, et gmail.com à 15 — un domaine, même d'apparence professionnelle, n'est pas une garantie d'appartenir à un seul client. Dans ces cas, la reprise ne choisit pas à la place de l'utilisateur : le contact est signalé pour une revue manuelle (côté import Brevo), avec la liste des clients possibles quand elle est connue et raisonnablement courte.

Un sous-domaine (compta.acme.fr) est d'abord recherché tel quel, puis sur le domaine parent (acme.fr) s'il n'est pas trouvé directement — mais seulement si ce domaine parent identifie lui aussi un client unique. Si le parent est également partagé par plusieurs clients, le contact n'est pas rattaché non plus.

Règles d'accès

Aucun écran dédié à ce stade : cette brique est une règle de rapprochement interne, consommée par le lot d'import entrant des contacts Brevo (à venir). Les droits d'accès applicables sont ceux du connecteur Brevo, pas ceux de cette brique.

Points d'attention

• Un domaine ambigu ou grand public n'est jamais arbitré automatiquement — le contact correspondant reste à traiter manuellement plutôt que d'être rattaché au hasard.
• Un client qui n'a ni domaine déclaré, ni site web, ni aucun contact avec adresse e-mail n'entre dans aucune des trois sources : ses futurs contacts importés resteront non rapprochés tant qu'aucune de ces informations n'est renseignée sur sa fiche.
• La règle est propre à chaque tenant : un client d'une autre entité n'entre jamais en concurrence dans le rapprochement, même s'il partage le même nom de domaine.

Voir aussi

• Doc technique : ../../.claude/technical-docs/crm/customer-domain-resolver.md
• Connecteur Brevo (import entrant) : ../integrations/brevo-connector.md