HORECAHORECA
  • Ana Sayfa
  • İşletmeler
  • Blog
  • Kariyer
  • Sayfalar

HORECA dokümantasyon (Lyra SSOT — tam belge)HORECA dokümantasyon (Lyra SSOT — tam belge)

Tek kaynak dosya: tüm kategoriler — ürün zekâsı, planlar, modüller, muhasebe, SSS.

Dokümantasyon

HORECA Dokümantasyon — Lyra SSOT (tek kaynak)

Sürüm: Kod + locale denetimi (2026). Alan: https://horeca.bykandil.com

Bu dosya tüm Türkçe docs içeriğinin tek birleşik kaynağıdır. Sol menüdeki her sayfa aynı dosyadan ilgili bölümü yükler.

İçindekiler (kategoriler)

KategoriBölümler
BaşlangıçGiriş
Lyra SSOTÜrün zekâsı, planlar, dürüstlük, URL haritaları
Hesap ve işletmeKayıt, workspace, genel bakış, ayarlar
Menü ve QRMenü, QR temalar, misafir URL
OperasyonAdisyon, rezervasyon, alan/masa
Stok ve finansStok, rapor, kur, muhasebe
EkipPersonel ve roller
Abonelik ve destekPlan, SSS, teknik notlar, sürüm notları

Kategori: Başlangıç

HORECA'ya giriş

HORECA; restoran, kafe, bar ve otel gibi işletmelerin dijital menü, QR menü, adisyon, kasa, stok, rezervasyon ve personel süreçlerini tek panelden yönetmesi için tasarlanmış bir işletme platformudur.

Bu dokümantasyonda neler var?

Sol menüden konulara göre ilerleyebilirsiniz. Her bölüm, ilgili ekranda sık yapılan işlemleri adım adım özetler.

Temel kavramlar

  • İşletme (workspace): Menünüz, masalarınız ve operasyonel verileriniz bu çatı altında toplanır. Birden fazla işletmeniz varsa her biri ayrı tanımlanabilir.
  • Panel: Yönetim ekranlarına giriş yaptıktan sonra gördüğünüz kontrol alanıdır; menü, sipariş, stok ve raporlar buradan yönetilir.
  • QR menü: Misafirlerin kendi telefonlarından menüyü görüntüleyip sipariş verebildiği deneyimdir; tema ve içerik işletme ayarlarınıza bağlıdır.

Önerilen okuma sırası

  1. HORECA ürün rehberi (Lyra SSOT) — işletme / misafir / partner, planlar, özellik matrisi, panel URL’leri
  2. Modül kısayolları (SSOT’a yönlendirir): Menü, QR, Adisyon
  3. Derin modül: Muhasebe
  4. Sık sorulan sorular (docs içi anlatım)

Destek

Uygulama içi akışlarla ilgili sorularınız için Destek ve Sık sorulan sorular sayfalarını kullanabilirsiniz.

Panel ve sitede ayrıca

İşletme operasyonu dışında, hesabınıza bağlı olarak şunlara da erişebilirsiniz:

  • Kariyer (/dashboard/career) — platform tarafındaki açık pozisyonlar ve başvuru akışı (genel Kariyer sitesiyle uyumludur).
  • Blog yazıları — herkese açık Blog içerikleri projede tutulur (/post/{slug}/); Search Console URL’leri sabittir.
  • İşletme profili (panel içi) (/dashboard/businesses/{kısaAd}) — “İşletmeleri keşfet” ekosistemindeki bir işletmenin herkese açık detay görünümüne panelden gitmek için kullanılır.
  • API dokümantasyonu (/api-dokumantasyon) — entegrasyon veya geliştirici ihtiyaçları için teknik referans (ayrıntılar için Teknik notlar).
  • Entegrasyonlar (/entegrasyonlar) — üçüncü taraf bağlantılar ve iş ortaklıkları hakkında genel bilgi (pazarlama sayfası).

Kategori: Lyra SSOT — Ürün, pazarlama, yardım, dürüstlük

HORECA Lyra SSOT — Ürün, Pazarlama, Yardım, Dürüstlük

Sürüm: Kod + locale + mevcut docs denetiminden türetilmiştir (2026).
Alan: https://horeca.bykandil.com · {slug} = işletme kısa adı (workspace slug).

Bu belge Lyra’nın HORECA hakkında anlamlandırması, pazarlaması ve yönlendirmesi için tek kaynaktır. Kullanıcıya kopyala-yapıştır broşür değil; ürünün gerçek mimarisini anlatır.


0. Lyra bu belgeyi nasıl kullanmalı?

DurumLyra ne yapar
“HORECA nedir?”§1–2: konumlandırma + üç taraf
İşletme sahibi / yatırım§4 değer önermesi + §5 plan karşılaştırması
Misafir deneyimi§6 misafir yolculuğu
“Ürün nasıl eklerim?”§9 görev reçeteleri + §8 panel haritası
Partner / entegrasyon§7
Fiyat / plan§5 — Standard ücretsiz, Plus $25, Extended $100
Agresif pazarlama§11 konuşma açıları — §12 dürüstlük sınırlarına uy

Lyra panelde işlem yapmaz; doğru sayfaya götürür veya adım adım tarif eder.


1. HORECA’nın özü (anlamlandırma)

HORECA, HoReCa sektörü için bulut tabanlı işletme işletim sistemidir (restoran işletim sistemi + misafir dijital katmanı + B2B partner ağı).

1.1 Çözdüğü temel problem

Geleneksel işletmede veri parçalıdır: menü PDF’te, sipariş kağıtta, stok Excel’de, cari muhasebede, rezervasyon defterinde. HORECA bu katmanları tek işletme kaydı (workspace) altında birleştirir; misafir tarafı aynı veriyi okur/günceller.

1.2 “Sadece QR menü” algısı

QR, misafirin kapısıdır — ama arka planda:

  • Menüdeki her fiyat değişikliği anında misafir ekranına yansır.
  • Aynı ürün adisyon satırına, stok malzemesine ve (yapılandırıldıysa) muhasebe yevmiyesine bağlanabilir.
  • Rezervasyon masası, adisyon masası ve kat planı aynı masa envanterinden beslenir.

Lyra pazarlamada: “QR menü vitrin; HORECA arka planda operasyon motoru.”

1.3 Bykandil ekosistemindeki yeri

  • Lyra — kişisel asistan; HORECA’da AI menü içe aktarma, çeviri, QR’da “AI Asistan”, panel sohbeti.
  • Travel / DVC — farklı ürünler; karıştırma.
  • Lemon Squeezy — işletme abonelik ödemesi.
  • ExConvert — otomatik döviz kurları.
  • HORECA Print Agent — USB/Bluetooth yazıcılar için yerel köprü.

1.4 Rakip POS / QR menüden farkı (kodda kanıtlanan)

BoyutHORECATipik QR/POS
Misafir katmanı6 QR teması, çoklu dil/para, garson çağır, masadan sipariş, Lyra asistanGenelde statik PDF veya basit liste
Menü girişiPDF/görsel/URL/metin → Lyra ile parse; AI çeviri/açıklamaElle giriş
MuhasebeTR TDHP + maliye denetim görünümü, otomatik yevmiye (ayarlı)Dış muhasebe export
Partnerİzin kataloğu + webhook outboxNadir
RezervasyonHostes, kat planı editörü (sürükle-bırak şekiller), paylaşılabilir link + QRAyrı ürün
YazıcıAğ + Print Agent (USB/BT) + fiş şablonu/kurallarTek kanal
Keşif/discover-businesses, herkese açık profilYok

2. Üç taraf modeli (keskin sınırlar)

2.1 İşletme tarafı

Kim: Sahip, genel müdür, kasiyer, garson, hostes, muhasebe sorumlusu.
Öder mi: Evet — Standard (ücretsiz) veya Plus ($25/ay) veya Extended ($100/ay).
Yaşar: /dashboard/workspace/{slug}/...

Operasyonel ayarlar (/settings/...): galeri, hizmet türleri, işletme bilgisi, açılış saatleri.
Ticari ayarlar (/general/subscription): plan, Lemon Squeezy portal, abonelik geçmişi.

2.2 Misafir (müşteri) tarafı

Kim: Masaya oturan, online rezervasyon yapan, QR okuyan kişi.
Öder mi: HORECA’ya hayır — ödeme işletmeye (ürün/hizmet) olur.
Yaşar: /{slug}/..., /businesses/{slug}, keşif sayfaları.

Hesap açmadan menü, rezervasyon, (açıksa) masadan sipariş ve kasa ödemesi.

2.3 Partner tarafı

Kim: İşletmeye B2B hizmet/ürün sunan firma (kurye, tedarikçi, medya, entegratör).
Öder mi: HORECA’ya hayır.
Yaşar: /dashboard/partner/{slug}/...

Partner işletme değildir; horeca_partner_businesses kaydı ayrıdır.


3. Ürün durumu matrisi (Lyra dürüstlük SSOT)

Kod ve route denetiminden. Lyra “yakında” veya “pazarlama sayfası” olanı shipped gibi satmamalı.

