Discord AI API Başvuru Botu

Modern AI destekli Discord AI API topluluğu başvuru sistemi. Kullanıcılar AI teknolojileri ve API deneyimleri hakkında sorulara cevap verir ve AI tarafından değerlendirilir.

🚀 Özellikler

• AI Destekli Sorular: OpenAI API ile dinamik başvuru soruları
• Otomatik Değerlendirme: AI ile cevapları analiz eder ve puanlar
• Modern Discord UI: Embed, buton ve modal destekli arayüz
• DM Tabanlı Başvuru: Kullanıcılar DM'den başvuru yapar
• Yönetici Paneli: Onay/red butonları ile kolay yönetim
• Veritabanı: SQLite ile güvenli veri saklama
• Türkçe Destek: Tamamen Türkçe arayüz

📋 Kurulum

Gereksinimler

• Node.js 18.0.0 veya üzeri
• Discord Bot Token
• OpenAI API Key

1. Proje Kurulumu

# Bağımlılıkları yükle
npm install

# Çevre değişkenlerini ayarla
cp .env.example .env

2. Çevre Değişkenleri (.env)

# Discord Bot Ayarları
DISCORD_TOKEN=discord_bot_token_buraya
GUILD_ID=1238952254518853723
APPLICATION_CHANNEL_ID=1385872080528216104
NOTIFICATION_CHANNEL_ID=1385871395988308038
APPROVER_USER_ID=1244181502795976775

# OpenAI Ayarları
OPENAI_API_KEY=openai_api_key_buraya
OPENAI_BASE_URL=https://ai.kynux.cloud/v1

# Veritabanı
DATABASE_PATH=./data/applications.db

# Bot Ayarları
AI_SCORE_THRESHOLD=90
QUESTIONS_COUNT=5

3. Discord Bot Kurulumu

1. Discord Developer Portal üzerinden yeni bir uygulama oluşturun
2. Bot sekmesine gidip token alın
3. Bot'u sunucunuza ekleyin (Yönetici izinleri gerekli)
4. Gerekli kanal ID'lerini kopyalayın

4. Botu Başlatma

# Geliştirme modu
npm run dev

# Üretim modu
npm start

🔧 Kullanım

Yönetici Komutları

• /setup-basvuru - Başvuru embed'ini oluşturur

Başvuru Süreci

1. Kullanıcı başvuru embed'indeki "📋 Başvuru Yap" butonuna tıklar
2. Bot DM'den 5 adet AI-generated soru sorar
3. Kullanıcı her soruya minimum 20 kelime ile cevap verir
4. AI cevapları değerlendirir (0-100 puan)
5. Sonuç bildirim kanalına gönderilir
6. Yetkili onay/red butonları ile karar verir

Değerlendirme Sistemi

• 90+ Puan: Otomatik geçer notu, manuel onay gerekir
• 90- Puan: Manuel inceleme gerekir
• Değerlendirme Kriterleri:
  • Discord kuralları bilgisi (25%)
  • Cevap kalitesi (25%)
  • Topluluk uyumu (25%)
  • İletişim becerisi (25%)

📊 Veritabanı Yapısı

applications (
  id INTEGER PRIMARY KEY,
  user_id TEXT NOT NULL,
  username TEXT NOT NULL,
  display_name TEXT,
  questions TEXT NOT NULL,
  answers TEXT NOT NULL,
  ai_score INTEGER NOT NULL,
  status TEXT DEFAULT 'pending',
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  approved_by TEXT,
  admin_notes TEXT
)

🤖 AI Kullanımı

API İstekleri

• Soru Üretimi: Başvuru başına 1 istek
• Cevap Değerlendirmesi: Başvuru başına 1 istek
• Toplam: Başvuru başına 2 API isteği

Rate Limiting

• Dakikada maksimum ~30 başvuru işlenebilir
• OpenAI API limitlerini dikkate alır

🔒 Güvenlik

• API anahtarları .env dosyasında güvenli saklanır
• Veritabanı yerel SQLite dosyasında şifrelenir
• Sadece yetkili kullanıcılar onay verebilir
• Rate limiting ile spam koruması

📁 Proje Yapısı

basvuru-bot/
├── src/
│   ├── ai/
│   │   └── aiService.js          # OpenAI entegrasyonu
│   ├── commands/
│   │   └── setup.js              # Kurulum komutu
│   ├── config/
│   │   └── config.js             # Yapılandırma
│   ├── database/
│   │   └── database.js           # SQLite veritabanı
│   ├── events/
│   │   ├── ready.js              # Bot hazır eventi
│   │   ├── interactionCreate.js  # Etkileşim eventi
│   │   └── messageCreate.js      # Mesaj eventi
│   ├── handlers/
│   │   └── applicationHandler.js # Başvuru işleyici
│   └── index.js                  # Ana bot dosyası
├── data/                         # Veritabanı dosyaları
├── package.json
├── .env.example
└── README.md

🛠️ Geliştirme

Komutlar

# Bağımlılıkları yükle
npm install

# Geliştirme modu (otomatik yeniden başlatma)
npm run dev

# Üretim modu
npm start

Loglama

Bot detaylı loglar üretir:

• ✅ Başarılı işlemler
• ⚠️ Uyarılar
• ❌ Hatalar
• 🤖 AI işlemleri
• 📝 Başvuru süreçleri

📞 Destek

Sorun yaşıyorsanız:

1. Console loglarını kontrol edin
2. .env dosyasının doğru yapılandırıldığından emin olun
3. Bot izinlerini kontrol edin
4. API anahtarlarının çalıştığından emin olun

📄 Lisans

MIT License - Kendi projenizde özgürce kullanabilirsiniz.

---

🎯 Discord AI Başvuru Botu - Modern, güvenli ve kullanıcı dostu başvuru sistemi