Kurulum ve Dağıtım Seçenekleri

Taz.Memory.AI, işletmenizin ihtiyaçlarına göre Cloud (Bulut) veya On-Premise (Yerel Dağıtım) olarak iki farklı şekilde kullanıma hazırlanır. Her iki dağıtım seçeneği de aynı güçlü altyapıyı sunar; fark yalnızca barındırma konumudur.

---

Hızlı Başlangıç — Cloud Versiyonuna Erişim

Henüz kendi tenant'ınızı oluşturmadıysanız, app.taztechnology.com adresine giderek aşağıdaki adımları izleyebilirsiniz:

1. Kayıt Olun: app.taztechnology.com/login adresinde "Google ile devam et" veya "Microsoft ile devam et" butonları ile tek tıkla kaydolun. E-posta/şifre girişi de mümkündür.
2. Tenant Seçimi: Kayıt sonrası hangi tenant'a bağlanacağınızı belirleyin — her tenant bağımsız bir AI ortamıdır.
3. Abone Türü Belirleme: İhtiyacınıza göre abonelik paketi seçin:
   • Starter — Küçük ekipler için başlangıç paketi (sınırlı token, 1 LLM backend)
   • Professional — Orta ölçekli ekipler (gelişmiş routing, sınırsız KB, widget desteği)
   • Enterprise — Kurumsal dağıtım (on-premise destek, SLA, özel entegrasyonlar)
4. Ortamınız Hazır: Dashboard'unuza giriş yapın ve ilk AI ajanınızı 2 dakikada oluşturun!

💡 Başka bir çözüm mü arıyorsunuz? Kendi altyapınıza Taz.Memory.AI kurmak istiyorsanız aşağıdaki On-Premise bölümünü inceleyin.

---

Seçenek 1: Cloud (Bulut) Dağıtımı

Avantajlar

Avantaj	Açıklama
Sıfır Kurulum	Hesap oluşturun, hemen kullanmaya başlayın — sunucu, config, deployment derdi yok
Otomatik Ölçekleme	Trafik arttığında altyapı otomatik genişler; siz sadece sonuçlara odaklanın
Güvenlik & Yedekleme	Verileriniz gününde 3 kez yedeklenir; PCI-DSS, SOC2 uyumlu altyapı
Anında Güncelleme	Yeni özellikler dakikalar içinde tüm tenant'lara yayılır — versiyon takibi yapmanıza gerek yok

Kimler İçin?

