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.
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.
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.
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.
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é.
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.
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.