Export & Import de Projet : Votre Architecture, Entièrement Portable
Nous croyons que votre documentation d'architecture vous appartient. Pas verrouillée dans un format propriétaire, pas piégée derrière une API, pas prise en otage par un niveau d'abonnement. Si vous avez investi du temps à documenter vos systèmes, conteneurs, composants et relations, vous devriez pouvoir emporter ce travail avec vous.
Aujourd'hui, nous rendons cette conviction concrète. Archyl supporte maintenant l'export et l'import complet de projets.
Tout dans un Seul Fichier
Quand vous exportez un projet, vous obtenez un seul fichier JSON contenant tout votre modèle C4. Chaque système que vous avez défini, chaque conteneur dans ces systèmes, chaque composant, jusqu'aux éléments de niveau code si vous avez modélisé à cette profondeur. Les relations qui les connectent, avec leurs descriptions et annotations de technologie. Les overlays visuels que vous avez créés pour grouper et organiser vos diagrammes.
L'export préserve la disposition spatiale de vos diagrammes. Vous avez passé du temps à positionner les éléments pour communiquer la structure clairement—l'API gateway à gauche, les bases de données à droite, les systèmes externes en haut. Cette disposition n'est pas aléatoire ; c'est une partie de la façon dont vous communiquez votre architecture. L'export capture tout cela.
Le format est du JSON simple, versionné et documenté. Ouvrez-le dans n'importe quel éditeur de texte et vous pouvez le lire. Parsez-le avec un script si vous voulez faire quelque chose de personnalisé. Ce sont vos données dans un format que vous contrôlez.
Comment Fonctionne l'Export
Ouvrez n'importe quel projet auquel vous avez accès, naviguez vers l'option d'export, et choisissez votre format. Pour la portabilité des données, sélectionnez JSON. Le fichier se télécharge immédiatement—même les grands projets avec des centaines d'éléments s'exportent en quelques secondes.
Nous supportons aussi les exports visuels pour différents cas d'usage. SVG vous donne un format vectoriel que vous pouvez éditer dans Illustrator ou intégrer dans de la documentation. PNG fournit une image partageable. PDF crée un document professionnel. Il y a même une option pour combiner les quatre niveaux C4 en un seul export complet.
Pour l'automatisation, l'endpoint API fonctionne exactement comme vous l'attendriez. Une requête GET à /projects/{id}/export retourne le payload JSON complet. Intégrez-le dans votre pipeline CI, planifiez des sauvegardes hebdomadaires, ou intégrez avec le workflow que vous avez déjà.
L'Import Crée des Projets Neufs
Quand vous importez une architecture, Archyl crée un tout nouveau projet. Vous fournissez un nom et un slug, sélectionnez optionnellement une équipe, et uploadez votre fichier JSON. Le système parse l'export, valide sa structure, et recrée chaque élément avec des identifiants frais.
C'est un choix de conception délibéré. L'import ne fusionne pas dans des projets existants et ne tente pas de réconcilier les conflits. Il crée une copie propre, indépendante de la source. Le projet original continue inchangé ; le projet importé commence sa propre vie.
Le processus d'import gère la complexité du remapping d'IDs de manière transparente. Votre export contient les UUIDs originaux de quand les éléments ont été créés. L'import génère de nouveaux UUIDs pour tout en préservant les relations entre les éléments. Un conteneur qui appartenait à un système spécifique appartient toujours à ce système. Une relation qui connectait deux composants les connecte toujours. La structure est identique ; seuls les identifiants changent.
Si une relation dans l'export référence un élément qui n'existe pas—peut-être d'un export partiel ou d'un fichier corrompu—l'import enregistre un avertissement et continue. Vous obtiendrez tout ce qui pouvait être importé, avec de la visibilité sur ce qui a été ignoré.
Cas d'Usage Réels
Un cabinet de conseil avec qui nous travaillons utilise l'export pour livrer de la documentation d'architecture aux clients. Ils modélisent le système du client dans Archyl, l'affinent à travers la découverte et la documentation manuelle, puis exportent le résultat final. Le client reçoit un fichier JSON qu'il peut importer dans sa propre instance Archyl ou simplement archiver comme trace de l'engagement.
Une équipe plateforme d'entreprise exporte son architecture chaque semaine vers un système de backup interne. Si quelque chose tourne mal avec leur documentation principale, ils peuvent restaurer depuis le dernier export. Le format JSON signifie que la sauvegarde est lisible et vérifiable, pas un blob binaire opaque.
Une startup a utilisé l'export pendant une acquisition. L'entreprise acquéreuse avait besoin de comprendre l'architecture système de la cible. Plutôt que de planifier des semaines de réunions de transfert de connaissances, l'équipe a exporté son projet Archyl et partagé le fichier. Les acquéreurs l'ont importé, l'ont exploré de manière interactive, et sont venus aux discussions d'intégration avec une vraie compréhension de ce qu'ils achetaient.
Les équipes de développement utilisent l'export comme snapshots d'architecture. Après une release majeure, ils exportent l'état actuel et commitent le fichier JSON aux côtés du code. Des mois plus tard, quand quelqu'un demande "à quoi ressemblait l'architecture avant la migration vers les microservices ?", la réponse est un git checkout.
Ce qui Est Exporté
L'export inclut la hiérarchie C4 complète. Les systèmes au niveau supérieur, avec les conteneurs imbriqués à l'intérieur, les composants dans les conteneurs, et les éléments de code dans les composants. Chaque élément porte ses métadonnées complètes : nom, description, type, stack technologique, tags, coordonnées de position, et tout style personnalisé.
Les relations sont exportées avec les deux endpoints spécifiés, ainsi que leur type, description et propriétés visuelles comme les positions des labels. Le processus d'import les mappe aux éléments nouvellement créés, maintenant la structure de connexion exacte.
Les overlays—les groupements visuels que vous créez pour organiser les diagrammes complexes—sont inclus avec leurs positions, dimensions, couleurs, et les éléments qu'ils contiennent.
Ce qui n'est pas actuellement exporté : les ADRs, la documentation de projet, les user flows, et les connexions aux repositories. L'export se concentre sur le modèle C4 lui-même—les systèmes, conteneurs, composants, code, et leurs relations. Nous envisageons d'étendre la portée dans les futures releases en fonction de ce que les utilisateurs nous disent avoir besoin.
Pas de Verrouillage, Pas de Pièges
Le format d'export utilise la version "1.0" aujourd'hui. Au fur et à mesure que nous ajoutons des fonctionnalités, nous mettrons à jour le format tout en maintenant la compatibilité ascendante. Un export que vous créez aujourd'hui s'importera correctement dans des années, même si Archyl évolue.
Nous ne sommes pas intéressés à piéger vos données. Nous sommes intéressés à être suffisamment utiles pour que vous choisissiez de rester. L'export et l'import sont notre engagement envers cette philosophie. Si Archyl cesse d'être le bon outil pour vous, emportez votre architecture et partez. Si un concurrent construit quelque chose de mieux, nous avons rendu le changement facile. La pression est sur nous pour continuer à mériter votre confiance.
Pour Commencer
L'export et l'import sont disponibles sur tous les plans, y compris le plan Gratuit. Il n'y a pas de restrictions artificielles, pas de jeux "l'export est une fonctionnalité premium".
Pour exporter : ouvrez n'importe quel projet, trouvez le bouton d'export, sélectionnez JSON, et enregistrez le fichier.
Pour importer : depuis votre liste de projets, cliquez sur Importer, uploadez un fichier JSON, donnez un nom à votre nouveau projet, et confirmez.
Votre documentation d'architecture est à vous. Maintenant vous pouvez l'emporter n'importe où.
Vous voulez en savoir plus sur ce que vous pouvez documenter dans Archyl ? Lisez notre Introduction au Modèle C4 ou voyez comment la Découverte Propulsée par l'IA peut automatiquement cartographier vos systèmes existants.