
# Değiştirilemez Sentetik Veri Sürümleme ve Blockchain Destekli Veri Sözleşmeleriyle Denetlenebilir Sürüm Ağacı

Sentetik veri, modern AI geliştirmesinin temel taşlarından biri haline gelmiştir; gizlilik‑korumalı model eğitimi, hızlı prototipleme ve önyargı azaltma gibi avantajlar sunar. Ancak sentetik veri boru hatları birden çok ekip, bulut bölgesi ve uç cihaz arasında karmaşıklaştıkça, organizasyonlar iki temel soruya yanıt vermekte zorlanır:

1. **Belirli bir modelin eğitildiği sentetik veri setinin hangi sürümü kullanıldı?**  
2. **Veri üretim sürecinin düzenleyici ve etik politikalara uygun olduğunu kanıtlayabilir miyiz?**

Geleneksel veri‑katalog çözümleri, kazara üzerine yazma, iç tehdit ve parçalanmış denetim izleri gibi risklere açık, değiştirilebilir meta veri depolarına dayanır. Bu makalede, **blockchain‑destekli veri sözleşmesi mimarisi** sunarak **değiştirilemez sürümleme**, **kriptografik olarak doğrulanabilir sürüm ağacı** ve **otomatik uyumluluk raporlaması** sağlayan bir yaklaşımı anlatıyoruz. Yaklaşım üç temel üzerine inşa edilmiştir:

* **Değiştirilemez Defter** – İzinli bir blockchain, her veri‑sözleşmesi işlemini kaydederek müdahale kanıtlanabilirliğini garanti eder.  
* **Akıllı‑Sözleşme‑Tabanlı Veri Sözleşmeleri** – Kendini yürüten sözleşmeler, üretim parametrelerini, onay makbuzlarını ve politika kısıtlamalarını kodlar.  
* **Otomatik Sürüm Ağacı Çıkarma** – Olay‑tabanlı ajanlar, sözleşme durumunu birleşik bir sürüm ağacı grafiğine dönüştürür ve bu grafik MLOps araçları tarafından sorgulanabilir.

Bu kılavuzun sonunda, uçtan uca akışı anlayacak, Hyperledger Fabric ve Formize kullanarak somut bir uygulamayı görecek ve çözümü CI/CD boru hatlarıyla sürekli uyumluluk için nasıl entegre edeceğinizi öğreneceksiniz.

---

## 1. Değiştirilemez Sürümlemenin Sentetik Veri İçin Neden Önemli Olduğu

Sentetik veri boru hatları tipik olarak aşağıdaki aşamaları içerir:

1. **Kaynak Veri Alımı** – Gerçek dünya verileri, onay ve gizlilik politikaları çerçevesinde toplanır.  
2. **Gizlilik Dönüşümü** – Diferansiyel gizlilik, GAN’lar veya difüzyon modelleri sentetik kayıtlar üretir.  
3. **Kalite Güvencesi** – İstatistiksel testler, önyargı tespiti ve fayda puanlamaları çıktıyı doğrular.  
4. **Dağıtım** – Veri setleri veri göllerinde saklanır, API’ler aracılığıyla paylaşılır veya doğrudan eğitim işlerine beslenir.

Her aşama birden çok **iterasyon** (ör. hiper‑parametre taramaları, model güncellemeleri) üretebilir. Değiştirilemez sürümleme olmadan:

