Motorlar Genel Bakış
TotalApp; iş mantığını, veriyi, yapay zeka orkestrasyonunu, entegrasyonları, arayüz çizimini ve gözlemlenebilirliği birbirinden ayrı, bağımsız ölçeklenebilir katmanlara bölen özel motorlarla çalışır. Bu sayfa her bir motoru ve uçtan uca nasıl birlikte çalıştıklarını tanıtır.
Motorlar Nedir?
TotalApp tek parça (monolitik) bir backend yerine, az sayıda özelleşmiş motordan oluşur. Her motor tek bir sorumluluğa sahiptir — veri modelleme, iş akışı yürütme, entegrasyonlar, yapay zeka orkestrasyonu, arayüz çizimi ya da gözlemlenebilirlik — böylece bağımsız olarak anlaşılabilir, ölçeklenebilir ve geliştirilebilir. Motorlar iki gruba ayrılır: sunucu tarafında çalışan ve asıl ağır işi yapan backend motorları ve backend'in ürettiği çıktıyı kullanıcının gördüğü ekranlara dönüştüren frontend motorları.
TotalApp Motorları
- Matrix Agent — iş akışı / iş kuralı yürütme ve yapay zeka destekli puanlama
- Flow Engine — görsel iş akışı grafiği çalışma zamanı (node'lar, kenarlar, tetikleyiciler)
- Schema & Data Engine — no-code tablo tanımlarını gerçek, performanslı bir veri tabanı şemasına dönüştürür
- Integration & Webhook Engine — dış dünyaya açılan kapı (ingest + egress)
- Agentic Routing Engine — LLM çağrılarını, prompt'ları ve yapay zeka ajanlarını orkestra eder
- Event & Analytics Engine — diğer tüm motorlardan gelen logları, maliyetleri ve yürütme zaman çizelgelerini toplar
Frontend tarafında, backend'in ürettiği JSON şemasını okuyup canlı, temalandırılmış bir ekrana dönüştüren daha hafif bir UI Rendering Engine ailesi bulunur — özellik başına sabit bir sayfa göndermeden.
Backend Motorları
Backend motorları şunlardır: Matrix Agent, Flow Engine, Schema & Data Engine, Integration Engine, Agentic Routing Engine ve Event & Analytics Engine.
Matrix Agent
Matrix Agent, yapılandırılmış veya serbest metin verisini yapılandırılabilir kurallara — olmazsa olmaz filtrelere, ağırlıklı puanlama kriterlerine ve eşiklere — göre değerlendirir, filtreler ve puanlar. Tedarikçi Zekası, Lead Puanlama ve Uyumluluk Radarı gibi ekranları besler; bu ekranlarda bir liste içindeki her varlığın 0–100 arası bir uygunluk puanına ve yönetici özetine ihtiyacı vardır. Somut uygulamalar için Uyumluluk Radar ve Tedarikçi Matrisi sayfalarına bakın.
Flow Engine
Flow Engine, TotalApp'in görsel İş Akışı Düzenleyici'sinin arkasındaki çalışma zamanıdır — node ve kenarlardan oluşan grafikleri yürütür, node başına girdi/çıktı sözleşmelerini çözer ve kısmi yürütmeyi (bir tetikleyici node'dan ulaşılabilir alt grafiği çalıştırma) destekler. Gelen webhook tetikleyicilerini, zamanlanmış tetikleyicileri ve manuel "İş Akışını Çalıştır" yürütmelerini besleyen de aynı motordur. Bkz. İş Akışı Düzenleyici.
Schema & Data Engine
Bu motor, no-code kullanıcısının oluşturduğu görsel tabloları arka planda performanslı ve güvenli bir veri tabanı mimarisine dönüştürür. Kullanıcılar alanları ve ilişkileri görsel olarak tanımlar; motor bu tanımı kullanıcı hiçbir zaman elle bir migration yazmadan, verimli ve tenant bazlı bir depolama şemasına çevirmekten sorumludur.
Integration & Webhook Engine
TotalApp ile dış dünya arasındaki kapıdır. Trafiğin her iki yönünü de yönetir: ingest (Shopify, WooCommerce, Odoo ve diğer sistemlerden gelen webhook'lar) ve egress (TotalApp'in bu sistemlere yaptığı dışa giden API çağrıları).
Message Queue
Redis / BullMQ tabanlı bir kuyruk, gelen trafikteki ani yığılmaları emer. Shopify'dan aynı anda 500 webhook geldiğinde motor bunları hemen bir HTTP 200 ile kabul eder ve payload'ları kuyruğa alır; Matrix Agent (veya Flow Engine) bunları sürdürülebilir bir hızda tüketir.
Idempotency (Mükerrerlik Kontrolü)
Gelen her olay bir request_id taşır. Aynı webhook bir ağ hatası yüzünden iki kez teslim edilirse, motor mükerrer isteği tanır ve yalnızca bir kez işler.
Exponential Backoff
Başarısız olan dışa giden API çağrıları, alt sistemi hemen zorlamak yerine artan bir program üzerinde yeniden denenir (ör. 1 dk, ardından 5 dk, ardından 15 dk).
Agentic Routing Engine
Yapay zeka çağrılarını optimize eden, token maliyetlerini düşüren ve Linter/Critic tarzı ajan döngülerinin trafiğini yöneten akıllı katmandır.
Provider Agnostic (Model Bağımsızlığı)
LLM çağrıları tek bir arayüzün arkasında soyutlanır. Uygulama kodu asla belirli bir sağlayıcıyı (ör. OpenAI veya Anthropic) doğrudan çağırmaz — AgenticEngine.call()'ı çağırır ve motor isteği hangi model/sağlayıcının işleyeceğine karar verir.
Dynamic Prompt Injector
Vektör veri tabanından gelen sonuçları, sistem prompt'larını ve tenant'a özel kuralları birleştirerek her istek için LLM'e gidecek son bağlamı oluşturur.
Event & Analytics Engine
Diğer tüm motorların ürettiği logları, token harcamalarını ve işlem sürelerini toplayıp bir insanın üzerine hareket edebileceği bir hale getiren gözlem merkezidir. Olayları nasıl kaydettiği ve yapay zeka maliyetini nasıl tahmin ettiğinin tam dökümü için bkz. Olay & Analitik Motoru.
Zaman Serisi Depolama
ClickHouse / TimescaleDB gibi bir zaman serisi veri tabanı, yüksek hacimli log akışını verimli şekilde saklar ve geriye dönük analiz yapılmasını sağlar.
Asenkron Loglama
Loglama hiçbir zaman ana yürütme akışını bloklamaz. Olaylar fire-and-forget şekilde veya bir olay veri yolu (ör. Kafka) üzerinden yayınlanır; böylece Matrix Agent'in kendi performansı gözlemlenebilirlik yükünden asla etkilenmez.
Maliyet Takibi
"Bu ay hangi akış kaç dolarlık OpenAI/Claude token'ı tüketti?" gibi tenant bazlı raporlar üretir.
Visual Debugger
İnteraktif bir zaman tüneli, bir iş akışı yürütmesinin hangi adımdan geçtiğini, her adımın kaç milisaniye sürdüğünü ve bir hata varsa hangi ajan veya fonksiyondan fırlatıldığını gösterir.
Frontend Motorları
Frontend tarafında TotalApp, özellik başına elle yazılmış bir sayfa göndermez. Bunun yerine, küçük bir UI Rendering Engine ailesi backend'in ürettiği JSON şemasını okuyup ekrana çizer. Bu grup Dynamic Screen Renderer'ı ve Theme Catalog'u içerir.
UI / UX Rendering Engine — Server-Driven UI (SDUI)
React/Vite frontend'inde özellik başına sabit bir sayfa barındırmak yerine, bu motor backend'den gelen JSON arayüz tanımlarını yorumlayarak (render ederek) ekranı çizer. Aynı genel amaçlı renderer, yalnızca aldığı şemaya bağlı olarak tamamen farklı ekranlar üretebilir.
Semantik CSS ve Tema Kataloğu
UI Engine, gelen bir şemada "theme": "success" gibi bir direktif okuduğunda, bu semantik ismi otomatik olarak platformun merkezi Tailwind CSS kataloğundaki karşılığına (ör. bg-emerald-600 hover:bg-emerald-700 text-white rounded-lg) eşler ve bileşene uygular. Bu eşleme merkezi olarak Tema Kataloğu'nda yaşadığı için, bir tenant'ın aktif temasını değiştirmek anında tüm platformun rengini değiştirir — ekran başına herhangi bir değişiklik gerekmez.
Dynamic Screen Renderer + Theme Catalog
Dynamic Screen Renderer yalnızca backend şemasının söylediğini çizer — layout, alanlar ve aksiyonlar. Theme Catalog ise yalnızca o şemadaki semantik isimler için görünümü (renkler, gradyanlar, blur) sağlar. Bu iki sorumluluğu ayrı tutmak, tek bir renderer'ın uygulamadaki her ekrana hizmet etmesini mümkün kılar.
Motorlar Birlikte Nasıl Çalışır?
Gelen tek bir olay — örneğin Shopify'da oluşturulan yeni bir sipariş — bir insan onu görmeden önce altı backend motorunun tamamından, ardından da bir ekrana dönüşmek üzere frontend rendering motorlarından geçer:
| Adım | Motor | Ne olur |
|---|---|---|
| 1 | Integration & Webhook Engine | Gelen Shopify siparişini yakalar ve kuyruğa yerleştirir. |
| 2 | Schema & Data Engine | Siparişin yazılacağı tablonun şemasını doğrular. |
| 3 | Agentic Routing Engine | Sipariş verisini bir Linter/Critic ajan döngüsünden geçirerek analiz eder ve temizler. |
| 4 | Matrix / Flow Engine | İş kurallarını (if/else yönlendirme) uygulayarak siparişin onay rotasına karar verir. |
| 5 | UI Rendering Engine | Ortaya çıkan şemadan son kullanıcı için onay bekleyen siparişi çizer. |
| 6 | Event & Analytics Engine | Tüm yolculuğun performansını ve yapay zeka maliyetini raporlar. |