Mubisoft Dokümantasyon Merkezi

Genel Bakış

Mubisoft, Türkiye'deki KOBİ ve kurumsal firmaların yerel veritabanlarına (Logo Tiger, Mikro, Netsis, Nebim, MSSQL/MySQL/PostgreSQL vb.) port açmadan mobil ve web üzerinden erişmesini sağlayan, AI destekli bir iş zekası (BI) platformudur.

Tek cümleyle: "ERP'nizden 5 dakikada WhatsApp'a KVKK uyumlu rapor - 10 uzman AI ajanıyla."

Bu dokümanı kimler okumalı?

• Firma yöneticileri: Hangi modülleri açacağınızı, paket farklarını anlamak için → Paketler
• Sistem yöneticileri: Agent kurulumu ve bağlantı profilleri için → Kurulum
• Rapor yazarları: SQL, parametre, kolon yapılandırması için → Raporlar
• Geliştiriciler: REST API ile entegrasyon için → REST API

Mimari

Mubisoft 4 ana bileşenden oluşur. Hiçbir bileşen yerel veritabanınıza dış dünyadan erişim sağlamaz; tüm bağlantılar agent'tan dışarı doğru kurulur.

Veri Akışı

1. Mobil uygulama → Relay'e client:query_request gönderir.
2. Relay → ilgili firmanın online agent'ına yönlendirir.
3. Agent → yerel DB'de sorguyu çalıştırır, sonucu 500 satırlık chunk'lar halinde stream eder.
4. Relay → mobil istemciye chunk'ları aynen iletir.
5. Mobil → ilk chunk gelir gelmez tabloyu doldurmaya başlar (canlı akış).

Hesap & Lisans

Mubisoft hesap hiyerarşisi 4 seviyelidir:

Super Admin (Mubisoft)
  └── Bayi (Dealer)
        └── Firma
              ├── Kullanıcılar
              └── Agent'lar

Lisans Anahtarı

Lisanslar MUBI-XXXX-XXXX-XXXX-XXXX formatındadır. İlk aktivasyonda agent makinesinin donanım parmak izine bağlanır (CPU + Anakart + MAC kombinasyonu, 2/3 eşleşme toleransı). Aylık 2 transfer hakkı vardır.

3 Günlük Ücretsiz Demo (self-servis)

Ücretsiz demo başlatmak için kart bilgisi gerekmez. Akış:

1. Şirket adı, ad-soyad, e-posta ve şifre ile formu doldurun.
2. E-postanıza gelen onay bağlantısına tıklayın.
3. Hesabınız anında oluşturulur: firma + firma yöneticisi (firm_admin) kullanıcı + 3 günlük deneme lisansı. Otomatik giriş yapılır.
4. Kurulum sihirbazı sizi adım adım yönlendirir (agent kur → bağlantı profili → ilk rapor).

Demo'da tüm özellikler açıktır; yalnızca kullanım kotaları küçüktür (2 kullanıcı · 1 agent · 10 rapor · 50 AI isteği) ve süre 3 gündür. Süre dolduğunda rapor çalıştırma kilitlenir (LICENSE_EXPIRED) ve yükseltme ekranına yönlendirilirsiniz - verileriniz korunur. Rehberli/kurumsal kurulum için demo talep formu da kullanılabilir (super admin onaylı, aynı 3 günlük tam-özellik demo).

Windows Agent Kurulumu

Sistem gereksinimleri: Windows 7 SP1 / Server 2008 R2 ve üzeri · .NET Framework 4.5+

Adım 1 - İndirin ve Kurun

1. İndirme sayfasından MubisoftAgentSetup.exe dosyasını indirin (~25 MB).
2. Sihirbazı çalıştırın. Yönetici yetkisi gerekir (NT servisi kurulumu için).
3. Kurulum sonrası tray ikonu görev çubuğunda belirir.

Adım 2 - Lisansı Etkinleştirin

Tray ikonuna sağ tıklayın → Lisans → Anahtarınızı yapıştırın. Aktivasyon başarılı ise yeşil onay alırsınız.

Adım 3 - Bağlantı Profili Ekleyin

