Demandes de changement d'architecture

Les demandes de changement d'architecture vous permettent de proposer des modifications à votre modèle C4 via un workflow de revue structure. Au lieu de modifier directement l'architecture, les membres de l'équipe créent des demandes qui peuvent être examinées, discutées et fusionnées.

Fonctionnement

Une demande de changement regroupe une ou plusieurs modifications proposées à votre modèle d'architecture. Elle suit un cycle de vie similaire à une pull request dans les dépôts de code :

1. Créer une demande avec un titre et une description
2. Ajouter des changements — créer, modifier ou supprimer des éléments C4 (systèmes, conteneurs, composants, éléments de code, relations, overlays)
3. Ouvrir pour revue lorsque la proposition est prête
4. Examiner — les membres de l'équipe approuvent, demandent des modifications ou laissent des commentaires
5. Fusionner pour appliquer tous les changements à l'architecture

Cycle de vie d'une demande

Chaque demande passe par ces statuts :

Créer une demande

Depuis l'onglet Demandes

1. Accédez à votre projet
2. Ouvrez l'onglet Demandes
3. Cliquez sur Nouvelle demande
4. Saisissez un titre (200 caractères max) et une description optionnelle
5. La demande commence au statut Brouillon

Ajouter des changements

Dans une demande en brouillon ou ouverte, ajoutez des changements en sélectionnant :

• Opération : Créer, Modifier ou Supprimer
• Type d'élément : Système, Conteneur, Composant, Code, Relation ou Overlay
• Données de l'élément : Les propriétés du nouvel élément ou de l'élément modifie

Les changements sont regroupés par type d'opération (creations, modifications, suppressions) pour faciliter la revue.

Modifier une demande

L'auteur peut modifier le titre et la description d'une demande à tout moment, tant qu'elle n'a pas été fusionnée. Cliquez sur l'icône crayon à côté du titre pour passer en mode édition.

Examiner une demande

Soumettre une revue

Les membres de l'équipe avec un accès en édition peuvent examiner les demandes ouvertes :

• Approuver — la proposition est satisfaisante
• Demander des modifications — des ajustements sont nécessaires avant la fusion
• Commenter — laisser un retour sans décision formelle

Fil d'activité

L'onglet activité affiche toutes les revues et commentaires par ordre chronologique. Utilisez le compositeur de commentaires en bas pour laisser des commentaires rapides sans revue formelle.

Fusionner une demande

Lorsqu'une demande a été examinée et approuvée :

1. Ouvrez la page de détail de la demande
2. Cliquez sur Fusionner
3. Tous les changements sont appliqués de manière atomique au modèle C4

Seuls les membres de l'équipe avec des permissions d'édition peuvent fusionner des demandes.

Prévisualiser les changements

L'onglet Aperçu montre une représentation visuelle de l'architecture après application des changements, permettant aux relecteurs de comprendre l'impact avant la fusion.

Bonnes pratiques

Rédigez des titres clairs

Utilisez des titres descriptifs qui expliquent l'intention :

• "Ajouter le service de paiement et l'intégration Stripe"
• "Diviser l'API monolithique en services utilisateur et commande"
• "Supprimer le composant de notification obsolète"

Gardez les demandes ciblées

• Un changement logique par demande
• Évitez de mélanger des modifications non liées
• Les demandes plus petites sont plus faciles à examiner

Utilisez les descriptions

Expliquez le raisonnement derrière les changements proposés :

• Pourquoi ce changement architectural est nécessaire
• Quelles alternatives ont été envisagées
• Liens vers les ADR ou la documentation associée

Examinez avant de fusionner

• Au moins une approbation est recommandée
• Utilisez les commentaires pour discuter des compromis
• Vérifiez l'onglet aperçu pour valider le résultat

Prochaines étapes

• Aperçu du modèle C4 — Comprendre le modèle d'architecture
• Équipes — Configurer votre équipe pour les revues collaboratives
• Documentation — Lier les ADR aux décisions d'architecture