Kick Anti-Bot Koruma Sistemi — Backend Servisi

Bu servis, Kick yayıncılarının kanallarındaki bot saldırılarını ve spamleri takip eden, Supabase Auth tabanlı çalışan NestJS backend uygulamasıdır.

• Node.js v18 veya üzeri
• NestJS — Modüler backend framework
• PostgreSQL / Supabase — Veritabanı ve kimlik do��rulama
• Prisma — ORM

Aşağıdaki adımları sırayla takip ederek projeyi kendi bilgisayarınızda çalıştırabilirsiniz.

• Node.js (LTS sürümü önerilir)
• Git
• Bir Supabase projesi (ücretsiz plan yeterli)

git clone https://github.com/Impevos/KickAntiBot.git
cd KickAntiBot

npm install

.env.example dosyasını .env olarak kopyalayın ve Supabase bilgilerinizle doldurun:

cp .env.example .env

Gerekli değişkenler:

Önemli: Prisma şema işlemleri (db push, migrate) için hem DATABASE_URL hem DIRECT_URL gereklidir.

# Prisma istemcisini oluşturur
npx prisma generate

# Tabloları veritabanına yansıtır
npx prisma db push

Önce uygulamayı çalıştırıp /api/auth/register ile kayıt olun, ardından:

# Windows PowerShell
$env:SEED_OWNER_EMAIL="kayit-olunan-email@adres.com"; npx prisma db seed

# macOS / Linux
SEED_OWNER_EMAIL=kayit-olunan-email@adres.com npx prisma db seed

# Geliştirme modu (hot reload)
npm run start:dev

# Üretim build
npm run build
npm run start:prod

Uygulama http://localhost:3000 adresinde çalışır.

Frontend entegrasyonu için detaylı endpoint dokümantasyonu:

👉 API_DOCS.md

src/
├── auth/                 # Giriş, kayıt, profil
├── channels/             # Kick kanal yönetimi
├── suspicious-users/     # Şüpheli kullanıcı listesi (bot aktivite)
├── risk-scores/          # Risk skoru geçmişi
├── alerts/               # Güvenlik bildirimleri
├── reports/              # Periyodik raporlar + dashboard özeti
├── protection-settings/  # Kanal bazlı koruma ayarları
├── activity-logs/        # Birleşik geçmiş kayıtları
└── common/               # Prisma, filtreler, decorator'lar

# E2E API testleri (24 test, Supabase bağlantısı gerektirir)
npm run test:e2e

# Build kontrolü
npm run build

# Veritabanı şemasını görsel olarak incele
npx prisma studio

# Lint kontrolü
npm run lint

Bu proje özel kullanım içindir.