Yetki (Entitlement) Matrisi

Bu sayfa, bir işletmenin neye erişebildiğini belirleyen tek mekanizmayı özetler: yetki (entitlement) anahtarları ve bu anahtarları kimin verdiği.

Plan, tier ya da paket yoktur. Çekirdek ürün süresiz ücretsizdir; ücretli yetenekler katalogdan tek tek satın alınır ve her ürün, verdiği anahtarlar (grants) üzerinden yetki setine katılır.

Anahtar uzayı ve katlama (fold)

Yetki seti, birden çok kaynaktan gelen grant satırlarının tek bir kümeye katlanmasıyla oluşur. Katlama kuralı anahtarın önekine bağlıdır:

Grant kaynakları üç tanedir: free:baseline (ücretsiz çekirdek), addon:<kod>:<id> (satın alınan her ürün için bir kaynak) ve override:admin (süperadmin müdahalesi; limit.* / integration.* için { __replace: … } sarmalıyla değeri değiştirebilir).

Ücretsiz çekirdek (free:baseline)

Her tenant’a koşulsuz, süresiz ve lisans gerektirmeden projeksiyonlanır.

Ücretsiz çekirdeğin geri kalanı (menü yönetimi, masa ve kat planı, QR menü, sipariş yönetimi, kasa ve nakit, temel raporlar, ekip ve rol yönetimi, müşteriler, cihaz ve şube paneli) hiçbir yetki anahtarına bağlı değildir — ilgili rotalarda @RequireEntitlement yoktur. Yetki kapıları rota bazında opt-in’dir; dekoratörü olmayan rota kimseyi reddetmez.

Katalog ürünleri ve verdikleri grant’lar

Fiyatlar TRY ve KDV dahildir; katalogda kuruş (priceCents) olarak tutulur (490000 = ₺4.900,00). annual satırlar hesabın yıl dönümüne kadar gün bazında orantılanır (bkz. Lisans & Ödeme API).

Lisans

Modüller

Entegrasyonlar

Kapasite

maxQuantity: 100. Adet olarak alınır; projektör limit.* değerini satırın quantity’siyle çarpar, motor da bunu ücretsiz tabandaki 1 ile toplar.

Kontörler (tek seferlik, süresiz)

Kontör paketleri hiçbir yetki vermez (grants: {}); bakiye açar ve tükenene kadar geçerlidir. Bağımlılık, satın alma anında sahip olunan aktif bir ürünle ya da aynı sepetteki bir kardeş satırla karşılanabilir.

Hizmet

Lisans karartması (suppression)

requiresLicense: true olan her ürünün grant’ları, lisans canlı değilken verilmez. Projektör sahiplik satırını yine yazar (sahip olunanlar listesi eksilmez) ama grant dizisi boştur.

• Hiçbir iş verisi silinmez: stok, rezervasyon, personel, üretilmiş AI medyası ve chargedCents yerinde kalır. Lisans yeniden ödendiğinde bir sonraki projeksiyonda her şey aynen geri yanar.
• Sepet seviyesindeki LICENSE_REQUIRED kontrolü satışı durdurur; asıl erişim kapısı budur — bir işletme yıl dönümü faturasının bazı satırlarını ödeyip lisansı ödemezse fark burada ortaya çıkar.
• Ödeme süresi geçmiş (past_due) satırlar 7 gün boyunca grant vermeye devam eder (ADDON_GRACE_DAYS); süpürücü satırı expired’a çevirince hak düşer. active satırlar da aynı 7 günlük ufku alır, böylece yıl dönümü gecesi motorun 5 dakikalık taraması ile günlük süpürücü arasındaki saatlerde kimse kilitlenmez.

Yetkileri okuma

/v1/entitlements/me ve /v1/me/licensing tenant seviyesindedir ve X-Branch-Id beklemez.

Yetki reddi (403)

Kapılı bir rota, eksik yetkiyi ve onu açan ürünü taşıyan bir 403 döner:

{
  "statusCode": 403,
  "message": "Bu özellik hesabınızda etkin değil.",
  "error": "Entitlement Required",
  "errorCode": "ENTITLEMENT_REQUIRED",
  "timestamp": "2026-08-13T08:14:05.123Z",
  "path": "/api/reports/advanced",
  "requestId": "1786…-a1b2c3d4e",
  "actionable": {
    "requirement": { "type": "feature", "key": "feature.advancedReports" },
    "offer": {
      "code": "advanced_reports",
      "name": "Gelişmiş Rapor & Analitik",
      "kind": "module",
      "annualPriceCents": 129000,
      "proratedCents": 74123,
      "currency": "TRY",
      "periodEnd": "2027-03-10T00:00:00.000Z"
    },
    "licenseRequired": false,
    "reason": "not_owned"
  }
}

Remediation yükü, global hata filtresinin allowlist’inden geçerek actionable altında taşınır (yalnızca requirement, offer, licenseRequired, reason alanları):

• requirement.type: feature | limit | integration. limit reddinde ayrıca usage ve cap gelir.
• offer: anahtarı açan en ucuz ürün, bu tenant için bugün fiyatlanmış hâliyle. Gösterilen fiyat ile checkout’ta tahsil edilecek fiyat aynı katalog okumasından gelir.
• licenseRequired: true ise asıl engel ürünün kendisi değil, eksik lisanstır; teklif de lisansa döner.
• reason: not_owned (hiç alınmamış) veya lapsed (süresi dolmuş) — istemcinin “Satın al” ile “Yenile” arasında seçim yapmasını sağlar.

İlgili

• Lisans & Ödeme API — checkout rayı, orantılı fiyatlama, yıl dönümü ve yenileme.
• Marketplace API — katalog, satın alma ve iptal uçları.
• Hata Kodları — standart hata zarfı ve kararlı errorCode değerleri.