UrlMint - URL Kısaltma Servisi

UrlMint, ASP.NET Core 9.0 ve PostgreSQL kullanarak geliştirilmiş modern bir URL kısaltma servisidir. Base62 encoding algoritması kullanarak veritabanı ID'lerini kısa ve güvenli URL kodlarına dönüştürür.

🚀 Özellikler

• ✅ URL kısaltma ve yönlendirme
• ✅ Base62 encoding ile kısa kod üretimi
• ✅ Tıklama sayısı takibi
• ✅ Redis ile URL cacheleme
• ✅ Redis tabanlı tıklama istatistikleri & arka plan senkronizasyonu
• ✅ URL bilgisi sorgulama
• ✅ Tüm URL'leri listeleme
• ✅ PostgreSQL veritabanı desteği
• ✅ OpenAPI/Swagger desteği (Development ortamında)

📋 Gereksinimler

• .NET 9.0 SDK
• PostgreSQL (12 veya üzeri)
• Redis (lokalde veya Docker ile, varsayılan port: 6379)
• Visual Studio 2022, VS Code veya herhangi bir .NET uyumlu IDE

🔧 Kurulum

1. Projeyi Klonlayın

git clone <repository-url>
cd UrlMint

2. Veritabanı Yapılandırması

PostgreSQL veritabanınızı oluşturun:

CREATE DATABASE urlmint;

3. Connection String Yapılandırması

UrlMint/appsettings.Development.json dosyasını oluşturun (veya appsettings.Development.json.example dosyasını kopyalayıp düzenleyin) ve hem PostgreSQL hem Redis connection string'lerini ekleyin:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Database=UrlMint;Username=postgres;Password=your_password;Pooling=true;Minimum Pool Size=10;Maximum Pool Size=200;",
    "Redis": "localhost:6379"
  }
}

Not: your_password kısmını kendi PostgreSQL şifrenizle değiştirin.

4. Veritabanı Migration'larını Çalıştırın

Proje dizininde terminal açın ve şu komutu çalıştırın:

cd UrlMint
dotnet ef database update

Eğer dotnet ef komutu bulunamazsa, önce EF Core tools'u yükleyin:

dotnet tool install --global dotnet-ef

5. Projeyi Çalıştırın

dotnet run --project UrlMint/UrlMint.csproj

Uygulama varsayılan olarak http://localhost:5064 adresinde çalışacaktır. Port numarası Properties/launchSettings.json dosyasından kontrol edilebilir.

📡 API Endpoints

1. URL Kısaltma

Uzun bir URL'yi kısaltır. Eğer aynı URL daha önce kısaltılmışsa, mevcut kısa URL'i döner.

Endpoint: POST /api/url/shorten

Request Body:

{
  "longUrl": "https://www.example.com/very/long/url/path"
}

Response (201 Created):

{
  "shortUrl": "http://localhost:5064/abc123",
  "shortCode": "abc123",
  "longUrl": "https://www.example.com/very/long/url/path",
  "createdAt": "2025-01-08T10:30:00Z"
}

Response (200 OK - Mevcut URL):

{
  "shortUrl": "http://localhost:5064/abc123",
  "shortCode": "abc123",
  "longUrl": "https://www.example.com/very/long/url/path",
  "createdAt": "2025-01-08T10:30:00Z"
}

Hata Durumları:

• 400 Bad Request: URL boş veya geçersiz format

---

2. Kısa URL'e Yönlendirme

Kısa URL kodunu kullanarak orijinal URL'e yönlendirir ve tıklama sayısını artırır.

Endpoint: GET /api/url/{code}

Örnek: GET /api/url/abc123

Response:

• 302 Redirect: Orijinal URL'e yönlendirme yapar

Hata Durumları:

• 404 Not Found: URL bulunamadı
• 400 Bad Request: Geçersiz kısa URL kodu

---

3. URL Bilgisi Sorgulama

Kısa URL koduna ait detaylı bilgileri döner (tıklama sayısı dahil).

Endpoint: GET /api/url/info/{code}

Örnek: GET /api/url/info/abc123

Response (200 OK):

{
  "shortCode": "abc123",
  "longUrl": "https://www.example.com/very/long/url/path",
  "createdAt": "2025-01-08T10:30:00Z",
  "clickCount": 42
}

Hata Durumları:

• 404 Not Found: URL bulunamadı
• 400 Bad Request: Geçersiz kısa URL kodu

---

4. Tüm URL'leri Listeleme

Veritabanındaki tüm kısaltılmış URL'leri listeler.

Endpoint: GET /api/url/all

Response (200 OK):

[
  {
    "shortCode": "abc123",
    "longUrl": "https://www.example.com/very/long/url/path",
    "createdAt": "2025-01-08T10:30:00Z",
    "clickCount": 42
  },
  {
    "shortCode": "xyz789",
    "longUrl": "https://www.another-example.com/page",
    "createdAt": "2025-01-08T09:15:00Z",
    "clickCount": 15
  }
]

