Yardım merkezi, tek yerde.

01 Genel Mimari

Hybrid Kantar; Windows masaüstü üzerinde çalışan DevExpress arayüzlü bir uygulamadır. Saha tarafında seri port (COM) indikatörleri ve Hikvision IP kameralar ile, merkez tarafında SQL Server veritabanı ile konuşur.

Bileşenler

İstemci uygulama: .NET 8 Windows masaüstü, DevExpress UI.
Veritabanı: SQL Server (yerel veya merkezi).
Saha donanımı: RS232/TCP indikatörler, Hikvision kameralar (ANPR destekli).
Bulut servisleri: Hybrid API sunucusu (mail, DBA), Patch API, Entegrasyon API.
Bildirim kanalları: Telegram Bot API, SMTP e-posta.

02 Modüller ve Lisanslama

Sistem; 15 modül üzerine kuruludur. Modül durumları Sistem Ayarları → Modül Parametreleri sekmesinde görüntülenir. Aktif modüller lisans bilgilerine göre belirlenir.

Modül listesi

#	Modül	Açıklama
1	Ödeme Takibi	Tartım formunda "Ödendi/Ödenmedi" kutusu · liste filtresi · ödenmemiş tamamlanmış tartımda fiş / PDF / mail engeli · sadece Normal Tartım'da düzenlenebilir
2	Ambalaj Giriş Sistemi	Tartım formunda ambalaj seçimi · ambalaj ağırlığı net hesaba dahil
3	Script / API Entegrasyonu	Otomasyon kuralları yönetimi · API çağrısı · URL tetikleme · SQL script · Telegram mesajı · engelleme kuralları
4	DBA İşlemleri	DBA menüleri · DBA Onay Formu · VGM alanları · DBA belge no üretimi · VGM servis kontrolü · DBA tartım istatistikleri
5	DBA Belge Birleştirme	Tartım listesinden toplu belge birleştirme
6	Sunucu Entegrasyonu / Şubeli Yapı	Açılışta otomatik sync · firma / ürün / araç / sözleşme / tartım merkeze gönderim · şube kodu ile çalışma · vergi no zorunluluğu
7	Müşteri Tartım Takibi (Web)	Web portal entegrasyonu (masaüstüde modül bayrağı · web tarafı ayrı servis)
8	Telegram Bildirimleri	Otomatik 1. / 2. / DBA tartım bildirimi · manuel gönderim · PDF fiş eki · firma bazlı chat ID
9	Cari / Ürün Senkronizasyonu	Harici muhasebe DB bağlantısı · firma ve ürün eşleme · dashboard sync butonları
10	Depo Yönetimi ve Raporları	Depo tanımları · tartımda depo seçimi · firma / depo raporu
11	Kamera Yönetimi	Kamera ayarları menüsü · ana ekranda canlı görüntü · ANPR plaka tanıma · kamera web arayüzü açma
12	Kameralı Normal Tartım	"Kamera Kullan" işaretli araç tipleri · 2. tartımda fotoğraf snapshot · kameralı kantar fişi raporu
13	Yapay Zeka Raporlama	Dashboard'da tek yıl / çok yıllı analiz · HTML rapor tarayıcıda · OpenAI entegrasyonu
14	WhatsApp Bildirimleri	Otomatik 1. Tartım / 2. Tartım / DBA tartım bildirimi · PDF fiş eki · firma bazlı WhatsApp numarası · WhatsApp Business API
15	Paraşüt E-Fatura Entegrasyonu	OAuth 2.0 API bağlantısı · tartım sonrası otomatik e-fatura · ürün / cari eşleme · GİB uyumlu fatura gönderimi · auto-retry · PARASUT_MANAGEMENT lisansı

03 Sistem Ayarları

Sistem Ayarları formu 5 sekmeden oluşur: Genel Bilgiler, Sistem Parametreleri, DBA Yetki Belgesi, Modül Parametreleri, Lisans Bilgileri. Firma adı, vergi no, mail ayarları, ağırlık eşikleri, yazdırma tercihleri ve API anahtarı bu ekrandan yönetilir.

04 Tartım İşlemleri

Normal Form: tam özellikli tartım ekranı. Basit Form: sadeleştirilmiş arayüz. Akış: firma seç → plaka (manuel/ANPR) → 1. tartım → kayıt → 2. tartım → net hesabı → yazdırma / bildirim / sync.