Modül / özellikDurumNot
Menü, kategori, ürün, varyant, çoklu paraShippedworkspace-menu-item-detail-view, menu-variants.js
Menü sürükle-bırak sıraShipped@atlaskit/pragmatic-drag-and-drop
Toplu içe aktarma (metin/JSON/CSV/PDF/görsel/URL)ShippedLyra import-parser
AI çeviri / açıklama / yazım düzeltmeShipped/api/chat, /api/translate
QR menü + 6 temaShippedTema 6 “Özel” kısmen yakında
Adisyon, kasa, iade, Z-raporuShipped
Yazıcı ağ + Print Agent USB/BTShippedprinter-catalog.js
Rezervasyon (liste, takvim, hostes, kat planı)Shipped
Rezervasyon paylaşılabilir link + QRShippedbookingLink locale
Rezervasyon kat düzeni editörü (şekiller, ızgara)ShippedfloorLayout
Stok / malzeme, SKT, düşük stok uyarılarıShippedstock-view, expiry fields
Tedarik modülü (/stock/supply)PlaceholderUI “yakında”
Muhasebe (TR/INT, cari, rapor, maliye)Shipped (kısmi Faz 2)Bazı CRUD “read-only Faz 1”
Personel, roller, izin matrisiShipped
Personel eğitimiPlaceholderRoute var, içerik giriş
Partner keşif + bağlantı + webhookShipped
İşletme “Talep aç” (/partners/request)Yakında
WhatsApp rezervasyon webhookStubVerify route, işleme kısıtlı
Mutfak ekranı (KDS — ayrı modül)Pazarlama/kitchen-management landing; ayrı dashboard route yok
Mutfak fişi (yazıcı kuralı)Shipped (kısmi)print_kitchen_on_confirm — sipariş onayında mutfak yazıcısına fiş; KDS ekranı değil
Kurye canlı takip UIPazarlamaPricing listesinde; ayrı modül yok
Sosyal medya yöneticisiPazarlama/social-media-management
CRM / şikayet modülüPazarlama/complaints-management
Caller IDPazarlamaPricing’de; kod yok
Alerjen etiket alanı (yapılandırılmış)YokAçıklama metninde önerilir; dedicated field yok
Otel kategorisi / otel fiyat matrisiYakındahome.json → hotelDialog: “Otel kategorisi yakında”; işletme oluşturmada hotel seçeneği var ama fiyatlandırma sekmesi restoran/kafe odaklı
Plan limitleri (10 kategori, 50 ürün…)Pazarlama metnihome.json — kodda enforce edilmiyor (2026 denetimi)

4. İşletme değer önermesi (Lyra pazarlama dili)

4.1 Tek cümle pitch’ler

  • “Menünüzü bir kez girin; QR, adisyon, stok ve rapor aynı veriyi kullansın.”
  • “Misafir telefonundan sipariş versin; mutfak fişi ve kasa aynı adisyonda buluşsun.”
  • “Rezervasyonu Instagram linkine koyun; hostes paneli masayı hazır tutsun.”
  • “Tedarikçiniz stok ve cari verinizi izinle çeksin — Excel e-posta zinciri olmasın.”

4.2 Persona bazlı

PersonaAcıHORECA cevabı
Küçük kafe sahibiMenü güncellemek zorQR + anlık senkron, ücretsiz Standard ile başlangıç
Restoran müdürüGarson–kasa kopukluğuAdisyon + kasa + masa birleştirme/aktarma
Zincir operasyonŞube başına dağınık veriÇoklu işletme (plan + RBAC)
MuhasebeciPOS verisi güvenilmezKapalı adisyon → yevmiye (otomasyon açıksa), maliye salt okunur görünüm
HostesTelefon + defter karmaşasıTakvim, kat planı, misafir CRM, online link

4.3 Segment — restoran, kafe, otel

SegmentLyra nasıl konuşur
RestoranTam operasyon hikâyesi: rezervasyon + adisyon + kat planı + stok.
KafeHızlı menü/QR, sınırlı masa, turist için çoklu dil/para vurgusu.
OtelYumuşak tease: “Restoran ve kafe için hazır; otel kategorisi ve otel fiyat matrisi yol haritasında — fiyat sayfasında otel sekmesi şu an ‘yakında’.” Otel işletmesi kaydı teknik olarak seçilebilir; otel-özel modüller vaat etme.

Kaynak: workspace-create-form.jsx (category: hotel/restaurant/cafe), home.json → pricing.hotelDialog.

4.4 Büyüme yolu (land → expand)

  1. Standard: dijital vitrin — menü + QR + keşif profili.
  2. Plus: günlük operasyon — adisyon, stok, rezervasyon, yazıcı, personel.
  3. Extended: ölçek + öncelik — Otomatik Satış Asistanı + SLA (pazarlama ayrımı; bkz. §5).

4.5 Lyra şöyle söyler (ton kütüphanesi — script değil)

BağlamÖrnek açı
İlk tanışma“HORECA, menünüzü bir kez girip QR’dan kasaya kadar aynı veriyle yönetmenizi sağlayan bulut işletim sistemi.”
QR algısı“QR vitrininiz; arka planda adisyon, stok ve rezervasyon aynı menüden beslenir.”
Ücretsiz plan“Standard ile ücretsiz başlayabilirsiniz; günlük operasyon için Plus’a bakmak mantıklı.”
Limit sorusu“Fiyat sayfasında plana göre hedeflenen kotlar var; uygulamada limitler henüz sıkı enforce edilmiyor — canlı davranışı panelden teyit edin.”
Mutfak“Ayrı mutfak ekranı modülü henüz yok; sipariş onayında mutfak yazıcısına fiş basma var.”
Otel“Kafe ve restoran için hazırız; otel fiyatlandırması yakında — isterseniz restoran/kafe akışını anlatayım.”
Extended“Extended, Plus’un üzerine öncelikli destek ve pazarlama paketindeki Otomatik Satış Asistanı ayrımını getirir; modülleri kodda kilitlemez.”
Panel işlemi“Panelde sizin adınıza işlem yapamam; adım adım tarif ederim veya doğrudan link veririm.”

5. Planlar ve fiyatlandırma

Kod SSOT: subscription-pricing-plan-content.js → standard | plus | extended
Fiyat: $0 · $25/ay · $100/ay (Lemon Squeezy).
Panel: /dashboard/workspace/{slug}/general/subscription

Kod adıKullanıcı diliFiyat
standardStandart / Ücretsiz$0
plusPlus / Başlangıç$25/ay
extendedExtended / Kurumsal$100/ay

Müşteri ve partner ödeme yapmaz.

5.1 Standard (ücretsiz) — pazarlama limitleri

home.json → pricing.plans.standard (üstü çizili = bu planda yok):

Dahil (özet): çalışma saatleri, 2 alan / 10 masa, 1 QR menü, 10 kategori / 50 ürün, temel menü/QR, adisyon/kasa (listede), çoklu para, rezervasyon (listede), puanlama, galeri, kampanya/indirim (kısmi).

Üstü çizili (Standard’da yok denir): çoklu işletme, stok, otomatik stok uyarısı, mutfak, kurye, yazıcı, personel eğitimi, ayın personeli, CRM, şikayet, caller ID, sosyal entegrasyon, akıllı otomasyon, otomatik satış asistanı, partner webhook, SLA.

Lyra notu: Bu limitler şu an yazılı pazarlama matrisidir; uygulama kodunda hard gate bulunamadı. Kullanıcıya “sistem şu an X’e izin vermiyor” demeden önce canlı davranışı doğrula.

5.2 Plus ($25/ay)

home.json → pricing.plans.plus: Standard’daki üstü çizili operasyonların çoğu açık — sınırsız masa/alan/menü/QR, stok, rezervasyon, yazıcı, kurye takip (pazarlama), personel eğitimi, partner webhook.

Extended’a göre üstü çizili kalan: Otomatik Satış Asistanı, SLA Destek Paketi.

workspace.json Plus özeti: QR + adisyon + kasa + stok + personel + rezervasyon + temel rapor.

5.3 Extended ($100/ay)

Plus’un tamamı + pazarlama olarak: Otomatik Satış Asistanı, SLA Destek Paketi.

workspace.json Extended özeti: Plus + gelişmiş analitik, sınırsız menü/QR, mutfak/kurye/yazıcı entegrasyonları (pazarlama dili), partner ekosistemi, öncelikli destek.

5.4 Plus vs Extended — kod gerçeği

Abonelik kaydı ödeme ve portal için kullanılır; modül route’ları plana göre kesilmiyor (2026). Lyra farkı fiyat sayfası ve subscription ekranı metnine dayandırmalı; “Extended olmadan muhasebe açılmaz” dememeli.


6. Misafir tarafı — yolculuk ve değer

6.1 Tipik akışlar

A) QR menü
QR okut → /{slug}/{menuSlug} → tema (arama, kategoriler, galeri, çalışma saatleri) → ürün detay → (açıksa) sepete ekle / garson çağır.

B) Masadan sipariş
/{slug}/tables/... veya /{slug}/masalar/{tableId} → ürün ekle → adisyon satırı işletme panelinde.

C) Rezervasyon
/{slug}/rezervasyon veya paylaşılan link → tarih/saat/kişi → (açıksa) masa seçimi → onay.

D) Ödeme
/{slug}/kasa veya masa bazlı kasa URL.

