Projekt-Export & Import: Ihre Architektur, Vollständig Portabel
Wir glauben, dass Ihre Architekturdokumentation Ihnen gehört. Nicht in einem proprietären Format eingesperrt, nicht hinter einer API gefangen, nicht als Geisel eines Abonnement-Tiers gehalten. Wenn Sie Zeit investiert haben, Ihre Systeme, Container, Komponenten und Beziehungen zu dokumentieren, sollten Sie diese Arbeit mitnehmen können.
Heute machen wir diese Überzeugung konkret. Archyl unterstützt jetzt vollständigen Projekt-Export und -Import.
Alles in Einer Datei
Wenn Sie ein Projekt exportieren, erhalten Sie eine einzelne JSON-Datei mit Ihrem gesamten C4-Modell. Jedes System, das Sie definiert haben, jeder Container in diesen Systemen, jede Komponente, bis hinunter zu Code-Level-Elementen, wenn Sie auf dieser Tiefe modelliert haben. Die Beziehungen, die sie verbinden, mit ihren Beschreibungen und Technologie-Annotationen. Die visuellen Overlays, die Sie erstellt haben, um Ihre Diagramme zu gruppieren und zu organisieren.
Der Export bewahrt das räumliche Layout Ihrer Diagramme. Sie haben Zeit damit verbracht, Elemente zu positionieren, um Struktur klar zu kommunizieren—das API-Gateway links, Datenbanken rechts, externe Systeme oben. Diese Anordnung ist nicht zufällig; sie ist Teil dessen, wie Sie Ihre Architektur kommunizieren. Der Export erfasst alles davon.
Das Format ist einfaches JSON, versioniert und dokumentiert. Öffnen Sie es in einem beliebigen Texteditor und Sie können es lesen. Parsen Sie es mit einem Skript, wenn Sie etwas Benutzerdefiniertes tun möchten. Es sind Ihre Daten in einem Format, das Sie kontrollieren.
Wie Export Funktioniert
Öffnen Sie ein beliebiges Projekt, auf das Sie Zugriff haben, navigieren Sie zur Export-Option und wählen Sie Ihr Format. Für Datenportabilität wählen Sie JSON. Die Datei wird sofort heruntergeladen—selbst große Projekte mit Hunderten von Elementen exportieren in Sekunden.
Wir unterstützen auch visuelle Exporte für verschiedene Anwendungsfälle. SVG gibt Ihnen ein Vektorformat, das Sie in Illustrator bearbeiten oder in Dokumentation einbetten können. PNG bietet ein teilbares Bild. PDF erstellt ein professionelles Dokument. Es gibt sogar eine Option, alle vier C4-Ebenen in einem einzigen umfassenden Export zu kombinieren.
Für Automatisierung funktioniert der API-Endpoint genau wie erwartet. Eine GET-Anfrage an /projects/{id}/export gibt die vollständige JSON-Payload zurück. Bauen Sie es in Ihre CI-Pipeline ein, planen Sie wöchentliche Backups oder integrieren Sie es mit dem Workflow, den Sie bereits haben.
Import Erstellt Neue Projekte
Wenn Sie eine Architektur importieren, erstellt Archyl ein brandneues Projekt. Sie geben einen Namen und Slug an, wählen optional ein Team und laden Ihre JSON-Datei hoch. Das System parst den Export, validiert seine Struktur und erstellt jedes Element mit neuen Identifikatoren neu.
Das ist eine bewusste Designentscheidung. Import führt nicht mit bestehenden Projekten zusammen und versucht nicht, Konflikte abzugleichen. Es erstellt eine saubere Kopie, unabhängig von der Quelle. Das Originalprojekt bleibt unverändert; das importierte Projekt beginnt sein eigenes Leben.
Der Importprozess handhabt die Komplexität des ID-Remappings transparent. Ihr Export enthält die ursprünglichen UUIDs von als die Elemente erstellt wurden. Der Import generiert neue UUIDs für alles, während die Beziehungen zwischen Elementen erhalten bleiben. Ein Container, der zu einem bestimmten System gehörte, gehört immer noch zu diesem System. Eine Beziehung, die zwei Komponenten verband, verbindet sie immer noch. Die Struktur ist identisch; nur die Identifikatoren ändern sich.
Wenn eine Beziehung im Export ein Element referenziert, das nicht existiert—vielleicht von einem partiellen Export oder einer beschädigten Datei—protokolliert der Import eine Warnung und fährt fort. Sie erhalten alles, was importiert werden konnte, mit Sichtbarkeit darüber, was übersprungen wurde.
Echte Anwendungsfälle
Eine Beratungsfirma, mit der wir arbeiten, nutzt Export, um Architekturdokumentation an Kunden zu liefern. Sie modellieren das System des Kunden in Archyl, verfeinern es durch Discovery und manuelle Dokumentation, und exportieren dann das Endergebnis. Der Kunde erhält eine JSON-Datei, die er in seine eigene Archyl-Instanz importieren oder einfach als Aufzeichnung des Engagements archivieren kann.
Ein Enterprise-Plattform-Team exportiert seine Architektur wöchentlich in ein internes Backup-System. Wenn irgendetwas mit ihrer primären Dokumentation schief geht, können sie aus dem neuesten Export wiederherstellen. Das JSON-Format bedeutet, dass das Backup lesbar und verifizierbar ist, kein undurchsichtiger binärer Blob.
Ein Startup nutzte Export während einer Akquisition. Das übernehmende Unternehmen musste die Systemarchitektur des Ziels verstehen. Anstatt Wochen an Wissenstransfer-Meetings zu planen, exportierte das Team sein Archyl-Projekt und teilte die Datei. Die Erwerber importierten sie, erkundeten sie interaktiv und kamen zu den Integrationsgesprächen mit echtem Verständnis dessen, was sie kauften.
Entwicklungsteams nutzen Export als Architektur-Snapshots. Nach einem großen Release exportieren sie den aktuellen Stand und committen die JSON-Datei zusammen mit dem Code. Monate später, wenn jemand fragt "Wie sah die Architektur vor der Microservices-Migration aus?", ist die Antwort ein Git-Checkout entfernt.
Was Exportiert Wird
Der Export umfasst die komplette C4-Hierarchie. Systeme auf der obersten Ebene, mit Containern darin verschachtelt, Komponenten in Containern und Code-Elemente in Komponenten. Jedes Element trägt seine vollständigen Metadaten: Name, Beschreibung, Typ, Technologie-Stack, Tags, Positionskoordinaten und jegliches benutzerdefiniertes Styling.
Beziehungen werden mit beiden Endpunkten spezifiziert exportiert, zusammen mit ihrem Typ, Beschreibung und visuellen Eigenschaften wie Label-Positionen. Der Importprozess mappt diese auf die neu erstellten Elemente und behält die exakte Verbindungsstruktur bei.
Overlays—die visuellen Gruppierungen, die Sie erstellen, um komplexe Diagramme zu organisieren—sind mit ihren Positionen, Dimensionen, Farben und den enthaltenen Elementen enthalten.
Was derzeit nicht exportiert wird: ADRs, Projektdokumentation, User Flows und Repository-Verbindungen. Der Export konzentriert sich auf das C4-Modell selbst—die Systeme, Container, Komponenten, Code und ihre Beziehungen. Wir erwägen, den Umfang in zukünftigen Releases basierend auf dem, was Benutzer uns sagen, dass sie brauchen, zu erweitern.
Kein Lock-In, Keine Tricks
Das Exportformat verwendet heute Version "1.0". Wenn wir Funktionen hinzufügen, werden wir das Format aktualisieren, während wir Abwärtskompatibilität beibehalten. Ein Export, den Sie heute erstellen, wird in Jahren noch korrekt importiert, selbst wenn sich Archyl weiterentwickelt.
Wir sind nicht daran interessiert, Ihre Daten einzusperren. Wir sind daran interessiert, nützlich genug zu sein, dass Sie sich entscheiden zu bleiben. Export und Import sind unser Bekenntnis zu dieser Philosophie. Wenn Archyl aufhört, das richtige Tool für Sie zu sein, nehmen Sie Ihre Architektur und gehen Sie. Wenn ein Konkurrent etwas Besseres baut, haben wir den Wechsel einfach gemacht. Der Druck liegt bei uns, Ihr Vertrauen weiterhin zu verdienen.
Erste Schritte
Export und Import sind auf allen Plänen verfügbar, einschließlich Kostenlos. Es gibt keine künstlichen Einschränkungen, keine "Export ist eine Premium-Funktion"-Spielchen.
Zum Exportieren: Öffnen Sie ein beliebiges Projekt, finden Sie die Export-Schaltfläche, wählen Sie JSON und speichern Sie die Datei.
Zum Importieren: Klicken Sie in Ihrer Projektliste auf Importieren, laden Sie eine JSON-Datei hoch, geben Sie Ihrem neuen Projekt einen Namen und bestätigen Sie.
Ihre Architekturdokumentation gehört Ihnen. Jetzt können Sie sie überallhin mitnehmen.
Möchten Sie mehr darüber erfahren, was Sie in Archyl dokumentieren können? Lesen Sie unsere Einführung in das C4-Modell oder sehen Sie, wie KI-gestützte Architektur-Entdeckung automatisch Ihre bestehenden Systeme kartieren kann.