05 DBA / VGM İşlemleri

DBA İşlemleri modülü + DBA TARTIM araç tipi + VGM kullanıcı hesabı gerekir. SOLAS uyumlu VGM tespiti, belge no üretimi, UDHB/VGM servisi, kamera snapshot ve bildirim akışı.

06 Bildirim Kanalları

Telegram: otomatik 1./2./DBA tartım bildirimi, PDF fiş eki, firma bazlı chat ID. E-posta: Hybrid bulut mail API. WhatsApp: yol haritasında.

07 Yazdırma ve PDF

2. tartım sonrası otomatik/manuel yazdırma, PDF export, kameralı fiş, kopya sayısı ayarı. DevExpress rapor motoru kullanılır.

08 Kamera ve Plaka Tanıma (ANPR)

Hikvision IP kameralar, ISAPI alert stream ile ANPR, canlı preview, tartımda snapshot. Veritabanı Ayarları → Kamera sekmesinden yapılandırılır.

09 Sunucu Entegrasyonu

Push: araç türleri, firmalar, tartımlar, audit log. Pull: müşteri/sözleşme güncellemeleri, otomasyon kuralları. Açılışta, CRUD sonrası ve manuel tetikleme.

10 Otomasyon Kuralları

Script / API Entegrasyonu modülü ile Telegram, HTTP API, URL tetikleme, SQL script ve engelleme kuralları. Paraşüt Muhasebe entegrasyonu PARASUT_MANAGEMENT lisansı ile.

11 Yapay Zeka Raporlama

Dashboard'da tek yıl / çok yıllı AI analizi, OpenAI GPT ile firma performans yorumu, anomali tespiti ve ağırlık tahmini. HTML rapor tarayıcıda açılır.

12 Kullanıcı Yetkileri

Toplam 46 yetki beş grupta tanımlıdır: Sistem, Tanımlamalar, İşlemler, Raporlar, Görünüm & Veri Erişimi.

Görünüm & Veri Erişimi

Sözleşme Fiyatı Göster
Ambalaj Görünümü
Ödeme Görünümü
DBA / VGM Giriş Alanları
Depo Giriş / Çıkış
Silinmiş Kayıtları Görüntüleme
Tüm Kullanıcı Kayıtlarına Erişim
Manuel 1. Tartım
Manuel 2. Tartım
Form Tasarımlarını Düzenleme
Ağırlık Eşik Uyarıları

13 Veritabanı / Seri Port / Kamera Ayarları

SQL Server bağlantısı, Access migrasyonu, çoklu COM profili, kamera IP/ANPR ayarları ve yerel yapılandırma dosyası.

14 Modül Etkileşim Matrisi

Hangi modül / ayar hangi özelliği nasıl etkiliyor? InteractionMatrixRows tablosunda 24 satır seed verisi mevcuttur.