6.2 Misafirin kazanımları (pazarlama)

  • Güncel fiyat ve stok durumu (işletme yönetirse).
  • Çoklu dil ve para birimi (işletme + tema).
  • Beklemeden sipariş; garson çağırma.
  • İşletmeyi puanlama, galeri, WiFi bilgisi (temaya bağlı).
  • QR içi Lyra AI Asistan — menü hakkında soru (Lyra API).
  • Platform keşfi — yeni mekan bulma (/discover-businesses).

6.3 Herkese açık URL tablosu

AmaçYol
Menü/{slug}/{menuSlug}
Ürün/{slug}/{menuSlug}/items/{itemId}
Masalar (TR)/{slug}/masalar, /{slug}/masalar/{tableId}
Masalar (EN)/{slug}/tables, /{slug}/tables/{tableSlug}/add-product
Kasa/{slug}/kasa, /{slug}/kasa/{tableSlug}
Rezervasyon/{slug}/rezervasyon
İşletme profili/businesses/{slug}
Keşif/discover-businesses
Personel başvuru (QR)/personel-qr-basvuru/{businessSlug}/

Misafir eğitim sayfaları: /qr-menu-usage, /reservation-guide, /ordering-guide, /view-menus, /write-reviews, /map-usage.


7. Partner ekosistemi

7.1 Mantık

İşletme operasyonu yapar; partner B2B hizmet sunar. Veri paylaşımı açık rıza ile.

7.2 İzin kataloğu (partner-consent-catalog.js)

AnahtarNe verir
menu.readYayınlanmış menü
order.readSiparişleri okuma
order.pushSipariş webhook (push)
stock.readStok seviyeleri
stock.low_alertDüşük stok uyarıları
accounting.receivables.readCari alacak bakiyeleri

7.3 Akış

  1. İşletme → Partner Ekosistem → partner kartı → hizmet/ürün + izinler.
  2. Talep → horeca_business_partner_links (pending).
  3. Partner panel → onay + savePartnerConsents.
  4. Olaylar → /api/partner-integrations/dispatch → partner HTTPS webhook (HMAC opsiyonel).

7.4 Partner paneli

SayfaYol
Kayıt/dashboard/partner/register
Özet/dashboard/partner/{slug}/overview
Hizmetler.../services
Ürünler.../products
Entegrasyon.../integrations (webhook URL, API key)
Bağlı işletmeler.../links
Loglar.../logs

8. Panel URL haritası (işletme)

{slug} = işletme kısa adı.

8.1 Çekirdek operasyon

ModülYol
İşletme oluştur/dashboard/workspace/create
Özet/dashboard/workspace/{slug}/overview
Adisyon.../order
Kasa.../order/cashier
Kur.../currency-rates

8.2 İşletme profili (operasyonel — abonelik değil)

Alt modülYol
Ayarlar kök.../settings
Galeri.../settings/gallery
Hizmet türleri.../settings/service-types
İşletme bilgisi.../settings/business-info
Açılış saatleri.../settings/opening-hours

8.3 Menü ve QR

Alt modülYol
Menü listesi.../menu
Kategori/ürünler.../menu/{menuSlug}
Ürün detay (varyant, fiyat, çeviri).../menu/{menuSlug}/items/{itemId}
QR kod.../qr-code
QR temalar.../qr-code/themes

8.4 Adisyon ayarları

Alt modülYol
Alan/masa.../order/table-settings
Alan masaları.../order/table-settings/{areaSlug}/
Yazıcı cihazlar.../order/printer-settings/devices
Yazıcı kurulum.../printer-settings/setup
Fiş şablonu.../printer-settings/templates
Yazdırma kuralları.../printer-settings/rules
Test.../printer-settings/diagnostics
İndirim/promosyon.../order/discounts-promotions

8.5 Stok, muhasebe, rezervasyon, personel, partner, ticari

ModülYol
Stok.../stock
Tedarik (placeholder).../stock/supply
Muhasebe.../accounting (+ maliye, transactions, contacts, reports, settings)
Rezervasyon.../reservations (+ calendar, hostess, floor-plan, floor-view, guests, statistics)
Rez. ayarları.../reservations/settings (+ integrations, notifications, floor-layout)
Personel.../personnel/management (+ roles, positions, job-listings, applications, training, working-hours)
Partner keşif.../partners (+ links, request, {partnerId})
Genel / ticari.../general
İşletme düzenle.../general/edit-business
Abonelik.../general/subscription

9. Özellik ağacı (modül → alt yetenekler, kod kaynaklı)

9.1 Menü ve ürün

  • Çoklu menü; kategori hiyerarşisi.
  • Ürün: ad, açıklama, görsel, fiyat, aktif/pasif, sıralama.
  • Varyant grupları ve varyant bazlı fiyat (price_modifier).
  • Çoklu para birimi fiyatları.
  • Çoklu dil çevirileri.
  • Availability zamanlama (JSON).
  • Malzeme bağlantısı → stok düşümü.
  • Sürükle-bırak kategori/ürün sırası.
  • Toplu işlemler: fiyat artır/azalt, toplu sil, taşıma.
  • İçe aktarma: metin, JSON, CSV, PDF, görsel, menü URL (Lyra parse).
  • AI: yazım düzeltme, açıklama üret, eksik çevirileri tamamla.
  • Alerjen: yapılandırılmış alan yok → açıklama veya varyant notu.

9.2 QR menü ve temalar

  • Menü başına QR config; yayınla/kapat; QR PNG indir.
  • 6 tema: Modern Minimal, Klasik Şık, Renkli Canlı, Elegant Dark, Minimalist White, Özel (kısmen yakında).
  • Tema özellikleri (kartlarda): koyu/açık mod, kategori sekmeleri, arama, popüler ürünler, puanlama, galeri, hizmetler, garson çağır, AI asistan, çoklu dil/para, WiFi, öneri, rezervasyon, iş ilanları.
  • QR anahtarları: çalışma saatleri göster, menü açıklaması, masadan sipariş, garson çağır.

9.3 Adisyon ve kasa

  • Alan → masa; durumlar: müsait, rezerve, dolu, temizlik, hesap istendi…
  • Sipariş satırları, notlar, masa birleştirme/aktarma.
  • Kasa: nakit/kart, indirim, promosyon.
  • İade / parçalı iade; işlem geçmişi (sayfalı).
  • Z-Raporu (kasa + muhasebe raporları).
  • Yazıcı: ağ IP, USB Agent, Bluetooth Agent; şablon ve kurallar.

9.4 Rezervasyon

  • Liste, takvim, hostes paneli.
  • Kat planı görünümü; masa durumları (VIP etiketi vb.).
  • Misafir kayıtları, istatistik.
  • Paylaşılabilir rezervasyon linki + QR PNG; otomatik/manuel onay; max kişi/gün; hoş geldin mesajı.
  • Misafir masa seçimi (açık/kapalı).
  • Kat düzeni editörü: yuvarlak, kare, dikdörtgen, oval, loca; ızgara; geri al/yinele.
  • Kaynak kanalları: telefon, WhatsApp, Instagram, Google, web, kapıda…
  • WhatsApp entegrasyon webhook: kısmi/stub.

9.5 Stok

  • Malzeme kartları, birimler, hareketler.
  • SKT (tarih/saat), bozulabilir ürün alanları.
  • Uyarı filtreleri (düşük stok, SKT yakın — UI filtreleri).
  • Menü ürünü ↔ malzeme reçetesi.
  • Tedarik sayfası: placeholder.

9.6 Muhasebe

  • TR paketi (TDHP) ve INT (IFRS jenerik) ülke paketi.
  • Cariler, işlemler, çek/senet, tekrarlayan kayıtlar.
  • Vergi kodları, otomatik POS yevmiyeleştirme (ayar).
  • Maliye salt okunur denetim ekranı + görüntüleme kuralları (gerçek kayıtları değiştirmez).
  • Raporlar: KDV, gelir tablosu, yaşlandırma, mizan/defter (gelişmiş).
  • Paylaşım: muhasebeci daveti, scope’lu erişim.

9.7 Personel

  • Davet, rol, izin matrisi (path bazlı permissionSlug).
  • Pozisyonlar, vardiya/çalışma saatleri takvimi.
  • İş ilanları + başvuru yönetimi.
  • Personel QR başvuru (ilansız genel sayfa).
  • Eğitim modülü: placeholder kartlar.

9.8 Keşif ve vitrin

  • Harita/liste ile işletme keşfi.
  • Herkese açık işletme detayı, puanlama formu (giriş gerekebilir).
  • Blog /post/{slug} — SEO içerik.

10. Görev reçeteleri (Lyra yönlendirme)

10.1 Hesap + işletme açmak

  1. /auth/sign-up — ad soyad, telefon, parola → SMS OTP.
  2. /dashboard/workspace/create — zorunlu: ad, kategori, cep, e-posta, açıklama, adres (ülke/il/ilçe), harita pin, logo, kapak.
  3. İlk menü: .../menu → menü oluştur → kategori → ürün ekle.
  4. QR: .../qr-code → menü seç → yayınla → tema .../qr-code/themes.

10.2 Ürün eklemek

.../menu → menü → kategori → Ürün Ekle → kaydet.
Varyant: ürün detay sayfası .../items/{itemId}.

10.3 Masa açmak

