KolayMiles
Kolay ekosisteminin mil defteri

Tek bakiye,
her Kolay uygulamasında.

Marinada yakıt alın, markette sipariş verin, charter rezervasyonu yapın — mil aynı cüzdanda birikir. Arkasında, finansal sistemlerin kurallarıyla yazılmış bir defter var.

Ürününüzü bağlayın Defter nasıl çalışır

Defter, olay girişi ve üye cüzdanı çalışıyor. Ödül kataloğu yolda — güncel duruma bakın.

Mil defteri Bakiye türetilir
Sıra Hareket Kaynak Tutar Bakiye
1041 Kazanım order:9f3a2b + 240 240
1042 Kazanım fuel:7c0fcc + 60 300
1043 Harcama reward:kahve − 150 150
1044 Geri alma refund:9f3a2b − 40 110
1045 Kazanım bill:2a91de + 95 205
Güncel bakiye 205 mil
Değişmezler

Sözle değil, şemayla garanti.

Aşağıdakiler pazarlama vaadi değil, veritabanı kısıtları. Her biri testle sabitlenmiş ve bozulduğunda derleme kırılır.

Append-only

Defter tabloları yalnızca INSERT ve SELECT kabul eder. UPDATE, DELETE ve TRUNCATE uygulama rolünden geri alınmıştır; CI bu geri almanın hâlâ geçerli olduğunu kanıtlar.

Bakiye türetilir

Hiçbir yerde değiştirilebilir bakiye kolonu yoktur. Bakiye her zaman hareketlerin toplamıdır — yani hiçbir zaman kendi geçmişiyle çelişemez.

İdempotent

Aynı iş anahtarıyla gelen tekrar, ilk kaydı geri döndürür. Garanti şema kısıtlarındadır, çağıranın nezaketinde değil — ağ hatası iki kez ödüllendirmez.

İadeye dayanıklı

İptal ve iade, kaydı silmez: telafi kaydı yazar. Kısmi iade oransal geri alır, bakiyeyi hiçbir koşulda eksiye düşürmez.

Nasıl çalışır

Olgudan bakiyeye, dört adım.

  1. 01

    Olay gelir

    Ürün, gerçekleşmiş bir olguyu bildirir: sipariş tamamlandı, yakıt alındı, adisyon ödendi. KolayMiles ticaretin sahibi değildir; olguyu olduğu gibi alır.

  2. 02

    Kural işler

    Programın kazanım kuralı uygulanır. Kural veridir, kod değil — kampanya değişikliği bir satır düzenlemesidir, deploy değil.

  3. 03

    Kayıt yazılır

    Olay kaydı, mil kaydı ve bildirim tek bir işlemde birlikte commit olur. Kaydı olmayan mil açıklanamaz; mili olmayan kayıt sessizce kaybolmuş bir ödüldür.

  4. 04

    Bakiye okunur

    Bakiye saklanmaz, hesaplanır. Cüzdan ekranı, ödül bozdurma ve raporlama aynı kaynağı okur — iki farklı doğru olamaz.

Fark

“Puan” yazan bir kolon değil.

Çoğu sadakat kurulumu, kullanıcı tablosuna bir puan kolonu ekler ve onu artırıp azaltır. O kolon bir gün gerçeği kaybeder: iki eşzamanlı yazma, yarıda kalan bir iade, elle yapılmış bir düzeltme. Sonra kimse bakiyenin neden o sayı olduğunu açıklayamaz.

KolayMiles bakiyeyi hiç saklamaz. Her mil bir kaydın sonucudur ve her kayıt hangi olgudan, hangi kuralla doğduğunu taşır. Bakiye bir iddia değil, bir toplamdır.

Ayrıntılı karşılaştırma

Sıradan puan kolonuKolayMiles
Bakiye saklanır, güncellenirBakiye türetilir
İade = bakiyeyi düşürİade = telafi kaydı
Tekrar = ikinci ödülTekrar = aynı kayıt
Düzeltme iz bırakmazHer düzeltme gerekçeli
“Neden bu sayı?” — bilinmezKayda kadar geri sarılır
İş ortakları

Bağlanmak bir uç, bir anahtar.

Ürününüz gerçekleşmiş bir olguyu bildirir; kazanım kuralını ve defteri KolayMiles taşır. Anahtar hangi olay tiplerini gönderebileceğinizle sınırlıdır ve kiracı bilgisi gövdeden değil, anahtardan okunur.

Entegrasyon rehberi

POST /v1/events
{
  "event_id":       "pur_9f3a2b7c",
  "type":           "fuel.purchased",
  "schema_version": 1,
  "tenant_id":      "t_talyasmart",
  "program_id":     "kolaymiles",
  "source_app":     "kolaymarin",
  "occurred_at":    "2026-08-10T09:14:22Z",
  "payload": {
    "purchase_id":  "pur_9f3a2b7c",
    "customer_ref": "…",
    "total_kurus":  125000,
    "currency":     "TRY"
  }
}

event_id sizin iş anahtarınızdır ve değişmez. Yeniden denerken aynı değeri gönderin — ikinci kez ödüllendirmez.

Ekosistem

Mil, ürünler arasında taşınır.

Her ürün kendi alanının sahibi kalır; KolayMiles yalnızca sadakat katmanıdır. Kullanıcı için sonuç tek: nerede kazanırsa kazansın, aynı cüzdan.

KolayMarin

Marina, yat, charter

KolayDenizMarket

Sipariş ve teslimat

KolayVoyage

Rezervasyon

KolaySigorta

Poliçe

KolayAcademy

Eğitim

KolayService

Tekne servisi

Sık sorulanlar

Kapsam ve sınırlar.

KolayMiles bir e-ticaret ya da CRM ürünü mü?

Hayır. Sipariş, ürün, stok, rezervasyon, poliçe ve fatura başka ürünlerin sahibidir. KolayMiles yalnızca sadakat, ödül, referans ve kampanya alanının sahibidir; diğerlerine olay olarak bağlanır.

Kimlik doğrulamayı KolayMiles mi yapıyor?

Hayır. KolayMiles bir kimlik sağlayıcı değildir. Üyeyi yalnızca opak bir referansla tanır; e-posta, telefon ve ad gibi kişisel veri platforma hiç gelmez.

Bir ürün nasıl entegre olur?

Entegrasyon veridir, kod değil. Ürün bir program, bir marka ve gönderebileceği olay tipleriyle sınırlı bir API anahtarı alır; ardından tek bir uca olay göndermeye başlar.

Aynı olayı iki kez gönderirsem ne olur?

Hiçbir şey. Tekrar, ilk kaydın kimliğiyle geri döner ve ikinci kez ödüllendirmez. Aynı anahtarla farklı bir gövde gönderirseniz bu sessizce yutulmaz — çakışma olarak bildirilir, çünkü bu üretici tarafında bir hatadır.

Ürününüzü bağlayalım.

Bir program, bir anahtar, bir uç. Kod değişikliği tek taraflı.

Entegrasyon rehberi