Ayar / Modül	Etkilediği özellik	Davranış
Varsayılan Tartım Formu	Yeni Tartım butonu	Normal veya Basit tartım formu açılır.
Varsayılan Araç Türü	Yeni tartım açılışı	Seçili araç türü otomatik olarak gelir.
Kantar Kontrolü (WKontrol)	Tartım kaydı	Kamera ve indikatör kontrolü zorunlu; sadece yetkili kullanıcı değiştirebilir.
Minimum Konteyner Ağırlığı	Tartım giriş alanı	Eşik altı konteyner ağırlığında uyarı / engel.
Minimum Konteyner Payload	Tartım giriş alanı	Net yük belirlenen eşik altında ise uyarı.
Maksimum Araç Ağırlığı	Tartım + ana ekran seri port	Brüt aşımında uyarı; ana ekranda seri port eşik uyarısı.
Ödeme Takibi	Fiş, PDF, mail gönderimi	Ödenmemiş ve tamamlanmış tartımda fiş yazdırma / PDF / mail engellenir.
Ambalaj Giriş Sistemi	Tartım net ağırlık hesabı	Ambalaj seçildiğinde net ağırlığa otomatik dara katılır.
DBA İşlemleri	Menüler ve onay formu	DBA / VGM akışı, belge no üretimi ve servis kontrolü aktifleşir.
DBA Belge Birleştirme	Tartım listesi	Seçili kayıtların belgelerini tek PDF'te birleştirir.
Sunucu Entegrasyonu	Tüm CRUD işlemleri	Açılışta + her CRUD sonrası merkez sunucuya otomatik sync.
Müşteri Tartım Takibi (Web)	Web portal entegrasyonu	Tartımlar müşterinin kendi portalında canlı görünür.
Telegram Bildirimleri	Kayıt sonrası bildirim	1./2./DBA tartım sonrası otomatik metin veya PDF fiş gönderimi.
Cari / Ürün Senkronizasyonu	Firma ve ürün listeleri	Muhasebe DB'sinden firma + ürün eşlenir, sync butonları aktifleşir.
Depo Yönetimi	Tartım formu	Depo seçim alanı görünür; depo bazlı raporlar açılır.
Kamera Yönetimi	Ana ekran + araç tipi listesi	Canlı görüntü kartı görünür; "Kamera Kullan" araç tipleri filtrelenebilir.
Kameralı Normal Tartım	Araç tipi seçimi	IsCamera işaretli araç tipleri listede görünür; 2. tartımda snapshot alınır.
ANPR Plaka Tanıma	Tartım plaka alanı	Hikvision ISAPI alert stream ile plaka otomatik doldurulur.
DirectPrint (Sessiz Yazdırma)	2. tartım sonrası	Yazıcı seçim penceresi açılmadan varsayılan yazıcıya basılır.
QuestionPrint	2. tartım sonrası	Kullanıcıya "Yazdırılsın mı?" sorulur.
Yazdırma Sayfa Sayısı	Fiş kopya adedi	Belirlenen kopya sayısı kadar fiş basılır (varsayılan: 1).
2. Tartım Büyük Kontrolü	Tartım kaydı	2. tartım 1.'den büyükse otomatik yeni kayıt oluşturulur.
Yapay Zeka Raporlama	Dashboard	Tek yıl / çok yıllı AI analiz raporu HTML olarak açılır.
Script / API Entegrasyonu	Tüm tartım yaşam döngüsü	Tanımlı kurallara göre URL, API, SQL, Telegram veya engel tetiklenir.

FL Sahadan buluta tek akış.

Tartım, doğrulama, belge üretimi ve bildirim süreçleri görünür, ölçülebilir ve otomatik hale gelir.

F01 Tartım Akışı

flowchart TD A[Firma & Araç Seç] --> B{Plaka Manuel mi?} B -- Hayır --> C[ANPR · Hikvision Plaka Tanıma] B -- Evet --> D[Manuel Plaka] C --> E[1. Tartım · Seri Port / Manuel] D --> E E --> F[Kayıt Oluştur] F --> G[Telegram 1. Tartım Bildirimi] F --> H[Sunucu Sync] G --> I[Araç Geri Döner] H --> I I --> J[2. Tartım · Net Hesabı] J --> K[Otomatik / Sorarak Yazdır] J --> L[Telegram PDF Fiş] J --> M[Sunucu Sync]

F02 DBA / VGM Akışı

flowchart TD A[DBA Araç Tipi Seçildi] --> B[Tartım Tamamlandı] B --> C[DBA Onay Formu Açılır] C --> D[Belge No Üret] D --> E[PDF Belgesi Oluştur] E --> F[UDHB / VGM Servisi] F --> G{Servis OK?} G -- Evet --> H[Kamera Snapshot] G -- Hayır --> I[Hata Bildir] H --> J[Telegram / Mail Gönder]

F03 Modül Etkileşim Şeması

flowchart LR T[Tartım İşlemleri] --> OD[Ödeme Takibi] T --> AM[Ambalaj] T --> DEP[Depo] T --> KAM[Kamera + ANPR] T --> YAZ[Yazdırma / PDF] T --> DBA[DBA İşlemleri] DBA --> BIRLES[DBA Belge Birleştirme] T --> TEL[Telegram Bildirim] T --> MAIL[E-posta] T --> SCR[Script / API] T --> SUN[Sunucu Sync] SUN --> WEB[Müşteri Portalı] CARI[Cari / Ürün Sync] --> T SCR --> OTO[Otomasyon Kuralları] DASH[Dashboard] --> AI[Yapay Zeka Raporlama]