Demandes de changement d'architecture

Les demandes de changement d'architecture vous permettent de proposer des modifications a votre modele C4 via un workflow de revue structure. Au lieu de modifier directement l'architecture, les membres de l'equipe creent des demandes qui peuvent etre examinees, discutees et fusionnees.

Fonctionnement

Une demande de changement regroupe une ou plusieurs modifications proposees a votre modele d'architecture. Elle suit un cycle de vie similaire a une pull request dans les depots de code :

1. Creer une demande avec un titre et une description
2. Ajouter des changements — creer, modifier ou supprimer des elements C4 (systemes, conteneurs, composants, elements de code, relations, overlays)
3. Ouvrir pour revue lorsque la proposition est prete
4. Examiner — les membres de l'equipe approuvent, demandent des modifications ou laissent des commentaires
5. Fusionner pour appliquer tous les changements a l'architecture

Cycle de vie d'une demande

Chaque demande passe par ces statuts :

Creer une demande

Depuis l'onglet Demandes

1. Accedez a votre projet
2. Ouvrez l'onglet Demandes
3. Cliquez sur Nouvelle demande
4. Saisissez un titre (200 caracteres 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 selectionnant :

• Operation : Creer, Modifier ou Supprimer
• Type d'element : Systeme, Conteneur, Composant, Code, Relation ou Overlay
• Donnees de l'element : Les proprietes du nouvel element ou de l'element modifie

Les changements sont regroupes par type d'operation (creations, modifications, suppressions) pour faciliter la revue.

Modifier une demande

L'auteur peut modifier le titre et la description d'une demande a tout moment, tant qu'elle n'a pas ete fusionnee. Cliquez sur l'icone crayon a cote du titre pour passer en mode edition.

Examiner une demande

Soumettre une revue

Les membres de l'equipe avec un acces en edition peuvent examiner les demandes ouvertes :

• Approuver — la proposition est satisfaisante
• Demander des modifications — des ajustements sont necessaires avant la fusion
• Commenter — laisser un retour sans decision formelle

Fil d'activite

L'onglet activite 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 ete examinee et approuvee :

1. Ouvrez la page de detail de la demande
2. Cliquez sur Fusionner
3. Tous les changements sont appliques de maniere atomique au modele C4

Seuls les membres de l'equipe avec des permissions d'edition peuvent fusionner des demandes.

Previsualiser les changements

L'onglet Apercu montre une representation visuelle de l'architecture apres application des changements, permettant aux relecteurs de comprendre l'impact avant la fusion.

Bonnes pratiques

Redigez des titres clairs

Utilisez des titres descriptifs qui expliquent l'intention :

• "Ajouter le service de paiement et l'integration Stripe"
• "Diviser l'API monolithique en services utilisateur et commande"
• "Supprimer le composant de notification obsolete"

Gardez les demandes ciblees

• Un changement logique par demande
• Evitez de melanger des modifications non liees
• Les demandes plus petites sont plus faciles a examiner

Utilisez les descriptions

Expliquez le raisonnement derriere les changements proposes :

• Pourquoi ce changement architectural est necessaire
• Quelles alternatives ont ete envisagees
• Liens vers les ADR ou la documentation associee

Examinez avant de fusionner

• Au moins une approbation est recommandee
• Utilisez les commentaires pour discuter des compromis
• Verifiez l'onglet apercu pour valider le resultat

Prochaines etapes

• Apercu du modele C4 — Comprendre le modele d'architecture
• Equipes — Configurer votre equipe pour les revues collaboratives
• Documentation — Lier les ADR aux decisions d'architecture