Aller au contenu
Meubles Morinière

Le produitLogique métier8 min de lecture

Clients

Un client existe dès qu’il commande ou reçoit un devis, sa fiche se crée toute seule à la vente, deux fiches se fusionnent, et la fiche rassemble ses affaires, ce qui attend un geste et ses données personnelles.

Au magasin, un client revient des mois après son premier passage. Il vient régler un solde, retirer un buffet ou demander un second devis. La personne qui le reçoit n’est pas toujours celle qui a fait la vente. Il faut qu’elle retrouve en quelques secondes ce qu’il a commandé, où en est son meuble et ce qu’il doit encore. Et ça, que la vente soit passée par le site, par le magasin ou par un devis.

Les chemins sans préfixe partent de apps/erp/.

Le client dépend des commandes et des devis, parce qu’il les regroupe. Sa fiche préremplit la vente au magasin et le devis. Le compte du site s’en sert pour montrer à un client connecté les ventes du magasin rattachées à son adresse e-mail (Compte client). Et la conservation des données anonymise la fiche quand plus rien ne s’y rattache (Données personnelles).

Un client sans fiche

Le site ne crée pas de fiche client. Son rôle dans la base n’a pas le droit d’en écrire, et la base refuse une commande du site qui en porterait une (Order_site_guard_insert). Du coup, une commande en ligne ne connaît que l’adresse e-mail saisie à la caisse.

