Müşteri Event'leri — customer.* PII

Ne zaman tetiklenir?

Abonelik

• Manifest: events: ["customer.created", "customer.updated", "customer.order_added", "customer.payment_added"] + events:subscribe.
• customers:read (PII) — dördü de bu scope'u ister; kurulumda açık consent ister. Yoksa aşağıdaki scope & consent kuralı uygulanır.

HTTP, imza & teslimat

POST {webhookUrl}
Content-Type: application/json
X-Restomenum-Signature: t=<unixSec>,v1=<HMAC_SHA256(webhookSecret, "<t>.<rawBody>")>
X-Restomenum-Event: customer.created | customer.updated | customer.order_added | customer.payment_added
X-Restomenum-Delivery: <deliveryId>   // teslim-bazlı (debug) — idempotency anahtarı DEĞİL

• İmzayı ham gövde üzerinden doğrula ("<t>.<rawBody>"), ±5 dk replay penceresi — bkz. imza şeması. Webhook endpoint'in HTTPS olmalı (private/loopback reddedilir — SSRF).
• Zarf: { id, type, version, tenantId, occurredAt, data }. version string "1"; occurredAt epoch milisaniye (imza t= ise saniye); tenantId = restoran ID'si.
• Idempotency: envelope id ile dedup (at-least-once → aynı id tekrar gelebilir; ikinci kez işleme, hızlı 2xx dön). X-Restomenum-Delivery teslim-bazlı debug header'ıdır — idempotency anahtarı olarak kullanma (her teslimde farklıdır → retry'ı asla yakalamaz).
• Ack: 2xx → işlendi. 5xx/timeout → retry → dead-letter.

Scope & consent (PII)

Müşteri PII'si yalnız iki koşul birden sağlanınca paylaşılır: PII scope (customers:read) VE tenant consent'i (dataConsent.piiShared === true, kesin boolean — 1/"true"/"yes" reddedilir).

Redaction iki katmandır: (1) customer objesi allowlist ile { id }'a indirgenir (region varsa korunur — non-PII; yeni alanlar consent yoksa otomatik düşer — güvenli); (2) diğer iç içe nesneler (örn. orders[], ödeme method) alan-adı bazlı recursive temizlenir (name/phone/address/email/tckn/vergino+ serbest-metin note/paymentNote/description/aciklama/desc silinir; orders[].id/lineTotalgibi yapısal alanlar korunur). Tam model: customers:read.

customer.created · updated — müşteri kaydı

data = { customerId, customer }. customerId opak referanstır (consent'ten bağımsız akar); customer ise customers/getile aynı allowlist şeklidir ve consent ile redact edilir. customer.updated tam güncel snapshot taşır — değişen-alan (diff) listesi içermez (bugün changedFields yok; ileride eklenebilir). Diff istiyorsan önceki state'i kendin cache'le.

{
  "id": "evt_<deterministik-firestore-trigger-id>",
  "type": "customer.created",
  "version": "1",
  "tenantId": "<tenantId>",
  "occurredAt": 1781000000000,
  "data": {
    "customerId": "cust_001",
    "customer": {
      "id": "cust_001",
      "name": "Ahmet Yılmaz",
      "phone": "5551234567",
      "address": "Atatürk Cad. No:5",
      "total": 0
    }
  }
}

customer.updated aynı şekildir, yalnız type + güncel total farklı. Consent yoksa customer → { id } (region varsa eklenir); scope yoksa data → {}.

customer.order_added — cari hesaba sipariş (veresiye)

✓ CanlıMüşterinin cari hesabına sipariş yazılınca (total += tutar, kalan = total − paid).

{
  "id": "cust_001_addorder_order_line_001order_line_002",
  "type": "customer.order_added",
  "version": "1",
  "tenantId": "<tenantId>",
  "occurredAt": 1781000000000,
  "data": {
    "customerId": "cust_001",
    "customer": {
      "id": "cust_001",
      "name": "Ahmet Yılmaz",
      "phone": "5551234567",
      "address": "Atatürk Cad. No:5",
      "total": 46.41
    },
    "orders": [
      { "id": "order_line_001", "title": "Espresso", "quantity": 1, "options": [], "extra": 0, "note": "", "lineTotal": 9.9 },
      { "id": "order_line_002", "title": "Cortado", "quantity": 1, "options": [], "extra": 0, "note": "", "lineTotal": 13.9 }
    ],
    "amount": 23.8,
    "balance": 36.41
  }
}

customer.payment_added — cari hesaptan tahsilat

✓ CanlıCari hesaptan ödeme/tahsilat yapılınca (paid += tutar). Tutar ≤ 0 ise event tetiklenmez.

{
  "id": "cust_001_addpayment_pay_77",
  "type": "customer.payment_added",
  "version": "1",
  "tenantId": "<tenantId>",
  "occurredAt": 1781000000000,
  "data": {
    "customerId": "cust_001",
    "customer": {
      "id": "cust_001",
      "name": "Ahmet Yılmaz",
      "phone": "5551234567",
      "address": "Atatürk Cad. No:5",
      "total": 46.41
    },
    "amount": 36.41,
    "method": { "id": "a2-cash", "title": "nakit" },
    "balance": 0,
    "orders": [],
    "note": ""
  }
}

Müşteri silme — customer.deleted YOK

GDPR/KVKK silme propagasyonu ayrıdır: tenant bir müşteriyi silince, PII consent'li kurulumlar zorunlu customer.redact lifecycle webhook'unu alır → o customerId'ye ait tüm PII'yi kendi tarafında silmelisin. Bu, abone olunan bir customer.* event'i değil, her bağlı kuruluma düşen bir lifecycle sinyalidir.