Referral Programı Kod Yapısı Oluşturma Kılavuzu

Aşağıdaki gereksinimlere göre, bir referral programı için [PROGRAMLAMA DİLİ] dilinde, [VERİTABANI TÜRÜ] veritabanı ile entegre olacak temel kod yapılarını ve API uç noktalarını oluştur. Odak noktamız hızlı bir MVP geliştirmektir.

### 1. Veritabanı Şeması Tasarımı

Referral programı için gerekli olan veritabanı tablolarını ([VERİTABANI TÜRÜ] için uygun syntax ile) ve alanlarını tanımla. Tablolar şunları içermelidir:

* **Kullanıcılar (Users):** Temel kullanıcı bilgileri (id, ad, e-posta). Mevcut bir 'users' tablosu olduğunu varsayabiliriz.
* **Referans Kodları (ReferralCodes):** Her kullanıcıya özel referans kodlarını saklar (id, user_id, referral_code, created_at, expires_at, is_active).
* **Referanslar (Referrals):** Kimin kimi referans ettiğini ve durumunu takip eder (id, referrer_user_id, referred_user_id, referral_code_id, status (pending, completed, cancelled), created_at, completed_at).
* **Ödüller (Rewards):** Referanslar sonucunda verilen ödülleri saklar (id, user_id, referral_id, reward_type, reward_amount, status (pending, claimed), created_at, claimed_at).

### 2. Kullanıcı ve Referans Kodu Yönetimi

* **Yeni Kullanıcı Kaydı:** Yeni bir kullanıcı sisteme kaydolduğunda otomatik olarak benzersiz bir referans kodu oluşturulmasını sağlayacak bir fonksiyon yaz. Referans kodunun uzunluğu [REFERRAL KOD UZUNLUĞU] karakter olmalı ve alfanümerik olmalıdır. Bu kodun 'Referans Kodları' tablosuna kaydedilmesini sağla.
* **Referans Kodu Oluşturma:** Mevcut bir kullanıcının henüz bir referans kodu yoksa, ona yeni bir referans kodu oluşturma ve atama fonksiyonu.
* **Referans Kodunu Getirme:** Bir kullanıcının referans kodunu getiren fonksiyon.

### 3. Referans Takibi ve Ödül Mantığı

* **Referans Takibi Fonksiyonu:** Yeni bir kullanıcı [REFERANS KODU] ile kaydolduğunda, bu referans kodunu kullanan kullanıcıyı ('referred_user_id') ve kodu sağlayan kullanıcıyı ('referrer_user_id') 'Referanslar' tablosuna kaydeden bir fonksiyon yaz. Başlangıç durumu 'pending' olmalı.
* **Referans Tamamlama ve Ödül Dağıtımı:** Bir referans işlemi tamamlandığında (örneğin, referans edilen kullanıcı ilk satın alımını yaptığında), 'Referanslar' tablosundaki 'status' alanını 'completed' olarak güncelleyen ve 'Ödüller' tablosuna [ÖDÜL TÜRÜ] ve [ÖDÜL MİKTARI] değerleriyle yeni bir ödül kaydı ekleyen bir fonksiyon oluştur.
* **Ödül Talep Etme Fonksiyonu:** Bir kullanıcının hak kazandığı ödülü talep etmesini sağlayacak ve 'Ödüller' tablosundaki 'status' alanını 'claimed' olarak güncelleyecek bir fonksiyon.

### 4. API Uç Noktaları

Yukarıdaki işlevsellikleri sunan temel RESTful API uç noktalarını tanımla ve örnek kodlarını oluştur:

* `POST /api/register`: Yeni kullanıcı kaydı ve referans kodu oluşturma. (Body: { 'username', 'email', 'password', 'referral_code' (opsiyonel) })
* `GET /api/user/referral-code`: Mevcut kullanıcının referans kodunu getirme. (Auth gerektirir)
* `POST /api/referral/track`: Referans takibi için bir endpoint. (Body: { 'referrer_code', 'referred_user_id' })
* `POST /api/referral/[REFERRAL ID]/complete`: Bir referansı tamamlama ve ödül dağıtma. (Admin veya sistem içi kullanım)
* `POST /api/rewards/[REWARD ID]/claim`: Kullanıcının ödül talep etmesi. (Auth gerektirir)

Her bir bölüm için kısa, açıklayıcı yorumlar ve anahtar fonksiyon imzaları ile başla, CodeWhisperer'ın gerisini tamamlamasına izin ver.

