AkarEngine & AkarIQ: Kurumsal ERP ve Yapay Zeka Destekli Endüstriyel Arama (RAG)

1. Proje Özeti ve İş İhtiyacı

Endüstriyel rulman ve güç aktarım organları sektöründe yüz binlerce farklı parça kodu (SKU), üretici ön ek/son ekleri (suffix/prefix), müşteri parça numaraları (Customer PN) ve teknik muadil ilişkileri bulunur. Satış, satın alma ve mühendislik ekiplerinin her gün yüzlerce satırlık RFQ (Request for Quotation) taleplerini incelemesi, doğru muadilleri bulması ve dinamik fiyatlandırma yapması gerekmektedir.

Bu projede (AkarEngine); tüm parça kataloğunu, RFQ iş akışlarını, CoC (Certificate of Conformance) sertifika üretimini ve müşteri ilişkilerini yöneten modern bir kurumsal ERP mimarisi kuruldu. Sistemin kalbine ise teknik katalogları, sipariş geçmişini ve kurumsal dokümanları doğal dilde sorgulayabilen AkarIQ (Enterprise RAG & AI Agent) entegre edildi.

[ KULLANICI / MÜHENDİS ] ──> Next.js 15 App Router (TypeScript & TanStack)
                                     │ (Same-Origin Session / WebSocket)
                                     ▼
                   [ DJANGO 5.2 ASGI BACKEND (Daphne) ]
   ┌─────────────────────────────────┴─────────────────────────────────┐
   │                                                                   │
   ▼                                                                   ▼
[ ERP MODÜLLERİ ]                                             [ AkarIQ AI ENGINE ]
• Bearings Catalog (100K+ SKU)                                • Hybrid Retrieval (pgvector + Lexical BM25)
• RFQ & Purchasing Lifecycle                                  • Execution-time RBAC Fencing
• CoC Automated Document Engine                               • Streaming SSE & Multi-Tool Orchestration
   │                                                                   │
   └─────────────────────────────────┬─────────────────────────────────┘
                                     ▼
                      [ POSTGRESQL + PGVECTOR + REDIS ]
                      • Vektör Veritabanı & İlişkisel ERP Verisi
                      • Celery Background Workers & Outbox Queue

2. Karşılaşılan Teknik Zorluklar

• Karmaşık Endüstriyel Kodlama ve Suffix Çeşitliliği: Rulman kodlarındaki küçük bir harf değişikliği (örn. INLINECODE0), iç boşluk, kafes tipi veya konik delik anlamına gelir. Klasik anahtar kelime aramaları veya ham LLM'ler bu teknik nüansları kaçırabilmektedir.
• Veri Güvenliği ve Yetkilendirme (RBAC Leaks): Satış ekibinin tedarikçi alış fiyatlarını veya gizli marjları görmemesi, sadece yetkili olduğu müşteri RFQ'larına erişebilmesi gerekir. LLM'in prompt injection veya hallucination ile yetkisiz veri sızdırmasını engelleme zorunluluğu.
• Gecikmesiz Canlı İletişim: Ekiplerin teklif satırları üzerinde anlık chat yapabilmesi ve bildirimlerin milisaniyeler içinde iletilmesi gereksinimi.
• Büyük Doküman ve Katalog Transferi: Yüzlerce sayfalık üretici PDF kataloglarının vektörleştirilmesi ve semantik chunking ile aranabilir hale getirilmesi.

3. Geliştirilen Mimari ve Teknik Çözümler

Aşama 1: Çift Katmanlı Modern ERP Mimarisi (Django 5.2 + Next.js 15)

• Backend: Django 5.2, Daphne ASGI sunucusu, Redis broker'lı Celery iş parçacıkları ve modüler domain tasarımı (INLINECODE1, INLINECODE2, INLINECODE3, INLINECODE4, INLINECODE5, INLINECODE6).
• Frontend: Next.js 15 App Router, React 19, TypeScript, TanStack Table, React Hook Form, Zod doğrulama ve TailwindCSS / shadcn arayüz sistemi.
• Gerçek Zamanlı İletişim: Django Channels üzerinden WebSocket bağlantılarıyla anlık RFQ satır sohbeti (INLINECODE7) ve global bildirimler (INLINECODE8).

Aşama 2: AkarIQ — Güvenli Endüstriyel RAG ve Agentic AI

• Hibrit Arama (Hybrid Search): PostgreSQL INLINECODE9 vektör embedding araması ile geleneksel leksikal (BM25) aramayı birleştiren, Reciprocal Rank Fusion (RRF) ve reranking mimarisi.
• Execution-Time RBAC Fencing: AkarIQ'nun çağırdığı her araç (tool), sorguyu yapan kullanıcının anlık oturum izinlerini doğrular. Yetkisiz sorgularda sistem fail-closed prensibiyle çalışarak veri sızıntısını sıfıra indirir.
• Streaming SSE Yanıtları: Uzun teknik analizlerin ve parça karşılaştırmalarının kullanıcıya gerçek zamanlı (Server-Sent Events) akıtılması.
• Golden v1 Evaluation Suite: 40 kritik senaryolu bağımsız test setiyle Recall, MRR, NDCG ve decision accuracy metriklerinin sürekli doğrulanması.

Aşama 3: Otomatik CoC & Sertifika Üretimi

• Müşteriye sevk edilen ürünler için teknik standartlara uygun Uygunluk Belgesi (Certificate of Conformance) belgelerinin LibreOffice headless motoru üzerinden tek tıkla dinamik PDF/Excel formatında üretilmesi.

4. Elde Edilen Ölçülebilir Sonuçlar

5. Kullanılan Teknolojiler

• Backend: Python 3.12, Django 5.2, Django Channels (WebSockets), Daphne, Celery, Redis
• Frontend: Next.js 15, React 19, TypeScript, TanStack Query & Table, TailwindCSS, shadcn/ui
• Veritabanı & AI: PostgreSQL 16, pgvector, Voyage AI / Gemini Embeddings, Semantic Reranking
• DevOps & Altyapı: Docker Compose, Nginx Reverse Proxy, Linux / Ubuntu Server, Mailpit

Sizin Altyapınız İçin de Özel ERP & AI Çözümü Geliştirelim

İşletmenizin kurumsal verilerini, kataloglarını ve teklif süreçlerini modern web teknolojileri ve yapay zeka ile güçlendirmek isterseniz hizmetlerimi inceleyebilir veya benimle iletişime geçebilirsiniz.