Tray → Bağlantı Profilleri → Yeni Profil. Sürücü tipini seçin (MSSQL, MySQL, PostgreSQL, OLE DB, ODBC). Bağlantı dizginizi DPAPI ile şifrelenmiş olarak yerel cihazda saklanır - sunucuya iletilmez.

Adım 4 - Otomatik Bağlantı

Agent, tray başlatıldıktan sonra otomatik olarak Relay'e bağlanır. Yeşil ikon = çevrimiçi.

Linux Agent Kurulumu

Desteklenen dağıtımlar: Ubuntu 20.04+ · Debian 11+ · CentOS 8+ · RHEL 8+ · Rocky Linux · AlmaLinux (linux-x64 + linux-arm64)

1. Tek Satırla Kurulum (önerilen)

curl -fsSL https://releases.mubisoft.com/agent/linux/install.sh | sudo bash

Script bağımlılıkları (curl, libicu) kontrol eder, en son agent sürümünü Cloudflare R2'den indirir, SHA256 ile doğrular, /opt/mubisoft/bin/'e kurar, mubisoft sistem kullanıcısı oluşturur ve systemd servis dosyasını yazar. Ayrıca /usr/local/bin/mubisoft-agent sembolik linki ile komut PATH'a eklenir.

1b. Paket Yöneticisi ile Kurulum (.deb / .rpm)

Tek satırlık kurulum yerine standart Linux paket yöneticisini tercih ediyorsanız:

# Debian / Ubuntu (.deb)
wget https://releases.mubisoft.com/agent/linux/latest/mubisoft-agent_amd64.deb
sudo dpkg -i mubisoft-agent_amd64.deb
sudo apt-get install -f   # bağımlılık eksikse tamamla

# Fedora / RHEL / Rocky / AlmaLinux (.rpm)
wget https://releases.mubisoft.com/agent/linux/latest/mubisoft-agent.x86_64.rpm
sudo dnf install ./mubisoft-agent.x86_64.rpm
# veya: sudo rpm -i mubisoft-agent.x86_64.rpm

Paket kurulumu sonrası sudo mubisoft-agent setup ile aktivasyon adımına geçin. Paket kaldırma:

# Debian - config'i koru
sudo apt remove mubisoft-agent
# Debian - tamamen sil (config + log + data)
sudo dpkg -P mubisoft-agent

# RPM - kaldır
sudo rpm -e mubisoft-agent

2. Renkli İnteraktif Kurulum (Önerilen)

sudo mubisoft-agent setup

5 adımlı sihirbaz: API/Relay URL onayı → agent adı → web panelden alınan agent anahtarı (gizli prompt) → bağlantı profili (driver seçimi + connection string + canlı test) → systemd servisi etkinleştirme. Her adımda Enter ile varsayılana geçilebilir, doğrulama otomatik.

3. Tek Komutluk Aktivasyon (CI/script için)

sudo mubisoft-agent register --token <AGENT_KEY> --name PROD-DB-01

Agent anahtarını Web Panel → Agent'lar → "Yeni Anahtar Oluştur" butonundan alın. Üretilen uzun JWT 30 gün geçerlidir, tek bir bilgisayara bağlanır (fingerprint binding).

4. Bağlantı Profili Yönetimi

# Yeni profil ekle (driver: mssql/mysql/postgres/odbc)
sudo mubisoft-agent profiles add \
  --name accounting --driver mssql \
  --connection-string 'Server=10.0.0.5;Database=Logo;User Id=mubi;Password=...;TrustServerCertificate=true'

# Listele (parolalar maskelenir)
sudo mubisoft-agent profiles list

# Bağlantıyı test et
sudo mubisoft-agent profiles test --name accounting

# Profili sil
sudo mubisoft-agent profiles remove --name accounting

5. Servis Yönetimi

# Mubisoft CLI üzerinden (systemctl ezberlemek yok)
sudo mubisoft-agent service start
sudo mubisoft-agent service stop
sudo mubisoft-agent service restart
sudo mubisoft-agent service status
sudo mubisoft-agent service enable    # boot'ta otomatik başlat
sudo mubisoft-agent service disable   # boot başlatmasını kapat

