Éléments & Style - Archyl Docs

Découvrez les différents types d'éléments à chaque niveau C4 et comment les styliser

Éléments & Style

Chaque niveau C4 supporte différents types d'éléments. Les comprendre vous aide à créer des diagrammes d'architecture précis et significatifs.

Éléments par Niveau

Niveau 1 : Contexte du Système

Le niveau le plus élevé montre votre système dans son environnement :

Élément Description
Système Logiciel Votre système ou produit principal
Personne Utilisateurs ou personas interagissant avec le système
Système Externe Systèmes tiers avec lesquels votre système s'intègre

Niveau 2 : Conteneur

Montre les blocs de construction techniques au sein d'un système :

Élément Description
Service Services backend ou microservices
API APIs REST, GraphQL ou gRPC
Application Web Applications web frontend
Application Mobile Applications iOS ou Android
Base de Données Bases de données SQL ou NoSQL
Cache Redis, Memcached, etc.
File de Messages Kafka, RabbitMQ, SQS, etc.
Stockage de Fichiers S3, blob storage, systèmes de fichiers

Niveau 3 : Composant

Montre la structure interne d'un conteneur :

Élément Description
Contrôleur Gestionnaires de requêtes HTTP
Handler Gestionnaires d'événements ou de messages
Repository Couche d'accès aux données
Adaptateur Adaptateurs de systèmes externes
Middleware Processeurs de requêtes/réponses
Utilitaire Fonctions d'aide et utilitaires
Modèle Modèles de domaine et entités

Niveau 4 : Code

Montre les détails d'implémentation :

Élément Description
Classe Classes orientées objet
Interface Définitions d'interface
Struct Structures de données
Fonction Fonctions autonomes
Méthode Méthodes de classe
Enum Types d'énumération
Constante Valeurs constantes
Type Définitions de type

Ajouter des Éléments

Utiliser le Bouton Ajouter

  1. Cliquez sur Ajouter dans la barre d'outils
  2. Sélectionnez le type d'élément
  3. Entrez le nom et la description
  4. Cliquez sur Créer

Utiliser le Menu Contextuel

  1. Cliquez droit sur le canevas vide
  2. Sélectionnez Ajouter [Type d'Élément]
  3. Remplissez les détails
  4. Cliquez sur Créer

Glisser-Déposer

Pour les conteneurs et composants, vous pouvez faire glisser les éléments depuis la barre latérale directement sur le canevas.

Styliser les Éléments

Accéder aux Options de Style

Cliquez droit sur n'importe quel élément pour accéder au style :

  • Couleur de fond : Couleur de remplissage de l'élément
  • Couleur de bordure : Couleur du contour
  • Couleur du texte : Couleur du label
  • Icône : Icône visuelle représentant l'élément

Palette de Couleurs

Archyl fournit une palette de couleurs soignée :

  • Tons de bleu : Services, APIs
  • Tons de vert : Bases de données, stockage
  • Tons de violet : Systèmes externes
  • Tons d'orange : Files de messages, asynchrone
  • Tons de gris : Utilitaires, infrastructure

Conseils pour un Style Cohérent

  • Utilisez la même couleur pour des types d'éléments similaires
  • Alignez les couleurs avec les conventions de votre organisation
  • Considérez les palettes adaptées aux daltoniens
  • Documentez votre schéma de couleurs dans les notes du projet

Overlays

Les overlays sont des regroupements visuels colorés qui aident à organiser les éléments sur votre diagramme.

Créer un Overlay

  1. Cliquez sur Ajouter et sélectionnez Overlay
  2. Donnez-lui un nom (ex : "Services Backend", "Apps Frontend")
  3. Choisissez une couleur de la palette
  4. Cliquez sur Créer

Utiliser les Overlays

  • Faites glisser les éléments dans la zone de l'overlay
  • L'overlay fournit un regroupement visuel
  • Les overlays sont spécifiques au niveau
  • Différents regroupements à chaque niveau C4

Cas d'Utilisation des Overlays

  • Regrouper par responsabilité d'équipe
  • Regrouper par unité de déploiement
  • Regrouper par domaine (contextes bornés DDD)
  • Mettre en évidence les composants du chemin critique
  • Montrer les frontières de sécurité

Bonnes Pratiques pour les Overlays

  1. Restez simple : 3-5 overlays maximum par niveau
  2. Utilisez des noms significatifs : "Domaine Paiement" pas "Groupe 1"
  3. Couleurs cohérentes : Même couleur d'overlay à travers les niveaux pour les regroupements liés
  4. Ne pas chevaucher : Évitez les overlays qui se chevauchent confusément

Styliser les Relations

Les relations peuvent aussi être stylisées :

Propriété Options
Couleur Correspondre aux couleurs des éléments ou utiliser du neutre
Style de ligne Solide, pointillé, en tirets
Épaisseur de ligne Fine, moyenne, épaisse
Style de flèche Standard, creuse, aucune

Conseils de Style pour les Relations

  • Utilisez des lignes pointillées pour la communication asynchrone
  • Utilisez des lignes plus épaisses pour les flux de données principaux
  • Codez par couleur selon le protocole (HTTP, gRPC, événements)

Prochaines Étapes