Guide
Dossier d'architecture d'un assistant IA : le plan
Plan d'un dossier d'architecture technique pour un assistant IA branché sur un CRM ou un ERP : arc42, schémas C4 et contenu de chaque partie.
Mis à jour le
Un dossier d'architecture technique (souvent abrégé DAT) est le document qui permet à quelqu'un d'autre que vous, le client, son informaticien ou votre successeur, de comprendre comment l'assistant IA est branché : ce qui parle à quoi, où tournent les composants, quelles décisions ont été prises et pourquoi. Pour commencer, nous proposons un schéma de contexte, une vue des applications et des données, puis les explications utiles sur les flux, les droits et les décisions. La taille du dossier dépend du système et des exigences du client. arc42 fournit un plan adaptable ; C4 aide à choisir les vues.
Le dossier doit situer les fonctions ALMA mobilisées dans les flux, puis préciser les responsabilités de chaque composant.
Le plan : arc42 en douze parties
Le modèle arc42, présenté sur son site (lu le 16/11/2026), se décrit comme « Open source and free, also for commercial use » (contenu du site sous licence CC BY-SA 4.0). Ses douze parties :
- Introduction et objectifs : les exigences fondamentales, notamment les objectifs de qualité ;
- Contraintes : règles et limites externes ;
- Contexte et périmètre : systèmes externes et interfaces ;
- Stratégie de solution : les idées directrices ;
- Vue des briques : la structure, décomposée hiérarchiquement ;
- Vue d'exécution : les scénarios importants ;
- Vue de déploiement : matériel, infrastructure, déploiement ;
- Concepts transverses : les sujets qui concernent plusieurs briques ;
- Décisions d'architecture ;
- Exigences de qualité ;
- Risques et dette technique ;
- Glossaire.
Développez chaque partie selon les décisions à expliquer. Une intégration courte peut avoir des exigences d'accès ou de disponibilité importantes : le nombre de composants ne suffit pas à décider quelles sections négliger.
Les schémas : le contexte, puis les conteneurs
Le modèle C4 (site c4model.com, lu le 16/11/2026) propose quatre niveaux de zoom : contexte du système, conteneurs, composants, code. Son site précise que les diagrammes de contexte et de conteneurs suffisent à la plupart des équipes, et qu'il n'est pas nécessaire d'utiliser les quatre niveaux.
- Diagramme de contexte : le système au centre, les personnes et les systèmes externes directement reliés autour. Public : tout le monde, techniciens ou non. L'accent porte sur les acteurs et les systèmes, sans détailler les protocoles. Pour votre projet : l'assistant au centre, avec les visiteurs ou les collaborateurs, le CRM ou l'ERP, la base de documents, l'outil d'automatisation éventuel.
- Diagramme de conteneurs : on ouvre la boîte. Un « conteneur », dans C4, est une application ou un lieu de stockage de données (application web, base de données, dossier de fichiers…). Public : les techniciens, dans l'équipe ou à l'extérieur. Il montre l'architecture générale, la répartition des responsabilités, les choix techniques majeurs et la façon dont les conteneurs communiquent. Le déploiement (grappes, répartition de charge) se dessine à part, par environnement.
Ce que contient chaque partie, pour un assistant IA
Les contenus ci-dessous sont une proposition de l'éditeur de ce site, appuyée sur le plan arc42.
| Partie arc42 | Ce que vous y écrivez pour l'assistant |
|---|---|
| 1. Objectifs | Les questions traitées, les écritures autorisées, les critères de recette décidés au cadrage |
| 2. Contraintes | Édition du CRM, limites d'appels de l'éditeur, contraintes de sécurité du client |
| 3. Contexte | Le schéma de contexte, la liste des interfaces et de qui les maintient |
| 5. Briques | Le schéma de conteneurs : site ou interface de discussion, plateforme de l'assistant, sources de documents, connecteurs, outil d'automatisation, journal |
| 6. Exécution | Trois ou quatre scénarios : question simple, lecture d'une donnée du CRM, écriture validée, panne d'une source |
| 7. Déploiement | Qui héberge quoi, quels comptes, quels environnements (test, production) |
| 8. Transverse | Droits (Droits d'accès), erreurs (Gestion des erreurs d'un flux), journalisation, secrets |
| 9. Décisions | Une fiche par choix : API directe ou serveur MCP (MCP ou API), synchronisation ou lecture à la demande, outil d'automatisation retenu |
| 10. Qualité | Scénarios mesurables : délai, fraîcheur, réponse attendue et défauts bloquants, dont accès non autorisé |
| 11. Risques | Dépendances à un tiers, jeton qui expire, quota atteint, source mal tenue |
| 12. Glossaire | Les sigles du client et les vôtres |
Les décisions : une fiche courte chacune
Une décision peut tenir dans une fiche courte : contexte, options, choix, raisons, conséquences, date et validateur. Ajoutez les conditions qui conduiraient à la réexaminer. La longueur compte moins que la possibilité de comprendre pourquoi une solution a été retenue et ce qu'elle ne résout pas.
Points à vérifier avant de livrer
- Un lecteur qui ne connaît pas le projet peut-il suivre le chemin d'une question, de l'écran à la donnée du CRM, en regardant un seul schéma ?
- Chaque flèche du schéma de conteneurs porte un verbe (« lit », « écrit », « notifie ») et une fréquence ou un déclencheur.
- Les comptes, les droits et les environnements sont nommés, sans aucun secret (clé, mot de passe) dans le document.
- Chaque choix important a sa fiche de décision.
- La date, la version et le nom de la personne qui tient le dossier à jour sont indiqués : voir Maintenance d'un assistant IA pour la mise à jour à chaque évolution.
- Le dossier a été relu par la personne du client qui administre le CRM ou l'ERP.
Décrire un échec aussi précisément que le parcours normal
Pour une lecture CRM, documentez l'identité transmise, la règle d'autorisation, les champs retournés et le comportement si la source ne répond plus. Une flèche « lecture CRM » ne dit pas si l'assistant attend, utilise une copie ancienne ou répond sans la donnée. Le lecteur doit pouvoir retrouver cette décision sans deviner le comportement du connecteur.
Pour une écriture, décrivez la validation de l'opération, son identifiant, le résultat attendu et le traitement d'une réponse perdue. Une tentative de relance peut créer un doublon si l'opération précédente a réussi sans que l'assistant reçoive la confirmation. Le dossier doit indiquer comment l'état est vérifié avant de recommencer et qui traite les situations non résolues.
Ces scénarios sont notre proposition de contenu pour une intégration. Ils complètent les vues statiques : un dessin des composants ne prouve ni le contrôle des droits ni la récupération après panne.
Relier le dossier à ce qui a été vérifié
Pour chaque exigence critique, donnez la référence du test ou de la vérification, sa date et la version concernée. Séparez les garanties observées des hypothèses fournisseur encore à confirmer. Une bonne note moyenne de réponses ne doit pas masquer un défaut d'isolation entre clients.
Indiquez où trouver les procédures d'exploitation et les paramètres sans recopier les secrets. Le dossier peut renvoyer vers le coffre et le responsable de rotation ; il n'a pas à contenir la valeur des clés. Documentez aussi les différences entre test et production, notamment les autorisations et les données disponibles.
À la livraison, demandez à un autre intervenant de suivre un scénario depuis l'écran jusqu'au résultat, puis d'identifier le point d'arrêt en cas d'erreur. Les questions restées sans réponse montrent ce qu'il faut compléter. Révisez ensuite le dossier avec chaque évolution qui modifie un flux, une responsabilité ou une hypothèse d'architecture.
Questions fréquentes
Existe-t-il un format officiel de dossier d'architecture technique ?
Les références présentées ici sont des modèles adaptables. Un client ou un marché peut imposer son propre dossier : vérifiez les livrables contractuels. arc42 est un modèle en 12 parties, libre d'usage y compris commercial ; le modèle C4 est une façon de dessiner l'architecture à plusieurs niveaux.
Combien de schémas faut-il dans le dossier ?
Peu. Le site du modèle C4 indique que les diagrammes de contexte et de conteneurs suffisent à la plupart des équipes, et qu'il n'est pas nécessaire d'utiliser les quatre niveaux.
Sources
Pages consultées pour écrire cet article :