SaaS & Web / E-Ticaret Ekosistemi — Geliştirici Kılavuzu (Dev Guide)

1. SaaS, CRM & Ön Muhasebe Modülleri

İşletme Yönetimi

Cari & Müşteri / Tedarikçi Yönetimi

firms.js CRM

Müşteri ve tedarikçi kartları, cari bakiye, ekstre, periyodik hizmet planları ve CRM etkileşim günlüğü.

Temel Yetenekler & İşlevler

Müşteri / Tedarikçi / Personel rol tanımları ve durum (Aktif/Pasif).
Dinamik çoklu döviz bakiye hesaplayıcı & filtreli cari hesap ekstresi (Ledger).
Periyodik bakım ve servis sözleşmesi planlama (service_plans).
Görüşme notları, CRM müşteri etkileşim günlüğü (interactions).
Çoklu şube ataması & Excel toplu cari içe/dışa aktarma (XLS_MODULE).

Modal Bileşeni: #modalFirmDetail, #modalFirms

Backend API: ajax/shared.php & ajax/accounting.php

SQLite Tabloları: users (role='firm'|'customer') & accounts

Güvenlik & UX: CORE.FormGuard entegrasyonu ile kaydedilmemiş veri koruması ve klavye kayıt navigasyonu (ArrowLeft/Right).

Fatura, Teklif & E-Belge Motoru

invoices.js Finans

Satış/Alış faturaları, teklif hazırlama, e-Arşiv/e-Fatura entegrasyonu, A4 yazdırma ve tekliften faturaya dönüştürme.

Temel Yetenekler & İşlevler

Barkod/Kamera okutuculu çok kalemli sepet (INVOICE.currentCart).
Tek tıkla Teklif → Satış Faturası dönüşümü (convertToSaleInvoice).
Dinamik KDV, iskonto, genel toplam ve döviz kurları hesaplaması.
VKN/TCKN ile entegratör üzerinden e-Arşiv ve e-Fatura XML/UBL gönderimi.
A4 formatında antetli, kaşeli resmi yazdırma motoru ve dijital teklif onay linki.

Modal Bileşeni: #modalInvoice, #modalInvoiceList

Backend API: ajax/shared.php (save_unified_invoice, save_proposal)

SQLite Tabloları: invoices, accounts

Sepet Koruması: FormGuard cart snapshot ile sepet değişiklikleri anlık izlenir.

Kasa, Bankalar & EHO (Otomatik Hesap Özeti)

accounting.js Banka API

Nakit kasaları, banka hesapları, 15 banka resmi EHO web servis entegrasyonu ve otomatik cari eşleme.

Temel Yetenekler & İşlevler