# Direkt systemctl ile aynısı
sudo systemctl status mubisoft-agent

6. Loglar

# Canlı log akışı (tail -f tarzı)
sudo mubisoft-agent logs --follow

# Son N satır
sudo mubisoft-agent logs -n 200

# systemd journal
sudo journalctl -u mubisoft-agent -f

Log dosyaları /var/log/mubisoft/agent-YYYYMMDD.log altında, 10 MB rolling, 14 gün retention.

7. Durum Kontrolü

sudo mubisoft-agent status

Agent ID, isim, kayıt durumu, lisans bilgileri (paket / expire / grace period) ve tanımlı bağlantı profillerini tek ekranda gösterir.

8. Kaldırma

# Tamamen kaldır (servis + binary + yapılandırma + loglar + sistem kullanıcısı)
sudo mubisoft-agent uninstall

# Veriyi koru, sadece servis + binary'yi kaldır (downgrade/yeniden kurulum için)
sudo mubisoft-agent uninstall --keep-data

# Onay sormadan (CI/script)
sudo mubisoft-agent uninstall --yes

Dosya Yerleşimi

• /opt/mubisoft/bin/mubisoft-agent - self-contained binary (~84 MB)
• /usr/local/bin/mubisoft-agent - PATH için sembolik link
• /etc/mubisoft/agent.json - yapılandırma (kimlik, JWT)
• /etc/mubisoft/profiles.dat - AES-256-GCM şifreli bağlantı profilleri
• /etc/mubisoft/vault.key - vault şifre anahtarı (chmod 600)
• /var/log/mubisoft/ - günlük log dosyaları
• /etc/systemd/system/mubisoft-agent.service - systemd unit (NoNewPrivileges + ProtectSystem hardening)

🛠️ Sorun Giderme

sudo systemctl status mubisoft-agent --no-pager -l
sudo journalctl -u mubisoft-agent -n 80 --no-pager

Destek

Yukarıdaki adımlar sorunu çözmediyse, log dosyasını ekleyerek bize ulaşın:

sudo journalctl -u mubisoft-agent --since "1 hour ago" --no-pager > /tmp/agent-debug.log
# /tmp/agent-debug.log dosyasını destek@mubisoft.com'a iletin

macOS Agent Kurulumu

Desteklenen: macOS 11 (Big Sur) ve üzeri · Apple Silicon (M1/M2/M3/M4) + Intel. İki dağıtım vardır: masaüstü için menü çubuğu uygulaması, sunucu için terminal (daemon) kurulumu.

A. Menü Çubuğu Uygulaması (masaüstü — önerilen)

Mac'inizin işlemcisine göre indirin (indirme sayfası doğru sürümü otomatik seçer): Apple Silicon (M1/M2/M3/M4) · Intel. İşlemcinizi Apple menüsü → Bu Mac Hakkında'dan ya da Terminal'de uname -m (arm64 = Apple Silicon, x86_64 = Intel) ile görebilirsiniz.

1. İşlemcinize uygun .zip'i indirin, açın.
2. Mubisoft Agent.app'i /Applications klasörüne sürükleyin.
3. Açın → sağ üst menü çubuğunda Mubisoft ikonu belirir → "Firma Değiştir" sekmesinden web panel agent anahtarını girip "Etkinleştir"e basın.
4. Menü çubuğu → "Açılışta başlat" ile oturum açıldığında otomatik çalışmasını sağlayın.

Uygulama Windows tray arayüzünün birebir karşılığıdır: Durum · Bağlantı Profilleri (sihirbaz + test) · Sunucu Ayarları · Firma Değiştir · WhatsApp Web (QR + mesaj/story) · Loglar. Güncelleme menüden "Güncellemeleri Denetle" ile yapılır.

xattr -dr com.apple.quarantine "/Applications/Mubisoft Agent.app"

B. Terminal / Daemon Kurulumu (sunucu)

GUI'siz Mac sunucular için. Script mimariyi (uname -m) otomatik tespit eder, doğru universal olmayan binary'yi R2'den indirir, SHA256 ile doğrular, launchd servisi olarak kurar:

