Décrire un système pour obtenir un premier jet

Sur un schéma vide, quelques phrases suffisent pour un premier modèle. L’Assistant ébauche les personnes, systèmes, conteneurs et flux que vous décrivez ; vous les vérifiez en fantômes, puis vous appliquez. Tout reste modifiable ensuite.

Avant de commencer

• Un schéma vide que vous pouvez modifier. Créez-en un depuis votre bibliothèque : voir Créer un schéma.
• L’Assistant activé, et des crédits restants. Voir Comment l’Assistant utilise les crédits.
• Deux ou trois phrases sur le système : qui l’utilise, de quoi il est fait, avec quoi il échange.

Obtenir le premier jet

1. Ouvrir le schéma vide

   Une feuille vide demande Que voulez-vous concevoir ? avec quelques exemples. La zone de l’Assistant indique Décrivez votre système en une ou deux phrases…

2. Décrire le système

   Écrivez ce dont un collègue aurait besoin pour le dessiner. Pour la Claims Platform :

   « Les assurés déclarent leurs sinistres par un portail web et une app mobile. Les deux appellent la Claims API, qui enregistre les sinistres dans une base PostgreSQL et publie un événement ClaimSubmitted sur un broker de messages. Un service Fraud Scoring consomme l’événement. Les gestionnaires travaillent dans une application web de back-office. La Claims API envoie des e-mails par un fournisseur de messagerie externe. »

   Appuyez sur Enter. La demande s’affiche comme Premier modèle · ajouts seulement : un premier jet ne fait qu’ajouter, il ne retire jamais rien.

3. Vérifier le premier modèle

   Quand il est prêt, la feuille indique Votre premier modèle est prêt dans le panneau de l’Assistant : vérifiez-le, puis appliquez-le. Lisez la liste sur la carte et regardez les fantômes. Décochez ce que vous ne voulez pas ; demandez une modification dans la même conversation s’il manque quelque chose (« Ajoute le fournisseur d’identité qu’utilisent le portail et le back-office. »).

4. Appliquer le premier jet

   Choisissez Appliquer sur la carte.

   Les personnes, systèmes, conteneurs et relations décrits sont sur le canevas, et chacun se sélectionne et se modifie dans l’Inspecteur.

Écrire une description qui marche

• Nommez les choses comme vous voulez les voir étiquetées : Claims API, Fraud Scoring, pas le service.
• Dites qui appelle qui, et comment : appelle en synchrone en HTTPS, publie un événement, lit des fichiers chaque nuit.
• Dites ce qui est hors de votre système : un fournisseur de messagerie externe, une passerelle de paiement, l’API d’un partenaire.
• Ajoutez les technologies quand vous les connaissez : PostgreSQL 16, Kafka. Les contrôles et le radar technologique s’en servent ensuite.
• Restez court. De deux à six phrases donnent un meilleur premier modèle qu’un long cahier des charges. Pour un long document, joignez-le plutôt : voir Apporter des images et des PDF.

Variantes et limites

• Sur un schéma qui a déjà des éléments, la même demande devient une proposition de modification de ce schéma. Sa carte dit où elle va avant que vous appliquiez.
• À partir d’une photo ou d’un croquis : ajoutez la photo d’un tableau blanc au lieu d’écrire. Voir Apporter des images et des PDF.
• Sans IA, commencez à la main ou depuis un gabarit : la feuille vide propose les deux.

BientôtUne proposition de nouveau schéma s’ouvre dans ce nouveau schéma.

Si ça ne marche pas

Autres symptômes : Dépannage de l’Assistant.