Exemple · fictif

Comment Acme Corp tient à jour la documentation d’une org Salesforce de 172 objets, analyse après analyse.

Acme Corp, une entreprise fictive de taille intermédiaire, exploite une seule org Salesforce consolidée. Plutôt que de remettre la documentation à plat une fois par an dans l’urgence, l’équipe s’appuie sur un portail qu’elle fait réanalyser après chaque mise en production.

Acme Corp (fictive) Europe Scénario illustratif
Portail — tableau de bord de la documentation
Le tableau de bord que l’équipe d’Acme Corp ouvre chaque matin : objets, règles métier, flows d’écran, processus et intégrations, tels que les a relevés la dernière analyse.
172
Objets documentés
2 376
Règles métier
41
Flows d’écran
124
Intégrations et API
Dans le portail

Les écrans que l’équipe consulte au quotidien.

Trois des écrans sur lesquels Acme Corp s’appuie, présentés ici en captures réelles et anonymisées du portail.

Historique des changements
Les règles métier ajoutées, modifiées et supprimées d’une analyse à l’autre.
Graphe d’exécution
Les points d’entrée et les règles métier, regroupés par événement.
Org Expert
Une réponse sourcée, tirée de la documentation de l’org.
01 · Contexte

Une org consolidée, une documentation dépassée.

Acme Corp exploite une seule org Salesforce, bâtie au fil de plusieurs années de consolidation : 172 objets documentés, 2 376 règles métier, 41 flows d’écran et 124 intégrations.

La documentation était un chantier annuel : exacte la semaine de sa rédaction, dépassée un mois plus tard. Chaque audit, chaque revue de migration commençait par redécouvrir l’org en repartant de zéro.

02 · Le changement

D’un document annuel à un portail.

Avec aprity, l’équipe fait réanalyser l’org chaque semaine, après chaque mise en production. Le portail de documentation évolue avec l’org, et l’équipe le consulte directement au lieu de tenir des fichiers à jour.

Chaque règle métier renvoie au composant dont elle est tirée : les relecteurs confrontent l’explication à l’org au lieu de croire un document sur parole.

03 · Au quotidien

Comprendre l’org avant chaque modification.

Avant de toucher à un objet, un architecte ouvre sa page et son graphe d’exécution pour voir les règles métier et les automatisations qui s’y appliquent.

Lorsqu’un nouveau chantier est cadré, le Story Agent rédige dans le portail des user stories au format Gherkin, fondées sur l’org documentée, que l’équipe relit ensuite.

Et votre org ?

Faites documenter votre propre org.

Trois ressources pour documenter votre org

Une méthode, un modèle réutilisable et un exemple commenté, accessibles sans inscription.