🚀 ShortAI

Yapay Zeka Destekli Yeni Nesil URL Kısaltma ve Analitik Platformu

---

📖 Proje Hakkında

ShortAI, sıradan bir URL kısaltıcıdan çok daha fazlasıdır. Karmaşık ve uzun linklerinizi kısaltırken, tıklamaları anlık olarak analiz eder ve entegre Yapay Zeka (AI) sayesinde trafik verilerinizi yorumlayıp size stratejik içgörüler sunar. İster yerel bir model kullanın, ister dünyanın en gelişmiş bulut tabanlı dil modellerini projeye bağlayın!

---

📸 Ekran Görüntüleri

Not: Lütfen görsel dosyalarınızı projenin ana dizininde bir docs klasörü oluşturarak içine atın.

1. Akıllı URL Kısaltma ve AI Önerisi

Kullanıcıların linklerini saniyeler içinde kısalttığı ve yapay zekanın "Custom Alias" (Özel İsim) önerdiği modern ana ekran.

2. Başarılı İşlem & Dinamik QR Kod

Kısaltılan linkin başarıyla oluşturulması, kopyalama kolaylığı ve anında paylaşıma hazır QR kod çıktısı.

3. Detaylı Trafik Analizi ve AI Yorumu

Kısa linkinize kim, ne zaman, hangi ülkeden ve hangi tarayıcıdan tıklamış? Tüm veriler pasta grafiklerle sunulur ve AI Insight modülü bu trafiği sizin için metin olarak yorumlar.

---

✨ Temel Özellikler

• 🔗 Akıllı URL Kısaltma: Uzun URL'leri anında kısaltın veya kendi özel uzantınızı (Alias) belirleyin.
• 🤖 Yapay Zeka Destekli Öneriler: Linkin içeriğini analiz ederek yapay zekanın otomatik anlamlı kısa isimler önermesini sağlayın.
• 📊 Gelişmiş Dashboard: Tıklama sayıları, coğrafi dağılım (Ülke/Şehir), tarayıcı, işletim sistemi ve cihaz bazlı detaylı loglama.
• 📱 Dinamik QR Kodlar: Oluşturulan her kısa link için anında indirilebilir QR kod üretimi.
• 🧠 AI Trafik Yorumlayıcı: Gelen trafiğin kalitesini ve kitlesini yapay zekaya yorumlatın (Örn: "Ziyaretçilerinizin çoğu mobilden geliyor, ağırlıklı olarak teknoloji odaklı trafik").
• ⚡ Yüksek Performans: Yönlendirme (Redirect) işlemleri Redis Cache üzerinden milisaniyeler içinde gerçekleşir.
• 🔒 Güvenlik: Dahili IP bazlı Rate Limiting ile spam tıklamalara karşı koruma.

---

🧠 Desteklenen AI Sağlayıcıları

Proje, esnek bir yapay zeka servisi mimarisi üzerine kurulmuştur. backend/.env dosyasından dilediğiniz sağlayıcıyı tek tuşla seçebilirsiniz:

• Groq: (Varsayılan) Çok hızlı Llama 3 modelleri. GROQ_API_KEY gerektirir.
• OpenAI: Sektör standardı GPT-4 modelleri. OPENAI_API_KEY gerektirir.
• Anthropic: Hızlı ve mantıksal Claude 3 Haiku. ANTHROPIC_API_KEY gerektirir.
• Google: Gemini 1.5 Flash. GOOGLE_API_KEY gerektirir.
• Mistral: Açık kaynak ağırlıklı modeller. MISTRAL_API_KEY gerektirir.
• Ollama (Yerel): İnternet gerektirmeden, bilgisayarınızda yerel olarak (Llama 3.2 vb.) çalışan tamamen ücretsiz ve gizlilik odaklı kullanım.

---

🛠️ Kurulum ve Çalıştırma

Projeyi yerel makinenizde çalıştırmak için bilgisayarınızda Node.js ve Docker'ın kurulu olması gerekmektedir.

1. Veritabanı ve Redis'i Başlatma

Proje dizininde terminali açıp aşağıdaki komutu çalıştırarak PostgreSQL ve Redis'i ayağa kaldırın:

docker-compose up -d

2. Backend (Sunucu) Kurulumu

cd backend
npm install

Eğer ayarlanmadıysa backend/.env dosyasındaki ayarlarınızı kontrol edin.

# Veritabanı şemalarını PostgreSQL'e yükleyin ve Prisma Client oluşturun
npx prisma db push

# Sunucuyu başlatın
npm run dev

(Backend API http://localhost:5000 adresinde çalışacaktır)

3. Frontend (Arayüz) Kurulumu

Yeni bir terminal sekmesi açın:

cd frontend
npm install
npm run dev

(Uygulama arayüzü genellikle http://localhost:5173 adresinde ayağa kalkacaktır)

---

Modern Web Teknolojileri kullanılarak ❤️ ile geliştirilmiştir.