Guide de Démarrage Rapide

Ce guide vous aidera à créer votre premier diagramme d'architecture dans Archyl en quelques minutes seulement.

Étape 1 : Créer un Compte

1. Allez sur app.archyl.com
2. Inscrivez-vous avec votre email ou connectez-vous avec GitHub, GitLab ou Bitbucket
3. Vérifiez votre email si vous vous êtes inscrit par email

Étape 2 : Créer Votre Premier Projet

1. Cliquez sur "Nouveau Projet" sur votre tableau de bord
2. Entrez un nom pour votre projet (ex : "Ma Plateforme E-commerce")
3. Ajoutez optionnellement une description et des tags
4. Cliquez sur "Créer le Projet"

Étape 3 : Ajouter Votre Premier Système

1. Dans votre nouveau projet, vous commencerez au niveau Contexte Système
2. Cliquez sur le bouton "+" ou faites un clic droit sur le canevas
3. Sélectionnez "Ajouter un Système"
4. Entrez un nom (ex : "Plateforme E-commerce")
5. Ajoutez une description de ce que fait le système

Étape 4 : Ajouter des Systèmes Externes

Les vrais systèmes n'existent pas isolément. Ajoutez les systèmes externes avec lesquels votre logiciel interagit :

1. Cliquez sur "+" et sélectionnez "Ajouter un Système Externe"
2. Ajoutez des systèmes comme "Passerelle de Paiement", "Service Email", "CDN"
3. Ceux-ci apparaîtront avec un style différent pour montrer qu'ils sont externes

Étape 5 : Créer des Relations

Montrez comment les systèmes communiquent :

1. Cliquez sur le système source
2. Glissez depuis le point de connexion vers le système cible
3. Ajoutez un libellé décrivant la relation (ex : "Traite les paiements via API")

Étape 6 : Zoomer sur les Conteneurs

Double-cliquez sur votre système principal pour plonger au niveau Conteneur :

1. Ajoutez des conteneurs comme "Application Web", "Serveur API", "Base de Données"
2. Montrez comment ils communiquent entre eux
3. Connectez-les aux systèmes externes

Prochaines Étapes

Félicitations ! Vous avez créé votre premier diagramme d'architecture. Voici ce qu'il faut explorer ensuite :

• Connecter un Dépôt - Laissez l'IA découvrir votre architecture automatiquement
• Découverte IA - Apprenez comment l'IA analyse votre code
• Collaboration d'Équipe - Invitez vos membres d'équipe
• Export et Partage - Partagez vos diagrammes avec les parties prenantes

Conseils pour Réussir

• Commencez haut niveau : Débutez par le Contexte Système avant de plonger dans les détails
• Utilisez des noms clairs : Nommez les systèmes et conteneurs de manière descriptive
• Ajoutez des descriptions : Votre vous futur (et votre équipe) vous remerciera
• Itérez : La documentation d'architecture est vivante - mettez-la à jour au fur et à mesure que votre système évolue