Multi-project cascade: managing N subjects as one graph

By the OrgGen AI team

Twenty subsidiaries, twenty separate OrgGen projects, one navigable graph: a block linked to another project shows a badge and dives in inline, without copying. This guide distinguishes linking / creating empty / forking — three gestures easily confused — and shows what the sharing cascade actually opens up, and to whom.

The full text of this guide currently exists in French only. The title and summary above are translated.

Trois verbes, trois intentions — ne pas les confondre

OutilLe projet cibleQuand l'utiliser
`link_project_to_cell`EXISTE déjàrattacher un projet qui vit déjà séparément (droits et cycle de vie distincts)
`create_nested_project`n'existe PAS encoredémarrer un sous-sujet vide sous ce bloc — l'inception : détail poussé un niveau plus bas
`fork_linked_project`existe, rattaché, mais en lecture seule pour toien obtenir une copie MODIFIABLE, dont tu deviens propriétaire

Le piège le plus fréquent est d'appeler `create_nested_project` en pensant rattacher un projet existant : il refuse si le bloc porte déjà un rattachement, mais si le bloc est libre, il CRÉE un schéma neuf et VIDE — pas ce qu'on voulait dire.

link_project_to_cell({
  cellId: "filiale-tech",
  projectId: "a1b2c3d4-e5f6-4789-a012-3456789abcde",
  label: "Architecture cible AWS",
})
Rattacher un projet d'architecture déjà modélisé ailleurs

Lire une arborescence entière sans changer de projet

`get_linked_project` lit à travers le rattachement — un aperçu (titre, compteurs, squelette des blocs), jamais le contenu détaillé. Avec `depth`, il descend la chaîne sur plusieurs crans : utile pour construire une vue d'ensemble sur une hiérarchie de sujets rattachés sans naviguer projet par projet.

get_linked_project({ cellId: "holding-groupe", depth: 3, includeBlockTitles: true })
Descendre trois crans de rattachement

La lecture RE-RÉSOUT l'accès à chaque cran. Un droit sur le projet racine n'ouvre pas automatiquement ce qu'il rattache plus bas : chaque projet de la chaîne exige sa propre autorisation, honorée exactement comme si on l'ouvrait directement.

Ce que la cascade de partage ouvre — et à qui

Partager le projet racine avec un collaborateur ouvre-t-il aussi les projets rattachés plus bas ? Oui, mais à UNE condition précise : le lien doit avoir été posé par un GOUVERNANT (propriétaire ou gestionnaire) du projet hôte. Un simple éditeur peut poser un rattachement — il reste alors utilisable par lui seul, jamais ouvert en cascade aux autres collaborateurs de l'hôte.

Qui pose le lienCe que les autres collaborateurs de l'hôte obtiennent
Propriétaire ou gestionnairecascade ouverte — accès automatique au projet rattaché
Simple éditeuraucune cascade — le lien reste personnel à qui l'a posé

L'édition EN LIGNE d'une scène rattachée (déplacer une carte, ouvrir son panneau, modifier son contenu) suit une règle séparée : elle s'ouvre dès que tu as un vrai droit d'écriture sur la CIBLE — rôle qui écrit, accès non borné à un seul bloc, aucun verrou d'écriture posé, lien non figé sur une ancienne version. Sinon, c'est lecture seule, et modifier exige d'ouvrir ce projet directement.

Quand la lecture seule ne suffit plus : forker

Un projet rattaché reste parfois en lecture seule malgré tout — un accès borné à un seul bloc partagé, une version figée (pin), ou un rôle qui n'écrit pas sur la cible. `fork_linked_project` en fabrique une copie INDÉPENDANTE dont tu deviens propriétaire, et repointe le bloc hôte vers cette copie.

fork_linked_project({ cellId: "filiale-tech", name: "Architecture AWS — copie éditable" })
Débloquer l'édition en forkant

Try it on your own case

Describe your situation in one sentence — OrgGen builds the diagram and runs the numbers.

Try it on your own case