.../order/table-settings → alan ekle → masa ekle → (opsiyonel) QR URL.

10.4 Rezervasyon linki paylaşmak

.../reservations/settings → booking link aktif → çalışma saati kontrol → link/QR kopyala → /{slug}/rezervasyon.

10.5 Plan yükseltmek

.../general/subscription → Plus veya Extended → Lemon Squeezy checkout → Aboneliği kontrol et.

10.6 Partner bağlantısı

.../partners → partner detay → izinleri seç → talep gönder → partner .../links’ten onaylar.


11. Lyra pazarlama konuşma açıları

  1. “Excel menüden kurtul” — PDF fotoğrafı Lyra ile içe aktar.
  2. “Misafir beklemez” — QR + masadan sipariş + garson çağır.
  3. “Rezervasyon kaçmasın” — link + hostes + kat planı.
  4. “Stok sürprizi olmasın” — malzeme bağlantısı + uyarılar.
  5. “Muhasebe gece yarısı değil” — kapanan adisyon → yevmiye (ayarlı).
  6. “Tedarikçi entegrasyonu” — partner webhook, izinli veri.
  7. “Çok şubeli büyüme” — çoklu işletme + merkezi rapor (plan).
  8. “Turist müşteri” — çoklu dil/para + Lyra asistan QR’da.

12. Lyra dürüstlük — vaat etme

  • Plan limitlerini (10 kategori vb.) kesin kural gibi söyleme — henüz kodda gate yok; fiyat sayfası matrisini “hedeflenen plan ayrımı” diye anlat.
  • Mutfak ekranı (KDS), kurye haritası, sosyal medya yöneticisi, CRM, caller ID — ayrı shipped modül değil. Mutfak fişi yazıcı kuralıyla var — KDS ile karıştırma.
  • Alerjen alanı — yapılandırılmış değil.
  • Tedarik, partner “talep aç”, personel eğitimi — yakında/placeholder.
  • Extended olmadan modül kapalı — doğru değil (route açık; fark ödeme + pazarlama SLA/asistan).
  • Maliye ekranı resmi beyanname değil — iç yönetim/denetim görünümü.
  • Otel segmenti — yol haritasında; otel fiyat sekmesi “yakında” (hotelDialog).

12.1 Kanal davranışı (Lyra)

KanalDavranış
Chat / webTam URL verebilir; SSOT §8–§10 linkleri kullan. Markdown link formatı: https://horeca.bykandil.com/dashboard/workspace/{slug}/...
Telefon / sesKısa cevap; en fazla bir URL veya “panelde X menüsü” de; uzun path okuma.
WhatsApp / Telegram (ileride)Chat ile aynı; tek mesajda bir görev reçetesi.

Bilinmeyende: Uydurma → horeca.knowledge tool ile bank’tan çek; yoksa kullanıcıya sor veya Destek’e yönlendir.
Panel: Login yok, form doldurma yok, ödeme yok — sadece rehberlik.

Kaynak: lyra-bykandil-com/src/ai/tools/builtin.js → horeca.knowledge.


13. Site pazarlama sayfaları

SayfaYol
Fiyat/pricing
Hizmetler/services
Çözümler (sektör)/solutions
Ortaklıklar/partnerships
Partner işletmeler/partner-businesses
Entegrasyonlar/entegrasyonlar
API/api-dokumantasyon
Webhook/api-webhook
İşletme kayıt/isletme-kayit
Demo/demo-talep

Özellik landing: /qr-menu-systems, /accounting-management, /reservation-software, /inventory-supply-management, /staff-management, /business-management, /payment-solutions, /masa-yonetimi, /raporlama, /analitik, /musteri-yonetimi — bazıları §3 matrisinde “pazarlama” olarak işaretli.


14. Kayıt — teknik zorunlu alanlar

Kullanıcı (supabase-sign-up-view): fullName, phone, password (≥6), OTP.

İşletme (workspace-create-form Zod): name, category, phone_mobile, email, description, address, country, city, district, latitude, longitude, logo (File), cover (File). Opsiyonel: phone_land, website, establishment_date, sosyal linkler.


16. Eksikler ve öneriler (denetim — 2026)

Lyra’nın yanlış söyleyebileceği riskler ve ürün ekibi backlog’u.

P0 — Yanlış bilgi riski (hemen düzelt / Lyra’da asla söyleme)

KonuRiskKaynak
Plan route gate yok“Extended olmadan muhasebe/stok açılmaz” deme — modüller route’ta açıkRoute taraması; permission-guard plan kontrolü yok
workspace.json subscription açıklaması“Plus/Extended tüm modüllere erişim” — kod gerçeğiyle uyumsuz pazarlamaworkspace.json → subscription.description
Plan limitleri enforce yok“50 ürün limitine takılırsınız” gibi kesin iddiahome.json pricing; gate araması boş
$50 planYok — yalnızca $0 / $25 / $100subscription-pricing-plan-content.js
Misafir/partner ödemesiHORECA’ya ödeme yapmazlarİş kuralı
Mutfak KDSLanding var, modül yok; mutfak fişi ayrıpaths.features.kitchen vs printing/triggers.js
Otel fiyatlandırma“Otel paketi hazır” demehome.json → hotelDialog

P1 — Ürün / pazarlama uyumu

KonuÖneri
Plan limit enforcementKategori/ürün/masa/QR kotası için server-side veya UI gate
Alerjen alanıMenü ürün şemasına yapılandırılmış alerjen etiketleri
stock/supplyTedarik modülü veya route’u kaldır / “yakında” netleştir
partners/requestİşletme “talep aç” akışını tamamla veya nav’dan gizle
Personel eğitimiCRUD veya “yakında” banner (training.helpModal.p2)
QR tema 6 “Özel”Özelleştirme kapsamını netleştir veya locale’de işaretle
Subscription UI metni“Tüm modüllere erişim” ifadesini plan matrisiyle hizala

P2 — İyileştirme

KonuÖneri
WhatsApp rezervasyon webhookStub → tam entegrasyon veya docs’tan kaldır
Otomatik Satış Asistanı / SLAExtended pazarlama maddelerinin kod karşılığını tanımla
Caller ID, CRM, sosyal modülLanding → roadmap veya modül
EN SSOT / Lyra bankTR tamamlandı; i18n sonra

17. Lyra test senaryoları (SSOT’tan beklenen cevap özeti)

SoruBeklenen cevap özeti
HORECA ne işe yarar?Bulut işletim sistemi: menü, QR, adisyon, stok, rezervasyon, muhasebe, partner — tek workspace.
Ücretsiz planda neler var?Standard $0: menü, QR, temel operasyon listesi; fiyat sayfası matrisi; limitler enforce değil.
Mutfak ekranı var mı?Ayrı KDS modülü yok (pazarlama). Mutfak yazıcı fişi var (yazıcı kuralları).
Alerjen gösterimi var mı?Yapılandırılmış alan yok; açıklama/varyant notu öner.
Ürün nasıl eklerim?.../menu → menü → kategori → ürün; varyant .../items/{id}.
Müşteriler ödeme yapar mı?HORECA’ya hayır; işletmeye (ürün/hizmet).
Partner olmak için ne öderim?HORECA’ya ödeme yok; B2B hizmet sunarsınız.
Extended olmadan muhasebe açılır mı?Evet — route açık; plan farkı fiyat/SLA/pazarlama.
Rezervasyon linki nasıl paylaşırım?.../reservations/settings → link/QR → /{slug}/rezervasyon.
QR temaları neler?6 tema: Modern Minimal, Klasik Şık, Renkli Canlı, Elegant Dark, Minimalist White, Özel.
Planlar kaç para?Standard $0, Plus $25/ay, Extended $100/ay — $50 plan yok.
Abonelik nereden?.../general/subscription — settings değil.
Stok tedarik modülü?/stock/supply placeholder — yakında.
Otel destekleniyor mu?Kafe/restoran hazır; otel fiyat matrisi yakında; yumuşak tease.
Lyra panelde ürün ekler mi?Hayır — adım adım veya link.

18. Dokümantasyon mimarisi

Tüm Türkçe docs tek dosyada birleştirildi: src/content/docs/tr/horeca-urun-rehberi.md

Kategoridoc-slug (sol menü URL)
Başlangıçbaslangic
Lyra SSOT (bu bölüm)horeca-urun-rehberi (tam belge)
Hesap / işletmehesap-kayit-giris, isletme-olusturma-ve-workspace, …
Menü / QR / operasyon / stok / ekip / destekmanifest’teki diğer slug’lar

Her slug <!-- doc-slug: ... --> işaretçisi ile aynı dosyadan yüklenir (load-doc.js).


19. Bakım

Ürün değiştikçe önce bu dosya, sonra Lyra HORECA_BANK_EXTENDED güncellenir. Kod referansları: paths.js, nav-config-dashboard.jsx, home.json (pricing), workspace.json, partner-consent-catalog.js, subscription-pricing-plan-content.js.


Kategori: Hesap ve işletme

Hesap: kayıt ve giriş

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §10.1, §14.

Yollar

  • Kayıt: /auth/sign-up (SMS OTP)
  • Giriş: /auth/sign-in
  • İşletme kaydı (pazarlama): /isletme-kayit

