Projets lies

Pour les grandes architectures, il est souvent utile de diviser la documentation en plusieurs projets : un par equipe, un par domaine, un par microservice. Le node "Linked Project" vous permet d'embarquer visuellement un projet dans un autre, montrant comment les systemes interagissent sans dupliquer la documentation.

Concept#

Un Linked Project Node est un type de node special qui represente un autre projet d'architecture. Il peut etre affiche dans deux etats :

Etat plie (defaut)#

Le node affiche un resume compact :

• Nom du projet lie
• Statistiques (X nodes, Y edges)
• Icone indiquant qu'il s'agit d'un projet lie

Etat deplie#

Le node s'agrandit pour afficher tous les composants du projet lie :

• Les nodes du projet lie sont affiches a l'interieur
• Ils sont en lecture seule (non editables)
• Les connexions internes sont visibles
• Le tout est contenu dans une bordure distinctive

Creer un Linked Project Node#

1. Dans la toolbar, selectionnez le type Linked Project (dans la categorie speciale)
2. Placez-le sur le canvas
3. Dans le panneau de proprietes, selectionnez le projet a lier
4. Seuls les projets auxquels vous avez acces sont listés

Deplier / Replier#

Deplier#

1. Selectionnez le Linked Project Node
2. Cliquez sur le bouton Deplier dans le panneau de proprietes
3. Ou double-cliquez sur le node

Le node s'agrandit et affiche le contenu du projet lie.

Replier#

1. Selectionnez le Linked Project Node deplie
2. Cliquez sur Replier
3. Ou double-cliquez sur la bordure du node

Le node revient a son etat compact.

Permissions#

Les permissions affectent ce que vous voyez :

Les utilisateurs sans acces au projet lie voient le node mais ne peuvent pas en explorer le contenu. Ils savent qu'un projet existe sans voir ses details.

Connexions#

Vers un Linked Project#

Vous pouvez creer des connexions vers un Linked Project Node :

1. Depuis un node de votre projet
2. Vers le Linked Project Node (plie ou deplie)
3. La connexion represente l'interaction avec le systeme externe

Vers les nodes internes#

Quand le Linked Project est deplie, vous pouvez connecter :

• Depuis votre projet vers un node specifique du projet lie
• La connexion est plus precise qu'une connexion vers le node global

Comptage des nodes#

Les nodes d'un Linked Project deplie comptent vers la limite de votre projet hote :

Gardez cela a l'esprit quand vous depliez des projets volumineux.

Recursivite#

Un projet lie peut lui-meme contenir des Linked Project Nodes :

Projet A
└── Linked: Projet B
    └── Linked: Projet C
        └── Linked: Projet D (max)

La profondeur maximale est de 3 niveaux pour eviter les boucles et la complexite excessive.

Cas d'usage#

Vue d'ensemble systeme#

Vous etes architecte systeme et voulez montrer comment 5 microservices interagissent :

1. Creez un projet "Vue Systeme"
2. Ajoutez 5 Linked Project Nodes (un par microservice)
3. Connectez-les pour montrer les flux
4. Chaque equipe maintient son propre projet

Presentation direction#

Pour une presentation aux executives :

1. Laissez les Linked Projects plies (vue macro)
2. Montrez les interactions principales
3. Depliez ponctuellement pour repondre aux questions

Documentation d'integration#

Documentez comment votre service s'integre aux systemes partenaires :

1. Votre service au centre
2. Linked Projects pour chaque systeme externe
3. Connexions montrant les APIs utilisees

Cartographie domaine#

Pour le Domain-Driven Design :

1. Un projet par bounded context
2. Un projet "Context Map" liant tous les contextes
3. Les relations entre contextes sont explicites

Limitations#

Contenu statique#

Le contenu d'un Linked Project est charge a l'ouverture. Si le projet source est modifie pendant que vous travaillez, vous ne verrez pas les changements automatiquement.

Pour rafraichir :

1. Repliez le Linked Project
2. Depliez-le a nouveau

Edition#

Les nodes internes d'un Linked Project sont en lecture seule :

• Vous ne pouvez pas les deplacer
• Vous ne pouvez pas modifier leurs proprietes
• Vous ne pouvez pas les supprimer

Pour modifier, ouvrez le projet source.

Connexions internes#

Les connexions entre les nodes du projet lie sont affichees mais non editables.

Bonnes pratiques#

Granularite#

Choisissez le bon niveau de decoupage :

• Trop de Linked Projects → Navigation complexe
• Pas assez → Projets monolithiques difficiles a maintenir

Regle : un projet par equipe ou par domaine fonctionnel.

Nommage#

Adoptez une convention claire pour les noms de projets :

• team-backend-users-service
• domain-payments
• infra-kubernetes-cluster

Permissions#

Assurez-vous que les utilisateurs ont les bons acces :

• Les architectes peuvent voir tous les projets
• Les equipes voient leurs projets + les projets lies
• Les stakeholders ont des vues simplifiees

Documentation#

Dans le projet hote, ajoutez des notes expliquant :

• Pourquoi ce projet est lie
• Quelles interactions existent
• Qui contacter pour plus de details

Prochaines etapes#

• Groupes pour organiser visuellement
• Analyse d'impact qui fonctionne avec les projets lies
• Mode Presentation pour presenter les vues systeme