# Çözüm tarifleri

> Sadakio üzerine kurulan hazır ürün tarifleri: kafeler için otomatik QR üretici, akıllı müşteri kayıt sistemi, kendi markanızla sadakat uygulaması ve geri dönüş analitiği paneli.

Her tarif bir üründür: ne olduğunu, kutudan ne çıktığını, hangi uç noktaların kullanıldığını ve ajanınıza verilecek hazır promptu içerir. Kopyalayın, uyarlayın, yayınlayın.

<a id="qr-uretici"></a>
## Kafeleriniz için otomatik QR üretici ve QR menü sistemi

Ajanslar, POS bayileri ve servis sağlayıcılar için. Müşteri kafenize tek API çağrısıyla dijital sadakat açarsınız: kafe kaydı, misafir kayıt sayfası ve markalı QR kodu saniyeler içinde hazır. QR menü ve masadan sipariş altyapısı aynı işletmenin panelinde açılmaya hazır bekler.

**Kutudan çıkanlar**

- Tek çağrıyla gerçek, izole işletme: `POST /businesses`
- Misafir kayıt sayfası hazır: yanıttaki `join_url`
- Baskıya hazır markalı QR: `GET /businesses/{id}/qr.png`
- Kafe sahibine panel: menü, kampanyalar, Apple Wallet kartları bizden

**Akış**

```
POST /platform/v1/businesses            → kafe açıldı, join_url geldi
GET  /platform/v1/businesses/{id}/qr.png → QR PNG indir, bastır, kafeye gönder
GET  /platform/v1/businesses            → tüm müşteri kafeleriniz tek listede
```

**Ajan promptu**

```
Sadakio Platform API ile bir ajans aracı yaz. Kontrat:
https://api.sadakio.com/platform/v1/openapi.yaml
Form: kafe adı ve sektör. Gönderince businesses endpointiyle kafe aç,
join_url ve qr.png dosyasını göster, indirilebilir yap.
```

<a id="kayit-sistemi"></a>
## İşletme sadakati için akıllı kayıt ve müşteri takip sistemi

Hızlı misafir kaydı ve sayaç takibi, sizin arayüzünüzle. Resepsiyon ekranı, kasa tableti veya kendi uygulamanız: misafiri telefonuyla kaydedin, ziyaretini işleyin, sayaçlarını okuyun. Kimlik tekilleştirme bizde, aynı telefon iki kez kayıt olmaz.

**Kutudan çıkanlar**

- `POST /guests`: telefonla kayıt, mükerrer kayıt otomatik yakalanır (200 ile `created: false`)
- `POST /guests/{id}/adjust` ve `POST /guests/{id}/events`: ham sayaç veya yönetilen ziyaret olayı
- `GET /guests/{id}/counters`: misafirin tüm bakiyeleri tek nesnede
- `GET /businesses/{id}/guests`: sayfalı liste, telefonlar KVKK maskeli

**Ajan promptu**

```
Sadakio Platform API ile bir resepsiyon ekranı yaz. Kontrat:
https://api.sadakio.com/platform/v1/openapi.yaml
Telefon gir, misafiri kaydet veya bul, ziyaretini events ile işle,
sayaçlarını göster. Idempotency-Key kullan.
```

<a id="sadakat-uygulamasi"></a>
## Kendi markanızla sadakat uygulaması

Damga ve ödül mekaniği hazır motorda, marka ve deneyim sizde. Misafirleriniz sizin uygulamanızı görür, sayaçlar ve idempotent yazma bizden. Yanlışlıkla çift damga basmak altyapı gereği imkansızdır: aynı Idempotency-Key ile gelen istek ilk sonucu aynen tekrarlar.

**Kutudan çıkanlar**

- İzole kiracı: her anahtar yalnızca kendi işletmelerini görür, yabancı id her zaman 404
- İdempotent yazma ve günlük bütçe korumaları: bir döngü hatası sınırsız bakiye basamaz
- KVKK silme dahil: `DELETE /guests/{id}` misafiri anonimleştirir, sayaçları sıfırlar

**Ajan promptu**

```
Sadakio Platform API üstünde markalı bir sadakat web uygulaması yaz.
Kontrat: https://api.sadakio.com/platform/v1/openapi.yaml
Misafir girişi telefonla. Damga ekranı counters endpointinden beslenir,
ziyaret events ile işlenir. Tasarım bana ait, motor Sadakio.
```

<a id="analitik-panel"></a>
## Geri dönüş analitiği paneli

Kendi kafenizin verisi üstüne kendi paneliniz. Misafir listesi, ziyaret akışı ve geri dönüş özetleri İşletme API ile okunur, görselleştirme sizindir.

**Kutudan çıkanlar**

- `GET /guests` ve `GET /visits`: cursor sayfalama ve tarih filtreleriyle ham akış
- `GET /stats/retention`: 7, 30 ve 365 günlük kayan pencerelerde geri dönen misafir özeti
- `updated_since` ile artımlı senkron: her gece yalnızca değişeni çekin

**Ajan promptu**

```
Sadakio İşletme API ile bir analitik panel yaz. Kontrat:
https://api.sadakio.com/api/v1/openapi.yaml
Haftalık geri dönüş grafiği, en sadık 20 misafir ve uykuya dalan
misafir listesi. Veriyi updated_since ile artımlı çek.
```

---

Tarifiniz burada yok mu? [biz@sadakio.com](mailto:biz@sadakio.com) adresine ne kurduğunuzu yazın. Eksik uç nokta varsa yol haritasına birlikte bakarız.