Zorunlu kullanıcı alanları: ad soyad, telefon, parola (≥6 karakter).

Sonraki adım: İşletme ve çalışma alanı.


İşletme ve çalışma alanı

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §10.1, §14 (Kayıt zorunlu alanlar).

Akış

  1. /auth/sign-up — ad, telefon, parola, OTP
  2. /dashboard/workspace/create — işletme formu (logo, kapak, adres, harita pin zorunlu)

Kategori: restoran, kafe veya otel (otel fiyat matrisi henüz yakında).

Çoklu işletme: her biri ayrı workspace {slug}.


İşletme genel bakış

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §8.1 (Çekirdek operasyon).

Panel

/dashboard/workspace/{slug}/overview — günlük operasyonlara giriş özeti.

Abonelik burada değil: .../general/subscription. Operasyonel ayarlar: .../settings/....


İşletme ayarları

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §8.2 (İşletme profili — abonelik değil).

Panel (/settings/)

Alt modülYol
Galeri.../settings/gallery
Hizmet türleri.../settings/service-types
İşletme bilgisi.../settings/business-info
Açılış saatleri.../settings/opening-hours

Plan ve faturalama: Genel ayarlar ve abonelik → .../general/subscription.


Kategori: Menü ve QR

Menü yönetimi

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.1 (Menü ve ürün), §10.2 (Ürün eklemek).

Güncel ürün gerçeği, varyant/AI içe aktarma ve panel yolları SSOT belgesindedir.

Panel

/dashboard/workspace/{slug}/menu → menü → kategori → ürün
Varyant ve çeviri: .../menu/{menuSlug}/items/{itemId}

Hızlı not

  • Alerjen için yapılandırılmış alan yok — açıklama alanını kullanın.
  • Sonraki adım: QR menü ve temalar.

QR menü ve temalar

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.2 (QR menü ve temalar), §6 (Misafir yolculuğu).

Panel

  • QR kod: /dashboard/workspace/{slug}/qr-code
  • Temalar: .../qr-code/themes

Özet

6 tema (Modern Minimal … Özel). Misafir menüsü: /{slug}/{menuSlug}. Garson çağır, masadan sipariş ve Lyra AI asistan işletme ayarına bağlıdır.

İlgili: Menü yönetimi, Misafir URL’leri.


Misafir tarafı: menü ve kasa bağlantıları

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §6 (Misafir yolculuğu), §6.3 (URL tablosu).

Misafir HORECA’ya ödeme yapmaz.

AmaçYol
Menü/{slug}/{menuSlug}
Masa/{slug}/masalar/{tableId}
Kasa/{slug}/kasa
Rezervasyon/{slug}/rezervasyon
Profil/businesses/{slug}
Keşif/discover-businesses

Panel yönetimi: Menü, Adisyon.


Kategori: Operasyon

Adisyon ve kasa

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.3 (Adisyon ve kasa), §8.4 (Adisyon ayarları).

Panel

  • Adisyon: /dashboard/workspace/{slug}/order
  • Kasa: .../order/cashier
  • Alan/masa: .../order/table-settings
  • Yazıcı: .../order/printer-settings/...

Özet

Masa durumları, sipariş satırları, birleştirme/aktarma, kasa ödemesi, iade, Z-raporu. Mutfak fişi yazıcı kuralıyla basılır; ayrı mutfak ekranı (KDS) modülü yok.

İlgili: Alan ve masalar, Muhasebe.


Rezervasyonlar

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.4 (Rezervasyon), §10.4 (Rezervasyon linki).

Panel

  • Liste/takvim/hostes: /dashboard/workspace/{slug}/reservations
  • Ayarlar ve booking link: .../reservations/settings
  • Kat düzeni: .../reservations/settings/floor-layout

Misafir

/{slug}/rezervasyon — paylaşılabilir link panelden üretilir.

İlgili: Alan ve masalar.


Alan ve masalar

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §8.4, §9.3, §10.3.

Panel

/dashboard/workspace/{slug}/order/table-settings → alan ekle → masa ekle.

Misafir (masadan sipariş)

  • /{slug}/masalar/{tableId} veya /{slug}/tables/...

Rezervasyon kat planı aynı masa envanterini kullanır — Rezervasyonlar.


Kategori: Stok ve finans

Stok ve tedarik

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.5 (Stok).

Panel

  • Stok: /dashboard/workspace/{slug}/stock
  • Tedarik: .../stock/supply — placeholder (yakında)

Özet

Malzeme kartları, SKT, düşük stok uyarıları, menü reçetesi bağlantısı. Tedarik modülü henüz operasyonel değil.

İlgili: Muhasebe.


Raporlama ve istatistikler

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.3 (Z-Raporu), §9.6 (Muhasebe raporları), §9.4 (Rez. istatistik).

Nerede?

  • Kasa Z-raporu: adisyon/kasa modülü
  • Rezervasyon istatistik: .../reservations/statistics
  • Muhasebe raporları: .../accounting/reports — ayrıntı Muhasebe modülü

Analitik landing (/analitik) pazarlama sayfasıdır; dashboard’da ayrı “analitik” modülü yok.


Kur bilgileri

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §1.3 (ExConvert entegrasyonu).

Panel

/dashboard/workspace/{slug}/currency-rates

Otomatik döviz güncelleme ExConvert ile; menüde çoklu para birimi fiyatları desteklenir.


Muhasebe modülü

Ürün SSOT: Genel modül durumu ve plan ayrımı için HORECA ürün rehberi §9.6. Bu belge muhasebe modülünün derin operasyon rehberidir.

Muhasebe modülü, işletme sahibinin satış, gider, cari hesap ve resmi mali tablolarını ana sayfalar + sekmeler üzerinden tek noktada izleyebileceği tam donanımlı bir paneldir. Çift taraflı muhasebe ilkesine ve çoklu ülke (country pack) mimarisine göre tasarlanmıştır:

  • Türkiye paketi (TR_TDHP) — Tek Düzen Hesap Planı, KDV %1/%8/%10/%18/%20 + stopaj, e-fatura/e-arşiv altyapısı.
  • Uluslararası paket (INT_GENERIC) — IFRS uyumlu jenerik 4 haneli plan, çoklu satış vergisi (VAT/GST/Sales Tax/Reverse Charge/Zero-rated/Exempt).

Posting (yevmiyeleştirme) motoru sabit hesap kodlarına bağlı değildir; rol bazlı haritalama (account_mappings) sayesinde TR'de TDHP'ye, INT'de jenerik plana otomatik bağlanır.

Temel kavramlar

  • Cari hesap: Müşteri, tedarikçi, personel veya diğer karşı taraflar. Her cari kayıt için açılış bakiyesi, kredi limiti, vergi kimliği ve hareket geçmişi tutulur.
  • Hesap planı: TR'de TDHP (100, 102, 120, 320, 600, …), INT'de IFRS jenerik (1010, 1020, 1200, 2100, 4000, …) plan otomatik yüklenir.
  • Vergi kodları: Sabit default_vat_rate yerine işletme bazlı çoklu tax_codes (KDV, stopaj, zero-rated, reverse-charge, exempt). Faturalar tax_code_id üzerinden hesaplanır.
  • Hesap rolleri: cash, bank, receivable, payable, revenue, tax_output, tax_input, cogs, expense_default … gibi 21 rol account_mappings tablosunda chart_of_accounts'a bağlanır. Posting engine bu rolleri çözümler.
  • Yevmiye fişi: Her mali olay borç=alacak dengeli kayıt olarak yevmiyeye işlenir. POS adisyonu, fatura veya tahsilat girildiğinde otomatik yevmiye fişi üretilir.
  • Dönem kilidi: Mali yıl kapanışı yapıldıktan sonra ilgili dönem değişikliklere kapatılır.
  • Üçüncü parti erişim: Muhasebeci, denetçi, kurye, toptancı, matbaa gibi roller scope'lu (reports.read, transactions.read …) erişim alır. Veri tabanı (partner_access) ve RLS hook'u (accounting_has_partner_access) kullanılır; davet Muhasebe Ayarları → Paylaşım sekmesinden yönetilir.

Sidebar yapısı

Muhasebe
├── Özet                   /accounting
├── Maliye                 /accounting/maliye
│   └── vergi kimliği · dönem ciro/KDV/stopaj · denetim izi (salt okunur)
├── İşlemler               /accounting/transactions
│   └── sekmeler: Satış · Gider · Tahsilat · Çek/Senet · Tekrarlayan
├── Cariler                /accounting/contacts
│   └── Cari detay         /accounting/contacts/[id]
├── Raporlar               /accounting/reports
│   └── sekmeler: Vergi · Gelir Tablosu · Z-Raporu · Yaşlandırma · Mali Tablolar (Pro) · Defterler (Pro)
└── Muhasebe Ayarları      /accounting/settings
    └── sekmeler: Genel · Ülke & Vergi · Hesap Planı · Kasa & Banka · Otomasyon · Paylaşım

Gelişmiş rapor sekmeleri (Raporlar → Mali tablolar / Defterler): Mizan, hesaplardan türetilen bilanço özeti ve dönemsel nakit görünümü; yevmiye listesi, fiş detayı ve işlem kaydı (audit) panelden kullanılabilir. Bu çıktılar iç yönetim ve muhasebe ofisi ile paylaşım içindir; resmi tebliğ/beyanname yerine geçmez — hukuki kullanım için yeminli mali müşavir onayı gerekir.