curl -fsSL https://releases.mubisoft.com/agent/macos/install-macos.sh | sudo bash

/opt/mubisoft/bin/'e kurar, _mubisoft sistem kullanıcısı oluşturur, /Library/LaunchDaemons/com.mubisoft.agent.plist launchd servisini yazar ve /usr/local/bin/mubisoft-agent sembolik linkini ekler.

C. Aktivasyon ve Yönetim (daemon)

# İnteraktif kurulum sihirbazı
sudo mubisoft-agent setup

# veya tek komutla aktivasyon
sudo mubisoft-agent register --token <AGENT_KEY> --name PROD-MAC-01

# Bağlantı profili (driver: mssql/mysql/postgres/odbc)
sudo mubisoft-agent profiles add --name accounting --driver mssql \
  --connection-string 'Server=10.0.0.5;Database=Logo;User Id=mubi;Password=...;TrustServerCertificate=true'

# Servis yönetimi (launchd'yi sizin yerinize çağırır)
sudo mubisoft-agent service start | stop | restart | status | enable | disable

# Canlı log
sudo mubisoft-agent logs --follow

# Kaldırma
sudo mubisoft-agent uninstall            # tamamen
sudo mubisoft-agent uninstall --keep-data # yapılandırmayı koru

Notlar

• Sürücüler: MSSQL · MySQL · PostgreSQL kutudan çalışır. ODBC için Mac'te brew install unixodbc + ilgili veritabanının ODBC sürücüsü gerekir. Excel/Access (OleDb) macOS'ta desteklenmez (Windows'a özel teknoloji) - Excel verisi için bu makinede bir Windows agent kullanın.
• WhatsApp Web: Menü çubuğu uygulamasında "WhatsApp Web" sekmesindeki "WhatsApp'ı Etkinleştir" butonu Chromium'u (~150 MB) indirir, sonra QR ile bağlanırsınız. Daemon kurulumunda Chromium otomatik iner.
• Dosya yerleşimi: /opt/mubisoft/bin (binary) · /etc/mubisoft (yapılandırma + AES-256-GCM şifreli profiller) · /var/log/mubisoft (loglar).

Mobil Uygulama

iOS (App Store) ve Android (Play Store) mağazalarından Mubisoft uygulamasını indirin. Web panelinden oluşturduğunuz e-posta + şifre ile giriş yapın. Cihaz tokeni FCM üzerinden push bildirimleri için kaydedilir.

Çevrimdışı Önbellek

Son görüntülenen 50 rapor SQLite ile cihazda saklanır. Agent çevrimdışı iken son veri zaman damgasıyla gösterilir.

Bildirim Tercihleri

• Agent çevrimiçi/çevrimdışı uyarısı
• Yeni rapor eklendi
• KPI alarmı tetiklendi
• Uzun süren sorgu tamamlandı
• Lisans bitiş uyarısı

Bağlantı Profili

Bağlantı profilleri raporlar ile gerçek bağlantı dizgilerini ayıran soyutlama katmanıdır. Web paneli yalnızca profil adını bilir; bağlantı dizgisi (ip, kullanıcı adı, şifre) asla sunucuya iletilmez - agent makinesinde DPAPI ile şifrelenmiş olarak kalır.

Çoklu Agent

Bir firma birden fazla agent kullanabilir (örn. ACCOUNTING-PC, WAREHOUSE-PC). Her agent farklı profilleri destekleyebilir. Mobil kullanıcı agent seçerek hangi profillere erişeceğini belirler.

Desteklenen Veritabanları

Rapor Oluşturma

Web panelde Raporlar → Yeni Rapor'a gidin. Üç yol vardır:

1. Manuel: SQL'inizi Monaco editörüne yazın.
2. Sorgu Ajanı: Türkçe açıklayın → AI parametreli SQL üretir.
3. Şablon Ajanı: ERP'nize uygun hazır şablonu içe aktarın.

Adım Adım

1. Başlık ve isteğe bağlı kategori girin.
2. Bağlantı profilini seçin (örn. muhasebe_db).
3. SQL editörüne sorgunuzu yazın. {{PARAM}} placeholder'ları otomatik tespit edilir.
4. Önizleme butonuna basın → ham sonuç tabloda görünür.
5. Kolon Yapılandırıcı ile sütunları düzenleyin (sıralama, başlık, format, alt toplam).
6. Kaydedin. Rapor anında mobil ve web'de görünür.

Parametre Sözdizimi

Parametreler {{NAME::TYPE::DEFAULT::REQUIRED}} formatında SQL'e gömülür:

SELECT * FROM sales
WHERE sale_date BETWEEN {{BAS::DATE::[%NOW%-30d@yyyy-MM-dd]::TRUE}}
                    AND {{BIT::DATE::[%NOW%@yyyy-MM-dd]::TRUE}}
  AND status IN ({{STATUS::MULTISELECT::Aktif,Beklemede::FALSE}})

Tarih Makroları

Bağlı (Cascading) Parametreler

Bir LIST_QUERY başka bir parametreye bağlı olabilir:

{{COUNTRY::LIST_QUERY::"SELECT id,name FROM countries"::TRUE::id::name}}
{{CITY::LIST_QUERY::"SELECT id,name FROM cities WHERE country_id={{COUNTRY}}"::TRUE::id::name}}

COUNTRY değişince CITY listesi otomatik yeniden yüklenir.

Kolon Yapılandırıcı

Sürükle-bırak arayüzü ile kolonları 4 alana ayırın:

• Görünür: Mobil/web'de gösterilir. Sıralama, başlık adı, format, genişlik düzenlenir.
• Gizli: Tabloda görünmez ama veriyi taşır (drill-down için).
• Alt Toplam: Sayısal sütunda en alta toplam satırı eklenir. Mobilde, web'de ve PDF/Excel'de uygulanır.
• Parametre Kolonu: Drill-down tetikleyici - alt rapora gönderilir.

Format Örnekleri

Alt Raporlar (Drill-down)

Bir rapor satırına tıklayarak ilgili detayları gösteren alt raporlar tanımlayabilirsiniz. Örnek: müşteri listesinde bir müşteriye dokunun → o müşterinin tüm faturaları açılsın.

Manuel Bağlama

1. Üst rapora gidin → Alt Raporlar sekmesi.
2. Tetikleyici sütunu seçin (örn. customer_id).
3. Alt raporu seçin. Alt raporun parametrelerine üst rapor sütunlarını bağlayın.

Drill-down Ajanı (AI)

AI Ajanı veritabanındaki foreign key ilişkilerini analiz edip "Bu rapora bağlanabilecek alt raporlar" listesi sunar. Tek tıkla otomatik oluşturulur.

PDF / Excel / Paylaş

Rapor sonucunu üç şekilde dışa aktarabilirsiniz:

• Excel (.xlsx): Kolon yapılandırması (gizli kolonlar atılır), alt toplam, format dahil.
• PDF: Firma logolu başlık + tarih + tablo. pdfmake ile sunucuda üretilir.
• Paylaş Linki: 24 saat geçerli imzalı URL → Cloudflare R2'de saklanır → WhatsApp/e-posta ile paylaşılır.

Pano Tasarımcı

Birden fazla raporu, KPI'yı ve grafiği 12 kolonluk grid'de tek panoda toplayın. Sürükle-bırak ile widget'ları yerleştirin, boyutlandırın.

Widget Tipleri

• KPI Widget: Tek değerli gösterim (sayı, yüzde, trend, sparkline, hedef)
• Chart Widget: Çubuk, çizgi, alan, pasta grafik
• Report Widget: Tablo halinde rapor önizlemesi

Birden Fazla Pano

Firma birden fazla pano oluşturabilir. Yıldızlanan pano "varsayılan" olur ve mobilde ana ekranda görünür.

Pano Ajanı (AI)

Pano Ajanı iki modda çalışır:

Manuel Mod

Widget'ları siz seçersiniz, Pano Ajanı 12-kolon grid'e akıllıca yerleştirir (KPI'lar 4'lü gruplar, grafikler 2'li, raporlar tam genişlik).

Otomatik Mod

Hiçbir widget seçmeyin → Pano Ajanı şemanızdaki tüm KPI/grafik/raporlardan en uygun olanları seçer ve yerleştirir. En az 1 rapor garantisi vardır.

Pano Sohbet

Hazır pano sayfasında AI panel açılır. "Bu ay hangi ürün en çok düşüş gösterdi?" gibi soru sorabilirsiniz. AI yalnızca panodaki widget verilerini kullanarak yanıtlar.

Pano Paylaşma

Panoyu şifre korumalı public link ile paylaşabilirsiniz - ziyaretçiler giriş yapmadan görüntüler.

• Agent + bağlantı profili otomatik seçilir (panonun widget profillerine göre)
• İsteğe bağlı şifre koruması (bcrypt hash)
• İsteğe bağlı AI sohbet paneli (lisansta varsa)
• Token tabanlı erişim - istediğiniz an iptal edebilirsiniz

KPI Widget'ları

KPI Alarm Kuralları

Her KPI için 4 farklı alarm tipi tanımlayabilirsiniz:

Edge-Triggered Davranış

Alarm bir kez tetiklenir - değer normale dönene kadar tekrar bildirilmez. Redis key kpi:alarm_active:{kpiId} ile takip edilir.

Bildirim Kanalları

• Mobil push bildirimi (FCM)
• E-posta (HTML + KPI değeri)
• WhatsApp Business API mesajı (Profesyonel+)

Zamanlanmış Görevler

Raporları belirli saatlerde otomatik çalıştırıp sonuçları farklı kanallara gönderebilirsiniz.

Cron İfadeleri

0 8 * * *        # Her gün 08:00
0 8 * * 1-5      # Hafta içi 08:00
0 8,17 * * *     # Her gün 08:00 ve 17:00
0 9 * * 1        # Her Pazartesi 09:00
0 0 1 * *        # Her ayın ilk günü gece yarısı

Teslimat Yöntemleri

• E-posta: HTML tablo + Excel eki
• Push bildirimi: Mobile FCM
• WhatsApp: Mesaj + ilk 10 satır + satır sayısı
• Tümü: 3 kanaldan birden gönder

E-posta Aboneliği

Rapor listesinde her satırın yanında 🔔 zil ikonu vardır. Tek tıkla "Her sabah 08:00'de bana gönder" aboneliği oluşturulur. Self-servis: kullanıcı kendi aboneliklerini yönetir, abonelik silmek istediğinde başkasına ihtiyaç duymaz.

WhatsApp Entegrasyonu

Meta WhatsApp Business API üzerinden bildirim ve 2-yönlü bot desteği:

Yapılandırma (Super Admin)

1. Meta Business hesabı oluşturun, telefon numarası onayı alın.
2. Web panel → Ayarlar → WhatsApp → API token + telefon numarası girin.
3. Webhook URL: https://api.mubisoft.com/api/whatsapp/incoming

Tek-Yönlü (Tüm paketler)

• Zamanlanmış görev sonuçları
• KPI alarmları
• Pano paylaşım linkleri

2-Yönlü Bot (Profesyonel+)

• WhatsApp'tan "Bugünkü satış" mesajı atın → PDF rapor cevap olarak gelir
• Sesli komut: ses kaydı → Whisper API ile transkript → rapor sorgusu
• Sabah 08:00'de tercih ettiğiniz KPI'ların özeti

Katmanlı AI Pipeline

Tek bir LLM çağrısı yerine katmanlı, denetlenebilir bir pipeline: 4 akıl yürüten AI ajanı (Architect - doğal dilden SQL; Atlas - şema anlamlandırma; Studio - KPI/grafik/pano/etiket tasarımı; Pulse - anomali kök-neden) ve bunları besleyen 7 otonom servis (Bridge, Stream, Sentry, Dispatch, Vault, Trace, Ledger). Aşağıdaki tablo bu AI yeteneklerinin arayüzde nereden tetiklendiğini gösterir:

AI Sağlayıcılar

Mubisoft 3 LLM sağlayıcıyı destekler - firma her zaman kendi seçimini yapar, kendi API anahtarını kullanır:

Veri Gizliliği

AI ile Oluştur (Atölye)

Üç ajanı tek panelde birlikte çalıştıran arayüz: KPI Ajanı + Grafik Ajanı + Drill-down Ajanı. Şemanızı tek seferde tarayıp 7 rapor + 4 KPI + 3 alt rapor önerir. Beğendiklerinizi tek tıkla içe aktarırsınız.

ERP Şablonları

Türkiye'nin yaygın ERP'leri için hazır SQL şablon kütüphanesi. Şablonlar açık kaynaklı, içe aktarımdan sonra serbestçe düzenleyebilirsiniz.

KVKK / PII Maskeleme

Türkiye'de kişisel veri kullanımı yasal zorunluluk. Mubisoft Gizlilik Ajanı bu süreci otomatize eder.

Otomatik PII Tespiti

Rapor sonucu kolonları desen eşleşmesi + AI fallback ile taranır:

• tckimlik, tc_no, kimlik → TC Kimlik
• iban → IBAN numarası
• kart_no, cc_number → Kredi kartı
• email, eposta → E-posta
• tel, gsm, telefon → Telefon

Maskeleme Tipleri

Rol Bazlı Görünürlük

visibleRoles alanında belirtilen roller (örn. firm_admin) tam değeri görür, diğerleri maskeli. Her PII içerikli rapor görüntülemesi audit log'a yazılır.

Satır Bazlı Güvenlik (RLS)

Profesyonel paket+. Rapor filtresini JWT kullanıcı kimliğine bağlayın - her kullanıcı yalnızca kendi verisini görür, ek SQL yazmanıza gerek kalmaz.

-- rls_config örneği:
{
  "userIdColumn": "user_id",
  "userIdSource": "jwt.user_id",
  "firmIdColumn": "firm_id",
  "firmIdSource": "jwt.firm_id"
}

-- Relay sorgu iletirken WHERE clause'unu otomatik ekler:
WHERE user_id = '...' AND firm_id = '...'

Denetim Günlüğü

Her işlem IP ve zaman damgasıyla kayıt altında. Web panelden filtreleyip dışa aktarılır.

Kayıt Edilen Eylemler

• report:execute - Rapor çalıştırma
• report:export - PDF/Excel dışa aktarım
• user:login, user:logout - Kullanıcı girişi/çıkışı
• agent:connect, agent:disconnect - Agent bağlantı durumu
• license:activate - Lisans aktivasyonu
• pii:viewed - PII içerikli rapor görüntüleme
• dealer:impersonate - Bayi rolü ile firma görüntüleme

REST API

Profesyonel paket ve üzerinde aktiftir. Üçüncü taraf sistemlerden rapor tetikleme, sonuç çekme.

Kimlik Doğrulama

Authorization: Bearer mubi_xxxxxxxxxxxxxxxxxxxx

Rapor Çalıştırma

POST https://api.mubisoft.com/public/v1/reports/{report_id}/run
Content-Type: application/json
Authorization: Bearer mubi_xxx...

{
  "parameters": {
    "BAS": "2026-01-01",
    "BIT": "2026-01-31",
    "STATUS": ["Aktif"]
  },
  "page": 1,
  "pageSize": 100,
  "format": "json"      // veya "csv"
}

Yanıt

HTTP 200 OK

{
  "rows": [
    { "musteri": "ABC Ltd.", "tutar": 45200, "tarih": "2026-01-15" },
    { "musteri": "XYZ A.Ş.", "tutar": 32100, "tarih": "2026-01-18" }
  ],
  "total": 150,
  "page": 1,
  "pageSize": 100,
  "executionMs": 412
}

Hata Kodları

Rate Limit

Saatlik 1.000 istek (Profesyonel) / 10.000 istek (Kurumsal). Aşıldığında 429 Too Many Requests.

API Anahtarı Yönetimi

Ayarlar → API Anahtarları sekmesinden:

• Yeni anahtar oluştur (isim ve açıklama girilir)
• Anahtar yalnızca oluşturulduğu anda tam görüntülenir - sonra hash olarak saklanır (SHA-256)
• Son kullanım zamanı izlenir
• İptal et: anında etkisiz olur, geriye dönük çağrılar 401 alır

Kullanıcı Rolleri

Paketler & Modüller