Skip to content
Retour au portfolio

Décisions d'architecture

Les choix techniques derrière ce portfolio relié à Salesforce : le contexte, la décision prise et ce qu'elle coûte. Tout ce qui est décrit ici est en production sur ce site.

  1. ADR-01

    Authentification de serveur à serveur par JWT Bearer

    Contexte
    Le site doit créer des enregistrements dans Salesforce sans qu'aucun visiteur se connecte, et sans exposer d'identifiant dans le navigateur.
    Décision
    Une External Client App avec certificat. Le serveur signe un JWT avec une clé privée stockée en variable d'environnement, Salesforce délivre un jeton d'accès, et un Permission Set limite l'accès aux seuls objets et champs utiles.
    Compromis
    Le certificat a une date d'expiration et doit être renouvelé. La configuration initiale est plus longue qu'un simple mot de passe, mais aucun secret ne quitte le serveur.
  2. ADR-02

    L'objet Lead standard plutôt qu'un objet personnalisé

    Contexte
    Les prises de contact viennent de recruteurs, de clients ou d'autres visiteurs, avec des informations différentes selon le cas.
    Décision
    Les demandes arrivent dans l'objet Lead, enrichi de champs personnalisés (type de visiteur, domaines d'intérêt, budget, délai). Un objet personnalisé n'est utilisé que pour les conversations de l'assistant.
    Compromis
    On profite de la conversion, des rapports et des règles de doublons standard. En contrepartie, ces règles ont bloqué des créations légitimes : l'appel API autorise désormais explicitement l'enregistrement d'un doublon.
  3. ADR-03

    Les e-mails partent de Salesforce, pas du site

    Contexte
    Chaque prise de contact doit déclencher un accusé de réception pour le visiteur et une notification pour moi.
    Décision
    Un trigger Apex après insertion appelle un service qui traite les Leads par lots. Un échec d'envoi n'empêche jamais la création du Lead : il est enregistré comme une tâche sur le Lead.
    Compromis
    Aucun service d'envoi supplémentaire à maintenir, et l'e-mail est tracé sur l'enregistrement. Mais une Developer Edition limite le nombre d'e-mails externes par jour, et un expéditeur en adresse Gmail reste fragile : la cible est un domaine propre, signé en DKIM.
  4. ADR-04

    Une notification qui n'arrivait pas : isoler la cause par variantes

    Contexte
    Salesforce acceptait la notification sans erreur, mais elle n'arrivait ni en boîte de réception ni en spam, alors que l'accusé de réception passait.
    Décision
    Plutôt que de deviner, un script a envoyé six variantes, chacune ajoutant un seul élément du message. Les deux variantes perdues contenaient un lien direct vers Salesforce et un lien mailto. Le lien passe maintenant par une redirection du site, qui n'accepte qu'un identifiant de Lead, et la réponse au visiteur se fait par l'en-tête Reply-To.
    Compromis
    Un clic de plus pour ouvrir le Lead, et une route supplémentaire à sécuriser. En échange, le message est livré et la méthode est réutilisable pour tout futur problème de délivrabilité.
  5. ADR-05

    Exposer le minimum vers l'extérieur

    Contexte
    Le site affiche l'état de la connexion à Salesforce, et ses routes API sont publiques.
    Décision
    La route d'état ne renvoie que trois informations : connecté ou non, version d'API et temps de réponse. Les messages d'erreur détaillés restent dans les journaux du serveur.
    Compromis
    Un diagnostic un peu moins direct depuis le navigateur, mais aucun détail de configuration n'est visible par un visiteur.
  6. ADR-06

    Un contenu piloté par des fichiers, des métadonnées versionnées

    Contexte
    Le portfolio évolue souvent : nouvelles missions, certifications, traductions.
    Décision
    Les contenus français et anglais vivent dans des fichiers JSON, les pages sont générées statiquement, et seules les routes reliées à Salesforce s'exécutent à la demande. Côté Salesforce, champs, objet, trigger et classes sont versionnés au format SFDX dans le même dépôt.
    Compromis
    Chaque modification de contenu demande un déploiement, mais le site reste rapide et l'org peut être reconstruite avec une seule commande.