Ücretsiz araç
Structurizr DSL’den C4 model diyagramına
Bir Structurizr DSL workspace’ini ya da workspace JSON dışa aktarımını yapıştırın; C4 modelinin görünümlerini düzenleyebileceğiniz diyagramlar olarak görün: kişiler, yazılım sistemleri, container’lar, component’ler ve deployment node’ları, ilişkiler açıklamalarıyla etiketli. Bir görünüm seçin ya da hepsini ayrı diyagramlar olarak açın.
Örnek çıktı
Nasıl çalışır
Workspace’inizi yapıştırın ya da bırakın
Bir workspace.dsl dosyası, Structurizr playground’dan kopyalanan DSL ya da Structurizr’ın dışa aktardığı JSON. model ve views blokları okunur; styles metinde kalabilir.
Her C4 görünümünü görün
Workspace’teki her görünüm, sistem manzarasından component ve deployment görünümlerine kadar listelenir. Birini seçtiğinizde önizleme onu C4 kartları, sınırlar ve etiketli oklarla yeniden çizer.
Archboard’da açın
Görünümü yeni bir diyagram olarak kaydedin; yeniden düzenleyin, not ekleyin, bağlantı paylaşın ya da SVG ve PNG olarak dışa aktarın. Kaydolmak için bir Google ya da GitHub hesabı yeterli.
Bir Structurizr workspace’inden neler çizilir
Seçili görünüm modelin şu parçalarından kurulur:
personKişiler, açıklamalarıyla C4 kişi kartı olarak. External tag’i taşıyan ya da JSON dışa aktarımında location External olan kişi dış kişi olur.
softwareSystemYazılım sistemleri, açıklamalarıyla C4 sistem kartı olarak. External tag’li sistemler yalnız adı gösteren dış sistem kartına dönüşür.
containerContainer’lar, teknolojisi ve açıklamasıyla kart olarak. Database tag’li container, yalnız adı gösteren veritabanı kartı olur. Queue tag’li container, External tag’li container ve component’ler ve enterprise bloğu kendi C4 tipleriyle çizilir: queue container, external container ve component kartları, enterprise sınırı.
componentComponent’ler, teknolojileriyle, ait oldukları container’ın içinde kart olarak.
->İlişkiler, açıklamasıyla etiketlenmiş ok olarak; teknoloji köşeli parantez içinde ardından gelir. Görünüm yalnız ebeveynleri gösteriyorsa çocukları arasındaki ilişki ebeveynler arasında bir kez çizilir.
container bankingcomponent banking.apiContainer ve component görünümünün kapsamı çerçeve olur: container görünümünde yazılım sistemi, component görünümünde container.
groupGruplar, içerdikleri kişi, sistem ya da container’ların çevresinde çerçeve olarak. Boş grup çizilmez.
deploymentNodeinfrastructureNodecontainerInstanceDeployment görünümleri: iç içe deployment node’ları çerçeve, container ve yazılım sistemi örnekleri temsil ettikleri kart, altyapı node’ları deployment node kartı olarak.
systemLandscapesystemContextdeploymentSistem manzarası, sistem bağlamı, container, component ve deployment görünümleri; her biri ayrı bir diyagram. Görünümü olmayan workspace’e bir manzara, her sistem için bir bağlam görünümü ve container’ı olan her sistem için bir container görünümü üretilir.
autoLayout lrinclude *Her görünüm türündeki anlamıyla include *, tanımlayıcı listeli include ve exclude, ve autoLayout yönü; yön verilmemişse yukarıdan aşağıya.
Bir workspace, birçok görünüm
Bir workspace genellikle aynı modelin birden çok görünümünü taşır. Dosyadaki ilk görünüm önce çizilir; önizlemenin üstündeki görünüm seçici aynı metnin başka bir görünümüne geçer. Her görünümü saklamak için Tüm görünümleri aç, çalışma alanınızda her görünüme bir diyagram oluşturur; seçili görünüm ilk sırada. Free planda diyagram sınırınıza sığmayan görünümler sessizce düşmez: araç kaçının açıldığını ve kaçının kaldığını söyler.
Structurizr içe aktarmasında olmayanlar
- Workspace’in gösterdiği dosya ve betikler: !include, !docs, !adrs, !script, !plugin ve workspace extends izlenmez, çalıştırılmaz. Bir uyarıda sayılırlar; yapıştırılan metinde yazılı her şey yine çizilir.
- Öğe ve ilişki stilleri, temalar ve marka ayarları. Şekil, renk ve simgeler C4 kartlarından gelir; diyagram Archboard’da açıldıktan sonra stilleri değiştirebilirsiniz.
- Dynamic, filtered, custom ve image görünümleri ile ifade olarak yazılmış include ya da exclude kuralları. Bunlar atlanıp sayılır; diğer görünümler yine listelenir.
- JSON dışa aktarımında kayıtlı öğe konumları. Structurizr ölçüleri C4 kartlarına uymadığı için her görünüm yeniden otomatik yerleştirilir.
- Belge bölümleri, karar kayıtları, properties, perspectives ve URL’ler. Yalnız model ve görünümleri okunur.
Structurizr ile ilgili sorular
Structurizr DSL’den hangi C4 düzeylerini çizebilirim?
Bir Structurizr workspace’inin modellediği her düzeyi: 1. düzey için sistem bağlamı ve sistem manzarası, 2. düzey için container, 3. düzey için component görünümleri, ayrıca deployment görünümleri. Kod düzeyi diyagramlar bir Structurizr workspace’inin parçası değildir, onlar için çizilecek bir şey yoktur.
DSL yerine workspace JSON dışa aktarımını yapıştırabilir miyim?
Evet. Structurizr’ın kaydettiği ya da dışa aktardığı JSON aynı şekilde okunur: her görünümde listelenen öğe ve ilişkiler çizilir; kişiler, sistemler, container’lar ve deployment node’ları dahil. Kayıtlı konumlar yok sayılır, her görünüm yeni bir otomatik yerleşim alır.
Bütün görünümleri tek seferde açabilir miyim?
Evet. Workspace’te iki ya da daha fazla görünüm varsa Tüm görünümleri aç, seçtiğiniz görünümden başlayarak her biri için ayrı bir diyagram oluşturur. Planınızın diyagram sınırı işlemi erken durdurursa açılan görünümler kalır, kalanlar sayılır; hiçbir şey haber verilmeden kaybolmaz.
Workspace’im !include kullanıyor. Ne yapmalıyım?
Dahil edilen dosyaları !include satırlarının yerine aynı metin kutusuna yapıştırın. Araç yalnız verdiğiniz metni okuduğu için yönerge izlenmez, bir uyarıda sayılır.
Diyagramı Archboard’da açınca ne kaydedilir?
Önizleme kaydedilmez. Archboard’da aç’ı seçtiğinizde gördüğünüz görünüm, C4 kartları, sınırları, çerçeveleri ve etiketli oklarıyla çalışma alanınızda yeni bir diyagram olarak kaydedilir. DSL ya da JSON’da sonradan yaptığınız değişiklikler onu güncellemez.
Structurizr’dan diyagram aracı ücretsiz mi?
Evet. Workspace yapıştırmak ve diyagramlarını görmek hesap gerektirmez. Bir görünümü ya da hepsini Archboard’da açmak için ücretsiz bir hesap gerekir.
Bir dakikada canvas açın
Google veya GitHub ile giriş yapın. Tek koltuk ücretsiz; ekip katılınca planı yükseltin.