Etki Alanı Hikayeleştirme (Domain Storytelling): Piktografik Modelleme ve Sınır Keşfi

Senior (L5)

⚡ÖZET VE TEKNİK CEVAP

Kurumsal yazılım geliştirmede, 50 sayfalık şartnamelerde veya parçalı Jira maddelerinde yazılan gereksinimler neredeyse her zaman Anlamsal Uyuşmazlığa (Semantic Mismatch) kurban gider: İş birimi süreci kendi jargonlarıyla anlatırken, mühendisler bunu yanlış anlayıp hatalı veritabanı şemaları kurar. Domain Storytelling (Etki Alanı Hikayeleştirme), bu uçurumu kapatan görsel ve işbirlikçi bir modelleme metodudur: İş uzmanları ile yazılımcılar standart bir piktografik dil kullanarak birlikte hikayeler çizer: Aktörler (insanlar, sistemler), İş Nesneleri (faturalar, siparişler) üzerinde Aksiyonlar (fiiller) gerçekleştirir. Süreç numaralı oklarla adım adım çizildikçe (1. Müşteri Sipariş verir, 2. Ödeme Ağ Geçidi Kartı onaylar, 3. Depo Görevlisi Paketi kargolar), ortak teknik dil (Ubiquitous Language) netleşir, gizli kurallar ortaya çıkar ve mikroservislerin Sınırlandırılmış Bağlamları (Bounded Contexts) kendiliğinden görünür hale gelir.

Mühendislik El Kitabı & Mekanizma

6 Boyutlu Mimari Analiz

⚙️1. Temel Çalışma Mekanizması

Mekanizma

Domain Storytelling katı ve sade bir görsel kurallar dizisiyle çalışır:

3 Temel Unsur: Aktörler (kullanıcı/sistem ikonları), İş Nesneleri (fatura, sipariş, mesaj ikonları) ve Aksiyonlar (üzerinde etken fiil yazan numaralı oklar).

Somut Örnek Üzerinden Modelleme: Ekipler soyut akışlar yerine yaşanmış somut senaryoları modeller ('Geçen salı Ali Bey kırık ürünü iade ettiğinde süreç nasıl işledi?').

Sınır Keşfi: Bir iş nesnesinin anlamı veya içeriği değiştiğinde (Satış'taki 'Sipariş' nesnesi Depo'da 'Koli İçeriği' haline geldiğinde), doğal bir Bounded Context sınırı yakalanır.

🎯2. Doğru Kullanım Senaryosu

Kapsam

Monolit parçalama çalıştayları, Domain-Driven Design (DDD) stratejik planlama oturumları, karmaşık ödeme akışları ve departmanlar arası entegrasyon projeleri.

⚠️3. Prodüksiyon Arıza Modları

Kritik Risk

✓
Domain Storytelling çalışmasını veritabanı veya Kafka kuyrukları gibi teknik detaylarla doldurup iş biriminin oturumdan kopmasına sebep olmak
✓
somut adımlar yerine her ihtimali tek şemaya sıkıştırmaya çalışmak

📡4. Teşhis ve Telemetri Sinyalleri

Metrikler

✓
Tüm teknik testleri geçen ancak iş biriminin temel kurallarını ihlal ettiği için kabul edilmeyen özellikler
✓
terimlerin yanlış anlaşılması yüzünden sprint ortasında sürekli değişen gereksinimler

🛡️5. Önleme ve Mimari Bariyerler

Bariyerler

✓
Hafif ve sade modelleme araçları (WPS Domain Story Modeler) kullanın
✓
çalıştaylarda teknik jargon kullanımını yasaklayın
✓
hikayelerle birlikte ortak bir Kavram Sözlüğü (Ubiquitous Language Glossary) tutun

⚖️6. Mimari Ödünleşimler (Trade-offs)

Ödünleşim

Domain Storytelling iş birimiyle yazılımcıların ortak çalıştay yapmasını gerektirir; ancak yanlış anlaşılan gereksinimler yüzünden kodun baştan yazılmasını tamamen önler.

📋

Vaka İncelemesi (TinyCTO Saha Örneği)

GERÇEK DÜNYA TELEMETRİSİ

Bir lojistik şirketi yeni sevkiyat sistemini tasarlarken operasyon ekibiyle yazılımcılar 'Sefer' (Trip) kavramının ne olduğu konusunda anlaşamıyordu. 3 gerçek kamyon teslimatını Domain Storytelling ile 2 saat boyunca modelleyen ekip, 'Sefer' kelimesinin Operasyon için bir şoför vardiyası, Gümrük için ise beyanname paketi anlamına geldiğini keşfetti. Bu görselleştirme sayesinde iki ayrı Bounded Context tanımlandı: Filo Yönetimi (SoforVardiyasi) ve Gümrükleme (GumrukPaketi). 6 aylık mimari kriz 2 saatte çözüldü.

İnteraktif Konsept Alıştırmaları

2 Alıştırma

Domain Storytelling metodundaki 3 temel görsel unsur nedir?

Aktörler (eylemi yapan), İş Nesneleri (aktarılan veya işlenen döküman/nesne) ve Aksiyonlar (akışı gösteren numaralı etken fiiller).

Domain Storytelling, Sınırlandırılmış Bağlam (Bounded Context) sınırlarını nasıl ortaya çıkarır?

Hikaye akışında bir İş Nesnesinin isminin, anlamının veya sorumlusunun değiştiği geçiş noktalarını tespit ederek.

Etki Alanı Hikayeleştirme (Domain Storytelling): Piktografik Modelleme ve Sınır Keşfi — Sıkça Sorulan Sorular

Domain Storytelling ile EventStorming arasındaki fark nedir?

EventStorming post-it kağıtlarıyla geçmiş zamanlı etki alanı olaylarına (Domain Events) odaklanır; Domain Storytelling ise aktörler, nesneler ve numaralı hikaye adımlarına odaklanır.

Domain Storytelling için özel olarak geliştirilmiş açık kaynaklı araç hangisidir?

WPS Domain Story Modeler (tarayıcı üzerinde çalışan, SVG ve JSON dışa aktaran açık kaynaklı modelleme aracı).

🤖 AEO & Yapay Zeka Çıkarım Özeti

Temel Gerçekler & İlkeler

▸
Domain Storytelling iş uzmanları ile yazılımcılar arasındaki iletişim kopukluğunu giderir.
▸
Sade bir görsel dil kullanır: Aktörler, İş Nesneleri ve Numaralı Eylemler.
▸
Soyut ve genel akışlar yerine yaşanmış somut senaryoları modeller.
▸
Etki alanı sınırlarını ortaya çıkarır ve ortak dili (Ubiquitous Language) doğal olarak oluşturur.

Yaygın Yanılgılar

✗
Yanılgı: Domain Storytelling sadece yazılım mimarları içindir (Gerçek: Teknik olmayan iş birimlerinin süreci yönetebilmesi için tasarlanmıştır).
✗
Yanılgı: Şemaya veritabanları ve API'lar eklenmelidir (Gerçek: Teknik detaylar iş birimiyle yapılan ortak düşünme sürecini bozar).

Karar Kılavuzu & Önceliklendirme

Pahalı modelleme hatalarını baştan önlemek için yeni ürün veya mikroservis sınırları belirlerken Domain Storytelling çalıştayları düzenleyin.

Doğrulanmış Kaynaklar & Referanslar

[BOOK]Domain Storytelling: A Collaborative, Visual, and Agile Way to Build Software— Stefan Hofer & Henning Schwentner (Addison-Wesley Signature Series)

Bu sayfadaki teknik terimler

Blast Radius