Aşağıdaki gereksinimlere göre, bir referral programı için [PROGRAMLAMA DİLİ] dilinde, [VERİTABANI TÜRÜ] veritabanı ile entegre olacak temel kod yapılarını ve API uç noktalarını oluştur. Odak noktamız hızlı bir MVP geliştirmektir.

### 1. Veritabanı Şeması Tasarımı

Referral programı için gerekli olan veritabanı tablolarını ([VERİTABANI TÜRÜ] için uygun syntax ile) ve alanlarını tanımla. Tablolar şunları içermelidir:

* **Kullanıcılar (Users):** Temel kullanıcı bilgileri (id, ad, e-posta). Mevcut bir 'users' tablosu olduğunu varsayabiliriz.
* **Referans Kodları (ReferralCodes):** Her kullanıcıya özel referans kodlarını saklar (id, user_id, referral_code, created_at, expires_at, is_active).
* **Referanslar (Referrals):** Kimin kimi referans ettiğini ve durumunu takip eder (id, referrer_user_id, referred_user_id, referral_code_id, status (pending, completed, cancelled), created_at, completed_at).
* **Ödüller (Rewards):** Referanslar sonucunda verilen ödülleri saklar (id, user_id, referral_id, reward_type, reward_amount, status (pending, claimed), created_at, claimed_at).

### 2. Kullanıcı ve Referans Kodu Yönetimi

* **Yeni Kullanıcı Kaydı:** Yeni bir kullanıcı sisteme kaydolduğunda otomatik olarak benzersiz bir referans kodu oluşturulmasını sağlayacak bir fonksiyon yaz. Referans kodunun uzunluğu [REFERRAL KOD UZUNLUĞU] karakter olmalı ve alfanümerik olmalıdır. Bu kodun 'Referans Kodları' tablosuna kaydedilmesini sağla.
* **Referans Kodu Oluşturma:** Mevcut bir kullanıcının henüz bir referans kodu yoksa, ona yeni bir referans kodu oluşturma ve atama fonksiyonu.
* **Referans Kodunu Getirme:** Bir kullanıcının referans kodunu getiren fonksiyon.

### 3. Referans Takibi ve Ödül Mantığı

* **Referans Takibi Fonksiyonu:** Yeni bir kullanıcı [REFERANS KODU] ile kaydolduğunda, bu referans kodunu kullanan kullanıcıyı ('referred_user_id') ve kodu sağlayan kullanıcıyı ('referrer_user_id') 'Referanslar' tablosuna kaydeden bir fonksiyon yaz. Başlangıç durumu 'pending' olmalı.
* **Referans Tamamlama ve Ödül Dağıtımı:** Bir referans işlemi tamamlandığında (örneğin, referans edilen kullanıcı ilk satın alımını yaptığında), 'Referanslar' tablosundaki 'status' alanını 'completed' olarak güncelleyen ve 'Ödüller' tablosuna [ÖDÜL TÜRÜ] ve [ÖDÜL MİKTARI] değerleriyle yeni bir ödül kaydı ekleyen bir fonksiyon oluştur.
* **Ödül Talep Etme Fonksiyonu:** Bir kullanıcının hak kazandığı ödülü talep etmesini sağlayacak ve 'Ödüller' tablosundaki 'status' alanını 'claimed' olarak güncelleyecek bir fonksiyon.

### 4. API Uç Noktaları

Yukarıdaki işlevsellikleri sunan temel RESTful API uç noktalarını tanımla ve örnek kodlarını oluştur:

* `POST /api/register`: Yeni kullanıcı kaydı ve referans kodu oluşturma. (Body: { 'username', 'email', 'password', 'referral_code' (opsiyonel) })
* `GET /api/user/referral-code`: Mevcut kullanıcının referans kodunu getirme. (Auth gerektirir)
* `POST /api/referral/track`: Referans takibi için bir endpoint. (Body: { 'referrer_code', 'referred_user_id' })
* `POST /api/referral/[REFERRAL ID]/complete`: Bir referansı tamamlama ve ödül dağıtma. (Admin veya sistem içi kullanım)
* `POST /api/rewards/[REWARD ID]/claim`: Kullanıcının ödül talep etmesi. (Auth gerektirir)

Her bir bölüm için kısa, açıklayıcı yorumlar ve anahtar fonksiyon imzaları ile başla, CodeWhisperer'ın gerisini tamamlamasına izin ver.