Velotab POS & ERP

Ana Modüller

13 Ana Sayfa & Tüm Alt Bileşenler

Her modülün ana sayfası, alt sayfaları, dialog pencereleri, widget'ları ve işlevleriyle eksiksiz detay.

📊

1. Özet Panel — Analytics Panel

analytics_panel.dart

📌 Sayfanın Amacı: Ana dashboard. İşletmenin genel durumunu anlık olarak gösteren metrik kartları, grafikler ve hızlı erişim widget'ları.

🔹 Alt Bileşenler & Widget'lar:

Canlı Metrik Kartları (4'lü Grid): Toplam Gelir, Toplam Gider, Net Bakiye, Anlık kasa durumu
Dönem Seçici: Günlük / Haftalık / Aylık veri filtreleme
Gelir-Gider Grafiği (fl_chart): Çubuk grafik ile dönemsel karşılaştırma
Kritik Stok Uyarı Kartı: Eşik altındaki malzemelerin listesi
Masa Doluluk Oranı: Toplam masa / dolu masa / aktif masa cirosu
Aktif Dış Kaynak Sipariş Sayacı: Platformdan gelen bekleyen sipariş sayısı
En Çok Satan Ürün ve Masa: Dönemin en yüksek cirolu ürünü ve masası
Geçmiş Kasa Listesi: Kapatılmış kasa kayıtları ve Z raporu özeti

💳

2. Adisyon & Kasa Yönetimi

finance_dashboard_page.dart (5559 satır) + cashier_dashboard_page.dart (2708 satır) + split_bill_dialog.dart

📌 Sayfanın Amacı: Tam ekran POS modülü. En kritik modül. Masa haritası, canlı sipariş, parçalı ödeme, yazıcı, dış kaynak sipariş, kasa aç/kapa/Z raporu.

🔹 4 Ana Sekme:

Sekme 1 — 🍽️ Canlı POS / Kasa

Restoran Masa Haritası: LayoutDesignerCanvas üzerinde canlı masa/doluluk gösterimi
Masa Seçimi & Aktif Sipariş Gösterimi
Ürün Ekleme Modalı: 3 panelli büyük dialog (kategori + ürün grid + sepet)
Stok Kontrolü ve İndirim Hesaplama
Kasa Kapalı Uyarısı

Sekme 2 — 📋 Geçmiş Siparişler & Detay

Sipariş Listesi: masa adı, toplam, personel, ödeme tipi
Sipariş Detay Modalı: ürün listesi, parçalı ödeme detayları
Denetim Logları: iptal/zayi/ikram işlemlerinin kaydı

Sekme 3 — 📦 Dış Kaynak & Paket Sipariş Hub'ı

Canlı Takip: 15 saniyede bir otomatik senkron
Tarih Filtreli Geçmiş: dönem, durum, ödeme, kanal filtreleri
Katalog Ürün Seçim Modalı: her kaynak için ayrı sepet
Sipariş Tamamlama Dialog'u: nakit/kart/parçalı ödeme
Kasa Vardiya Uyuşmazlık Kontrolü

Sekme 4 — 🏧 Kasa (Till Shift) Yönetimi

Kasa Durum Kartı: açık/kapalı, aktif vardiya bilgisi
Kasa Açma Dialog'u: açılış bakiyesi girme
Kasa Kapama Dialog'u: sayım bakiyesi, Z Raporu
Z Raporu: PDF indir veya yazıcıdan bastır

🧾

3. Yazarkasa Fiş Takip — Fiscal Audit Hub

fiscal_audit_hub_page.dart

📌 Sayfanın Amacı: Tüm mali fişlerin durum takibi ve yönetimi. Yazarkasa uyumluluk denetim merkezi.

Fiş Durum Filtreleri: Tümü / Bekleyen / Basıldı / Hatalı / By-pass
Fiş Tablosu: Sipariş ID, masa, tutar, ödeme tipi, fiş durumu, fiş/Z numarası, hata mesajı
Yeniden Yazdırma: Hatalı/bekleyen fişleri yeniden yazarkasaya gönderme
By-pass İşlemi: Yazarkasa arızasında fişi by-pass geçme

🥘

4. Malzemeler — Ingredients

ingredients_page.dart

📌 Sayfanın Amacı: Restoran malzeme/stok yönetimi. Satın alma, tüketim, fire kaydı ve stok hareketlerinin tam takibi.

Malzeme Listesi: ad, birim (gram/adet/ml), güncel stok, kritik eşik, son alış fiyatı, kategori
Kritik Stok Vurgulama: eşik altı malzemeler kırmızı işaretli
Stok Girişi (Satın Alma): miktar, birim fiyat, toplam maliyet
Fire Kaydı: çürüme, dökülme, son tüketim, diğer, personele verildi
Stok Hareket Geçmişi: tüm hareket tipleriyle zaman damgalı kayıtlar

📝

5. Ürünler & Reçete — Products

products_page.dart

📌 Sayfanın Amacı: Ürün tanımlama, reçete yönetimi, maliyet hesaplama ve kategori atama.

Ürün Listesi: ad, satış fiyatı, tür (recipe/direct), KDV, stok, durum
Reçete Yönetimi: ürün-malzeme çoka-çok ilişkisi
Soft Delete & Geri Yükleme
Kategori Atama (çoka-çok mapping)
Satış İstatistikleri ve İşlem Logları

📖

6. Adisyon ve Katalog — Catalog

catalog_page.dart

📌 Sayfanın Amacı: Katalog yönetimi. Ürün kategorileri, indirim kuralları, stok kontrol yapılandırması.

Kategori Listesi ve Ürün-Kategori Eşleme
İndirim Kuralı Yönetimi: yüzde, aktif/pasif, hedef atama
Stok Kontrol Ayarları: işletme bazında kısıtlama aç/kapa

🏗️

7. Restoran Dizayn — Layout

restaurant_layout_page.dart + layout_designer_canvas.dart + layout_models.dart

📌 Sayfanın Amacı: Restoranın masa/duvar/sandalye düzenini görsel olarak tasarlama ve kaydetme.

Tab 1 — Layout Tasarım: Sürükle-bırak masa, duvar çizme, sandalye yerleştirme, kaydetme
Tab 2 — Tablo Analizi: Masa bazlı ciro, sipariş sayısı, doluluk oranları
Veri Modelleri: TableModel, WallModel, ChairModel

📈

8. Gelir Kaynakları — Revenue Sources

revenue_sources_page.dart

📌 Sayfanın Amacı: Dış platform entegrasyonlarının yönetimi. Getir, Yemeksepeti gibi platformların API bağlantı ayarları.

Gelir Kaynağı Listesi ve Yeni Kaynak Ekleme
API Kimlik Bilgileri: API key, client secret, chain ID
Platform Sipariş Senkronizasyonu

🏦

9. Finans & Muhasebe — Finance Hub

finance_hub_page.dart

📌 Sayfanın Amacı: Finansal işlemlerin merkezi. Kasa hareketleri, nakit akışı, personel ödemeleri ve muhasebe raporları.

Kasa Hareketleri: giren/çıkan, kaynak, kategori, tutar
Nakit Akış Raporu ve Personel Ödemeleri
Gelir-Gider Analitiği ve Dönem Filtreleme

🔍

10. Gözlem Raporları — Insights

insights_page.dart

📌 Sayfanın Amacı: İş zekası ve raporlama merkezi. Satış trendleri, ürün performansı ve dönemsel analizler.

Satış Grafikleri: çizgi, çubuk ve pasta grafikler
Ürün/Kategori Bazlı Analiz ve Dönemsel Karşılaştırma
En Çok Satanlar ve Kasa Raporları

👥

11. Personel Yönetimi — Staff

staff_page.dart

📌 Sayfanın Amacı: Personel bilgilerinin tam yönetimi. Kimlik, maaş, izin, vardiya ve yetkilendirme.

Personel Listesi: ad, TC kimlik, telefon, rol, maaş, durum
Rol Tanımlama: owner/manager/chef/employee
PIN Kodu Atama (4 haneli), Maaş & Sigorta Yönetimi
İzin Yönetimi ve Personel Ödemeleri

⏰

12. Vardiya Yönetimi — Shift Management

shift_management_page.dart

📌 Sayfanın Amacı: Personel vardiya planlaması ve çalışma saatleri takibi.

Vardiya Şablonları: Sabah (09:00) ve Akşam (14:00)
Personel-Vardiya Eşleme, Giriş/Çıkış Kaydı
Otomatik Rotasyon ve Sabit Vardiya Desteği

🖨️

13. Yazıcı & Ayarlar — Printer Settings

printer_settings_page.dart (1557 satır) + printer_router_engine.dart

📌 Sayfanın Amacı: Tüm sistem ayarları. Yazıcı yönetimi, işletme profili, şifreler, Hugin yazarkasa entegrasyonu.

🔹 4 Sekme:

Sekme 1 — 🖨️ Yazıcılar

Yazıcı Listesi, Ekleme, Kategori-Yazıcı Eşleme
Sağlık Kontrolü (30dk), Test Sayfası, Failover

Sekme 2 — 🏢 İşletme Profili

İşletme bilgileri, vergi dairesi, VKN, adres, yetkili kişi

Sekme 3 — 🔐 Şifre Değiştirme

Yönetici ve terminal şifresi güncelleme

Sekme 4 — 🔗 Hugin S1 PC Link

IP: 192.168.1.150:4443, yazılım/donanım ID, eşleştirme, otomatik fiş

Veritabanı Mimarisi

22 Tablo • MariaDB

İlişkisel veritabanı yapısı, ACID uyumlu, foreign key constraint'ler ile veri bütünlüğü sağlanmıştır.

🏢 İşletme & Masa Yönetimi (3 tablo) ▼

businesses — İşletme kaydı. Kod, vergi, şifreler, Hugin ayarları, tasarım JSON.

businesses_tables — Masa tanımları. İşletme bazlı masa adı, sandalye sayısı.

businesses_tables_logs — Masa logları. Ekleme/silme/güncelleme denetim kaydı.

👤 Personel Yönetimi (5 tablo) ▼

employees — Personel kaydı. TC, telefon, rol, PIN, maaş, sigorta, izin.

employee_shifts — Vardiya giriş/çıkış kayıtları.

employee_leaves — İzin kayıtları. Ücretli/ücretsiz/hastalık/yıllık.

employee_payments — Personel ödemeleri. Maaş/sigorta/ek ödeme.

shift_schedules — Vardiya şablonları. Ad, saat, süre, tolerans.

📦 Ürün & Kategori (4 tablo) ▼

products — Ürünler. Ad, fiyat, tür, KDV, stok.

product_categories — Ürün kategorileri.

product_category_mappings — Ürün-kategori çoka-çok ilişkisi.

product_action_logs — Ürün işlem logları.

🥘 Malzeme & Stok (4 tablo) ▼

ingredients — Malzemeler. Birim, stok, kritik eşik, fiyat.

ingredients_category — Malzeme kategorileri.

ingredients_consumption — Stok hareketleri. Tüm tipler, eski/yeni stok.

ingredients_waste — Fire kayıtları. Neden, miktar, personel.

🧾 Sipariş & Ödeme (4 tablo) ▼

orders — Siparişler. Masa, durum, tutar, fiscal durum.

order_items — Sipariş kalemleri. Ürün, miktar, fiyat.

order_payments — Parçalı ödeme kayıtları. Bölme türü, yöntem, tutar.

order_item_actions — İptal/zayi/ikram/iade işlemleri.

💰 Finans & Kasa (4 tablo) ▼

cash_register — Kasa kayıtları. Açılış/kapanış, bakiye, Z raporu.

cash_movements — Kasa hareketleri. Kaynak, giren/çıkan, kategori.

revenue_sources — Gelir kaynakları. Platform, API key, kimlik.

revenue_source_orders — Dış kaynak siparişleri. Müşteri, adres, ödeme, fiscal.

🏷️ İndirim & Yazıcı & Log (6 tablo) ▼

discounts — İndirim kuralları. Ad, yüzde, aktif/pasif.

discount_targets — İndirim hedefleri. Ürün/kategori bazlı.

printers — Yazıcı tanımları. Bağlantı, grup, boyut.

printer_product_categories — Yazıcı-kategori eşlemesi.

system_logs — Sistem logları. Aksiyon, IP.

product_recipes — Ürün reçeteleri. Malzeme ve miktar.

Backend API

13 Route Grubu • 40+ Endpoint

Express.js ile modüler yapıda, tenant auth middleware ile korunan REST API.

Route Grubu	Endpoint Sayısı	Açıklama
/api/businesses	1	İşletme girişi (login)
/api/ingredients	~6	Malzeme CRUD, stok, fire
/api/products	~10	Ürün CRUD, reçete, kategori
/api/employees	~8	Personel CRUD, vardiya, izin, PIN
/api/orders	~8	Sipariş, ödeme, yazıcı
/api/tables	~4	Masa CRUD, layout
/api/revenue-sources	~6	Gelir kaynağı, senkron
/api/finance-hub	~6	Kasa, nakit akışı, ödemeler
/api/insights	~4	Satış istatistikleri, raporlar
/api/catalog	~5	Kategori, ürün, stok, indirim
/api/settings	~6	Profil, şifre, yazıcı, Hugin
/api/pos	~12	POS işlemleri, kasa, dış sipariş
/api/hugin-pc-link	~4	Yazarkasa sağlık, eşleştirme

🔐

Auth Middleware

Her istekte X-Business-Id ve X-Employee-Id header'larını doğrular. Tenant bazlı veri izolasyonu.

⚡

Queue Engine

Yüksek eşzamanlılık için kuyruk mekanizması. Maksimum 100 işlem chunk. 250+ eşzamanlı yazma.

Frontend Mimarisi

Flutter Desktop POS

Bloc pattern, responsive layout, erişilebilirlik ve animasyonlu arayüz.

🏗️

State Yönetimi

flutter_bloc kullanılır. İki ana Bloc: AuthBloc (işletme girişi) ve EmployeeAuthBloc (PIN girişi).

📱

Responsive Dashboard

13 navigasyon öğeli yan menü. Genişletilebilir/dar mod. Tam ekran POS. Erişilebilirlik.

🎬

Animasyonlu Giriş

3 fazlı animasyon: mavi arka plan kayar, beyaz panel yükselir, login kartı ölçeklenir. Hatalı girişte shake.

🖧

API Client (Dio)

Merkezi HTTP istemcisi. Dinamik tenant injector'lar ile otomatik header ekleme.

Öne Çıkan Özellikler

Kurumsal POS & ERP Yetenekleri

Velotab'ı diğer POS sistemlerinden ayıran güçlü özellikler.

✂️

Split Bill — Parçalı Ödeme Motoru

3 bölme türü: Ürün Bazlı, Eşit Bölme, Özel Tutar. Nakit/Kart/Diğer ödeme yöntemleri.

🔄

Dış Kaynak Sipariş Entegrasyonu

15sn otomatik senkron, API key yönetimi, müşteri bilgisi, fiscal takip.

📋

Stok & Reçete Kontrolü

Reçete bazlı otomatik stok düşümü, kritik eşik uyarısı, satış engelleme.

🏷️

Akıllı İndirim Motoru

Ürün/kategori bazlı kurallar, en iyi indirim otomatik seçimi.

🖨️

Akıllı Yazıcı & Failover

Kategori bazlı yönlendirme, 30dk sağlık kontrolü, yedek yazıcı.

🧾

Hugin PC Link (Yazarkasa)

Otomatik fiş, durum takibi, bypass, sağlık kontrolü.

🏧

Kasa (Till Shift) Yönetimi

Açılış/kapanış, Z raporu, kasa açığı/fazlası tespiti.

👤

Personel PIN & Yetkilendirme

4 haneli PIN, rol bazlı yetki, çift faktörlü giriş.

🎨

Restoran Dizayn

Sürükle-bırak masa/duvar/sandalye tasarımı, canlı önizleme.

♿

Erişilebilirlik

Yüksek kontrast, metin büyütme, sidebar daraltma, renk körü dostu.

Üç Katmanlı Kurumsal Yapı

Flutter Frontend

Node.js Backend

MariaDB

Frontend (Flutter)

Backend (Node.js)

13 Ana Sayfa & Tüm Alt Bileşenler

1. Özet Panel — Analytics Panel

🔹 Alt Bileşenler & Widget'lar:

2. Adisyon & Kasa Yönetimi

🔹 4 Ana Sekme:

3. Yazarkasa Fiş Takip — Fiscal Audit Hub

4. Malzemeler — Ingredients

5. Ürünler & Reçete — Products

6. Adisyon ve Katalog — Catalog

7. Restoran Dizayn — Layout

8. Gelir Kaynakları — Revenue Sources

9. Finans & Muhasebe — Finance Hub

10. Gözlem Raporları — Insights

11. Personel Yönetimi — Staff

12. Vardiya Yönetimi — Shift Management

13. Yazıcı & Ayarlar — Printer Settings

🔹 4 Sekme:

22 Tablo • MariaDB

13 Route Grubu • 40+ Endpoint

Auth Middleware

Queue Engine

Flutter Desktop POS

State Yönetimi

Responsive Dashboard

Animasyonlu Giriş

API Client (Dio)

Kurumsal POS & ERP Yetenekleri

Split Bill — Parçalı Ödeme Motoru

Dış Kaynak Sipariş Entegrasyonu

Stok & Reçete Kontrolü

Akıllı İndirim Motoru

Akıllı Yazıcı & Failover

Hugin PC Link (Yazarkasa)

Kasa (Till Shift) Yönetimi

Personel PIN & Yetkilendirme

Restoran Dizayn

Erişilebilirlik

Uçtan Uca Süreçler

🛒 Sipariş Alma Süreci

💳 Parçalı Ödeme Süreci

📦 Dış Kaynak Sipariş Süreci

🔐 Giriş Süreci

Harici Sistem Bağlantıları

Ağ Yazıcıları

Hugin S1 PC Link

Dış Platformlar

Kullanılan Teknolojiler

Flutter 3.12

Node.js

MariaDB

Dio + Bloc

fl_chart

pdf + printing

window_manager

equatable