Hangi sekme ne işe yarar?

Özet

Net gelir, toplam gider, net kâr, KDV, nakit akışı KPI'ları ve aylık trend grafiği. Vadesi geçmiş faturalar ve son işlemler tek bakışta.

Maliye

Maliye veya dış denetim ekibi geldiğinde kullanılan salt okunur denetim dosyası. Vergi kimliği (ünvan, VKN/TCKN, vergi dairesi, MERSİS/sicil/SGK), seçili dönem ciro–KDV–stopaj özeti, tahsilat kanalları, dönem kilidi durumu ve kısa işlem kaydı (audit izi) tek ekranda. Resmi beyanname yerine geçmez.

Görünüm ayarı (kritik): Muhasebe Ayarları → Maliye sekmesinden yalnızca bu sayfada gösterilecek tutarlar için kurallar tanımlanır:

  • % / Sabit / Tavan — kalem bazında (ciro, gider, vergi; isteğe bağlı tahsilat kanalları)
  • Ürün hariç tut — seçilen menü ürünlerinin dönem cirosu Maliye toplamından düşülür
  • Kanalları ciroya kilitle — nakit/kart oranları ciro ile çelişmesin diye
  • Yuvarlama — gösterilen tutarları 10 / 100 / 1000 ₺’ye yuvarlama

Bu ayarlar gerçek muhasebe / yevmiye / POS / rapor kayıtlarını değiştirmez; yalnızca Maliye ekranı (ve dışa aktarım) görüntüsünü etkiler.

İşlemler

  • Satış: Adisyon, ürün ve ödeme tipi bazlı satış raporları.
  • Gider: Hızlı gelir-gider girişi; tax_code, kategori, kasa/banka ve cari ile ilişkilendirme.
  • Tahsilat / Tediye: Cari hesap ödeme ve tahsilat akışları (payments.js) ile listelenir ve işletme süreçlerine bağlanır.
  • Çek / Senet: Aldığınız ve verdiğiniz çek/senet takibi (cheques.js ve ilgili tablolar).
  • Tekrarlayan: Tekrar eden gelir/gider şablonları (recurring) ve planlı çalıştırma.

Cariler

Müşteri, tedarikçi, personel ve diğer carilerin yönetimi; cari hareket defteri, açılış bakiyesi, kredi limiti, VKN/TCKN, açıklama. Cari detay sayfasında borç/alacak hareketleri ve bakiye akışı görüntülenir.

Raporlar

  • Vergi: Aylık KDV/satış vergisi hesaplama (hesaplanan, indirilecek, ödenecek, devreden).
  • Gelir Tablosu: Brüt satış, COGS, brüt kâr, faaliyet giderleri, net kâr.
  • Yaşlandırma: Müşteri/tedarikçi cari bakiye yaşlandırma raporu (0-30, 31-60, 61-90, 90+).
  • Mali tablolar (gelişmiş): Mizan; hesap türlerine göre özet bilanço; seçilen döneme göre nakit/gelir-gider özeti (yönetim içi).
  • Defterler (gelişmiş): Yevmiye fişleri listesi ve detay; işlem kaydı (audit) sekmesi ile değişiklik izi.

