Persistance

İş akış örneklerinin saklanması için bir veri tabanı katmanı sunulur. Bu katmanda tüm akış örnekleri ve ilişkili verileri tutulur. Bu katman master data olarak anılır.

vNext Platform, Dual-Write Pattern (Çift Yazma Deseni) destekler. Bu destek ile:

• Event Sourcing yaklaşımı ile iş akış örneklerinde veri değişimleri bir akış olarak sunulabilir. (CDC - Change Data Capture)
• İş akış örneklerinin birer kopyaları başka bir veritabanında barındırılabilir. (Replication)

Master Data

İş akış örneklerini saklamak için Entity Framework tabanlı veritabanı kullanılır:

• Her bir akış için şema yaratılır.
• Her bir akış örneği farklı veri tablolarında saklanır.
• Her bir domain farklı veritabanı ile çalışır.
• Her bir runtime sadece bir domain çalıştırır.
• Domainler runtime'lara bölünemez.

Akış Şemaları

Her bir akış için bir şema oluşturulup içerisinde verileri saklamak için ön tanımlı bir tablo kümesi yaratılır.

Tablolar

Instance: Her bir iş akış örneğinin temel bilgilerini tutar.

InstanceData: İş akışının içerdiği veri kümesini tutar.

InstanceCorrelation: SubProcess/SubFlow tipinde başlatılmış iş akış örneklerinin referanslarıdır. SubProcess/SubFlow farklı bir domain üzerinde çalışıyor olabilir.

InstanceTransition: İş akış örneği ile ilgili tüm geçiş bilgilerini tutar.

InstanceTask: İş akış örneği ile ilgili tüm görev çalışma bilgilerini tutar.

InstanceAction: İş akış örneğinde çalıştırılan bir görev ile ilgili tüm alt adım çalışma bilgilerini tutar.

InstanceJobs: İş akış örneğinde çalıştırılan zamanlanmış görevler ile ilgili tüm bilgileri tutar.

Task

Task birden fazla konu için çalışabilir, bu yüzden ne amaçla tetiklendiğini bilmek için Type enum tipi bulunmaktadır. Task'ı tetikleyen tipin kayıt örneğinin tekil numarası için reference alanı kullanılır.

Operasyonel Tablolar — Inbox / Outbox Pattern

Dual-Write pattern'in mesaj kaybı ve duplicate işleme risklerini ortadan kaldırmak için Inbox/Outbox pattern uygulanır.

OutboxMessage

Yayınlanacak event'lerin transactional kaydı. State değişikliği ve outbox yazımı aynı transaction içinde olur — böylece state güncellendi ama event yayınlanamadı durumu oluşmaz.

Alan	Açıklama
Id	Event'in tekil tanımlayıcısı (idempotency key)
Type	Event tipi (örn. instance.transitioned)
Payload	CloudEvent gövdesi (JSON)
CorrelationId	Workflow instance / dış sistem korelasyonu
CreatedAt	Yazılma zamanı
PublishedAt	Yayınlanma zamanı (null = pending)
Attempts	Yayınlama denemesi sayısı

İşleyiş: BBT.Workflow.Workers.Outbox worker'ı bu tabloyu drain eder, Dapr Pub/Sub üzerinden yayınlar, başarılı olunca PublishedAt set edilir. At-least-once publish garantisi sağlanır.

InboxMessage

Gelen event'lerin idempotent kaydı. Aynı event ID birden fazla kez ulaşırsa (broker retry, network duplicate) yalnızca bir kez işlenir.

Alan	Açıklama
Id	Event'in tekil tanımlayıcısı (broker mesaj ID veya idempotency key)
Type	Event tipi
Payload	CloudEvent gövdesi (JSON)
ReceivedAt	Geliş zamanı
ProcessedAt	İşlenme zamanı (null = pending)
Status	pending / processed / failed

İşleyiş: BBT.Workflow.Workers.Inbox worker'ı pub/sub'tan event'i alır, InboxMessage'a yazar (PK ihlali ile dedupe), uygular ve ProcessedAt set eder. Exactly-once işleme garantisi sağlanır.

Background Workers

Worker	Sorumluluk
BBT.Workflow.Workers.Outbox	OutboxMessage drain → Dapr Pub/Sub publish
BBT.Workflow.Workers.Inbox	Dapr Pub/Sub consume → InboxMessage dedupe + apply

Detaylı topoloji ve operasyonel garantiler için: Runtime.