* **Model tekrarlanabilirliği zarar görür** – Takımlar “Dataset v3.2” üzerinde eğitilmiş bir modeli güvenilir şekilde yeniden üretemez.  
* **Düzenleyici risk artar** – Denetçiler, bir veri setinin kullanım anında [GDPR](https://gdpr.eu/) veya [HIPAA](https://www.hhs.gov/hipaa/index.html) ile uyumlu olduğunu doğrulayamaz.  
* **Veri kökeni boşlukları** – Bir önyargı sorunu ortaya çıktığında, tam üretim parametrelerine geri dönmek zaman alıcıdır.

Değiştirilemez bir defter, geriye dönük olarak değiştirilemeyen **tek bir gerçek kaynak** sağlayarak bu sorunları çözer.

---

## 2. Temel Mimari Genel Bakış

Aşağıda önerilen mimarinin yüksek‑seviye diyagramı yer almaktadır. Diyagram Mermaid sözdizimiyle ifade edilmiştir; Hugo otomatik olarak render eder.

```mermaid
graph LR
    subgraph Edge
        A["Gerçek‑Dünya Veri Kaynağı"]
        B["Onay Yönetimi (Formize)"]
    end
    subgraph Core
        C["Sentetik Veri Motoru"]
        D["Veri Sözleşmesi Akıllı‑Sözleşmesi"]
        E["İzinli Blockchain"]
        F["Sürüm Ağacı Servisi"]
        G["CI/CD Boru Hattı"]
        H["Model Kayıt Defteri"]
    end
    subgraph Consumers
        I["Eğitim İşi"]
        J["Denetim Kontrol Paneli"]
    end

    A --> B
    B --> C
    C --> D
    D --> E
    E --> F
    F --> G
    G --> H
    H --> I
    F --> J
```

**Temel etkileşimler**

* **Onay Yönetimi (Formize)**, kullanıcı onayını toplar ve zincire kaydedilen imzalı bir makbuz üretir.  
* **Sentetik Veri Motoru** (ör. bir GAN veya difüzyon modeli), makbuzu okur, veri üretir ve üretim parametreleriyle **Veri Sözleşmesi**ni tetikler.  
* **Veri Sözleşmesi**, **İzinli Blockchain**e bir işlem yazar; bu işlem şunları içerir:  
  * Veri seti karması  
  * Üretim algoritması sürümü  
  * Hiper‑parametreler  
  * Onay makbuzu referansı  
  * Politika uyum bayrakları  
* **Sürüm Ağacı Servisi**, blockchain olaylarını dinler, veri seti sürümlerinin yönlendirilmiş asiklik grafiğini (DAG) oluşturur ve bir GraphQL API sunar.  
* **CI/CD Boru Hattı**, eğitim işini tetiklemeden önce ledger’dan en son veri seti karmasını çeker; böylece tekrarlanabilirlik sağlanır.  
* **Denetim Kontrol Paneli**, sürüm ağacı grafiğini görselleştirir ve dışa aktarılabilir uyumluluk raporları sunar.

---

## 3. Veri Sözleşmeleri Akıllı Sözleşme Olarak

**Veri Sözleşmesi**, sentetik veri üretim bağlamının tamamını kapsayan hafif bir akıllı sözleşmedir. Aşağıda, Hyperledger Fabric chaincode’u için derlenebilecek, Solidity‑benzeri sadeleştirilmiş bir pseudo‑kod örneği verilmiştir.

```solidity
contract SyntheticDataContract {
    struct GenerationRecord {
        string datasetHash;          // Üretilen veri setinin SHA‑256 karması
        string algorithmId;          // ör. "GAN_v2.1"
        string hyperParams;         // Hiper‑parametrelerin JSON dizgesi
        string consentTxId;          // Onay makbuzunun blockchain işlem kimliği
        uint256 timestamp;           // Unix epoch
        bytes32 policyDigest;        // Uygulanan uyumluluk politikasının karması
    }

    mapping(string => GenerationRecord) public records; // anahtar = datasetHash

    event DataGenerated(string indexed datasetHash, address indexed generator);

    function registerGeneration(
        string memory _datasetHash,
        string memory _algorithmId,
        string memory _hyperParams,
        string memory _consentTxId,
        bytes32 _policyDigest
    ) public {
        require(bytes(_datasetHash).length > 0, "Invalid hash");
        GenerationRecord memory rec = GenerationRecord({
            datasetHash: _datasetHash,
            algorithmId: _algorithmId,
            hyperParams: _hyperParams,
            consentTxId: _consentTxId,
            timestamp: block.timestamp,
            policyDigest: _policyDigest
        });
        records[_datasetHash] = rec;
        emit DataGenerated(_datasetHash, msg.sender);
    }

    function getRecord(string memory _datasetHash) public view returns (GenerationRecord memory) {
        return records[_datasetHash];
    }
}
```

**Bu tasarımın neden işe yaradığı**

* **Müdahale kanıtlanabilirliği** – `registerGeneration` çağrıldıktan sonra kayıt, defterde değiştirilemez.  
* **Kendini tanımlama** – Tüm ilgili meta veri tek bir işlemde saklanır; dış meta veri depolarına ihtiyaç kalmaz.  
* **Politika bağlantısı** – `policyDigest`, veri setini belirli bir uyumluluk politikası sürümüyle bağlar; böylece otomatik politika kayması tespiti mümkün olur.

---

## 4. Formize ile Onay ve Politika Yönetiminin Entegrasyonu

Formize, **dinamik onay toplama** ve **politika sürümleme** konusunda uzmanlaşmıştır. Entegrasyon akışı şöyledir:

1. **Onay Yakalama** – Kullanıcı, Formize web formunu doldurur; platform, makbuzu dağıtık bir kimlik (DID) ile imzalar ve blockchain’e yazar.  
2. **Politika Çekme** – Sentetik veri motoru, veri üretiminden önce Formize’dan aktif gizlilik politikasını (ör. GDPR‑Article‑6‑1‑a) ve politikanın karmasını alır.  
3. **Sözleşme Çağrısı** – Motor, onay işlem kimliğini ve politika karmasını Veri Sözleşmesine iletir.

Bu sıkı bağ, her sentetik veri setinin **tam olarak aynı onay ve politika** ile kriptografik olarak ilişkilendirilmesini sağlar.

---

## 5. Otomatik Sürüm Ağacı Çıkarma Servisi

**Sürüm Ağacı Servisi**, Fabric SDK aracılığıyla blockchain olaylarını dinleyen bir Go (veya Rust) mikroservistir. Görevleri şunlardır:

* **Olay Dinleyici** – `DataGenerated` olayları geldiğinde tam `GenerationRecord` kaydını alır.  
* **Graf Oluşturma** – Neo4j veya JanusGraph gibi bir graf veritabanına bir düğüm ekler; varsa önceki veri setine `DERIVED_FROM` kenarıyla bağlar.  
* **Sürüm Etiketleme** – Algoritma veya hiper‑parametrede değişiklik olduğunda semantik sürüm numaraları (`v1.0.0`, `v1.1.0`) atar.  
* **API Sunumu** – CI/CD, denetim UI gibi downstream araçlar için bir GraphQL uç noktası sağlar.

Bir veri setinin tam sürüm ağacını almak için örnek sorgu:

```graphql
query Lineage($hash: String!) {
  dataset(hash: $hash) {
    hash
    algorithmId
    generatedAt
    parent {
      hash
      algorithmId
    }
    children {
      hash
      algorithmId
    }
  }
}
```

---

## 6. Tekrarlanabilir Model Eğitimi İçin CI/CD Entegrasyonu

Değiştirilemez sürümlemeyi CI/CD’ye dahil etmek, **her model derlemesinin tekrarlanabilir olmasını** garantiler. Aşağıda tipik bir GitHub Actions iş akışı örneği verilmiştir:

```yaml
name: Train Model
on:
  push:
    branches: [ main ]

jobs:
  train:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Resolve dataset version
        id: dataset
        run: |
          HASH=$(curl -s https://lineage.api.company.com/dataset/latest | jq -r .hash)
          echo "DATASET_HASH=$HASH" >> $GITHUB_ENV

      - name: Pull dataset from storage
        run: |
          aws s3 cp s3://synthetic-data/${{ env.DATASET_HASH }} ./data.csv

      - name: Train model
        run: |
          python train.py --data data.csv --output model.pkl

      - name: Register model artifact
        run: |
          curl -X POST -H "Content-Type: application/json" \
            -d '{"modelHash":"'"$(sha256sum model.pkl | cut -d' ' -f1)"'","datasetHash":"${{ env.DATASET_HASH }}"}' \
            https://model-registry.api.company.com/register
```

Önemli noktalar:

* İş akışı, **Sürüm Ağacı Servisi**’nden en son veri seti karmasını sorgular; böylece kullanılan tam sürüm kaydedilir.  
* Eğitim sonrası model varlığı, veri seti karmasıyla birlikte kayıt altına alınır; bu da model ve veri arasında **çift yönlü bir bağ** oluşturur.

---

## 7. Denetlenebilir Uyumluluk Raporlaması

Düzenleyiciler, sentetik veri boru hatlarının gizlilik ve adillik kısıtlamalarına **gerçek zamanlı kanıt** sunulmasını giderek daha fazla talep etmektedir. Blockchain‑tabanlı mimari sayesinde, uyumluluk raporu üretmek sadece ledger’ı sorgulamak kadar basittir.

Aşağıdaki Python betiği, PDF formatında bir denetim raporu üretir:

```python
import json
from web3 import Web3
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas

w3 = Web3(Web3.HTTPProvider("https://fabric-node.company.com"))
contract = w3.eth.contract(address="0xABC123...", abi=contract_abi)

def fetch_record(dataset_hash):
    return contract.functions.getRecord(dataset_hash).call()

def generate_report(dataset_hash, filename):
    rec = fetch_record(dataset_hash)
    c = canvas.Canvas(filename, pagesize=letter)
    c.drawString(72, 720, f"Dataset Hash: {rec[0]}")
    c.drawString(72, 700, f"Algorithm ID: {rec[1]}")
    c.drawString(72, 680, f"Hyper‑Parameters: {rec[2]}")
    c.drawString(72, 660, f"Consent Tx ID: {rec[3]}")
    c.drawString(72, 640, f"Policy Digest: {rec[5].hex()}")
    c.save()

generate_report("0xdeadbeef...", "audit_report.pdf")
```

Oluşturulan PDF, denetçilerin halka açık ledger ile doğrulayabileceği **kriptografik referanslar** içerir; böylece uyumluluk kontrolleri için harcanan süre dramatik şekilde azalır.

---

## 8. Güvenlik ve Performans Hususları

| Alan                | Öneri                                                                 |
|---------------------|-----------------------------------------------------------------------|
| **İzinlendirme**    | Yazma erişimini yalnızca güvenilir hizmetlerle sınırlamak için **izinli bir blockchain** (Hyperledger Fabric veya Corda) kullanın. |
| **Veri Gizliliği**  | Zincirde yalnızca **karmalar** ve meta veriler saklansın; gerçek sentetik veri şifreli nesne depolama içinde kalmalı. |
| **Ölçeklenebilirlik** | Birden çok `registerGeneration` çağrısını tek bir blokta toplamak, işlem yükünü azaltır. |
| **Anahtar Yönetimi** | Onay makbuzları ve sözleşme çağrıları için donanım güvenlik modülleri (HSM) kullanın. |
| **Felaket Kurtarma** | Ledger’ı birden çok veri merkezine çoğaltın ve grafik veritabanının anlık görüntülerini yedekleyin. |

---

## 9. Gerçek Dünya Kullanım Örneği: Sağlık Araştırma Konsorsiyumu

Çok‑kurumlu bir sağlık konsorsiyumu, [HIPAA](https://www.hhs.gov/hipaa/index.html) ve [GDPR](https://gdpr.eu/) uyumlu sentetik hasta kayıtlarını paylaşmak zorundaydı. Blockchain‑destekli veri sözleşmesi modelini benimseyerek:

* **Sürüm izlenebilirliği**, yayınlanan bir modeli üç yıl sonra tam olarak yeniden üretmeyi sağladı.  
* **Onay bağlantısı**, bir hasta onayını geri çektiğinde otomatik iptal olayını tetikledi; Sürüm Ağacı Servisi bu değişikliği tüm alt veri setlerine yaydı.  
* **Düzenleyici denetim**, denetçinin sadece değiştirilemez ledger’ı indirip her veri setini doğrulaması sayesinde bir günden birkaç haftaya düştü.  

Konsorsiyum, **uyumluluk maliyetinde %40 azalma** ve **model geliştirme döngüsünde %30 hızlanma** rapor etti.

---

## 10. Başlangıç – Minimal Bir Prototip

1. **Yerel bir Fabric ağı** kurun (resmi Docker örneklerini kullanın).  
2. **`SyntheticDataContract` chaincode’unu** (Bölüm 3) dağıtın.  
3. **Formize’i** kurun ve onay makbuzlarını aynı Fabric kanalına yazacak şekilde bir form yapılandırın.  
4. **Basit bir Sürüm Ağacı Servisi** yazın (Go); `DataGenerated` olaylarını dinlesin ve düğümleri bellek içi bir haritada saklasın.  
5. **Sentetik veri üreticisini** (ör. önceden eğitilmiş bir CTGAN) çalıştırın; her çalıştırmadan sonra `registerGeneration` çağrısı yapsın.  
6. **Ledger’ı sorgulayın**; her veri seti sürümünün değiştirilemez olduğunu doğrulayın.

Bu kum havuzu, kalıcı bir graf veritabanı, rol‑bazlı erişim kontrolü ve mevcut MLOps platformları (Kubeflow, MLflow) ile entegrasyon eklenerek üretime ölçeklendirilebilir.

---

## 11. Gelecek Yönelimler

* **Sıfır‑Bilgi Kanıtları** – Veri setinin bir gizlilik bütçesini (privacy budget) ifşa etmeden karşıladığını kanıtlamak için zk‑SNARK’lar veri sözleşmesine gömülür.  
* **Çapraz‑Zincir İşbirliği** – Cosmos IBC veya Polkadot köprüleri, organizasyon sınırları arasında sentetik veri sürüm ağacının paylaşılmasını, egemenliğin korunmasını sağlayarak mümkün kılar.  
* **AI‑Destekli Politika Evrimi** – LLM’ler, sentetik veri kalitesi veya önyargı metriklerindeki kaymaları algılayarak otomatik politika güncellemeleri önerir.  

Değiştirilemez veri sözleşmesi çerçevesini sürekli genişleterek, kuruluşlar ortaya çıkan düzenlemelere ayak uydurabilir ve AI sistemlerinin sentetik veri üzerine kurulu güvenini koruyabilir.

---

## İlgili Bağlantılar

- [Hyperledger Fabric Dokümantasyonu](https://hyperledger-fabric.readthedocs.io) – İzinli blockchain’ler oluşturmak için resmi kılavuz.  
- [Formize Onay Yönetim Platformu](https://formize.com/consent) – Dağıtık kimlik ve dinamik onay konularını nasıl ele alır.  
- [Gizlilik‑Koruyan AI için Sıfır‑Bilgi Kanıtları](https://zokrates.github.io) – zk‑SNARK’ların ve uygulamalarının tanıtımı.