Muhasebe Ayarları

  • Genel: Vergi kimliği (ünvan, VKN/TCKN, vergi dairesi, TR'de MERSİS/Ticaret Sicil/SGK), muhasebe para birimi, ondalık hane, stok değerleme yöntemi, çoklu para birimi, e-fatura, dönem kilidi.
  • Ülke & Vergi: Ülke paketi seçimi (TR/INT), hesap planı standardı (otomatik), locale, varsayılan vergi/stopaj oranları, mali yıl başı, vergi kodları CRUD'u (tax_codes).
  • Hesap Planı: TR_TDHP veya INT_GENERIC seed sonrası oluşan chart_of_accounts'un görüntülenmesi (Faz 1 read-only; CRUD Faz 2).
  • Kasa & Banka: Tanımlı nakit kasaları ve banka hesaplarının görüntülenmesi (Faz 1 read-only; CRUD Faz 2).
  • Otomasyon: POS adisyonlarını otomatik yevmiyeleştirme; alış faturalarını otomatik yevmiyeleştirme. Posting engine rol bazlı çalışır (Borç Kasa/Banka — Alacak Gelir + Vergi Çıkışı).
  • Maliye: Yalnızca Maliye sayfası görüntüleme kuralları (maliye_display_config): yüzde / sabit tutar / tavan (gelir, gider, vergi ve isteğe bağlı nakit/kart/yemek kartı kanalları), ürün hariç tutma, ciroya orantılı kanal kilidi, yuvarlama. Gerçek muhasebe verisine yazılmaz.
  • Paylaşım: Muhasebeci ve diğer roller için e-posta ile davet; horeca_accounting_partner_access ve accounting_has_partner_access ile scope bazlı salt okunur erişim. Davet akışı ayarlar sekmesinden yönetilir.

Veri güvenliği ve gizlilik

  • Her tablo Row Level Security (RLS) ile işletme bazında izole edilmiştir; başka bir işletme verisine erişmek mümkün değildir.
  • Üçüncü parti erişim için accounting_has_partner_access(business_id, scope) helper'ı tüm RLS politikalarına entegre edilmiştir; davet edilen muhasebeci yalnızca verilen scope'lardaki kayıtları okuyabilir.
  • Parasal alanlar dört ondalıklı (NUMERIC(18,4)) tutulur, faturalama ve mizan hesaplarında yuvarlama hatası oluşmaz.
  • Yevmiye fişlerinde borç-alacak dengesi trigger ile zorunlu kılınır; dengeli olmayan kayıt veritabanına işlenmez.

Yetkilendirme

Personel rolleri için muhasebe izinleri tanımlıdır (Personel → Roller → İzinler ekranında):

  • accounting — Özet
  • accounting/maliye — Maliye
  • accounting/transactions — İşlemler (Satış/Gider/Tahsilat/Çek/Tekrarlayan)
  • accounting/contacts — Cariler
  • accounting/reports — Raporlar (Vergi / Gelir tablosu / Z-Raporu / Yaşlandırma / Gelişmiş mali tablolar ve defterler)
  • accounting/z-report — Z-Raporu düzenleme (Raporlar sekmesi ve kasa; ince yetki)
  • accounting/settings — Muhasebe Ayarları

Her izin için ayrı görüntüleme ve düzenleme yetkisi verebilirsiniz; örneğin yalnızca raporları gören ama ayar değiştiremeyen personel rolü oluşturulabilir.

Dışa aktarma

Rapor ekranlarındaki Dışa Aktar butonu üç format sunar:

  • Excel (.xlsx) — exceljs ile başlık ve toplam satırları biçimlendirilmiş çok sayfalı çalışma kitapları.
  • PDF (.pdf) — @react-pdf/renderer ile kurumsal düzenli raporlar.
  • CSV (.csv) — UTF-8 BOM ile Türkçe karakter uyumlu, Excel ve diğer araçlarda doğrudan açılabilir.

Yol haritası, kabul kriterleri ve metrikler

Birincil persona: İşletme sahibi / operasyon müdürü (günlük ciro, cari, KDV takibi). İkincil persona: Harici muhasebeci (export, yevmiye, rapor salt okunur).

“Yeterli” tanımı (ürün kabulü örneği): Seçilen dönemde özet ve raporların tutarlı görünmesi; dönem kilidi açıkken kilitli tarihe müdahale edilememesi; cari ve raporların Excel/PDF/CSV dışa aktarılabilmesi; kritik hesap rollerinin eşlenmiş olması.

Başarı metrikleri (izlenmesi önerilen): rapor export başarı oranı; yevmiye oluşturma hatası sayısı; dönem kilidi ihlali (DB exception) sayısı; rapor sayfaları TTFB veya istemci tarafı yükleme süresi.

İlk ay senaryosu (özet)

  1. Muhasebe Ayarları → Genel: Ünvan, vergi kimliği, para birimi, e-belge tercihi ve dönem kilidi.
  2. Ülke & Vergi: Ülke paketi (TR / uluslararası), vergi kodları, varsayılan oranlar.
  3. Hesap planı & Kasa/Banka: Seed sonrası hesapları kontrol et; kasa ve banka hesaplarını tanımla.
  4. Otomasyon: POS ve alış faturası otomatik yevmiye kurallarını aç/kapat.
  5. İşlemler: Gerçek satış/gider hareketleri geldikten sonra Raporlar → Vergi ile KDV dönemini hesaplat; Gelişmiş sekmelerden mizan/yevmiye ile çapraz kontrol.

Muhasebeciye verilecek paket (checklist)

  • Cari listesi ve bakiye (Excel/PDF/CSV).
  • Seçilen dönem gelir tablosu ve yaşlandırma exportları.
  • Mizan (tarih itibarıyla) ve istenirse yevmiye listesi / fiş detayları.
  • Ayarlar özeti: ülke paketi, rapor kilit tarihi (varsa).
  • (İleride) e-belge entegrasyonu devreye girdiğinde: portal çıktıları ve platform fişlerinin mutabakat notu.

Kod tarafında adım listesi (panel yolu ve format ipuçları): ACCOUNTANT_BUNDLE_STEPS — src/lib/accounting/accountant-bundle.js.

e-Belge entegrasyonu (taslak mimari)

Üretim kullanımı hukuki ve operasyon onayı gerektirir. Teknik tarafta tipik bileşenler: sağlayıcı API kimliği ve sertifika saklama; GİB veya uluslararası eşdeğer test ortamı; gönderim kuyruğu ve idempotent iş emirleri; webhook veya yoklama ile durum senkronu; hata sınıflandırması ve yeniden deneme; denetim için immutable log.

Faz sıralaması sabiti (ürün / geliştirme planlaması): E_INVOICE_ROADMAP_PHASES — src/lib/accounting/e-invoice-roadmap.js.

Ölçek (çok şube / konsolidasyon)

Tek işletme ve tek vergi kimliği varsayımıyla optimize edilmiştir. Zincir, ayrı tüzel kişiler veya konsolide rapor ihtiyacı ürün kararı ile ayrı roadmap’e alınmalıdır; şema genişletmesi ve RLS politikaları bu karara bağlıdır.

İlgili konular

  • Adisyon ve kasa — POS satışları otomatik olarak muhasebe modülüne işlenir.
  • Stok ve tedarik — Tedarikçiler muhasebe carisine bağlanır.
  • Personel, roller ve yetkiler — Muhasebe izinlerini personele atama.
  • Raporlama ve istatistikler — Operasyonel raporlar için.

Kategori: Ekip ve güvenlik

Personel, roller ve yetkiler

Ana kaynak: HORECA ürün rehberi (Lyra SSOT) — §9.7 (Personel).

Panel

/dashboard/workspace/{slug}/personnel/management — roller, pozisyonlar, izin matrisi, ilanlar, başvurular.

Not

Personel eğitimi route’u var; içerik/CRUD placeholder (training.helpModal.p2). Genel başvuru QR: /personel-qr-basvuru/{businessSlug}/.


Kategori: Abonelik ve destek

Genel ayarlar ve abonelik

Bu bölüm ticari / hesap planı içindir — galeri, çalışma saatleri veya işletme bilgisi için İşletme ayarları (/dashboard/workspace/{slug}/settings) kullanılır.

HORECA’da yalnızca işletmeler plan öder. Üç plan vardır: Ücretsiz, Başlangıç ($25/ay), Kurumsal ($100/ay). Müşteri ve partner tarafından platform ücreti alınmaz.

Tam ürün ve sayfa haritası: HORECA ürün rehberi.

Hesap düzeyinde dil, bildirim ve planınızla ilgili tercihler bu bölümde toplanır. Faturalama ve sözleşme detayları yönetici hesabınızda veya ödeme sağlayıcı ekranında görünebilir.

Plan ve faturalama

  • Aktif planınızı ve yenileme tarihini kontrol edin.
  • Fatura ve ödeme yöntemi değişiklikleri için güvenli akışları kullanın; şifreleri paylaşmayın.

Bildirimler ve hesap bağlantıları

E-posta veya uygulama içi bildirim tercihlerinizi iş yükünüze göre ayarlayın. Ayrıntılı tercihler için panelde Bildirimler sayfası: /dashboard/user/account/notifications. Sosyal veya harici hesap bağlantıları (destekleniyorsa): /dashboard/user/account/socials.

Ödeme sayfası (plan satın alma)

Plan veya paket ödemesi tamamlanırken tarayıcıda /checkout/success veya /checkout/cancel son sayfalarına yönlendirme görmeniz normaldir; sorun yaşarsanız Destek ile iletişime geçin.

İptal ve dondurma

Politikanızda dondurma veya iptal varsa destek ile iletişime geçerek resmi süreci takip edin.


Sık sorulan sorular

Bu sayfa, işletme sahiplerinin ve ekiplerin neden, nasıl ve ne bekleyerek platformu kullanacağını anlaması için hazırlanmıştır. Klasik madde madde SSS yerine, satış ve destek görüşmelerinde çıkan sorulara paragraf halinde yanıtlar içerir; Lyra gibi asistanların da bağlamı doğru kurması için uygundur. Güncel hukuki ve fiyat metinleri için sitedeki SSS, Fiyatlandırma ve Destek sayfalarını birlikte kullanın.


Platformu tanıma ve kayıt kararı

İşletmemi neden buraya kaydetmeliyim; bana ne faydası var?

Kayıt olmak, işletmenize ait menü, operasyon ve görünürlük ayarlarını tek hesapta toplamanızı sağlar. QR menü ve dijital menü yanında adisyon, kasa, stok, rezervasyon ve personel gibi süreçleri aynı çatı altında yürütebilir; böylece müşteri tarafı ile mutfak ve kasa arasında kopukluk azalır. Ayrıca ekosistem içinde işletmenizin keşfedilebilir olması, yalnızca kendi QR kodunuzu dağıtmaktan farklı bir görünürlük katmanı sunabilir. Fayda, işletmenizin büyüklüğüne ve hangi modülleri kullandığınıza göre değişir; ilk adımda HORECA’ya giriş ve İşletme ve çalışma alanı sayfalarına bakmanız yeterlidir.

Çoğu kişi sadece “QR menü” sanıyor; platform aslında ne?

Dışarıdan bakıldığında ilk temas çoğu zaman QR ile açılan menüdür; bu yüzden “sadece QR” algısı doğaldır. Oysa HORECA; dijital menünün ötesinde sipariş, ödeme, stok, rezervasyon, personel ve raporlama gibi operasyon katmanlarını da kapsayan bir işletme platformudur. QR menü, müşterinin gördüğü uçtan görünen parçadır; arka planda menü yönetimi, masa ve alan düzeni, kasa ve yetkilendirme gibi süreçler birlikte çalışır. Bu ayrımı netleştirmek, beklentiyi doğru kurmanın en önemli parçasıdır.

Misafirleri dışarıdan işletmeye yönlendirdiğinizi söylediğinizde ne kastediyorsunuz?

Kendi müşterinize verdiğiniz QR veya link dışında, platformun işletmeleri keşfet ve benzeri herkese açık akışları üzerinden çevredeki veya ilgi alanına uygun işletmelere giden ziyaretçiler olabilir. Yani yalnızca “masadaki misafir” değil, platformu dolaşan yeni bir kitle ile de temas ihtimali vardır; bu da bir vitrin ve tanıtım katmanı olarak düşünülebilir. Kesin görünürlük kuralları ve konumlandırma, ürün güncellemeleriyle değişebileceği için güncel bilgi için Destek hattına danışılması doğrudur.

“Reklamım olacak” veya “işletmem öne çıkacak” derken neyi garanti ediyorsunuz?

Burada garanti edilen şey, tek bir sıralama veya sürekli üst sıra değildir; kastedilen, işletmenizin ekosistem içinde profil ve içerikle temsil edilebilmesi ve uygun bağlamda kullanıcıların sizi bulabilmesidir. Pazarlama ve öne çıkarma kampanyaları ürün politikasına bağlıdır. Net vaat veya ücret karşılığı özel görünürlük varsa bunlar sözleşme veya fiyat sayfasında açıkça yazılmalıdır; belirsiz kaldığında müşteriye “resmi kanaldan yazılı teyit” önerilir.

Küçük bir kafe için bu platform ağır mı kalır; her şeyi kullanmak zorunda mıyım?

Hayır. Modüller genelde ihtiyaca göre açılır; sadece menü ve QR ile başlayıp zamanla adisyon veya stok eklemek mümkündür. Küçük işletmeler için önemli olan, ilk günde tüm ekranları doldurmak değil, doğru temel ayarlarla açılış yapmaktır. İşletme genel bakış ekranından işinizi büyüttükçe derinleşebilirsiniz.


Ücret, abonelik ve şeffaflık

Ücretli olan şeyler neler; hangi başlıklar para karşılığıdır?

Genel çerçevede; plan veya paket (kullanıcı sayısı, işletme sayısı, modül erişimi), ek kapasite ve bazı entegrasyon veya premium özellikler ücretlendirilebilir. Tam liste ve güncel rakamlar için Fiyatlandırma sayfasına bakın; sözleşme öncesi ekranda gördüğünüz plan özeti bağlayıcı referanstır. Bu doküman hukuki fiyat listesi değildir.

İleride habersiz veya ek ücret kesilir mi endişesi yaşıyorum; nasıl güvence olur?

Sağlıklı yaklaşım: kayıt ve ödeme adımlarında gösterilen plan koşullarını ve e-posta ile gelen fatura özetini saklamaktır. Otomatik yenileme, modül ekleme veya limit aşımı varsa bunlar genelde arayüzde veya sözleşmede belirtilir; şüphede Destek ile “hangi kalemin ne zaman kesileceği”ni yazılı netleştirin. Bu dokümanda “asla ek ücret olmaz” denemez; ürün politikası zamanla güncellenebilir.

Aboneliği yükselttiğimde veya yeni modül eklediğimde ne değişir?

Tipik olarak daha fazla kullanıcı kotası, işletme veya şube, rapor derinliği veya entegrasyon açılır. Geçiş anında fiyat farkı, faturalama döngüsü veya orantılı ücretlendirme ödeme sağlayıcı ayarlarına göre hesaplanır; kesin kural için hesabınızdaki faturalama ekranına ve Genel ayarlar ve abonelik belgesine bakın.

Deneme veya iptal konusunda ne sormalıyım?

Ürünün o an sunduğu deneme süresi, iptal hakkı ve iade koşulları yasal ve ticari metinlerde yer alır. Kayıt öncesi Kullanım şartları ve İade politikası gibi sayfaları okuyun; özel kampanyalar farklı koşul getirebilir.


Özellik talepleri ve yol haritası

İstediğim özellik şu an yoksa ne olacak?

Öncelikle aynı ihtiyacın başka bir modül veya ayar ile çözülüp çözülmediğini kontrol etmek gerekir; çoğu zaman “yok” sanılan şey aslında farklı menüden yapılabiliyordur. Gerçekten üründe bulunmuyorsa talebiniz geri bildirim veya destek kaydı olarak kayda geçer; ürün ekibi öncelik, teknik uygunluk ve güvenlik çerçevesinde değerlendirir. Resmi taahhüt almak için Destek üzerinden talebinizi yazılı bırakın.

Özellik talep ediyorum; ekliyor musunuz?

Evet, anlamlı ve sürdürülebilir talepler yol haritasına alınabilir. Her şey eklenecek diye genel bir vaat verilemez; ancak işletmelerden gelen gerçek kullanım ihtiyaçları ürün gelişiminde önemli rol oynar. Talebinizi mümkün olduğunca ekran adı, kullanım senaryosu ve sıklık ile birlikte iletin.

Saha ekipleri “bir hafta içinde eklenir” gibi bir şey söyledi; bu her zaman geçerli mi?

Bu ifade, sık gelen ve kapsamı net olan iyileştirmeler için kullanılan yaklaşık bir hedef süre olarak anlaşılmalıdır; çoğu basit talep teknik olarak mümkünse birkaç gün ila yaklaşık bir hafta bandında değerlendirilebilir. Karmaşık entegrasyonlar, hukuki uyum veya üçüncü taraf bağımlılıkları süreyi uzatır. Kesin tarih ve kapsam için mutlaka Destek veya resmi kanaldan yazılı teyit isteyin; bu doküman bireysel satış sözü yerine geçmez.

Talebim reddedilirse neden olabilir?

Örnek nedenler: güvenlik riski, çok düşük kullanım, mevcut mimari ile çelişi, yasal kısıt veya aynı ihtiyacın başka yolla çözülmüş olması. Red durumunda genelde alternatif iş akışı veya geçici çözüm önerilir.


Ekosistem, görünürlük ve beklenti yönetimi

Sadece QR menü sanan bir işletmeye ne anlatmalıyım?

Önce müşterinin hedefini dinleyin: çoğu zaman “menüyü telefonda göstermek” ile başlar. Ardından sipariş, kasa, stok ve personel gibi konuların aynı panelde toplanabileceğini ve bunun hata ile mücadeleyi kolaylaştırdığını söyleyin. İkinci sürpriz genelde keşif ve görünürlük katmanıdır: işletmenin yalnızca kendi QR’ına bağımlı kalmadan ekosistemde temsil edilebileceği. Bu iki katmanı ayırmak, güveni artırır.

Dışarıdan müşteri yönlendirmesi duyunca insanlar neden şaşırıyor ve bunu nasıl pozitifleştiririm?

Çünkü birçok işletme yalnızca “kendi linkim ve QR’ım” ile düşünür; platformun getirdiği ek trafik veya vitrin etkisini ilk başta görmez. Bunu abartmadan, “ek görünürlük ihtimali” ve “profilinizin bulunabilir olması” şeklinde yumuşak ve dürüst anlatın; garanti vermeyin, ürünün güncel davranışını resmi kaynakla destekleyin.

Rakip veya mevcut POS / yazılımım varken HORECA ile birlikte kullanılabilir mi?

Bazı senaryolarda paralel kullanım mümkündür; bazılarında veri çift yazılması veya operasyonel karmaşa riski doğar. Entegrasyon veya veri aktarımı gerekiyorsa API dokümantasyonu ve Destek üzerinden teknik uygunluk sorulmalıdır. Bu belge entegrasyon taahhüdü vermez.


Operasyon, teknik ve güvenlik

Birden fazla şube veya markayı yönetebilir miyim?

Çoklu işletme veya workspace kullanımı ürün ve plana bağlıdır. İşletme ve çalışma alanı belgesindeki mantıkla ilerleyin; limit aşımında plan yükseltme gerekebilir.

Personel hesapları ve roller konusunda endişeliyim.

Rol tabanlı erişim, herkesin her şeyi görmesini engeller. Pratikte kasa, menü fiyatı ve raporlar ayrı yetkilere bölünebilir. Ayrıntı için Personel, roller ve yetkiler sayfasına bakın.

Veriler kimin; platform işletme verisini reklamda kullanır mı?

Genel ilkeler için Gizlilik politikası ve KVKK aydınlatma metinlerine başvurun. Satışta “veriler sizin” demek kolaydır; hukuki çerçeve bu sayfalarda tanımlıdır.

Yazıcı, tablet veya özel donanım şart mıdır?

Tamamen işletme tercihine ve kullanılan modüllere bağlıdır. Bazı ekranlar yazıcı veya terminal olmadan da kullanılabilir; kasa fişi ve mutfak yazdırma gibi senaryolarda donanım gerekir. Adisyon ve kasa belgesindeki yazıcı ayarlarına bakın.

İnternet kesildiğinde ne olur?

Web tabanlı akışlarda bağlantı şarttır; kesinti süresince gerçek zamanlı senkronizasyon etkilenir. Kritik operasyon için yedek iletişim veya offline süreç planı işletme içi politika olarak düşünülmelidir.

Kurulum ne kadar sürer?

Sadece menü ve QR ile açılış birkaç saat içinde yapılabilir; adisyon, stok ve entegrasyonlar günler veya haftalar sürebilir. Gerçekçi plan için Destek veya hesap yöneticisi ile kapsam netleştirmesi yapın.

Veriyi dışa aktarabilir veya taşıyabilir miyim?

Ürünün sunduğu dışa aktarma veya API olanakları için güncel dokümantasyona ve Destek’e danışın. Taahhüt bu belgede yer almaz.


Hızlı operasyon sorunları (kısa)

Parola sıfırlama, menü görünmeme, ödeme ve yedekleme gibi konularda önce ilgili modül belgelerine gidin:

  • Giriş: Hesap: kayıt ve giriş
  • Menü: Menü yönetimi, QR menü ve temalar
  • Ödeme: Adisyon ve kasa

Site üzerindeki geniş SSS: SSS · Yardım merkezi


Teknik notlar

Tarayıcı

Güncel Chrome, Edge veya Safari sürümleri önerilir. Eski tarayıcılarda bazı ekranlar düzgün çalışmayabilir.

Mobil

Tablet ve telefonlarda yatay/dikey kullanımda düzen değişebilir; kritik işlemler için stabil internet bağlantısı kullanın.

Çerezler ve oturum

Oturumun sürmesi için çerezlerin engellenmediğinden emin olun; gizli modda sorun yaşarsanız normal pencerede deneyin.

Performans

Çok sayıda sekme açıkken yavaşlama olabilir; uzun raporlar için tek sekmede çalışmayı tercih edin.

Geliştirici ve entegrasyon

REST veya entegrasyon ihtiyaçları için sitedeki API dokümantasyonu sayfasına bakın; bu sayfa panel menüsünde her zaman görünmeyebilir, doğrudan adres ile açılır.


Sürüm notları

Ürün güncellemeleri, iyileştirmeler ve duyurular zaman içinde yayımlanır. Ayrıntılı haberler ve ipuçları için blog bölümümüzü takip edebilirsiniz.

2026 — Dokümantasyon birleştirme

  • Tüm Türkçe docs tek dosyada toplandı: horeca-urun-rehberi.md (8 kategori, 21 bölüm).
  • Sol menü URL’leri korundu; içerik load-doc.js ile aynı dosyadan bölüm olarak yüklenir.
  • Lyra HORECA_BANK_EXTENDED kayıtları SSOT ile senkron.

Nasıl haberdar olurum?

  • Blog ve duyuru kanalları (e-posta bülteni varsa kayıt olun)
  • Panel içi bildirimler (etkinse)

Geri bildirim

Özellik isteği veya hata bildirimi için Destek üzerinden bize ulaşın; mümkün olduğunca ekran görüntüsü ve adım ekleyin.



HORECAHORECA

HORECA, otel, restoran ve kafeler için modern dijital çözümler sunan kapsamlı bir yönetim platformudur. İşletmenizi dijitalleştirin, müşterilerinize mükemmel bir deneyim sunun.

HORECA

HakkımızdaHizmetlerFiyatlandırmaSSS

Destek

Yardım Merkeziİade PolitikasıDokümantasyonAPI Referansı

Yasal

Kullanım ŞartlarıGizlilik PolitikasıÇerez PolitikasıKVKK

İletişim

İletişimhoreca@bykandil.com+90 553 741 59 33İstanbul, Türkiye

© 2026 HORECA. Tüm hakları saklıdır. - Versiyon 6-5-0