C4 MODEL · DSL · DOKÜMAN · ADR
Mimarinin haritası, tek bir modelde.
C4 modelinde her elemanı bir kez tanımlayın. System Context, Container ve Component görünümleri, dokümanlar ve mimari kararlar aynı modelden beslensin. Bir servisin adını değiştirdiğinizde her diagram ve dokümana gömülü her görünüm kendiliğinden güncellenir.
- DSL ve görsel editör senkron
- SVG / PNG dışa aktarım
- Türkçe ve İngilizce
Diagram bir araçta, doküman başka birinde, kararlar bir klasörde. Hiçbiri birbirinden haberdar değil.
Bir servisin adı değiştiğinde onlarca diagramı elle güncellemek gerekir. Dokümanlardaki ekran görüntüleri eskir, kararların hangi bileşeni etkilediği kaybolur.
BUGÜN
- Her diagram bağımsız bir çizim; aynı kutu on farklı dosyada.
- Wiki'deki diagram görseli ilk değişiklikte eskiyor.
- ADR'ler hangi bileşeni etkilediğini söylemiyor.
ARQATLAS İLE
- Eleman bir kez tanımlanır; görünümler onu yalnızca gösterir.
- Dokümana gömülen diagram canlıdır; model değişince o da değişir.
- Her karar, etkilediği elemanın detay panelinde görünür.
NASIL ÇALIŞIR
Önce model, sonra görünümler.
Modeli kurun
Person, Software System, Container, Component, Data Store ve Queue elemanlarını ve aralarındaki ilişkileri görsel olarak ya da DSL ile tanımlayın.
Görünümleri türetin
System Context, Container ve Component görünümleri aynı elemanları farklı yakınlıkta gösterir. Bir kutuya çift tıklayarak bir alt seviyeye inin.
Anlatın ve kaydedin
Markdown dokümanlarına canlı görünümler gömün. Kararları ADR şablonuyla yazıp ilgili elemanlara bağlayın.
Mimarın günlük işi için.
Hesap oluşturC4 seviyeleri arasında gezinme
System Context'ten Container'a, oradan Component'e çift tıklayarak inin. Breadcrumb ile geri dönün.
DSL ve görsel editör senkron
Metinle yazın, tuvalde düzenleyin. İki taraf aynı modeli değiştirir.
Canlı gömülü diagramlar
Dokümandaki görünüm bir ekran görüntüsü değil, modelin kendisidir. Model değiştikçe o da güncellenir.
Elemanlara bağlı ADR'ler
Otomatik numaralanan kararlar; durumları Önerildi'den Yerini Aldı'ya kadar izlenir, eleman panelinde listelenir.
Otomatik yerleşim
Tek komutla düzenli bir yerleşim. Elle yerleştirdiğiniz elemanlar sabitlenir ve yerinde kalır.
Güvenli silme
Bir elemanı silmeden önce kullanıldığı görünümleri, dokümanları ve ADR'leri görün; onay vermeden hiçbir şey silinmez.
METİN İLE MODELLEME
Yazdığınız her satır tuvalde bir kutu.
Model metin olarak da düzenlenir; tuvaldeki değişiklik metne, metindeki değişiklik tuvale yansır. Hatalar satır ve sütunuyla işaretlenir, geçersiz metin modele uygulanmaz.
customer = person "Müşteri"orders = softwareSystem "Sipariş Platformu" { web = container "Web Uygulaması" orderService = container "Order Service" orderDb = container "Sipariş DB" { properties { "arqatlas.subtype" "datastore" } }}customer -> web "Sipariş verir"web -> orderService "Sipariş oluşturur"orderService -> orderDb "Okur / yazar"Sık sorulan sorular
C4 model nedir?
C4 model, bir yazılım mimarisini System Context, Container, Component ve Code olmak üzere dört seviyede anlatan, öğrenmesi kolay bir diyagramlama yaklaşımıdır (Simon Brown, c4model.com). ArqAtlas bu modelin System Context, Container ve Component seviyelerini uygular: bir mimari model bir kez kurulur, bu üç görünüm aynı modelden türetilir. Ayrıntılı anlatım için C4 model rehberimize bakabilirsiniz.
Structurizr DSL ile ilişkisi ne?
ArqAtlas'ın metin tabanlı modelleme dili, Structurizr DSL'in sözdizimsel bir alt kümesidir ve kendi ayrıştırıcımızla çalışır. Model, DSL ve görsel editör arasında çift yönlü senkron kalır: birinde yaptığınız değişiklik diğerine yansır, geçersiz metin modele uygulanmaz. Tam Structurizr içe aktarımı bu sürümde yer almıyor.
Diyagramları dışa aktarabilir miyim?
Evet. Görünümleri SVG ve PNG olarak, tarayıcınızda doğrudan dışa aktarabilirsiniz; ayrı bir sunucu render adımı yoktur. Projenizin tamamını da model, DSL karşılığı ve bir README içeren bir ZIP arşivi olarak dışa aktarabilir, istediğiniz an araçtan bağımsız bir kopyasını alabilirsiniz — bunun için ayrı bir onay adımı gerekmez.
Modelim nerede saklanıyor?
Modeliniz ArqAtlas'ın sunucularında, çalışma alanınıza özel olarak saklanır; aktarımda TLS kullanılır, çalışma alanları arasında veri izolasyonu sağlanır ve yetki kontrolleri her zaman sunucu tarafında yapılır, istemciye güvenilmez. Projenizi istediğiniz an ZIP olarak dışa aktarıp kendi ortamınızda ayrıca bir kopyasını tutabilirsiniz.
Türkçe ve İngilizce destekleniyor mu?
Evet. Hem uygulama arayüzü hem de bu tanıtım sitesi Türkçe ve İngilizce olarak sunulur; dil menüden istediğiniz an değiştirilebilir. Yeni sayfalar ve özellikler de iki dilde yayınlanmayı hedefler; bu sayfaların yapısının iki dilde eşit kaldığı build sırasında otomatik olarak denetlenir. Üçüncü bir dil bu sürümde planlanmıyor.
Ücretli bir plan var mı?
Şu an ArqAtlas'ın tüm özellikleri ücretsiz plandadır. Ücretli bir plan ileride eklenecek; bugün için fiyat ya da tarih vermiyoruz. Güncel plan ve özellik listesini fiyat sayfamızda bulabilirsiniz. Plan hazır olduğunda hem bu sayfa hem fiyat sayfası, kapsam ve koşullarla birlikte güncellenecek.
Sisteminizin haritasını bugün çıkarın.
Hesabınızı açın, ilk modelinizi kurun; görünümler, dokümanlar ve kararlar aynı yerde kalsın.