Tam Ekran EHO Hub Merkezi (#modalEhoHub) ile konsolide banka ekstresi.
Gelen EFT/Havale/FAST hareketlerinin VKN, TCKN ve unvan ile %98 otomatik eşleşmesi.
Tek tıkla kasaya gelir/gider aktarımı ve mükerrer kayıt engeli.
Çek / Senet portföyü ve periyodik ödeme talimatları takibi.
Paraşüt, Logo ve Mikro ERP API senkronizasyon köprüsü.

Modal Bileşeni: #modalKasa, #modalEhoHub, #modalTransaction

Backend API: ajax/accounting.php & ajax/bank_eho.php

SQLite Tabloları: accounts, settings (id='banks')

Görev Yönetimi & Takvimim

tasks.js & calendar.js Operasyon

Ekip iş emirleri, teklif geçerlilik takvimi, hizmet yenileme vadeleri ve entegre takvim görünümü.

Temel Yetenekler & İşlevler

Öncelik (Düşük/Orta/Yüksek), personel ataması ve durum yönetimi (Kanban/Liste).
Takvim üzerinde teklif son günleri, çek/senet vadeleri ve servis randevuları.
Otomatik geciken işler bildirim sayacı ve alarm mekanizması.

Modal Bileşeni: #modalTask, #modalCalendar

Backend API: ajax/shared.php (tasks)

SQLite Tabloları: tasks, operations

Çek & Senet Portföy Yönetimi

finance.js Finans

Alınan ve verilen çek/senetler, vade takip takvimi, tahsilat, ciro, iade ve karşılıksız durumları.

Temel Yetenekler & İşlevler

Alınan & Verilen Enstrümanlar: Giriş yönü (↓ Müşteri çeki) ve çıkış yönü (↑ Tedarikçi çeki/senet).
Vade ve Gecikme Takibi: Günü geçen vadeler otomatik kırmızı ikazla (table-danger), tahsil edilenler yeşil çizgiyle işaretlenir.
Seri No & Banka Eşleşmesi: Çek seri no, keşideci firma, banka şube bilgisi ve dövizli tutar takibi.
Hızlı Aksiyonlar: Tek tıkla tahsil etme (collect_payment) ve kasaya otomatik işleme.

Tetikleyici: ACCOUNTING.openCekSenet() / FINANCE.openFinanceList()

Modal Bileşeni: #modalFinanceList

Backend API: ajax/finance.php (get_finance_data)

İlişkili Tablolar: accounts, settings (id='banks')

Mesajlar, İletişim Merkezi & Mailbox

communication.js mailbox.js İletişim

Toplu SMS, e-posta gönderimi, Excel'den hedef kitle içe aktarma, hazır şablonlar ve dahili canlı sohbet.

Temel Yetenekler & İşlevler

Çok Kanallı Gönderim: SMS (Netgsm / İletimerkezi), E-Posta (SMTP) ve WhatsApp bilgilendirmeleri.
Excel Sürükle-Bırak Hedef Kitle: Dosyadan telefon ve e-posta listelerini anlık ayrıştırıp toplu gönderime bağlama.
Şablon Editörü: Dinamik yer tutuculu (Ad, Borç Tutarı, Son Ödeme vb.) mesaj taslakları.
Dahili Kullanıcı Sohbeti & Mailbox: Personeller arası anlık mesajlaşma (chat.js) ve kurumsal gelen/giden kutusu (mailbox.js).

Modal Bileşeni: #modalCommunication, #modalMailbox, #modalChat

Backend API: ajax/comm_handler.php & ajax/mailbox.php

SQLite Tabloları: messages, templates, operations

2. E-Ticaret & Sipariş Motoru

B2C / C2C / Hibrit Mağaza

Sipariş Yönetimi & 4 Yazdırma Motoru

ecommerce.js Yazdırma

7 aşamalı sipariş takibi, kapıda ödeme tahsilatları, barkodlu kargo etiketi, depo toplama ve fatura çıktıları.

4 Ayrı Yazdırma Motoru & Akış

🖨️ Sipariş Detayı Yazdır: Depo hazırlama ve sipariş toplama fişi.
🏷️ Kargo Barkod Etiketi: A5/A6 standart kargo ve alıcı barkod fişi.
📋 Detaylı Ürün Etiketi: Varyant, beden, renk ve desi bilgili sevk fişi.
📄 Fatura & Sözleşmeler: E-Arşiv fatura çıktısı ve mesafeli satış sözleşmesi.
🔄 İade (RMA) & Değerlendirme: Otomatik restock ve mağaza cevabı yazma.

Modal Bileşeni: #modalEcommerce

Backend API: ajax/ecommerce.php

SQLite Tabloları: operations (type='ecommerce_order'|'ecommerce_return')

Canlı Rozetler: Bekleyen sipariş/iade/yorum rozetleri anlık güncellenir.

Ürün Kataloğu, Varyantlar & Depo Sayımı

items.js & stock_count.js Katalog

Sınırsız varyant (beden, renk, SKU, barkod), desi matrisi, kâr marjı hesabı ve el terminaliyle depo sayımı.

Temel Yetenekler & İşlevler

Çok dilli ürün başlığı, açıklaması ve Summernote zengin metin editörü.
Her varyanta özel stok miktarı, depo seçimi ve bağımsız fiyatlama.
Alış fiyatı, satış fiyatı ve KDV oranına göre otomatik kâr marjı denetimi.
Hızlı kamera/barkod sayımı ve Excel tam uyumlu içe/dışa aktarım.

Modal Bileşeni: #modalItemDetail, #modalStockCount

Backend API: ajax/shared.php (items) & ajax/ecommerce.php

SQLite Tabloları: items (variants JSON kolonu dahil)

Kargo Matrisi & Sanal POS / Online Tahsilat

pos_payments.js Ödeme Motoru

7 coğrafi bölgeye göre desi bazlı kargo ücretlendirmesi, sanal POS taksit matrisi ve otomatik mutabakat.

Temel Yetenekler & İşlevler

Marmara, Ege, İç Anadolu vb. 7 bölge için özel kargo fiyat baremleri.
Ücretsiz kargo sepet tutar eşiği ve kargo firmaları yönetimi.
Banka Sanal POS, 3D Secure e-tahsilat ve komisyon/taksit oranları.
Başarılı tahsilatların anında cari hesaba ve kasa bakiyesine işlenmesi.

Backend API: ajax/ecommerce.php, ajax/pos_payments.php

SQLite Tabloları: accounts, settings (id='ecommerce')

Stok Hareketleri & Depo Giriş / Çıkış

stock_movements.js Stok

Tüm ürünlerin genel stok giriş/çıkış geçmişi, manuel stok düzeltmeleri, irsaliye/fatura eşleşmesi ve depo transferi.

Temel Yetenekler & İşlevler

Manuel Stok Giriş/Çıkış: Satın alma, fire, sayım fazlası/eksiği veya iade tipiyle anlık miktar güncelleme.
Hareket Geçmişi & Denetim İzi: İşlemi yapan kullanıcı (actor), tarih, birim fiyat, referans evrak no ve açıklama kaydı.
Depolar Arası Transfer: Şube veya merkez depolar arasında ürün/varyant transferi.
Otomatik Tetikleyiciler: Sipariş onayında otomatik stok düşüşü, RMA iade onayında otomatik restock artışı.

Tetikleyici: STOCK_MOVEMENTS.ensureModals() / openManualEntry()

Modal Bileşeni: #modalStockMovements

Backend API: ajax/stock_movements.php

SQLite Tabloları: items, operations (type='stock_movement')

3. Web & Kurumsal CMS Modülleri

Dinamik Vitrin & İçerik

Kurumsal Sayfalar, Menü & İçerik Blokları

pages.js & web.js CMS

Hiyerarşik menü ağacı, sayfa içi dinamik içerik blokları, çoklu dil ve zengin metin düzenleyici.

Temel Yetenekler & İşlevler

Sürükle-bırak menü sıralaması ve açılır alt menü ağacı.
Sayfa içi dinamik bloklar (Banner, Metin, Galeri, SSS).
Yasal sözleşme şablonları (mesafeli-satis-sozlesmesi, kvkk-aydinlatma-metni).
Çok dilli çeviri motoru ve otomatik URL slug üretimi.

Modal Bileşeni: #modalPageDetail, #modalWebSettings

Backend API: ajax/pages.php & ajax/web.php

SQLite Tabloları: pages, settings (id='web')

Yüzen Butonlar, AI Chatbot & KVKK Çerez Barı

web.js (#tab-web-widgets) Widget Motoru

WhatsApp, Hızlı Arama, Sosyal Paylaşım menüsü, AI Canlı Satış Asistanı ve dinamik KVKK çerez onay modalı.

Desteklenen 6 Yüzen Widget

💬 WhatsApp Butonu: Konum (sağ/sol/orta), özel numara ve hazır karşılama mesajı.
📞 Hemen Ara Butonu: Tek tıkla çağrı merkezi veya GSM arama.
🤖 AI Canlı Asistan: Bağımsız sistem promptu ve tıklanabilir mini ürün kartları.
🔗 Sosyal Paylaşım: X, WhatsApp, LinkedIn, E-Posta flyout menüsü.
🍪 KVKK & Çerez Barı: pages tablosundan dinamik yasal metin entegrasyonu.
⬆️ Yukarı Çık: Akıllı scroll tespitli floating back-to-top butonu.

Çıktı Motoru: config/meta.php (render_floating_widgets())

Konfigürasyon: settings (id='web' -> widgets)

Haberler, Blog & Multimedya Yöneticisi

news.js & multimedia.js İçerik

Kategori bazlı blog/haber motoru, sürükle-bırak çoklu görsel yükleme, otomatik resim sıkıştırma ve video URL desteği.

Temel Yetenekler & İşlevler

Yayın tarihi, yazar ve kategori eşleştirmesi.
YouTube / Vimeo video URL entegrasyonu ve otomatik kapak görseli.
Sürükle-bırak galeri yönetimi ve WebP formatında otomatik optimizasyon.

Modal Bileşeni: #modalNewsDetail

Backend API: ajax/news.php & ajax/media.php

SQLite Tabloları: news, media

4. AI Workflow & Otomasyon Robotları

OpenAI & Gemini & NVIDIA

AI Workflow Engine (12+ İş Akışı Robotu)

ai_workflow.js Otomasyon

Sipariş sınıflandırma, desi eksiklik tespiti, müşteri bilgilendirme taslağı, iade analizi ve duygu (sentiment) raporları.

Hazır Yapay Zeka Ajanları

ecommerce_1..7: Sipariş kırılımı, kargo durumu, desi kontrolü, iade analizi ve ürün yorumu yanıtlayıcı.
Teklif AI: Proje kapsamı, fiyatlandırma stratejisi ve şartname metni hazırlama.
Global AI SEO: Tek tıkla ürün, sayfa ve haberler için arama motoru meta üretimi.

Modal Bileşeni: #modalAiWorkflow

Backend API: ajax/ai_workflow_engine.php

Sağlayıcılar: OpenAI GPT-4o, Google Gemini, NVIDIA NIM, DeepSeek

5. Çekirdek Güvenlik & Sistem Motoru

Altyapı Standartları

CORE & FormGuard (Veri Kaybı Önleyici)

core.js Özel Dark Modal

Oturum kontrolü, PWA, toast bildirimleri, klavye kısayolları ve sistem genelinde kaydedilmemiş form koruma motoru.

FormGuard & Detay Koruması

FormGuard: Baseline snapshot karşılaştırması ve özel koyu cam modal uyarısı.
Detail Navigation: Modallar arası önceki/sonraki kayıt geçişi (ArrowLeft/Right).
Ctrl + S Kısayolu: Açık modallardaki aktif formu tek tıkla kaydetme.
PWA & Mobil: Çevrimdışı önbellekleme ve mobil alt navigasyon barı.

Paket Dosyası: assets/js/app.core.bundle.js

Derleyici Betik: build_bundles.ps1 / build_bundles.php

SQLite Veritabanı: data/database.sqlite (JSON formatlı hibrit mimari)

Admin DB (SQLite Manager) & İzolasyon Protokolü

admin_db.js Master Only

Tarayıcı içi SQL sorgu editörü, tablo kayıt gezgini ve modüler izole sistem sıfırlama güvenliği.

İzolasyon Standartları

Modül İzolasyonu: Ürünler sıfırlanırken blog veya sayfa görsellerine asla dokunulmaz.
Sipariş Sıfırlama: Yalnızca operasyon kayıtları silinir, müşteri carileri korunur.
Veritabanı Güvenliği: Sadece Master yetkili kullanıcılar DB konsoluna erişebilir.

Modal Bileşeni: #modalAdminDb

Backend API: ajax/shared.php (admin_db)

Yetki Seviyesi: Master Admin

Şube & Çoklu Lokasyon Altyapısı

core.js (branches) Çoklu Şube

Farklı şubeler, depolar veya çalışma grupları arasında anında veri filtreleme, çoklu şube ataması ve yetkilendirme.

Çekirdek Şube Standartları

Merkezi Veri Havuzu: CORE.DATA.branches üzerinden tüm sistem dinamik şube ağacını tanır.
Liste & Tablo Filtreleme: CORE.populateListBranchFilter() ve CORE.recordMatchesBranch() ile cariler, haberler, kasalar şube bazlı filtrelenir.
Çoklu Şube Seçici: Detay formlarında .multi-branch-picker ve CORE.populateMultiBranchSelects() bileşenleri kullanılır.
Dinamik Kolon & Etiketleme: Tablolarda .mod-branchs sınıfı ile şube modülü açık/kapalı durumuna göre otomatik gösterilir/gizlenir.

Global Fonksiyonlar: CORE.getBranchLabel(), CORE.ensureBulkSelectionScope()

Veri Deposu: CORE.DATA.branches & settings (id='branches')

Uygulanan Modüller: Cariler, Siparişler, Kasalar, Stok Depoları, Haberler, Sayfalar

Entegrasyonlar Merkezi (ERP, POS, SMS, AI)

integrations Bağlantılar

Ön muhasebe & ERP (Paraşüt v4, Logo, Mikro), Sanal POS, SMS servisleri, Google API ve AI LLM modelleri.

Desteklenen Entegrasyon Kanalları

ERP & Ön Muhasebe: Paraşüt v4 REST API (OAuth2), Logo ve Mikro aktarım köprüsü.
Sanal POS & Tahsilat: PayTR, iyzico ve banka Sanal POS 3D Secure e-tahsilat.
Toplu SMS & Bildirim: Netgsm, İletimerkezi, Mutlucell ve özel SMS gateway sağlayıcıları.
Google & Web API: Google OAuth2 Giriş, Google Analytics, Google Tag Manager, Search Console.
Yapay Zeka (AI Engine): OpenAI GPT-4o, Google Gemini Flash/Pro, NVIDIA NIM API anahtarları.

Yönetim Sekmesi: #tab-settings-integrations (Ayarlar Modalı)

Backend API: ajax/accounting_integration.php, ajax/comm_handler.php

SQLite Tabloları: settings (id='integrations'), settings (id='ecommerce')