• Hızlı şekilde AI desteğini hayatınıza geçirmek isteyen KOBİ'ler ve startup'lar
• Altyapı yönetimiyle uğraşmak istemeyen ürün ve pazarlama ekipleri
• Çoklu departman için izole AI ortamları (tenant'lar) kuran kuruluşlar

Abonelik Paketleri

Özellik	Starter	Professional	Enterprise
Aylık Token Hakkı	50K	500K	Sınırsız
LLM Backend Sayısı	1	5	Sınırsız
Knowledge Base	3	Sınırsız	Sınırsız (on-prem)
Agent Sayısı	2	20	Sınırsız
Widget	❌	✅	✅
On-Premise Desteği	❌	❌	✅
SLA	—	%99.5	%99.99

---

Seçenek 2: On-Premise (Yerel Dağıtım)

Taz.Memory.AI'ın tamamını kendi altyapınıza kurun. Verileriniz asla üçüncü şahısların sunucularından geçmez; LLM routing tamamen sizin kontrolünüzdedir.

🔧 Gereken Sistem Kaynakları

Minimum Donanım Gereksinimleri

Bileşen	Minimum	Önerilen
CPU	8 çekirdek	16+ çekirdek
RAM	16 GB	32 GB+
GPU (AI için)	8 GB VRAM	16–24 GB VRAM
Disk	100 GB SSD	500 GB NVMe SSD
Ağ	100 Mbps	1 Gbps+

⚠️ GPU Zorunludur: Yerel LLM çalıştırmak (Ollama, yerel embedding modelleri vb.) için en az 8 GB VRAM'li bir GPU gerekir. NVIDIA GPU'lar önerilir; CUDA ve cuDNN kurulumu gereklidir.

Desteklenen Kubernetes Ortamları

Taz.Memory.AI container-first mimari ile tasarlanmıştır ve aşağıdaki Kubernetes dağıtımlarında sorunsuz çalışır:

Platform	Açıklama
K3s (Önerilen)	Hafif, edge computing için ideal; tek node'da tam kurulum
Docker Compose / Docker Swarm	Basit çoklu-container deployment; CI/CD gerektirmez
Rancher	Çoklu küme yönetimi; enterprise-grade cluster kontrolü
Amazon EKS	AWS üzerindeki Kubernetes hizmeti; otomatik ölçekleme
Google GKE	Google Cloud Kubernetes Engine
Azure AKS	Microsoft Azure Kubernetes Service
On-Premises Kubernetes	VMware, OpenStack, Proxmox üzerinde kendi kümenizi kurun

Kurulum Adımları (Kubernetes / K3s)

Adım 1: Helm Charts ile Deploy

# Taz repo'sunu ekleyin
helm repo add taz https://charts.tazai.com
helm repo update

# Namespace oluşturun
kubectl create namespace taz-ai

# Helm ile deploy edin (abonelik paketinize göre config dosyası düzenleyin)
helm install taz-memoriall ./helm/taz-memory-ai \
  --namespace taz-ai \
  -f values-prod.yaml

# Deployment kontrolü
kubectl get pods -n taz-ai

Adım 2: Veritabanı Hazırlığı

PostgreSQL veritabanı ön hazırlığı:

# PostgreSQL oluştur (örn. AWS RDS, DigitalOcean Managed veya kendi sunucunuz)
CREATE DATABASE taz_memory_ai;
CREATE USER taz_app WITH PASSWORD 'your_strong_password';
GRANT ALL PRIVILEGES ON DATABASE taz_memory_ai TO taz_app;

Adım 3: Redis Hazırlığı

Cache ve mesaj kuyruğu için Redis instance'ı:

# Docker ile hızlı kurulum
docker run -d --name taz-redis -p 6379:6379 \
  redis/redis-stack:latest

Adım 4: RabbitMQ Hazırlığı

Mikroservisler arası asenkron mesajlaşma için:

docker run -d --name taz-rabbit \
  -p 5672:5672 -p 15672:15672 \
  rabbitmq:3-management

Adım 5: GPU Driver Kurulumu (On-Prem için)

# NVIDIA CUDA toolkit (Ubuntu/Debian için)
apt install -y nvidia-cuda-toolkit

# Docker ile GPU erişimi
docker run --gpus all -d --name taz-ollama \
  -v ollama_data:/root/.ollama \
  -p 11434:11434 ollama/ollama

Adım 6: SSL/TLS Sertifika (Production)

# Let's Encrypt ile ücretsiz SSL
certbot --nginx -d taz.yoursirket.com

---

Altyapı Teknoloji Yığını (Backend)

Taz.Memory.AI, yüksek performanslı, ölçeklenebilir ve güvenilir bir backend altyapısı üzerine inşa edilmiştir. Her bileşen prod-tested ve enterprise-grade'dir.

🔹 .NET 10 — Backend Çekirdek

┌─────────────────────────────────┐
│         ASP.NET Core 10          │
│   Minimal APIs + gRPC Services   │
│   C# 13 + Source Generators     │
│   AOT Compilation (Publish)     │
│   Native AOT + Trimmed Deploy   │
└─────────────────────────────────┘

• Modern .NET 10: En yeni performans optimizasyonları, %40 daha hızlı startup, native AOT desteği
• Minimal APIs: Temiz, minimal endpoint tasarımı; boilerplate yok
• C# 13 Source Generators: Derleme zamanında kod üretimi — reflection maliyeti yok
• Native AOT Publishing: Tek binary, Docker imajı boyutu 70% küçülme, milisaniye düzeyinde cold start

🔹 PostgreSQL + Entity Framework Core

┌─────────────────────────────────┐
│      PostgreSQL 16+             │
│   ┌───────────────────────┐     │
│   │   EF Core 9 (Latest)   │     │
│   │  Code-First Migrations │     │
│   │  Bulk Operations       │     │
│   │  JSONB Columns         │     │
│   │  Full-Text Search      │     │
│   └───────────────────────┘     │
└─────────────────────────────────┘

• PostgreSQL 16+: JSONB, full-text search, partitioning — vektör verileri için ideal
• EF Core 9: Code-first migration'lar ile version control; bulk operations ile milyonlarca satır hızla işleme
• JSONB sütunları: Dinamik konfigürasyon ve esnek veri modelleri

🔹 Redis — Cache ve Session Yönetimi

┌─────────────────────────────────┐
│        Redis 7+                 │
│   ┌───────────────────────┐     │
│   │   Semantic Cache       │     │
│   │   Rate Limiting        │     │
│   │   Session Store        │     │
│   │   Distributed Locks    │     │
│   └───────────────────────┘     │
└─────────────────────────────────┘

• Semantic Cache: Aynı soru tekrar geldiğinde LLM çağrısı yapmadan cevap verir — maliyet %60'a kadar düşer
• Rate Limiting: IP bazlı istek sınırlaması; spam ve abuse önleme
• Session Store: Dağıtık oturum yönetimi; horizontal scaling desteği
• Distributed Locks: Concurrent işlemlerde veri tutarlılığı

🔹 MediatR (CQRS Pattern)

┌─────────────────────────────────┐
│         CQRS / MediatR           │
│   ┌───────────────────────┐     │
│   │    Commands (Write)   │     │
│   │  → CreateAgent        │     │
│   │  → UpdatePrompt       │     │
│   │  → DeployTool         │     │
│   ├───────────────────────┤     │
│   │    Queries (Read)     │     │
│   │  → GetAgentById       │     │
│   │  → ListKnowledgeBase  │     │
│   │  → AgentAnalytics     │     │
│   └───────────────────────┘     │
└─────────────────────────────────┘

• CQRS Pattern: Okuma ve yazma işlemleri ayrı modellerde; her biri kendi optimize edilmiş query'siyle
• MediatR: In-process service bus; clean architecture'a uygun mesaj geçişi
• Pipeline Behaviors: Loglama, cache, validation — her request pipeline'ında otomatik

🔹 MassTransit + RabbitMQ — Asenkron Mesajlaşma

┌─────────────────────────────────┐
│      MassTransit 8+             │
│         RabbitMQ 3.13           │
│   ┌───────────────────────┐     │
│   │   Agent Workflow Qs    │     │
│   │   KB Indexing Queue    │     │
│   │   Notification Bus     │     │
│   │   Audit Trail Events   │     │
│   │   Retry / Dead Letter  │     │
│   └───────────────────────┘     │
└─────────────────────────────────┘

• MassTransit 8+: Event-driven microservices mimarisi; saga pattern desteği
• RabbitMQ: Yüksek throughput; delayed queue, prioritization, DLX (Dead Letter Exchange)
• Saga Pattern: Uzun çalışan agent işlemlerinde transaction yönetimi
• Retry / Dead Letter: Başarısız mesajlar otomatik tekrar denenir; sonunda DLQ'ya düşer

🔹 Serilog — Structured Logging

┌─────────────────────────────────┐
│          Serilog                 │
│   ┌───────────────────────┐     │
│   │    Console (Dev)       │     │
│   │    File (Rolling)      │     │
│   │    Elasticsearch / Kibana│
│   │    Seq Dashboard       │     │
│   │    Serilog.Sinks.MSSql │     │
│   └───────────────────────┘     │
└─────────────────────────────────┘

• Structured Logging: JSON formatında log; metin arama değil, property bazlı sorgulama
• Rolling File: Günlük log dosyaları otomatik döndürülür; disk yönetimi kolay
• Elasticsearch / Kibana Entegrasyonu: Log'lar anlık olarak analiz edilebilir; alert oluşturabilirsiniz
• Seq Dashboard: Gerçek zamanlı log dashboard

🔹 Prometheus + Grafana — Monitoring & Alerting

┌─────────────────────────────────┐
│       Prometheus 3+              │
│         Grafana 11+              │
│   ┌───────────────────────┐     │
│   │   Request Latency      │     │
│   │   Token Throughput     │     │
│   │   Error Rates          │     │
│   │   GPU Memory Usage     │     │
│   │   Agent CPU/Mem        │     │
│   │   Custom Metrics       │     │
│   └───────────────────────┘     │
│         ↓ Grafana Dashboards    │
│   📊 LLM Cost Dashboard          │
│   📊 Agent Performance           │
│   📊 System Health               │
│   📊 KB Indexing Progress        │
└─────────────────────────────────┘

• Prometheus 3+: Metrics collection; histogram, counter, gauge tipleri
• Grafana 11+: Dashboard'lar ve alertler — LLM maliyetini gerçek zamanlı izleyin
• Custom Metrics: Her endpoint için özel metrikler; SLA ihlal alertleri
• GPU Monitoring: NVIDIA DCGM Exporter ile GPU VRAM, temperature, utilization takibi

---

Frontend Teknoloji Yığını

Taz.Memory.AI'in kullanıcı arayüzü, en güncel web teknolojileri ile tasarlanmıştır. Modern, hızlı ve geliştirici dostu bir deneyim sunar.

┌─────────────────────────────────────┐
│         Taz.Memory.AI Frontend       │
│                                      │
│  ┌────────────────────────────────┐  │
│  │     Next.js 15 (App Router)    │  │
│  │   Server Components (RSC)      │  │
│  │   Streaming SSR + SSG          │  │
│  │   Edge Runtime Support         │  │
│  └────────────┬───────────────────┘  │
│               │                       │
│  ┌────────────▼───────────────────┐  │
│  │     React 19+                  │  │
│  │   Server Actions               │  │
│  │   useFormStatus, useOptimistic │  │
│  │   Actions + Suspense           │  │
│  └────────────┬───────────────────┘  │
│               │                       │
│  ┌────────────▼───────────────────┐  │
│  │     TypeScript 5+              │  │
│  │   Strict Mode + Paths Alias    │  │
│  │   Project References           │  │
│  └────────────┬───────────────────┘  │
│               │                       │
│  ┌────────────▼───────────────────┐  │
│  │     TanStack Query v5          │  │
│  │   Infinite Scroll              │  │
│   │   Optimistic Updates           │  │
│  │   Background Refetching         │  │
│  └────────────┬───────────────────┘  │
│               │                       │
│  ┌────────────▼───────────────────┐  │
│  │     Zustand                    │  │
│  │   Global State Store           │  │
│  │   Middleware (persist, devtools)│ │
│  └────────────┬───────────────────┘  │
│               │                       │
│  ┌────────────▼───────────────────┐  │
│  │     React Hook Form + Zod      │  │
│  │   Schema Validation            │  │
│  │   Zero-Bundle-Size             │  │
│  └────────────┬───────────────────┘  │
│               │                       │
│  ┌────────────▼───────────────────┐  │
│  │     Tailwind CSS 3             │  │
│  │   + Shadcn/ui                  │  │
│  │   Recharts                     │  │
│  │   NextAuth.js                  │  │
│  └────────────────────────────────┘  │
└─────────────────────────────────────┘

🔹 React 19+

• Modern React: En son React özellikleri — Actions, useFormStatus, useOptimistic hook'ları
• Server Components (RSC): Sayfa bileşenlerinin çoğu sunucuda render edilir; client bundle boyutu minimum
• Streaming SSR: İlerleme göstergeli sayfa yükleme; kullanıcı hemen görür, içerik gelir

🔹 TypeScript 5+

• Strict Mode: Tüm tipler tanımlı; runtime hataları derleme zamanında yakalanır
• Path Aliases: @/components/*, @/lib/* gibi alias'lar ile temiz import'lar
• Project References: Monorepo yapısında tip kontrolü optimizasyonu

🔹 Next.js 15+ (App Router, Server Components)

• App Router: Dosya-tabanlı routing; /dashboard, /agents/new, /kb/:id gibi URL yapıları
• Server Components: Varsayılan olarak sunucuda çalışır; veri çekme bileşenlerde doğrudan yapılabilir
• Server Actions: Form submit'leri doğrudan server-side handler'lara gider — API endpoint yazmaya gerek yok
• Streaming SSR: React.Suspense ile kısmi yükleme; skeleton UI gösterilir, içerik gelir

🔹 TanStack Query (React Query v5)

• Infinite Scroll: Bilgi tabanı ve log listelerinde sonsuz kaydırma
• Optimistic Updates: Agent oluştururken anında UI güncellemesi; rollback eğer API hata verirse
• Background Refetching: Focus olduğunda otomatik yenileme; her zaman güncel veri

🔹 Zustand (State Management)

• Global State: Auth, theme, sidebar toggle gibi global durumlar
• Middleware: persist — state'i localStorage'a kaydet; devtools — Chrome扩展'de state'ı izleme
• Minimal Boilerplate: Context Provider'a gerek yok; doğrudan import

🔹 React Hook Form + Zod (Form Validation)

• Schema Validation: Zod şablonları ile form validasyonu; client ve server tarafında aynı kurallar
• Zero-Bundle-Size: Zod compile-time'da çalışır; production bundle'a eklenmez
• React Hook Form: useFieldArray ile dinamik alanlar (LLM backend listesi, tool config vb.)

🔹 Tailwind CSS 3 + Shadcn/ui

• Tailwind CSS 3: Utility-first CSS; design system'in her noktası token'larla yönetilir
• Shadcn/ui: Accessible, customizable component library; copy-paste ile kendi kodunuza dahil edin
• Dark Mode: next-themes ile tema geçişi; sistem tercihi otomatik algılanır

🔹 Recharts (Data Visualization)

• LLM Cost Dashboard: Grafik çizelgeleri ile günlük/haftalık maliyet görselleştirme
• Agent Performance: Latency, token throughput, CSAT skorları — interactive charts
• Real-time Updates: WebSocket veya polling ile canlı veri akışı

🔹 NextAuth.js (Authentication)

• OAuth2 / OIDC Support: Google, Microsoft, GitHub, SAML enterprise SSO
• Credentials: E-posta/şifre girişi; JWT session yönetimi
• Multi-tenant Auth: Tenant bazlı authentication; cross-tenant isolation

---

İki Dağıtım Karşılaştırması

Kriter	Cloud (Bulut)	On-Premise (Yerel)
Kurulum Süresi	5 dakika (hesap oluşturma)	2–4 saat (sunucu hazırlığı dahil)
Başlangıç Maliyeti	$0 (starter plan ile)	Donanım + lisans + kurulum
Veri Güvenliği	Taz altyapısı güvende	Tamamen sizin kontrolünüzde
LLM Seçimi	12+ bulut sağlayıcısı	Bulut + yerel Ollama karışık
Ölçekleme	Otomatik (Taz yönetir)	Manuel veya auto-scaling gruplar
Veri Süresi	Şifreli, yedekli	Tam kontrol sizde
Customizasyon	Sınırlı (API üzerinden)	Tam kaynak erişimi
SLA	%99.5 (Professional+)	Kendi SLA'nızı belirlersiniz
GPU Gereksinimi	❌ Yok	✅ 8GB+ VRAM zorunlu
Uygun Kitlesi	KOBİ, startup, SMB	Kurumsal, devlet, finans, sağlık

---

Sonraki Adım

Taz.Memory.AI hakkında daha fazla bilgi mi edinmek istiyorsunuz?

• 📖 Taz.Memory.AI Kullanım Manueli → Ekran görüntüleri ile adım adım uygulama kılavuzu
• 🚀 AI Agent Kullanımı → İlk AI ajanınızı oluşturun
• 🏗️ Mimari Dokümantasyon → Derin teknik mimari inceleme
• 💬 İletişime Geçin: info@taztech.com.tr