Pourtant, la liste des clients montre ces acheteurs, parce qu’elle se calcule à partir des commandes et des devis (modules/customers/data/get-admin-customers.ts#customerRowsSql). Chaque commande et chaque devis désigne son client par sa fiche quand il en a une. Sinon, c’est par la fiche qui porte la même adresse e-mail. Et sinon, par l’adresse elle-même. Donc une personne qui a abandonné un paiement sur le site apparaît dans la liste avec son nom, son téléphone et la date de son dernier contact, et personne n’a eu à la saisir.

Le lien de la page suit le même principe. Un client qui a une fiche s’ouvre par l’identifiant de sa fiche. Un client sans fiche s’ouvre par son adresse e-mail encodée (shared/lib/customer-key.ts#customerKey). Le jour où une fiche prend cette adresse e-mail, l’ancien lien redirige vers elle (app/(console)/clients/[cle]/page.tsx).

La fiche se crée à la vente

Personne n’a à créer une fiche avant de vendre. Une seule fonction rattache une vente à son client (shared/server/customer-link.ts#linkCustomer). Quatre gestes l’appellent dans leur propre transaction : la vente au magasin (shared/server/store-order.ts#createStoreOrder), la création d’un devis (modules/quotes/services/quote-admin.service.ts#createQuote), la correction des coordonnées d’une commande (modules/orders/services/order-edits.service.ts) et l’encaissement d’une commande du site par le webhook (modules/payments/services/webhook-session.service.ts). Du coup, une commande en ligne reçoit sa fiche au moment où elle est payée, et c’est l’ERP qui l’écrit.

  • Avec une adresse e-mail, la fonction cherche la fiche qui la porte, et elle la crée si elle n’existe pas. Une fiche qui existe déjà n’est complétée que là où elle était vide (téléphone, société, SIREN, numéro de TVA). Donc ce qu’un client a tapé à la caisse n’écrase pas ce que l’équipe a saisi.
  • Sans adresse e-mail, et ça arrive au magasin, la vente rejoint la fiche qui porte le même téléphone et le même nom, comparés sans casse ni accents. Sinon, une fiche s’ouvre.
  • Une vente soldée et remise sur place à un client qui ne donne ni nom ni adresse e-mail n’a pas de fiche (Acomptes et paiements).

Tant qu’un client n’a pas de ligne dans la base, il n’y a pas de contrainte qui puisse empêcher deux ventes simultanées de lui ouvrir deux fiches. Du coup, la fonction prend un verrou consultatif sur l’adresse e-mail, ou sur le téléphone, le temps de la transaction (Données). Et de toute façon, l’index unique partiel de l’adresse e-mail (Customer_email_key) refuse une seconde fiche pour la même adresse.

On peut aussi créer une fiche à la main, pour quelqu’un qui passe se renseigner avant toute vente (modules/customers/services/customer-admin.service.ts#createCustomer). Le service refuse une adresse e-mail déjà prise. Il refuse aussi une fiche jumelle, avec le même nom et le même téléphone. Si des commandes ou des devis sans fiche portent déjà cette adresse, ils s’y rattachent dans la même transaction.

Corriger et fusionner

Quand on change l’adresse e-mail d’une fiche (#updateCustomer), certaines commandes et certains devis ne lui étaient liés que par l’ancienne adresse. On commence par les rattacher pour de bon. Sans ça, ils quitteraient la fiche au moment où son adresse change. Le service verrouille la fiche, la relit et refuse si son adresse a changé entre-temps (CUSTOMER_ERROR_MESSAGES.CHANGED). Une société établie en France doit donner son SIREN (customerSirenIssue), et le pays se lit sur la dernière adresse de livraison connue du client.

Il y a quand même des doublons : une faute de frappe dans une adresse, un client qui donne son adresse personnelle puis celle de sa société. #mergeCustomers fusionne deux fiches en une transaction.

  1. Il verrouille les deux adresses e-mail et les deux lignes dans un ordre stable. Il relit les fiches et il refuse si l’adresse de l’une a changé entre-temps.
  2. Les commandes et les devis de la fiche absorbée passent à celle qu’on garde, y compris ceux qui ne lui étaient liés que par l’adresse e-mail.
  3. La fiche gardée n’est complétée que là où elle était vide. Un SIREN ou un numéro de TVA ne passe de l’une à l’autre que si les deux fiches nomment la même société (ou si l’une n’en nomme pas) et si les deux numéros se correspondent. Si la fiche gardée n’a ni société, ni SIREN, ni TVA, elle reprend ceux de l’autre. Les deux notes se mettent bout à bout.
  4. La fiche absorbée est supprimée, et l’écran dit combien de commandes et de devis ont changé de fiche.

Une fiche anonymisée ne se fusionne pas.

Ce que la fiche rassemble

La fiche répond aux questions du vendeur dans l’ordre où il se les pose.

D’abord, il veut savoir à qui il parle. Une ligne le résume (app/(console)/clients/[cle]/_components/customer-standing.ts#customerStanding). Elle dit « Prospect » tant qu’aucune commande n’est payée, et « Fidèle » à partir de deux. Elle donne le nombre de commandes payées, le total payé net des remboursements, les devis en cours, et depuis quand on connaît le client. Elle dit aussi quel vendeur le suit, c’est-à-dire celui de sa dernière affaire.

Ensuite, il veut savoir si quelque chose attend. Le bloc du haut liste les commandes qui ont un signal levé ou un solde à encaisser. Les signaux graves passent d’abord, puis la commande la plus ancienne (_lib/customer-pending.ts#customerPendingOrders). Les signaux sont ceux de la fiche commande (La journée de l’équipe), et la fiche client y ajoute la réclamation au transporteur encore à faire (afterSalesSignals). Les devis à relancer viennent après, en commençant par la fin de validité la plus proche.

Puis il y a l’historique. Un client ne parle pas de sa commande n° 1042, il parle de son buffet. Du coup, la fiche range l’historique par affaire (_lib/customer-affairs.ts#customerAffairs). Un devis et la commande qui en est sortie, c’est une seule ligne. Trois vues filtrent les affaires en cours, celles qui ont une facture ou un avoir, et celles qui ont du SAV (AFFAIR_VIEWS). Les paiements abandonnés sur le site et les devis expirés ou annulés restés sans suite sont repliés en bas de l’historique (isAffairNoise). On peut toujours les consulter.

Pour finir, la fiche montre les trois dernières adresses de livraison distinctes du client, avec les consignes d’accès laissées pour chacune (modules/customers/lib/customer-summary.ts#customerAddresses). Elles sont lues sur ses commandes et ses devis, donc il n’y a pas de carnet d’adresses à entretenir. La fiche dit aussi si un compte existe sur le site pour cette adresse e-mail (getAdminSiteAccount).

Depuis la fiche, une vente au magasin, un lien de paiement ou un devis s’ouvrent avec le client déjà rempli.

La liste et les chiffres

La liste se trie par dernier contact, et deux vues isolent les prospects et les fidèles (CUSTOMER_VIEWS). Pour la recherche, on tape un bout du nom ou de l’adresse e-mail, ou au moins six chiffres du téléphone. Un client au bout du fil donne son numéro avant son nom.

La page Ventes lit les clients sur quatre-vingt-dix jours (modules/customers/lib/customer-pulse.ts#CUSTOMER_PULSE_WINDOW_DAYS). Elle donne la part de nouveaux clients et de clients revenus, et la part de paiements abandonnés sur le site. Chacune est comparée à la période d’avant.

Les données personnelles

Un client peut demander l’effacement de ses données. Le geste part de sa fiche. Avant de confirmer, l’écran dit ce qui va se passer (_components/customer-erasure.ts#erasureForecast). Les commandes closes sont anonymisées. Les commandes en cours restent telles quelles. Les devis qui ne servent plus sont supprimés. Le compte du site est effacé. Et la fiche est anonymisée à son tour quand plus rien ne s’y rattache. L’étude de cas Un effacement qui survit à une restauration raconte ce que devient cet effacement quand on restaure une copie de la base.

S’il n’y a pas de demande, la veille du matin fait une partie de ce travail à l’échéance. Les commandes closes, elle ne fait que les lister, et elles s’anonymisent à la main. Par contre, elle anonymise d’elle-même une fiche à laquelle plus aucune commande ni aucun devis ne se rattache, et qui n’a pas été modifiée depuis trente jours (modules/customers/services/customer-retention.service.ts#anonymizeOrphanCustomers, ORPHAN_CUSTOMER_GRACE_DAYS). Et elle supprime un compte du site resté trois ans sans connexion (customer-account-retention.service.ts#deleteInactiveCustomerAccounts, CUSTOMER_ACCOUNT_INACTIVITY_YEARS).

Une fiche anonymisée ne montre plus qu’un message. Les documents comptables archivés gardent le nom du client dix ans, et on les retrouve par le numéro de la commande (CUSTOMER_GONE_DESCRIPTION).

Les limites

  • Ce n’est pas un outil de relation client. Il n’y a pas d’étiquettes, pas de segments, pas de campagnes d’e-mails, et la fiche n’a qu’une note libre.
  • Un client sans adresse e-mail ne se reconnaît qu’à un nom et un téléphone identiques. Si le nom est écrit autrement, une seconde fiche s’ouvre, et il faut la fusionner.
  • Le nom d’un client sans fiche, c’est celui de sa dernière commande ou de son dernier devis (customerIdentity). Il change si le client l’écrit autrement la fois suivante.
  • La liste se recalcule à chaque lecture à partir des commandes et des devis. Cette agrégation convient au volume d’un magasin, et la fiche ne lit que les commandes et les devis les plus récents (CUSTOMER_ORDERS_MAX, CUSTOMER_QUOTES_MAX).

Sur cette page