---

🧪 Test Etme

cURL Örnekleri

URL Kısaltma:

curl -X POST http://localhost:5064/api/url/shorten \
  -H "Content-Type: application/json" \
  -d "{\"longUrl\": \"https://www.example.com\"}"

URL Bilgisi:

curl http://localhost:5064/api/url/info/abc123

Tüm URL'leri Listeleme:

curl http://localhost:5064/api/url/all

Postman veya HTTP Client

Proje içinde UrlMint.http dosyası bulunmaktadır. Bu dosyayı Visual Studio Code'da REST Client extension'ı ile veya JetBrains Rider'da kullanabilirsiniz.

---

🏗️ Proje Yapısı

UrlMint/
├── Controllers/
│   └── ShortUrlController.cs      # API endpoint'leri
├── Domain/
│   ├── DTO/
│   │   └── ShortenUrlRequest.cs   # Request DTO
│   ├── Entities/
│   │   └── ShortUrl.cs            # Veritabanı entity
│   └── Interfaces/
│       ├── IShortUrlRepository.cs # Repository interface
│       └── IUrlEncoder.cs         # Encoder interface
├── Infrastructure/
│   ├── Encoding/
│   │   └── Base62Encoder.cs       # Base62 encoding implementasyonu
│   ├── Persistence/
│   │   ├── UrlMintDbContext.cs    # EF Core DbContext
│   │   └── Migrations/             # Veritabanı migration'ları
│   ├── BackgroundTasks/
│   │   └── UrlStatsBackgroundService.cs # Redis click sayacı senkronizasyonu
│   └── Repositories/
│       └── ShortUrlRepository.cs  # Repository implementasyonu
├── Services/
│   ├── Interfaces/
│   │   └── IShortUrlService.cs    # Servis interface'i
│   └── ShortUrlService.cs         # Redis + cache kullanan servis katmanı
└── Program.cs                      # Uygulama giriş noktası

Redis Kullanımı (Özet)

• IDistributedCache (StackExchange.Redis) ile kısa kod → uzun URL eşlemesi Redis'te cache'lenir (url:{code} anahtarı).
• Tıklama sayıları direkt veritabanına yazılmak yerine Redis içinde stats:click:{code} anahtarı altında artırılır.
• UrlStatsBackgroundService, belirli aralıklarla bu Redis istatistiklerini okuyup veritabanındaki ClickCount alanına toplu olarak uygular.

---

📝 Teknolojiler

• .NET 9.0 - Framework
• ASP.NET Core - Web framework
• Entity Framework Core 9.0 - ORM
• PostgreSQL - Veritabanı
• Npgsql - PostgreSQL provider
• Redis - In-memory veri yapısı deposu ve önbellekleme
• StackExchange.Redis - Yüksek performanslı Redis kütüphanesi

---

🐛 Sorun Giderme

Migration Hatası

Eğer migration çalıştırırken hata alırsanız:

# Migration'ları sıfırlayın (DİKKAT: Veriler silinir!)
dotnet ef database drop
dotnet ef database update

Connection String Hatası

• PostgreSQL servisinin çalıştığından emin olun
• Connection string'deki bilgilerin doğru olduğunu kontrol edin
• Veritabanının oluşturulduğunu doğrulayın

Port Çakışması

Properties/launchSettings.json dosyasından port numarasını değiştirebilirsiniz.

---

⚡ Performans Analizi

Sistemin hızını ve dayanıklılığını ölçmek amacıyla k6 kullanılarak 50 eşzamanlı kullanıcı (VUs) ile yük testleri yapılmıştır. Sonuçlar, veritabanı optimizasyonunun etkisini net bir şekilde göstermektedir.

Metrik	İndekssiz	İndeksli	Redis + İndeks
Ortalama Yanıt Süresi	29.32 ms	3.57 ms	19.01 ms
Saniyedeki İstek (RPS)	384 req/s	479 req/s	416 req/s
p(95) Gecikme	53.52 ms	12.45 ms	43.53 ms
Başarı Oranı	%100	%100	%100

🔍 Optimizasyon Çıkarımları

• 8 Kat Hız Artışı: ShortCode kolonu üzerindeki B-Tree indeksleme sayesinde yönlendirme süreleri %700'den fazla iyileşmiştir.
• Ölçeklenebilirlik: Sorgu optimizasyonu ile p(95) gecikme süresi 53ms'den 12ms'ye düşürülerek sistemin yoğun yük altında kararlı çalışması sağlanmıştır.
• Mimari: Yüksek trafikli senaryolarda veritabanı yükünü azaltmak amacıyla Redis önbellekleme katmanı mimariye dahil edilmiştir.

---

📄 Lisans

Bu proje LICENSE dosyasında belirtilen lisans altındadır.